When you use system.tag.getConfiguration to get the configuration of UDt instances, it retrieves all non-default configuration of the UDT definition’s tags by deep recursively searching.
If you compare this to the Tag Browser’s copy JSON functionality, this only copies the properties of the UDT definition tags that are overridden, as well as of the name and tagType.
When using getConfiguration with configure, the output from copy JSON is required otherwise you will essentially be overriding the UDT Instance tags with all of the non-default properties that have been set on the tags in the UDT Definition, thus defeating the purpose of a UDT.
For example, take this UDT Definition:
{
"name": "TEST",
"tagType": "UdtType",
"tags": [
{
"valueSource": "memory",
"name": "New Tag",
"tooltip": "This is a great tag!",
"value": 999,
"tagType": "AtomicTag",
"engUnit": "bob"
}
]
}
This is the output from Copy JSON copying an instance of this UDT:
{
"name": "Test Instance",
"typeId": "_TESTING/TEST",
"tagType": "UdtInstance",
"tags": [
{
"name": "New Tag",
"tagType": "AtomicTag"
}
]
}
And this is the output from system.tag.getConfiguration:
[{
"path": "[default]_TESTING/Test Instance",
"tagType": "UdtInstance",
"name": "Test Instance",
"typeId": "_TEST/TEST",
"tags": [{
"path": "New Tag",
"tooltip": "This is a great tag!",
"tagType": "AtomicTag",
"name": "New Tag",
"engUnit": "bob",
"valueSource": "memory",
"value": "999"
}
]
}
]
If I was to use configure with the getConfiguration output, I would apply all of that tag config as overrides in the instance, thus practically unlinking all of the tag config from the UDT definition
I’m requesting that an argument be added into the getConfiguration function to determine what configuration to get: all non-default properties using a deep recursive search, or just the non-defaults at face value.
Forum post: