Item

Description

Open Page

I will open up a new page. It has the following parameters:

Method: Either calling the page by the name or by the index

Page: Depending on the Method, users will specify the page by name or page number.

Close Page

Closes the current page. It has the following parameters:

Method: Either calling the page by the name or by the index

Page: Depending on the Method, users will specify the page by name or page number.

Set Tag Value

Sets the tag value to the predetermined value. It has the following parameters:

Tag: Specifies which tag will have its value changed.

Value Type: Configuration for how the value will be set, copying from another tag or by a constant integer.

Value: Depending on the configuration of the Value Type, it will require either an int or another tag to grab the value from.

Toggle Tag Value

Toggles a tag to interchange between zero and one. It cannot go to any other value. Has the parameters:

Tag: Sets the tag which is to be toggled.

Call Script

Toggles a Manual Script to be run when activated. It has the following parameters:

Run on a separate thread: A toggle that will determine if each instance of the script being run will count as a separate script or the same one.

Script Name: Specifies the script that will be called.

Press Key

Simulates a keystroke from a specified key on the keyboard. It has the following parameters:

Key: Specifies which key will be simulated. I.E., Enter, tab, backspace, etc.

Enter Tag Value

Opens up a keypad to manually input a new tag value. It has the following parameters:

Type: Sets the to-be input as either text or a Numeric input. Numeric will display a keypad; text will display a keyboard.

Tag: Specifies the tag that will be changed.

Header: Sets the text at the top of the keypad that will appear at the top left of the keypad window.

Subheader: Sets the text below the header. It will appear also in the top left of the keypad.

X: Sets the X position for the keypad

Y: Sets the Y position for the keypad.

The following parameters are for Numeric Keypads only.

Decimal Places: Will set how many decimal places will show by default when opening the keypad.

Leading Zeroes: Sets how many Zeroes will appear preceding the tag value when opening the keypad

Base: Can be set to either Decimal or Hexadecimal. A numeric keypad will appear with standard numbering conventions of A-F, respectively.

Use Thousands Separator(,): Adds a comma for every thousand places.

Use Min/Max: Will enable the use of setting a Min / Max on the keypad

Min: Set the minimum value accepted for the keypad. No limit.

Max: Set the maximum value accepted for the keypad. No limit.

Enable/Disable Schedule

Sets a schedule to be turned on or off depending on the command specifications. It has the following parameters:

Schedule: specifies which schedule to enable/disable.

Operation: Sets the command only to Enable, Disable, or Toggle the schedule.

Set Translation Language

Sets the Language. It has the following parameters:

Language: Set the language, which must be in the translation editor.

Save Alarm CSV

Creates a CSV file based on the Alarm Summary data. It has the following parameters:

Storage Type: Sets where the CSV file will be stored. Has the options of Local, USB, SD Card, and FTP.

Label: This can be set only to record Alarms with a specific label or to grab all labels.

Save Data Log CSV

Creates a CSV file based on the Data Logger data. It has the following parameters:

Storage Type: Sets where the CSV file will be stored. Has the options of Local, USB, SD Card, and FTP.

Data Log Model: Specifies which Data Log Model to grab the data from.

Time Range: All by default. It can be configured to grab within a specific time frame only.

Send Screen Notification

Sends a notification to the bottom of the screen during runtime. It has the following parameters:

Message: Set the message to be sent by the news.

Automatically Dismiss: Toggle to turn on automatic dismissal.

Dismiss Delay (ms): Set how long the project will wait before Dismissing the message.

Exit Project

Automatically closes the project. There are no parameters for this command.

Open Config Menu

Opens the configuration menu, this is usually opened via the 3-corner method. There are no parameters for this command.

Start/Stop Data Log

Sets a Data Log to be turned on or off depending on the command specifications. It has the following parameters:

Schedule: specifies which Data Log Model to enable/disable.

Operation: Sets the command only to Enable or Disable.

Add Row to Data Log

Adds a row to the Data Log. It has the following parameters:

Data Log Model: specifies which Data Log Model will have the vrow added.

Open Login Window

Opens the Login window for Identity and Access Management. It has the following parameters:

Show User List: A toggle to show the list of all available users or to have the user type in the username.

Logout user

Automatically logs out the current user from the runtime. There are no parameters for this command.

