From ICIHelp8.1
Jump to: navigation, search
Line 108: Line 108:
  
 
 
 
 
 +
  
  
Line 114: Line 115:
 
== Configuring Email Type for Notification ==
 
== Configuring Email Type for Notification ==
  
Users can configure the notifications to be sent to email addresses captured in the agreement instance and also set the recipients email type (To, Cc and Bcc) and sender email type (Reply-To and From) for the received emails.
+
Users can configure the notifications to be sent to email addresses captured in the agreement instance and also set the recipient's email type (To, Cc and Bcc) and sender email type (Reply-To and From) for the received emails.
  
 
To configure the subscription:
 
To configure the subscription:
  
1. '''Navigate '''to the "Recipients" tab as explained in the "Create Subscription" section.
+
1. '''Navigate '''to the "Recipients" tab as explained in the "Creating a Subscription" section.
  
2. '''Click '''"Add Recipients". The "Add Recipient"'' ''window opens. 
+
2. '''Click '''"Add Recipients". The "Add Recipients"'' ''window opens. 
<div class="image-green-border">[[File:8.0-Notification Settings-Subscription-create-recipent1.PNG|520px]]</div>  
+
<div class="image-green-border">[[File:8.0-Notification Settings-Subscription-create-recipent1.PNG|520px|8.0-Notification Settings-Subscription-create-recipent1.PNG]]</div>  
 
To add users provisioned in the system:
 
To add users provisioned in the system:
  
11.&nbsp;'''Search''' for the user using ''Refine Search'' ''here'' search bar.
+
11.&nbsp;'''Search''' for the user using the "Refine Search here" search bar in the left collapsible pane of the "Refine View".
  
12.&nbsp;'''Select '''the checkbox corresponding to the user. For example, ''Jill Water''.
+
12.&nbsp;'''Select '''the checkbox corresponding to the user. For example, Jill Water.
  
13.&nbsp;'''Select''' ''Email Type''. For example, ''To''.
+
13.&nbsp;'''Select'''&nbsp;"Email" Type. For example, ''To''.
  
14.&nbsp;'''Click''' ''Add''. The user will be added to the subscription.
+
14.&nbsp;'''Click''' Add. The user will be added to the subscription.
<div class="image-green-border">[[File:Configuring email type for notification subscriptions5.png|720px|Configuring email type for notification subscriptions5.png]]</div>
+
<div class="image-green-border">To add user emails captured during runtime while creating the agreement instance:</div>
To add user emails captured during runtime while creating the agreement instance:
+
15.&nbsp;'''Choose '''the attribute &nbsp;in which you captured email addresses during agreement instance creation in the "Select Attributes" field. For example, "Created By"
 
+
15.&nbsp;'''Choose '''the attribute &nbsp;in which you captured email addresses during agreement instance creation in the ''Select Attributes'' field. For example, ''Observer Emails''.
+
 
<div class="note-box">'''Note''': The ''Select Attributes'' dropdown will show all attributes with data types as ''User ''and ''Email''.</div>  
 
<div class="note-box">'''Note''': The ''Select Attributes'' dropdown will show all attributes with data types as ''User ''and ''Email''.</div>  
16.&nbsp;'''Select '''''Email Type''. For example, ''Reply To''. When users reply to the email notifications, it will be sent to these configured email addresses.&nbsp;
+
16.&nbsp;'''Select '''"Email Type". For example, "Reply To". When users reply to the email notifications, it will be sent to these configured email addresses.&nbsp;
<div class="note-box">'''Note''': When users chooses ''Reply All'' option while replying to the email, the reply will be sent to all the recipients in ''To, Cc'' and the user emails configured with the ''Reply To'' email type .</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Configuring email type for notification subscriptions6.png|720px|Configuring email type for notification subscriptions6.png]]</div>
+
<div class="note-box">'''Note''': When users choose the "Reply All" option while replying to the email, the reply will be sent to all the recipients in To, Cc and the user emails configured with the ''Reply To'' email type .</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">17.&nbsp;'''Click '''"Add". The&nbsp;details will be added to the subscription with the selected properties.</div>
17.&nbsp;'''Click '''''Add''. The&nbsp;details will be added to the subscription with the selected properties.
+
18.&nbsp;'''Add '''more users as recipients to the subscription with other email types following the same process. For example, attribute "Customer Email" with email type as "CC".
  
18.&nbsp;'''Add '''more users as recipients to the subscription with other email types following the same process. For example, attribute&nbsp;''Customer Email'' with email type as ''CC''.
+
19.&nbsp;'''Add '''a user with email type as "From".
 
+
19.&nbsp;'''Add '''a user with email type as ''From''.
+
  
 
The recipients will receive notifications from the user whose email address is set with the email type as From.
 
