From ICIHelp7.15
Jump to: navigation, search
 
(42 intermediate revisions by 4 users not shown)
Line 1: Line 1:
  
= Create a Subscription =
+
= Creating a Subscription =
  
 +
 
  
Using Subscriptions, you can create user notifications and assign appropriate recipients.<br/> '''While creating subscription:'''
+
Using Subscriptions, you can create user notifications and assign appropriate recipients. When&nbsp;creating a subscription:
  
#You have to define the entity or a task for which the notification to be sent.  
+
*Define the entity or a task for which the notification to be sent.  
#You have to define the event at which it will be sent.  
+
*Define the event for which it will be sent.  
<div><div style="float:left;width:68%;">
+
<div><div style="float:left;">
'''To create a subscription:'''
+
To create a subscription:
  
#On the ''Admin'' page, '''click''' the ''Notification Settings'' tile. The ''All Notifications Category'' page appears.  
+
'''1. Click '''the ''Notification Settings'' tile on the ''User Administration'' page. The ''All Notifications Category'' page opens.&nbsp;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.
  
[[File:Admin tiles.jpeg|RTENOTITLE]]
+
2.'''&nbsp;Click''' the ''Subscription'' tile. The ''Subscriptions'' page opens.&nbsp;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.
 +
<div class="image-green-border">[[File:Creating Subscription Subscriptions page 7.8.png|1000px|Subscriptions page]]</div>
 +
3.&nbsp;'''Click '''the&nbsp;''Create Subscription ''button''. ''The&nbsp;''Create Subscription&nbsp;''page opens.&nbsp;&nbsp;
  
[[File:Sub.jpeg|RTENOTITLE]]
+
There are four tabs on this page:
<ol start="2">
+
<ul style="margin-left: 40px;">
<li>'''Click''' the ''Subscription'' tile. The ''Subscriptions'' page appears.</li>
+
<li>Details</li>
</ol>
+
<li>Template</li>
 +
<li>Recipient</li>
 +
<li>Verify</li>
 +
</ul>
 +
<div class="note-box">'''Note''':&nbsp;When creating or editing a subscription, the Administrator&nbsp;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&nbsp;configuration team to add it to the database through scripts.&nbsp;</div>  
 +
&nbsp;
  
[[File:Create Subscription 1.png|RTENOTITLE]]
+
'''Details'''
<ol start="3">
+
<li>'''Click&nbsp;'''''Create Subscription. ''The&nbsp;''Create Subscription&nbsp;''page opens.&nbsp;&nbsp;</li>
+
</ol>
+
 
+
Enter the information for the following in the page.
+
 
+
*Details
+
*Template
+
*Recipient
+
*Verify
+
  
Let us go through each of the tabs in detail.
+
Fill in the mandatory fields:
 +
<ul style="margin-left: 40px;">
 +
<li>'''Type'''&nbsp;an appropriate Template Name for the subscription.</li>
 +
<li>'''Select'''&nbsp;an Entity Name such as ''Agreement''.</li>
 +
<li>'''Select'''&nbsp;an Event Name, such as ''Agreement Approved.''</li>
 +
<li>'''Select''' a Category Name such as ''Agreement Notifications''.</li>
 +
<li>'''Click'''&nbsp;''Next''. The&nbsp;''Template''&nbsp;tab opens.</li>
 +
</ul>
 
</div>  
 
</div>  
 
&nbsp;
 
&nbsp;
<div style="clear:both">&nbsp;</div>
 
'''Details'''
 
  
:a. In the ''Template Name'' box, '''type''' an appropriate template name for the subscription.
+
&nbsp;
 
+
:b. In the ''Entity Name'' list, '''click''' the appropriate entity name.
+
:c. In the ''Event Name'' list, '''click''' the appropriate event name.
+
 
+
:d. In the ''Category Name'' list, '''click''' the appropriate category name.
+
 
+
:e. '''Click''' ''Next''. The ''Template'' tab appears.
+
 
+
[[File:Create Subscription 2 Details.png|RTENOTITLE]]
+
  
 +
