Template Management[edit]


= Template Management =

Template is a framework that represents a standard layout for an Agreement. The&nbsp;''Template Management'' tile enables you to manage all aspects of creating and editing Templates from a single page. From here, you can:

*View and manage all your Templates on Templates page. 
*Create and upload a&nbsp;Template&nbsp;through Create Template page. 
*Create Template through Word Add-ins. 

== Templates ==

Navigate to the&nbsp;''Templates''&nbsp;page by clicking on the&nbsp;''Template Management''&nbsp;tile. This page displays all the Templates&nbsp;that you are associated with- you may have created a Template or are a&nbsp;part of the team working on it. This page displays the most current version of a Template regardless of its status.
<div class="image-green-border">[[File:Templates page 1.png|RTENOTITLE]]</div> 
From this page you can:

*search templates in a variety of ways. You can search templates from this page or use the Advanced Search. 
*view details of a template&nbsp;by clicking on the&nbsp;''View Record&nbsp;[[File:Eyeball.png|RTENOTITLE]]''icon. The details are displayed in the Template_Details_Page. 
*view the template in word document format by clicking on the ''View Document[[File:View Document Icon.PNG|RTENOTITLE]]''icon. 

== Template Access Management ==

Template Access Management is now enhanced and is available through a technical configuration. When turned On, the access control for Templates is driven by the Organization Unit (OU) or the Team.&nbsp;

OU can be configured in 2 ways:

*Template access is dependent on the highest level of the OU and since everyone belongs to the OU so they have access by default, if they are part of the team. 
*Through a technical configuration, you now have the ability to change the access based on the OU of the user who is creating the Template. For example, if user John Doe is part of the Sales OU and the team, then Templates created by John Doe can be accessed by all users in the Sales OU and those belonging to the Template team. 

Additionally, you can add members to the Template team through Event Rules, thus saving time of manually adding users to the Team. The support for the Observer role is extended to the Template Library as well through Role Action Mapping.&nbsp;
<div class="note-box">Note: This feature is applicable to ICM Web UI and the .JS version of Word Add-in.&nbsp;</div> 
== Searching Templates ==

You can search for templates either from&nbsp;advanced search&nbsp;page or from Templates Page&nbsp;to:

*view its details 
*check the status 
*edit it 

You can find a specific template you are looking for from the ''Templates'' page&nbsp;using one of these 3 methods:

*Category Search 
*Saved Searches 
*Searches pinned as Favorites 
<div class="image-green-border">[[File:Template Management search template 7.8.PNG|RTENOTITLE]]</div> 
=== Category Search ===

Follow these steps to search for templates&nbsp;using the Category drop down:

1.&nbsp;'''Click''' the&nbsp;''Template'''&nbsp;'''Management'' tile on My Dashboard. This opens the Templates Page&nbsp;displaying all the existing Templates.

2. Use the ''Categories'' drop down to narrow down the templates&nbsp;and find the exact one you are looking for. For example, search by status, created by or the status changed,&nbsp;date, among many other options. This displays all the options that match the selected category.

3. Select the desired criteria by marking the&nbsp;boxes next to that option. Only the templates matching this specified criteria are displayed.

4. Narrow your search further by typing specific keywords in the ''Custom Keyword'' field and then '''click''' ''Apply''. You can use Boolean operators such as AND/OR or search by wildcards to filter the results. For example:&nbsp;

*APP*: displays agreements only in the APPROVED and WAITING FOR APPROVAL states 
*?PP*&nbsp;: displays agreements only in the APPROVED and WAITING FOR APPROVAL states 
*APP*:&nbsp;OR DRA* - displays agreements only in the APPROVED, WAITING FOR APPROVAL and DRAFT states &nbsp; &nbsp;&nbsp; 

5. You can also type free text in the ''Refine Search Here...'' search box. A list of relevant agreements are displayed.

=== Saved Searches ===

Follow these steps to use your saved searches:

1.&nbsp;'''Click''' the ''Template Management&nbsp;''tile on My Dashboard. This opens the Templates page displaying all the existing templates.

2.&nbsp;'''Click''' the ''Saved Searches'' drop down and select the desired saved search. Refer to Using Advanced Search for details on saving a search. This displays the templates matching the criteria defined in the saved search.

Refer to Saved Searches for details on saving a search.

=== Searches pinned as Favorites ===

Follow these steps to search using a favorite search:

1.&nbsp;'''Click''' the ''Template Management'' tile on My Dashboard. This opens the Templates page displaying all the existing templates.

2.&nbsp;'''Click''' one of the searches defined as favorite, just below the feature tiles. Refer to Using Advanced Search for details on adding searches as favorites. This displays the templates&nbsp;matching the criteria defined in favorite search.

&nbsp;

== Creating a Template in ICM ==

To create a Template in ICM:

1.&nbsp;'''Click'''&nbsp;the&nbsp;''Template Management''&nbsp;tile on the Dashboard. The Templates page opens.

2. '''Click '''the&nbsp;''Create Template''&nbsp;tile.&nbsp;The&nbsp;''Create Template'' page. Type the required details in the following sections.

*Details 
*Template Variable&nbsp; 
*Team 
*Verify 

'''Note''': (*) denotes a mandatory field. ICM displays an error message if a mandatory field is left empty.

'''1. Details'''

The&nbsp;''Details''&nbsp;section&nbsp;consists of some mandatory fields, while rest of the sections are optional.

Enter the basic details in the following fields:

*Contract Type Name: '''Select''' a ''Contract type'' from the drop-down list for which you want to create a Template. 
*Name: '''Type''' an appropriate name for the Template. 
*Template Code: The Template Code is auto-generated. 
*Template Language: '''Select''' the language for the Template. 
*Primary Template: '''Select''' ''Yes'' if this is the Primary Template. '''Select''' ''No'' if it is not a Primary Template.&nbsp;This feature helps define the primary Template in a specific language, and you can define secondary Templates in other languages if needed. 
*Linked Primary Template: This section appears when you '''select''' ''No'' for Primary Template option.&nbsp;'''Select''' a ''Primary Template'' from the drop-down menu to link this Template to it. 
*Effective From: '''Type''' or '''select''' the ''Effective From'' date using the calendar window. 
*Effective To: '''Type''' or '''select''' the ''Effective To'' date using the calendar window. 
*Description: '''Type''' a description for the Template. 
*Version Comments: '''Type'''&nbsp;relevant comments for this version, such as what changes were made and why, who they were approved by or any other comments you may wish to add specific to this version. 
*File: '''Click''' ''Select File'' to upload a Template from your local folder. 

'''Click''' ''Next'' to go to the ''Template Variables'' tab.

'''2. Template Variable'''

Template Variables are the attributes that are part of the template.&nbsp;

On this tab you can eaither select the attributes from the Available Attributes section or Add new attributes.

To select the attributes from the already existing attributes:

1.&nbsp;'''&nbsp;Select '''a desired attribute from the Available Attributes section then '''click '''the&nbsp;[[File:Arrow 1.PNG|20px|Arrow 1.PNG]]&nbsp;icon.

2. The attribute&nbsp;is added to the ''Selected Attribute'' section.

3. '''Click '''the attribute that is added to the''Selected Attributes'' section. The details of that attribute are populated in the ''Edit Attribute'' section.

4. '''Edit '''the details of the attribute if required. For example, Display Name, Help Message etc.
<div class="image-green-border">[[File:Template Management Template Variables 7.8.PNG|RTENOTITLE]]</div> 
5. '''Define '''the attribute with the help of flags such as ''Is Default, Is Editable'' etc.

