Skip to main content

system.mes.material.getPropertiesAndValuesForMaterial

Description

Retrieves all Material Properties and Material Property Values records by its material ID or path.

Syntax

system.mes.material.getPropertiesAndValuesForMaterial(idOrPath)

Parameters

ParameterTypeDescription
idOrPathStringThe ULID or path of the material.

Returns

Returns a list of JSON objects representing all material properties and property values for a given material.

NameTypeDescription
materialClassIdString (ULID)The ULID of the material class associated with this material property.
materialIdString (ULID)The ULID of the material.
materialPropertyIdString (ULID)The ULID of the material property.
materialPropertyValueIdString (ULID)The ULID of the material property value.
materialPropertyNotesStringNotes related to the material property.
materialPropertyValueNotesStringNotes related to the material property value.
materialPropertyEnabledBooleanIndicates if the property is active and enabled.
materialPropertyValueEnabledBooleanIndicates if the property value is active and enabled.
nameStringThe name of the material property.
descriptionStringThe description of the material 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.
valueMixedThe value assigned to the property value if none is provided. The type is mixed as it depends on what dataType is.

Code Examples

# Retrieve all material properties and property values by material ID or path
properties_and_values = system.mes.material.getPropertiesAndValuesForMaterial('IRB/5391537510212')

# Output the material properties and property values
print(properties_and_values)