20.5 ProductionDatasetTransfer

20.5.1 General

OPC UA Part 5 defines a TemporaryFileTransferType for the representation of file transfers. This Type is used for the transfer of production datasets.

20.5.2 GenerateOptions in GenerateFileForRead

For the GenerateOptions in the Method GenerateFileForRead the DataType ProductionDatasetReadOptionsType as defined below shall be used.

Table 116 – ProductionDatasetReadOptionsType Definition
Name Type Description
ProductionDatasetReadOptionsTypestructureSubtype of 0:Structure as defined in OPC UA 10000-3

Storage

StorageEnumeration

Indication from where the production dataset is read. Enumeration of Type StorageEnumeration.

Although StorageEnumeration is defined as a Mask, here only the values 1, 2 and 4 are allowed (no combination).

Name

0:StringName of the production dataset that should be transferred from the server to the client. This parameter is only relevant, if Storage is 4 (FILE_SYSTEM). In other cases, it shall be an empty 0:String.

20.5.3 GenerateOptions in GenerateFileForWrite

For the GenerateOptions in the Method GenerateFileForWrite the DataType ProductionDatasetWriteOptionsType as defined below shall be used.

Table 117 – ProductionDatasetWriteOptionsType Definition
Name Type Description
ProductionDatasetWriteOptionsTypestructureSubtype of 0:Structure as defined in OPC UA 10000-3

Storage

StorageEnumerationIndication where the production dataset is written to. Enumeration of Type StorageEnumeration.

Name

0:StringName of the production dataset that should be transferred from the client to the server.

Components

0:UInt16[]

Array which indicates which parts of the production dataset shall be activated in the machine control after writing. Only valid if Storage is PRODUCTION_1 or PREPARATION_2.

Array of UInt16. See possible values in Table 115.

If Components has the array length 0 then complete production dataset is activated.

Table 118 – StorageEnumeration Definition
Name Value Description
PRODUCTION1The production dataset is written directly to the (active layer of the) control system of the machine.
PREPARATION2The production dataset is written to the preparation layer of the control system of the machine (if supported).
FILE_SYSTEM4The production dataset is written to the file system of the machine for later activation.

This Enumeration is defined as a Mask. With this, writing to several destinations with one Method call is possible (e.g. StorageEnumeration = 6 writes the production dataset to the file system and the preparation layer of the control system.

NOTE: It is possible that the machine does not support all storage options (e.g. only writing to file system allowed). In this case, the server will return the StatusCode Bad_InvalidArgument when calling the GenerateFileForWrite Method with a not supported value for Storage.