system.mes.oee.getAllOeeProductionRecords

Retrieves all OEE production records for a specific location within a given time range.

Permissions

This method requires the OEE.READ.GET permission.

Syntax

system.mes.oee.getAllOeeProductionRecords(locationIdOrPath, startDate, endDate)

Parameters

Parameter	Type	Nullable	Description
locationIdOrPath	String	False	The location ID (ULID) or path to retrieve OEE production records for.
startDate	Date	False	The start date/time for the query range.
endDate	Date	True	The end date/time for the query range. If null, uses current time.

Returns

A list JSON representations of OeeProductionRecordDTO objects, each representing a historical or active OEE run.

Each object has the following properties:

Name	Type	Nullable	Description	Default Value
id	String	True	The id of the OEE Production Record	null
locationId	String	False	Identifier of the associated location where this OEE production record was captured	null
locationPath	String	True	Path of the location where this OEE production record was captured	null
locationName	String	True	Name of the associated location	null
status	Status	False	Status of the OEE production record (e.g., running, faulted, canceled, complete)	UNKNOWN
startDate	Instant	False	Start date and time of the OEE production record	Instant.now()
endDate	Instant	True	End date and time of the OEE production record	null
totalDurationSec	Double	False	Total duration of the OEE production record in seconds	0.0
'performanceReasonId'	String	True	The id of the associated performance reason, if applicable	null
'performanceReasonName'	String	True	The name of the associated performance reason, if applicable	null
'performanceReasonPath'	String	True	The path of the associated performance reason, if applicable	null
infeedCount	Double	False	Total number of infeed units during this record period	0.0
expectedInfeedCount	Double	False	Expected number of infeed units during this record period	0.0
qualityStrategy	OeeQualityStrategy	False	Quality Strategy for this OEE Production Record	WASTE_COUNT
outfeedCount	Double	False	Total number of outfeed units recorded during this period	0.0
infeedCountUnitOfMeasureId	String	True	Identifier of the unit of measure for the infeed count	null
infeedCountUnitOfMeasureName	String	True	Name of the unit of measure for the infeed count	null
infeedCountUnitOfMeasureSymbol	String	True	Symbol of the unit of measure for the infeed count	null
infeedRateTimeUnits	TimeUnit	False	Unit of measure for the machine infeed rate & standard rate	MINUTES
stateRecordId	String	True	Identifier of the associated state record	null
standardRate	Double	True	The standard rate for this record	0.0
productionOrderId	String	True	The id of the production order associated with this OEE production record	null
productionOrderName	String	True	The name of the production order associated with this OEE production record	null
notes	String	True	Notes associated with the OEE Production Record	null
enabled	boolean	True	Indicates whether the OEE Production Record is enabled	true
spare1	String	True	Extra field 1	null
spare2	String	True	Extra field 2	null
spare3	String	True	Extra field 3	null

Code Examples

from java.util import Date
from java.util.concurrent import TimeUnit

# Get OEE production records for the last 24 hours
locationPath = "Enterprise/Site/Production/Line1"
endTime = Date()
startTime = Date(endTime.getTime() - TimeUnit.HOURS.toMillis(24))

oeeProductionRecords = system.mes.oee.getAllOeeProductionRecords(locationPath, startTime, endTime)

for record in oeeProductionRecords:
    print record['infeedCount'], record['outfeedCount']