Alert Templates
Create different outbound email templates for different projects.
You can add, edit, delete and find existing email templates.
Template Types
Email templates are used upon one of the following actions:
- When new items are created (When Created)
- When someone is resourced (When Resourced)
- When an item is changed (When Updated)
- When watched items change (Watcher Notification)
- When something in the scope of an AppNav card changes (AppNav Card Alerts)
- To automatically acknowledge an email-to-ticket (Acknowledge Email - Breeze only)
- To reply from Zeromatic to an email-to-ticket initiator(Email Reply - Breeze only)
- Generic - not used by the Zeromatic alerts engine
NoteThe last two of these are only available to users of Breeze (email ticketing)
Defining Templates
Creating or editing templates will enable you to select the type of template and to provide a meaningful name.
- Name: meaniingful descriptor for the template
- Alert Type: type email template
- Subject: the email subject line
- Associated Project(s): leave blank for all projects or select the projects your template
- Content: the HTML for the template
Pay special attention to the associated projects for the template. Leave this field blank to use the template across all projects.
Template HTML Editor
When you add a Template the appropriate default HTML based on the event type is selected for you.
Injecting Data
Note the use of @(Model.TheItem.Type) for injecting item data into the email template. You can inject any of the below item fields - including custom fields.
The syntax for including the fields is @(Model.TheItem.FieldName) where the FieldName represents one of the below fields.
Available Fields
The following table lists all fields available from @(Model.TheItem) object.
| Field | Description |
|---|---|
| AffectedVersionNumbers | Any associated affected versions (comma separated) |
| Age | Number of days since item created |
| ClosedDate | The date and time this item was closed |
| ComponentNames | Components associated with item (comma separated) |
| Comments[n].Entity.Comment | Collection of all comments where "n" represents index of comment |
| Created | The date and time when the item was created |
| CustomFields["your custom field name"].Entity.Data | |
| Description | The full description of the item |
| DueDate | When work should complete for the item |
| Elapsed | Number of minutes since item opened till closure |
| EstimatedEffort | The number of hours and minutes to complete item (0h 0m format) |
| ExcessTime | The number of hours and minutes exceeding original estimate (0h 0m format) |
| FixedInVersion | Any associated version |
| Id | The id of the item (e.g. 23456) |
| IssueKey | The key of the item (e.g. GEM-23456) |
| LastComment | Latest comment for the item |
| LoggedHours | Total number of hours logged against this item |
| LoggedMinutes | Total number of minutes logged against this item |
| OriginatorData | Any associated source data for item (e.g. email address) |
| PercentComplete | How much work has been completed (e.g. 25%) |
| Points | Allocated points for item |
| Priority | The current priority of the item (e.g. High) |
| ProjectCode | The project code that the item belongs to (e.g. ACME) |
| ProjectName | The project name that the item belongs to (e.g. My Project) |
| RemainingTime | The number of hours and minutes to remaining for item (0h 0m format) |
| Reporter | The fullname of the user who reported the item (e.g. Joe Bloggs) |
| Resolution | The current resolution of the item (e.g. Complete) |
| ResolvedDate | The date and time this item was marked as resolved |
| ResourceNames | The resources assigned to the item (comma separated) |
| Revised | The date and time when the item was last revised |
| Reviser | The name of the user who last revised the item |
| Severity | The current severity of the item (e.g. Showstopper) |
| IsInSLA | Check if the item part of SLA |
| SLATimeLeftFull | The SLA time left in days hours minutes format (1d 2h 3m) |
| SLATimeLeftMinutes | How many minutes left for SLA |
| SLATimePassedMinutes | How many minutes have passed for SLA |
| StartDate | When work should commence on the item |
| Status | The current status of the item (e.g. Unassigned) |
| TimeLogged | The number of hours and minutes to logged against item (0h 0m format) |
| Title | The title of the item (e.g. Fix Cross-browser issues) |
| Type | The type of the item (e.g. Bug) |
| Visibility | The visibility of the item (e.g. Everyone) |
| Votes | The number of votes for this item |
The following table lists all fields available from @(Model) object (that's the associated workspace).
| Field | Description |
|---|---|
| CardKey | The key of the card - usually the project code |
| CardDescription | The user-specified title of the card |
| CardComment | Optional comment associated with the card |
| CardUrl | The URL to the page that the card points to |
| ChangeCount | The number of changes that took place for items within the card's sceop |
The following table lists all fields available from @(Model) object (this is only associated to "Email Reply (Breeze)" alert template).
| Field | Description |
|---|---|
| Model.Sender.Fullname | The fullname of the user who send the email reply from Zeromatic |
| Model.Sender.Entity.Email | The email address of the user who send the email reply from Zeromatic |
| Model.Sender.Entity.Firstname | The firstname of the user who send the email reply from Zeromatic |
| Model.Sender.Entity.Surname | The surname of the user who send the email reply from Zeromatic |
The following table lists all fields available from @(Model) object (this is only associated to "Acknowledge Email (Breeze)" alert template).
| Field | Description |
|---|---|
| Model.NewUserAdded | Check if the user just been created by Breeze, the property is a boolean (true/false) |
| Model.NewUserName | The username of the new user |
| Model.NewUserPassword | The password of the new user |
You can also change the system default tempate HTML located in the App Data\Notifications folder.