General Properties of a Mail Template

Table 279: Mail Template Properties

Property	Meaning
Mail template	Name of the mail template. This name will be used to display the mail templates in the administration tools and in the Web Portal. Translate the given text using the button.
Base object	Mail template base object. A base object only needs to be entered if the mail definition properties of the base object are referenced.
Report (parameter set)	Report, made available through the mail template.
Description	Mail template description. Translate the given text using the button.
Target format	Format in which to generate email notification. Permitted values are: Value Description HTML The email notification is formatted in HTML format. HTML format can contain formatting. TXT The email notification is formatted in text format. Text format cannot contain any formatting.
Design type	Design in which to generate the email notification. Permitted values are: Value Description Mail template The generated email notification contains mail text corresponding to the mail definition. Report The email notification is generated with the report contained under Report (parameter set) as mail body. Mail template, report as attachment The generated email notification contains mail text corresponding to the mail definition. The report entered in the Report (parameter set) field is attached to the mail as PDF file.
Importance	Importance for the email notification. Permitted values are "low", "normal" and "high".
Confidentiality	Confidentiality for the email notification. Permitted values are "normal", "personal", "private" and "confidential".
Can unsubscribe	Specifies whether the recipient can unsubscribe email notification. If this option is set, the emails can be unsubscribed through the Web Portal.
Disabled	Specifies whether this mail template is disabled.
Mail definitions	Unique name for the mail definition.
Language culture	Language which applies to the mail template.
Subject	Subject of the email message
Mail body	Content of the email message.

Related Topics

• Creating and Editing an Email Definition

Creating and Editing an Email Definition

Mail texts can be defined in these different languages in a mail template. This ensures that the language of the recipient is taken into account when the email is generated.

To create a new mail definition

1. Open the mail template in Mail Template Editor.
2. Click the button next to the Mail definition list.
3. Select the language culture you want the mail definition to apply to from the Language culture menu.

   All active language cultures are shown in the list. To use other languages, enable the corresponding countries.

4. Enter the subject in the Subject field.
5. Edit the mail text in the Mail definition view with the help of the Mail Text Editor.
6. Save the changes.

To edit an existing mail definition

1. Open the mail template in Mail Template Editor.
2. Select the language in the Mail definition list.
3. Edit the mail subject line and the body text.
4. Save the changes.

Related Topics

• Displaying Country Information

Using Base Object Properties

You can use all the properties of the object entered under Base object in the subject line and in the mail body. You can also use the object properties that are referenced by foreign key relation.

To access properties use dollar notation. For more information, see the One Identity Manager Configuration Guide.

Example

An IT Shop requester should receive email notification about the status of the request.

The generated email notification could look like the following, for example, once it has been formatted:

Related Topics

• Using Dollar ($) Notation

Use of Hyperlinks in the Web Portal

Use of Hyperlinks in the Web Portal

You can insert hyperlinks to the Web Portal in the mail body. If the recipient clicks on the hyperlink in the email, the Web Portal is opened on that web page and further actions can be carried out. In the default version, this method is implemented for IT Shop requests, in Identity Audit, for policy checking and in attestation.

Prerequisites for using this method

• The configuration parameter "QER\WebPortal\BaseURL" is set and contains the Web Portal URL.

  http://<Server>/<App>

  with:

  <Server> = Server name

  <App> = Web Portal installation directory path

To add a hyperlink to the Web Portal into the mail text

1. Click in the mail body at the point where you want to add the hyperlink.
2. Open the context menu and select Hyper Link....
3. Enter the hyperlink in Display text.
4. Set the option File or website.
5. Enter the address of the page to be opened in the Web Portal in Address.
6. To accept the input, click OK.

Related Topics

• Default Functions for Creating Hyperlinks
• Using Process Parameters in Hyperlinks