Using a CygNet Grid in Run Mode

The CygNet Grid has numerous run-mode options:

  • If a column has been configured to Sort numerically, click that column header to sort the grid. Clicking the column header moves between the three states: sort ascending, sort descending, and unsorted. A small arrow indicates the sort order.

  • In the TWC Web view, if a cell in a numeric column contains a non-numeric value, a placeholder ({non-numeric}) will be shown in its place.

All grid headers contain a filtering tool to limit the rows displayed in the grid. Click Filter in Canvas / Filter in TWC to the right of a column header to filter the rows displayed in a grid based on values within the selected column. Two sets of qualifying filter criteria can be specified, and the criteria can be compounded (use all rules by selecting And or use either rule by selecting Or). The options in the filter tool are described below.

Filter in Canvas Native view

Filter Canvas tool

Canvas Grid Filter

  1. Select All — Click to Select All column elements to include in the filter.
  2. Select elements — Select the elements from the column on which to filter.
  3. Show rows with value that — Select an operator from the Show rows with value that drop-down menu. Operators include:
    • Is equal to
    • Is not equal too
    • Is null
    • Is not null
  4. <qualifying string> — Type a qualifying string to match the operator.
  5. And/Or — Select And to join one qualifying string to another. Or select OR to choose either qualifying string.
  6. Show rows with value that — Select an operator from the second Show rows with value that drop-down menu. Operators are listed above.
  7. <qualifying string> — Type a qualifying string to match the operator.
  8. Filter — Click Filter to limit the rows in the pane to the those that match the filter criteria.
  9. Clear Filter — Click Clear Filter to remove the filter criteria and return all rows.
  

Filter in CygNet TWC web view

Filter TWC tool

TWC Grid Filter

  1. Filter — Select an operator from the Filter drop-down menu. numeric filtering on values such as <, <=, >, and >= is supported. Operators include:
    • Is equal to
    • Is not equal to
    • Starts with
    • Contains
    • Does not contain
    • Ends with
    • Is null
    • Is not null
    • Is empty
    • Is not empty
    • Has no value
    • Has value
  2. <qualifying string> — Type a qualifying string to match the operator.
  3. And/Or — Select And to join one qualifying string to another. Or select OR to choose either qualifying string.
  4. Filter — Select an operator from the second Filter drop-down menu. Operators are listed above.
  5. <qualifying string> — Type a qualifying string to match the operator.
  6. Filter — Click Filter to limit the rows in the pane to the those that match the filter criteria.
  7. Clear Filter — Click Clear Filter to remove the filter criteria and return all rows.

Not supported by TWC

  • If a generic column allows editing, click any cell and type a new value. Edited values are not saved anywhere but in the grid, but they can be saved or otherwise manipulated via script.

The Alarm Grid and CygNet Grid can be configured to send a single facility or multiple facilities to other controls using the Facility sender mode property settings. This property determines what data to pass from grid to grid, from a grid to other controls on your current screen, or from a grid to other controls on a hyperlinked screen.

Facility Sender Mode

The Facility sender mode property determines how facilities are sent to other controls. There are four options:

  • None — No facilities are sent. This is the default value.
  • Single click — A single click on a row will send a single facility to a receiving control on the same screen.
  • Double click — A double click on a row will send a single facility to a receiving control on the same screen. This option supports two actions when a row is double-clicked: 1. Sending a facility to anther control on the same screen; and 2. Sending a facility to another screen. See the note below.
  • All facilities — As soon as all facilities are received they will be sent to the receiving control on the screen. No click is required.

Note:

If Double click is selected for the Facility sender mode property, and Hyperlink is selected for the Double click mode property, and a Hyperlink mode and Screen path are configured, two actions will be performed when a row is double-clicked:

  1. the selected facility will be sent to any control(s) on the screen configured to receive its facility from the grid

    - and -

  2. the selected facility will be sent to the screen configured in the Screen path property.

Script Event

