From ICIHelp8.2
Jump to: navigation, search
Line 78: Line 78:
  
 
On this tab, verify all the information you entered for the Subscription.
 
On this tab, verify all the information you entered for the Subscription.
<div class="image-green-border">'''Click'''&nbsp;''Save'' to create the Subscription. Notifications will be sent as and when the respective event occurs.</div> <div class="image-green-border">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.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:7.11-NotificationTemplatespage.png|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">'''Related Topics''': [[User_Administration|User_Administration]] | [[Create_Notification_Categories|Creating Notification Categories]] | [[Create_a_Notification_Rule|Create_a_Notification_Rule]]</div> </div>
+
<div class="image-green-border">'''Click'''&nbsp;''Save'' to create the Subscription. Notifications will be sent as and when the respective event occurs.</div> <div class="image-green-border">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.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:7.11-NotificationTemplatespage.png|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">&nbsp;</div>
 +
== Configuring the associated document type for attachment&nbsp; ==
 +
 
 +
ICI users can share the main agreement document as part of various email notifications that gettriggered for the agreement.In addition to the main agreement document, users can now send associated documents as part of various email notifications that get triggered for the agreement from time to time. Access tothese documents can be controlled based on the type of document – internal, external, or&nbsp;restricted. For example, some documents may only be shared with internal users, some may beshared with internal and external users, whereas some may not be shared with anyone.
 +
 
 +
Now,&nbsp;
 +
 
 +
*Administrators can tag the associated document contract type in the email notification&nbsp;template for agreements, assignment agreements, termination agreements, and<br/> amendments.&nbsp;
 +
*Users can define:&nbsp;
 +
**The type of notification as internal or external.&nbsp;
 +
**The type of associated document instance as internal, external, or restricted. 
 +
*Based on the type of notification and type of tagged associated documents, attachments&nbsp;are added to the email notification
 +
 
 +
Users can configure the associated document to send in an email as an attachment with the base agreement by adding the global seeded attribute Type of Associated Document while creating or editing an Association contract type.
 +
 
 +
To edit the Associated Document Contract Type:&nbsp;
 +
 
 +
1.&nbsp;'''Click''' ''Configuration'' > ''Contract Types'' on the ''Home'' page. The ''Contract Types'' index page opens.
 +
 
 +
2.&nbsp;'''Click''' the ''View Record'' icon corresponding to the ''Associated Document'' contract type you want to edit. For example, ICMAnnexure1. The contract Type ''Details'' page opens.
 +
 
 +
3.&nbsp;'''Click''' ''Edit''. The ''Edit Contract Type'' page opens.
 +
 
 +
4.&nbsp;'''Clik&nbsp;'''''Next.&nbsp;''The&nbsp;''Attributes&nbsp;''page opens.&nbsp;
 +
 
 +
5.&nbsp;'''Select''' and add the attribute ''Type of Associated Document'' from the ''Available Attributes'' pane to the ''Select Attributes'' pane using the action arrows.
 +
 
 +
6.&nbsp;'''Click&nbsp;'''''Save.&nbsp;''The&nbsp;''Attribute saved successfully&nbsp;''message is displayed.&nbsp;
 +
 
 +
7.&nbsp;'''Click''' ''Next''. The ''Associations'' tab opens.<br/> 8.&nbsp;'''Enter''' the details on ''Association'', ''Display Preference'' and ''Team'' tabs.<br/> 9.&nbsp;'''Verify''' the details and '''click''' ''Update''. The ''Associated Document'' contract type is updated with the Type of Associated Document attribute.<br/> &nbsp;
 +
 
 +
== Configuring a notification subscription for association attachment&nbsp; ==
 +
 
 +
Users can define and set the notification mode and tag the associated document as attachment for the notifications email while creating or editing the Notification Subscriptions.
 +
 
 +
To configure Notifications:&nbsp;
 +
 
 +
1.&nbsp;'''Click''' ''User Administration'' > ''Notification Settings'' > ''Subscription'' on the ''Home'' page. The ''Notification Templates'' page opens.
 +
 
 +
2. '''Click''' ''Create Subscription''. The ''Create Subscription'' page opens.
 +
 
 +
3.&nbsp;'''Enter''' the Template Name. For example, Associated Document Attachment.<br/> 4.&nbsp;'''Enter''' the Entity Name for which you want to send notifications. For example, Master Services Agreement.<br/> 5.&nbsp;'''Enter''' the Event Name to trigger notifications. For example, Agreement Approved.<br/> 6.&nbsp;'''Enter''' the Category Name. For example, Agreement Notifications.<br/> 7.&nbsp;'''Enter''' the Notification Mode. For example, '''select''' ''External''.
 +
 
 +
The available options are:&nbsp;
 +
 
 +
*Internal: select to send notifications to internal users.
 +
*External: select to send notifications to external users.&nbsp;
 +
 
 +
8. '''Click''' ''Next''. The ''Template'' page opens.<br/> 9.&nbsp;'''Tag''' the ''AssociatedDocAttachement'' attribute for associated documents in the Template. This enables the attachment of Associated Documents in notifications.
 +
 
 +
