Commands Tab for Equipment Classes

On the Commands tab for an equipment class shown below, you can configure menu items that will be copied to equipment nodes that are created using the equipment class. Menu items can open displays, run reports, open reports, and more. By creating them for an equipment class, you can save time by not having to recreate menus over and over again for each equipment node that you define. You can override any of the commands for any equipment node that is created using this equipment class.

 

Tip: For more information about equipment classes, refer to the Creating Equipment Classes for Use as Templates topic.

Tip: You can use aliasing in some command fields so that when the equipment class is used for creating equipment, prompts will allow the creator to easily fill in the blanks. For more information, refer to the Using Aliases in an Equipment Class topic.

 

Commands Sub-tab for Equipment Class

 

To open the Commands sub-tab, in the Project Explorer, expand the AssetWorX provider then, in the navigation tree, create or navigate to the equipment class you are defining runtime menu commands for. This displays the Equipment Class tab, with the Properties tab on top. Click the Commands sub-tab. Use this tab to define runtime menu options for the equipment class. Menu options can open displays, run reports, open reports, and more. Each prompt on this sub-tab is described below. For more information, refer to the Setting up Runtime Menus for Equipment topic.

 

Options on the Commands sub-tab are described below:

Commands that you can choose include (listed alphabetically):

The following parameters are available for the majority of commands:

* This field can contain one or more aliases, which will be used as prompts when an equipment node is created using this equipment class. For more about aliases and their uses, refer to the Using Aliases in an Equipment Class topic.

 

The remainder of this topic describes each command and its parameters.

Acknowledge Command

The Acknowledge command allows a user to acknowledge alarms in an associated AlarmWorX64 Viewer.

When an alarm requires acknowledgement, the typical steps for acknowledging the alarm are:

  1. An alarm is triggered and is added to the alarm grid on which it is used. (Only enabled alarms are triggered. An alarm that is not enabled is considered to be an alarm that is not ready for use or an alarm that is being decommissioned. Alarms are enabled when they are added to the alarm server, using the General tab of the AlarmWorX64 Server tag form.)

  2. A runtime operator acknowledges the alarm; this puts the alarm into an Acknowledged state.

  3. When the alarm condition no longer exists, the alarm leaves the grid as long as its acknowledgement requirements have been met.

Acknowledge Command

 

Parameters for the Acknowledge command are:

Return to the Commands Tab topic

Add Favorite Command

The Add Favorite command inserts a new favorite asset in target Asset Navigator's favorites folder.

 

Add Favorite Command

 

Parameters for the Add Favorite command are:

Return to the Commands Tab topic

Add Operator Comment

The Add Operator Comment command Adds an operator comment for data selected in a target control. Supported by TrendWorX Viewer and Fault Viewer.

 

Add Operator Comment Command

 

Parameters for the Add Operator command are:

Return to the Commands Tab topic

Apply Discard Command

The Apply Discard command performs a selected action in a target GridWorX64 Viewer control.

 

Apply Discard Command

 

Parameters for the Apply Discard command are:

Return to the Commands Tab topic

Batch Command

The Batch command defines a "mini program" to execute multiple commands using conditions and jumps, which can be based on step results.

 

Batch Command

 

Parameters for the Batch command are:

Steps Properties

STEP

ACTION

Configure Command Window

CONTINUE WITH

Depending on how a step is executed, one of three continuation paths is chosen. These include:

Option Definitions:

Return to the Commands Tab topic

Call Method Command

The Call Method command calls a method or task from within Platform Services. These methods can be parameterized or not and range from simple data writing to complex calculations or actions. Due to this, the parameters field can be filled with whatever is necessary to pass to the custom method. Methods must be coded in C# and can be used in combination with the Jscript.NET scripting engine of GraphWorX64. The ICONICS Application Note "GENESIS64 - Custom Server Methods in Platform Services" includes two examples and instructions to begin creating a custom command.

 

Call Method command

 

Parameters for the Call Method command are:

Return to the Commands Tab topic

Create Pen Command

The Create Pen command adds a new pen into a target TrendWorX Viewer using the following parameters.

 

