Plant Information Catalog (PIC)

You can move a group or an individual tag from Plant Information Catalog to an empty cell, on to an image, or on a tag trend. You can reposition the tags to the desired location. The selected tag can be viewed in trends and current views in Live and Design modes. The changes/configurations to the tag are reflected in Preview. In the selected cell, the group or the tag is displayed along with an icon. For details on the icons to the groups or tags, see Property Sets

You can move an entire PIC group to a selected cell. On moving, the group along with the tags are displayed in the cell. In the selected cell, you can search for individual tags under the group using the Search tool, reset your search criteria, and copy the group and its contents to the clipboard. You can do a fuzzy search of tags and tag groups within all the dashboards. You can search for the tags and groups based on the names, description, and other keywords. You can couple your own functions on selecting a node. On selection, some event handler functions are available which provides the details of the selected node. You can access the function details using https://<server>:<port>/XMII/JSDOC.

Prerequisites

You must be assigned the following UME roles:

XMII_SSCE
XMII_SSCE_PIC

For more information on users and roles, see User Management.

Features

The behavior of tags is different in Live and Design modes.

Live Mode

In Live mode, a line chart (tag trend) is displayed by default when you add a tag to an empty cell. You can configure additional display and query parameters to the tag. For more details on configuring display and query parameters, see the following:

Configuring Display Templates in the Activities section of Display Templates
Configuring Query Templates in the Activities section of Query Templates

You can toggle between current and trend views using (Trend Mode). In Trend view, the tag is rendered as a line chart. In Current view, the default or static image appears and on hovering over the tag, the tool tip displays the tag name along with the path. You can configure the following for the selected tag:

Threshold values
Highlight the threshold values using Color Picker
Icons
Graphics
Mapped values
Display units for string and numeric data types

Note
You cannot display the units for Boolean data type

End of the note.
Display tag names
Call Javascript methods on events such as change in the tag value or a click on the tag

Design Mode

When you move a tag to an empty cell, the static or default image is displayed. The behavior and properties of the tag are the same as in Live mode.

Following are the display options in Current and Trend views for Live and Design modes:

Views	Behavior of Tags
Views	Trend Mode	Current Mode
Live with empty cell	A line chart is displayed. The tag configurations are displayed at the side of the chart.	Displays only the tag name
Design with empty cell	Displays only the tag name Default display template image along with tag path is displayed	Displays only the tag name
Live with image	Removes the existing image displayed in current mode and renders a line chart along with tag details	Displays the tag on top of the image.
Design with image	Default display template image along with tag path is displayed	Displays the tag on top of the image.
Live with another object other than image	A warning message to replace the existing object with the tag appear. A corresponding line chart appears.	Displays only the tag name.
Design with another object other than image	Replaces the existing object with the default tag image and displays the tag path.	Replaces the existing object with the tag

When you position a tag on an object other than an image, a warning message to replace the existing object with tag appears. A line chart or a static image along with the tag path appears depending on Live or Design mode.

Note Note

The current values of the tag are fetched from the web socket. If web socket server is unavailable, the tags are fetched from the catalog query. By default, the catalog query is executed every 20 seconds. You can change the interval in the field tagRefreshInterval.

End of the note.

Activities

To configure the tag properties, do the following:

Select the tag and choose Configure Tag Display.
A dialog box appears.
From the Rules tab, do the following:
1. If the tag is of type Numeric or String, you can choose the operators from the Operators column.
  For more details, see the Features section of Tag Functions.
2. You can manually enter the values in the Value column or select a property from the value help. A Property dialog box appears.
  On selecting typical value, the property value is fetched by a query and compared with the tag value. The manually entered value or the typical value fetched by the query is compared with the tag value. If the conditions are matched, the text or value provided in Mapped Value column is displayed in Preview mode.
  
  Note
  If the tag is of type Boolean, the Value column is disabled.
  
  End of the note.
3. Choose the relevant color from the Color column.
  A Color Picker dialog box appears.
4. You can either choose a graphic or a icon from Graphics Type and Icons column respectively.
5. Enter any value or text in the Mapped Value column.
  If the condition is true, the value or text provided in the Mapped Value column is displayed instead of actual tag value.
The Display tab contains the following fields:
- Show Tag Name: The name entered is displayed in the Preview mode
- Value Display: Displays the values of the selected tag
- Show Units: Displays the unit of measure of the selected tag
- Size: Displays the image in the entered pixel size
The Events tab has the following:
- On Value Change: Call the method mentioned in Method Name field when there is a change in the value of the tag
- On Click: Call the method mentioned in Method Name field when you click on the tag.
  1. Select the Show Trend checkbox to display the tag trend in a separate dialog box when you click on the tag or the area corresponding to the tag.
  2. To call a method in the Javascript Function tab, select Call Javascript Function and enter a name in Method Name field.
Choose Apply.
To configure additional display parameters, choose (Configure Display Parameters)..
To configure additional query parameters, choose (Configure Query Parameters).

Configuring a Group

Select the group from PIC and move to an empty cell.
The group along with the tags are displayed in a tree format in the empty cell.
Select the group or a tag and choose (Configure Group).
A dialog box appears.
Choose Call Javascript Function.
Enter a name in Method Name field.
Choose Apply.
To edit the methods, choose Source Code page.
For more information on editing the methods, see Source Code.