# Message Types

The name of the message or pager type indicates the entity to which it relates, such as agreement, and the scenario in which it is used.

> For example, Message Type **1003** is called **Call – Note Added**. This message type would be used to send an email when a note is added to a call.

### Viewing Message Types <a href="#viewing" id="viewing"></a>

{% hint style="info" %}

### Before you start

You must have **System Set Up** selected in the Admin tab of your **General Access security role**.
{% endhint %}

1. Select the Menu button, then **Admin**, then select **System Administration**. The System Administration window appears.
2. Select the **Message Types** option. The **Message Types** window appears.It contains a table with two columns:

<table><thead><tr><th width="172">Code</th><th>A number assigned to the message type</th></tr></thead><tbody><tr><td>Name</td><td>The title of the message type. This indicates the entity the message relates to and the scenario in which it is used</td></tr></tbody></table>

### Viewing Message Type Templates <a href="#viewing2" id="viewing2"></a>

{% hint style="warning" %}
Each message or pager type is linked to a template, which is the file used to generate a message. The template is associated with a predefined query. Templates can be created and configured in the Designer.
{% endhint %}

1. View the list of message types.
2. Select the required message type, scrolling down if necessary.
3. Double click on the entry to select it. The **Message Type Map** window appears showing the following options:

<table data-header-hidden><thead><tr><th width="181"></th><th></th></tr></thead><tbody><tr><td>Open Designer</td><td>You would select this option to modify the selected template in the ASM Designer. This option is only enabled if your security role permits you to access ASM Designer.</td></tr><tr><td>Open Subject Editor</td><td><p>You would select this option to manage the message subjects.</p><p>Save any changes made on the Message Type Map window before selecting this option.</p></td></tr></tbody></table>

Below these fields, two browse tables are displayed. The left one lists all the templates in the system that can be selected for this message type. The right displays the template(s) linked to the selected message type, as well as the screen set(s) and the subject(s). ASM Core provides a default template for emails. New templates can be created using the Designer.

### Linking Templates to a Message Type <a href="#linking" id="linking"></a>

{% hint style="info" %}

### Before you start

There must be at least one message template assigned to the default screen set for the entity. If email templates are partitioned, there must be at least one message template for the default screen set **and** the default partition.

Additional templates may not be used except in some cases. Additional linked templates are available for selection only on selected windows where Analysts can select a template, for example, the **Send Email** window of a call or request.

For emails that are sent automatically by the system, you *cannot* link more than one template to the same screen set. If **email templates** are partitioned, you *cannot* link more than one template to the same screen set and the same partition.

You must have **System Set Up** selected in the Admin tab of your **General Access security role**.
{% endhint %}

1. Select the template from the **Template** table on the left.
2. Select  to link the template to the selected message type. It appears in the right hand table.
3. If you have a partitioned system, assign the partition. Select the **Partition** cell for the template. This will display a drop-down list with all the partitions to which you have access. Select the partition you want to assign to the message template.
4. You only need assign partitions to message templates that are specifically designed for that partition. When the system tries to send an email that does not have a message template assigned to the partition of the entity, it will use the topmost message template displayed in the Default partition.
5. Amend the **Subject**, if you wish. Select the existing subject to see the small arrow indicating a drop down list of subjects linked to the screen set. You can update the subjects using the Subject Editor.
6. Select  to save the changes. Provide the Change Reasons if prompted to do so.

### Customizing Message Templates

{% hint style="warning" %}
You cannot modify pager templates.
{% endhint %}

1. Select the template from the **Template** table.
2. Select **Open Designer**. The ASM Designer window opens with the associated entity, such as Call, selected in the left hand pane and the list of screens on the right filtered to display only message templates.
3. Customize the template using the features of ASM Designer.
4. Return to the Message Type Map window. Select  to save the changes. Provide the Change Reasons if prompted to do so.

### Message Subjects <a href="#managing" id="managing"></a>

You can define the subject for a message and include fields from the selected entity type for a particular screen set to use in the subject. You can define a default subject as well as a particular subject for each screen set associated with the current message type.

#### Creating a Message Subject

1. Select **Open Subject Editor**. The **Message Subjects** window appears.
2. Configure the **Message Subject Details**:

<table><thead><tr><th width="130">Name</th><th>The name for the subject</th></tr></thead><tbody><tr><td>Screen Set</td><td><p>Select the screen set from the drop down list.</p><p>Only the screen sets associated with the entity linked to the selected message type are displayed.</p></td></tr><tr><td>Data fields for</td><td>Select the data field for the message from the drop down list. This determines the data fields displayed in the browse table.</td></tr><tr><td>Display Title</td><td>Select the display title from the list provided, scrolling down if necessary</td></tr><tr><td>Subject</td><td>Type the text that you want to appear in the subject line of the email template. You can also drag and drop data fields from the left hand list into this field if needed.</td></tr></tbody></table>

1. Select **Ok**. A new row with the details of the subject is added to the list of subjects in the **Message Subjects** window.
2. Select to return to the **Message Types** window.
3. Link the new subject to the new template using the **Subject** drop down if necessary.
4. Save the details.

{% hint style="warning" %}
Subjects are specific to the screen set for which they were created. This is in consideration that fields may not be available on a different screen set. The only exception is the Base Entity screen set, such as Base Task Screen Set, Call Screen Set, etc. Subjects created using these 'base' screen sets can be mapped to message temples of any screen set.
{% endhint %}

#### Editing a Message Subject

1. Select **Open Subject Editor**. The **Message Subjects** window appears.
2. From the Subject List browse table, select the message subject you wish to modify.
3. Select **Edit**.
4. In the **Message Subjects** box, configure the Message Subject Details:

<table><thead><tr><th width="167">Name</th><th>The name for the subject</th></tr></thead><tbody><tr><td>Screen Set</td><td><p>Select the screen set from the drop down list.</p><p>Only the screen sets associated with the entity linked to the selected message type are displayed.</p></td></tr><tr><td>Data fields for</td><td>Select the data field for the message from the drop down list. This determines the data fields displayed in the browse table.</td></tr><tr><td>Display Title</td><td>Select the display title from the list provided, scrolling down if necessary</td></tr><tr><td>Subject</td><td>Type the text that you want to appear in the subject line of the email template. You can also drag and drop data fields from the left hand list into this field if needed.</td></tr></tbody></table>

1. Select **Ok** to save the changes or  to return without saving.
2. Select  to return to the **Message Type Map** window.
3. Link the subject to the template if necessary.

#### Deleting a Message Subject

1. Select **Open Subject Editor**. The **Message Subjects** window appears.
2. From the browse table, select the message subject you wish to delete.
3. Select **Delete**. A pop-up window asking you to confirm the deletion will appear. Select **Yes** to confirm the changes and **No** to exit the window without saving.
4. Select  to return to the **Message Type Map** window.

The subject will no longer be available in the drop down list on the **Message Type Map** window.

### Unlinking Templates

1. Select the template from the table on the right.
2. Select to remove it from the list.
3. Select to save the changes. Provide the Change Reasons if prompted to do so.