Create Pen Command

 

Parameters for the Create Pen command are:

Return to the Commands Tab topic

Custom Command

The Custom Command command was designed to allow future expansion to third-party integration and reference to the API. Custom Commands are virtually unlimited.

 

Custom Command Command

 

Parameters for the Custom Command command are:

Return to the Commands Tab topic

Delete Pen Command

The Delete Pen command remove a pen from a TrendWorX64 Viewer. This command requires a target which can be a TrendWorX64 Viewer in GraphWorX64. The name of the pen and the target viewer are the parameters for this command.

 

Delete Pen Command

 

Parameters for the Delete Pen command are:

Return to the Commands Tab topic

Edit Pen Command

The Edit Pen command will edit a pen within a TrendWorX64 Viewer. This command requires a target which can be a TrendWorX64 Viewer in GraphWorX64 or PortalWorX_SL. The name of the pen and the target viewer are the parameters for this command. You can create this command within the GraphWorX64 Viewer and Asset Navigator controls. You can apply this command to the TrendWorX64 Viewer control.

 

Edit Pen Command

 

Parameters for the Edit Pen command are:

Return to the Commands Tab topic

Edit Trend Chart Command

The Edit Trend Chart command

 

Edit Trend Chart Command

 

Parameters for the Edit Trend Chart command are:

Select values Window

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Execute Commands Command

The Execute Commands command executes commands that already exist on that particular Equipment. The added commands can be specified in the Commands text entry field, each separated by a semicolon (with no spaces). The Execute Commands command can be made visible while the executed commands are invisible. This command is only available for AssetWorX, because GraphWorX64 has its own support for aggregating pick actions.

 

Execute Commands Command

 

Parameters for the Execute Commands command are:

Return to the Commands Tab topic

Expand Collapse Command

The Expand Collapse command will allow users to change the levels shown in the Asset Navigator by expanding or collapsing the assets to a desired level.

 

Expand Collapse Command

 

Parameters for the Expand Collapse command are:

Return to the Commands Tab topic

Export Data Command

Export Data Command

 

Parameters for the Export Data Command are:

Return to the Commands Tab topic

Export Image Command

The Export Image command is a GraphWorX64-Only Command that will allow users to export an image of a GraphWorX64 file based on the current view or the entire display.

 

Export Image Command

 

Parameters for the Export Image command are:

Return to the Commands Tab topic

Export Statistic Command

The Export Statistic command just shows the Export Statistics dialog using default options (no intermediate dialog is displayed). The parameter ReportName is currently unused as the report doesn’t provide a dedicated field.

 

The report generated by the Export Statistic command with a TrendWorX64 Viewer target has been enhanced to be more customizable. Previously, running the Export Statistic command with a target of a TrendWorX64 Viewer would perform the same action as selecting the Export Statistics button in the trend viewer toolbar, which was to display a report that then could be saved to CSV or other formats.

 

Now, the action taken by the command depends on the TrendWorX64 Viewer configuration. The command itself has no new parameters, but in the target TrendWorX64 Viewer, the user can select the chart, go to the Data tab, and select the Configure button next to Statistics Export. Similar to the preexisting data export configuration, the statistics export configuration presents various configurable settings for the statistics report, including which columns to include in the report and whether to export visible pens.

 

By default, the Export Statistic command now immediately saves the report to a CSV file, but the user can return to the legacy behavior of opening the report page by selecting Use legacy export in the statistics export settings.

 

This functionality of the Export Statistic command is currently only supported in desktop (WPF) and Universal Windows Platform (UWP). Equivalent functionality for the HTML5 trend viewer is planned for a future version.

 

Export Statistic Command

 

Parameters for the Export Statistic command are:

Return to the Commands Tab topic

Go To Location Command

The Go To Location command is used with EarthWorX targets and works similar to the Ribbon menu option in the EarthWorX contextual Ribbon in GraphWorX64 by allowing users to input a Latitude, Longitude and Zoom (based on the Unit pulldown). Executing this command will zoom or otherwise change the view of the target EarthWorX window.

 

Go to Location Command

 

Parameters for the Go To Location command are:

Return to the Commands Tab topic

Group Command

The Group command, used to target AlarmWorX64 or GridWorX Viewers, will allow pre-configured or dynamic grouping of data grids using the parameters offered. Grouping can encompass one or more levels by using the Add Action or be removed entirely using the Reset Action.

 

Group Command

 

Parameters for the Group Location command are:

Return to the Commands Tab topic

Load Alarm Configuration Command

The Load Alarm Configuration command opens an AlarmWorX file of alarms inside an AlarmWorX Viewer when a runtime user selects the menu option. The prompts you must provide for a Load Alarm Display command look like this:

 

Load Alarm Configuration Command

 

Parameters for the Load Alarm Configuration command are:

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Load DataGrid Configuration Command

The Load DataGrid Configuration command, used with GridWorX, will locate and load a GDXX (WPF-based) file format that contain GridWorX Configurations. Users can specify the file name and path of the file as well as any desired target.  

 

Load DataGrid Configuration Command

 

Parameters for the Load DataGrid Configuration command are:

Return to the Commands Tab topic

Load Energy Data Command

The Load Energy Data command opens an Energy AnalytiX Configuration (.eav) file created using the Energy AnalytiX Web part.

 

The prompts you must provide for a Load Energy Data command look like this:

 

Load Energy AnalytiX Data Command

 

Parameters for the Load Energy Data command are:

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Load Executed Reports Command

The Load Executed Reports command loads a folder of reports for viewing. Note that this command does not execute the reports, it simply displays executed reports that reside in a folder. For example, you can store energy reports in one folder and use this command to open the folder of reports for display when a runtime user selects it from the equipment's right-click menu. (Alternatively, you can use the Load Report command to open one report that has been executed.) The prompts you must provide for a Load Executed Reports command look like this:

 

Load Executed Reports Command

 

Parameters for the Load Executed Reports command are:

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Load Executed Transactions

The Load Executed Transactions command loads a list of data transaction reports from a specific folder into a target BridgeWorX Viewer.

 

Load Executed Transactions Command

 

Parameters for the Load Executed Transactions command are:

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Load Facility Data Command

The Load Facility Data command opens an FDDWorX Configuration (.fav) file created using the FDDWorX Web part.

 

The prompts you must provide for a Load FDDWorX Data command look like this:

 

Load Facility Data Command

 

Parameters for the Load Facility Data command are:

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Load Graphics Display Command

The Load Graphics Display command opens a GraphWorX display file inside a GraphWorX Viewer when a runtime user selects the menu option. The prompts you must provide for a Load Display command look like this:

 

Load Display Command

 

Parameters for the Load Graphics Display command are:

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Load KPI Dashboard Command

Load KPI Dashboard Command

 

Parameters for the Load KPI Dashboard command are:

The string representing the active filter on a dashboard can be copied. This string can be pasted into the Load KPI Dashboard command's Parameters property. This makes it easy to create a command that can open dashboards with filters already applied.

 

Users can create or open a saved dashboard, apply a desired filter, then, in the dashboard header, select More > Share > Filter String > Clipboard. Users can then paste the string into the Parameters property of the Load KPI Dashboard command. User can also use More > Share > Dashboard Name > Clipboard to get the properly formatted name of a dashboard for the Load KPI Dashboard command.

 

Return to the Commands Tab topic

Load Mobile Layout Command

Load Mobile Layout Command

Return to the Commands Tab topic

Load Report Command

The Load Report command displays a report for viewing. Note that this command does not execute the report, it simply displays a report that has already been executed. For example, if a report ran over the weekend, this command can open it for display when a runtime user selects it from the equipment's right-click menu. (Alternatively, you can use the Load Executed Reports command to open an entire folder of reports.) The prompts you must provide for a Load Report command look like this:

 

Load Report Command

 

Parameters for the Load Report command are:

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Load Schedule Control Configuration Command

The Load Schedule Control Configuration command opens a calendar inside a Schedule Control when a runtime user selects the menu option. You can create this command within the GraphWorX64 Viewer and Asset Navigator controls. You can apply this command to the Schedule Control. The prompts you must provide for a Load Schedule Control command look like this:

 

Load Schedule Control Configuration Command

 

Parameters for the Load Schedule Control Configuration command are:

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Load Transaction

The Load Transaction command Loads a data transaction report by name into a target BridgeWorX Viewer.

 

Load Transaction Command

 

Parameters for the Load Transaction command are:

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Load Trend Configuration Command

The Load Trend Configuration command opens a TrendWorX trend file inside a TrendWorX Viewer when a runtime user selects the menu option. The prompts you must provide for a Load Trend Display command look like this:

 

Load Trend Configuration Command

 

Parameters for the Load Trend Configuration command are:

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Load Url Command

The Load Url command loads a URL when a runtime user selects the menu option. You can use this command to load a frequently-used online tool, a corporate Web site, a vendor's page for placing an order, or an interactive page for requesting service.

 

Load Url Command

 

Parameters for the Load Url Command are:

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Log Event Command

The Log Event command allows for logging custom simple or tracking events.

 

Log Event Command

 

Parameters for the Log Event Command are:

Return to the Commands Tab topic

Login Dialog Command

The Login Dialog command will pop up the Security Login Dialog when triggered. Similar to the original Pick Action in GraphWorX64, this command will function similarly in other client types by allowing access to the dialog via command execution.

 

Login Dialog Command

Parameters for the Login Dialog Configuration command are:

Return to the Commands Tab topic

Navigate Command

The Navigate command allows users to supplement web navigation buttons with GraphWorX64 buttons or Asset commands to provide alternative navigation schemes. The Steps option allows users to determine how far the navigation goes while the Navigation option allows movement backward and forward. Home, End and Now refer to the TrendWorX64 Freeze mode where they can be used to Navigate the Summary View and manipulate trend data.

 

Navigate Command

 

Parameters for the Navigate command are:

Return to the Commands Tab topic

Open URL Command

The Open Url command opens a URL when a runtime user selects the menu option. You can use this command to go to a frequently-used online tool, a corporate web site, an vendor's page for placing an order, or an interactive page for requesting service.  

 

The prompts you must provide for an Open Url command look like this:

 

Open URL Command

 

Parameters for the Open URL command are:

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Phone Call Command

The Phone Call command lets a runtime user make a phone call from a Windows phone (using MobileHMI) to a pager. Refer to the MobileHMI documentation for requirements.

 

The prompts you must provide for a Phone Call command look like this:

 

Phone Call Command

 

Parameters for the Phone Call command are:

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Print Command

The Print command allows users to print the current view or entire control in GraphWorX64. An option to use a White Background can be selected, but users should be careful of white text as it may not show up with this option selected. Targeting can be used to print embedded GraphWorX64 displays.

 

Print Command

 

Parameters for the Print command are:

Return to the Commands Tab topic

Recipe: Copy Command

You can create the Recipe: Copy command within the GraphWorX64 Viewer and Asset Navigator controls. It copies a selected recipe from the tree explorer.

 

Recipe: Copy Command

 

 Parameters for the Recipe: Copy command are:

Return to the Commands Tab topic

Recipe: Delete Command

You can create the Recipe: Delete command within the GraphWorX64 Viewer and Asset Navigator controls. It deletes the selected recipe from the tree explorer.

 

Recipe: Delete Command

Return to the Commands Tab topic

Recipe: Download Command

You can create the Recipe: Download command within the GraphWorX64 Viewer and Asset Navigator controls. It downloads the current values to the OPC tags.

 

Recipe: Download Command

 

Parameters for the Recipe: Download command are:

Return to the Commands Tab topic

Recipe: Load Command

You can create the Recipe: Load command within the GraphWorX64 Viewer and Asset Navigator controls. It loads a recipe dataset (rcdps:) into the GridWorX Viewer.

 

Recipe: Load Command

 

Parameters for the Recipe: Load command are:

Return to the Commands Tab topic

Recipe: New Command

You can create the Recipe: New command within the GraphWorX64 Viewer and Asset Navigator controls. It creates a new child recipe item under the selected recipe in the tree explorer.

 

Recipe: New Command

 

Parameters for the Recipe: New command are:

Return to the Commands Tab topic

Recipe: Save Command

You can create the Recipe: Save command within the GraphWorX64 Viewer and Asset Navigator controls. It applies changes to the dataset that is loaded into the GridWorX Viewer.

 

Recipe: Save Command

 

Parameters for the Recipe: Save command are:

Return to the Commands Tab topic

Recipe: Upload Command

You can create the Recipe: Upload command within the GraphWorX64 Viewer and Asset Navigator controls. It uploads the values from the OPC tags to the GridWorX Viewer. Changes aren't saved until the Save Command is executed.

 

Recipe: Upload Command

 

Parameters for the Recipe: Upload command are:

Return to the Commands Tab topic

Refresh Command

You can use the Refresh command to refresh a display requiring an updated view.

 

Refresh Command

 

Parameters for the Refresh command are:

Return to the Commands Tab topic

Remove Favorite Command

The Remove Favorite command removes a specific or selected favorite in a target Asset Navigator.

 

Remove Favorite Command

 

Parameters for the Remove Favorite command are:

Return to the Commands Tab topic

Run Report Command

NOTE: The Run Report command is for the 32-bit version of ReportWorX. For executing ReportWorX64 reports, see Executing Reports on a Button Press or Command.

 

The Run Report command executes a report using ICONICS ReportWorX when a runtime user selects the menu option.

 

Run Report Command

 

Parameters for the Run Report command are:

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Run Script Command

Run Script Command

 

Parameters for the Run Script Command are:

Return to the Commands Tab topic

Run Transaction Command

The Run Transaction command executes an ICONICS BridgeWorX transaction when a runtime user selects the menu option. For example, if you use BridgeWorX to populate a database table for us in reports, you can use this command to launch that service.

 

Run Transaction Command

 

Parameters for the Run Transaction command are:

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Save Configuration Command

The Save Configuration command can be used for any of the .NET Controls (e.g., AlarmWorX64 AWXX and AWXXS files). The file type used to save the configuration is entered at the end of the file path and name in the FileName field. Select the Overwrite checkbox to allow for changing the configuration of an existing one when saving.

 

Save Configuration Command

 

Parameters for the Save Configuration command are:

Return to the Commands Tab topic

Scan Command

The Scan command

 

Scan Command

 

Parameters for the Scan command are:

Return to the Commands Tab topic

Schedule Clear Override Command

The Schedule Clear Override command allows you to Clear an Override to an existing Schedule, similar to that set via Runtime Tab in the Schedule Control in GraphWorX64.

 

Schedule Clear Override Command

 

Parameters for the Schedule Clear Override command are:

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Schedule Event Command

The Schedule Override command allows users to perform common scheduling actions for the ScheduleWorX64 Viewer control. The command can be used to create, edit, and delete events. The Action parameter determines which of the three subcommands (Create, Delete, or Edit) is executed.

 

Schedule Event Command

 

Parameters for the Schedule Event command are:

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Schedule Override Command

The Schedule Override command allows you to activate an Override for an existing Schedule, similar to that set via the Runtime Tab in the Schedule Control in GraphWorX64.

 

Schedule Override Command

 

Parameters for the Schedule Override command are:

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Select Asset Command

The Select Asset command allows users to do a few things. First, it can target the Asset Navigator and tell the control to select an asset (more commonly triggered from GraphWorX64). Second, it can target TrendWorX64 Viewers to parse the asset’s equipment properties to trend the values. No configuration is necessary for the points, as they will automatically be added as pens to the targeted viewer. Finally, the Select Asset command can allow users to dynamically switch Pivot Pages in GraphWorX64 by using the "tab" option dropdown and typing in the name of the Pivot Page (or index of the page).

 

Select Asset Command

 

Parameters for the Select Asset command are:

Return to the Commands Tab topic

Select Element Command

The Select Element command allows users to provide secondary navigation for tabs, views, rows or objects separate from what is available in the .NET Viewers. Each Element must be named uniquely for Select Element to find them (this is enforced by GraphWorX already).

 

Select Element Command

 

Parameters for the Select Element command are:

Return to the Commands Tab topic