6. '''Click '''''Save. ''The Template Variable is added in the Template that you are creating.
<div class="image-green-border">[[File:Template Management attribute flags 7.8.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">7. '''Click '''''Next''. The ''Team ''tab opens.</div> 
'''3. Team&nbsp;'''

This section helps you in selecting different roles for your Template. You can add 3 roles which are:

*'''Approver'''&nbsp;: approves or rejects the Template after reviewing it. 
*'''Secondary Owner ''': works with the Primary owner or alone if the Primary owner is not available. Both these roles have the same privileges. 
*'''Contributor'''&nbsp;: can review the Template, but can’t make any changes or take action. Any comments related to it are sent to the Primary owner or Secondary owner. 

To add different roles:

*'''Click''' the ''Add''&nbsp;&nbsp;icon.&nbsp;This opens the&nbsp;''Add User''&nbsp;dialog box. 
*Select the role from the drop down, and the users for that specific role. 
*Selecting&nbsp;a role of an approver, displays a&nbsp;''step number''&nbsp;field. This step number is mandatory and controls the sequence of approvals if there are multiple approvers. The&nbsp;approval flows sequentially according to the step number. 
*'''Click'''&nbsp;''Add'''''. '''The users just added will be seen under Team. 

'''4. Verify'''

Here you can review and verify all the information for the Template before clicking on ''Create''. If you wish to edit anything, click&nbsp;''Previous''. Once created the template gets into Draft state.

After that click on ''Send for Approval''''',''' to send it further for approvals, or click ''Edit''&nbsp;if you want to update any field.

The Approver gets a notification about the Template, who can then review and approve it. Once approved, the Template is ready for use.

== Editing a Template in ICM ==

You can edit a template at any state, to make changes to effective date, team, and so on.&nbsp;However, when you edit an approved Template, you have to get it approved again.

To edit the existing Template:

1. On the&nbsp;''Template Management''&nbsp;page''', Click&nbsp;'''the&nbsp;''View Record''&nbsp;&nbsp;icon next to the Template. The Template Details Page opens providing the summary of the template.

&nbsp;

2.&nbsp;'''Click&nbsp;'''''Edit.&nbsp;''The&nbsp;''Edit Template&nbsp;''wizard with the&nbsp;''Details&nbsp;''tab appears.&nbsp;'''Edit&nbsp;'''the desired fields.&nbsp;

<br/> &nbsp;

You can edit the existing description or version comments information. You can upload a new template file or replace an existing template as well.

3.&nbsp;'''Click'''&nbsp;''Next''. The&nbsp;''Team''&nbsp;tab appears.Add or delete the team members, if required.

4.&nbsp;'''Click&nbsp;'''''Next.&nbsp;''The&nbsp;''Verify&nbsp;''tab appears.&nbsp;Verify the changes made to the Template.

&nbsp;

5.&nbsp;'''Click&nbsp;'''''Save&nbsp;''to save the changes made to the Template.&nbsp;

&nbsp;



6. Choose one of the following:

*'''Click'''&nbsp;''Previous''&nbsp;to go back and make changes to the information that you have entered. 
*'''Click'''&nbsp;''Update''&nbsp;to update the Template. 

The details of the updated Templates are displayed. Preview of the Template appears on the right side of the page.

Choose from the following options that appear below the contract summary and details:

*Download Document:&nbsp;'''Click'''&nbsp;to save the Template to your local computer. 
*Edit:&nbsp;'''Click'''&nbsp;to make changes to the Template. 
*Send For Approval:&nbsp;'''Click'''&nbsp;to send the Template to approver. 

'''Note''': The options that are displayed vary according to the type of Template and privileges assigned to your user id.&nbsp;

== Tagging Attributes inside another Attribute value in Templates ==

You can authorize&nbsp;users to tag an Attribute inside another choice or multi-select Attribute, so that the same Attribute tag can be used within the Agreement or Template.&nbsp;

<br/> In ICM, you can:

*Tag&nbsp;an Attribute inside the values of choice and multi-select type of Attributes 
*Tag&nbsp;Attributes at the Template Variable, Contract Type and Attribute Library levels 
*Search&nbsp;for other Attribute types that can be nested or tagged and have been configured for the selected Contract Type 
*Append&nbsp;prefix and postfix text to the tagged Attribute 
*Tag&nbsp;for nested Attributes using Bulk Upload and Excel Add-in. 
*Tag&nbsp;for nested attributes is resolved during Document Assembly using Word Add-in 
*Reverse sync&nbsp;which is driven by the same flag that is currently used for tagged Attributes 
*Have only one level nesting<br/> &nbsp; 

<u>'''Remember:'''</u>

*In ICM, the internal name ($abc) for the choice Attribute will be displayed and this value will not get resolved. 
*When this field is used in the Agreement/ Template as a tagged Attribute, the tagging is resolved during document assembly and the mapped variable is displayed in the document. The document will always display the actual value of the referred Attribute.&nbsp; 
*If the referred Attribute has no available value and it is selected from the choice list, then no value will be displayed in the document during document assembly. 
*If the referred Attribute is removed from the Contract Type, a notification message is displayed stating that the Attribute may be tagged somewhere else. 

&nbsp;

'''Relatged Topics:&nbsp;'''[[Create_a_Template_in_ICM_Word_Add-in|Create a Template in ICM Word Add-in]]&nbsp;|&nbsp;[[Create_a_Template_Selection_Rule|Create a Template Selection Rule]]&nbsp;|&nbsp;