RenameTag

Associated with: AVEVA Historic Data Export items

Security permission required to access this method: Configure (on both the point or accumulator for which the tag is being renamed, and the AVEVA Historic Data Export item)

Use the RenameTag method to rename an existing tag in AVEVA Historian. Use this method to align an existing tag name in AVEVA Historian with the name of the point or accumulator with which that tag is associated, after that point or accumulator has been renamed and/or moved in the Geo SCADA Expert database.

The RenameTag method will only rename a tag that already exists in the AVEVA Historian database with which the AVEVA Historic Data Export item is associated. For a tag to exist in the AVEVA Historian database, HCAL must have previously exported some historic data for the point or accumulator. When Geo SCADA Expert creates a tag in AVEVA Historian, the name of the tag is stored in the Geo SCADA Expert database (and can be viewed using the point's or accumulator's AVEVA Historian Export status attribute). The RenameTag method compares the tag name that is stored in Geo SCADA Expert with the current name of the point or accumulator plus the AVEVA Historian database item's Tag Names settings; if they differ, the method renames the tag in the AVEVA Historian and updates the tag name that is stored in the Geo SCADA Expert database.

To ascertain the tag name that currently applies to a point or accumulator in Geo SCADA Expert, view that point's or accumulator's AVEVA Historian Export Status display attribute.

To rename a tag in AVEVA Historian using the RenameTag method (so that the tag name aligns with the point's or accumulator's name in Geo SCADA Expert):

1. Ensure that AVEVA Historian (formerly Wonderware Historian) is configured to allow tags to be renamed programmatically. This is controlled by the 'AllowRenameTags' system parameter. You can use the Historian Configuration Editor in the ArchestrA System Management Console to set this system parameter to its required setting of 1.
2. In Geo SCADA Expert, ensure that the AVEVA Historic Data Export item is configured with the required Tag Names settings (see Specify the Properties that are Associated with Tag Names).
3. Ensure that the point or accumulator for which the tag is to be renamed:
   • Is stored in the required location in the Geo SCADA Expert database (see Moving a Database Item)
   • Is assigned the relevant name (see Renaming a Database Item).
4. Use the RenameTag method in Geo SCADA Expert to trigger AVEVA Historian to update the existing tag name. You execute the RenameTag method programmatically; for example, using the Automation Interface.

   The method has 1 argument:

   • Object (String)—Use to specify either:
     • The Full Name of the point or accumulator for which the tag is to be renamed, including that point's or accumulator's full path in the database (see Full Name)

     Or:

     • The Id of the point or accumulator for which the tag is to be renamed (see Id).