Select View Command

Select View Command

 

Parameters for the Select View command are:

Return to the Commands Tab topic

Send Alert Email Command

Send Alert Email Command

 

Parameters for the Send Alert Email Command are:

Return to the Commands Tab topic

Send Alert Page Command

Send Alert Page Command

 

Parameters for the Send Alert Page Command are:

Return to the Commands Tab topic

Send Email Command

The Send Email command lets runtime users send an e-mail from a Windows phone (using MobileHMI). Refer to the MobileHMI documentation for requirements.

 

The prompts you must provide for a Send Email command look like this:

 

Send Email Command

 

Parameters for the Send Email command are:

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Send Message Command

The Send Message command lets the runtime user send a message from a Windows phone (using MobileHMI) to a pager. Refer to the MobileHMI documentation for requirements.

 

The prompts you must provide for a Send Message command look like this:

 

Send Message Command

 

Parameters for the Send SMS command are:

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Send Notification

The Send Notification command can be used to send new push notifications to clients subscribed to specific topic(s).

 

Send Notification Command

 

Parameters for the Send Notification command are:

Return to the Commands Tab topic

Set Fault Incident State

The Set Fault Incident State command changes the state of all, specific, or selected faults in a target Fault Viewer. Can optionally show a runtime dialog to confirm or fine-tune the parameters.

 

Set Fault Incident State Command

 

Parameters for the Set Fault Incident State command are:

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Set Filter Command

The Set Filter command is most commonly used with AlarmWorX64 Viewers to apply or remove filters from Viewers dynamically, but can also be applied to GridWorX Viewers, allowing users to configure a filter name or create a new filter (specifying a new previously unused filter name) based on the Filter Name and Expression. The Filters are Server Side for Historical Alarms and Client Side for Real Time Alarms.

 

Set Filter Command

 

Parameters for the Set Filter command are:

Return to the Commands Tab topic

Set Freeze Mode Command

The Set Freeze Mode command, used with TrendWorX64, will toggle Freeze Mode in a TrendWorX64 Viewer.

 

Set Freeze Mode Command

 

Parameters for the Set Freeze Mode command are:

Return to the Commands Tab topic

Set Global Aliases Command

The Set Global Aliases command sets a global alias theme when a runtime user selects the menu option. This is helpful for runtime users who must review GENESIS64 displays or reports for different locations for which unique global aliases are set. Refer to Global Aliasing for more information.

 

The prompts you must provide for a Set Global Aliases command look like this:

 

Set Global Aliases Command

 

Parameters for the Set Global Aliases command are:

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Set Global Color Theme Command

Global Color Theme Command

 

Parameters for the Set Global Color Theme are:

Return to the Commands Tab topic

Set Language Command

The Set Language command allows operators to trigger a change in language by entering in the Culture name listed in the Language Aliasing Engine. This name must match the Language Aliasing Configuration on the server in order to trigger the change. Any asset or GraphWorX64 button can be used to trigger the change.

 

Set Language Command

 

Parameters for the Set Language command are:

Return to the Commands Tab topic

Set Period Command

The Set Period command, used with TrendWorX64, allows the Period to be changed from AssetWorX Assets and GraphWorX64 Pick Actions.  Targeting a viewer (or enabling Drag & Drop) will allow operators to use an alternative method to changing the Period (existing methods are the Trend Period Toolbar in the TrendWorX64 Viewer and the GraphWorX64 Contextual Ribbon menu).

 

Set Period Command

 

Parameters for the Set Period command are:

Return to the Commands Tab topic

Set Time Range Command

The Set Time Range command, used with TrendWorX64, allows the time range to be changed from AssetWorX Assets and GraphWorX64 Pick Actions. Targeting a viewer (or enabling Drag & Drop) will allow operators to use an alternative method to changing the Time Range (existing methods are the options available in the GraphWorX64 Contextual Ribbon menu).

 

Set Time Range Command

 

Parameters for the Set Time Range command are:

Return to the Commands Tab topic

 

Set Value Command

