The Maintain Wdata Tag Values template is used to create and maintain tags in your workspace. When run, the chain updates all available tags with a specified value; if the tag doesn't exist yet, the chain will create the tag and populate it for you.
Requirements
The following connectors must be enabled by an org security administrator:
Build your template
The Maintain Wdata Tag Values template is located in the Workiva Chains section of the Templates screen.
Here's how to find it:
- In Chain Builder, go to the Templates tab.
- Select Workiva Chains from the menu at the top.
- Search for Maintain Wdata Tag Values at the top right and open the template.
After locating your template, configure it to for your workspace using the variables and runtime inputs listed below.
Note: For detailed instructions on creating a chain from a template, see the Create and manage chains article.
Variables
Please note that all variables listed here are required.
| Type | Name | Purpose |
| Workspace variable | wsv_API Base URL - IAM | Root path to the IAM API. You can find this value in our API developer documentation. |
| Workspace variable | wsv_API Base URL - Wdata | Root path to the Wdata API. You can find this value in our API developer documentation. |
| Workspace variable | wsv_Client ID | The client ID of your OAuth grant. Learn more about setting up an OAuth grant. |
| Workspace variable | wsv_Client Secret | The client secret of the OAuth grant. Ensure that this variable is encrypted after entering it. Learn more about setting up an OAuth grant. |
Runtime inputs
| Runtime input | Purpose | Option value | Required |
| Tag name | Name of the tag to update or create in Wdata. | <text entry> | Yes |
| Tag value | Value to add to the list of selections for the tag. | <text entry> | Yes |
Configurable nodes
The following nodes contain an output text field that can be customized for your business:
- Set Result Text - Tag Exists
- Set Result Text - New Tag