OPC UA DataTypes – OPC UA for Textile Testing Devices

10 OPC UA DataTypes

10.1 ExchangeablePartDataType

This structure contains properties that are used to identify an exchangeable part inside or on the device. Exchangeable parts can be measurement equipment such as load cells and clamp types or tear and wear parts such as jaw faces.

The structure is defined in Table 40.

Table 40 – ExchangeablePartDataType Structure

Name	Type	Description	Optional
ExchangeablePartDataType	structure	Subtype of 0:Structure defined in OPC 10000-5
PartType	0:String	Name of the machine part.	False
Mounted	0:Boolean	Flag stating if the part is currently mounted or not.	False
Traceable	0:Boolean	Flag stating if the part is traceable (e.g. has an Id or serial number).	True
PartId	0:String	Id or serial number of the part.	True
MachineReadable	0:Boolean	Flag stating if the PartId is machine readable.	True
LastCalibrationDate	0:UtcTime	Date of the last calibration of this part if available.	True

Its representation in the AddressSpace is defined in Table 41.

Table 41 – ExchangeablePartDataType Definition

Attribute	Value
BrowseName	ExchangeablePartDataType
IsAbstract	False

References	Node Class	BrowseName	DataType	TypeDefinition	Other
Subtype of 0:Structure defined in OPC 10000-5

Conformance Units
TTD_TextileTestingDeviceType

10.2 OptionalModuleDataType

This structure is used to define optional hard-/software modules that may be installed on the TTD.

The structure is defined in Table 42.

Table 42 – OptionalModuleDataType Structure

Name	Type	Description	Optional
OptionalModuleDataType	structure	Subtype of 0:Structure defined in OPC 10000-5
ModuleName	0:String	The name of the module.	False
ModuleType	0:String	The type of the module. E.g. hardware/software.	False
IsInstalled	0:Boolean	Flag that indicates if the module is installed.	False
Version	0:String	Version of the soft-/hardware module.	True

Its representation in the AddressSpace is defined in Table 43.

Table 43 – OptionalModuleDataType Definition

Attribute	Value
BrowseName	OptionalModuleDataType
IsAbstract	False

References	Node Class	BrowseName	DataType	TypeDefinition	Other
Subtype of 0:Structure defined in OPC 10000-5

Conformance Units
TTD_TextileTestingDeviceType

10.3 StatisticResultContentDataType

This structure contains a fixed statistical value set of one measured material property. The units for the ResultKey should be based on extended SI units that are not part of this specification.

The structure is defined in Table 44.

Table 44 – StatisticResultContentDataType Structure

Name	Type	Description	Optional
StatisticResultContentDataType	structure	Subtype of 0:Structure defined in OPC 10000-5
ResultKey	0:String	Unique identifier of the measured property defined by the tester application.	False
ItemCount	0:UInt32	Number of valid tests that were calculated in the statistics.	False
MeanValue	0:Double	Mean value of the valid tests.	False
StandardDeviation	0:Double	Standard Deviation of the valid tests.	False
CoefficientOfVariation	0:Double	Coefficient of variation of valid tests.	False
MinValue	0:Double	The minimum value of the valid tests.	False
MaxValue	0:Double	The maximum value of the valid tests.	False
ConfidenceInterval95	0:Double	Confidence interval (95%) of the measurement.	False

Its representation in the AddressSpace is defined in Table 45.

Table 45 – StatisticResultContent Definition

Attribute	Value
BrowseName	StatisticResultContentDataType
IsAbstract	False

References	Node Class	BrowseName	DataType	TypeDefinition	Other
Subtype of 0:Structure defined in OPC 10000-5

Conformance Units
TTD_TTDResultManagementType

10.4 StatisticResultContentWithUnitsDataType

This structure contains a fixed statistical value set of one measured material property with units included.

The structure is defined in Table 46.

Table 46 – StatisticResultContentWithUnitsDataType Structure

