system.mes.material.validatePropertyValue

Description

Validates the specified parameters for a Material Property Values record and returns any validation errors. This only checks if the material property value object can be saved based on the attributes given.

Syntax

system.mes.material.validatePropertyValue(**property_data)

Parameters

Parameter	Type	Description
materialId	String (ULID)	The ULID of the material.
materialPropertyId	String (ULID)	The ULID of the material property.
dataType	String	The data type of the property value. Must be the same as the data type of the property.
value	Mixed	The value assigned to the property value if none is provided. The type is mixed as it depends on what dataType is.
id	String (ULID)	The ULID of the material property value (optional, for updating an existing property).
notes	String	Notes related to the material property value.
enabled	Boolean	Indicates if the property value is active and enabled.
spare1	String	Additional field for user-defined context.
spare2	String	Additional field for user-defined context.
spare3	String	Additional field for user-defined context.

Returns

Returns a JSON object where keys are field names and values are lists of validation violation messages.

Code Examples

# Generate the object structure for a new property object
new_property = system.mes.material.newProperty()
new_property['materialClassId'] = '01JCH3ENEB-SV2X8B3W-NFY8WZNK'
new_property['name'] = 'Density'
new_property['dataType'] = 'Float'
saved_property = system.mes.material.saveProperty(**new_property)

# Generate the object structure for a new property value object
property_value_data = system.mes.material.newPropertyValue()

# Define property value details
property_value_data['materialId'] = system.mes.material.getMaterial('IRB/5391537510212')['id']
property_value_data['materialPropertyId'] = saved_property.id
property_value_data['dataType'] = 'Float' # Must be the same data type as the property
property_value_data['value'] = 100

# Validate material property value parameters

validation_errors = system.mes.material.validatePropertyValue(**property_value_data)
if len(validation_errors) > 0:
    print('Validation errors found:', validation_errors)
else:
    print('Material property value parameters are valid.')