If Double click is selected for the Facility sender mode property, and Script is selected for the Double click mode property, the selected facility will be sent to any control(s) on the screen configured to receive its facility from the grid, and the script event Double Click Cell will fire using the facility received from the grid. Scripting is not supported by TWC

Usage Notes

  • An Alarm Grid and a CygNet Grid can act as a facility receiver, or a facility sender, or both.
  • An Alarm Grid and a CygNet Grid will send a single facility on a single or double-click.
  • Since the Alarm Grid is point-based it can have multiple rows representing a single facility. During facility sending (on either a single or double-click), the Alarm Grid will send only one facility to the receiving control. When sending facilities in All facilities mode, only the unique list of facilities is sent.
  • An Alarm Grid and a CygNet Grid will send All facilities to other controls as soon as they are received by the grid.
  • An Alarm Grid will send All facilities only if new facilities have been received.
  • A CygNet Grid can have one facility per cell, however during facility sending to an Alarm Grid, the receiving Alarm Grid will show all the alarm rows that belong to the single facility.

The grid supports hyperlinking to another screen via a double-click action. The Facility sender mode must be set to Double click. The Double click mode must be set to Hyperlink. Set the desired mode in the Hyperlink mode property. Set the destination Screen file source and Screen path.

Double click a row in the grid to open another screen. Depending on the Hyperlink mode selected, the following will happen:

  • Open — Open a designated screen in a new window (default).
  • Modal open — Open a designated screen in a new modal window. A modal window is a type of popup that is subordinate to a parent window that appears in front of the parent and usurps the parent’s control. You cannot interact with the parent window until the modal window has been closed. This type of window is used when you want a user to focus on or interact with information in the popup.
  • Open and close — Open a designated screen in a new window and close the current screen. Not supported by TWC
  • Replace — Replace the current screen with the designated screen.
  • Replace with navigation — Replace the current screen with the specified screen and add a navigation toolbar to the top of the screen. Not supported by TWC
  • Close — Close the current screen. Not supported by TWC

Note: Grid cells can display a different facility from that configured for a grid row. The double-click hyperlink action will pass the cell or row’s facility to other controls on the screen configured to receive it AND to the receiving screen.

When an alarm is reported to the CAS, its state is "unacknowledged", meaning that the alarm is new and that a user or the system has not acknowledged its presence. An unacknowledged alarm may be identified by the color settings for the control (background, text, border, ring, bar, fill, or marker color), if configured to represent the point state of the associated point. Additionally, some controls may blink to warn of a point in alarm, if configured to do so.

Acknowledge the alarm from the context menu:

  • Select the object when it is displaying an alarm color or blink action. Some controls can be configured to blink to indicate that the object's point has an unacknowledged alarm.
  • Right-click the object and select Acknowledge alarm from the context menu. The Acknowledge alarm option is removed once the alarm is acknowledged.

See the control properties for more information about configuring alarm acknowledgment options.

  

Context menu

Canvas Native view
Context Menu

Right-click the context menu to access several CygNet system dialog boxes for information about the point and facility associated with the object, where you can modify properties and values as needed. The associated point/UDC and facility is identified in the context menu, so you know what you are viewing.

  • Select the object.
  • Right-click and select any of the following options from the context menu:
    • Current value — Open the Point Properties dialog box
    • Acknowledge alarm — Acknowledge an unacknowledged alarm
    • History Arrow right
      • History values — Open the History Values dialog box
      • Alarm history — Open the Alarm History dialog box
    • Point configuration Arrow right
      • Comments — Open the Comments tab of the PNT Editor
      • Alarm settings — Open the Alarm Settings dialog box for the point type
      • All settings — Open the PNT Editor
      • Questionable state — Open the Edit Questionable State dialog box
      • Alarm suppression — Open the Alarm Suppression Settings dialog box
    • Facility configuration — Open the Properties for <Facility> dialog box
    • Add to chart — Add point values to a default chart (described below)
  

Context menu

Grid cell context menu
Point configuration

