Label

(Use as an alternative to the TRACE LabelExpr identifier.)

String

Use to define the text that identifies the trace in the Trend Key.

Alsosee Use TrendSpec to Define a Multiple Trace Ad Hoc Trend.

To use an expression to define the value of the trace’s key label, use the TRACE LabelExpr identifier instead of the Label identifier.

LabelExpr

(Use as an alternative to the TRACE Label identifier.)

String

Use to define the text that identifies the trace in the Trend Key.

Alsosee Use TrendSpec to Define an Ad Hoc Trend’s Text Attributes.

To specify a string, rather than an expression, use the TRACE Label identifier instead of the LabelExpr identifier.

TraceStyle

Identifier value

Use to define the type of trace. Specify one of these values:

TraceLine, TraceStepFirst, TraceStepLast, TraceBarLine, or TraceBarFill.

Depending on the chosen TraceStyle, you might also want to specify the BarWidth or LineWidth.

Interval

Integer, string, or Identifier value

Use to specify the amount of time between each value shown on the trace.

If the TRACE’s <Data Mode> is Current, either specify the Interval as an integer, whereby the value has to be in seconds

or as a string, whereby the value has to be specified in the OPC Time Format.

If the TRACE’s <Data Mode> is ProcessedHistoric, you can specify the required Interval using either of the above value types. Alternatively, you can have ClearSCADA dynamically determine the Interval from the time period that is represented by each pixel on the x-axis. To do this, specify the identifier value PerPixel in this format:

If the TRACE’s <Data Mode> is ProcessedHistoric, use the corresponding SOURCE section’s AggregateId identifier to specify the algorithm that ClearSCADA uses to process the historic data. The trace depicts the resulting value for each resample Interval. Be aware that the AggregateId values are limited when the Interval is set to PerPixel(see Supported AggregateId Values).

BarWidth

(Only applicable if the TraceStyle is TraceBarLine, or TraceBarFill.)

Integer or string

Use to specify the amount of time that each bar represents.

Either specify the BarWidth as an integer, whereby the value has to be in seconds

or as a string, whereby the value has to be specified in the OPC Time Format

The BarWidth should not be greater than the Interval.

GapInterval

(Only applicable if the TraceStyle is TraceLine, TraceStepFirst, or TraceStepLast.)

Integer or string

Use to specify the maximum acceptable amount of time for a gap in the data. If no values were retrieved or calculated for a time period that exceeds this value, the trace will include a gap to indicate the lack of data at that time.

Either specify the GapInterval as an integer, whereby the value has to be in seconds

or as a string, whereby the value has to be specified in the OPC Time Format

RawOverlay

(Only applicable if the TRACE’s <Data Mode> is ProcessedHistoric.)

Boolean

Use to specify whether raw data markers are displayed on the Trend, in addition to the trace that indicates the processed data.

Alsosee Use TrendSpec to Define a Multiple Trace Ad Hoc Trend.

If a trace has multiple sources (see Multiple Source Traces), the RawOverlay has to be set to False.

PointLimit

(Only applicable if the TRACE’s <Data Mode> is RawHistoric.)

Integer

Use to specify the maximum number of values that can be shown on the Trend.

ExtendToNow

Boolean

Use to specify whether the trace line is extended from the last reported value to the current time (‘now’).

UpdateMode

(Only applicable if the TRACE’s <Data Mode> is Current.)

Identifier value

Use to specify when the trace is updated.

Specify one of these values:

Interval, Change, or IntervalAndChange.

(If a trace has multiple sources (see Multiple Source Traces), the UpdateMode has to be set to Interval.)

System

(Only required on ClearSCADA systems that have Multiple Databases)

String

Use to specify which ClearSCADA database supplies the trace’s source.

A trace’s System identifier has to contain the same value as the corresponding YAXIS StateSystem identifier (see YAXIS Optional Values).

LineColour

RGB

Use to specify the RGB color of the trace line.

Alsosee Use TrendSpec to Define an Ad Hoc Trend’s Colors.

LineStyle

(Only applicable if the TraceStyle is TraceLine, TraceStepFirst, or TraceStepLast.)

Identifier value

Use to specify the appearance of the trace line.

Specify one of these values:

DashSolid, DashDash, DashDot, DashDashDot, or DashDashDotDot.

Alsosee Use TrendSpec to Define a Multiple Trace Ad Hoc Trend.

LineWidth

(Only applicable if the TraceStyle is TraceLine, TraceStepFirst, or TraceStepLast.)

Real

Use to specify the thickness of the trace line, in points.

MarkerLimit

Integer

Use to specify the maximum number of value markers that can be shown on the trace.

MarkerSize

Integer

Use to specify the size of the trace’s value markers. Specify a size from 1 to 5, inclusive.

MarkerStyle

Identifier value

Use to specify the appearance of the trace’s value markers. Specify one of these values:

Diamond, Square, or Cross.

Alsosee Enable Users to Specify Which Traces to Include on an Ad Hoc Trend.

ShowMarkers

Boolean

Use to specify whether Trend Markers are shown on the trace.

ClearSCADA only takes into account the values of any other Marker identifiers if ShowMarkers = True (and in the case of ProcessedHistoric traces, when RawOverlay = True).

ShowTrace

Boolean

Use to specify whether the Trend Trace is shown on an ad hoc Trend.

ShowAnnotations

(Only applicable if <Data Mode> is RawHistoric or ProcessedHistoric.)

Boolean

Use to specify whether Trend Annotations are shown on the trace.

Alsosee Use TrendSpec to Define an Ad Hoc Trend’s Text Attributes.

ClearSCADA only takes into account the values of any other Annotation identifiers if ShowAnnotations = True.

AnnotationStyle

(Only applicable if <Data Mode> is RawHistoric or ProcessedHistoric.)

Identifier value

Use to specify the appearance of any annotation markers.

Specify one of these values:

Diamond, Square, or Cross.

AnnotationSize

(Only applicable if <Data Mode> is RawHistoric or ProcessedHistoric.)

Integer

Use to specify the size of any annotation markers on the trace. Specify a size from 1 to 5, inclusive.

IncludeGoodQualityData

(Only applicable if <Data Mode> is RawHistoric or ProcessedHistoric).

Boolean

Use to specify whether Good quality values are used for the trace. By default, Good quality values are used (IncludeGoodQualityData is True).

If you want to exclude Good quality values so that the trace only represents Uncertain and/or Bad quality values, you should set IncludeGoodQualityData to False.

IncludeUncertainQualityData

(Only applicable if <Data Mode> is RawHistoric or ProcessedHistoric).

Boolean

Use to specify whether values of Uncertain quality are used for the trace. By default, Uncertain quality values are used (IncludeUncertainQualityData is True).

If you want to exclude Uncertain quality values so that the trace only represents Good and/or Bad quality values, you should set IncludeUncertainQualityData to False.

IncludeBadQualityData

(Only applicable if <Data Mode> is RawHistoric or ProcessedHistoric).

Boolean

Use to specify whether Bad quality values are used for the trace. By default, Bad quality values are used (IncludeBadQualityData is True).

If you want to exclude Bad quality values so that the trace only represents Good and/or Uncertain quality values, you should set IncludeBadQualityData to False.

We recommend that you set IncludeBadQualityData to False if your system has advanced drivers that use the Log Historic Value on Communication Failure feature. This is because Log Historic Value on Failure can cause ‘extra’ historic values to be logged, and these ‘extra’ values can cause undesirable results when viewing historic data. For more information, Quality Filter for Historic Views.