Name	Type	Description	Optional
StatisticResultContentWithUnitsDataType	structure	Subtype of StatisticResultContentDataType
UnitItemCount	0:EUInformation	Unit for the ItemCount.	False
UnitMeanValue	0:EUInformation	Unit for the MeanValue.	False
UnitStandardDeviation	0:EUInformation	Unit for the StandardDeviation.	False
UnitCoefficientOfVariation	0:EUInformation	Unit for the CoefficientOfVariation.	False
UnitMinValue	0:EUInformation	Unit for the MinValue.	False
UnitMaxValue	0:EUInformation	Unit for the MaxValue.	False
UnitConfidenceInterval	0:EUInformation	Unit for the ConfidenceInterval.	False

Its representation in the AddressSpace is defined in Table 47.

Table 47 – StatisticResultContentWithUnits Definition

Attribute	Value
BrowseName	StatisticResultContentWithUnitsDataType
IsAbstract	False

References	Node Class	BrowseName	DataType	TypeDefinition	Other
Subtype of StatisticResultContentDataType

Conformance Units
TTD_TTDResultManagementType

10.5 RecipeIdDataType

This structure contains properties that are used to identify and describe a recipe. This structure is also used in the methods provided by the RecipeManagement.

The structure is defined in Table 48.

Table 48 – RecipeIdDataType Structure

Name	Type	Description	Optional
RecipeIdDataType	structure	Subtype of 0:Structure defined in OPC 10000-5
Name	0:String	Human readable name for the recipe.	True
Id	0:String	System wide unique id for the file content. (E.g. Hash of file content is possible)	False
Type	0:String	The type of the textile testing device for which the recipe is applicable.	True
Description	0:String	Description of the recipe.	True
Comment	0:String	Comment on the recipe.	True
ModifiedDate	0:UtcTime	The date of the last modification to the recipe file.	True
Version	0:String	Version of the recipe.	True
Validated	0:Boolean	Flag that indicates if the recipe was successfully validated on the textile testing device. Null if the validation was not performed.	True

Its representation in the AddressSpace is defined in Table 49.

Table 49 – RecipeIdDataType Definition

Attribute	Value
BrowseName	RecipeIdDataType
IsAbstract	False

References	Node Class	BrowseName	DataType	TypeDefinition	Other
Subtype of the 0:Structure defined in OPC 10000-5

Conformance Units
TTD_RecipeManagementType

10.6 RecipeDataType

This structure represents the recipe and combines its metadata that is used to identify the recipe with its content. The RecipeContent is a ByteString that holds the configuration data for the textile testing device. Most likely this is a ByteString representation of the content of a configuration file.

The structure is defined in Table 50.

Table 50 – RecipeDataType Structure

Name	Type	Description	Optional
RecipeDataType	structure	Subtype of 0:Structure defined in OPC 10000-5
RecipeId	RecipeIdDataType	RecipeId meta data describing this recipe.	False
RecipeContent	0:ByteString	The content of this recipe as ByteString.	False
ContentEncoding	0:String	The encoding of the content. E.g.: UTF-8 or ASCII	False

Its representation in the AddressSpace is defined in Table 51.

Table 51 – RecipeDataType Definition

Attribute	Value
BrowseName	RecipeDataType
IsAbstract	False

References	Node Class	BrowseName	DataType	TypeDefinition	Other
Subtype of the 0:Structure defined in OPC 10000-5

Conformance Units
TTD_RecipeManagementType

10.7 TTDResultMetaDataType

This structure is a refinement of the ResultMetaDataType defined in OPC 40001-101 to describe the results generated by the TTD. Especially the fields SampleId, TesterJobId, TesterSampleResultId, ProductInstanceURI and CanBeDeleted were added to offer a better possibility to relate a result to a measurement.

The following fields of the 4:ResultMetaData should be used mandatorily:

ResultId (already mandatory)

HasTransferableDataOnFile

IsPartial

CreationTime

The structure is defined in Table 52.

Table 52 – TTDResultMetaDataType Structure

