FMS History Data Groups

FMS history data groups are used to send historical data to FMS. Multiple instances of an FmsHist data group in a device template file are possible. They get their data from one or more Enron history data groups (that is, data groups where dgCat="enronHistory").

At least one Enron history support data group must be defined. If more than one is defined, only the first support data group instantiated for a device is used. Support data groups are found in the supportDg element of your sample template. Mapping between FMS history data group element and FMS data items is within the histItems section of fmsMaps in the device template file. See also FMS History Items.

FMS history data groups use a maximum of 10 characters for their name. The first 7 of which characters must be FmsHist. The last 3 characters are entirely free-form. For example, FmsHistH could signify FMS hourly history.

The TmOrient data group element does not appear in a device template file, but it commonly appears as part of a DDS transaction in the CygNet DDS Viewer utility (DdsViewer.exe). This element indicates whether a device supplies history in leading or trailing time. If its value is 1, the history record uses leading time. If its value is 2, the history record uses trailing time.

For more information, see the following subsections:

• Example
• Structure and Components
• To Create a Data Group

For more information about working with device template files, see Device Template Files.

Example

Click here to see an example of the data group   <FmsHistH niceName="FMS Hourly History" baseOrd="1" maxCnt="4" recordMinutes="60" histType="GM"> <dgElements/> <supportDg> <EnrHrly required="true"/> </supportDg> <uccRecvParms> <SDate desc="Start Device Date/Time" required="true"/> <EDate desc="End Device Date/Time" required="true"/> </uccRecvParms> </FmsHistH>

Structure and Components

Click here to see the structure and components of the data group   <!-- To get FMS history, you must include both the histType and recordMinutes attributes along with their respective values. Any Enron history data group (where dgCat="enronHistory") can be identified as a support data group. -->   <FmsHist recordMinutes="" histType="" tmFormat=""> <dgElements/> <supportDg> <SupportDataGroup required="true"/> </supportDg> <uccRecvParms> <UISParameter/> </uccRecvParms> </FmsHist>

To Create a Data Group

1. Using a text editor or XML editor, open the device template file to which you want to add data groups.
2. Define a new data group.
   1. Define a supportDg element.
   2. Define all support data groups from which you require data.
   3. Define a dgElements element.
   4. Define a uccRecvParms element in the data group.
   5. Define one or more RecParmName elements.
3. Define any other required data groups.
4. Validate and load your template.