Trends Guide - TRACE Mandatory Values (Using TrendSpec to Produce Ad Hoc Trends)

TRACE Mandatory Values

The TRACE section within a TrendSpec definition has to contain two mandatory values: <Data Mode> and <Y-Axis Name>.

You should specify the <Data Mode> before the <Y-Axis Name> and separate the two entries with a comma.

TRACE Mandatory Values
<Data Mode>	Identifier value	Use to define the type of data that the trace displays. Specify one of these values: Current, RawHistoric, or ProcessedHistoric (For information about the type of data that each option represents, see Add a Trace to a Trend.) Example: Current (for a trace that displays current data) Only specify an option other than Current if Historic is enabled for the database item that is the source of the trace (for points, Defining Historic Details for a Point; for accumulators, Tabs on Accumulator Forms). A Trace can only have multiple sources if an option other than RawHistoric is specified (see Multiple Source Traces). The <Data Mode> mandatory value is trace independent. As such, the traces on a multiple-trace ad hoc Trend can be assigned different <Data Mode> values to each other.
<Y-Axis Name>	String	Use to identify the y-axis that is associated with the trace. The <Y-Axis Name> is used internally within the TrendSpec definition to link a trace to its respective y-axis. As such, the <Y-Axis Name> in the TRACE section of a definition has to be identical to the <Y-Axis Name> in the corresponding YAXIS section (see YAXIS Mandatory Value). Example: ‘Sensor Value’ (for a y-axis that indicates a sensor’s value)

TRACE Mandatory Values

Mandatory Value

Type

Comments

Identifier value

Use to define the type of data that the trace displays.

Specify one of these values:

Current, RawHistoric, or ProcessedHistoric

(For information about the type of data that each option represents, see Add a Trace to a Trend.)

Example:

Current
(for a trace that displays current data)

Only specify an option other than Current if Historic is enabled for the database item that is the source of the trace (for points, Defining Historic Details for a Point; for accumulators, Tabs on Accumulator Forms).

A Trace can only have multiple sources if an option other than RawHistoric is specified (see Multiple Source Traces).

The <Data Mode> mandatory value is trace independent. As such, the traces on a multiple-trace ad hoc Trend can be assigned different <Data Mode> values to each other.

<Y-Axis Name>

String

Use to identify the y-axis that is associated with the trace.

The <Y-Axis Name> is used internally within the TrendSpec definition to link a trace to its respective y-axis. As such, the <Y-Axis Name> in the TRACE section of a definition has to be identical to the <Y-Axis Name> in the corresponding YAXIS section (see YAXIS Mandatory Value).

Example:

‘Sensor Value’
(for a y-axis that indicates a sensor’s value)

If required, you can specify one or more TRACE Optional Values after the above mandatory values in a TrendSpec definition.