This is a key to reading the descriptions of the built-in scripting functions og InduSoft web Studio HMI software.
Each function description is broken into several sections.
Every function has certain attributes that are described in a single-row table:
|Function||Group||Execution||Windows||Embedded||Thin Client||Mobile Access|
|function name||group name||synchronous or asynchronous||supported or not supported||supported or not supported||supported or not supported||supported or not supported|
First, obviously, the exact name of the function as it should be used in your project.
Next, the functions are organized into groups according to the type of calculation they perform or the part of your project upon which they act. You can use the group names to find the functions you want in the Object Finder and in this documentation.
Next, the execution of the function is either synchronous or asynchronous:
- Synchronous means that when the function is executed on either the project server or the project client, that station requires some response or acknowledgement from the other. The project pauses, however briefly, while it waits for the response. In other words, the server and client must remain synchronized.
This is normally not an issue because most functions are executed almost instantly, but if a client makes unusually frequent function calls or your network is slow, then your project may suffer decreased performance.
- Asynchronous means that the function can be executed on either the project server or the project client without waiting for the other. The project continues to run without interruption.
Finally, the function is either supported or unsupported on each of the target system types:
- Windows means the full InduSoft Web Studio project runtime server and/or client running on Windows or Windows Server.
- Embedded means either EmbeddedView running on Windows Embedded Standard or CEView running on Windows Embedded Compact.
- Thin Client means either Secure Viewer (a.k.a. the InduSoft Thin Client software) or the Web Thin Client (i.e., the ISSymbol plug-in for Internet Explorer).
- Mobile Access means project screens viewed in the browser via the Mobile Access web interface.
Syntax diagram and parameters
A basic syntax diagram shows how the function should be entered and what parameters it takes.
In most cases, a parameter can take either a literal value or the name of a project tag that contains the value. The data type of the parameter is indicated by its prefix:
- bool means the parameter can take either a literal Boolean value or the name of a Boolean tag. For example, either 0 or MyBoolTag.
- num means the parameter can take either a literal numerical value or the name of an Integer or Real tag. For example, either 45.6543 or MyNumTag.
- str means the parameter can take either a text string enclosed in quotation marks or the name of a String tag. For example, either “My string” or MyStrTag.
The additional prefix opt indicates that a parameter is optional. If you do not specify a value for the parameter, then the function will take the default value mentioned in the parameter description.
In the few cases where a parameter must take a project tag or some other special input, it will be fully explained in the parameter description.
This section describes the value returned by the function, if any.
Some functions return a calculated value, depending on the nature of the function.
Other functions return an error code that indicates how well the function was executed. The possible codes and their meanings are provided in a table.
This section describes any additional notes or cautions on the use of the function.
This section shows how the function can be called in your project. Multiple examples are provided to show how the function can take both literal values and project tags, as well as how the function may be called if it has optional parameters.