Skip to main content

system.mes.location.getProperty

Description

Retrieves a Location Properties record by its specified ID or name.

Syntax

system.mes.location.getProperty(idOrName)

Parameters

ParameterTypeDescription
idOrNameStringThe ULID or name of the location property to retrieve.

Returns

Returns a JSON representation of the location property. Returns nothing if no location property is found.

NameTypeDescription
nameStringThe name of the location property.
descriptionStringA description of the location property.
dataTypeStringThe data type of the property (e.g., Integer, String, Float).
lowLimitDoubleThe minimum value allowed for a numerical property.
highLimitDoubleThe maximum value allowed for a numerical property.
formatStringThe format of the property, if applicable.
unitOfMeasureIdString (ULID)The ULID of the unit of measure for this property.
unitOfMeasureNameStringThe name of the unit of measure for the property. For display purposes only.
unitOfMeasureSymbolStringThe symbol of the unit of measure for the property. For display purposes only.
optionsStringList of possible values for the property (e.g., "[option1, option2]").
nullableBooleanDefines if the property can accept null values.
defaultValueMixedThe default value assigned to the property if none is provided. The type is mixed as it depends on what dataType is.
idString (ULID)The ULID of the location property.
notesStringNotes related to the location property.
enabledBooleanIndicates if the property is active and enabled.
spare1StringAdditional field for user-defined context.
spare2StringAdditional field for user-defined context.
spare3StringAdditional field for user-defined context.

Code Examples

# Retrieve a location property by ID or name
property = system.mes.location.getProperty('Temperature')

# Output the location property
print(property)