Skip to content

Commit c413105

Browse files
Merge pull request #313258 from dominicbetts/release-aio-2603-commander
AIO 2603: Change for Call option in commander
2 parents 3a735b3 + 1989f7f commit c413105

1 file changed

Lines changed: 5 additions & 2 deletions

File tree

articles/iot-operations/discover-manage-assets/howto-control-opc-ua.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -197,12 +197,12 @@ resource asset 'Microsoft.DeviceRegistry/namespaces/assets@2025-10-01' = {
197197
managementGroups: [
198198
{
199199
name: 'managementGroup'
200+
dataSource: 'nsu=http://microsoft.com/Opc/OpcPlc/Boiler;i=5019'
200201
actions: [
201202
{
202203
name: 'Switch'
203204
actionType: 'Call'
204205
targetUri: 'nsu=http://microsoft.com/Opc/OpcPlc/Boiler;i=7019'
205-
typeRef: 'nsu=http://microsoft.com/Opc/OpcPlc/Boiler;i=5019'
206206
}
207207
{
208208
name: 'explicit-write'
@@ -275,9 +275,12 @@ The example asset called `management-actions-asset` has an action called `Switch
275275
An action always has the following properties:
276276

277277
- `name`: Name of the action in a management group.
278+
- `dataSource`: Maps to the `objectId` in [OPC UA](https://reference.opcfoundation.org/Core/Part4/v104/docs/5.11.2.2). Distinguishes methods defined for multiple objects.
278279
- `targetUri`: Maps to the `methodId` in [OPC UA](https://reference.opcfoundation.org/Core/Part4/v104/docs/5.11.2.2). References the method to call.
279280
- `actionType`: The type of action. For methods, this property is always `Call`.
280-
- `typeRef`: Maps to the `objectId` in [OPC UA](https://reference.opcfoundation.org/Core/Part4/v104/docs/5.11.2.2). Distinguishes methods defined for multiple objects.
281+
282+
> [!NOTE]
283+
> Versions of Azure IoT Operations prior to 2603 used `typeRef` instead of `dataSource` to map to the `objectId`. If you're using an older version, use `typeRef` in your asset definition instead of `dataSource`.
281284
282285
When you publish a message to the topic `azure-iot-operations/asset-operations/<asset name>/<management group name>/<action name>` that includes a value for `Switch`, the commander service calls the method in the OPC UA server. For example, to switch on the boiler, publish a message with the following payload to the topic `azure-iot-operations/asset-operations/management-actions-asset/managementGroup/Switch`:
283286

0 commit comments

Comments
 (0)