Skip to main content

Setup

Navigation:

Navigation menu showing the Setup selection in the OEE module

Example:

Complete Setup screen showing configuration tabs and location tree

Description:

  • The Setup screen allows users to configure the OEE model, including defining States, Modes, Downtime Reasons, and other OEE Configurations. This screen is essential for customizing the OEE tracking system to fit the specific needs of the manufacturing operation.

How to use:

  • To populate the OEE Configurations, States, Modes, and Downtime Reasons tabs, the user must first select a location from the location tree on the left side of the screen. This selection will determine which configurations are displayed and modified.

OEE Configuration​

Example:

OEE Configuration tab with fields for modes, downtime, performance and quality settings

OEE Configuration Workflow​

  1. Select a location from the dropdown menu to configure OEE settings for that specific location.
  2. Set the Max Record Duration and Prune Days.
  3. Set the Max Flush Interval and the Max Time Between Executions.
  4. Fill out the Mode Expression.
  5. Configure the Availability settings:
  6. Configure the Performance settings:
  7. Configure the Quality settings:
  8. Configure the Production Order Source.
  9. Save the configuration by clicking the Confirm button at the bottom of the screen.

OEE Configuration Fields​

Import​

Imports the OEE configurations from a CSV or JSON file. The imported file should match the expected format exported from Tamaki MES to ensure data integrity.

Export​

Exports the OEE configurations for the selected location to a CSV or JSON file. This can be useful for backup purposes or for transferring configurations between different instances of Tamaki MES.

Delete​

Deletes the OEE configuration for the selected location. This will not affect any existing OEE Records at this location, they will remain.

Enabled​

Toggles the OEE tracking for the selected location.

Max Record Duration​

Maximum duration for an OEE record in seconds. Normally, the following events cause an OEE record to cut over to the next record:

  • OEE Mode change at the location.
  • Standard rate change at the location.
  • Production order change at the location.
  • [future] Operation start or end at the location.
  • [future] Shift start or end at the location.

If none of those events occur within the Max Record Duration, the OEE record will to cut over to the next record automatically. The purpose of this is to control the granularity of the records. Changing this value will not affect existing records, but will apply to new records created after the change.

Prune Days​

Number of days to retain OEE records in the database before deleting. (If blank, records will be kept indefinitely)

Max Flush Interval​

Maximum time oee data being flushed into the database from the data collection service.

Max Time Between Executions​

Maximum number of seconds between data collection evaluating data.

Mode Expression​

The Expression Field is evaluated to an integer value corresponding to a Mode's code of the location is bound to the OEE model.

Availability​

Enable Availability​

Enables availability tracking for the OEE Records. This allows the system to track when the location is running and when it is not, providing insights into the operational efficiency of the equipment.

State Expression​

This is where the Oee State's code number is specified for this location State. This can be a static value but will most likely be a tag binding to reflect the PLC's value for the state of the machine Expression Field.

Downtime Reason Source​

Opens a dropdown with the following options:

  • Manual: The downtime reason will be manually selected by the user when a downtime event occurs using the Downtime Entry page.
  • Expression: The downtime reason will be determined by the Downtime Reason Expression field.
Downtime Reason Expression​

This is where the Downtime Reason's fault code is specified for this location Downtime Reason. This can be a static value but will most likely be a tag binding to reflect the PLC's value for the fault code of the machine Expression Field.

Alarm Path​

This defines the tag path where alarms related to this location are configured. Any alarms triggered under this path will be captured and associated with the corresponding equipment.

Performance​

Enable Performance​

Enables performance tracking for the OEE Records. This allows the system to track the production count and rate of the location.

Production Count Unit of Measure​

The unit of measure for the Production Count. This is used to define how the production count is measured, such as in pieces, kilograms, or liters.

Production Rate Time Unit​

The time unit for the production rate, such as seconds, minutes, or hours. This is used to define how the production rate is calculated.

For example, if this field is set to Minutes, and the Production Count Unit of Measure is set to Pound, then the production rate will be calculated in Pounds per Minute.

Production Count Expression​

This is where the production count value is specified for the location Production Count. This can be a static value but will most likely be a tag binding to reflect the PLC's value for the current production count at the machine Expression Field.

Production Count Overflow Value​

The tag capturing production count will roll over to 0 when it reaches this value. This is used to calculate the production count.

Standard Rate Source​

Opens a dropdown with the following options:

Standard Rate (UoM/Time Unit)​

The fixed value for the Standard Rate of the location, defined in the unit of measure and time unit specified in the Production Count Unit of Measure and Production Rate Time Unit fields. This is used to define the expected production rate for the location.

Standard Rate Expression (UoM/Time Unit)​

