Knowledgebase

Search:     Advanced search

Using Hyperlinks in TestTrack Email Notifications

Article ID: 323  |  Last updated: 31 Dec, 2014

Note: This information only applies to TestTrack 2008 and later.

You can include hyperlinks in TestTrack email templates, which requires using field codes in the email template body. When a notification is sent, the field code is replaced with a hyperlink to the record that caused the notification to be sent. Users click the hyperlink to go directly to the record. For example, when users receive an assignment email, they can click the hyperlink to go directly to the assigned record.

You can use controlled hyperlinks to require the recipient to log in to view the defect, make the hyperlink invalid after it is accessed once, or disable access using the hyperlink after a specific number of hours, days, weeks, or months.

TestTrack includes the following hyperlink field codes:

  • %TTSTUDIOURL%—Creates a ttstudio hyperlink to the related defect, test case, or test run. Always use this field code to provide links to test cases and test runs. Use this field code to provide links to defects for TestTrack Client and TestTrack Web users if you do not want to control access to the hyperlink.
  • %HTTPURL%—Creates an http hyperlink to the related defect. Use this field code to provide links to defects for TestTrack Web users if you do not want to control access to the hyperlink.

    Note: The TestTrack CGI must be configured in the project options if you use this field code. Choose Tools > Administration > Project Options and click the Hyperlinks category. Enter the TestTrack CGI URL.
  • %NURL%—Creates a controlled http hyperlink to the related defect. Use this field code to provide links to defects for TestTrack Web users if you want to control access to the hyperlink.

    To use this field code, controlled email notification hyperlinks must be enabled in the project options. Choose Tools > Administration > Project Options and click the Hyperlinks category. Select Enable controlled email notification hyperlinks and select any options.

    Note: The TestTrack CGI must be configured in the project options if you use this field code.

Following are the steps for adding email notification hyperlinks.

  1. Choose Tools > Administration > Email Templates.
  2. Select the email template you want to add the hyperlink to and click Edit. You can also add email notification hyperlinks when you add email templates.
  3. Add the field code and any text to the body of the message.

    Note: If the Send email in HTML format is enabled for the email template, you need to use href tags with the field code. If you send a plain text email with a URL link in it, most email clients make the link clickable. If you send an HTML email with a URL link in it, use href tags to make the link clickable (e.g., <a href="%HTTPURL%"> Text </a>).
  4. Click OK to save the changes.
Article ID: 323  |   Last updated: 31 Dec, 2014
Tags
hyperlinks email notifications email template

Prev   Next
XML Export Does Not Work When Using Internet Explorer on a Mac     European Date Format Changes When Switching Tabs