Insert Custom Script

Creates a script to run. Will be treated like a Manual Script. There are no parameters for this command.

Start/Stop FTP Server

Toggles on or off an FTP server. It has the following parameters:

Operation: Sets the power only to Start or Stop.

Open Frame Monitor

Opens up the Frame Monitor. This only works on a physical Xpanel and is not supported in simulator mode. There are no parameters for this command.

Open Previous Page

Open the previous page that the current page was opened from. There are no parameters for this command.

Enable/Disable Driver

Enables or Disabled Communication with the selected I/O Device. It has the following parameters:

I/O Device: Selects which I/O Device will have their communication configuration will be altered.

Operation: Sets the command only to Enable or Disable.

Send Email

Sends an email from the project to the recipients. It has the following parameters:

To: Select from Users or groups, or type in an email to send the message to.

Cc: Carbon copy. Recipients in this will receive the email, but it will not be primarily addressed to them.

Subject: Sets the subject line for the email.

Message: Sets what the message within the email will be sent.

Send Recipe Record

Sets tags to the values saved within the Reciperecipe. It has the following parameters:

Recipe Database: Sets the Recipe database to pull the info from.

Use Record Tag ID: A Toggle to pull the tag connected to the Record record or just the ID number.

Record ID: The ID number of the Record record to pull tag data from.

Record Tag ID: The Tag connected to the Record record to pull tag data from.

Receive Recipe Record

Receives tag values from the project and saves them to the Reciperecipe. It has the following parameters:

Recipe Database: Sets the Recipe database to pull the info from.

Use Record Tag ID: A Toggle to pull the tag connected to the Record record or just the ID number.

Record ID: The ID number of the Record record to pull tag data from.

Record Tag ID: The Tag connected to the Record record to pull tag data from.

Import Recipe CSV

Select a CSV file to import into the selected Reciperecipe. It has the following parameters:

Recipe: Select the Recipe to have the CSV file imported.

Storage Type: Selection choice for where the CSV file will be searched from.

Export Recipe CSV

Select a Recipe to export into the selected storage type. It has the following parameters:

Recipe: Select the Recipe to have the CSV file exported from.

Storage Type: Selection choice for where the CSV file will be exported to.

Open Recipe Config

Opens a Recipe configuration window in runtime. It has the following parameters:

Recipe: Select the Recipe that will have its config window open.

Item

Description

alarm.createAllCsv(enum storageType);

Saves all the messages at the assigned Storage type as a CSV.

Enter the number or string below as the user’s declared Storage type.

1: Storage.Local

2: Storage.Usb

3: Storage.SdCard

4: Storage.Ftp

The return value is undefined.

Example: alarm.

createAllCsv(1);

alarm.createCsv(String label, enum storageType);

Saves all the alarm messages associated with the String label at the assigned Storage type as a CSV.

String label refers to one of the following labels in the below image. Users can create their own labels or use a preset label.

Enter the number or string below as the user’s declared Storage type.

1: Storage.Local

2: Storage.Usb

3: Storage.SdCard

4: Storage.Ftp

The return value is undefined.

Example: alarm.createCsv("A", 1);

datalog.start(String modelName)

Causes the Data Log Model specified to begin logging data.

String modelName refers to the name of the data log model to be targeted.

The return value is undefined.

Example: datalog.start("LoggingModel");

datalog.stop(String modelName)

Causes the Data Log Model specified to stop logging data.

String modelName refers to the name of the data log model to be targeted.

The return value is undefined.

Example: datalog.stop("LoggingModel");

datalog.addRow(String modelName)

Causes the Data Log Model specified to have a single row added to it.

String modelName refers to the name of the data log model to be targeted.

The return value is undefined.

Example: datalog.

addRow("LoggingModel");

datalog.createCsv(String modelName, enum storageType)

Creates a CSV file of the Data Log Model specified at the designated location.

String modelName refers to the name of the data log model to be targeted.

Enter the number or string below as the user’s declared Storage type.

1: Storage.Local

2: Storage.Usb

3: Storage.SdCard

4: Storage.Ftp

The return value is undefined.

Example: datalog.

createCsv("LoggingModel", 1);

datalog.createCsvForRange(String modelName, Date start, Date end, enum storageType)