&nbsp;
 +
<div class="image-green-border"><br/> [[File:Creating Subscription Create Subscription page 7.8.png|Create Subscription]]</div> <div class="image-green-border">&nbsp;</div>
 
'''Template'''
 
'''Template'''
  
On the ''Template'' tab, define a template for user notifications and email notifications.
+
On the ''Template'' tab, define a template for user notifications and email notifications:
 
+
<ul style="margin-left: 40px;">
:a. In the ''Template Subject'' box, '''type''' the relevant entity name for the template.  
+
<li>'''Type '''appropriate subject in the ''Template Subject''&nbsp;box. All the notification emails using this template would have this content in the subject line.</li>
 
+
<li>'''Type''' an appropriate message in the T''emplate Body.'' '''Click''' the ''Attributes'' list to tag respective attributes in the template body. You can also format the selected attributes by using menu options.</li>
:b. In the ''Template Body'', '''type''' an appropriate message text. '''Click''' the ''Attributes'' list to tag respective attributes in the template body. You can also format the selected attributes by using menu options.  
+
<li>'''Click''' ''Next''. The ''Recipient'' tab open.</li>
 
+
</ul>
:c. '''Click''' ''Next''. The ''Recipient'' tab appears.  
+
<div class="image-green-border">[[File:Creating Subscription templates tab 7.8.png|1000px|Templates tab]]</div> <div class="image-green-border">&nbsp;</div>
 
+
[[File:Create Subscription 3 Template.png|RTENOTITLE]]
+
 
+
 
'''Recipient'''
 
'''Recipient'''
  
On the ''Recipient'' tab, add recipients as follows:
+
To add recipients:
  
:a. '''Click''' [[File:Add icon.jpeg|RTENOTITLE]] next to ''Add Recipients''.  
+
1. '''Click '''the [[File:Add icon.jpeg|RTENOTITLE]] ''Add Recipients ''icon. The ''Add Recipients'' window opens.
  
[[File:Add rec.jpeg|RTENOTITLE]]
+
2. '''Select'''&nbsp;''User Roles ''such as Approver, Internal Reviewer etc.
  
:b. In the ''Add Recipient'' dialogue box, '''select''' respective users.  
+
3. '''Select '''''User Attributes'' such as Created By, Modified by etc.
  
:c. In the ''Select Roles'' list, '''click''' the appropriate role.  
+
4. '''Check&nbsp;'''the ''Action User'' box if necessary.
  
:d. In the ''Select User Attributes'' list, '''click''' the appropriate attributes, and select the '''Action User''' box.  
+
5. '''Select '''a desired user from the displayed list or search a user using the search bar.
  
:e. '''Select''' a user from the user tiles. You can use scroll arrows [[File:400.jpeg|RTENOTITLE]] to browse through the user tiles.  
+
6.&nbsp;'''Click''' ''Add''. The user name and role get added in the list.
 +
<div class="image-green-border">[[File:Creating Subscription Add recipients 7.8.png|1000px|Recipients tab]]</div>
 +
&nbsp;
 +
<div class="note-box">'''Note''': You can tag users in the Notifications Template using their usernames or Email IDs.</div>
 +
&nbsp;7.&nbsp;'''Click''' ''Next''. The ''Verify'' tab opens.
  
:f. '''Click''' ''Add''. The user name and role appear as a tile.
+
&nbsp;
 
+
:g. '''Click''' ''Next''. The '''Verify''' tab appears.
+
  
 
'''Verify'''
 
'''Verify'''
  
On the '''Verify''' tab, verify all the information 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>
[[File:Create Subscription 5 Verify.png|RTENOTITLE]]
+
 
+
Click '''Save''' to create a '''Subscription'''.<br/> Once a subscription is created, notifications will be sent as and when the respective event occurs.
+
 
+
'''Related Topics:'''<br/> [[Edit_a_Subscription|Edit a Subscription]]
+
 
+
&nbsp;
+
 
+
&nbsp;
+

Latest revision as of 10:10, 18 November 2020

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