You are here: Section Rules Reference > Section Rules Summary > CreateChartSeries

CreateChartSeries

Use this section level rule to get data from extract records and include it as series data in a chart. The system uses the data exactly as it exists in the extract record. There is a syntax you can use to create a search mask which will search for and get an extract record. You can also specify where in that record the data resides. Additionally, you must specify the chart and series to which the data will be added.

Typically, you will use the DeleteDefaultSeriesDatabefore you use this rule. You should always use the PurgeChartSeriesafter you use this rule.

Syntax

CreateChartSeries (Chart,Series,SearchMask,DataDefinitions)

Parameter

Description

Chart

The name of the chart (as defined in the FAP file) to which the series data will be added.

Series

The name of the series that data is to be added to. If the series is not defined in the FAP, a default series is created.

SearchMask

The search mask to be used to find the extract record from which data is retrieved. The search mask should contain one or more offset,data pairings. For example, if you want to find the extract record with the text HEADERREC at offset 20 (base 1), the search mask would be 20,HEADERREC. Additional offset length pairings can be appended. For example:

20,HEADERREC,50,XYZ

means find the record with HEADERREC at offset 20 and XYZ at offset 50. See the topic Search Criteria for more information.

DataDefinitions

One or more offset,length pairings used to obtain data values from the extract record defined by the search mask. For example, if five data values existed at offsets 110, 120, 130, 140 and 150 each one 10 characters in length, the DataDefinitions field would look like this:

110,10 120,10 130,10 140,10 150,10.

There is a space between each offset,length pair, unlike the SearchMask which has all its offset,data pairs separated by a comma (,).

See also