Skip to main content

system.mes.equipment.getPropertiesAndValuesForEquipment

Description

Retrieves a combined list of all Equipment Properties and their corresponding Equipment Property Values for a given equipment. This is a convenience method that returns both property definitions and values together.

Permissions

This method requires the EQUIPMENT.READ.GET permission.

Syntax

system.mes.equipment.getPropertiesAndValuesForEquipment(idOrPath)

Parameters

ParameterTypeNullableDescription
idOrPathStringFalseThe ID or path of the equipment.

Returns

Returns a list of JSON objects. Each JSON object contains both property definition and value information:

NameTypeDescription
equipmentIdString (ULID)The ULID of the equipment.
equipmentPropertyIdString (ULID)The ULID of the equipment property.
equipmentPropertyValueIdString (ULID)The ULID of the equipment property value.
nameStringThe name of the equipment property.
descriptionStringA description of the equipment property.
dataTypeStringThe data type of the property.
lowLimitDoubleThe minimum allowed value.
highLimitDoubleThe maximum allowed value.
formatStringAn optional format string.
unitOfMeasureIdString (ULID)The ULID of the unit of measure.
unitOfMeasureNameStringThe name of the unit of measure.
unitOfMeasureSymbolStringThe symbol of the unit of measure.
optionsList<String>A list of allowed values.
nullableBooleanWhether the property value can be null.
defaultValueMixedThe default value.
valueMixedThe current value.
equipmentPropertyNotesStringNotes on the equipment property.
equipmentPropertyValueNotesStringNotes on the equipment property value.
equipmentPropertyEnabledBooleanWhether the equipment property is enabled.
equipmentPropertyValueEnabledBooleanWhether the equipment property value is enabled.

Code Examples

propertiesAndValues = system.mes.equipment.getPropertiesAndValuesForEquipment('Pumps/CentrifugalPumps/Pump-101')
print(propertiesAndValues)