Skip to main content
Version: V2 (Ignition 8.1)

system.mes.equipment.setEquipmentPropertyValue

Description​

Sets the value of an Equipment Property Values record for a given equipment and property, creating the record if it does not already exist.

Permissions​

This method requires the EQUIPMENT.WRITE.SAVE permission.

Syntax​

system.mes.equipment.setEquipmentPropertyValue(equipmentIdOrPath, propertyIdOrName, value)

Parameters​

ParameterTypeNullableDescription
equipmentIdOrPathStringFalseThe ID or path of the equipment.
propertyIdOrNameStringFalseThe ID or name of the equipment property.
valueMixedTrueThe value to assign. The type depends on the data type of the property. May be None to clear the value, but only when the property definition is nullable; passing None for a non-nullable property raises an error.

Returns​

Returns a JSON representation of the updated equipment property value.

Code Examples​

updatedValue = system.mes.equipment.setEquipmentPropertyValue('Pumps/CentrifugalPumps/Pump-101', 'MaxFlowRate', 300.0)
print(updatedValue)

# Clear the value of a nullable property by passing None
system.mes.equipment.setEquipmentPropertyValue('Pumps/CentrifugalPumps/Pump-101', 'MaxFlowRate', None)