Call for WRITE operations (the name WRITE is the arbitrarily chosen name for this call)
Input Parameter
For the WRITE Connector Call, you need to configure the “operationType ” and the “nodeId” (consisting of 2 mandatory parameters: “identifier” and “namespaceIndex” and one optional parameter: “identifierType”). Furthermore, you need to define the mandatory “operationTarget” and the “value”.
operationType: Defines which operation you want to execute, in this case, “WRITE”.
Parameter Name: operations[0]/operationType
Constant Value: WRITE
Data Type: String
nodeId: Defines the identification of the OPC UA node. It is split in 3 parameters (two mandatory and one optional):
- identifier:
Parameter Name: operations[0]/nodeId/identifier
Data Type: String - namespaceIndex:
Parameter Name: operations[0]/nodeId/namespaceIndex
Data Type: String
Possible Values: All numbers from 0 to 65535. - identifierType (optional): Searches for the Identifier with a fixed Data Type.
Parameter Name: operations[0]/identifierType
Data Type: String
Possible Values: Numeric, UUID, String, Byte String
Note: In every namespace, each ID must be unique for its own identifierType (it is possible to use the String “7617” and the Numeric 7167 together in one namespace)
operationTarget:
Parameter Name: operations[0]/operationTarget
Data Type: String
Possible Values: Choose between
- WITHOUT_EVERYTHING
- WRITE_ONLY
- CONFIRM_ONLY
- WRITE_THEN_CONFIRM
- READ_ONLY
- READ_THEN_WRITE
- READ_THEN_CONFIRM
- READ_THEN_WRITE_THEN_CONFIRM
value The value, which is going to be written into the nodes.
Parameter Name: operations[0]/value
Data Type: String
Note: In a batch-call, the position of the values will equal to the position of the node. For example, if node a is on the first position and node b on the second, whereas value x is on the first and value y on the second position then value x will be written into node a and value y into node b.
Batch Operations
It is possible to execute multiple different OPC UA Operations with one connector call. In order to do that, the number in the operations[X] path must be used. Each number represents one OPC UA Operation.
A batch call with two WRITE-Operations would look as follows (only constant values are provided with bold letters):
First WRITE Operation:
- operations[0]/nodeId/identifierType
- operations[0]/nodeId/namespaceIndex
- operations[0]/nodeId/identifier
- operations[0]/operationType WRITE
- operations[0]/operationTarget
- operations[0]/value
Second WRITE Operation:
- operations[1]/nodeId/identifierTyp
- operations[1]/nodeId/namespaceIndex
- operations[1]/nodeId/identifier
- operations[1]/operationType WRITE
- operations[1]/operationTarget
- operations[1]/value
Note: The specific commands are NOT defined here!
Output parameters
You can return all output parameters like this:
Parameter Name: /
Data Type: String
If you want to get only selected output parameters, use the following syntax:
Parameter Name: operationsResult[0]/newValue/value (exemplary)
Data Type: depends on the parameter you want to be returned.
For now, only the complete unformatted JSON will be returned.