Name	Type	Description	Optional
TTDResultMetaDataType	structure	Subtype of 4:ResultMetaDataType defined in OPC 40001-101.
SampleId	0:String	The unique identifier of one sample.	False
TesterJobId	0:String	TTD-internal id given to the tested set of samples(job)	False
TesterSampleResultId	0:String	Unique identifier created by the TTD for each sample result. Necessary additional to the SampleId if the sample is tested more than once.	False
ProductInstanceURI	0:String	Unique product instance uri of the TTD.	False
CanBeDeleted	0:Boolean	Flag set by the client that indicates if the TTD may delete the result.	False
JobOrder	7:ISA95JobOrderDataType	The metadata for the job containing parameters like linear density, RecipeId, NumberOfTests and SampleInfo.	False

For the structure of JobOrder see: Table 18 – Predefined 7:ISA95JobOrderDataType/JobOrderParameters.

Its representation in the AddressSpace is defined in Table 53.

Table 53 – TTDResultMetaDataType Definition

Attribute	Value
BrowseName	TTDResultMetaDataType
IsAbstract	False

References	Node Class	BrowseName	DataType	TypeDefinition	Other
Subtype of 4:ResultMetaDataType defined in OPC 40001-101

Conformance Units
TTD_TTDResultManagementType

10.8 TestProcedureIdDataType

This structure contains the id for the test procedure as well as some optional metadata describing the test procedure.

Table 54 – TestProcedureIdDataType Structure

Name	Type	Description	Optional
TestProcedureIdDataType	structure	Subtype of 0:Structure defined in OPC 10000-5
TestProcedureId	0:String	The available test procedures are stored on the testing device and referenced by name (TestProcedureId).	False
Description	0:String	Description of the test procedure.	True
ProcedureReferences	0:String[]	An array of references to standards.	True
IsProcedureLicensed	0:Boolean	Flag to define the availability on the server.	True

Its representation in the AddressSpace is defined in Table 55.

Table 55 – TestProcedureIdDataType Definition

Attribute	Value
BrowseName	TestProcedureIdDataType
IsAbstract	False

References	Node Class	BrowseName	DataType	TypeDefinition	Other
Subtype of the 0:Structure defined in OPC 10000-5

Conformance Units
TTD_TextileTestingDeviceType

10.9 SampleInfoDataType

This structure contains properties of a sample (provided by MES), that are needed to execute a recipe. The SampleInfoDataType contains all information for tests on fibres and yarns.

Table 56 – SampleInfoDataType Structure

Name	Type	Description	Optional
SampleInfoDataType	structure	Subtype of 0:Structure defined in OPC 10000-5
SampleId	0:String	The unique identifier of a (physical) sample.	False
NominalLinearDensity	0:Double	The nominal linear density of this sample in tex. It is used for calculating linear density related parameters.	False
MaterialDensity	0:Double	The material density in g/cm3. It is used for calculating some test results like diameter.	True
MaterialType	0:String	The material type information can be used to switch between material-dependend handling of material or for reporting.	True
PositionOnCarrier	0:String	Position of the sample on the carrier. If there is no carrier an empty String should be provided.	False

Its representation in the AddressSpace is defined in Table 57.

Table 57 – SampleInfoDataType Definition

Attribute	Value
BrowseName	SampleInfoDataType
IsAbstract	False

References	Node Class	BrowseName	DataType	TypeDefinition	Other
Subtype of the 0:Structure defined in OPC 10000-5

Conformance Units
TTD_JobManagementType

10.10 TestNumDataType

This structure provides the number of tests for each test procedure.

The structure is defined in Table 58.

Table 58 – TestNumDataType Structure

Name	Type	Description	Optional
TestNumDataType	structure	Subtype of 0:Structure defined in OPC 10000-5
TestProcedureId	0:String	The name of the test procedure that should be executed.	False
NumberOfTests	0:UInt32	The number of tests that have to be performed with this test procedure on one sample.	False

Its representation in the AddressSpace is defined in Table 59.

Table 59 – TestNumDataType Definition

Attribute	Value
BrowseName	TestNumDataType
IsAbstract	False

References	Node Class	BrowseName	DataType	TypeDefinition	Other
Subtype of 0:Structure defined in OPC 10000-5

Conformance Units
TTD_JobManagementType