This is where the value for the Standard Rate is specified for the location. This can be a static value but will most likely be a tag binding to reflect the PLC's value for the standard rate for the product running at the machine Expression Field.

Quality​

Enable Quality​

Enables quality tracking for the OEE Records. This allows the system to track the waste count and rate of the location.

Quality Strategy​

Opens a dropdown with the following options:

Quality Count Expression​

The Expression Field where the PLC tag for the Good Count or Waste Count of the location is bound to the OEE model.

Quality Count Overflow Value​

The tag capturing waste count will roll over to 0 when it reaches this value. This is used to calculate the waste count.

Production Order​

Production Order Source​

Opens a dropdown with the following options:

  • None: No production order will be tracked for the location.
  • Expression: The production order will be determined by the Production Order Expression field.
Production Order Expression​

This is where the name or id of the Production Order running at the location. This can be a static value but will most likely be a tag binding to reflect the PLC's value for the current production order name running at the machine Expression Field.

States​

Example:

States configuration tab showing list of operational states with their codes and calculation types

State Workflow​

Create New State​

  1. Click on the Create New button to create a new state.
  2. Fill out the fields in the popup that appears (see Edit or Create New State Popup Fields for details).
  3. Click the Confirm button to save the new state.

Edit State​

  1. Select a state from the list on the right side of the screen.
  2. Click on the Edit button to open the edit popup.
  3. Modify the fields in the popup as needed (see Edit or Create New State Popup Fields for details).
  4. Click the Confirm button to save the changes.

State Fields​

Import​

Imports the OEE states from a CSV or JSON file. The imported file should match the expected format exported from Tamaki MES to ensure data integrity.

Export​

Exports the OEE states for the selected location to a CSV or JSON file. This can be useful for backup purposes or for transferring configurations between different instances of Tamaki MES.

Delete​

Deletes the selected state.

Edit​

Opens the following popup to edit the selected state (in this case, "Downtime"):

Edit state popup with fields for state name, code, calculation type and color selection

Refer to Edit or Create New State Popup Fields for details on the popup.

Create New​

Opens the following popup to create a new state:

Create new state popup with empty fields for defining state properties

Refer to Edit or Create New State Popup Fields for details on the popup.

Edit or Create New State Popup Fields​

Enabled​

Toggles the state on or off.

Name​

The name of the state. This should be a descriptive name that clearly indicates the purpose of the state (e.g., "Running", "Downtime", "Setup").

State Calculation Type​

This is a dropdown that allows the user to select how the OEE record of the state will be handled. The options are:

  • Idle: This is the default state for the OEE record, indicating that the location is not currently running or producing anything.
  • Running: This is the state for the OEE record when the location is actively producing items. This state is counted towards the OEE calculation as running time.
  • Downtime: This is the state for the OEE record when the location is not producing items due to a planned or unplanned downtime event.
  • Starved: This is the state for the OEE record when the location is not producing items because it is waiting for input from a previous location in the production line.
  • Blocked: This is the state for the OEE record when the location is not producing items because it is waiting for output to be accepted by a subsequent location in the production line.
Interruption Location​

This is a dropdown that allows the user to select an interruption location.

The interruption location is the location that is causing the state of the selected location to be set to the selected state.

Here are a few examples of states and their corresponding interruption locations:

  • State is Downtime: The interruption location would be left blank, because downtime doesn't occur as a result of another location.

  • State is Starved: The interruption location would be the location that is directly before the selected location. This is because, for the location to be starved, the location before it in the production line must not be outputting what the selected location needs to run.

  • State is Blocked: The interruption location would be the location that is directly after the selected location. This is because, for the location to be blocked, the location after it in the production line must not be accepting an input from the selected location.

State Code​

This is the integer code for the state, matching the PLC tag that indicates the state of the location. This code is used to identify the state in the PLC and should be unique for each state.

State Code​

This is the integer code for the state, matching the PLC tag that indicates the state of the location. This code is used to identify the state in the PLC and should be unique for each state.

Color​

The color associated with the state, used for visual representation in the OEE timeline.

Notes​

The optional comments or explanation about the state.

Modes​

Example:

Modes configuration tab showing list of operational modes with their codes and calculation types

Mode Workflow​

Create New Mode​

  1. Click on the Create New button to create a new mode.
  2. Fill out the fields in the popup that appears (see Edit or Create New Mode Popup Fields for details).
  3. Click the Confirm button to save the new mode.

Edit Mode​

  1. Select a mode from the list on the right side of the screen.
  2. Click on the Edit button to open the edit popup.
  3. Modify the fields in the popup as needed (see Edit or Create New Mode Popup Fields for details).
  4. Click the Confirm button to save the changes.

Mode Fields​

Import​

Imports the OEE modes from a CSV or JSON file. The imported file should match the expected format exported from Tamaki MES to ensure data integrity.

