Production values are recorded automatically through values passed via tag collectors, such as counts and status, and those values set by the OEE engine, such as Mode, Standard Rate, shift etc.

The MES Value Editor component allows for these collected production values to be edited or deleted and for new values to be inserted (with or without updating the values of subsequent entries to reflect the count value change caused by the new entry).

This provides an easy method for correcting production values where the line was set to the wrong mode, line was recorded as running when it was in fact down, production counts are off, or the wrong product code or work order was selected.

In this Section

Tag Collector Types

Recall that production values such as equipment modes, states and counts are recorded 24/7.  Tag collectors will not record values if the equipment item is not enabled in the production model. If the recorded values need to be modified as production counts were off or the line mode was captured as Maintenance when it should have been Production, these scripting functions or the MES Value Editor component, can be used to correct the values.

The Tag Collector Types are used by the MES Value Editor component and the script functions listed below to read and modify production values recorded via tag collector paths and by the OEE engine.

Each tag collector type may have a different datatype and some tag collector types have a key (where there is more than one stored value for the tag collector type). Examples of these would be MES Counters, where the Tag Collector Type Equipment Count would have the default Material Out and any other user added mes counter names. Additional Factors would also use the key to distinguish between the user defined additional factors.

The Equipment State tag collector has an additional parameter called the Auxiliary Value. The getTagCollectorValue() and updateTagCollectorValue() have an overloaded function to handle the auxiliary value name for this tag collector type.

 Scripting Functions for Tag Collectors

OEE Rates are stored as "per minute"

The Sepasoft OEE module always stores rates (including the Standard Rate) in "per minute" equivalent, in order to streamline functionality (regardless of the units set in GUI-based components such as the OEE Material Manager). However, when utilizing the Tag Collector, you are storing values directly to the database, so you must convert the values to "per minute" before writing values to these tags. Rate values in the Value Editor will also be "per minute".

Tag Collector Type

Data TypeKeyAuxiliary ValueDescription

Equipment Additional Factor 

StringName of user defined additional FactorsN/ASee Additional Factors for more details
Equipment CountLongName of user defined MES counters and the default Material OutN/AValue of the MES Counter as defined in the key. See MES Counters for more details
Equipment Cycle CountLongN/AN/ASee Analysis Datapoints and Settings - Cycle Count for more details
Equipment NoteStringN/AN/AAny downtime notes added through the tag collector or entered through the OEE Downtime Table component
Equipment Infeed Count Scale Float8N/AN/ASee Infeed Count Scale for more details
Equipment Infeed Units StringN/AN/ASee Infeed Units for more details
Equipment ModeInt4N/AN/ASee Equipment Modes for more details
Equipment Operation UUIDStringN/AN/AUnique Identifier for currently running operation
Equipment Outfeed Units StringN/AN/ASee Outfeed Units for more details
Equipment Package CountFloat8N/AN/ASee Package Count for more details
Equipment Product CodeStringN/AN/AProduct code currently being processed on this equipment
Equipment Rate Period StringN/AN/ASee Rate Period for more details
Equipment Reject Count ScaleFloat8N/AN/ASee Reject Count Scale for more details
Equipment Reject UnitsStringN/AN/ASee Reject Units for more details
Equipment Schedule CountFloat8N/AN/AAmount of product that should have been produced (Target) based on the schedule rate
Equipment Schedule DurationFloat8N/AN/ADuration of scheduled run
Equipment Schedule RateFloat8N/AN/ASee Schedule Rate for more details
Equipment Shift StringN/AN/AThe shift as defined in the Ignition Schedule Management component or passed to the Shift Tag Collector
Equipment Standard RateFloat8N/AN/ASee standard rate for more details
Equipment StateStringN/A EquipmentUUIDThe unique identifier for the equipment
Equipment StateInt4N/A StateEquipment state value.  Note that this may be a negative value if the original value was over-ridden.
Equipment StateInt4N/A OriginalState The original equipment state before it was updated
Equipment StateStringN/A DifferedToUUID If the original EquipmentUUID is changed using the Downtime Table then the new uuid is DifferedToUUID
Equipment StateStringN/ADifferedState If the original state is changed using the Downtime Table then the new state is DifferedState
Equipment Target Changeover TimeFloat8N/AN/AAmount of time in minutes set for Target Changeover. See Changeover Duration for more details
Equipment Work OrderStringN/AN/AWork order processed on this equipment
Line Infeed Count Equipment UUID StringN/AN/AUnique identifier for the equipment where the line infeed count came from
Line Outfeed Count Equipment UUIDStringN/AN/AUnique identifier for the equipment where the line outfeed count came from


When there are multiple values within a tag collector, this specifies which one to show. As an example, there can be multiple MES counters for the Equipment Count tag collector type. If not needed, pass an empty string. In other words it is the name of the MES counter or the name of the Additional Factor. 

Insert Value Before or After 

  • Select the value to be changed
  • Click on the button or  button.
  • Set the new time stamp and change the value.
  • (for tag collector types Equipment Count and Equipment Cycle Count only) Check/uncheck Update following values? (to update all subsequent entries).
  • Click Save.

Editing and Deleting Value

  • Edit - Click on the value you wish to edit and select Edit.
  • Provide the new value and click Save.
  • Delete - Click on the value you wish to delete and select Delete.

Exporting Values

  • Select the Tag Collector Type to be exported and click Export.

  • When the save window appears, name the file to be exported and click Save.

Importing Values

  • Select the Tag Collector Type to import to and click Import.

  • Use the File open dialog box to select the .xml file to be imported and click Open.

  • No labels