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”.
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.
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.
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 |
This method removes a material from the list.
Signature
RemoveMaterialById (
[in]0:StringId);
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).
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.