A tag is simply a string that is attached to the task when it is created. Since the tasks for each session can come from different user requests, the tasks that belong to a particular request can be identified by their tags. The task tag can later be used to filter only those tasks that share the given tag.
The client application is responsible for generating the task tag. The tag, which can be up to 128 characters in length, is limited to alphanumeric, hyphen, and underscore characters. Note that the task tag cannot begin with a hyphen.
The task tag is set in the TaskSubmissionAttributes object, which is passed as an input parameter to the sendTaskInput() method. The following code samples demonstrate the use of the task tag for each of the supported programming languages. For more details, refer to the API reference documentation.
Actions that query and display related tasks can be performed by supplying the task tag or wildcard characters via the command line interface. Refer to Symphony Reference documentation for more information on the commands that accept the task tag as a filter.
The task tag can also be supplied through the Platform management console as a filter. Refer to the online documentation provided with the management console for further information.