Main Properties

The main properties tab contains the most central parameters of the tracker process unit. Most of these parameters must be considered for the TPU to work properly.

ProcessUnit

The process unit parameter decides on which Process Unit the TPU works. The set of process units available is governed by the database configuration.

Process Unit ID

This is a read only parameter showing the database id of the selected process unit.¨

Tracker process Unit ID

This is a read only parameter showing the assigned database id of this actual TPU.

Task name

The task name is a descriptive name of the TPU. The name of the TPU in the ModFrame environment will be the name of the process unit followed by the task name surrounded by brackets, e.g ProcessUnitName[TaskName]. This parameter is required.

Tracking Ident Definition

This property defines the ident definition of the Tracking Identifiers of the materials residing in this tracker process unit. 

Tracking Ident Pattern

The tracking ident pattern used to enable tracking ident validation. The Tracking Ident Pattern is a regex used to specify the syntax of the tracking identifier. If the tracking identifier does not fit the regex, the tracking identifier is considered invalid. The Tracking Ident Pattern Violation Handling parameter decides how invalid tracking identificators are handled.

Leave the property blank to disable tracking ident validation.

Tracking Ident Pattern Violation Handling

This parameter decides the handling of invalid tracking identifiers. The alternatives are:

  • Violation not allowed. No database registration is executed, and an error message is will be issued.
  • LIFO. The material is registered but not traced. (No genealogy will be registered) The behavior will be LIFO
  • FIFO. The material is registered but not traced. (No genealogy will be registered) The behavior will be LIFO.

Tracking Ident Duplicate handling

Per definition, tracking identifiers must be unique within a transaction. This parameter is used to handle handle cases with non-unique tracking identificators. The alternatives are:

  • Duplicates not allowed. No database registration is executed, and an error message is will be issued.
  • LIFO. The material is registered but not traced. (No genealogy will be registered) The behavior will be LIFO.
  • FIFO. The material is registered but not traced. (No genealogy will be registered) The behavior will be LIFO.

Enable Group Identification

This property enables group identification in this tracker process unit. Group identification makes it possible to reference multiple material entities by the use of one single group identifier. When group identification is enabled, a new property named Group Ident Definition will appear for specification of the Ident definition of the group identifier.

Group Ident Definition

This property is used to specify the ident definition of the group identifier when group identification is enabled.

Amount handling

This parameter declares how to register material amount in this TPU. The alternatives are:

  • Default. A default amount will always be registered, even if the native transaction contains amount information.The amount registered can be specified by the Default amount parameter.
  • Continued. The material shall inherit amount information from the previous TPU. Until the genealogy is established, the value of the Default amount  parameter will be used. "
  • Specific. The material will be registered with amount provided by the native transaction. If the native transaction does not contain amount information, the value of the Default amount parameter will be registered.

Default amount

This parameter decides the default amount to be registered on materials entering this TPU. The Amount Handling parameter decides when the default amount will be used.

Material Quality Handling

This parameter defines how to register material quality in this TPU. The options are:

  • Default material quality. A default material quality will always be registered, even if the native transaction message contains material quality information. All quality information from transaction messages will be discarded. The default material quality can be specified by the Default Material Quality parameter.
  • Continued material quality. The material will inherit material quality information from the parent material in the previous TPU. Until the genealogy is established, the value of the Default Material Quality parameter will be registered. All quality information from transaction messages will be discarded.
  • Transaction specific material quality. It is expected that transaction messages will contain quality information for the material. When the TPU receives quality information for the material, this will be registered. If no quality information is received, the functionality will be as for the Continued material quality option.

Default Material Quality

This parameter decides the default material quality to be registered on materials entering this TPU. The Material Quality Handling parameter decides when the default amount will be used.

Article Handling

This parameter controls how to register articles in this TPU. The options are:

  • No article. There will be no article registration in this tracker process unit.
  • Default article. A default article will always be registered, even if the native transaction message contains article information. All article information from transaction messages will be discarded. The default article can be specified by the Default Article parameter.
  • Continued article. The material will inherit article information from the parent material in the previous TPU. Until the genealogy is established, the value of the Default Article parameter will be registered. All article information from transaction messages will be discarded.
  • Transaction specific article. It is expected that transaction messages will contain article information for the material. When the TPU receives article information for the material, this will be registered. If no quality information is received, the functionality will be as for the Continued article option.

Default Article

This parameter declares the default article to be registered on materials entering this TPU. The Article Handling parameter decides when the default amount will be used.

Material Outdate time

This parameter declares how long (seconds) a material can stay inside this TPU before considered outdated. A reasonable value for this property is 120% of the maximum physical retention time in the process unit. If the parameter is set to 0 (zero) the outdate will be disabled.

Material Outdate Quality

This parameter is used to define the Material Quality to be assigned to materials that are outdated. If <Keep current> is selected, the current Material Quality of the material will be preserved after the outdate.

Transaction pending period

This parameter defines how long (seconds) transactions that cannot execute because of missing dependencies may stay in the pending queue.

Pending Period Parent Relation

This parameter defines how long (seconds) to try to establish parent relations for materials entering this tracker process unit.

Pending Period Child Relation

This parameter defines how long (seconds) materials that enter this tracker process unit shall wait for child material to establish their parent relation.

Pending Period Material Attribute Relation

This parameter defines how long (seconds) materials that enter this tracker process unit shall wait for material attribute relations to be registered.