Admin Templates (3.x.x and earlier): Difference between revisions

From Obsidian Scheduler
Jump to navigationJump to search
No edit summary
No edit summary
Line 10: Line 10:


[[Image:TemplateListing.png]]
[[Image:TemplateListing.png]]
== Adding or Editing a Template ==
When adding or editing a template, a unique name must be supplied, the template can be made active or inactive, and various template settings can be configured.
'''Note:''' The question mark icon next to form titles indicates inline help. Click on the icon to view help related to the current item.
For help with creating the email subject and body templates, see [[Email_Templates]].
Every template applies either to a specific notification category, or the ''All'' category, which is used when no other matching template exists. A single category can be selected for each template. These categories are the same as those used when configuring subscriptions.
For categories that are job-related, you may indicate the template is the default for that category by checking the ''Use as Default'' box. If this is not selected, you will be able to select specific jobs that the template applies to. Templates that are linked with specific jobs are always used instead of defaults when they exists.
For non-job related categories, an active template is always considered the default.
'''Note:''' When an active template is saved, other templates may be updated automatically. If the template is for a non-job category or it is marked as ''Use as Default'', any other templates with the same category will be made inactive. If the template applies to specific jobs, any templates with the same category and job mappings will be updated to remove the overlapping applicable jobs.
Changes may be confirmed by clicking the Save button at the bottom of the form, or the one in the left navigation area.
[[Image:AddTemplate.png]]

Revision as of 00:58, 3 June 2013

As of version 2.0, Obsidian supports customizable templates for all email notifications.

The email templates screens allow users to customize the content of notification emails by event category and even by specific jobs.

Templates management screens are reached via the Notifications tab and are visible to users with the Admin role.

Listing Templates

The main templates screen shows the current configured templates and their details. Obsidian comes with two default templates. Click on the template name to edit the template Add Template link in the navigation bar below the tabs to create a new one.


Adding or Editing a Template

When adding or editing a template, a unique name must be supplied, the template can be made active or inactive, and various template settings can be configured.

Note: The question mark icon next to form titles indicates inline help. Click on the icon to view help related to the current item.

For help with creating the email subject and body templates, see Email_Templates.

Every template applies either to a specific notification category, or the All category, which is used when no other matching template exists. A single category can be selected for each template. These categories are the same as those used when configuring subscriptions.

For categories that are job-related, you may indicate the template is the default for that category by checking the Use as Default box. If this is not selected, you will be able to select specific jobs that the template applies to. Templates that are linked with specific jobs are always used instead of defaults when they exists.

For non-job related categories, an active template is always considered the default.

Note: When an active template is saved, other templates may be updated automatically. If the template is for a non-job category or it is marked as Use as Default, any other templates with the same category will be made inactive. If the template applies to specific jobs, any templates with the same category and job mappings will be updated to remove the overlapping applicable jobs.

Changes may be confirmed by clicking the Save button at the bottom of the form, or the one in the left navigation area.

File:AddTemplate.png