Note: The context menu options change depending on the point configuration:

  • If the control is configured to display long point ID, the Facility configuration menu option is hidden.
  • If the facility description is blank, then the menu will show the facility ID in the Facility configuration option.
  • If the point description is blank, then the menu will show the UDC/long point ID (based on configuration).

Several controls support the option to add point values as a new series to a default chart, providing additional visual context for trended data:

  • Select the object, right-click and select Add to chart from the context menu, then select:
    • New chart — Add values to a new default chart
    • New chart with rollups — Add rolled-up values to a new chart. Four labelled rollup series will be added to the default chart:
      • Real Time — No rollup
      • Min — Calculated minimum
      • Max — Calculate maximum
      • Mean — Calculated mean
    • Chart n — Add values to a previously opened default chart
  • The point values for the time range specified for the screen will be displayed as a series in the default chart
  • You can add as many default charts as you want
  • You can add a series from different controls to same default chart, or from the same control to different default charts
  • See Default Chart for more information about the default chart feature
  • See Using a Chart in Run Mode for more information about hiding and removing series from a default chart
  • See Viewing Data in a TWC Ad Hoc Chart for information about adding a CygNet point presented in the web view to an on-demand or ad hoc chart.
  

Context menu

Grid cell context menu
Add data to default chart

The CygNet Thin Web Client supports its own context menu visible in the web view.

Perform the following actions from the TWC context menu:

  • Right-click on a control to view the context menu for a selected point. When the context menu is active the main part of the page is dimmed. The context menu is divided into four sections:
    1. Acknowledge Alarm — If the point is in alarm, the Acknowledge Alarm icon will indicate this state. Click to acknowledge it and the Acknowledge Alarm will disappear.
    2. Current Value — View read-only Current Value attributes for the selected point.
    3. Alarm Summary — Click the toggle switch to view Alarm Summary values.

      From here you can edit alarm threshold values or the alarm priority in the context menu, which will be written back to the point on the CygNet host server. A warning will show if you do not have the appropriate security access level to edit points.

      1. Click Edit button (Edit) then click on the Value or Priority you want to edit.
      2. Enter a new value or use the spin control to increase or decrease the value.
      3. Click Edit button (Save) to write the new value back to the point configuration on the CygNet host server.
      4. Or click Cancel edit (Cancel) to abort and return to the read-only mode.
    4. Chart — Click the toggle switch to view a quick Chart for a selected point. The series shows the last eight hours of value history and will update with each new point value received. Hover over any point in the series to reveal a small popup showing the UDC, point value, and timestamp. From here you can add the currently viewed point to a new or existing ad hoc chart which will display in a new browser tab. Note that an ad hoc chart is not a template. Any saved chart is hard-coded with specific point tags.
      1. Click Add to new chart to add the selected point to a new ad hoc chart. A new chart titled NewChart<n> will open in a new browser tab, where you can rename, duplicate, or delete the chart. You can also view the chart data in a grid and export data to an Excel file.
      2. Click Existing chart(s) to open a drop-down list of previously saved ad hoc charts.
      3. Click the + <chart name> to add the selected point to that chart. The selected chart will open in a new browser tab.  Note: If you add a point to an existing chart that is already opened in another tab, then the point is added to that open chart but TWC does not shift focus to that tab. You will remain on the current tab.
      4. Click Existing chart(s) again to close the drop-down list of existing charts.

      Once saved an ad hoc chart can be viewed from the main CygNet TWC web view via the Saved Charts (Saved Charts ) button. See Viewing Data in a TWC Ad Hoc Chart for more information about working with ad hoc charts.

  • Click Close the context menu (Close) to close the context menu and return to the TWC page that launched the menu.

See Using the Thin Web Client Context Menu for more information.

  

TWC Context Menu - Current Value Normal

TWC Context Menu:
Current Value Normal

TWC Context Menu - Current Value in Alarm

TWC Context Menu:
Current Value in Alarm

TWC Context Menu - Alarm Summary Edit

TWC Context Menu:
Alarm Summary in edit mode

TWC Context Menu - Chart

TWC Context Menu: Chart