Chat now with support
Chat with Support

Identity Manager 8.0 - Configuration Guide

One Identity Manager Software Architecture Working with the Designer Customizing the One Identity Manager Default Configuration Checking Data Consistency Compiling a One Identity Manager Database Working with Change Labels Basic System Configuration Data
One Identity Manager Authentication Module Database Connection Data Configuration Parameters for System Configuration Setting up the Mail Notification System Enabling More Languages for Displaying and Maintaining Data Displaying Country Information Setting Up and Configuring Schedules Password Policies in One Identity Manager Reloading Changes Dynamically TimeTrace Databases Machine Roles and Server Functions Files for Software Update Operating Systems in Use System Configuration Reports Using Predefined Database Queries Managing Custom Database Objects within a Database
The One Identity Manager Data Model Granting One Identity Manager Schema Permissions Working with the User Interface
Object definitions for the User Interface User Interface Navigation Forms for the User Interface Statistics in the One Identity Manager Extending the Launchpad Task Definitions for the User Interface Applications for Configuring the User Interface Icons and Images for Configuring the User Interface Language Dependent Data Representation
Process Orchestration in One Identity Manager
Declaring the Job Server One Identity Manager Service Configuration Handling Processes in the One Identity Manager
Tracking Changes with Process Monitoring Conditional Compilation using Preprocessor Conditions One Identity Manager Scripts Maintaining Mail Templates Reports in the One Identity Manager Custom schema extensions Transporting One Identity Manager Schema Customizations Importing Data Web Service Integration SOAP Web Service One Identity Manager as SPML Provisioning Service Provider Searching for Errors in the One Identity Manager Processing DBQueue Tasks One Identity Manager Configuration Files

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

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

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.

Table 280: Email Notification Properties
Property Value
Base object PersonWantsOrg
Subject "$DisplayOrg[D]$" status change
Mail body Dear $FK(UID_PersonOrdered).Salutation[D]$ $FK(UID_PersonOrdered).FirstName$ $FK(UID_PersonOrdered).LastName$,

The status was changed on the following request on $DateHead:Date$.

Product: $DisplayOrg[D]$

Requested by: $DisplayPersonInserted$

Reason: $OrderReason$

Current status of your request:

Approval: granted

Approver: $DisplayPersonHead[D]$

Reason: $ReasonHead[D]$

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

Related Topics

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
Related Documents