About notification templates

Notification templates provide a means of sending customized messages to you about events in the system.

Template types provided

The system includes a set of notification template types, as follows:

Each type includes a set of translated messages. The messages use variables to provide context.

Global usage

Use the provided templates globally as follows:

Messages stored in translations

The notification message used is stored in a translation associated with the template type. Each translation specifies information about its notification message:

You can edit the translations in both the provided notification templates and in notification templates that you create.

Message format

Messages can be sent in one of two message types:

Variables in templates

The system parses the templates for a number of variables (See Using environment variables and register variables.)

Custom templates for specified projects and steps

You can create customized notification templates based on the provided notification types. The customized templates must be associated with a project or an individual step within a project. See Creating new templates for specific projects and steps.

About the Templates panel

Use the Templates panel to set up notification about events. To view the panel, select Projects > Templates.

Screen image of the Templates panel in the Projects panel

The panel lists all of the templates that come with Rational® Build Forge®. When creating a new template, enter information in the following fields:

Type
The type of message. Select an existing template type.
Project
Specify the project that is sending the message.
Step
Specify a step within the project that is sending the message.

About the Translations panel

Use the Translations panel to set up messages that are used by templates. To view the panel, select Projects > Templates, and then select a template from the list. A list of translations for the template is shown. Each item in the list displays the following information:

Language
Required. The language for the message.
Description
Used as the title of the translation in the list.
From
Optional: An email address to use in the From field of the message. The following email address formats are supported.
username@host.com
name username@host.com
name "<username@host.com>"
name <username@host.com>
name "username@host.com"

Where

Username is the email user name.

Name is an arbitrary string, usually a given name in some form.

Subject
Required: A string to use in the Subject field of the message. It can contain variables.
Body
Required: The text of the message. It can contain variables.

Feedback