Searching the Help
To search for information in the Help, type a word or phrase in the Search box. When you enter a group of words, OR is inferred. You can use Boolean operators to refine your search.
Results returned are case insensitive. However, results ranking takes case into account and assigns higher scores to case matches. Therefore, a search for "cats" followed by a search for "Cats" would return the same number of Help topics, but the order in which the topics are listed would be different.
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 |
|
|
Either word in a topic |
|
|
Topics that do not contain a specific word or phrase |
|
|
Topics that contain one string and do not contain another | ^ (caret) |
cat ^ mouse
|
A combination of search types | ( ) parentheses |
|
- Record Management
Notifications
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 view a notification template
-
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.
-
You can select any template in the list of Email templates to view the entire template in the right pane.
Note To see how the notification will appear when it is sent, click Preview on the toolbar.
- To change the order of the languages, click on the left side of the template menu bar. Select a language and click or to move it.
- Click or to scroll through the list of languages.
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 sma_noreply@microfocus.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:
- Access the image URL.
- Use your browser’s Copy Image function.
- Return to the Service Management page where you are creating the notification template.
- Paste the image into the template.
-
To embed a URL in the message body, do the following:
- Click the link button in the editor toolbar.
- In the Link dialog box, enter the required URL.
- If you are embedding an external URL, select the relevant protocol for that URL.
- 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:
- In the non-customized notification, select and copy the link you wish to duplicate (the "original link").
-
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}
. - Select the original link again in the non customized notification.
- Click . The Link dialog box is displayed.
- Copy the content of the URL field.
- Click Cancel.
- In the new custom notification, select the text you pasted in step b above, and click . The Link dialog box is displayed.
- Select blank for Protocol.
- In the URL field, paste the content you copied in step e above.
- 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 delete a notification template
If you plan to delete a notification template, make sure that you understand where Service Management uses the template to send workflow email notifications. If you remove the template, users will not receive the notifications specified by the workflow business rules.
-
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 deleted.
- Click Remove on the toolbar.
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 > Studio.
- 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 - After you have made your changes, click Save on the toolbar.