Creates a CSV file of the Data Log Model specified at the designated location with a set time boundary.

String modelName refers to the name of the data log model to be targeted.

Enter the number or string below as the user’s declared Storage type.

1: Storage.Local

2: Storage.Usb

3: Storage.SdCard

4: Storage.Ftp

Date start refers to the first day that it will collect data from.

Date end refers to the last day that it will collect data from.

The return value is undefined.

Example: datalog.

createCsvForRange("LoggingModel", 1, 31, 1);

keyboard.sendKeyEvent(keycode)

Simulates a keystroke for an integer keycode.

Keycode is a code that indicates which key to simulate, either in hexadecimal or decimal. Here is a list of supported keycodes.

The return value is undefined.

Example: keyboard.sendKeyEvent(0x20);

keyboard.launchKeypad(tagname, properties)

Create a popup numeric keypad popup to set a tag to the user input value.

Tagname refers to the name of the tag to be set.

Properties refer to optional specifying parameters that can change components of the keypad. The following options are:

• header: Sets the text at the top of the keypad that will appear at the top left of the keypad window

• subheader: Sets the text below the header. It will appear also in the top left of the keypad.

• x: Sets the X position for the keypad

• y: Sets the Y position for the keypad.

• format: Can be set to either Decimal or Hexadecimal. Decimal with a numeric keypad appears and will follow standard numerical systems. Hexadecimal will follow hexadecimal numbering conventions, and A-F will also appear on the keypad.

• min: Set the minimum value accepted for the keypad. No limit.

• max: Set the maximum value accepted for the keypad. No limit.

The return value is undefined.

keyboard.launchKeyboard(tagname, properties)

Example: var properties = {

header : "Header",

subheader : "Subheader",

x : 50,

y : 50,

format : "HH",

min : 5,

max : 20

}

keyboard.launchKeypad("Number", properties);

keyboard.launchKeyboard(tagname, properties)

Creates a popup keyboard to set a tag to the user input value.

Tagname refers to the name of the tag to be set.

Properties refer to optional specifying parameters that can change components of the keypad. The following options are:

• Header: Sets the text at the top of the keypad that will appear at the top left of the keypad window

• Subheader: Sets the text below the header. It will appear also in the top left of the keypad.

• X: Sets the X position for the keypad

• Y: Sets the Y position for the keypad.

The return value is undefined.

The return value is undefined.

Example: var properties = {

header : "Header",

subheader : "Subheader",

x : 50,

y : 50

}

keyboard.launchKeyboard("number", properties);

notification.send(string msg, int dismissInterval = -1)

Sends a popup notification to the screen runtime displaying the specified message.

String msg refers to the string to be displayed in the notification.

Int dismissInterval refers to an optional number of seconds before the notification is automatically dismissed. Any value that is set to less than 0 means it will stay until manually dismissed. The default value is -1.

The return value is 0.

Example: notification.send("This is a notification");

page.open(string name)

Opens the page with the specified name.

String name refers to the name of the page to be opened.

The return value is undefined.

Example: page.open("Page 2");

page.openIndex(number index)

Opens the page with the specified index.

Numbers index refers to the index of the page to be opened.

The return value is undefined.

Example: page.openIndex(1);

page.close(string name)

Closes the page with the specified name.

String name refers to the name of the page to be closed.

The return value is undefined.

Example: page.close("Page 1");

page.closeIndex(number index)

Closes the page with the specified index.

Number index refers to the index of the page to be closed.

Example: page.closeIndex(1);

page.currentName()

Gets the name of the current page.

The return value is the string containing the name of the currently opened page.

Example: page.currentName();

page.currentIndex()

Gets the index of the current page.

The return value is the string containing the index of the currently opened page.

Example: page.currentIndex();

schedule.isEnableisEnabled(String title);

Returns a bool stating if the schedule is enabled or not.

String title refers to the name of the schedule that is being checked.

Example: schedule.isEnabled("Schedule");

schedule.setEnable(string title, bool enable)

Turns the named schedule on or off based on what bool enable is set to.

String title refers to the name of the schedule that is being enabled/disabled.

Bool enable can only be set to true to enable the schedule or false to turn off the schedule.

The return value is undefined.

Example: schedule.setEnable("Schedule", 1);

