Using a Comparison within the Acknowledge Command

When using the Acknowledge command within a GraphWorX64 viewer to be applied to an AlarmWorX64 Viewer control via a Dynamic (e.g. a separate button), you have the option of selecting 'Comparison' in the Acknowledge field (within the expanding 'CommandParameters' section), as shown below. Once 'Acknowledge' is selected, the remaining parameters below will update and you will then be able to enter your point of comparison within the 'Comparison' field itself, as highlighted below in the red box.


'Comparison' Selected in the 'Acknowledge' Command Parameters


When you use the Acknowledge command with a Comparison, you are acknowledging the alarms where your selected “Field” entry has the value specified in the “Comparison” entry. Note that the Comparison entry can also support wild cards, e.g.,  “*”.

You will also need to enter the specific Field to make the comparison.

 


'Field' Selected in the 'Acknowledge' Command Parameters



The syntax for this Field text entry box relies upon the AlarmWorX Viewer fields to be compared. We'll use the following AlarmWorX Viewer Grid, shown below, as an example. We'd like to use the Tag column for the comparison.

 


Example AlarmWorX Viewer Grid


Double-clicking the grid within GraphWorX64 (in Configuration mode) opens the Configure Your Control dialog box. Expanding the sample AwxView Control to the contained Tab then to the contained Grid allows you to select the 'Column' tab, as shown below.


Configure your Control Dialog Box


As you can see, all the columns used in our grid example are listed here - and this is where we can find the correct syntax for the Comparison. To get the correct syntax to use for the Comparison, just hover over your selected column name. In our example, we want to use the Tag column name which, when hovered over, provides a tooltip box containing "Field Name: OriginalSource Field Type: BaseConditionType Value String: String", as shown below.

 


Tooltip Containing Info for the Field Entry



The correct syntax is the Field Name and the Field Type combined with no spaces. In this example, that would be "OriginalSourceBaseConditionType", which is what we'll enter into the Field text entry (within the expanding 'CommandParameters' section), as shown below. We will also enter our point of Comparison, "Tank*" (with the wild card character "*"), in the Tag column, to acknowledge by.


Example of Acknowledge Command Using Comparison


When you put this display into Runtime mode, and trigger the command (in the example pictured below, via a Button dynamic), it will Acknowledge items (via comparison of the selected Tag column set via the Field entry) that match the criteria set within the Comparison entry (Tank*), as shown by the acknowledged item in the red box below.


Item Acknowledged via the Acknowledge Command Using a Comparison



Return to Acknowledge Command in GraphWorX64