Share this page
{{responsibility-assignment}}
The {{responsibility-assignment}} tag is used to insert a response link in the body of the responsibility assignment request message. The user receiving this email message can either accept or decline responsibility for the item indicated in the message. StarTeam Notification Agent de-references this tag at runtime to a set of instructions for the mail client to execute. The result is an automated response that is back to StarTeam Notification Agent.
The response instructions can take a form of a URL or a mailto: command. In the first case, the mail client would invoke an Internet browser and the browser would send an http request to the http server built into Notification agent. The http request is processed by StarTeam Notification Agent, and a page is sent back to the browser with information about the result of the operation (error or success).
In the latter case, the mail client reacts by creating a new message window, with a pre-formatted email message that can be mailed by the user to the StarTeam Notification Agent mailbox. StarTeam Notification Agent retrieves the email response from the mailbox and processes it accordingly. If the confirm attribute is set, StarTeam Notification Agent notifies the user about the success of the operation. Errors during processing are always reported via email.
In either case, the {{responsibility-assignment}} tag is converted into a command with a set of parameters that uniquely identify the user, item and request. The user is not required to enter any new data while executing the response.
The {{responsibility-assignment}} tag should be placed in a hypertext link for convenient execution.
Attributes
| response |
Optional: no Permitted Values:
Comment: Properly formed responsibility assignment request messages should contain this tag twice; once with response=accept and once with response=decline, to give the user a choice. |
| method |
Optional: no Permitted Values:
Comment: The mode of responding to the responsibility assignment request: either by using the built-in http server or via email. |
| confirm |
Optional: yes Permitted Values:
Comment: The default value is yes. Applicable to mail responses. Http responses always trigger confirmation. |
Examples
The following template excerpt:
<a href="{{responsibility-assignment response="accept" method="mail"}}">Click here if you accept</a><a href="{{responsibility-assignment response="decline" method="mail"}}">Click here if you decline</a>
would be converted to something like:
<a href="mailto:RAResponse:TaskID=5103320a-3723-fc51-3237-51fcef000000:RequestID=5103320a-3742-fc51-5137-51fcef000000:Response=accept">Click here if you accept</a><a href="mailto:RAResponse:TaskID=5103320a-3723-fc51-3237-51fcef000000:RequestID=5103320a-3742-fc51-5137-51fcef000000:Response=decline">Click here if you decline</a>
Similarly,
<a href="{{responsibility-assignment response="accept" method="http"}}">Click here if you accept</a><a href="{{responsibility-assignment response="decline" method="http"}}">Click here if you decline</a>
would be converted to something like:
<a href="http://agent_server:8080/NA/AssignTask?TaskID=5f05320a-7918-fc9d-2779-9dfcef000000&RequestID=5f05320a-7937-fc9d-4779- 9dfcef000000&Response=accept">Click here if you accept</a><a href="http://agent_server:8080/NA/AssignTask?TaskID=5f05320a-7918-fc9d-2779-9dfcef000000&RequestID=5f05320a-7937-fc9d-4779- 9dfcef000000&Response=decline">Click here if you decline</a>
The actual email message might look like the one on the next page. Note the “Click here if…” links. Clicking on the link will invoke the browser if method="http" was used, or it will create a new email message if method="mail" was used.