system.importScript(string scriptName)

Executes a specified script in the current project on the current thread. Any variables/functions in the declared script will be accessible in the calling script.

String scriptName refers to the target script that will run within the current script.

The return value would be whatever the result of the called script is.

Example: system.importScript("Script");

system.runScript(string scriptName)

Executes a specified script in the current project on a separate thread.

String scriptName refers to the target script that will run within the current script.

The return value is undefined.

Example: system.runScript("Script");

system.openConfig()

Opens the runtime config (3 corner method) menu.

The return value is undefined.

Example: system.openConfig();

system.openXpanelManager()

Opens the Xpanel Control Center (desktop)

The return value is undefined.

Example: system.openXpanelManager();

system.setLanguage(string language)

Sets the language to be used by the Translation Editor.

String language refers to the name of the language to be used. This should be one of the columns in the Translation Editor.

The return value is undefined.

Example: system.setLanguage("English");

system.login(string username, string password)

Immediately logs in the user for the Identity and Access Management feature.

String username refers to the name of the user to log in to.

String password refers to the password for the specific user. This argument can be omitted without a password or an empty string.

The return value is true if the user is successfully logged in; it will return false if it is unsuccessful.

Example: system.login("Username", "Password");

system.openLoginWindow(properties)

Open the login window from the Identity and Access Management system.

Properties refer to optional specifying parameters that can change components of the function. The only option is:

• listUsers: a toggle to show the list of all available users, or to have the user type in the username.

The return value is undefined.

Example: var properties = {

listUsers: 1

};

system.openLoginWindow(properties);

system.openAuthWindow(properties)

Opens the built-in dialog for authenticating a user. Users will have to re-enter username and password.

Properties refer to optional specifying parameters that can change components of the function. The only option isoptions are:

• Username: sets the user to be authenticated. If no user is provided, it will authenticate the current user. If there is no user logged in, it will return false.

• Permissions: only allow users with the listed permissions to successfully login. If they do not have permission, it will not complete logging in.

The return value is True if logged in; otherwise, it is false.

Example: var properties = {

permissions: "Permission 1"

}

system.openAuthWindow(properties);

system.logout()

Logs out of the current user from the Identity and Access Management system

The return value is undefined.

Example: system.logout();

system.hasPermission(string permission)

Check to see if the currently logged-in user has the specified permission.

String permission refers to the name of the permission being checked.

The return value is true if the user has permission and false if the user does not.

Example: system.hasPermission("Permission 1");

system.exit()

Closes the current project and runtime application.

The return value is undefined.

Example: system.exit();

system.audio.playfileplayFile(Storage type, string relativePath, bool async = true)

Plays an audio file at the designated location.

Enter the number or string below as the user’s declared Storage type.

1: Storage.Local

2: Storage.Usb

3: Storage.SdCard

4: Storage.Ftp

String relativePath refers to the path to the audio file.

If async is true, it will return immediately; otherwise, it will finish when the audio file is complete.

The return value is the audio file.

Example: system.audio.playFile(1, "Path");

system.audio.stopFile(Storage type, string relativePath)

Stops all audio files at the specific location.

Enter the number or string below as the user’s declared Storage type.

1: Storage.Local

2: Storage.Usb

3: Storage.SdCard

4: Storage.Ftp

String relativePath refers to the path to the audio file.

The return value is the audio file.

Example:system.audio.stopFile(1, "Path");

system.audit.log(description)

Logs the entered description in the audit database.

Description refers to the text to be added to the database.

The return is undefined.

Example: system.audit.log("Text");

system.email.send(properties)

Sends an email using the SMTP settings.

Properties refers to specific email properties .including

• To

• Cc

• Subject

• Body

The return value is undefined.

Example: var properties = {

to: "test@gmail.com",

cc: "test2@gmail.com",

subject: "Script Email Send",

body: "This email is an example of how the system.email.send function works."

};

system.email.send(properties);

system.file.exists(Storage type, String path = string())

Determines whether a file exists at the given path.

Enter the number or string below as the user’s declared Storage type.

1: Storage.Local

2: Storage.Usb

3: Storage.SdCard

4: Storage.Ftp

String path refers to the path to the file.

The return value is true or false.

Example: system.file.exists(1, "Test.txt");

