Notifications

Search for	Example	Results
A single word	`cat`	Topics that contain the word "cat". You will also find its grammatical variations, such as "cats".
A phrase. You can specify that the search results contain a specific phrase.	`"cat food"` (quotation marks)	Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase.

Search for	Operator	Example
Two or more words in the same topic	`AND` `and` `+` (plus symbol) `&` (ampersand)	`cat AND dog` `"cat food"+milk` `"cat food"&"dog food"`
Either word in a topic	`OR` `or` `\|` (pipe)	`cat OR dog` `cat \| dog`
Topics that do not contain a specific word or phrase	`NOT` `not` `!` (exclamation point)	`NOT cat` `! dog`
Topics that contain one string and do not contain another	`^` (caret)	`cat ^ mouse`
A combination of search types	`( )` parentheses	`cat + (dog \| mouse)` `cat \| dog + (! mouse)`

Notifications are pre-formatted email messages that Service Management sends when certain workflow events occur.

Notification templates contain the structure for each type of message. You can add, update, or delete any template for an email notification if you have customer administration permissions. Each template contains the information that the recipient needs to know when the workflow triggers the email to be sent.

For example, a template for a new incident notification includes all the details of a new incident. Service Management sends this email when the recipient is the owner of the new incident, or belongs to the assignment group that owns the new incident. A template for an impending SLT breach contains information about the service target and the amount of time that remains until the breach occurs.

Important

If you customize default templates or create new templates, and your Service Management community uses different languages, you must localize any new notification content. You must choose the languages and provide the translated message text that appears in the revised or new template.
Use of a public distribution list for a group notification overrides notification preferences.

Note Before an email notification is sent, Service Management validates that the submitter has permission to view the record for which the message is being sent.

How to create a notification template

If you have customer administration permission, you can add a new template. Service Management provides a rich text editor to create formatted text and insert images or links.

Note If you have development and production tenants, all configuration changes must be made on the development tenant. For more information about synchronizing the tenants, see Dev2Prod - How to synchronize your development and production tenants.

From the main menu, select Administration > Configuration > Records.
Select a record type. For example, select Incident.
Select the Notifications tab. The left pane of the tab displays a list of all existing templates for the record type. The list shows the title that appears as a heading for the email notification.

Click Add to create a new template.
If you want to create the template in a language other than English, click on the right side of the template menu bar and select the desired language.
Note
- An asterisk is displayed next to the language name until you save the template. In addition, an indicator () is displayed next to the language name to indicate that you have not yet added content to the template. Once you add content and save the template, the indicator disappears.
- To hide a specific language version of the template, click on the language name tab. If you add that language again, the last saved template will be displayed.
Type a template Name. This is the internal template record name.
Type a Display name. This is the external template name that appears in the list of email templates.
Type a template Description.
Deselect the Enabled check box to prevent the notification from being sent. By default, sending is enabled for all notifications.
Select the Use group email check box to send the notification to the group email, rather than to each group member individually. It is relevant when a group is selected for the recipients parameter in the Send notification business rule. If no group email is defined for the selected group, the notification is sent to each group member individually.
Note

When the Use group email check box is selected:
- You cannot use the Expression language phrase current_recipient in the template.
- Service Management sets the language for the email to the same language as that of the group owner.
- If there is no group owner, Service Management sets the language for the email to English.
- If there is no group email address, Service Management instead sets the language for the email individually, to the same language as each recipient’s specified language.
- Notification preferences that are set for individual users are ignored when a notification is sent to a group.
Select the Enable agent notification preferences check box to enable the preferences that an administrator has specified about when, to whom, and for what records notifications will be sent.

When you select this check box, the Event type drop-down list appears, enabling you to select a predefined event type. For more information, see Notification settings.

Note This functionality is available for Request, Change, Incident, and Task records only.
In the From email field, enter the sender's email address to appear in the template. The default email address is hp_service_anywhere_noreply@hpe.com.
In the From name field, enter the sender's name to appear in the template. The default is a blank value.
In the Message section, type the template Subject text, for example, This request is complete.
Type the message body using the rich text editor to add special formatting to your message.

