Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This document describes the various tag actions at an Edge device and the actions required to represent the Edge tags correctly at MQTT Engine.

Note
To use the sample tags provided to test the various scenarios, install MQTT Distributor, MQTT Engine and MQTT Transmission. Configure a Transmitter with Tag Provider "default", an empty Tag Path and leave the SparkplugIDs as empty. Import the SampleTags.json and refresh Transmission.

Non UDT Tags at Edge

Action at EdgeResultActionResult

Create new group level folder with no tags

Add G2

On add: No change at EngineRefresh TransmissionNo folder created at Engine

Create new edge level with no tags

Add G2/E2

On add: No change at EngineRefresh TransmissionFolder path is created at Engine

Create new device level folder with no tags

Add G2/E2/D2

On add: No change at EngineRefresh TransmissionFolder path is created at Engine

Create new folder under the device level with no tags

Add G2/E2/D2/New Folder

On add: No change at EngineRefresh TransmissionNo folder path created at Engine

Add a tag to folder

Add G1/E1/D1/Tag2 (Int)

On add: No change at EngineRefresh TransmissionTag is created under tag folder path at Engine

Delete a tag

Delete G1/E1/D1/Tag2

On delete: Engine will mark tag as Bad_Stale

Delete tag at Engine

Tag deleted

Delete tag and add tag with the same name

Delete G1/E1/D1/Tag1

Add G1/E1/D1/Tag1 (Bool)


On delete: Engine will mark tag as Bad_Stale

On add: No change as Engine

Refresh TransmissionTag will be configured at Engine under tag folder path with any new properties and GOOD quality

Delete tag and create a folder which has the same name as the tag. Add a tag to this folder.

Delete G1/E1/D1/Tag1

Add G1/E1/D1/Tag1/Tag2

On delete: Engine will mark tag as Bad_Stale

On add: No change at Engine


Delete tag at Engine before a Transmission refresh is performed

New tag will be created under new tag folder path at Engine

Refresh Transmission without deleting tag at Engine

Error similar to below logged, tag will not be deleted and no tag path folder will be created

Error processing edit for tag path '[MQTT Engine]Edge Nodes/My MQTT Group/Edge Node 0964bf/PLC 1/New Tag/New Tag1': Bad_Unsupported("The target path '[MQTT Engine]Edge Nodes/My MQTT Group/Edge Node 0964bf/PLC 1/New Tag' cannot accept children tags.")

Delete tag and parent folder and add a tag with same name as the parent folder

Delete G1/E1/D1/Tag1/Tag2

Add G1/E1/D1/Tag1

On delete: Engine will mark tag as Bad_Stale

On add: No change at Engine

Refresh TransmissionTag and folder will be configured at Engine

...

Action at EdgeResultActionResult

Add a UDT Instance

Add G1/E1/Instance2 with type T3

On add: No change at EngineTransmission RefreshNew Instance created at Engine

Delete member tag of UDT Instance (this will delete the UDT Instance)

Delete G1/E1/D1/Instance1/New Tag

On delete: MQTT Engine marks all tags for the Instance as Bad_StaleDelete tags at MQTT Engine

Delete UDT Instance

Delete G1/E1/D1/Instance1 with type TestUDT

On delete: MQTT Engine marks all tags for the Instance as Bad_StaleDelete tags at MQTT Engine

Delete UDT Instance and add with the same name and UDT type

Delete G1/E1/D1/Instance1 with type TestUDT

Add G1/E1/D1/Instance1 with type TestUDT

On delete: MQTT Engine marks all tags for the Instance as Bad_Stale

On add: MQTT Engine will mark all tags for the Instance as Good quality

No action required

Delete UDT Instance and add with the same name and different UDT type

Delete G1/E1/D1/Instance1 with type TestUDT

Add G1/E1/D1/Instance1 with type T2


On delete: MQTT Engine marks all tags for the Instance as Bad_Stale

On add: No change at Engine


Delete tags at Engine before Transmission refresh is performed

New Instance created at Engine

Refresh Transmission without deleting tags at Engine

Tags show Bad_Stale at Engine

Various errors from tags.management.provider for new tags in definition structure

Error processing edit for tag path '[MQTT Engine]Edge Nodes/G1/E1/D1/Instance1/t3folder/t3Inst/t3Tag1': Bad_Unsupported("The target path '[MQTT Engine]Edge Nodes/G1/E1/D1/Instance1/t3folder/t3Inst' cannot accept children tags.")

Error processing edit for tag path '[MQTT Engine]Edge Nodes/G1/E1/D1/Instance1/t2Tag1': Bad_Unsupported("The target path '[MQTT Engine]Edge Nodes/G1/E1/D1/Instance1' does not have item 't2Tag1' for overrides, and cannot accept children tags.")

...