system.file.isDirectory(Storage type, String path)

Determines whether the path is a directory or not.

Enter the number or string below as the user’s declared Storage type.

1: Storage.Local

2: Storage.Usb

3: Storage.SdCard

4: Storage.Ftp

String path refers to the path to the directory.

The return value is true or false.

Example: system.file.isDirectory(1, "Documents");

system.file.openDialog(Storage type, String path = string())

Determines whether a file exists at the given path.

Enter the number or string below as the user’s declared Storage type.

1: Storage.Local

2: Storage.Usb

3: Storage.SdCard

4: Storage.Ftp

String path refers to the path for selecting a file.

The return value is undefined.

Example: system.file.openDialog(1, "Documents");

system.file.saveDialog(Storage type, String path = string())

Determines whether a file exists at the given path.

Enter the number or string below as the user’s declared Storage type.

1: Storage.Local

2: Storage.Usb

3: Storage.SdCard

4: Storage.Ftp

String path refers to the path for selecting a file.

The return value is undefined.

Example: system.file.saveDialog(1, "Documents");

system.ftp.startServer()

Starts a local FTP server.

The return value is undefined.

Example: system.ftp.startServer();

system.ftp.stopServer()

Stops a local FTP server.

The return value is undefined.

Example: system.ftp.stopServer();

system.openFrameMonitor()

Opens the Frame Monitor.

The return value is undefined.

Example: system.openFrameMonitor();

tag.read(string name)

Gets the current value of the specified tag.

String name refers to the name of the tag.

The return value is dependent on what type the tag is; a BOOL will return a BOOL, a String will return a String, etc.
Example: tag.

read("TagName");

tag.write(string name, value)

Sets the value of the specified tag.

String name refers to the name of the tag.

Value refers to what the tag will be set to.

The return value is undefined.

Example: tag.write("TagName", tag.read("TagName") + 1);

thread.msleep(number msecs)

Suspends the current thread for the specified amount of milliseconds.

Number msecs refers to the number of milliseconds the program will wait before continuing execution.

The return value is undefined.

Example: thread.msleep(100);

thread.sleep(number secs)

Suspends the current thread for the specified amount of seconds.

Number secs refers to the number of seconds the program will wait before continuing execution.

The return value is undefined.

Example: thread.sleep(100);

recipe.openConfig(string recipe = string())

Opens a Recipe configuration window in runtime. If no recipe name is given, the function will open the most recently created recipe.

String recipe refers to the name of the created Recipe recipe to open.

The return value is undefined.

Example: recipe.openConfig("RecipeName");

recipe.sendRecord(string recipe, int id)

Sets the recipe values from a local recipe database to a device.

String recipe refers to the Recipe recipe to save onto.

Int id refers to the record ID to save the new data.

The return value is undefined.

Example: recipe.

sendRecord("RecipeName", tag.read("Switch"));

recipe.receiveRecord(string recipe, int id)

Gets the recipe values from a device and saves them onto a local recipe database.

String recipe refers to the Recipe recipe to save onto.

Int id refers to the record ID to save the new data.

The return value is undefined.

Example: recipe.receiveRecord("RecipeName", tag.read("Switch"));

recipe.createRecord(string recipe, int id, string name, List<Value> values)

Creates a new record with the given parameters and adds it to the local recipe database.

String recipe refers to the recipe database to add the new record.

Int Id refers to the Record ID of the new record.

String name refers to the name of the record.

List <Value> values refers to all parameters that must be listed within the record.

The return value is undefined.

Example: recipe.createRecord("RecipeName", tag.read("Switch"), "Orange", ["#FFA500"]);

recipe.deleteRecord(string recipe, int id)

Deletes the given record from the recipe database.

String recipe refers to the recipe database to delete the record from.

Int id refers to the ID of the record to be deleted.

The return value is undefined.

Example: recipe.

deleteRecord("RecipeName", tag.read("Switch"));

recipe.setRecord(string recipe, int id, List<Value> values)

Updates the values of a record from the local recipe database.

String recipe refers to the recipe database to add the new record.

Int Id refers to the Record ID of the record.

List <Value> values refers to all the values within each parameter that must be listed within the record.

The return value is undefined.

Example: recipe.setRecord("RecipeName", tag.read("Switch"), ["#FFA500"])

