Attributes to Return

The following CIMPLICITY attributes can be returned to a Proficy Portal display:

Attribute

Returns

Value

The value of the point. This value is a "process value". This means that, in addition to the value, the quality and time information is returned to Proficy Portal. Various Proficy Portal display components make use of this extended information. For example, the Time chart will use the time information from a process value to plot the point and the Grid will give a visual indication of bad quality. This will be a string value unless the As Numeric check box is selected.

Raw Value

The raw value of the point. This value is a "process value" (see explanation in previous Value description). This will be a string value unless the As Numeric check box is selected

Time Stamp

The time this point record was logged. This is a date value.

Alarm State

The alarm state of the point. This is a string value (for example, "Normal", "Alarm High", "Alarm Low", "Warning High", or "Warning Low").

Quality

The CIMPLICITY quality flags for the point. Refer to the CIMPLICITY documentation for the meaning of the individual bits in the flag. This is an integer value.

Engineering Units

The engineering units for the point. This is a string value.

User Flags

The user flags for the point. This is a string value.

Resource

The resource ID configured for the point. This is a string value.

Point ID

The ID of the point. This is a string value.

Time Last Logged

The time the Previous Value was logged. This is a data value.

Previous Value

The previously logged value of the point (for the same logging event). This will be a string value unless the As Numeric check box is selected.

The Value, Raw Value, and Previous Value will be returned as strings unless the As Numeric check box is selected (since Proficy Portal does not have access to the point configuration and cannot determine whether the point is numeric).

If the point is numeric, and you do not select the As Numeric check box, you will be restricted in what you can do with the point. For example, you will not be able to select any of the numeric aggregation functions (such as Average) and you will not be able to graph the values. In addition, sorting (in the Grid component, for instance), may not work as expected (e.g., "100" will sort before "12").

If the point is not numeric, and you do select the As Numeric check box, you may receive a runtime error message, such as "Error converting data type varchar to float. Error Code: 8114", indicating that the string value cannot be converted to a number.

See Also

To set attributes to return