Overview

Contact points and subscriptions are used to control how and when pulse™ will notify you of build events. Rather than having to constantly check on the status of your projects, you can instruct the pulse™ server to notify you when something of interest happens. For example, you may wish to be emailed whenever a build fails for a project your are participating in. Contact points and subscriptions are a part of your preferences, and are managed via your "preferences" tab.

Contact Points

A contact point is a way for the pulse™ to get in contact with you. Pulse supports two types of contact points:

Type	Description
Email	An email address for receiving HTML or plain text emails.
Jabber	Jabber account details for receiving instant messages.

Note that you can also subscribe to RSS feeds for a project by copying the page URL into your feed reader.

Adding Contact Points

To add a new contact point, click the "create contact" link at the bottom of the "contacts" table. This will take you to the contact point wizard which will guide you through the process of adding the contact. The wizard involves two steps:

1. Selecting the type of contact point
2. Entering type-specific information (refer to the types above)

Once you have added a contact point, you will be able to subscribe to project notifications.

Managing Contact Points

You can edit the type-specific details for a contact point at any time by clicking the "edit" link in the corresponding row of the "contacts" table. Refer to the documentatin for the specific contact point type for configuration information.

To remove a contact point, click the "delete" link in the corresponding row of the "contacts" table.

Warning When you delete a contact point, all subscriptions that refer to that contact will also be deleted.

Subscriptions

A subscription is a connection between a project and a contact point that specifies which notifications you would like to be sent to that contact point. The subscription consists of:

• The events you wish to be notified of; and
• The contact point that will receive notifications; and

Subscriptions are broadly divided into two categories, summarised in the table below:

Adding Subscriptions

To add a new subscription, click the "create subscription" link at the bottom of the "subscriptions" table. You will be prompted to select the contact point you wish notifications to be sent to and the type of subscription. Upon preceding, you will be prompted for details for the specific subscription type.

Deleting Subscriptions

If you no longer want to receive notifications, you can delete the subscription by clicking the "delete" link in the corresponding row of the "subscriptions" table.

Subscription Templates

Subscription messages are rendered using templates that define the contents and format of the message. Several templates are provided, tailored for different contact point types. It is also possible to define your own templates, see Subscription Templates for details.