Adding item hyperlinks in email templates

You can add links to Helix ALM items in email templates. These links are included in email notifications and take users directly to the item that caused the notification to be sent. For example, when users receive an email about an assignment, they can click the link to go directly to the assigned item.

The following field codes can be used in email templates. You may choose to use one or both field codes in templates depending on the type of Helix ALM clients your team uses.

%TTSTUDIOURL%—Creates ttstudio links to items, which open in either the Helix ALM Client and Helix ALM Web, depending on the user's configuration.
%HTTPURL%—Creates http links to items, which only open in Helix ALM Web. The Helix ALM CGI must be configured if you use this field code. See Setting hyperlink project options.

1. Choose Tools > Administration > Email Templates.

The Configure Email Templates dialog box opens.

2. Select the email template to add the link field code to and click Edit.

You can also add link field codes when you add email templates. See Adding email templates.

3. Add the %HTTPURL% or %TTSTUDIOURL% field code and any text to the body of the message.

When the email is generated, the field code is replaced with a link to the item. If the recipient’s email application does not recognize the ttstudio protocol, the link may be inactive. Users can click the link to go directly to the item or copy the URL from the email and paste it in the Address bar to open the item. See Using the Address bar.

If the Send email in HTML format option is enabled, select the field code from the Available field codes list and click Insert to create a link. If you manually enter the field code, you must add href tags in the HTML view to make the link clickable (e.g., <a href=”%HTTPURL%”>Text</a>).

4. Click OK to save the changes.