Graphics Builder > Configure Graphics Pages > Edit the Properties for a Page > Page Properties - Associations

Page Properties - Associations

The Page Property association Name Tab is used to define default Associations. The name you use when defining a Super Genie association is entered in the Name Field.

Use this tab to reference or edit existing associations. In using this tab you can add those associations that are currently in use in a Super Genie association and define the appropriate default value and value on error fields. You can also add a description.

Double-click in the row to make it editable, or Click Add.

Field

Description

Name

Note: On upgrading from an earlier version of Citect SCADA existing numbered substitutions are taken from defined Super Genie pages and automatically listed in the drop down box.

For new associations enter the name of the association directly in the field [Name] provided: or select the name of the association from the drop-down box. Only those association names that are ‘in-use’ as part of a Super Genie assocaition are listed. For example, if the association in the expression field of a button was ‘?Speed?’ then the association name is Speed.

Name Associations:

  • To start with an alphanumeric or “_” character
  • To contain only those characters that are allowed in variable tag names (excluding the period character ‘.’), and not contain any white space.
  • Be no more than 253 characters in length

Default (optional)

Enter the default value to be used if the page association has not been performed using one of the Association Cicode functions at runtime. The default value needs to be either a literal string constant enclosed in single quotes (e.g. <'a literal value'> or <'1.23'>) or a valid full or partial tag name, equipment.item reference.

Value on Error (optional):

Enter the text to be used if no default value is defined and the association is not performed, or if the defined association did not resolve to a valid tag name. Since the value on error cannot be a variable tag, it is not necessary to enclose the text in quotation marks.

If the association on the page is specified in a typed format, the value will be converted to the specified type. If the value cannot be converted a hardware alarm will be raised. For example, if the association is specified as ?INT AlmDesc? and the value on error is set to <LowLevel>, the animation will display zero (0) and a hardware alarm will be raised. Typeless substitutions such as ?AlmDesc? will display the value on error as specified.

Description (optional):

Enter a description of the page association. The description is useful when maintaining associations.

In Use:

This column can not be edited and simply indicates if the association is in use on the current page in a Super Genie.

When finished click Add, the association is then added to the table.

To edit an association select an item and click Edit or double-click on the row to make it editable. You can not edit the name of an existing association that is in use. However you can select a new name in an existing row, and when this name is <ENTERED>, a new row of information will be displayed and the existing row of data will disappear.

To delete an association select the row in the table and click Delete. You can delete associations in use or not in use. If you delete the object from the page, the status of the association used in the Super Genie substitution will be updated to not in-use.

Click Ok or Apply to save the association table or click Cancel to discard any changes you may have made.

See Also

Published June 2018