The recipients will receive notifications from the user whose email address is set with the email type as From.
<div class="image-green-border">[[File:Configuring email type for notification subscriptions7.png|720px|Configuring email type for notification subscriptions7.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="note-box">'''Notes''':&nbsp;  
+
<div class="image-green-border">&nbsp;</div> <div class="note-box">'''Notes''':&nbsp;  
 
*The sender email type ''From ''will, by default, be unavailable.&nbsp;  
 
*The sender email type ''From ''will, by default, be unavailable.&nbsp;  
 
*The ''From ''email type is configured through the technical configuration.&nbsp;  
 
*The ''From ''email type is configured through the technical configuration.&nbsp;  
 
*Users can not add more than one user with ''From ''email Type to the subscription. If the role/attribute with multiple users is configured with ''From ''email Type, system will pick any one user randomly. Therefore, it is recommended to use single user or user role/attribute that has single user associated with it.  
 
*Users can not add more than one user with ''From ''email Type to the subscription. If the role/attribute with multiple users is configured with ''From ''email Type, system will pick any one user randomly. Therefore, it is recommended to use single user or user role/attribute that has single user associated with it.  
</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Configuring email type for notification subscriptions8.png|720px|Configuring email type for notification subscriptions8.png]]</div>
+
</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">20.&nbsp;'''Click "'''Next". The "Verify" page opens. </div>
20.&nbsp;'''Click '''''Next''. The ''Verify ''page opens. 
+
21.&nbsp;'''Verify '''the details and '''click'''&nbsp;"Create". The subscription is created.
 
+
<div class="image-green-border">&nbsp;</div>  
21.&nbsp;'''Verify '''the details and '''click''' ''Create''. The subscription is created.
+
<div class="image-green-border">[[File:Configuring email type for notification subscriptions9.png|720px|Configuring email type for notification subscriptions9.png]]</div>  
+
&nbsp;
+
 
+
 
&nbsp;
 
&nbsp;
  

Revision as of 11:04, 7 December 2021

Notification Settings

As an administrator, you can create various notification categories and subscriptions under "Notification Settings". You can place your subscription in the appropriate notification category. 

Notification Category

The Notification Category is the one under which the notifications are triggered for various actions on UI or backend.

The categories are then visible to the respective users on the Notifications page, "Notifications Dashboard", by clicking the notification bell icon on the top right. A red dot will be displayed along with the notification bell icon which indicates that there are unread notifications for the user to go over.

Bell icon1.PNG
 
8.0-Notification Dashboard.PNG

 

Creating Notification Categories

To create a notifications category:

1. Click the "Notification Settings" menu under the "Admin" navigation menu on the top.

8.0-Notification Settings-Menu1.PNG
2. Click "Category". The "Notification Category" page opens. The existing categories are listed in a grid. The grid has sort and filter functionalities[[File:]] at the right of each column heading. The page also has pagination with pagination info displayed.
 
8.0-Notification Settings-Category-Grid3.PNG

3. Click "Create" on the far right in the title bar on top. The "Creat Category" page opens with the "Details" tab. 

4. Enter the appropriate "Category Name" and click "Create". The user is redirected to the "Notification Category" page with the created category listed on the top row.
 
8.0-Notification Settings-Category-Cerate.PNG
 
 

Editing Notification Categories

As an administrator, you can create as well as edit various notification categories.

To edit a notification category:

1. Click "Edit" on the three dots of the actions column in the last on the "Notification Category" page. 

2. Update the existing category name in the "Category Name" field, and click "Update". The updated notification category name appears on the " Notifications Category" page.

8.0-Notification Settings-Category-Edit.PNG

 

Deleting Notification Category

To delete the Notification Category:

1. Navigate to the "Notification category" page.

2. Select the categories you want to delete.

3. Click "Delete" on the right above the grid.

8.0-Notification Settings-Category-Delete.PNG

 

Subscription

Creating a Subscription

Using Subscriptions, you can create user notifications and assign appropriate recipients.

When creating a subscription:

  • Define the entity or a task for which the notification is to be sent.
  • Define the event for which it will be sent.

To create a subscription:

1. Click the "Subscription" menu of "Notification Settings". The "Subscriptions" page opens. On this page, you can see a list of all the existing Notification Templates and their details. 
 
8.0-Notification Settings-Subscription.PNG
 

2. Click "Create" on the top at the far right. The Create Subscription page opens.  

There are four tabs on this page:

  • Details
  • Template
  • Recipient
  • Verify
Note: When creating or editing a subscription, the Administrator must make sure that he set his language preferences to English (United States). Otherwise, an information message is displayed. Subscriptions can be created in English only. If you need your subscription in various languages, you can provide the localized content to the ICI configuration team to add it to the database through scripts. 

Details

3. Enter the mandatory fields:

  • Type an appropriate "Template Name" for the subscription.
  • Select an "Entity Name" such as "Agreement".
  • Select an "Event Name", such as "Agreement Approved".
  • Select a "Category Name" such as "Agreement Notifications".
  • Click "Next". The "Template" tab opens.
8.0-Notification Settings-Subscription-create-detail.PNG

Template

4. On the "Template" tab, define a template for user notifications and email notifications:

  • Type appropriate subject in the "Template Subject" textbox. All the notification emails using this template would have this content in the subject line.
  • Type an appropriate message in the "Template Body". Click the "Attributes" list to tag respective attributes in the template body. You can also format the selected attributes by using menu options.
  • Click "Next". The "Recipient" tab opens.
8.0-Notification Settings-Subscription-create-Template1.PNG

Recipient

5. To add recipients:

  • Click "Add Recipients". The "Add Recipients" drawer slides from the right.
  • Select "Select Roles" such as Approver, Internal Reviewer, etc.
  • Select "Select Attributes" such as Created By, Modified by, etc.
  • Check the "Action User" if necessary.
  • Select a desired user from the displayed grid or search a user using the "Refine View" filter left pane (Note: If "Refine View is collapsed, then expand to view it).
  • Click "Add". The user name and role get added to the list.
8.0-Notification Settings-Add-Recipients.PNG
 
For example, two recipients are added, "First Approver" with Role "Approver" and "Vijay Soni" as role "Reviewer.
 
8.0-Notification Settings-Subscription-create-Recipient.PNG
 
Note: You can tag users in the Notifications Template using their usernames or Email IDs.
  •  Click "Next". The "Verify" tab opens.

Verify

6. On this tab, verify all the information you entered for the Subscription. You can use the Collapse/Expand All icon on the top right to expand the data in all tabs or can expand or collapse individual tab data.

Click "Create" to create the Subscription. Notifications will be sent as and when the respective event occurs.

8.0-Notification Settings-Subscription-create-Verify.PNG

Notification can be sent in multiple languages. If there are multiple recipients with different language preferences for the respective event. The language is identified from the language set by the Internal User and External user with login privileges in their "Preferences". One single email is sent to all the selected recipients with the content in different languages. The recipients can simply scroll through the email and read the content drafted in their preferred language.

 



Configuring Email Type for Notification

Users can configure the notifications to be sent to email addresses captured in the agreement instance and also set the recipient's email type (To, Cc and Bcc) and sender email type (Reply-To and From) for the received emails.

To configure the subscription:

1. Navigate to the "Recipients" tab as explained in the "Creating a Subscription" section.

2. Click "Add Recipients". The "Add Recipients" window opens. 

8.0-Notification Settings-Subscription-create-recipent1.PNG

To add users provisioned in the system:

11. Search for the user using the "Refine Search here" search bar in the left collapsible pane of the "Refine View".

12. Select the checkbox corresponding to the user. For example, Jill Water.

13. Select "Email" Type. For example, To.

14. Click Add. The user will be added to the subscription.

To add user emails captured during runtime while creating the agreement instance:

15. Choose the attribute  in which you captured email addresses during agreement instance creation in the "Select Attributes" field. For example, "Created By"

Note: The Select Attributes dropdown will show all attributes with data types as User and Email.

16. Select "Email Type". For example, "Reply To". When users reply to the email notifications, it will be sent to these configured email addresses. 

Note: When users choose the "Reply All" option while replying to the email, the reply will be sent to all the recipients in To, Cc and the user emails configured with the Reply To email type .
 
17. Click "Add". The details will be added to the subscription with the selected properties.

18. Add more users as recipients to the subscription with other email types following the same process. For example, attribute "Customer Email" with email type as "CC".

19. Add a user with email type as "From".

The recipients will receive notifications from the user whose email address is set with the email type as From.

 
Notes
  • The sender email type From will, by default, be unavailable. 
  • The From email type is configured through the technical configuration. 
  • Users can not add more than one user with From email Type to the subscription. If the role/attribute with multiple users is configured with From email Type, system will pick any one user randomly. Therefore, it is recommended to use single user or user role/attribute that has single user associated with it.
 
20. Click "Next". The "Verify" page opens. 

21. Verify the details and click "Create". The subscription is created.

 

 

 

Related Topics: Agreement ManagementManaging Organization | Managing Users | Managing User Groups | Managing Security Groups | Application Settings | Currencies | Reasons | Deleting an Agreement | Search Sync | Legacy Upload