recipe.getRecordValues(string recipe, int id)

Updates the values of a record from the local recipe model.

String recipe refers to the recipe database to add the new record.

Int Id refers to the Record ID of the record.

The return value is a list of all record values.

Example: recipe.getRecordValues("RecipeName", tag.read("Switch"))

recipe.getAllParameters(string recipe)

Returns a list of all record values from the device.

String recipe refers to the recipe database.

The return value is all values from the device.

Example: recipe.getAllParameters("RecipeName");

recipe.getParameter(string recipe, int id, int index)

Returns a single value from a given record from the recipe database.

String recipe refers to the recipe database.

Int Id refers to the Record ID of the record.

Int index refers to the position within the recipe.

The return value is the value requested.

Example: recipe.

getParameter("RecipeName", tag.read("Switch"), 0);

recipe.setParameter(string recipe, int id, int index, Value value)

Sets a value of a record from the selected recipe database.

String recipe refers to the recipe database to add the new record.

Int Id refers to the Record ID of the record.

Int index refers to the position within the recipe.

List value refers to the value that will be set.

The return value is undefined.

Example: recipe.setParameter("RecipeName", tag.read("Switch"), 0, "#FFA500");

recipe.getParameterbyName(string recipe, int id, string name)

Returns a single value from the given record from the named column.

String recipe refers to the recipe database.

Int Id refers to the Record ID of the new record.

String name refers to the parameter the user wants to grab data from.

The return value is the value of the record.

Example: recipe.getParameterByName("RecipeName", tag.read("Switch"), "color");

recipe.setParameterbyName(string recipe, int id, string name, Value value)

Sets a single value from the given record from the named column.

String recipe refers to the recipe database.

Int Id refers to the Record ID of the new record.

String name refers to the parameter the user wants to set data to.

Value value refers to the new data that will be set.

The return value is undefined.

Example: recipe.

setParameterByName("RecipeName", tag.read("Switch"), "color", "#FFA500")

recipe.getRecordName(string recipe, int id)

Returns the name of the given record from the selected recipe database.

String recipe refers to the recipe database.

Int Id refers to the Record ID of the record.

The return value is the name of the record.

Example: recipe.getRecordName("RecipeName", tag.read("Switch"));

recipe.setRecordName(string recipe, int id, string name)

Sets the name of a record and saves it to the name of the selected recipe database.

String recipe refers to the recipe database.

Int Id refers to the Record ID of the new record.

String name refers to the new name that will be added to the record.

The return value is undefined.

Example: recipe.setRecordName("RecipeName", tag.read("Switch"), "New Name");

recipe.setRecordId(string recipe, int oldID, int newId)

Updates the record ID from the selected recipe database.

String recipe refers to the recipe database.

Int oldId refers to the old Record ID of the record.

Int newId refers to the new Record ID of the record.

The return value is undefined.

Example: recipe.

setRecordId("RecipeName", tag.read("Switch"), tag.read("Switch") + 5);

recipe.importCsv(string recipe, Storage type, string path)

Replace recipe data with the data found in a CSV at the path.

String recipe refers to the recipe database.

Enter the number or string below as the user’s declared Storage type.

1: Storage.Local

2: Storage.Usb

3: Storage.SdCard

4: Storage.Ftp

String path refers to where to find the CSV file.

The return value is undefined.

Example: recipe.importCsv("RecipeName", 1, "RecipeScript.csv");

recipe.exportCsv(string recipe, Storage type, string path)

Saves recipe data in a CSV at the specified path.

String recipe refers to the recipe database.

Enter the number or string below as the user’s declared Storage type.

1: Storage.Local

2: Storage.Usb

3: Storage.SdCard

4: Storage.Ftp

String path refers to where to find the CSV file.

The return value is undefined.

Example: recipe.exportCsv("RecipeName", 1, "RecipeScript.csv");

page.isOpen(String name)

Returns the current status of the page being checked.

Name refers to the name of the page.

The return value is true if the page is open, and false if it is not.

Example: page.isOpen("Page 2");

page.isOpenIndex(Number index)

Returns the current status of the page being checked.

Number index refers to the index of the page to be opened.

The return value is true if the page is open, or false if it is not.

Example: page.isOpenIndex(1);