system.mes.oee.getCalculationConfig

Description

Retrieves an OEE Calculation Configuration by its ID. Throws ResourceNotFoundException if no configuration exists with the given ID.

Permissions

This method requires the OEE.READ.GET permission.

Syntax

system.mes.oee.getCalculationConfig(id)

Parameters

Parameter	Type	Nullable	Description
id	String (ULID)	False	The ID of the OEE Calculation Configuration.

Returns

A JSON representation of an OeeCalculationConfigurationDTO object.

Name	Type	Nullable	Description	Default Value
id	String	True	The ID of the configuration (ULID).	null
locationId	String	False	Identifier for the associated location.	null
locationPath	String	True	Path for the associated location (display only).	null
periodType	String	False	Period granularity: HOUR, DAY, WEEK, MONTH, or SHIFT.	null
numRowsPerCycle	Integer	False	Maximum records to generate per job cycle.	1
weekStartDay	String	False	First day of the calendar week for WEEK bucketing.	"MONDAY"
numDaysDelay	Integer	False	Minimum number of days a period must end before it is pre-computed. The pre-processed row in the rollup table will always be at least this many days behind the current date. This is to allow for a settling period.	1
latestCalculationTimestamp	Instant	True	ISO-8601 timestamp of the most recently computed period.	null
enabled	Boolean	False	Whether this configuration is active.	true
notes	String	True	Optional notes.	null

Code Examples

# Retrieve a calculation config by its ID
configId = "01JCH3ENEB-SV2X8B3W-NFY8WZNK"
try:
    config = system.mes.oee.getCalculationConfig(configId)
    print "Rows per cycle:", config['numRowsPerCycle']
    print "Location:", config['locationPath']
except:
    print "No calculation configuration found with ID:", configId