Adding Notification Events

Purpose

Follow this procedure to add a new notification event.

NOTE  If you do not specify a subject, message, or notification template the notification event is ignored.

To add a notification event:

  1. In Dimensions Build click the Notifications tab. In the navigation pane click Notifications and click Subscriptions. In the navigation or content panes click the Dimensions project containing the build configuration where you want to add a notification event. In the menu or content pane click Create New Notification Event.

  2. The Add New Notification Event dialog box appears.

  3. From the Project list select the Dimensions project where you want to add a notification event.

  4. From the Build Configuration list select the build configuration where you want to add a notification event.

  5. From the Targets list select the target to which the notification event will apply. To trigger a notification for all targets select All Targets.

  6. From the Event list select the type of event that will trigger the notification event. Some events also require that you select an additional option. For example, if you select the Build is finished event type you must also select an option from the Build Result list.

  7. From the Template list optionally select a notification template that will be used to populate the subject and message fields in the email message. If you do not want to use a template select <none>.

  8. For Subject type the subject of this notification event. If you do not specify a subject the template subject is used. To add a pre-defined variable do the following:

  9. a    Place the cursor where you want to add the variable.

    b    Click Insert Variable. The Insert Notification Variable to the Field dialog box appears.

    c     From the Variable Name field select a variable. The content of the variable is displayed in the Preview field. The Description field briefly describes the variable.

    d    Click OK.

    TIP  After you have inserted variables you can add freeform text anywhere in the field. You can also cut and paste variables if you want to rearrange their order.

  10. For Message type the message for this notification event. If you do not specify a message the template message is used. Add pre-defined variables and HTML formatting tags if required.

  11. Click OK. The notification event is added to the build configuration and displayed in the content pane.

Adding Notification Templates

Editing Notification Events

Adding Notification Subscriptions