Page Comparison

In this section, you can find the method of writing a script using functions and subroutines^[1]. When you write a script, please be aware of the following precautions.

Panel

panelIconId	atlassian-warning
panelIcon	:warning:
bgColor	#4C9AFF

When you use a function in the script, there must be brackets since it has a return value. Brackets should be removed in subroutines.
When you use functions and subroutines in command expression, they must be used with brackets.
In the script, the functions and subroutines have to be differentiated.
Please refer to the appendices of ‘Script’ and ‘Operation and Command Expressions’ manual.

(1) Writing a Script

a) In the database editor, create an analog tag named ‘VALUE’.

b) Select [Tools] – [Script] or icon to bring up the script editor. Press icon to create a new script.

c) Write a script as shown below. This script changes the value of the ‘VALUE’ tag.

d) When the script is called, it executes the functions and ends automatically. If you use ‘While’ statement as used in c), the script will loop infinitely. In this case, you can stop the script using StopScript() function.

Panel

panelIconId	atlassian-warning
panelIcon	:warning:
bgColor	#4C9AFF

‘Sleep’ function must be included in the While statement to pause the operation at least 100msec. Otherwise, the script will loop continuously, which will cause the latency in the project operation.

e) Press [!] button in the editor to compile the script.

...

f) Select [File] – [Save] or icon to save the script to the project.

g) Select [Draw] – [Tag Value] or icon to add the tag value object to the graphic page, which will display the value of the ‘VALUE’ tag.

(2) Script Run / Stop

a) You can run or stop the script with the following subroutines.

Subroutine for the script execution

Subroutine	Command	RunScript(“Script Name”)
	Script	RunScript “Script Name”
Description	Executes the assigned script.
Example	Runs the script named ‘ValueChange’. RunScript(“ValueChange”)

Subroutine	Command			RunScriptEx(“Script Name”, Option, Parameter)
	Script			RunScriptEx “Script Name”, Option, Parameter
Description	Executes the assigned script according to the option and parameter.
	Option	0	No action is taken if the assigned script is currently running.
		1	Waits until the script stops and runs the script with Parameter.
	Parameter		A parameter conveyed to the script. The script can receive the parameter using GetParameter() function.
Example	Convey the parameter ‘Test’ to the script and executes the script named ‘ValueChange’. RunScriptEx(“ValueChange”, 1, Test)

Subroutine to stop the script

Subroutine	Command	StopScript(“ValueChange”)
	Script	StopScript “ValueChange
Description	Stops the assigned script.
Example	Stops the script named ‘ValueChange’. StopScript(“ValueChange”)

Versions Compared

Old Version 1

New Version 2

Key