The line list options object is used to configure information used for the roll up of segments to records. In the out-of-the-box system, there is one line list options object, created in configuration top for all plants to use. You can define specific line list options in a plant to override this delivered control.
The line list options object is a generic rollup configuration control that could be used to roll up other objects in the future. However, it is currently only used to configure the rollup of segments to records.
To define specific line list options for a plant, do the following:
-
Create a new ENS definition to control the rollup of segments to records.
-
Create a new line list options object (File > New > Line List > Line List Options). Use the values described below for the line list options properties.
Line list options
The properties of the line list options object are as follows:
Name - The name of the line list options object is controlled by an ENS definition to name it after the plant.
Description - The description of the line list options object.
Rollup target classdef - The object to which items are rolled up. For line lists, this should be set to the line list record (SPFLLALineListRecord).
Rollup ENS definition - The ENS definition used to define the rollup of segments to records.
Source to target rollup reldef - The relationship definition between the source object to the target object. For line lists, this value should be SPFLLALineListRecordLineSegment.
Rollup source classdef -The object to be rolled up. For line lists, this value should be set to the line segment (SPFLLALineSegment).
ENS definition for rollup
An ENS definition also defines the set of properties to be used for rollup of the line segments into line list records. The delivered ENS definition for determining which line segment properties are used in the rollup is LLASegmentRecordRollup.
Include all properties that you want to roll up in the rollup ENS definition. The rollup properties must be on both the rollup target object and the rollup source object.
-
Properties included in the line list record ENS should also be in the rollup ENS definition.
-
Properties to be consolidated instead of rolled up should not be included in the rollup ENS definition.
-
If a line list record already exists that matches properties (using the ENS definition) on the line segments being rolled up, the software adds those segments to the appropriate line list record when you use the Rollup command.
-
Only properties included in the ENS definition are copied from the line segment to a new line list record (that is, for the case where an existing line list record that matches the rollup property values was not found).
Resolving data conflicts when creating line list records
When line list segments are rolled up into line list records, the process data from the line list segments are copied to the line list records using the configured ENS definition or mapping created for the consolidation process. However, in some cases, the data for properties that are not part of the ENS definition does not match across the line segments. The way the system manages this situation varies by the type of the property.
|
Property type |
How conflicts are managed |
|---|---|
|
String |
The conflicting property values are stored as a comma-separated list for the property on the line list record. |
|
UoM |
When the AllowUoMValueAText setting on the property is set to True, the conflicting property values are stored as a comma-separated list for the property on the line list record. |
|
Other property types |
Conflicting values for the property among the line list segments results in a conflict that must be resolved before the rollup can be completed. When this conflict is found during rollup, you can choose an appropriate process value for each property with conflicts in the Resolve Conflicts - Rollup dialog box. The selected values are copied to the line list record. |
The Resolve Conflicts - Rollup dialog box also appears if conflicting data is found during re-rollup.