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.
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:
| Type |
Description |
| personal build subscriptions |
A subscription to results of your personal builds. |
| project build subscriptions |
A subscription to build results for one or more projects. |
Subscription Conditions
So that you can be notified only of results that interest you, project build subscriptions contain a subscription condition. Only build results that match the condition will trigger a notification. Several built in conditions are available, or you may create your own custom condition.
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.