If you want to add an image to your message, you must copy the image from a publicly available URL that can then be accessed by the recipient’s email client. Do the following:
1. Access the image URL.
2. Use your browser’s Copy Image function.
3. Return to the Service Management page where you are creating the notification template.
4. Paste the image into the template.
To embed a URL in the message body, do the following:
1. Click the link button in the editor toolbar.
2. In the Link dialog box, enter the required URL.
3. If you are embedding an external URL, select the relevant protocol for that URL.
4. If you are embedding a URL link to a record, select the blank protocol option. Service Management automatically completes the URL with the correct protocol to access the specified record. Enter the link to the record using the Create_url processing rule. For more information, see Processing rules in notifications.
To copy a link from a non-customized notification to a customized notification, follow these steps:
1. In the non-customized notification, select and copy the link you wish to duplicate (the "original link").
2. Paste the exact text that is presented, in Expression Language format, into the new custom notification. For example, to copy a link to a record's display label, you would copy the following text:
  
  ${:entity.Type} ${:entity.Id}: ${:entity.DisplayLabel}.
3. Select the original link again in the non customized notification.
4. Click . The Link dialog box is displayed.
5. Copy the content of the URL field.
6. Click Cancel.
7. In the new custom notification, select the text you pasted in step b above, and click . The Link dialog box is displayed.
8. Select blank for Protocol.
9. In the URL field, paste the content you copied in step e above.
10. Click OK.
If you want to the notification to be sent as a mobile notification as well, select Mobile app above the language bar. For more information on mobile app notifications, see Enable mobile notifications.
Click Save. Service Management adds the template to the list of templates in the left pane. The right pane displays the new template information.
Make any changes or enhancements to the basic template.
Click Save on the toolbar.

Note Click Discard to erase unsaved changes. Click Remove to delete a template with saved changes.

How to update a notification template

You can update existing templates with new messages or other text.

From the main menu, select Administration > Configuration > Records.
Select a record type. For example, select Incident.
Select the Notifications tab. The left pane of the tab displays a list of all existing templates for the record type. The list shows the title that appears as a heading for the email notification.

Select the template to be updated.
Change any field:
- Name
- Display name
- Description
- From email
- From name
- Subject
- Message body
- Language. Select a language from the drop-down list at the top of the page. The new language is added to the previously selected language(s).
If you want to sent notifications only for specific events, click the Enable agent notification preferences check box and select the desired events.
If you want to add a mobile notification to this template, select Mobile app above the language bar. For more information on mobile app notifications, see Enable mobile notifications.
Click Save on the toolbar.

Note Click Discard to erase unsaved changes. Click Remove to delete a template with saved changes.

Optional: Click Header and footer to create a custom header or footer. The rich text editor enables to you make modifications to existing text, add new text, choose fonts, embed images, or create links to external destinations. If you change the header or footer, the changes apply to all notification templates.

How to edit a system notification template

You can edit the structure and content of the system templates. These templates are used for system activities. Although the templates are applicable to all record entities, they cannot be selected for any specific entity.

From the main menu, select Administration > Configuration > Records.
From the drop-down list, select Cross-record settings.

Select one of the following system notification templates to edit:

Template	Description
Authorization code	Used when an authorization code is sent to a user for strong identity validation
Comment modified	Used when a comment is updated
Conversation invitation	Used when a user is invited to join a conversation
Conversation post modified	Used when a post in a conversation is updated
Default template for records	Used when the ID for the selected template cannot be found in the system
Header and Footer	Contains the header and footer that appears in all notifications
New answer added	Used when a new Q&A answer is added
New comment added	Used when a comment is added
New comment added, with anonymous agent details	Used when a comment is added, and excludes the IT agent's name and avatar
New conversation post added	Used when a post is added to a conversation
New question posted	Used when a new Q&A question is asked
Request verification code for encryption domain	Used when a verification code is requested for an encryption domain
Request verification code for strong identity validation	Used when a verification code is requested for strong identity validation