'''Note''':&nbsp;The tag ''AssociatedDocAttachement'' supports attachments of associated documents in all ICI supported file formats.
 +
 
 +
'''Note''':&nbsp;The associated document tag ''AssociatedDocAttachement'' will only be available for selection and tagging in a Notification Template if enabled through technical configuration for an instance.
 +
 
 +
10.&nbsp;'''Click''' ''Add Sender/Recipients''. The ''Add Sender/Recipients'' window opens.
 +
 
 +
11. '''Select''' ''Attributes'' to send the notification to users added during the creation of an agreement instance. For example, External Signatory.
 +
 
 +
Configurators can also search and add users through&nbsp;''Search User&nbsp;''field.&nbsp;
 +
 
 +
12.&nbsp;'''Select&nbsp;'''''Action User&nbsp;''checkbox.&nbsp;
 +
 
 +
13.&nbsp;'''Click''' ''Add''. The user is added to the Subscription.&nbsp;
 +
 
 +
14.&nbsp;'''Click''' ''Next''. The ''Verify'' page opens.<br/> 15.&nbsp;'''Verify''' the details and '''click''' ''Save''. The Subscription is created.
 +
 
 +
The configured notification template is displayed on the ''Notification Templates'' page.
 +
 
 +
== Defining a type of Association while creating Association instance ==
 +
 
 +
Users can define the attachment type for associated documents by setting the value in the Type of Associated Document attribute while creating a new association, editing the existing association from the Agreement Details page as well as from Association Management menu tile on the Home page.
 +
 
 +
To set the type of association while creating new association instance:&nbsp;
 +
 
 +
1. '''Click''' ''Agreement Management'' > ''Agreements'' on the ''Home'' page.<br/> 2.&nbsp;'''Click''' the ''View Record'' icon corresponding to the agreement you want to open. For example, ''Master Services Agreement''. The agreement ''Details'' page opens.<br/> 3.&nbsp;'''Expand''' the Associations tab in the left navigation pane.<br/> 4.&nbsp;'''Click''' the ''Create Association'' icon corresponding to the association you want to add to the agreement. For example, Annexure 1. The Create Association page opens.
 +
 
 +
5. '''Select''' the file and upload in the ''Select File'' field. For example, Annexure 1 data.xlsx.<br/> 6.&nbsp;'''Select''' the value in the Type of ''Associated Document'' attribute. For example, select External.<br/> &nbsp;
 +
 
 +
The available options are :&nbsp;
 +
 
 +
*Internal: select to send notifications to internal users.
 +
*External: select to send notifications to external users.
 +
*Restricted: select to restrict the attachment of an associated document in notifications.
 +
 
 +
When Notification Mode is set as Internal in the Notification Subscription, Associated Documents will be attached in the notification email if the Type of Associated Document set as Internal or External and will not be attached if set as Restricted.&nbsp;<br/> When Notification Mode is set as External in the Notification Subscription, Associated Documents will be attached in the notification email only when the Type of Associated Document is also set as External and will not be attached if set as Internal or Restricted.<br/> &nbsp;
 +
 
 +
7.&nbsp;&nbsp;'''Enter''' other details.<br/> 8.&nbsp;'''Click''' ''Next''.&nbsp;<br/> 9.&nbsp;Complete the creation of Association following the standard ICI workflow.<br/> 10. '''Publish''' and '''Approve''' the Agreement.<br/> &nbsp;
 +
 
 +
The notification will be sent with the attached associated documents to the intended users as per the configured notification subscription for the agreement.<br/> &nbsp;
 +
<div class="image-green-border">'''Related Topics''': [[User_Administration|User_Administration]] | [[Create_Notification_Categories|Creating Notification Categories]] | [[Create_a_Notification_Rule|Create_a_Notification_Rule]]</div> </div>

Revision as of 12:22, 31 January 2021

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 to be sent.
  • Define the event for which it will be sent.

To create a subscription:

1. Click the Notification Settings tile on the User Administration page. The All Notifications Category page opens. All the existing notification categories are displayed on this page such as Agreement Notifications, Clause Notifications. Each notification category groups various notification templates of various events that fit into the respective category. You can also edit or delete the displayed categories.

2. Click the Subscription tile. The Subscriptions page opens. On this page you can see a list of all the existing Notification Templates and their details such as Template Name, Entity Name, Event and Category Name etc. You can also edit, delete, create, enable or disable a subscription using the respective buttons.

Subscriptions page

3. Click the Create Subscription button. 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 the language preferences are set 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

Fill in 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.

 

 

 


Create Subscription
 

Template

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

  • Type appropriate subject in the Template Subject box. 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 open.
Templates tab
 

Recipient

To add recipients:

1. Click the RTENOTITLE Add Recipients icon. The Add Recipients window opens.

2. Select User Roles such as Approver, Internal Reviewer etc.

3. Select User Attributes such as Created By, Modified by etc.

4. Check the Action User box if necessary.

5. Select a desired user from the displayed list or search a user using the search bar.

6. Click Add. The user name and role get added in the list.

Recipients tab

 