Export​

Exports the OEE modes for the selected location to a CSV or JSON file. This can be useful for backup purposes or for transferring configurations between different instances of Tamaki MES.

Delete​

Deletes the selected mode.

Edit​

Opens the following popup to edit the selected mode (in this case, "CIP"):

Edit mode popup with fields for mode name, code, calculation type and color selection

Refer to Edit or Create New Mode Popup Fields for details on the popup.

Create New​

Opens the following popup to create a new mode:

Create new mode popup with empty fields for defining mode properties

Refer to Edit or Create New Mode Popup Fields for details on the popup.

Edit or Create New Mode Popup Fields​

Enabled​

Toggles the mode on or off.

Name​

The name of the mode. This should be a descriptive name that clearly indicates the purpose of the mode (e.g. Idle, Production, Product Changover, Maintenance).

Mode Code​

The integer code for the mode, matching the PLC tag that indicates the mode of the location. This code is used to identify the mode in the PLC and should be unique for each mode.

Mode Calculation Type​

This is a dropdown that allows the user to select how the OEE record of the mode will be handled. The options are:

  • Schedule Production: This mode is used for scheduled production runs, where the location is expected to produce items according to a predefined schedule.
  • Scheduled Downtime: This mode is used for planned downtime events, such as maintenance or setup changes, where the location is not expected to produce items.
  • Unscheduled Downtime: This mode is used for when the location is not planned to be producing items but not due to a planned downtime event. This could be simply idle time between production runs.

Color​

The color associated with the mode, used for visual representation.

Expected Duration Source​

Opens a dropdown with the following options:

Expected Duration Expression (Seconds)​

The Expression Field where the PLC tag for the expected duration of the mode is bound to the OEE model. This allows for dynamic calculation of the expected duration based on real-time data.

Expected Duration (Seconds)​

The fixed value for the expected duration of the mode, defined in seconds. This is used to set a baseline for how long the mode is expected to last, which can be useful for planning and scheduling purposes.

Notes​

The optional comments or explanation about the mode. This will be automatically copied into any mode records as template notes.

Downtime Reasons​

Example:

Downtime reasons configuration tab showing hierarchical tree of downtime reason categories

Downtime reasons configuration tab showing hierarchical tree of downtime reason categories

Downtime Reasons Model oee downtime reason​

Downtime Reasons Workflow​

Create New Downtime Reason​
  1. Click the downtime reason you want to set as the parent reason, or leave it unselected if no parent reason is required.
  2. Click Create on the default downtime reason page. This will populate the right side of the screen with empty values, and set the Parent Downtime Reason to what was clicked (see Edit or Create New Downtime Reason Fields).
  3. Fill out the fields on the right side of the screen (see Edit or Create New Downtime Reason Fields for details).
  4. Click the Confirm button to save the new downtime reason.
Edit Downtime Reason​
  1. Select a downtime reason from the tree on the left side of the screen. The right side of the screen will be populated with the details of the selected downtime reason.
  2. Modify the fields on the right side of the screen as needed (see Edit or Create New Downtime Reason Fields for details).
  3. Click the Confirm button to save the changes.

Downtime Reasons Fields​

Downtime Reason Tree​

The downtime reason tree displays the hierarchy of downtime reasons. It allows users to navigate through the downtime reasons, making it easier to add or edit a downtime reason.

To edit a downtime reason, select it from the tree to populate the right side of the screen. See Edit or Create New Downtime Reason Fields for details on the fields.

Edit or Create New Downtime Reason Fields​

Import​

Imports the OEE downtime reasons from a CSV or JSON file. The imported file should match the expected format exported from Tamaki MES to ensure data integrity.

Export​

Exports the OEE downtime reasons to a CSV or JSON file. This can be useful for backup purposes or for transferring configurations between different instances of Tamaki MES.

Enabled​

Toggles the downtime reason on or off.

Name​

The name of the downtime reason, which is displayed in Downtime Entry and other places in the MES. This should be a descriptive name that clearly indicates the cause of the downtime.

Description​

A concise, detailed description of the downtime reason, providing additional context and information about the cause of the downtime. This can help operators and managers understand the issue better and take appropriate actions.

Code​

The integer code for the downtime reason, matching the PLC tag that indicates the downtime reason or fault code of the location. This code is used to identify the downtime reason in the PLC and should be unique for each downtime reason.

Location​

The location where this downtime reason applies. This determines which specific machine, line, or area the reason is associated with when downtime is recorded.

Parent Downtime Reason​

The parent downtime reason, which is used to create a hierarchy of downtime reasons. This allows for categorization and grouping of related downtime reasons, making it easier to analyze and report on downtime events.

Last updated on by Ryan Kennedy