Skip to main content

system.mes.oee.getOeeAlarm

Description

Retrieves an OEE Alarm configuration by its ID.

Permissions

This method requires the OEE.READ.GET permission.

Syntax

system.mes.oee.getOeeAlarm(id)

Parameters

ParameterTypeNullableDescription
idString (ULID)FalseThe ID of the OEE alarm to retrieve.

Returns

Returns a JSON representation of the OeeAlarmDTO object. Returns nothing if no alarm is found.

NameTypeNullableDescriptionDefault Value
idStringTrueThe id of the OEE Alarmnull
locationIdStringFalseIdentifier of the associated locationnull
locationPathStringTruePath for the associated locationnull
tagPathStringFalseThe qualified path to monitor for alarmsnull
minPriorityAlarmPriorityFalseMinimum alarm priority to include in eventsDiagnostic
labelFilterStringTrueOptional filter to apply to alarm labels. Only alarms with labels matching this filter will be included.null
availabilityReasonCodeOverrideStringTrueName of the associated data property in Ignition alarms that contains the availability reason code override valuenull
stateCodeOverrideStringTrueName of the associated data property in Ignition alarms that contains the state code override valuenull
notesStringTrueNotes associated with the OEE Alarmnull
enabledbooleanTrueIndicates whether the OEE Alarm is enabledtrue
spare1StringTrueExtra field 1null
spare2StringTrueExtra field 2null
spare3StringTrueExtra field 3null

Code Examples

# Retrieve an OEE alarm by ID
alarm = system.mes.oee.getOeeAlarm('01JAP8RJBN-8ZTPXSGY-J9GSDPE1')

# Output the alarm configuration
print(alarm)