Note: You can tag users in the Notifications Template using their usernames or Email IDs.

 7. Click Next. The Verify tab opens.

 

Verify

On this tab, verify all the information you entered for the Subscription.

Click Save to create the Subscription. Notifications will be sent as and when the respective event occurs.
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.
 
 
RTENOTITLE
 
 

Configuring the associated document type for attachment 

ICI users can share the main agreement document as part of various email notifications that gettriggered for the agreement.In addition to the main agreement document, users can now send associated documents as part of various email notifications that get triggered for the agreement from time to time. Access tothese documents can be controlled based on the type of document – internal, external, or restricted. For example, some documents may only be shared with internal users, some may beshared with internal and external users, whereas some may not be shared with anyone.

Now, 

  • Administrators can tag the associated document contract type in the email notification template for agreements, assignment agreements, termination agreements, and
    amendments. 
  • Users can define: 
    • The type of notification as internal or external. 
    • The type of associated document instance as internal, external, or restricted.
  • Based on the type of notification and type of tagged associated documents, attachments are added to the email notification

Users can configure the associated document to send in an email as an attachment with the base agreement by adding the global seeded attribute Type of Associated Document while creating or editing an Association contract type.

To edit the Associated Document Contract Type: 

1. Click Configuration > Contract Types on the Home page. The Contract Types index page opens.

2. Click the View Record icon corresponding to the Associated Document contract type you want to edit. For example, ICMAnnexure1. The contract Type Details page opens.

3. Click Edit. The Edit Contract Type page opens.

4. Clik Next. The Attributes page opens. 

5. Select and add the attribute Type of Associated Document from the Available Attributes pane to the Select Attributes pane using the action arrows.

6. Click Save. The Attribute saved successfully message is displayed. 

7. Click Next. The Associations tab opens.
8. Enter the details on Association, Display Preference and Team tabs.
9. Verify the details and click Update. The Associated Document contract type is updated with the Type of Associated Document attribute.
 

Configuring a notification subscription for association attachment 

Users can define and set the notification mode and tag the associated document as attachment for the notifications email while creating or editing the Notification Subscriptions.

To configure Notifications: 

1. Click User Administration > Notification Settings > Subscription on the Home page. The Notification Templates page opens.

2. Click Create Subscription. The Create Subscription page opens.

3. Enter the Template Name. For example, Associated Document Attachment.
4. Enter the Entity Name for which you want to send notifications. For example, Master Services Agreement.
5. Enter the Event Name to trigger notifications. For example, Agreement Approved.
6. Enter the Category Name. For example, Agreement Notifications.
7. Enter the Notification Mode. For example, select External.

The available options are: 

  • Internal: select to send notifications to internal users.
  • External: select to send notifications to external users. 

8. Click Next. The Template page opens.
9. Tag the AssociatedDocAttachement attribute for associated documents in the Template. This enables the attachment of Associated Documents in notifications.

Note: The tag AssociatedDocAttachement supports attachments of associated documents in all ICI supported file formats.

Note: The associated document tag AssociatedDocAttachement will only be available for selection and tagging in a Notification Template if enabled through technical configuration for an instance.

10. Click Add Sender/Recipients. The Add Sender/Recipients window opens.

11. Select Attributes to send the notification to users added during the creation of an agreement instance. For example, External Signatory.

Configurators can also search and add users through Search User field. 

12. Select Action User checkbox. 

13. Click Add. The user is added to the Subscription. 

14. Click Next. The Verify page opens.
15. Verify the details and click Save. The Subscription is created.

The configured notification template is displayed on the Notification Templates page.

Defining a type of Association while creating Association instance

Users can define the attachment type for associated documents by setting the value in the Type of Associated Document attribute while creating a new association, editing the existing association from the Agreement Details page as well as from Association Management menu tile on the Home page.

To set the type of association while creating new association instance: 

1. Click Agreement Management > Agreements on the Home page.
2. Click the View Record icon corresponding to the agreement you want to open. For example, Master Services Agreement. The agreement Details page opens.
3. Expand the Associations tab in the left navigation pane.
4. Click the Create Association icon corresponding to the association you want to add to the agreement. For example, Annexure 1. The Create Association page opens.

5. Select the file and upload in the Select File field. For example, Annexure 1 data.xlsx.
6. Select the value in the Type of Associated Document attribute. For example, select External.
 

The available options are : 

  • Internal: select to send notifications to internal users.
  • External: select to send notifications to external users.
  • Restricted: select to restrict the attachment of an associated document in notifications.

When Notification Mode is set as Internal in the Notification Subscription, Associated Documents will be attached in the notification email if the Type of Associated Document set as Internal or External and will not be attached if set as Restricted. 
When Notification Mode is set as External in the Notification Subscription, Associated Documents will be attached in the notification email only when the Type of Associated Document is also set as External and will not be attached if set as Internal or Restricted.
 

7.  Enter other details.
8. Click Next
9. Complete the creation of Association following the standard ICI workflow.
10. Publish and Approve the Agreement.
 

The notification will be sent with the attached associated documents to the intended users as per the configured notification subscription for the agreement.