Adding Named Scripts to a Graphic
- Last UpdatedJul 13, 2023
- 2 minute read
You can add named scripts to a graphic. A named script runs:
-
One time when the specified values, data or expressions change.
-
Periodically if the values or expressions meet a certain criterion, such as being true.
Every named script can contain only one trigger type.
To add a named script to a graphic
-
Open the graphic in the Industrial Graphic Editor.
-
On the Special menu, click Scripts. The Edit Scripts dialog box appears.
-
Click the Add icon. A new entry is created in the Named Scripts list.
-
Type a name for the named script. The name appears on the right panel as header.
-
In the Expression box, do one of the following:
-
Type an expression, value or reference.
-
Browse for a reference.
The expression acts as data source for the script trigger.
-
-
In the Trigger list, click:
-
WhileTrue to trigger the script periodically when the expression is true.
-
WhileFalse to trigger the script periodically when the expression is false.
-
OnTrue to trigger the script one time when the expression becomes true from false.
-
OnFalse to trigger the script one time when the expression becomes false from true.
-
DataChange to trigger the script one time when the expression or its quality changes. Select the Quality Changes check box to trigger the script when the quality of the specified expression changes.
-
-
If you want to specify how often the script is run when the trigger condition is fulfilled, type a time delay in milliseconds in the Trigger Period box.
-
If you want to specify by how much the evaluated value is expected to change before the script runs, type a deadband value in the Deadband box.
-
Type your script in the main edit box.
-
Use the Script Function Browser and Attribute Browser to select external data.
-
Click OK. The script editor validates the syntax of the script and identifies any errors. Click:
-
Yes to save changes even if the script contains errors.
-
No to cancel the changes and close the script dialog box.
-