MaterialListType – OPC UA for Plastics and Rubber Machinery

29 MaterialListType

This ObjectType is used to provide a list of materials which are intended to be used on the machine.

Table 145 – MaterialListType Definition

Attribute	Value
BrowseName	MaterialListType
IsAbstract	False

References	Node Class	BrowseName	DataType	TypeDefinition	Other
Subtype of 0:BaseObjectType defined in OPC UA Part 5
0:HasProperty	Variable	0:NodeVersion	0:String	0:PropertyType	M, RO
0:HasProperty	Variable	DensityUnit	0:EUInformation	0:PropertyType	M, RO
0:HasComponent	Object	Material_<Nr>		MaterialType	OP
0:HasComponent	Method	AddMaterial			O
0:HasComponent	Method	RemoveMaterialById			O
0:GeneratesEvent	ObjectType	RequestAddMaterialEventType	Defined in 29.5
0:GeneratesEvent	ObjectType	0:GeneralModelChangeEventType

When instances for materials are created, the BrowseNames shall be "Material_<Nr>” where <Nr> is a three-digit number with leading zeros, starting with “001”.

29.1 NodeVersion

The NodeVersion Property as defined in OPC UA Part 3 is used to inform the client about model changes. Here it informs about added or removed instances of MaterialType.

29.2 DensityUnit

In the MaterialType the Density has the TypeDefinition AnalogUnitType which includes the used unit. AnalogUnitType cannot be used as InputArgument of a method. Therefore, the MaterialListType has the Property DensityUnit and the unit given there is the basis for the Density InputArgument in the method AddMaterial.

29.3 AddMaterial

This method adds a material to the list.

Signature

	AddMaterial (
		[in]	0:String		Id
		[in]	0:LocalizedText		Name
		[in]	0:Double		Density);

Table 146 – AddMaterial Method Arguments

Argument	Description
Id	Id of the material
Name	Name of the material (e.g. trade name)
Density	Density of the material in the unit given in the DensityUnit Property in the instance of MaterialListType

Table 147 – AddMaterial Method AddressSpace Definition

Attribute	Value
BrowseName	AddMaterial

References	Node Class	BrowseName	DataType	TypeDefinition	Modelling Rule
0:HasProperty	Variable	InputArguments	Argument[]	0:PropertyType	Mandatory

29.4 RemoveMaterialById

This method removes a material from the list.

Signature

	RemoveMaterialById (
		[in]	0:String	Id);

Table 148 – RemoveMaterialById Method Arguments

Argument	Description
Id	Id of the material that shall be removed

Table 149 – RemoveMaterialById Method AddressSpace Definition

Attribute	Value
BrowseName	RemoveMaterialById

References	Node Class	BrowseName	DataType	TypeDefinition	Modelling Rule
0:HasProperty	Variable	InputArguments	Argument[]	0:PropertyType	Mandatory

Warning: Problems may occur when the Material Id is currently in use (in a job, hopper).

29.5 RequestAddMaterialEventType

With this EventType, the Server can request that the client shall add a material (by calling the method AddMaterial) with the specified Id. This can be used, e.g. when a material Id is used inside a new job, which is not included in the MaterialList).

Table 150 – RequestAddMaterialEventType Definition

Attribute	Value
BrowseName	RequestAddMaterialEventType
IsAbstract	True

References	Node Class	BrowseName	DataType	TypeDefinition	Other
Subtype of 0:BaseEventType defined in OPC UA Part 5
0:HasProperty	Variable	Id	0:String	0:PropertyType	M

Id: Id of the material that shall be added.