A significant limitation of the preexisting Write Value global command is that it can only write to tags that are visible to all clients on a system. This means that local tags, such as the "localsim" tags that are unique to a given GraphWorX64 display, could not be written to using the Write Value command. 

 

The Set Value command was introduced to bridge this gap. Set Value works like Write Value except it takes a target parameter, and the target executes the write. This means that the command can target a particular GraphWorX64 display and write to a localsim tag on that display, including local variables and properties. 

 

Here are some places where Set Value allows you to write to local tags where you couldn't before: 

Return to the Commands Tab topic

 

Set Visibility Command

The Set Visibility command is a flexible command used to target GraphWorX64 Objects (Visual ObjectType), TrendWorX64 Pens (Pen ObjectType), and any grid-based layout like AlarmWorX64 and GridWorX (Column ObjectType). The command will allow operators to Show, Hide or Toggle the visibility of any one of these object types by issuing the command from an AssetWorX asset or GraphWorX64 Pick Action.

 

Set Visibility Command

 

Parameters for the Set Visibility command are:

Note: Starting V10.97.2, Set Visibility command works with Table/Fault controls if targeting Columns.

 

Return to the Commands Tab topic

Show Details Command

Show Details

 

Parameters for the Show Details command are:

Return to the Commands Tab topic

Sort Command

The Sort command, used to target AlarmWorX64 or GridWorX Viewers, will allow pre-configured or dynamic sorting of data grids using the parameters offered. Sorting can encompass one or more levels by using the Add Action or be removed entirely using the Reset Action.

 

Sort Command

 

Parameters for the Sort command are:

Return to the Commands Tab topic

Switch Layout Command

The Switch Layout command will take a new Layout Name that is already configured and apply it to the current window. Multiple commands can be used in tandem to allow dynamic switching between more than two layouts.

 

Switch Layout Command

 

Parameters for the Switch Layout command are:

Return to the Commands Tab topic

Write Value Command

The Write Value command writes a value to another tag, a global alias, a language alias, or a conversion value, when a runtime user selects the menu option. For example, you might use this command to give runtime users the ability to switch a machine "off" or to set a thermostat to a specified temperature.  

 

The prompts you must provide for a Write Value command look like this:

 

Write Value Command

 

Parameters for the Write Value command are:

* If the equipment node was created using an equipment class, and this or other fields contain aliases (that is, variables that are surrounded by /? and ?/), you can replace the aliases with values that are appropriate for this equipment node by instantiating the aliases.

 

Return to the Commands Tab topic

Zoom Command

Zoom Command

 

Parameters for the Zoom command are:

The TrendWorX Viewer is the only type of control that currently supports this command. In order for a TrendWorX Viewer to "accept" the command properly in GraphWorX64, you need to:

  1. Give the TrendWorX Viewer a Name within the Properties panel and set the Target parameter of the "Zoom" command to match the TrendWorX viewer's new name.

  2. Enable "zoom mode" within the TrendWorX Viewer (accomplished in runtime by double-clicking on the trend to show the "TrendWorX runtime menu," then clicking the magnifying glass button within this menu).

The Unit and Zoom parameters work in tandem to set a desired zoom level. To zoom to a desired percentage relative to the original zoom level, set Unit to "Percentage" and "Zoom" to the desired zoom level percentage (e.g. "100" reverts the viewer to its original zoom level, "50" causes the viewer to zoom in by a factor of 2). To zoom to a desired scale factor relative to the original zoom level, set Unit to "Scale" and "Zoom" to a positive number (e.g. "1" reverts the viewer to its original zoom level, "2" causes the viewer to zoom out by a factor of 2). The "None" and "Level" values of the Unit parameter currently have no effect on the target TrendWorX Viewer.

 

It's possible to scale only the time (horizontal) or value (vertical) axis of the TrendWorX Viewer by setting the Axis parameter to "Time" or "Value," respectively. To scale both axes by the same amount, leave the parameter at its default value of "Both." Note that it is currently not possible to scale the two axes by different scale factors at the same time with only one pick action (though strategic use of two pick actions should allow you to accomplish this task when needed).

 

Return to the Commands Tab topic

 

See also:

Tabs for Equipment Classes (Templates)