The "tagName" property is a required string that specifies the unique name of a tag. See also "tagId".
- It cannot be an empty string
"". - Must be between 1 and 256 bytes.
- In
"createInput"and"createOutput", you can use the"tagId"or"tagName"properties to associate the connector with a tag. - In
"alterInput"and"alterOutput", you can use the"tagId"or"tagName"properties to change the connector's association with a tag. - When assigning a tag to a connector, you can use either the
"tagId"or"tagName"property but not both. - If a tag is associated with a connector, the response to the input and output actions include both the
"tagId"or"tagName"properties; otherwise, these properties are omitted in the response.
Important The
"propertyPath"property is deprecated for the"createInput","createOutput","alterInput", and"alterOutput"actions. Instead, use the"tagName"or"tagId"properties.
When using connectors, this property specifies the full name of a tag, such as MyTag[10,42] for CIP-based PLCs.
For CIP-based PLCs, use the format Program:<program name>.<tag>.
- <program name> is the program name in which the tag is created
- <tag> is the name in the program
Examples: Program:MyProgram.MyTag accesses the tag MyTag in the program MyProgram.
PCCC-based PLC examples include N7:4, ST18:26, L20:2, MG14:6.en, B3:4/2, and so forth. Many common field name abbreviations are supported.