From ICIHelp8.2
Jump to: navigation, search
 
(160 intermediate revisions by 5 users not shown)
Line 1: Line 1:
  
 
= Salesforce =
 
= Salesforce =
 
== Configuration for allowing user to be redirected to ICM Details page in Salesforce ==
 
 
When creating Contracts, Contract Requests and Amendments from Salesforce, Administrators can now configure whether the users should be redirected to the ICM Contract details page or the Salesforce Record page from where creation process was initiated. This can be configured by selecting the Allow Redirect checkbox on the ICM Endpoint Configuration page. By default, the checkbox is unchecked. When checked, the user is redirected to the Salesforce Record page, else to the ICM Contract detail page.
 
  
 
== Purpose ==
 
== Purpose ==
  
The purpose of this guide is to document the process of:
+
The purpose of this Wiki is to document the process of:
  
*Configuring ICM in Salesforce.  
+
*Configuring ICI in Salesforce.  
*Performing Salesforce related configuration in ICM for mapping data entities and saved searches.  
+
*Performing Salesforce related configuration in ICI for mapping data entities and saved searches.  
  
The guide also describes the process of using the ICM Salesforce connector for standard scenarios.
+
It also describes the process of using the Icertis Experience for Salesforce with the standard scenarios.
  
 
The document is primarily intended for:
 
The document is primarily intended for:
  
*Administrator users who configure Icertis Salesforce Connector on Salesforce.com.  
+
*Administrator users who configure Icertis Experience for Salesforce on Salesforce.com.  
*ICM Administrator Users who work on ICM Side Configuration.  
+
*ICI Administrator Users who work on ICI Side Configuration.  
 
*Other users who work with Agreements.  
 
*Other users who work with Agreements.  
  
 
'''Prerequisites'''
 
'''Prerequisites'''
  
*The user must have an account on Salesforce and ICM.  
+
*The user must have an account on Salesforce and ICI.  
 
*Icertis CLM must be installed on Salesforce.com from Salesforce AppExchange. It is compatible with Group, Professional, Enterprise, Unlimited, Force.com Developer and Performance Editions.  
 
*Icertis CLM must be installed on Salesforce.com from Salesforce AppExchange. It is compatible with Group, Professional, Enterprise, Unlimited, Force.com Developer and Performance Editions.  
*The user must have admin privileges for ICM and Salesforce in case the user is configuring ICM on Salesforce.   
+
*The user must have admin privileges for ICI and Salesforce in case the user is configuring ICI on Salesforce.   
  
== Overview of ICM Salesforce Connector ==
+
== Overview of Icertis Experience for Salesforce  ==
  
ICM Salesforce Connector is a native Salesforce application that allows you to access the full suite of ICM functionality from Salesforce, including the following capabilities:
+
Icertis Experience for Salesforce is a native Salesforce application that allows you to access the full suite of ICI functionality from Salesforce, including the following capabilities:
  
 
*Manage end-to-end contract lifecycle from the familiar Salesforce platform.  
 
*Manage end-to-end contract lifecycle from the familiar Salesforce platform.  
*Create Contract Requests with pre-populated data from Salesforce objects.  
+
*Create and edit Contract Requests with pre-populated data from Salesforce objects.  
 
*Track contract progress and status updates within Salesforce.  
 
*Track contract progress and status updates within Salesforce.  
 
*View contract notifications as part of chatter feed messages.  
 
*View contract notifications as part of chatter feed messages.  
*Automatically transfer and synchronize data between Salesforce objects and ICM.  
+
*Execute actions like Lock/Unlock and Hold/Unhold on Salesforce agreements and contract requests.
*Map Salesforce objects (standard and custom) with ICM entities.  
+
*Access and view “Opportunity”, “View Quote”, and “View Account” pages.
<div class="image-green-border">[[File:Overview of ICM Salesforce.PNG|RTENOTITLE]]</div>  
+
*See and conduct Advanced searches within Salesforce iframe.
ICM and Salesforce integration is required to port data from ICM to Salesforce. This integration avoids the need for re-entering the data manually in Salesforce which you have already created in ICM.&nbsp;
+
*Automatically transfer and synchronize data between Salesforce objects and ICI.  
 +
*Map Salesforce objects (standard and custom) with ICI entities.  
 +
<div class="image-green-border">[[File:Salesforce1.png|820px|Salesforce1.png]]</div>  
 +
ICI and Salesforce integration is required to port data from ICI to Salesforce. This integration avoids the need for re-entering the data manually in Salesforce which you have already created in ICI.&nbsp;
  
To use ICM from within Salesforce:
+
To use ICI from within Salesforce:
  
*The ICM sections must be embedded in the Salesforce pages.  
+
*The ICI sections must be embedded in the Salesforce pages.  
*After logging on to Salesforce, select ICM in the top right corner of your Salesforce page to use ICM through Salesforce.  
+
*After logging on to Salesforce, select ICI in the top navigation bar&nbsp; of the Salesforce page to use ICI through Salesforce.  
  
ICM Salesforce contains the following key concepts:
+
Icertis Experience for&nbsp;Salesforce has the following key concepts:
  
 
*''Account'' is a label for business. It is a company or a business entity, you might already be working with, or one that you hope to work with. In simple words, an Account is an actual business or company.  
 
*''Account'' is a label for business. It is a company or a business entity, you might already be working with, or one that you hope to work with. In simple words, an Account is an actual business or company.  
<div class="image-green-border">[[File:Overview of ICM Salesforce2.PNG|RTENOTITLE]]</div>  
+
<div class="image-green-border">[[File:Salesforce59.PNG|720px|Salesforce59.PNG]]</div>  
 
*''Opportunity'' is a pending deal with a monetary value associated with it. It helps to track the pending deals and sales.  
 
*''Opportunity'' is a pending deal with a monetary value associated with it. It helps to track the pending deals and sales.  
<div class="image-green-border">[[File:Overview of ICM Salesforce3.PNG|RTENOTITLE]]</div>  
+
<div class="image-green-border">[[File:Salesforce60.PNG|720px|Salesforce60.PNG]]</div>  
 
*''Quote'' is the data showing the proposed prices for the products or services. Quotes can be created by using the data that is saved in the Opportunities and shared with the prospective customers. Every opportunity can have multiple associated quotes linked to it.  
 
*''Quote'' is the data showing the proposed prices for the products or services. Quotes can be created by using the data that is saved in the Opportunities and shared with the prospective customers. Every opportunity can have multiple associated quotes linked to it.  
<div class="image-green-border">[[File:Overview of ICM Salesforce4.PNG|RTENOTITLE]]</div>  
+
<div class="image-green-border">[[File:Salesforce61.PNG|720px|Salesforce61.PNG]]</div>  
After integrating ICM with Salesforce, you can do the following contract management tasks in Salesforce:
+
After integrating ICI with Salesforce, you can do the following contract management tasks in Salesforce:
  
 
*Create and edit a Contract Request from an existing Account.  
 
*Create and edit a Contract Request from an existing Account.  
Line 61: Line 60:
 
*Create and edit a Contract from an existing Opportunity.  
 
*Create and edit a Contract from an existing Opportunity.  
 
*Create and edit a Contract from an existing Quote.  
 
*Create and edit a Contract from an existing Quote.  
 +
 +
&nbsp;
  
 
== Salesforce Side Configuration ==
 
== Salesforce Side Configuration ==
Line 67: Line 68:
  
 
*You must have a Salesforce account.&nbsp;  
 
*You must have a Salesforce account.&nbsp;  
*You must have administrator privileges to install ICM in Salesforce.  
+
*You must have administrator privileges to install ICI in Salesforce.  
*You must have ICM administrator privileges to configure ICM in Salesforce.  
+
*You must have ICI administrator privileges to configure ICI in Salesforce.  
  
 
=== Compatibility ===
 
=== Compatibility ===
  
ICM is compatible with the following editions of Salesforce:
+
ICI is compatible with the following editions of Salesforce:
  
 
*Professional  
 
*Professional  
Line 82: Line 83:
 
For more information about the different editions of Salesforce, refer to:&nbsp;<br/> [https://help.salesforce.com/articleView?id=overview_edition.htm&type=0 https://help.salesforce.com/articleView?id=overview_edition.htm&type=0]&nbsp;
 
For more information about the different editions of Salesforce, refer to:&nbsp;<br/> [https://help.salesforce.com/articleView?id=overview_edition.htm&type=0 https://help.salesforce.com/articleView?id=overview_edition.htm&type=0]&nbsp;
  
=== Installing ICM in Salesforce ===
+
=== Installing ICI in Salesforce ===
  
To install ICM in Salesforce:
+
To install ICI in Salesforce:
  
1.&nbsp;Log on to Salesforce.<br/> 2.&nbsp;Open a new browser instance and go to Salesforce AppExchange to download the ICM application.
+
1.&nbsp;Log on to Salesforce.<br/> 2.&nbsp;Open a new browser instance and go to Salesforce AppExchange to download the ICI application.
<div class="image-green-border">[[File:Installing ICM in Salesforce.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">3.&nbsp;'''Click''' ''Get It'' Now. This opens a new screen having two options:</div>  
+
<div class="image-green-border">[[File:Installing ICM in Salesforce.PNG|720px|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">3.&nbsp;'''Click''' ''Get It'' Now. This opens a new screen having two options:</div>  
 
*Log in to AppExchange: '''Logon''' to AppExchange using your Salesforce credentials to proceed with the installation.  
 
*Log in to AppExchange: '''Logon''' to AppExchange using your Salesforce credentials to proceed with the installation.  
*I don’t have a login: '''Install''' ICM in Salesforce as a guest user.  
+
*I don’t have a login: '''Install''' ICI in Salesforce as a guest user.  
<div class="image-green-border">[[File:Installing ICM in Salesforce2.PNG|RTENOTITLE]]<br/> &nbsp;<br/> 4. '''Choose'''''Log into AppExchange''. This presents the following options:</div>  
+
<div class="image-green-border">[[File:Installing ICM in Salesforce2.PNG|720px|RTENOTITLE]]<br/> &nbsp;<br/> 4. '''Choose&nbsp;'''''Log into AppExchange''. This presents the following options:</div>  
 
*Install in production  
 
*Install in production  
 
*Install in Sandbox  
 
*Install in Sandbox  
<div class="image-green-border">[[File:Installing ICM in Salesforce3.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">5.&nbsp;'''Choose''' ''Install in production'' and select the Terms and Conditions checkbox.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Installing ICM in Salesforce4.PNG|RTENOTITLE]]<br/> &nbsp;<br/> 6. '''Choose '''one of the applicable options:</div>  
+
<div class="image-green-border">[[File:Installing ICM in Salesforce3.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">5.&nbsp;'''Choose''' ''Install in production'' and '''select''' the ''Terms and Conditions'' checkbox.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Installing ICM in Salesforce4.PNG|720px|RTENOTITLE]]<br/> &nbsp;<br/> 6. '''Choose '''one of the applicable options:</div>  
*Install for Admins only: install ICM for Salesforce Administrators who can install ICM in Salesforce.  
+
*Install for Admins only: install ICI for Salesforce Administrators who can install ICI in Salesforce.  
*Install for All Users: install ICM for all users of Salesforce.  
+
*Install for All Users: install ICI for all users of Salesforce.  
*Install for Specific Profiles: install ICM for specific profiles only.  
+
*Install for Specific Profiles: install ICI for specific profiles only.  
<div class="image-green-border">7. Perform Configuring ICM EndPoint.</div> <div class="image-green-border">&nbsp;</div>  
+
<div class="image-green-border">7. Perform Configuring ICI EndPoint.</div> <div class="image-green-border">&nbsp;</div>  
 
=== Creating and Managing the Canvas App ===
 
=== Creating and Managing the Canvas App ===
  
Line 104: Line 105:
 
Follow these steps to create a Canvas App:&nbsp;
 
Follow these steps to create a Canvas App:&nbsp;
  
1.&nbsp;In '''Salesforce''', under ''Setup'', '''search '''for ''Apps'' in the&nbsp;''Quick Find'' box and '''select''' Apps.
+
1. '''Click '''Setup icon > “Setup”.<br/> 2. '''Click '''“Platform Tools” > “Apps” > “App Manager”.&nbsp;
<div class="image-green-border">[[File:Creating and Managing the Canvas App.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">2.&nbsp;In the ''Connected Apps related'' list, '''click '''New.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Creating and Managing the Canvas App2.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">3.&nbsp;In the ''Connected App Name'' field, '''type '''the name of the Canvas App.<br/> 4. Accept the default API Name. This is the internal name of the Canvas App and you cannot change the name after saving it.<br/> 5. In the ''Contact Email'' field, '''type''' your valid email address.<br/> 6.&nbsp;In the ''Logo Image URL'' field, '''type''' the ''Logo URL'' that you want to provide.<br/> 7.&nbsp;In the ''Icon URL'' field, '''type''' the ''Icon URL'' that you want to provide.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Creating and Managing the Canvas App3.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">8.&nbsp;In the ''API'' (''Enable OAuth Settings'') section '''select '''the ''Enable OAuth Settings'' field.<br/> 9. In the ''Callback'' URL field, '''type''' your ''Callback'' ''URL''.&nbsp;<br/> 10. In the ''Selected OAuth Scopes'' field, '''select''' ''Full Access''.<br/> 11. In the ''Canvas App Settings'' section, '''select '''''Force.com Canvas''.<br/> 12. In the ''Canvas App URL'' field, '''type''' the application URL that you want to sync with Salesforce. This is the application URL, which is integrated with Salesforce.<br/> 13. In the ''Access Method'' field, '''select''' ''Signed Request'' (Post)<br/> 14. In the ''Locations'' field, '''select''' ''Visualforce'' Page.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Creating and Managing the Canvas App4.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">15.&nbsp;'''Click''' ''Save''.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">'''Managing the Canvas App'''</div>
+
<div class="image-green-border">[[File:Salesforce5.png|280px|Salesforce5.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">3.&nbsp;'''Click''' on “New Connected App”.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Salesforce6.png|720px|Salesforce6.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">4.&nbsp;In the ''Connected App Name'' field, '''type '''the name of the Canvas App.<br/> 5. Accept the default API Name. This is the internal name of the Canvas App and you cannot change the name after saving it.<br/> 6. In the ''Contact Email'' field, '''type''' your valid email address.<br/> 7.&nbsp;In the ''Logo Image URL'' field, '''type''' the ''Logo URL'' that you want to provide.<br/> 8.&nbsp;In the ''Icon URL'' field, '''type''' the ''Icon URL'' that you want to provide.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Salesforce7.png|720px|Salesforce7.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">9.&nbsp;In the ''API'' (''Enable OAuth Settings'') section '''select '''the ''Enable OAuth Settings'' field.<br/> 10. In the ''Callback'' URL field, '''type''' your ''Callback'' ''URL''.&nbsp;<br/> 11. In the ''Selected OAuth Scopes'' field, '''select''' ''Full Access''.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Salesforce8.png|720px|Salesforce8.png]]</div> <div class="image-green-border"><br/> 12. In the ''Canvas App Settings'' section, '''select '''''Canvas''.<br/> 13. In the ''Canvas App URL'' field, '''type''' the application URL that you want to sync with Salesforce. This is the application URL, which is integrated with Salesforce.<br/> 14. In the ''Access Method'' field, '''select''' ''Signed Request'' (Post)<br/> 15. In the ''Locations'' field, '''select''' ''Visualforce'' Page.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Salesforce9.png|720px|Salesforce9.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">16.&nbsp;'''Click''' ''Save''.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">'''Managing the Canvas App'''</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">To create a Canvas App:</div>  
1.&nbsp;In ''Salesforce'', under ''Setup'', '''search''' for ''Connected Apps'' in the ''Quick Find'' box and then '''select''' the option for managing ''Connected Apps''.&nbsp;
+
1.&nbsp;&nbsp;'''Click''' Setup icon > “Setup”.<br/> 2.&nbsp;&nbsp;Under “Platform Tools” > “Apps” > “Connected Apps” '''click''' “Manage Connected Apps”.
<div class="image-green-border">[[File:Managing the Canvas App.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">2.&nbsp;'''Click '''the ''ICM App'', and then '''click''' ''Edit''.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Managing the Canvas App2.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">3.&nbsp;In the ''Permitted Users'' field, '''select''' ''Admin approved users are pre-authorized'' so that other ICM users cannot view the Canvas App until they are provided permissions. '''Click '''''OK'' in the<br/> pop-up message that appears.&nbsp;</div> <div class="image-green-border">&nbsp; <div class="note-box">'''Note''': If you select the ''All Users may self-authorize'' option in the ''Permitted Users'' field, other ICM users can see the Canvas App, but they would need to approve or deny access to it.&nbsp;</div>
+
[[File:Managing the Canvas App3.PNG|RTENOTITLE]]
+
  
4. '''Click''' ''Save''.
+
[[File:Salesforce10.png|280px|Salesforce10.png]]
</div> <div class="image-green-border">Now, define who can access your Canvas App by using profiles and permission sets.&nbsp;<br/> To understand the following example, consider that you want to give access to the System Administrator profile.&nbsp;</div> <div class="image-green-border"><br/> 1. In the ''Profiles ''related list, '''click''' ''Manage Profiles''.&nbsp;<br/> 2.&nbsp;'''Select '''the ''System Administrator'' profile and '''click''' Save.</div> <div class="image-green-border">&nbsp;</div>
+
=== Configuring ICM EndPoint ===
+
  
You can perform ICM EndPoint Configuration only after you have installed Salesforce ICM from AppExchange.&nbsp;
+
3.&nbsp;&nbsp;'''Click''' “Edit”.
<div class="image-green-border">[[File:Configuring ICM EndPoint.PNG|RTENOTITLE]]<br/> &nbsp;</div> <div class="image-green-border">Follow these steps to configure ICM EndPoint:</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">1. '''Click''' ''ICM Configuration'' in the top navigation bar by logging on to the ICM App in Salesforce on ICM App Home page. ''ICM EndPoint Configuration'' page appears.<br/> 2. Provide relevant information in the respective fields:</div> <div class="image-green-border">&nbsp;</div>
+
&nbsp;[[File:Configuring ICM EndPoint Table1.PNG|RTENOTITLE]]
+
  
[[File:Configuring ICM Endpoint Table2.PNG|RTENOTITLE]]
+
[[File:Salesforce11.png|720px|Salesforce11.png]]
 +
<div class="image-green-border">4.&nbsp;In the ''Permitted Users'' field, '''select''' ''Admin approved users are pre-authorized'' so that other ICI users cannot view the Canvas App until they are provided permissions. '''Click '''''OK'' in the<br/> pop-up message that opens.&nbsp;</div> <div class="image-green-border">&nbsp; <div class="note-box">'''Note''': If you select the ''All Users may self-authorize'' option in the ''Permitted Users'' field, other ICI users can see the Canvas App, but they would need to approve or deny access to it.&nbsp;</div>
 +
[[File:Managing the Canvas App3.PNG|720px|RTENOTITLE]]
  
[[File:Configuring ICM Endpoint Table3.PNG|RTENOTITLE]]
+
5. '''Click''' ''Save''.
 +
</div> <div class="image-green-border">Now, define who can access your Canvas App by using profiles and permission sets.&nbsp;<br/> To understand the following example, consider that you want to give access to the System Administrator profile.&nbsp;</div> <div class="image-green-border"><br/> 1. In the ''Profiles ''related list, '''click''' ''Manage Profiles''.&nbsp;<br/> 2.&nbsp;'''Select '''the ''System Administrator'' profile and '''click''' Save.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Salesforce12.png|720px|Salesforce12.png]]</div> <div class="image-green-border">&nbsp;</div>
 +
=== Configuring ICI EndPoint ===
  
[[File:Configuring ICM EndPoint Table4.PNG|RTENOTITLE]]
+
You can perform ICI EndPoint Configuration only after you have installed Salesforce ICI from AppExchange.&nbsp;
 +
<div class="image-green-border">[[File:Configuring ICM EndPoint 1.PNG|720px|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">Follow these steps to configure ICI EndPoint:</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">1. '''Click''' ''ICI Configuration'' in the top navigation bar by logging on to the ICI App in Salesforce on ICI App Home page. ''ICI EndPoint Configuration'' page opens.<br/> 2. Provide relevant information in the respective fields:</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Table 1 1.PNG|RTENOTITLE]]</div> <div class="image-green-border">[[File:Table 1 2.PNG|RTENOTITLE]]</div>
 +
=== Creating a Field Set&nbsp; ===
  
=== Setting up a new Remote Site (whitelisting of ICM instance) ===
+
The Field set are fields that have been grouped together for creating the Field Set. For example, Opportunity name, Close Date, Opportunity Owner etc. A user with Administrator privileges can create or edit a Field Set.&nbsp;
  
Adding a remote site or whitelisting the ICM domain is an optional step. The Application automatically creates or adds the remote site settings but if the application does not create remote site automatically, follow the steps below to create remote site settings. You can view added remote site by navigating to ''Setup'', ''Remote Site Settings'' and search for ''ICM URL'', which you added by following the steps in the earlier section.
+
To create a Field Set:&nbsp;
<div class="image-green-border">You need to add your ICM Application URL in Salesforce for whitelisting. Salesforce can access only whitelisted URLs.&nbsp;<br/> To setup a new remote site:&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">1. '''Click '''''Setup ''in the upper right corner of your page. The ''Setup'' page appears.&nbsp;<br/> 2. '''Click '''''Security Controls'' in the ''Administer'' menu in the left pane and then '''click''' ''Remote Site Settings''. Alternatively, you can '''type '''''Remote Site Settings'' in the ''Quick Find/Search box''. As you type the text, the relevant search result appears. '''Select''' ''Remote Site Settings'' under ''Security Controls''. The ''All Remote Sites'' page appears showing the list of Remote sites.<br/> 3. '''Click '''''New Remote Site''. The ''Remote Site Edit ''page appears.</div> <div class="image-green-border">&nbsp;</div>  
+
 
[[File:Setting up a new Remote type Table 1.PNG|RTENOTITLE]]
+
1.&nbsp;'''Click&nbsp;'''the ''Settings&nbsp;''icon on the ''Settings'' page,&nbsp;and then click Setup. The ''Setup'' page opens.
 +
<div class="image-green-border">[[File:CreatingFieldSet1.PNG|720px|RTENOTITLE]]</div>
 +
2.&nbsp;'''Click''' ''Object Manager''. The ''Object Manager'' page opens.&nbsp;
 +
<div class="image-green-border">[[File:Select ObjectManager.png|720px|RTENOTITLE]]</div>
 +
3.&nbsp;'''Enter''' the entity name in the ''Quick Find'' box to search for the entity that you want to create the Field Set. For example, ''Opportunity''.
 +
<div class="image-green-border">[[File:Quick Find Entity.png|RTENOTITLE]]</div>
 +
4. '''Click''' an ''Opportunity'' from the filtered list. The respective ''Opportunity'' page opens.
 +
<div class="image-green-border">[[File:Quick Find Entity 1.png|720px|RTENOTITLE]]</div>
 +
5.&nbsp;'''Click''' ''Field Sets'' in the left navigation pane. The ''Field Sets'' page opens.
 +
<div class="image-green-border">[[File:Field Sets.png|720px|RTENOTITLE]]</div>
 +
6.&nbsp;'''Click''' ''New'' on the ''Field Sets'' tab. The ''New Field Set'' page opens.
 +
<div class="image-green-border">[[File:Create New FieldSet.png|720px|RTENOTITLE]]</div>
 +
7.&nbsp;'''Enter''' the description for the following fields on the ''New Field Set'' page.
 +
 
 +
*''Field Set Label:&nbsp;''The name for the Field Set.&nbsp;
 +
*''Field Set Name:&nbsp;''This is&nbsp;auto-populated based on the ''Field Set'' label above.
 +
*''Where is this used?''&nbsp;: A brief description of the Salesforce pages where the ''Field Set'' will be used, and for what purpose.
 +
<div class="image-green-border">[[File:Create New FieldSet 1.png|720px|RTENOTITLE]]</div>
 +
8.&nbsp;'''Drag''' and '''drop''' the Fields from the ''Quick Find'' section to the ''In the Field Set'' section to add the Fields to the Field Set.
 +
<div class="image-green-border">9.&nbsp;'''Click&nbsp;'''''Save&nbsp;''to save the Field Set you created.&nbsp;</div>
 +
=== Viewing the Fields in Salesforce ===
 +
 
 +
The Fields added in the Field Set can be viewed when creating a Contract from Salesforce using an Account, Opportunity or Quote.&nbsp;
 +
 
 +
To view the Fields:&nbsp;
 +
 
 +
1.&nbsp;'''Click''' ''Opportunities'' on the&nbsp;''Home'' page in Salesforce. The ''Opportunities'' page opens displaying the list of Opportunities.
 +
<div class="image-green-border">[[File:Salesforce13.png|720px|Salesforce13.png]]</div>
 +
2.&nbsp;'''Click''' the ''Opportunity'' from which you want to create a Contract. The ''Opportunity Details'' page opens.
 +
<div class="image-green-border">[[File:Salesforce14.png|720px|Salesforce14.png]]</div>
 +
3.&nbsp;'''Click''' ''New Contract'' in the ''Icertis Contracts'' section. The ''Create'' page opens displaying the details to be entered for creating the Contract.
 +
<div class="image-green-border">[[File:Salesforce15.png|720px|Salesforce15.png]]</div> <div class="image-green-border">4.&nbsp;'''Select&nbsp;'''the following on&nbsp;''Create&nbsp;''page.&nbsp;</div>
 +
*''Category:&nbsp;'''''Select&nbsp;'''the Category from this dropdown. For example,&nbsp;''Default.&nbsp;''
 +
*''Contract Type Name:&nbsp;'''''Select&nbsp;'''the Contract Type based on which you want to create the Contract. For example,&nbsp;''SFMSA.&nbsp;''
 +
*''Type of Paper'': '''Select''' ''Own'' if you want to use the system generated Template. '''Select''' ''Third Party'' if you want to upload and use your own Template.
 +
<div class="image-green-border">[[File:Salesforce16.png|720px|Salesforce16.png]]</div>
 +
5.&nbsp;'''Click''' ''Next''. The ''Attributes'' page opens showing the list of Fields added in the Field Set. For example, ''Opportunity Id'', ''Opportunity Name''.
 +
<div class="image-green-border">[[File:Salesforce17.png|720px|Salesforce17.png]]</div>
 +
'''Note''':&nbsp;After the Contract is created in Salesforce, it is displayed in ICI along with the Fields added in the Field Set.
 +
<div class="image-green-border">[[File:Salesforce18.png|720px|Salesforce18.png]]</div> <div class="image-green-border">&nbsp;</div>
 +
=== Setting up a new Remote Site (whitelisting of ICI instance) ===
 +
 
 +
Adding a remote site or whitelisting the ICI domain is an optional step. The Application automatically creates or adds the remote site settings but if the application does not create remote site automatically, follow the steps below to create remote site settings. You can view added remote site by navigating to ''Setup'', ''Remote Site Settings'' and search for ''ICI URL'', which you added by following the steps in the earlier section.
 +
<div class="image-green-border">You need to add your ICI Application URL in Salesforce for whitelisting. Salesforce can access only whitelisted URLs.&nbsp;<br/> To setup a new remote site:&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">1. '''Click '''''Setup ''in the upper right corner of your page. The ''Setup'' page&nbsp;opens.&nbsp;<br/> 2. '''Click '''''Security Controls'' in the ''Administer'' menu in the left pane and then '''click''' ''Remote Site Settings''. Alternatively, you can '''type '''''Remote Site Settings'' in the ''Quick Find/Search box''. As you type the text, the relevant search result opens. '''Select''' ''Remote Site Settings'' under ''Security Controls''. The ''All Remote Sites'' page opens showing the list of Remote sites.<br/> 3. '''Click '''''New Remote Site''. The ''Remote Site Edit ''page opens.</div> <div class="image-green-border">&nbsp;</div>  
 +
[[File:Table 2.PNG|RTENOTITLE]]
 +
 
 +
After you add the above information on the&nbsp;''Remote Site Edit'' page, you can do the following:&nbsp;
  
[[File:Setting up a new Remote type Table 2.PNG|RTENOTITLE]]
 
<div class="image-green-border">After you add the above information on the&nbsp;''Remote Site Edit'' page, you can do the following:&nbsp;</div>
 
 
*'''Save '''the Remote Site you created.&nbsp;  
 
*'''Save '''the Remote Site you created.&nbsp;  
 
*'''Click '''''Save ''and ''New'' to save the Remote Site you created and open the ''Remote Site Edit'' page to continue creating a new Remote Site.  
 
*'''Click '''''Save ''and ''New'' to save the Remote Site you created and open the ''Remote Site Edit'' page to continue creating a new Remote Site.  
Line 140: Line 185:
 
=== Configuring Page Layout ===
 
=== Configuring Page Layout ===
  
To Enable ICM sections on the added entity (as per the ''ICM Configuration'' section) you need to add the ICM custom pages into page layouts. By using the ''Page Layout Configuration'', Admin assigns user access to Contract or Contract Request Related Sections. For example, if you have enabled the ICM Configuration for Opportunity in Salesforce, you need to enable ICM custom pages in '''Opportunity Layout''':
+
To Enable ICI sections on the added entity (as per the ''ICI Configuration'' section) you need to add the ICI custom pages into page layouts. By using the ''Page Layout Configuration'', Admin assigns user access to Contract or Contract Request Related Sections. For example, if you have enabled the ICI Configuration for Opportunity in Salesforce, you need to enable ICI custom pages in '''Opportunity Layout''':
  
Opportunity (Opportunity Page Layout)
+
You can Edit your existing Page layout (Opportunity Layout) and add two Visualforce pages inside the page layout as follows:
  
1.&nbsp;You can Edit your existing Page layout (''Opportunity Layout'') and add two Visualforce pages inside the page layout as follows:
+
1. &nbsp;Click Setup icon > “Setup”. The “Setup” page opens.<br/> 2. &nbsp;In the “Quick Find” search box, search for “object manager”
 +
<div class="image-green-border">[[File:Salesforce19.png|480px|Salesforce19.png]]</div>
 +
3. '''Click '''“Object Manager”, the “Object Manager” page opens displaying all entity objects.
 +
<div class="image-green-border">[[File:Salesforce21.png|800px|Salesforce21.png]]</div>
 +
4. In the “Quick Find” search box, search for “opportunity” and '''click '''on the “Opportunity” object from the search result. The “Opportunity” page opens.
 +
<div class="image-green-border">[[File:Salesforce22.png|800px|Salesforce22.png]]</div>
 +
5. '''Click '''“Page Layouts” from the left pane of the “Opportunities” page, the “Page Layouts” list are displayed.
 +
<div class="image-green-border">[[File:Salesforce23.png|800px|Salesforce23.png]]</div>
 +
6. '''Click '''“Opportunity Layout” from the “Page Layouts” list, the “Opportunity Layout” configuration page opens in editable mode.
 +
<div class="image-green-border">[[File:Salesforce24.png|800px|Salesforce24.png]]</div>
 +
7. &nbsp;In the Opportunity Layout pane, in the left menu, scroll down to select Visualforce Pages. &nbsp;Under Blank Space, drag the page that you want to give access to and drop it in the appropriate area in the opportunity (located on the same page under Opportunity Sample). For example, as you can see in the following screenshot, ICI_Contract Page and ICI_Contract Request Page can be dragged and dropped in the appropriate area in the opportunity.
 +
<div class="image-green-border">[[File:Salesforce20.png|800px|Salesforce20.png]]</div>
 +
Pages are now added in the Icertis Contracts Section.
  
2.&nbsp; On the ''Opportunity Layout'' page, '''click''' ''Edit'' to edit the page layout where you want to add ''Visualforce'' pages.&nbsp;
 
<div class="image-green-border">[[File:Configuring Page Layout new.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">3.&nbsp;In the ''Opportunity Layout'' pane, in the left menu, scroll down to select ''Visualforce Pages''. &nbsp;Under ''Blank Space'', drag the page that you want to give access to and drop it in the appropriate area in the opportunity (located on the same page under ''Opportunity Sample''). For example, as you can see in the following screenshot, ''ICM_Contract Page'' and ''ICM_Contract Request Page'' can be dragged and dropped in the appropriate area in the opportunity.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Configuring Page Layout new2.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">4.&nbsp;Pages are added in the ''Icertis Contracts'' Section.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Configuring Page Layout new3.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">5.&nbsp;'''Click '''''Save''.</div> <div class="image-green-border">&nbsp;</div> <div class="note-box">'''Note''': For better visualization, please add inline VF pages with the height of 250px.</div> <div class="image-green-border">&nbsp;</div>
 
 
=== Configuring Data Sync ===
 
=== Configuring Data Sync ===
  
Once the Contract and Contract Request is created from Salesforce, the data is synced to ICM entities. If the Salesforce entity is edited or changed, user need to update mapped fields in ICM. Ideally, this process is automated. The system should automatically sync the data in the background, without user intervention.
+
Once the Contract and Contract Request is created from Salesforce, the data is synced to ICI entities. If the Salesforce entity is edited or changed, user need to update mapped fields in ICI. Ideally, this process is automated. The system should automatically sync the data in the background, without user intervention.
  
To enable this feature in Salesforce, ''ICM Service User Authentication Token'' should be configured and create a process in ''Process Builder'' for specific entities. &nbsp;Selected entities will have Data sync functionality. To know more about the ''Process Builder'', visit: [https://help.salesforce.com/articleView?id=process_overview.htm&type=0 https://help.salesforce.com/articleView?id=process_overview.htm&type=0&nbsp;]
+
To enable this feature in Salesforce, ''ICI Service User Authentication Token'' should be configured and create a process in ''Process Builder'' for specific entities. &nbsp;Selected entities will have Data sync functionality. To know more about the ''Process Builder'', visit: [https://help.salesforce.com/articleView?id=process_overview.htm&type=0 https://help.salesforce.com/articleView?id=process_overview.htm&type=0&nbsp;]
  
=== Data Sync (Salesforce to ICM) Configuration ===
+
=== Data Sync (Salesforce to ICI) Configuration ===
 
<div class="image-green-border">&nbsp;</div> <div class="image-green-border">Data sync configuration is divided into two sections:</div>  
 
<div class="image-green-border">&nbsp;</div> <div class="image-green-border">Data sync configuration is divided into two sections:</div>  
 
*Configure Service User Authentication Token  
 
*Configure Service User Authentication Token  
 
*Configure Entity Process Builder  
 
*Configure Entity Process Builder  
 +
 +
&nbsp;
 +
 +
&nbsp;
  
 
=== Service User Authentication Token ===
 
=== Service User Authentication Token ===
Line 163: Line 222:
 
To configure Service User Token in Salesforce, follow these steps:
 
To configure Service User Token in Salesforce, follow these steps:
  
1.&nbsp;In Salesforce, under ''Setup'', '''search''' ''Installed Packages'' in the ''Quick Find'' box and '''select '''''Installed Packages''.
+
1.&nbsp;In Salesforce, under ''Setup'', '''search''' ''Installed Packages'' in the ''Quick Find'' box and '''select '''''Installed Packages''.&nbsp;The “Installed Packages” are displayed.
<div class="image-green-border">[[File:Service USer Authentication Token.PNG|RTENOTITLE]]</div> <div class="image-green-border">2.&nbsp;'''Find '''''IcertisCLM'' Package and '''Click '''Configure. ''Data Sync Configuration'' page appears.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Service USer Authentication Token new 2.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Service USer Authentication Token new 3.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">3.&nbsp;Only the ''Admin ''user can perform the following actions:</div>  
+
<div class="image-green-border">[[File:Salesforce25.png|800px|Salesforce25.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">2.&nbsp;'''Find '''''IcertisCLM'' Package and '''Click '''Configure. ''Data Sync Configuration'' page opens.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Salesforce26.png|800px|Salesforce26.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Salesforce27.png|800px|Salesforce27.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">3.&nbsp;Only the ''Admin ''user can perform the following actions:</div>  
 
*''Disable DS Interval Flow'': '''Click''' this checkbox to deactivate the Data Sync Interval Flow. Default value false.&nbsp;  
 
*''Disable DS Interval Flow'': '''Click''' this checkbox to deactivate the Data Sync Interval Flow. Default value false.&nbsp;  
 
*''Sync Time Duration'': &nbsp;It denotes the sync time duration (in seconds). Default value 10.  
 
*''Sync Time Duration'': &nbsp;It denotes the sync time duration (in seconds). Default value 10.  
*''ICM Service User Auth Token'': It is the Service User Authentication Token. Contact DevOps team to get this token. and it is existed in ICM, if you want this token contact ICM Configurator.  
+
*''ICI Service User Auth Token'': It is the Service User Authentication Token. Contact DevOps team to get this token. and it is existed in ICI, if you want this token contact ICI Configurator.  
  
 
4. '''Click''' ''Save''.
 
4. '''Click''' ''Save''.
 +
 +
&nbsp;
 +
 +
&nbsp;
  
 
=== Configure Entity Process Builder ===
 
=== Configure Entity Process Builder ===
Line 176: Line 239:
  
 
1. In Salesforce, under ''Setup'', '''search '''for ''Process Builder'' in the ''Quick Find'' box and '''select''' ''Process Builder''.
 
1. In Salesforce, under ''Setup'', '''search '''for ''Process Builder'' in the ''Quick Find'' box and '''select''' ''Process Builder''.
<div class="image-green-border">[[File:Configure Entity Process Builder.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">2. On the ''Process Builder Configuration Page'', '''click''' ''New''. ''New Process'' popup appears.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Configure Entity Process Builder1.PNG|RTENOTITLE]]</div> <div class="image-green-border"><br/> 3. On the New Process popup window, '''enter '''Process Name and API Name.<br/> 4.&nbsp;'''Set '''The process starts when field value to ''A record changes'' and '''click''' Save.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Configure Entity Process Builder2.PNG|RTENOTITLE]]<br/> &nbsp;<br/> 5.&nbsp;''Opp Sync process configuration'' page appears. '''Click '''''Add Object'', '''Select '''''Object Name'' and '''select '''''when record is created or edited'' and '''click '''''Save''.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Configure Entity Process Builder3.PNG|RTENOTITLE]]</div> <div class="image-green-border"><br/> 6.&nbsp;'''Click''' ''Add Criteria'', '''enter''' ''Criteria Name'' and '''select''' ''Conditions are met'', ''formula evaluates true'' or ''No Criteria'' and '''click''' Save.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Configure Entity Process Builder4.PNG|RTENOTITLE]]<br/> &nbsp;<br/> 7.&nbsp;To configure ''Immediate Actions'', '''click '''''Add Action'', '''enter''' the data as per the table below and '''click '''''Save''.</div> <div class="image-green-border">&nbsp;</div>  
+
<div class="image-green-border">[[File:Salesforce28.png|360px|Salesforce28.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">2. On the ''Process Builder Configuration Page'', '''click''' ''New''. ''New Process'' popup opens.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Configure Entity Process Builder1.PNG|720px|RTENOTITLE]]</div> <div class="image-green-border"><br/> 3. On the New Process popup window, '''enter '''Process Name and API Name.<br/> 4.&nbsp;'''Set '''The process starts when field value to ''A record changes'' and '''click''' Save.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Configure Entity Process Builder2.PNG|720px|RTENOTITLE]]<br/> &nbsp;<br/> 5.&nbsp;''Opp Sync process configuration'' page opens. '''Click '''''Add Object'', '''Select '''''Object Name'' and '''select '''''when record is created or edited'' and '''click '''''Save''.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Configure Entity Process Builder3.PNG|720px|RTENOTITLE]]</div> <div class="image-green-border"><br/> 6.&nbsp;'''Click''' ''Add Criteria'', '''enter''' ''Criteria Name'' and '''select''' ''Conditions are met'', ''formula evaluates true'' or ''No Criteria'' and '''click''' Save.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Configure Entity Process Builder4.PNG|720px|RTENOTITLE]]<br/> &nbsp;<br/> 7.&nbsp;To configure ''Immediate Actions'', '''click '''''Add Action'', '''enter''' the data as per the table below and '''click '''''Save''.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Table 3.PNG|720px|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Configure Entity Process Builder6.PNG|720px|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">8.&nbsp;'''Click''' ''Activate'' to complete the process.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Configure Entity Process Builder7.PNG|720px|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="note-box">'''Note''':&nbsp;You can configure any other Entity following the same process.</div> <div class="image-green-border">&nbsp;</div>  
[[File:Configure Entity Process Builder5.PNG|RTENOTITLE]]
+
&nbsp;
<div class="image-green-border">[[File:Configure Entity Process Builder6.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">8.&nbsp;'''Click''' ''Activate'' to complete the process.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Configure Entity Process Builder7.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="note-box">'''Note''':&nbsp;You can configure any other Entity following the same process.</div> <div class="image-green-border">&nbsp;</div>  
+
== ICM Side Configuration ==
+
  
=== Mapping Data between Salesforce and ICM ===
+
== ICI Side Configuration ==
  
Use the ''Configuration ''tile in the ICM application to specify the mapping details between Salesforce and ICM by creating Masterdata records for mapping entities.
+
=== Mapping Data between Salesforce and ICI ===
 +
 
 +
Use the ''Configure&nbsp;''tile in the ICI application to specify the mapping details between Salesforce and ICI by creating Masterdata records for mapping entities.
 +
 
 +
&nbsp;
  
 
=== Creating Masterdata records for mapping entities ===
 
=== Creating Masterdata records for mapping entities ===
Line 189: Line 254:
 
'''Creating Client App Cross Reference Mapping'''
 
'''Creating Client App Cross Reference Mapping'''
  
1. '''Log on '''to the ICM application.<br/> 2. '''Click''' ''Configuration'' on ICM Dashboard. The Configuration page appears.
+
#'''Log on '''to the ICI application  
<div class="image-green-border">[[File:Creating Masterdata records for mapping entities.PNG|RTENOTITLE]]</div>  
+
#'''Click''' ''Configure&nbsp;>&nbsp;Masterdata >&nbsp;Create Masterdata&nbsp;''on ICI Dashboard. The ''Create Masterdata ''page opens.  
3.&nbsp;'''Click '''''Masterdata ''on the ''Configuration ''page. The ''Masterdata ''page appears.&nbsp;
+
<div class="image-green-border">[[File:SF 7.png|720px|SF 7.png]]</div> <ol start="3">
<div class="image-green-border">[[File:Creating Masterdata records for mapping entities1.PNG|RTENOTITLE]]</div>  
+
<li>Provide relevant information in the respective fields:</li>
<br/> 4. '''Click''' ''Create Masterdata''. ''Create Masterdata ''page appears.
+
</ol>
<div class="image-green-border">[[File:Creating Masterdata records for mapping entities2.PNG|RTENOTITLE]]</div>  
+
<div class="image-green-border">[[File:Creating Masterdata records for mapping entities3.PNG|720px|RTENOTITLE]]</div> <ol start="4">
5. Provide relevant information in the respective fields:
+
<li>'''Click''' ''Next''. The ''Attributes ''page opens.</li>
 
+
<li>Provide relevant information in the respective fields:</li>
[[File:Creating Masterdata records for mapping entities3.PNG|RTENOTITLE]]
+
</ol>
 +
<div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Table 4.PNG|720px|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="note-box">'''Note:&nbsp;'''You can map a Salesforce standard Contract object to ICI Contract Type. This allows creating a Contract in Salesforce automatically whenever it is created in ICI. You can configure any Salesforce entity to map with the ICI Contract creation.&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">8.&nbsp;'''Click '''''Save'' after entering the details.&nbsp;</div> <div class="image-green-border">&nbsp;</div>  
 +
&nbsp;
  
6.&nbsp;'''Click''' ''Next''. The ''Attributes ''page appears.
 
<div class="image-green-border">[[File:Creating Masterdata records for mapping entities4.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">7. Provide relevant information in the respective fields:</div> <div class="image-green-border">&nbsp;</div>
 
[[File:Creating Masterdata records for mapping entities5.PNG|RTENOTITLE]][[File:Creating Masterdata records for mapping entities6.PNG|RTENOTITLE]]
 
<div class="image-green-border">&nbsp;</div> <div class="note-box">'''Note:&nbsp;'''You can map a Salesforce standard Contract object to ICM Contract Type. This allows creating a Contract in Salesforce automatically whenever it is created in ICM. You can configure any Salesforce entity to map with the ICM Contract creation.&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">8.&nbsp;'''Click '''''Save'' after entering the details.&nbsp;</div> <div class="image-green-border">&nbsp;</div>
 
 
=== Creating Masterdata for mapping the entities ===
 
=== Creating Masterdata for mapping the entities ===
  
You can create a Masterdata record for the Contract Type Masterdata that you created earlier. This helps in mapping the entities between Salesforce and ICM. ICM allows mapping this data from any Salesforce entities like opportunity, account, or quote to a Contract Request or agreement by creating the Masterdata record in ICM.&nbsp;<br/> <br/> To create a Masterdata record:
+
You can create a Masterdata record for the Contract Type Masterdata that you created earlier. This helps in mapping the entities between Salesforce and ICI. ICI allows mapping this data from any Salesforce entities like opportunity, account, or quote to a Contract Request or agreement by creating the Masterdata record in ICI.&nbsp;<br/> <br/> To create a Masterdata record:
  
1. '''Click''' ''Configuration'' on My Dashboard. The ''Configuration'' page appears.&nbsp;
+
#'''Click''' ''Configure >&nbsp;Masterdata >&nbsp;Create Masterdata&nbsp;''on ICI Dashboard. The ''Create Masterdata'' page opens.  
<div class="image-green-border">[[File:Creating Masterdata for mapping the entities.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">2.&nbsp;'''Click''' ''Masterdata'' on the Configuration page. The Masterdata page appears.&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Creating Masterdata for mapping the entities1.PNG|RTENOTITLE]]<br/> &nbsp;<br/> 3.&nbsp;'''Click '''''Create Masterdata'' on the Masterdata page. The ''Create Masterdata'' page appears.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Creating Masterdata for mapping the entities2.PNG|RTENOTITLE]]<br/> &nbsp;<br/> 4. Complete the information in the following sections.&nbsp;</div>  
+
<div class="image-green-border">[[File:SF 7.png|720px|SF 7.png]]</div> <div class="image-green-border"><br/> &nbsp;<br/> 2. Complete the information in the following sections.&nbsp;</div>  
 
*''Masterdata Details''  
 
*''Masterdata Details''  
 
*''Attributes''  
 
*''Attributes''  
<div class="image-green-border">5.&nbsp;'''Click '''''Next'' at the end of ''Masterdata Details'' section to go to the ''Attributes ''section and complete creating the Masterdata record.&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">'''Masterdata Details'''</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">1. '''Select '''the category from the drop-down list.&nbsp;<br/> 2. '''Select''' the Contract Type Masterdata that you created earlier. For the purpose of mapping the data between ICM and Salesforce, '''select '''''Client App Entity Mapping''.<br/> 3.&nbsp;'''Click '''''Next''. The ''Attributes'' page appears.&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Creating Masterdata for mapping the entities3 new.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">'''Attributes'''</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">This section shows the attributes that you created when creating the Contract Type Masterdata.&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Creating Masterdata for mapping the entities4 new.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">4.&nbsp;Enter the following details in appropriate fields.</div> <div class="image-green-border">&nbsp;</div>  
+
<div class="image-green-border">3.&nbsp;'''Click '''''Next'' at the end of ''Masterdata Details'' section to go to the ''Attributes ''section and complete creating the Masterdata record.&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">'''Masterdata Details'''</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">1. '''Select '''the category from the drop-down list.&nbsp;<br/> 2. '''Select''' the Contract Type Masterdata that you created earlier. For the purpose of mapping the data between ICI and Salesforce, '''select '''''Client App Entity Mapping''.<br/> 3.&nbsp;'''Click '''''Next''. The ''Attributes'' page opens.&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">'''Attributes'''</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">This section shows the attributes that you created when creating the Contract Type Masterdata.&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:SF 8.PNG|520px|SF 8.PNG]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">4.&nbsp;Enter the following details in appropriate fields.</div> <div class="image-green-border">&nbsp;</div>  
[[File:Creating Masterdata for mapping the entities5.PNG|725px|Creating Masterdata for mapping the entities5.PNG]]
+
[[File:Table5 1.PNG|720px|RTENOTITLE]][[File:Table5 2.PNG|720px|RTENOTITLE]]
  
[[File:Creating Masterdata for mapping the entities6.PNG|RTENOTITLE]]
+
5.&nbsp;'''Click '''''Save'' to save the Masterdata record and enable mapping between ICI and Salesforce.
  
5.&nbsp;'''Click '''''Save'' to save the Masterdata record and enable mapping between ICM and Salesforce.
+
&nbsp;
 +
 
 +
&nbsp;
 +
 
 +
== Configuration for allowing user to be redirected to ICI Details page in Salesforce ==
 +
 
 +
When creating Contracts, Contract Requests and Amendments from Salesforce, Administrators can now configure whether the users should be redirected to the ICI Contract details page or the Salesforce Record page from where creation process was initiated.&nbsp;This can be configured by selecting the “Show initiating object’s Salesforce page” checkbox on the ICI Endpoint Configuration page. By default, the checkbox is unchecked. When checked, the user is redirected to the Salesforce Record page, else to the ICI Contract detail page.
 +
 
 +
&nbsp;
 +
 
 +
&nbsp;
 +
 
 +
== Integrating ICI Tasks with Salesforce&nbsp; ==
 +
 
 +
With this release, Salesforce users can now manage ICI tasks from within Salesforce. ICI Administrators can configure ICI task integration with Salesforce so that the tasks created in ICI are pushed to Salesforce. This allows users to view task details with the attributes such as ''Task Name'', ''Status'', ''Priority'', ''Due Date'' within Salesforce itself.
 +
 
 +
Based on configuration, users can receive task notifications in Salesforce for any action taken on agreements, templates, contract requests, clauses or masterdata in ICI.&nbsp;<br/> To integrate ICI Tasks with Salesforce Tasks:
 +
 
 +
&nbsp;
 +
 
 +
=== Creating Client App Cross Reference ===
 +
 
 +
#'''Click''' ''Configure&nbsp;> Masterdata > Create''. The ''Masterdata Details'' tab is displayed.
 +
<div class="image-green-border">[[File:SF 7.png|720px|SF 7.png]]</div> <ol start="2">
 +
<li>'''Select''' the ''Category ''from the dropdown. For example, ''Default''.</li>
 +
</ol>
 +
<div class="image-green-border">[[File:SF 9.PNG|520px|SF 9.PNG]]</div> <ol start="3">
 +
<li>'''Select '''the ''Masterdata Contract Type''. In order to map ICI entities with entities in Salesforce, you must select ''Client App Cross Reference'' from the dropdown.</li>
 +
<li>'''Click''' ''Next''. The ''Attributes ''tab opens.</li>
 +
<li>'''Enter '''the relevant attribute values. Enter ''ICI Entity Name'' and ''Client Entity Name'' as ''Task''.</li>
 +
</ol>
 +
<div class="image-green-border">[[File:SF 10.PNG|720px|SF 10.PNG]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border"><div class="note-box">'''Note''': The Sync Task Notification attribute will only be visible if ''Client Name'' is selected as ''Salesforce''. Similarly, the ''Task Types Of Contract'' and ''Task Notification Actions'' attributes will only be displayed if ''Sync Task Notification'' flag is set to ''Yes''.</div>
 +
When the user takes any of the workflow action selected in the ''Task Notification Actions'' field in ICI, the corresponding task gets generated in Salesforce. For example, if ''Request Review'' action is taken on an agreement and a user (Reviewer) is selected, then the same task will appear in the Tasks section of Salesforce.
 +
</div>
 +
&nbsp;
 +
 
 +
=== Viewing ICI Tasks in Salesforce ===
 +
 
 +
[[File:SF 11.png|520px|SF 11.png]]
 +
 
 +
&nbsp;For example, if the agreement is Not&nbsp;approved in ICI for which ''Send for Approval'' action was taken, then the agreement status in ICI changes to ''Approval Pending''&nbsp;and in Salesforce changes to ''Not Started.''
 +
 
 +
&nbsp;
  
 
== Working with Saved Searches ==
 
== Working with Saved Searches ==
  
 
You can use advanced search option to search for existing entities. You can save these searches and pin them as favorites for easy access. Saved searches can be opened for easy access to the search results.&nbsp;
 
You can use advanced search option to search for existing entities. You can save these searches and pin them as favorites for easy access. Saved searches can be opened for easy access to the search results.&nbsp;
 +
 +
&nbsp;
  
 
=== Performing a Search to Save ===
 
=== Performing a Search to Save ===
  
1.&nbsp;'''Click '''the ''Search&nbsp; [[File:Magnifying search.PNG|25x25px|Magnifying search.PNG]]&nbsp;''tile on the top right corner on ''My Dashboard'' page. The ''Advanced Search'' page appears.&nbsp;<br/> 2.&nbsp;In the ''Please select Entities to Search'' field, '''enter''' or '''select''' appropriate entities from the list and '''type''' the keywords to search in the ''Enter Search here'' field.&nbsp;
+
1.&nbsp;'''Click '''the ''Advanced ''button on the&nbsp;right corner of the Search toolbar. The ''Advanced Search'' page opens.&nbsp;<br/> 2.&nbsp;In the first field from left, '''enter''' or '''select''' appropriate entities from the list and '''type''' the keywords to search in the ''Refine&nbsp;Search here&nbsp;''field'''.&nbsp;'''
<div class="image-green-border">[[File:Working with saved searches.PNG|RTENOTITLE]]<br/> &nbsp;<br/> 3. '''Select''' from these options:&nbsp;</div>  
+
<div class="image-green-border">[[File:SF 12.PNG|720px|SF 12.PNG]]<br/> &nbsp;<br/> 3. '''Select''' from these options:&nbsp;</div>  
*''Metadata'': the search is performed in the metadata of the selected Agreement.&nbsp;
+
4. After selecting either of the above options, '''click '''the ''Search''&nbsp;button. The list of search results opens.&nbsp;
*''Full Text'': the search is performed within the contents of the document of the selected Agreement.&nbsp;  
+
  
4. After selecting either of the above options, '''click '''the ''Search'' [[File:Magnifying glass with image.jpg|25x25px|Magnifying glass with image.jpg]]&nbsp; icon. The list of search results appears.&nbsp;
+
5.&nbsp;To narrow down your search further, navigate to ''Search For'' field. '''Click '''''Select Field'' and '''select '''an option from the list provided. The number in the bracket indicates the number of items available containing that search term. You can select multiple options. For example, '''selecting '''the field Status displays the number of Agreements that have the ''Status as Draft'', ''Approved'', ''Terminated'', ''Superseded ''and so on. If you select the status as ''Draft'' (select the checkbox next to Draft), all Agreements in the ''Draft'' state are displayed.&nbsp;
  
5.&nbsp;To narrow down your search further, navigate to ''Search For'' field. '''Click '''''Select Field'' and '''select '''an option from the list provided. The number in the bracket indicates the number of items available containing that search term. You can select multiple options. For example, '''selecting '''the field Status displays the number of Agreements that have the ''Status as Draft'', ''Approved'', ''Terminated'', ''Superseded ''and so on. If you select the status as ''Draft'' (select the checkbox next to Draft), all Agreements in the ''Draft'' state appear.&nbsp;
+
6. A list of these Agreements opens as search result in a tabular format. Enhance your search using wild cards as follows:
  
6. A list of these Agreements appears as search result in a tabular format. Enhance your search using wild cards as follows:&nbsp;
+
&nbsp;
 +
 
 +
&nbsp;
  
*
 
**...*: Type a search term in between the star characters. It shows existing items which include the respective search term.&nbsp;
 
**...: Prefix * to a search term. It shows existing items which end with this term.&nbsp; 
 
*...*: Suffix * to a search term. It shows existing items which start with this term.
 
*"...": &nbsp;Type a search term in double quotes. It shows existing items which include the search term.&nbsp;
 
*...(space)...: Type multiple search terms with space in between. It shows existing items which include the search terms.
 
  
 
=== Saving a Search ===
 
=== Saving a Search ===
Line 246: Line 348:
 
If you have the search criteria defined and need same search criteria repeatedly, it is advisable to '''save '''the search. For Configuring Saved Search in Salesforce, we need some of the Data Mapping which includes Salesforce Account and Opportunity Id (which is 18 digit of alphanumeric reference value). That means, if you are defining a mapping of Salesforce Opportunity with Contract Request, then in that contract request create a field/attribute which will hold the salesforce Opportunity id, in the same manner you can create for the account id reference. So create these required mapping to start with Saved Search.
 
If you have the search criteria defined and need same search criteria repeatedly, it is advisable to '''save '''the search. For Configuring Saved Search in Salesforce, we need some of the Data Mapping which includes Salesforce Account and Opportunity Id (which is 18 digit of alphanumeric reference value). That means, if you are defining a mapping of Salesforce Opportunity with Contract Request, then in that contract request create a field/attribute which will hold the salesforce Opportunity id, in the same manner you can create for the account id reference. So create these required mapping to start with Saved Search.
  
For example, after you map data, attribute like Opportunity ID can be mapped in ICM and Salesforce.
+
For example, after you map data, attribute like Opportunity ID can be mapped in ICI and Salesforce.
<div class="image-green-border">[[File:Working with saved searches2.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Working with saved searches3.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">To '''save''' the search:</div> <div class="image-green-border">
+
<div class="image-green-border">[[File:SF 13.PNG|620px|SF 13.PNG]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:SF 14.PNG|720px|SF 14.PNG]]</div> <div class="image-green-border">&nbsp;</div>  
1.&nbsp;'''Click''' the ''Save''&nbsp;[[File:Saved button image.jpg|RTENOTITLE]] &nbsp;icon. This opens the ''Save Search'' dialog box. Set the parameters for this Saved Search.&nbsp;
+
To '''save''' the search:
2. '''Type''' a name for the search. Use a name that you can easily associate with this search.&nbsp;<br/> <br/> '''Click '''''Yes ''to make it a global search, which means all users of the selected Security Groups and Organization units can view it. '''Select '''''No'' to save this search locally, which will not be visible to any other person than the person who is creating it.<br/> &nbsp; <div class="note-box">'''Note''': Only the Administrator can save global searches.</div>
+
3.&nbsp;'''Specify''' the Advanced parameters as follows:&nbsp;
+
  
[[File:Working with saved searches5.PNG|RTENOTITLE]]
+
1.&nbsp;'''Click''' the ''Save&nbsp;''icon. This opens the ''Save Search'' window. Set the parameters for this Saved Search.&nbsp;<br/> 2. '''Type''' a name for the search. Use a name that you can easily associate with this search.&nbsp;<br/> <br/> '''Click '''''Yes ''to make it a global search, which means all users of the selected Security Groups and Organization units can view it. '''Select '''''No'' to save this search locally, which will not be visible to any other person than the person who is creating it.
<div class="image-green-border">&nbsp;</div> <div class="image-green-border"><div class="note-box">'''Note''':&nbsp;A search defined as a Smart Link cannot be set as a Dashboard tile.&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; For a global search, the administrator needs to create a security group and give access to specific users. Only those users can see that Saved Search in the list and add it as a Dashboard tile.</div> </div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">You can also save your searches and use the saved search Uniform Resource Identifier (URI) in the ICM Endpoint Settings in Salesforce. You can create saved searches for the following fields that appear in ''Salesforce ICM Config Settings > ICM Endpoint Settings'':&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Working with saved searches4.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">Following is an example of creating a saved search for Contract Opportunity Search URI:&nbsp;</div>
+
<div class="note-box">'''Note''': Only the Administrator can save global searches.</div>  
<br/> 1. On the upper right corner of your ICM page, '''click''' [[File:Magnifying search.PNG|25x25px|Magnifying search.PNG]]. The Search page appears.&nbsp;<br/> 2.&nbsp;In the ''Please select Entities to search'' list, select the entity that you want to search such as Agreement or Contract Request and then '''type '''the entity that you want to display in the search text box. The relevant search results appear.&nbsp;<br/> 3.&nbsp;On the upper right corner of the search results, click&nbsp;[[File:Saved button image.jpg|RTENOTITLE]]&nbsp; &nbsp;to save your search. The Save Search dialog box appears. &nbsp;<br/> 4. In the Save search as box, type the name of the saved search as a URI such as SF_OPP_CR for a contract request, or SF_OPP_Contract for a contract request. &nbsp;<br/> Similarly, you can create&nbsp;saved searches for the remaining entities. The entity and field to filter will be different. &nbsp;
+
3.&nbsp;'''Specify''' the Advanced parameters as follows:
<div class="image-green-border">&nbsp;</div> <div class="image-green-border"><div class="note-box">'''Note''':&nbsp;For core ICM related configuration, refer to ICM admin guide.&nbsp;<br/> Within Salesforce, ICM will be accessible as per the ICM based User context so if there is anything which you need to control at the user end, please control the user settings from core ICM product.</div>
+
<div class="image-green-border">[[File:Working with saved searches5.PNG|720px|RTENOTITLE]]<br/> &nbsp;</div> <div class="note-box">'''Note''':&nbsp;A search defined as a Smart Link cannot be set as a Dashboard tile.&nbsp;For a global search, the administrator needs to create a security group and give access to specific users. Only those users can see that Saved Search in the list and add it as a Dashboard tile.</div>  
== <br/> Updating Saved Search Configuration&nbsp; ==
+
You can also save your searches and use the saved search Uniform Resource Identifier (URI) in the ICI Endpoint Settings in Salesforce. You can create saved searches for the following fields that are displayed&nbsp;in ''Salesforce ICI Config Settings > ICI Endpoint Settings'':&nbsp;
 +
<div class="image-green-border">[[File:SF 14.PNG|720px|SF 14.PNG]]</div> <div class="image-green-border">&nbsp;</div>  
 +
Following is an example of creating a saved search for Contract Opportunity Search URI:&nbsp;
  
With this feature, Salesforce administrator can map any of the entity level attribute for executing the Saved Search, provided it is created in ICM as per the attribute configured in Salesforce.&nbsp;<br/> If you do not configure the attribute in Salesforce, the Saved Search still executes based on the Salesforce record ID.&nbsp;
+
1. On the upper right corner of your ICI page, '''click'''&nbsp;''Search'' icon. The Search page opens.&nbsp;<br/> 2.&nbsp;In the ''Please select Entities to search'' list, select the entity that you want to search such as Agreement or Contract Request and then '''type '''the entity that you want to display in the search text box. The relevant search results open.&nbsp;<br/> 3.&nbsp;On the upper right corner of the search results, click ''Save''&nbsp;icon to save your search. The Save Search window is displayed. &nbsp;<br/> 4. In the Save search as box, type the name of the saved search as a URI such as SF_OPP_CR for a contract request, or SF_OPP_Contract for a contract request. &nbsp;<br/> Similarly, you can create&nbsp;saved searches for the remaining entities. The entity and field to filter will be different.
</div>  
+
<div class="note-box">'''Note''':&nbsp;For core ICI related configuration, refer to ICI admin guide.&nbsp;<br/> Within Salesforce, ICI will be accessible as per the ICI based User context so if there is anything which you need to control at the user end, please control the user settings from core ICI product.</div> <div class="image-green-border">&nbsp;</div>
 +
 
 +
 
 +
 
 +
== Agreement Lines Sub tab ==
 +
 
 +
Agreement Lines subtab is added for account object displaying the list of all the active product and services sold to the customer. The products displayed under agreement line sub tab are fetched via ICI saved searches.
 +
<div class="note-box">'''Note''': The agreement line subtab can only be accessed through sales instance.</div>
 +
&nbsp;
 +
<div class="image-green-border">[[File:8.2-Visibility of products and services.png|720px|8.2-Visibility of products and services.png]]</div>
 +
1.Click “Account”. The “Accounts” tab will open.
 +
 
 +
[[File:8.2-Visibility of products and services1.png|720px|8.2-Visibility of products and services1.png]]
 +
 
 +
2.&nbsp;List of all the customer accounts is displayed, click on the desired customer name. The Account details page for that customer opens.
 +
<div class="image-green-border">[[File:8.2-Visibility of products and services2.png|720px|8.2-Visibility of products and services2.png]]</div> <div class="image-green-border">&nbsp;</div>
 +
3.&nbsp;Click “Agreement Lines”. The Agreement Lines subtab will open, displaying list of products sold to the customer.
 +
<div class="image-green-border">[[File:8.2-Visibility of products and services3.png|720px]]</div>
 +
4.&nbsp;To view the list of all the products sold to the customer, click “View All”. The list of all the products and services sold to the customer will be displayed.
 +
<div class="image-green-border">[[File:8.2-Visibility of products and services4.png|720px]]</div> <div class="image-green-border">[[File:8.2-Visibility of products and services5.png|720px]]</div> <div class="image-green-border">&nbsp;</div> <div class="note-box">'''Note''': The “Agreement Lines” displays only active products and services from executed contracts.</div>
 +
&nbsp;
 +
 
 +
== Updating Saved Search Configuration&nbsp; ==
 +
 
 +
With&nbsp;this feature, Salesforce administrator can map any of the entity level attribute for executing the Saved Search, provided it is created in ICI as per the attribute configured in Salesforce.&nbsp;<br/> If you do not configure the attribute in Salesforce, the Saved Search still executes based on the Salesforce record ID.&nbsp;
 +
 
 +
&nbsp;
 +
 
 +
&nbsp;
 +
 
 +
== Configuring Global Search&nbsp; ==
 +
 
 +
Previously, there were 2 separate sub-tabs, 1 each for Contracts and Contract Requests, under the ICI tab within Salesforce. The previous Search page when rendered from within an iFrame inside Salesforce, gives the user a perception that they are working outside of Salesforce application.
 +
 
 +
With the SFDC experience enhancement, the user will have the ability to:
 +
 
 +
&nbsp;To configure the Global Search tab:
 +
<div class="image-green-border">[[File:SF 15.PNG|720px|SF 15.PNG]]</div> <div class="image-green-border">[[File:SF 16.png|720px|SF 16.png]]</div> <div class="image-green-border">[[File:SF 17.png|720px|SF 17.png]]</div>  
 
== Enabling Single Sign-On ==
 
== Enabling Single Sign-On ==
  
You need to setup single sign-on for Salesforce to work seamlessly with ICM. For more information about setting up single sign-on, refer [https://help.salesforce.com/articleView?id=sso_saml.htm&type=0 https://help.salesforce.com/articleView?id=sso_saml.htm&type=0]
+
You need to setup single sign-on for Salesforce to work seamlessly with ICI. For more information about setting up single sign-on, refer [https://help.salesforce.com/articleView?id=sso_saml.htm&type=0 https://help.salesforce.com/articleView?id=sso_saml.htm&type=0]
  
== Multiple Salesforce Instances ==
+
&nbsp;
  
With this feature, you can connect multiple Salesforce instances of your organization or organization groups to a single ICM instance. For using this feature, the user needs to create a new `Masterdata record which can be used to define the multiple Salesforce instances. The user needs to add the login details of the configured Salesforce instance machine configuration. Contact Dev Ops team for assistance.<br/> <br/> To support Multiple Salesforce instances, you need to add multiple records in Client App Org Reference Contract Type. If the Contract Type is not listed in the system, then it needs to be created.&nbsp;<br/> <br/> If the Client Org Reference Contract Type is not already created, create it using the following steps:&nbsp;<br/> <br/> To create a Masterdata record:&nbsp;<br/> <br/> 1.&nbsp;On the ''My Dashboard'' page, '''click '''''Configuration ''and then '''click''' ''Masterdata''. The Masterdata page appears<br/> 2.&nbsp;'''Click '''''Create Masterdata''. Provide relevant information in the respective fields and '''click '''''Next''. The ''Attributes'' page appears. Provide relevant information in the respective fields:
+
&nbsp;
  
&nbsp;[[File:Multiple Salesforce Instances1.PNG|RTENOTITLE]]
+
&nbsp;
  
 +
== Multiple Salesforce Instances ==
 +
 +
With this feature, you can connect multiple Salesforce instances of your organization or organization groups to a single ICI instance. For using this feature, the user needs to create a new `Masterdata record which can be used to define the multiple Salesforce instances. The user needs to add the login details of the configured Salesforce instance machine configuration. Contact Dev Ops team for assistance.<br/> <br/> To support Multiple Salesforce instances, you need to add multiple records in Client App Org Reference Contract Type. If the Contract Type is not listed in the system, then it needs to be created.&nbsp;<br/> <br/> If the Client Org Reference Contract Type is not already created, create it using the following steps:&nbsp;<br/> <br/> To create a Masterdata record:&nbsp;<br/> <br/> 1.&nbsp;On the ''My Dashboard'' page, '''click '''''Configuration ''and then '''click''' ''Masterdata''. The Masterdata page opens<br/> 2.&nbsp;'''Click '''''Create Masterdata''. Provide relevant information in the respective fields and '''click '''''Next''. The ''Attributes'' page opens. Provide relevant information in the respective fields:
 +
<div class="image-green-border">[[File:Multiple Salesforce Instances1.PNG|720px|RTENOTITLE]]</div>
 
3.&nbsp;Provide relevant information in the respective fields:&nbsp;
 
3.&nbsp;Provide relevant information in the respective fields:&nbsp;
 +
<div class="image-green-border">[[File:Table 6.PNG|720px|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="note-box">'''Notes''':&nbsp;While creating a new Contract Type, name it as Client Org Reference only. The naming convention must be followed exactly as given. ICI will not recognize and sync Contract Type which is created by any other name.<br/> &nbsp;<br/> After adding the Org Reference mapping in Client App Entity mapping and Cross-reference mapping, there will be an extra attribute where the user selects the Org for which that particular mapping is synced.<br/> <br/> After the Salesforce instance is configured, you can use that Reference Org to define Client App Entity Mapping and Client App Cross Reference mapping.<br/> <br/> If Client App Org Reference Contract Type is not installed, you need to create this Contract type, with exactly the same name and attributes. Refer this link for details.&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">In this way, Client Org Reference Contract Type can be used for multiple Salesforce instances.&nbsp;</div> <div class="image-green-border">&nbsp;</div>
 +
&nbsp;
  
[[File:Multiple Salesforce Instances2.PNG|RTENOTITLE]]
+
=== Viewing ICI Dashboard widgets in Salesforce&nbsp; ===
<div class="note-box">'''Notes''':&nbsp;While creating a new Contract Type, name it as Client Org Reference only. The naming convention must be followed exactly as given. ICM will not recognize and sync Contract Type which is created by any other name.<br/> &nbsp; &nbsp;&nbsp;<br/> After adding the Org Reference mapping in Client App Entity mapping and Cross-reference mapping, there will be an extra attribute where the user selects the Org for which that particular mapping is synced.<br/> &nbsp;<br/> After the Salesforce instance is configured, you can use that Reference Org to define Client App Entity Mapping and Client App Cross Reference mapping.<br/> <br/> If Client App Org Reference Contract Type is not installed, you need to create this Contract type, with exactly the same name and attributes. Refer this link for details.&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">In this way, Client Org Reference Contract Type can be used for multiple Salesforce instances.&nbsp;</div> <div class="image-green-border">&nbsp;</div>  
+
 
=== Creating a Contract Request from an Account&nbsp; ===
+
To configure and view ICI dashboard widgets:
 +
 
 +
1.&nbsp; '''Click''' Setup icon > “Edit Page”. The “Home” page dashboard opens in editable mode.
 +
<div class="image-green-border">[[File:Salesforce29.png|800px|Salesforce29.png]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">2.&nbsp;&nbsp; &nbsp;On the last widget on the Home page, '''click''' the plus “+” icon to add a widget.<br/> 3.&nbsp;&nbsp; &nbsp;'''Click''' “Visualforce” from the left pane.<br/> &nbsp;</div> <div class="image-green-border">[[File:Salesforce30.png|800px|Salesforce30.png]]</div>  
 +
4.&nbsp;&nbsp; &nbsp;'''Select''' the My Recent Activities widget option from the “Visualforce Page Name” dropdown.
 +
<div class="image-green-border">[[File:Salesforce31.png|600px|Salesforce31.png]]</div>  
 +
5.&nbsp;&nbsp; &nbsp;'''Uncheck''' the “Show Label” option to remove the Salesforce default header label on the widget.
 +
<div class="image-green-border">[[File:Salesforce32.png|360px|Salesforce32.png]]</div>  
 +
6.&nbsp;&nbsp; &nbsp;'''Click''' “Save” to save the configured widget.<br/> 7.&nbsp;&nbsp; &nbsp;Follow the above steps to add the “Performance Metrics” widget.
 +
<div class="image-green-border">[[File:Salesforce33.png|800px|Salesforce33.png]]</div>  
 +
Now, the ICI widgets “My Recent Activities” and “Performance Metrics” will be displayed on the Salesforce “Home” dashboard.
 +
<div class="image-green-border">[[File:Salesforce34.png|800px|Salesforce34.png]]b.&nbsp;&nbsp;</div>  
 +
&nbsp;
 +
 
 +
'''Viewing Notifications Feed'''
 +
 
 +
1.&nbsp;'''Go&nbsp;to&nbsp;'''the Salesforce&nbsp;''Home&nbsp;''page.&nbsp;
 +
<div class="image-green-border">[[File:SF 19.PNG|620px|SF 19.PNG]]&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">
 +
2. View the latest notifications in the live “Chatter” feed, and it can be sorted by “Latest Posts” or “My Recent Activity” will be displayed.
 +
 
 +
[[File:Salesforce35.png|800px|Salesforce35.png]]
 +
</div>
 +
&nbsp;
 +
 
 +
=== Simplified UX Actions in Grid ===
 +
<div class="image-green-border">
 +
The Icertis Experience for Salesforce already provides the capability for Salesforce users to perform agreement-related tasks from within Salesforce. ICI is now improving the user experience such that Salesforce users can perform their tasks more seamlessly by taking actions on agreements with fewer clicks than required earlier.
 +
 
 +
The user will now be able to view a contract record by double-clicking the row, instead of the earlier option of clicking the ''View'' hyperlink. They will be able to take ''Download, Assemble Contract'' and ''Send for Approval'' actions directly from the ''Action'' column of the Contract grid on Salesforce entity forms, without opening the agreement record. These actions will be displayed to the user based on the workflow state of the agreement.
 +
 
 +
'''1. Click''' on the ''Opportunities'' tab. The ''Opportunity'' home page opens.
 +
 
 +
'''2. Click''' on any&nbsp;''Opportunity ''link.
 +
 
 +
'''3. Click''' on the&nbsp;“Agreements or “Request” tab.
 +
<div class="note-box">'''Note:''' The agreement grid and corresponding actions can also be navigated through the global “Agreements” or “Requests” tab, in addition to the “Details” tab navigation.</div>  
 +
4.&nbsp;'''Scroll''' to the ''Icertis Contract Intelligence'' section.
 +
 
 +
'''5. Click''' on the View Details column to ''U''''pload, Assemble Contract'''''<b>, ''Request Review: Internal'', ''Request Review: External'', ''Send for Approval'' and&nbsp;''Download Document.''</b>
 +
 
 +
6. Double-click'''&nbsp;'''the row to view the Agreement'''.'''
 +
[[File:Salesforce36.png|720px|Salesforce36.png]] <div class="image-green-border">&nbsp;</div> '''&nbsp; '''
 +
=== Creating a Contract Request from an Account ===
  
 
You can create a Contract Request if your organization does not provide the privileges to create a contract directly.&nbsp;
 
You can create a Contract Request if your organization does not provide the privileges to create a contract directly.&nbsp;
<div class="image-green-border">[[File:Creating a Contract Request from an Account.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">To create a Contract Request from an account:</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">1.&nbsp;'''Log on''' to Salesforce using your ICM credentials.<br/> 2.&nbsp;'''Select''' ''ICM'' in the top right corner of your Salesforce page to use ICM through Salesforce.<br/> 3.&nbsp;'''Click''' ''Account'' in the top navigation, and '''click''' the ''Account'' for which you want to create a Contract Request.<br/> 4.&nbsp;On the ''Account Detail'' page, scroll down to the ''Icertis Contracts'' section.&nbsp;<br/> 5.&nbsp;'''Click '''''New Contract Request''. The ''Create Contract Request'' page appears in Salesforce. The options available on this page indicate the type of contract for which you are creating this request.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Creating a Contract Request from an Account2.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;<br/> 6.&nbsp;'''Select '''the ''Category'' and ''Request Type'' based on the request you are creating and '''click''' ''Next''.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Creating a Contract Request from an Account3.PNG|RTENOTITLE]]<br/> &nbsp;<br/> 7.&nbsp;'''Specify '''the details of the request on the various sections of this page.&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Creating a Contract Request from an Account4.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">8.&nbsp;'''Click '''''Next''. The ''Request Summary'' page appears. You can also '''click''' ''Save'' if you want to save the changes and create the request later.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Creating a Contract Request from an Account5.PNG|RTENOTITLE]]<br/> &nbsp;<br/> 9. '''Click''' ''Create Request''. The Accounts page appears showing the Contract Request you created in ''Draft ''state.<br/> 10. '''Click''' ''ICM'' in the top navigation bar and then click ''Contract Requests''. The Contract Request page appears and it shows the list of available requests.<br/> 11. '''Click''' ''View ''next to the Request you created. The ''Request Details'' page appears.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Creating a Contract Request from an Account6.PNG|RTENOTITLE]]</div> <div class="image-green-border"><br/> 12. Use the buttons in the table below to perform a desired action:</div> <div class="image-green-border">&nbsp;</div>
+
<div class="image-green-border">To create a Contract Request from an account:</div>  
[[File:Creating a Contract Request from an Account7.PNG|RTENOTITLE]]
+
1.&nbsp;'''Log on''' ''to Salesforce using your ICI credentials.''
 +
 
 +
2.&nbsp;'''Select''' ICI in the top right corner of your Salesforce page to use ICI through Salesforce.
 +
 
 +
3.&nbsp;'''Click''' ''Accounts'' in the top navigation bar, and click the Account for which you want to create a Contract Request.
 +
 
 +
[[File:Salesforce37.png|720px|Salesforce37.png]]
 +
 
 +
4. Click “Requests” tab, the Requests grid opens.
 +
 
 +
[[File:Salesforce38.png|720px|Salesforce38.png]]
 +
 
 +
5. Click “New Contract Request”. This opens the “Create Request” popup.
 +
 
 +
[[File:Salesforce39.png|720px|Salesforce39.png]]
 +
 
 +
6.&nbsp;&nbsp; &nbsp;Select the Category and Request Type based on the request you are creating and click Next. The Attributes page opens.
 +
 
 +
[[File:Salesforce40.png|720px|Salesforce40.png]]
 +
 
 +
7.&nbsp;&nbsp; &nbsp;Specify the details of the request on the various sections of this page and click “Next”,&nbsp;<br/> You can also click Save if you want to save the changes and create the request later.
 +
 
 +
[[File:Salesforce41.png|600px|Salesforce41.png]]
 +
 
 +
8.&nbsp;&nbsp; &nbsp;Click “Create Request”.
 +
 
 +
[[File:Salesforce42.png|600px|Salesforce42.png]]
 +
 
 +
The Contract Request is created and its Accounts “Details” page opens with a “Draft” state.
 +
 
 +
[[File:Salesforce43.png|600px|Salesforce43.png]]
 +
 
 +
9. Use the buttons in the table below to perform a desired action:
 +
<div class="image-green-border">[[File:Table 8.PNG|720px|RTENOTITLE]]</div> &nbsp;</div>
 +
&nbsp;
  
<br/> [[File:Creating a Contract Request from an Account8.PNG|RTENOTITLE]]
 
<div class="image-green-border">&nbsp;</div>
 
 
=== Creating a Contract from an Account ===
 
=== Creating a Contract from an Account ===
  
The process of creating a contract from ICM in Salesforce is dependent on the workflow that is implemented in your organization.&nbsp;
+
The process of creating a contract from ICI in Salesforce is dependent on the workflow that is implemented in your organization.&nbsp;
 +
<div class="image-green-border">To create a Contract from an Account:</div>
 +
1.&nbsp;'''Log on''' to Salesforce using your ICI credentials.
  
[[File:Creating a Contract Request from an Account.PNG|RTENOTITLE]]<br/> &nbsp;<br/> To create a Contract from an Account:
+
2.&nbsp;'''Select''' ''ICI'' in the top right corner of your Salesforce page to use ICI through Salesforce
  
1.&nbsp;'''Log on''' to Salesforce using your ICM credentials.<br/> 2.&nbsp;'''Select''' ''ICM'' in the top right corner of your Salesforce page to use ICM through Salesforce<br/> 3.&nbsp;''Click'' ''Accounts'' in the top navigation, and '''click''' the ''Account'' for which you want to create a contract.
+
3.&nbsp;'''Click''' ''Accounts'' in the top navigation bar, and click the ''Account'' for which you want to create a contract.
 +
<div class="image-green-border">[[File:Salesforce37.png|720px|Salesforce37.png]]</div> <div class="image-green-border">
 +
4. '''Click''' “Agreements” tab, the Agreements grid opens.
  
[[File:Creating a Contract from an Account1 new.PNG|RTENOTITLE]]<br/> &nbsp;<br/> 4.&nbsp;On the ''Account Detail'' page, scroll down to the ''Icertis Contracts'' section.<br/> '''Click''' ''New Contract''. This opens the ''Create Contract'' page in Salesforce.&nbsp;
+
[[File:Salesforce45.png|720px|Salesforce45.png]]
<div class="note-box">'''Note''': You can set the label of the buttons as required.</div>
+
[[File:Creating a Contract Request from an Account2.PNG|RTENOTITLE]]<br/> &nbsp;<br/> 5.&nbsp;Complete the details in the sections below and '''click''' ''Next''.
+
  
'''Contract Type Details'''
+
5. '''Click''' “New Contract”. This opens the “Create Agreement” popup.
  
Enter the following information in this section:
+
[[File:Salesforce15.png|720px|Salesforce15.png]]
  
[[File:Creating a contract from an account6.PNG|RTENOTITLE]]
+
6. Complete the details in the sections in the popup, and '''click''' Next.
 +
 
 +
[[File:Salesforce47.png|720px|Salesforce47.png]]
 +
 
 +
'''Attributes'''
 +
 
 +
7. This section contains the attributes that the primary owner selected while creating the Contract Type for the agreement, which you are creating. You can also save the details at any stage and return to this page to complete the agreement later. The attributes displayed in this section vary based on the Contract Type you select.
 +
 
 +
[[File:Salesforce48.png|720px|Salesforce48.png]]
 +
 
 +
'''Template'''
 +
 
 +
&nbsp;This section shows the templates that you created for the selected Contract Type. This section opens only if you select Own type of paper to create the agreement. Select the template from the list.
 +
 
 +
8. '''Click''' Next.
 +
 
 +
[[File:Salesforce49.png|720px|Salesforce49.png]]
 +
 
 +
'''Verify'''
 +
 
 +
This is the final step in the agreement creation process. The details in this section open based on the attributes and sections you used to create this agreement.&nbsp;
 +
 
 +
[[File:Salesforce50.png|720px|Salesforce50.png]]
 +
 
 +
&nbsp;You can perform the following actions on this page:
 +
 
 +
•&nbsp;&nbsp; &nbsp;Click Previous to go back and make any changes to the agreement. Click Next to return to this section after making the required changes.<br/> •&nbsp;&nbsp; &nbsp;Click Create to create the Agreement. After the agreement is created it is not visible to all users until it is published by its primary owner.<br/> •&nbsp;&nbsp; &nbsp;Click Create and Publish to create and publish the agreement. After the agreement is published it becomes visible to other users and a Draft watermark opens on the agreement in all states until it is approved by the designated approver.<br/> •&nbsp;&nbsp; &nbsp;Click Create and Send for Approval to create and send the agreement for approval. The agreement is sent to the approvers that are set by rule for the Contract Type selected for this agreement.<br/> •&nbsp;&nbsp; &nbsp;Click Cancel to stop the agreement creation process. A discarded agreement is no longer available in ICI. You can discard the agreement from any section while creating the agreement. After the Agreement is created in Salesforce, it is available in ICI in the Draft state. You can send the agreement for approval through Salesforce, however, the approve and reject actions on the agreement can only happen through ICI.
 +
</div>
 +
&nbsp;
  
'''Attributes''' This section contains the attributes that the primary owner selected while creating the Contract Type for the agreement, which you are creating. You can also save the details at any stage and return to this page to complete the agreement later. The attributes displayed in this section vary based on the Contract Type you select.
 
<div class="image-green-border">[[File:Creating a Contract from an Account3.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">Below is the description of some of the attributes.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Creating a Contract Request from an Account9.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">'''Template'''</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">This section shows the templates that you created for the selected Contract Type. This section appears only if you select Own type of paper to create the agreement. Select the template from the list.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Creating a Contract from an Account4.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">'''Verify'''</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">This is the final step in the agreement creation process. The details in this section appear based on the attributes and sections you used to create this agreement.&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Creating a Contract from an Account5.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">You can perform the following actions on this page:&nbsp;</div>
 
*'''Click '''''Previous'' to go back and make any changes to the agreement. '''Click '''''Next'' to return to this section after making the required changes.
 
*'''Click '''''Create'' to create the Agreement. After the agreement is created it is not visible to all users until it is published by its primary owner.
 
*'''Click''' ''Create and Publish'' to create and publish the agreement. After the agreement is published it becomes visible to other users and a Draft watermark appears on the agreement in all states until it is approved by the designated approver.
 
*'''Click''' ''Create and Send for Approval'' to create and send the agreement for approval. The agreement is sent to the approvers that are set by rule for the Contract Type selected for this agreement.
 
*'''Click''' ''Discard'' to stop the agreement creation process. A discarded agreement is no longer available in ICM. You can discard the agreement from any section while creating the agreement.
 
<div class="image-green-border">After the Agreement is created in Salesforce, it is available in ICM in the Draft state. You can send the agreement for approval through Salesforce, however, the approve and reject actions on the agreement can only happen through ICM.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">&nbsp;</div>
 
 
=== Adding Amendment to a Contract ===
 
=== Adding Amendment to a Contract ===
<div class="image-green-border">&nbsp;</div> <div class="image-green-border">After the Contract is executed, it cannot be edited. However, the primary owner can add an amendment to the Contract that is in the ''Executed'' state only.</div> <div class="image-green-border">Amendments are added to a Contract due to following reasons:</div>
+
 
 +
After the Contract is executed, it cannot be edited. However, the primary owner can add an amendment to the Contract that is in the ''Executed'' state only.<br/> Amendments are added to a Contract due to following reasons:
 +
 
 
*Payment terms of the Contract have changed.  
 
*Payment terms of the Contract have changed.  
 
*Scope of work in the Contract has changed.  
 
*Scope of work in the Contract has changed.  
 
*The terms and conditions of the Contract have changed due to the introduction of the new regulation.  
 
*The terms and conditions of the Contract have changed due to the introduction of the new regulation.  
  
To add an amendment to a Contract:
+
To add an amendment to a Contract:<br/> 1.&nbsp;'''Log on''' to Salesforce with your credentials.<br/> 2.&nbsp;'''Click''' ''ICI'' in the top navigation. The ''ICI'' page showing the list of Contracts and Contract Requests opens.&nbsp;<br/> 3.&nbsp;Select and open the Contract that is in the &nbsp;''Executed'' state. The ''Contract'' page opens.<br/> 4.&nbsp;'''Click''' ''Add Amendment'' on the ''Contract'' page. The ''Add Amendment'' page opens.<br/> 5.&nbsp;Make the required changes to the Contract on the ''Initial Attributes'' tab and click ''Next''.&nbsp;<br/> 6.&nbsp;Click ''Create''. The ''Amendment'' moves to the ''Draft'' state and opens the ''Amendment Details'' page.
<div class="image-green-border">1.&nbsp;'''Log on''' to Salesforce with your credentials.<br/> 2.&nbsp;'''Click''' ''ICM'' in the top navigation. The ''ICM'' page showing the list of Contracts and Contract Requests opens.&nbsp;<br/> 3.&nbsp;'''Select '''and open the Contract that is in the&nbsp;''Executed'' state. The ''Contract'' page appears.<br/> 4.&nbsp;'''Click''' ''Add Amendment'' on the ''Contract'' page. The ''Add Amendment'' page appears.<br/> 5.&nbsp;'''Make''' the required changes to the Contract on the ''Initial Attributes'' tab and '''click''' ''Next''.&nbsp;<br/> 6.&nbsp;'''Click''' ''Create''. The ''Amendment'' moves to the ''Draft'' state and opens the ''Amendment Details'' page.<br/> 7.&nbsp;You can perform the following actions on the ''Amendment Details'' page:</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Adding Amendment to a Contract.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">After adding an Amendment, it goes through the similar flow of Agreement from Draft till execution.&nbsp;</div> <div class="image-green-border">&nbsp;</div>
+
 
 +
7.&nbsp;You can perform the following actions on the ''Amendment Details'' page:'
 +
<div class="image-green-border">[[File:Adding Amendment to a Contract.PNG|720px|RTENOTITLE]]</div> <div class="image-green-border">[[File:Salesforce51.PNG|720px|Salesforce51.PNG]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Salesforce52.png|720px|Salesforce52.png]]</div>
 +
After adding an Amendment, it goes through the similar flow of Agreement from Draft till execution.&nbsp;
 +
 
 
=== Creating a Contract Request from an Opportunity ===
 
=== Creating a Contract Request from an Opportunity ===
  
You can create a Contract Request if your organization does not provide the privileges to create a contract from ICM in Salesforce.&nbsp;
+
You can create a Contract Request if your organization does not provide the privileges to create a contract from ICI in Salesforce.&nbsp;To create a Contract Request from an Opportunity:&nbsp;<br/> 1. Log onto Salesforce using your ICI credentials.&nbsp;<br/> 2.&nbsp;'''Select '''''ICI'' in the top right corner of your Salesforce page to use ICI through Salesforce.<br/> 3.&nbsp;'''Click''' ''Opportunities'' in the top navigation, and click the ''Opportunity '' for which you want to create a Contract Request.
 +
<div class="image-green-border">
 +
4. '''Click''' “Requests” tab, the Requests grid opens.
  
To create a Contract Request from an Opportunity:&nbsp;
+
5. '''Click''' “New Contract Request”. This opens the “Create Request” popup.
  
1. '''Log on''' to Salesforce using your ICM credentials.&nbsp;<br/> 2.&nbsp;'''Select''' ''ICM'' in the top right corner of your Salesforce page to use ICM through Salesforce.<br/> 3.&nbsp;'''Click''' ''Opportunities'' in the top navigation, and '''click''' the ''Opportunity ''for which you want to create a Contract Request.
+
6.&nbsp;'''Select''' the Category and Request Type based on the request you are creating and click Next. The Attributes page opens.
<div class="image-green-border">[[File:Creating a Contract Request from an opportunity.PNG|RTENOTITLE]]</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">4.&nbsp;On the ''Opportunity Detail'' page, scroll down to the ''Icertis Contracts'' section.</div> <div class="image-green-border">5.&nbsp;'''Click '''''New Contract Request''. The ''Create Contract Request'' page appears in Salesforce. The options available on this page indicate the type of contract for which you are creating this request.<br/> 6.&nbsp;The rest of the process to create a Contract Request from an Opportunity is same as Creating a Contract Request from an Account.&nbsp;</div> <div class="image-green-border">&nbsp;</div>  
+
 
 +
7.&nbsp;Specify the details of the request on the various sections of this page and '''click''' “Next”.<br/> You can also '''click''' Save if you want to save the changes and create the request later.
 +
 
 +
8.&nbsp;&nbsp; &nbsp;'''Click''' “Create Request”.&nbsp;
 +
 
 +
The Contract Request is created and its Accounts “Details” page opens with a “Draft” state.<br/> &nbsp;
 +
</div>  
 
=== Creating a Contract from an Opportunity ===
 
=== Creating a Contract from an Opportunity ===
  
The process of creating a contract from ICM in Salesforce is dependent on the workflow implemented in your organization.&nbsp;
+
The process to create a contract from an Opportunity is same as creating a contract from an Account.
  
To create a Contract from an Opportunity:&nbsp;<br/> <br/> 1.&nbsp;'''Log on''' to Salesforce using your ICM credentials.&nbsp;<br/> 2.&nbsp;'''Select''' ''ICM'' in the top right corner of your Salesforce page to use ICM through Salesforce.<br/> 3.&nbsp;'''Click''' ''Opportunities'' in the top navigation, and click the Opportunity for which you want to create a contract.
+
&nbsp;
  
[[File:Creating a Contract from an opportunity.PNG|RTENOTITLE]]
+
&nbsp;
  
4.&nbsp;On the ''Opportunity Detail'' page, scroll down to the ''Icertis Contracts'' section.&nbsp;<br/> 5.&nbsp;'''Click''' ''New Contract''. The ''Create Contract'' page appears in Salesforce. The options available on this page indicate the type of contract for which you are creating this request.<br/> <br/> The rest of the process to create a Contract Request from an Opportunity is same as Creating a Contract from an Account.&nbsp;
+
=== Creating a Contract Request from a Quote ===
  
=== Creating a Contract Request from a Quote&nbsp; ===
+
The process to create a Contract Request from a&nbsp;Quote is same as creating a Contract Request from an Opportunity or Account.&nbsp;<br/> &nbsp;
 +
 
 +
&nbsp;
  
You can create a Contract Request if your organization does not provide the privileges to create a contract from ICM in Salesforce.&nbsp;<br/> <br/> To create a Contract Request from a Quote:<br/> <br/> 1.&nbsp;'''Log on''' to Salesforce using your ICM credentials.&nbsp;<br/> 2.&nbsp;'''Select''' ''ICM'' in the top right corner of your Salesforce page to use ICM through Salesforce.<br/> 3.&nbsp;'''Click''' Quotes in the top navigation, and '''click '''the Quotes for which you want to create a Contract Request.<br/> &nbsp;
 
<div class="image-green-border">[[File:Creating a Contract Request from a Quote.PNG|RTENOTITLE]]</div> <div class="image-green-border"><br/> 4.&nbsp;On the ''Quote Detail'' page, scroll down to the ''Icertis Contracts'' section.&nbsp;<br/> 5.&nbsp;'''Click''' ''New Contract Request''. The ''Create Contract Request'' page appears in Salesforce. The options available on this page indicate the type of contract for which you are creating this request.<br/> 6.&nbsp;The rest of the process to create a Contract Request from a Quote is same as Creating a Contract Request from an Account.</div> <div class="image-green-border">&nbsp;</div>
 
 
=== Creating a Contract from a Quote ===
 
=== Creating a Contract from a Quote ===
  
The process of creating a contract from ICM in Salesforce is dependent on the workflow implemented in your organization.&nbsp;
+
The process to create a Contract from the Quote is same as Creating a Contract from an Opportunity or&nbsp;Account.&nbsp;
 +
 
 +
&nbsp;
 +
 
 +
=== Configuring Auto-creation of Contracts and Tasks in Salesforce ===
 +
 
 +
With this release, the contract creation process has been automated based on Opportunity or Quote status, thus increasing the productivity of Salesforce users.<br/> Salesforce Administrators can now:
 +
 
 +
*Configure the Opportunity or Quote status which can automatically trigger the contract creation.
 +
*Configure the contract type which should be used to create the contract based on data from an Opportunity or Quote.
 +
*Define the Type of Paper to be used as Own or Third Party.
 +
*Configure automated contract creation or automated task creation to initiate the contract creation process:&nbsp;
 +
**For auto creation of contracts, the ICI Experience for Salesforce will determine the dependencies for the contract. For example, if the opportunity is for an extension, the existing master agreement for the account will be identified and an appropriate contract type such as an order form will be selected and associated with it.
 +
**For auto creation of tasks, Salesforce users will be able to create a contract using a single button click that will assemble all necessary documents for the type of contract to be created.&nbsp; 
 +
 
 +
&nbsp;
 +
 
 +
==== Configuring Logs ====
 +
 
 +
1. Go to&nbsp;the ''ICI Configuration'' tab in Salesforce. The ''ICI Endpoint Configuration'' page opens.
 +
 
 +
2. Enter ''Duration for logs in days'', for example 60.0 days. The number of days for which the logs will be preserved can be defined here.
 +
<div class="image-green-border">[[File:SF 21.png|720px|SF 21.png]]</div>
 +
3. Set the ''Logging Level'':<br/> a. "Log Error'': Only errors will be logged.''<br/> b. "Log Info'': Only information will be logged, for example request and response.''<br/> c. "Log Always'': Errors and information will be logged.''
 +
 
 +
&nbsp;
 +
 
 +
 
 +
== Displaying validations when uploading documents via Salesforce related contracts grid ==
 +
 
 +
To avoid any unwanted file from being uploaded and to avoid any potential risk for customer business, validations have been put in place for the following issues:
 +
 
 +
*Invalid file types
 +
*Validation when uploading an older version of the agreement document
 +
*Add/remove/modify content control and upload
 +
*Association added/modified/deleted as file/table and for the differences
 +
*Missing mandatory/parent clause, clause modified/removed/added
 +
*Incorrect format for the tagged attributes
 +
*Invalid documents
 +
*Reuploading same documents
 +
*Virus scan
 +
*Invalid lookup values
 +
 
 +
1. On the Opportunities page, navigate to the “Action” column in the contracts related list (such as “Agreements” or “Requests”).
 +
<div class="image-green-border">[[File:Salesforce55.png|720px|Salesforce55.png]]</div>
 +
'''2. Click '''the actions dropdown arrow. The actions available for the corresponding contract will be displayed.
 +
<div class="image-green-border">'''3. Click '''the “Upload Document” icon. The Upload Document popup window is displayed.</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">[[File:Salesforce57.png|720px|Salesforce57.png]]</div>
 +
'''4. Click''' “Select File”. The browse file popup is displayed.
 +
 
 +
'''5. Select '''the document to be uploaded.
 +
 
 +
'''6. Click '''“Upload” or “Upload and Submit”. The corresponding validation will be displayed depending on the document you are trying to upload. For example, “Document is exactly same as previous document. Would you like to continue with the upload?”&nbsp;
 +
<div class="image-green-border">[[File:Salesforce58.png|720px|Salesforce58.png]]</div>
 +
Validations are also displayed:
 +
 
 +
*For older document versions&nbsp;
 +
*If differences are found in the uploaded document.  
 +
*If any errors are found in the document or the document itself is invalid.
 +
 
 +
&nbsp;
 +
 
 +
 
 +
 
 +
 
 +
== Revamping ICI Salesforce User Interface&nbsp; ==
 +
 
 +
=== Agreement Sub Tabs&nbsp; ===
 +
 
 +
*Details&nbsp;
 +
*Associations&nbsp;
 +
*Amendments&nbsp;
 +
*Collaborations&nbsp;
 +
*Note&nbsp;
 +
*Team&nbsp;
 +
 
 +
'''Details Sub Tab''':&nbsp;Details subtab displays the agreements details overview.
 +
<div class="image-green-border">[[File:8.2-RevampingSFDC.png|720px|8.2-RevampingSFDC.png]]</div>
 +
'''Associations Sub Tab''': The associations sub displays all the associations linked to an agreement, with hyperlink to associations details added in first column. Click the association name to view association details.
 +
<div class="image-green-border">[[File:8.2-RevampingSFDC1.png|720px|8.2-RevampingSFDC1.png]]</div>
 +
'''Amendments Sub Tab''': Amendments sub tab gives ability to preview document using the down arrow button present at the right and then click “Preview Document” option.
 +
 
 +
[[File:8.2-RevampingSFDC2.png|720px|8.2-RevampingSFDC2.png]]
 +
 
 +
After clicking “Preview Document” the “Preview Document” dialogue box pops up.
 +
 
 +
[[File:8.2-RevampingSFDC3.png|720px|8.2-RevampingSFDC3.png]]
 +
 
 +
Collaboration Sub Tab: The Collaboration sub tab displays topics and messages added for collaboration. To create a new topic
 +
 
 +
1.&nbsp;Click on “New Topic” on Collaboration sub tab. “Create a New Topic” dialog box will open.
 +
<div class="image-green-border">[[File:8.2-RevampingSFDC4.png|720px|8.2-RevampingSFDC4.png]]</div>
 +
2.&nbsp;Select the participants by clicking on the “Add Participants” icon present right of the select user box.
 +
<div class="image-green-border">[[File:8.2-RevampingSFDC5.png|720px|8.2-RevampingSFDC5.png]]</div>
 +
3.&nbsp;The “Select Participants” dialogue box will open. Select the required participants and click “Add”.
 +
<div class="image-green-border">[[File:8.2-RevampingSFDC6.png|720px|8.2-RevampingSFDC6.png]]</div>
 +
4.&nbsp;The added users will be displayed inside “Selected Users” box. Add a “Subject” and a “Message” and click on “Create”.
 +
<div class="image-green-border">[[File:8.2-RevampingSFDC7.png|720px|8.2-RevampingSFDC7.png]]</div>
 +
5.&nbsp;New topic will be created under collaboration.
 +
 
 +
'''Note Sub Tab''': To add a new note.
 +
 
 +
1.Click down arrow button present right of the note heading in the right scroll pane. The “Add Note” dialog box will open.
 +
<div class="image-green-border">[[File:8.2-RevampingSFDC8.png|500px|8.2-RevampingSFDC8.png]]</div>
 +
2.&nbsp;Enter the note and click “Add”.
 +
<div class="image-green-border">[[File:8.2-RevampingSFDC9.png|600px|8.2-RevampingSFDC9.png]]</div>
 +
3.&nbsp;To view all the notes, click “View All” button at the bottom of the notes box. The “View All” page will open.
 +
<div class="image-green-border">[[File:8.2-RevampingSFDC10.png|500px|8.2-RevampingSFDC10.png]]</div>
 +
4. User can “Search”, “Manage” and “Add Note” from the “View all” notes page.
 +
<div class="image-green-border">[[File:8.2-RevampingSFDC11.png|720px|8.2-RevampingSFDC11.png]]</div>
 +
'''Teams Sub Tab''': To add a new team member&nbsp;
 +
 
 +
1.&nbsp;Click down arrow button present right of the Teams heading in the right scroll pane. The “Add Team Member” dialog box will open.
  
To create a Contract from a Quote:<br/> &nbsp;<br/> 1.&nbsp;'''Log on''' to Salesforce using your ICM credentials.&nbsp;<br/> 2.&nbsp;'''Select''' ''ICM'' in the top right corner of your Salesforce page to use ICM through Salesforce.<br/> 3.&nbsp;'''Click''' ''Quotes'' in the top navigation, and '''click''' the Quotes for which you want to create a contract.
+
[[File:8.2-RevampingSFDC12.png|500px|8.2-RevampingSFDC12.png]]
  
[[File:Creating a Contract Request from a Quote.PNG|RTENOTITLE]]
+
2.&nbsp;Select the role from “Select Role” dropdown.
 +
<div class="image-green-border">[[File:8.2-RevampingSFDC13.png|600px]]</div>
 +
3.&nbsp;Set the “Step Number” if applicable, select the desired users.
 +
<div class="image-green-border">[[File:8.2-RevampingSFDC14.png|600px]]</div>
 +
4.&nbsp;Add a note if required, click “Add”. The team member will be added.
  
4.&nbsp;On the ''Quote Detail'' page, scroll down to the ''Icertis Contracts'' section.&nbsp;<br/> 5.&nbsp;'''Click''' ''New Contract''. The Create Contract page appears in Salesforce. The options available on this page indicate the type of contract for which you are creating this request.<br/> <br/> The rest of the process to create a Contract from a quote is the same as Creating a Contract from an Account.&nbsp; &nbsp;
+
5. To view all the team members, click “View All” button at the bottom of the Teams box. The “View All” page will open.
<div class="image-green-border">&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">&nbsp;</div> <div class="image-green-border">&nbsp;</div> </div> <div class="image-green-border">'''Related Topics:'''&nbsp;[[Agreement_Management|Agreement Management]] |&nbsp; [[Configuration|Configuration]]&nbsp;| [[Integrations|Integrations]] |&nbsp;[[Icertis_Adapter_for_Coupa_Integration|Icertis Adapter for Coupa Integration]]&nbsp;| [[Using_Adobe_Sign|Using Adobe Sign]]&nbsp;|&nbsp;[[Using_DocuSign|Using DocuSign]]</div>
+
<div class="image-green-border">[[File:8.2-RevampingSFDC15.png|600px]]</div>  
 +
6.&nbsp;User can “Search”, “Manage” and “Add Team Member” from the “View all” Teams page.
 +
<div class="image-green-border">[[File:8.2-RevampingSFDC16.png|800px]]</div>

Latest revision as of 14:29, 4 September 2022

Contents

Salesforce

Purpose

The purpose of this Wiki is to document the process of:

  • Configuring ICI in Salesforce.
  • Performing Salesforce related configuration in ICI for mapping data entities and saved searches.

It also describes the process of using the Icertis Experience for Salesforce with the standard scenarios.

The document is primarily intended for:

  • Administrator users who configure Icertis Experience for Salesforce on Salesforce.com.
  • ICI Administrator Users who work on ICI Side Configuration.
  • Other users who work with Agreements.

Prerequisites

  • The user must have an account on Salesforce and ICI.
  • Icertis CLM must be installed on Salesforce.com from Salesforce AppExchange. It is compatible with Group, Professional, Enterprise, Unlimited, Force.com Developer and Performance Editions.
  • The user must have admin privileges for ICI and Salesforce in case the user is configuring ICI on Salesforce. 

Overview of Icertis Experience for Salesforce 

Icertis Experience for Salesforce is a native Salesforce application that allows you to access the full suite of ICI functionality from Salesforce, including the following capabilities:

  • Manage end-to-end contract lifecycle from the familiar Salesforce platform.
  • Create and edit Contract Requests with pre-populated data from Salesforce objects.
  • Track contract progress and status updates within Salesforce.
  • View contract notifications as part of chatter feed messages.
  • Execute actions like Lock/Unlock and Hold/Unhold on Salesforce agreements and contract requests.
  • Access and view “Opportunity”, “View Quote”, and “View Account” pages.
  • See and conduct Advanced searches within Salesforce iframe.
  • Automatically transfer and synchronize data between Salesforce objects and ICI.
  • Map Salesforce objects (standard and custom) with ICI entities.
Salesforce1.png

ICI and Salesforce integration is required to port data from ICI to Salesforce. This integration avoids the need for re-entering the data manually in Salesforce which you have already created in ICI. 

To use ICI from within Salesforce:

  • The ICI sections must be embedded in the Salesforce pages.
  • After logging on to Salesforce, select ICI in the top navigation bar  of the Salesforce page to use ICI through Salesforce.

Icertis Experience for Salesforce has the following key concepts:

  • Account is a label for business. It is a company or a business entity, you might already be working with, or one that you hope to work with. In simple words, an Account is an actual business or company.
Salesforce59.PNG
  • Opportunity is a pending deal with a monetary value associated with it. It helps to track the pending deals and sales.
Salesforce60.PNG
  • Quote is the data showing the proposed prices for the products or services. Quotes can be created by using the data that is saved in the Opportunities and shared with the prospective customers. Every opportunity can have multiple associated quotes linked to it.
Salesforce61.PNG

After integrating ICI with Salesforce, you can do the following contract management tasks in Salesforce:

  • Create and edit a Contract Request from an existing Account.
  • Create and edit a Contract Request from an existing Opportunity.
  • Create and edit a Contract Request from an existing Quote.
  • Create and edit a Contract from an Account when a prospective sales lead is qualified and a corresponding account is created.
  • Create and edit a Contract from an existing Opportunity.
  • Create and edit a Contract from an existing Quote.

 

Salesforce Side Configuration

Prerequisites

  • You must have a Salesforce account. 
  • You must have administrator privileges to install ICI in Salesforce.
  • You must have ICI administrator privileges to configure ICI in Salesforce.

Compatibility

ICI is compatible with the following editions of Salesforce:

  • Professional
  • Enterprise
  • Unlimited
  • Developer
  • Performance

For more information about the different editions of Salesforce, refer to: 
https://help.salesforce.com/articleView?id=overview_edition.htm&type=0 

Installing ICI in Salesforce

To install ICI in Salesforce:

1. Log on to Salesforce.
2. Open a new browser instance and go to Salesforce AppExchange to download the ICI application.

RTENOTITLE
 
3. Click Get It Now. This opens a new screen having two options:
  • Log in to AppExchange: Logon to AppExchange using your Salesforce credentials to proceed with the installation.
  • I don’t have a login: Install ICI in Salesforce as a guest user.
RTENOTITLE
 
4. Choose Log into AppExchange. This presents the following options:
  • Install in production
  • Install in Sandbox
RTENOTITLE
 
5. Choose Install in production and select the Terms and Conditions checkbox.
 
RTENOTITLE
 
6. Choose one of the applicable options:
  • Install for Admins only: install ICI for Salesforce Administrators who can install ICI in Salesforce.
  • Install for All Users: install ICI for all users of Salesforce.
  • Install for Specific Profiles: install ICI for specific profiles only.
7. Perform Configuring ICI EndPoint.
 

Creating and Managing the Canvas App

Creating the Canvas App

Follow these steps to create a Canvas App: 

1. Click Setup icon > “Setup”.
2. Click “Platform Tools” > “Apps” > “App Manager”. 

Salesforce5.png
 
3. Click on “New Connected App”.
 
Salesforce6.png
 
4. In the Connected App Name field, type the name of the Canvas App.
5. Accept the default API Name. This is the internal name of the Canvas App and you cannot change the name after saving it.
6. In the Contact Email field, type your valid email address.
7. In the Logo Image URL field, type the Logo URL that you want to provide.
8. In the Icon URL field, type the Icon URL that you want to provide.
 
Salesforce7.png
 
9. In the API (Enable OAuth Settings) section select the Enable OAuth Settings field.
10. In the Callback URL field, type your Callback URL
11. In the Selected OAuth Scopes field, select Full Access.
 
Salesforce8.png

12. In the Canvas App Settings section, select Canvas.
13. In the Canvas App URL field, type the application URL that you want to sync with Salesforce. This is the application URL, which is integrated with Salesforce.
14. In the Access Method field, select Signed Request (Post)
15. In the Locations field, select Visualforce Page.
 
Salesforce9.png
 
16. Click Save.
 
Managing the Canvas App
 
To create a Canvas App:

1.  Click Setup icon > “Setup”.
2.  Under “Platform Tools” > “Apps” > “Connected Apps” click “Manage Connected Apps”.

Salesforce10.png

3.  Click “Edit”.

Salesforce11.png

4. In the Permitted Users field, select Admin approved users are pre-authorized so that other ICI users cannot view the Canvas App until they are provided permissions. Click OK in the
pop-up message that opens. 
 
Note: If you select the All Users may self-authorize option in the Permitted Users field, other ICI users can see the Canvas App, but they would need to approve or deny access to it. 

RTENOTITLE

5. Click Save.

Now, define who can access your Canvas App by using profiles and permission sets. 
To understand the following example, consider that you want to give access to the System Administrator profile. 

1. In the Profiles related list, click Manage Profiles
2. Select the System Administrator profile and click Save.
 
Salesforce12.png
 

Configuring ICI EndPoint

You can perform ICI EndPoint Configuration only after you have installed Salesforce ICI from AppExchange. 

RTENOTITLE
 
Follow these steps to configure ICI EndPoint:
 
1. Click ICI Configuration in the top navigation bar by logging on to the ICI App in Salesforce on ICI App Home page. ICI EndPoint Configuration page opens.
2. Provide relevant information in the respective fields:
 
RTENOTITLE
RTENOTITLE

Creating a Field Set 

The Field set are fields that have been grouped together for creating the Field Set. For example, Opportunity name, Close Date, Opportunity Owner etc. A user with Administrator privileges can create or edit a Field Set. 

To create a Field Set: 

1. Click the Settings icon on the Settings page, and then click Setup. The Setup page opens.

RTENOTITLE

2. Click Object Manager. The Object Manager page opens. 

RTENOTITLE

3. Enter the entity name in the Quick Find box to search for the entity that you want to create the Field Set. For example, Opportunity.

RTENOTITLE

4. Click an Opportunity from the filtered list. The respective Opportunity page opens.

RTENOTITLE

5. Click Field Sets in the left navigation pane. The Field Sets page opens.

RTENOTITLE

6. Click New on the Field Sets tab. The New Field Set page opens.

RTENOTITLE

7. Enter the description for the following fields on the New Field Set page.

  • Field Set Label: The name for the Field Set. 
  • Field Set Name: This is auto-populated based on the Field Set label above.
  • Where is this used? : A brief description of the Salesforce pages where the Field Set will be used, and for what purpose.
RTENOTITLE

8. Drag and drop the Fields from the Quick Find section to the In the Field Set section to add the Fields to the Field Set.

9. Click Save to save the Field Set you created. 

Viewing the Fields in Salesforce

The Fields added in the Field Set can be viewed when creating a Contract from Salesforce using an Account, Opportunity or Quote. 

To view the Fields: 

1. Click Opportunities on the Home page in Salesforce. The Opportunities page opens displaying the list of Opportunities.

Salesforce13.png

2. Click the Opportunity from which you want to create a Contract. The Opportunity Details page opens.

Salesforce14.png

3. Click New Contract in the Icertis Contracts section. The Create page opens displaying the details to be entered for creating the Contract.

Salesforce15.png
4. Select the following on Create page. 
  • Category: Select the Category from this dropdown. For example, Default. 
  • Contract Type Name: Select the Contract Type based on which you want to create the Contract. For example, SFMSA. 
  • Type of Paper: Select Own if you want to use the system generated Template. Select Third Party if you want to upload and use your own Template.
Salesforce16.png

5. Click Next. The Attributes page opens showing the list of Fields added in the Field Set. For example, Opportunity Id, Opportunity Name.

Salesforce17.png

Note: After the Contract is created in Salesforce, it is displayed in ICI along with the Fields added in the Field Set.

Salesforce18.png
 

Setting up a new Remote Site (whitelisting of ICI instance)

Adding a remote site or whitelisting the ICI domain is an optional step. The Application automatically creates or adds the remote site settings but if the application does not create remote site automatically, follow the steps below to create remote site settings. You can view added remote site by navigating to Setup, Remote Site Settings and search for ICI URL, which you added by following the steps in the earlier section.

You need to add your ICI Application URL in Salesforce for whitelisting. Salesforce can access only whitelisted URLs. 
To setup a new remote site: 
 
1. Click Setup in the upper right corner of your page. The Setup page opens. 
2. Click Security Controls in the Administer menu in the left pane and then click Remote Site Settings. Alternatively, you can type Remote Site Settings in the Quick Find/Search box. As you type the text, the relevant search result opens. Select Remote Site Settings under Security Controls. The All Remote Sites page opens showing the list of Remote sites.
3. Click New Remote Site. The Remote Site Edit page opens.
 

RTENOTITLE

After you add the above information on the Remote Site Edit page, you can do the following: 

  • Save the Remote Site you created. 
  • Click Save and New to save the Remote Site you created and open the Remote Site Edit page to continue creating a new Remote Site.
  • Click Cancel to cancel the process of creating the Remote Site.
RTENOTITLE

 

Configuring Page Layout

To Enable ICI sections on the added entity (as per the ICI Configuration section) you need to add the ICI custom pages into page layouts. By using the Page Layout Configuration, Admin assigns user access to Contract or Contract Request Related Sections. For example, if you have enabled the ICI Configuration for Opportunity in Salesforce, you need to enable ICI custom pages in Opportunity Layout:

You can Edit your existing Page layout (Opportunity Layout) and add two Visualforce pages inside the page layout as follows:

1.  Click Setup icon > “Setup”. The “Setup” page opens.
2.  In the “Quick Find” search box, search for “object manager”

Salesforce19.png

3. Click “Object Manager”, the “Object Manager” page opens displaying all entity objects.

Salesforce21.png

4. In the “Quick Find” search box, search for “opportunity” and click on the “Opportunity” object from the search result. The “Opportunity” page opens.

Salesforce22.png

5. Click “Page Layouts” from the left pane of the “Opportunities” page, the “Page Layouts” list are displayed.

Salesforce23.png

6. Click “Opportunity Layout” from the “Page Layouts” list, the “Opportunity Layout” configuration page opens in editable mode.

Salesforce24.png

7.  In the Opportunity Layout pane, in the left menu, scroll down to select Visualforce Pages.  Under Blank Space, drag the page that you want to give access to and drop it in the appropriate area in the opportunity (located on the same page under Opportunity Sample). For example, as you can see in the following screenshot, ICI_Contract Page and ICI_Contract Request Page can be dragged and dropped in the appropriate area in the opportunity.

Salesforce20.png

Pages are now added in the Icertis Contracts Section.

Configuring Data Sync

Once the Contract and Contract Request is created from Salesforce, the data is synced to ICI entities. If the Salesforce entity is edited or changed, user need to update mapped fields in ICI. Ideally, this process is automated. The system should automatically sync the data in the background, without user intervention.

To enable this feature in Salesforce, ICI Service User Authentication Token should be configured and create a process in Process Builder for specific entities.  Selected entities will have Data sync functionality. To know more about the Process Builder, visit: https://help.salesforce.com/articleView?id=process_overview.htm&type=0 

Data Sync (Salesforce to ICI) Configuration

 
Data sync configuration is divided into two sections:
  • Configure Service User Authentication Token
  • Configure Entity Process Builder

 

 

Service User Authentication Token

To configure Service User Token in Salesforce, follow these steps:

1. In Salesforce, under Setup, search Installed Packages in the Quick Find box and select Installed Packages. The “Installed Packages” are displayed.

Salesforce25.png
 
2. Find IcertisCLM Package and Click Configure. Data Sync Configuration page opens.
 
Salesforce26.png
 
Salesforce27.png
 
3. Only the Admin user can perform the following actions:
  • Disable DS Interval Flow: Click this checkbox to deactivate the Data Sync Interval Flow. Default value false. 
  • Sync Time Duration:  It denotes the sync time duration (in seconds). Default value 10.
  • ICI Service User Auth Token: It is the Service User Authentication Token. Contact DevOps team to get this token. and it is existed in ICI, if you want this token contact ICI Configurator.

4. Click Save.

 

 

Configure Entity Process Builder

Process Builder configuration is an entity-specific configuration. To configure Process Builder in Salesforce, go through the following steps. In this case, the Opportunity entity will be configured.

1. In Salesforce, under Setup, search for Process Builder in the Quick Find box and select Process Builder.

Salesforce28.png
 
2. On the Process Builder Configuration Page, click New. New Process popup opens.
 
RTENOTITLE

3. On the New Process popup window, enter Process Name and API Name.
4. Set The process starts when field value to A record changes and click Save.
 
RTENOTITLE
 
5. Opp Sync process configuration page opens. Click Add Object, Select Object Name and select when record is created or edited and click Save.
 
RTENOTITLE

6. Click Add Criteria, enter Criteria Name and select Conditions are met, formula evaluates true or No Criteria and click Save.
 
RTENOTITLE
 
7. To configure Immediate Actions, click Add Action, enter the data as per the table below and click Save.
 
RTENOTITLE
 
RTENOTITLE
 
8. Click Activate to complete the process.
 
RTENOTITLE
 
Note: You can configure any other Entity following the same process.
 

 

ICI Side Configuration

Mapping Data between Salesforce and ICI

Use the Configure tile in the ICI application to specify the mapping details between Salesforce and ICI by creating Masterdata records for mapping entities.

 

Creating Masterdata records for mapping entities

Creating Client App Cross Reference Mapping

  1. Log on to the ICI application
  2. Click Configure > Masterdata > Create Masterdata on ICI Dashboard. The Create Masterdata page opens.
SF 7.png
  1. Provide relevant information in the respective fields:
RTENOTITLE
  1. Click Next. The Attributes page opens.
  2. Provide relevant information in the respective fields:
 
RTENOTITLE
 
Note: You can map a Salesforce standard Contract object to ICI Contract Type. This allows creating a Contract in Salesforce automatically whenever it is created in ICI. You can configure any Salesforce entity to map with the ICI Contract creation. 
 
8. Click Save after entering the details. 
 

 

Creating Masterdata for mapping the entities

You can create a Masterdata record for the Contract Type Masterdata that you created earlier. This helps in mapping the entities between Salesforce and ICI. ICI allows mapping this data from any Salesforce entities like opportunity, account, or quote to a Contract Request or agreement by creating the Masterdata record in ICI. 

To create a Masterdata record:

  1. Click Configure > Masterdata > Create Masterdata on ICI Dashboard. The Create Masterdata page opens.
SF 7.png

 
2. Complete the information in the following sections. 
  • Masterdata Details
  • Attributes
3. Click Next at the end of Masterdata Details section to go to the Attributes section and complete creating the Masterdata record. 
 
Masterdata Details
 
1. Select the category from the drop-down list. 
2. Select the Contract Type Masterdata that you created earlier. For the purpose of mapping the data between ICI and Salesforce, select Client App Entity Mapping.
3. Click Next. The Attributes page opens. 
 
Attributes
 
This section shows the attributes that you created when creating the Contract Type Masterdata. 
 
SF 8.PNG
 
4. Enter the following details in appropriate fields.
 

RTENOTITLERTENOTITLE

5. Click Save to save the Masterdata record and enable mapping between ICI and Salesforce.

 

 

Configuration for allowing user to be redirected to ICI Details page in Salesforce

When creating Contracts, Contract Requests and Amendments from Salesforce, Administrators can now configure whether the users should be redirected to the ICI Contract details page or the Salesforce Record page from where creation process was initiated. This can be configured by selecting the “Show initiating object’s Salesforce page” checkbox on the ICI Endpoint Configuration page. By default, the checkbox is unchecked. When checked, the user is redirected to the Salesforce Record page, else to the ICI Contract detail page.

 

 

Integrating ICI Tasks with Salesforce 

With this release, Salesforce users can now manage ICI tasks from within Salesforce. ICI Administrators can configure ICI task integration with Salesforce so that the tasks created in ICI are pushed to Salesforce. This allows users to view task details with the attributes such as Task Name, Status, Priority, Due Date within Salesforce itself.

Based on configuration, users can receive task notifications in Salesforce for any action taken on agreements, templates, contract requests, clauses or masterdata in ICI. 
To integrate ICI Tasks with Salesforce Tasks:

 

Creating Client App Cross Reference

  1. Click Configure > Masterdata > Create. The Masterdata Details tab is displayed.
SF 7.png
  1. Select the Category from the dropdown. For example, Default.
SF 9.PNG
  1. Select the Masterdata Contract Type. In order to map ICI entities with entities in Salesforce, you must select Client App Cross Reference from the dropdown.
  2. Click Next. The Attributes tab opens.
  3. Enter the relevant attribute values. Enter ICI Entity Name and Client Entity Name as Task.
SF 10.PNG
 
Note: The Sync Task Notification attribute will only be visible if Client Name is selected as Salesforce. Similarly, the Task Types Of Contract and Task Notification Actions attributes will only be displayed if Sync Task Notification flag is set to Yes.

When the user takes any of the workflow action selected in the Task Notification Actions field in ICI, the corresponding task gets generated in Salesforce. For example, if Request Review action is taken on an agreement and a user (Reviewer) is selected, then the same task will appear in the Tasks section of Salesforce.

 

Viewing ICI Tasks in Salesforce

SF 11.png

 For example, if the agreement is Not approved in ICI for which Send for Approval action was taken, then the agreement status in ICI changes to Approval Pending and in Salesforce changes to Not Started.

 

Working with Saved Searches

You can use advanced search option to search for existing entities. You can save these searches and pin them as favorites for easy access. Saved searches can be opened for easy access to the search results. 

 

Performing a Search to Save

1. Click the Advanced button on the right corner of the Search toolbar. The Advanced Search page opens. 
2. In the first field from left, enter or select appropriate entities from the list and type the keywords to search in the Refine Search here field

SF 12.PNG
 
3. Select from these options: 

4. After selecting either of the above options, click the Search button. The list of search results opens. 

5. To narrow down your search further, navigate to Search For field. Click Select Field and select an option from the list provided. The number in the bracket indicates the number of items available containing that search term. You can select multiple options. For example, selecting the field Status displays the number of Agreements that have the Status as Draft, Approved, Terminated, Superseded and so on. If you select the status as Draft (select the checkbox next to Draft), all Agreements in the Draft state are displayed. 

6. A list of these Agreements opens as search result in a tabular format. Enhance your search using wild cards as follows:

 

 


Saving a Search

If you have the search criteria defined and need same search criteria repeatedly, it is advisable to save the search. For Configuring Saved Search in Salesforce, we need some of the Data Mapping which includes Salesforce Account and Opportunity Id (which is 18 digit of alphanumeric reference value). That means, if you are defining a mapping of Salesforce Opportunity with Contract Request, then in that contract request create a field/attribute which will hold the salesforce Opportunity id, in the same manner you can create for the account id reference. So create these required mapping to start with Saved Search.

For example, after you map data, attribute like Opportunity ID can be mapped in ICI and Salesforce.

SF 13.PNG
 
SF 14.PNG
 

To save the search:

1. Click the Save icon. This opens the Save Search window. Set the parameters for this Saved Search. 
2. Type a name for the search. Use a name that you can easily associate with this search. 

Click Yes to make it a global search, which means all users of the selected Security Groups and Organization units can view it. Select No to save this search locally, which will not be visible to any other person than the person who is creating it.

Note: Only the Administrator can save global searches.

3. Specify the Advanced parameters as follows:

RTENOTITLE
 
Note: A search defined as a Smart Link cannot be set as a Dashboard tile. For a global search, the administrator needs to create a security group and give access to specific users. Only those users can see that Saved Search in the list and add it as a Dashboard tile.

You can also save your searches and use the saved search Uniform Resource Identifier (URI) in the ICI Endpoint Settings in Salesforce. You can create saved searches for the following fields that are displayed in Salesforce ICI Config Settings > ICI Endpoint Settings

SF 14.PNG
 

Following is an example of creating a saved search for Contract Opportunity Search URI: 

1. On the upper right corner of your ICI page, click Search icon. The Search page opens. 
2. In the Please select Entities to search list, select the entity that you want to search such as Agreement or Contract Request and then type the entity that you want to display in the search text box. The relevant search results open. 
3. On the upper right corner of the search results, click Save icon to save your search. The Save Search window is displayed.  
4. In the Save search as box, type the name of the saved search as a URI such as SF_OPP_CR for a contract request, or SF_OPP_Contract for a contract request.  
Similarly, you can create saved searches for the remaining entities. The entity and field to filter will be different.

Note: For core ICI related configuration, refer to ICI admin guide. 
Within Salesforce, ICI will be accessible as per the ICI based User context so if there is anything which you need to control at the user end, please control the user settings from core ICI product.
 


Agreement Lines Sub tab

Agreement Lines subtab is added for account object displaying the list of all the active product and services sold to the customer. The products displayed under agreement line sub tab are fetched via ICI saved searches.

Note: The agreement line subtab can only be accessed through sales instance.

 

8.2-Visibility of products and services.png

1.Click “Account”. The “Accounts” tab will open.

8.2-Visibility of products and services1.png

2. List of all the customer accounts is displayed, click on the desired customer name. The Account details page for that customer opens.

8.2-Visibility of products and services2.png
 

3. Click “Agreement Lines”. The Agreement Lines subtab will open, displaying list of products sold to the customer.

8.2-Visibility of products and services3.png

4. To view the list of all the products sold to the customer, click “View All”. The list of all the products and services sold to the customer will be displayed.

8.2-Visibility of products and services4.png
8.2-Visibility of products and services5.png
 
Note: The “Agreement Lines” displays only active products and services from executed contracts.

 

Updating Saved Search Configuration 

With this feature, Salesforce administrator can map any of the entity level attribute for executing the Saved Search, provided it is created in ICI as per the attribute configured in Salesforce. 
If you do not configure the attribute in Salesforce, the Saved Search still executes based on the Salesforce record ID. 

 

 

Configuring Global Search 

Previously, there were 2 separate sub-tabs, 1 each for Contracts and Contract Requests, under the ICI tab within Salesforce. The previous Search page when rendered from within an iFrame inside Salesforce, gives the user a perception that they are working outside of Salesforce application.

With the SFDC experience enhancement, the user will have the ability to:

 To configure the Global Search tab:

SF 15.PNG
SF 16.png
SF 17.png

Enabling Single Sign-On

You need to setup single sign-on for Salesforce to work seamlessly with ICI. For more information about setting up single sign-on, refer https://help.salesforce.com/articleView?id=sso_saml.htm&type=0

 

 

 

Multiple Salesforce Instances

With this feature, you can connect multiple Salesforce instances of your organization or organization groups to a single ICI instance. For using this feature, the user needs to create a new `Masterdata record which can be used to define the multiple Salesforce instances. The user needs to add the login details of the configured Salesforce instance machine configuration. Contact Dev Ops team for assistance.

To support Multiple Salesforce instances, you need to add multiple records in Client App Org Reference Contract Type. If the Contract Type is not listed in the system, then it needs to be created. 

If the Client Org Reference Contract Type is not already created, create it using the following steps: 

To create a Masterdata record: 

1. On the My Dashboard page, click Configuration and then click Masterdata. The Masterdata page opens
2. Click Create Masterdata. Provide relevant information in the respective fields and click Next. The Attributes page opens. Provide relevant information in the respective fields:

RTENOTITLE

3. Provide relevant information in the respective fields: 

RTENOTITLE
 
Notes: While creating a new Contract Type, name it as Client Org Reference only. The naming convention must be followed exactly as given. ICI will not recognize and sync Contract Type which is created by any other name.
 
After adding the Org Reference mapping in Client App Entity mapping and Cross-reference mapping, there will be an extra attribute where the user selects the Org for which that particular mapping is synced.

After the Salesforce instance is configured, you can use that Reference Org to define Client App Entity Mapping and Client App Cross Reference mapping.

If Client App Org Reference Contract Type is not installed, you need to create this Contract type, with exactly the same name and attributes. Refer this link for details. 
 
In this way, Client Org Reference Contract Type can be used for multiple Salesforce instances. 
 

 

Viewing ICI Dashboard widgets in Salesforce 

To configure and view ICI dashboard widgets:

1.  Click Setup icon > “Edit Page”. The “Home” page dashboard opens in editable mode.

Salesforce29.png
 
2.    On the last widget on the Home page, click the plus “+” icon to add a widget.
3.    Click “Visualforce” from the left pane.
 
Salesforce30.png

4.    Select the My Recent Activities widget option from the “Visualforce Page Name” dropdown.

Salesforce31.png

5.    Uncheck the “Show Label” option to remove the Salesforce default header label on the widget.

Salesforce32.png

6.    Click “Save” to save the configured widget.
7.    Follow the above steps to add the “Performance Metrics” widget.

Salesforce33.png

Now, the ICI widgets “My Recent Activities” and “Performance Metrics” will be displayed on the Salesforce “Home” dashboard.

Salesforce34.pngb.  

 

Viewing Notifications Feed

1. Go to the Salesforce Home page. 

SF 19.PNG 
 

2. View the latest notifications in the live “Chatter” feed, and it can be sorted by “Latest Posts” or “My Recent Activity” will be displayed.

Salesforce35.png

 

Simplified UX Actions in Grid

The Icertis Experience for Salesforce already provides the capability for Salesforce users to perform agreement-related tasks from within Salesforce. ICI is now improving the user experience such that Salesforce users can perform their tasks more seamlessly by taking actions on agreements with fewer clicks than required earlier.

The user will now be able to view a contract record by double-clicking the row, instead of the earlier option of clicking the View hyperlink. They will be able to take Download, Assemble Contract and Send for Approval actions directly from the Action column of the Contract grid on Salesforce entity forms, without opening the agreement record. These actions will be displayed to the user based on the workflow state of the agreement.

1. Click on the Opportunities tab. The Opportunity home page opens.

2. Click on any Opportunity link.

3. Click on the “Agreements or “Request” tab.

Note: The agreement grid and corresponding actions can also be navigated through the global “Agreements” or “Requests” tab, in addition to the “Details” tab navigation.

4. Scroll to the Icertis Contract Intelligence section.

5. Click on the View Details column to U'pload, Assemble Contract, Request Review: Internal, Request Review: External, Send for Approval and Download Document.

6. Double-click the row to view the Agreement.

Salesforce36.png
 
 

Creating a Contract Request from an Account

You can create a Contract Request if your organization does not provide the privileges to create a contract directly. 

To create a Contract Request from an account:

1. Log on to Salesforce using your ICI credentials.

2. Select ICI in the top right corner of your Salesforce page to use ICI through Salesforce.

3. Click Accounts in the top navigation bar, and click the Account for which you want to create a Contract Request.

Salesforce37.png

4. Click “Requests” tab, the Requests grid opens.

Salesforce38.png

5. Click “New Contract Request”. This opens the “Create Request” popup.

Salesforce39.png

6.    Select the Category and Request Type based on the request you are creating and click Next. The Attributes page opens.

Salesforce40.png

7.    Specify the details of the request on the various sections of this page and click “Next”, 
You can also click Save if you want to save the changes and create the request later.

Salesforce41.png

8.    Click “Create Request”.

Salesforce42.png

The Contract Request is created and its Accounts “Details” page opens with a “Draft” state.

Salesforce43.png

9. Use the buttons in the table below to perform a desired action:

RTENOTITLE
 

 

Creating a Contract from an Account

The process of creating a contract from ICI in Salesforce is dependent on the workflow that is implemented in your organization. 

To create a Contract from an Account:

1. Log on to Salesforce using your ICI credentials.

2. Select ICI in the top right corner of your Salesforce page to use ICI through Salesforce

3. Click Accounts in the top navigation bar, and click the Account for which you want to create a contract.

Salesforce37.png

4. Click “Agreements” tab, the Agreements grid opens.

Salesforce45.png

5. Click “New Contract”. This opens the “Create Agreement” popup.

Salesforce15.png

6. Complete the details in the sections in the popup, and click Next.

Salesforce47.png

Attributes

7. This section contains the attributes that the primary owner selected while creating the Contract Type for the agreement, which you are creating. You can also save the details at any stage and return to this page to complete the agreement later. The attributes displayed in this section vary based on the Contract Type you select.

Salesforce48.png

Template

 This section shows the templates that you created for the selected Contract Type. This section opens only if you select Own type of paper to create the agreement. Select the template from the list.

8. Click Next.

Salesforce49.png

Verify

This is the final step in the agreement creation process. The details in this section open based on the attributes and sections you used to create this agreement. 

Salesforce50.png

 You can perform the following actions on this page:

•    Click Previous to go back and make any changes to the agreement. Click Next to return to this section after making the required changes.
•    Click Create to create the Agreement. After the agreement is created it is not visible to all users until it is published by its primary owner.
•    Click Create and Publish to create and publish the agreement. After the agreement is published it becomes visible to other users and a Draft watermark opens on the agreement in all states until it is approved by the designated approver.
•    Click Create and Send for Approval to create and send the agreement for approval. The agreement is sent to the approvers that are set by rule for the Contract Type selected for this agreement.
•    Click Cancel to stop the agreement creation process. A discarded agreement is no longer available in ICI. You can discard the agreement from any section while creating the agreement. After the Agreement is created in Salesforce, it is available in ICI in the Draft state. You can send the agreement for approval through Salesforce, however, the approve and reject actions on the agreement can only happen through ICI.

 

Adding Amendment to a Contract

After the Contract is executed, it cannot be edited. However, the primary owner can add an amendment to the Contract that is in the Executed state only.
Amendments are added to a Contract due to following reasons:

  • Payment terms of the Contract have changed.
  • Scope of work in the Contract has changed.
  • The terms and conditions of the Contract have changed due to the introduction of the new regulation.

To add an amendment to a Contract:
1. Log on to Salesforce with your credentials.
2. Click ICI in the top navigation. The ICI page showing the list of Contracts and Contract Requests opens. 
3. Select and open the Contract that is in the  Executed state. The Contract page opens.
4. Click Add Amendment on the Contract page. The Add Amendment page opens.
5. Make the required changes to the Contract on the Initial Attributes tab and click Next
6. Click Create. The Amendment moves to the Draft state and opens the Amendment Details page.

7. You can perform the following actions on the Amendment Details page:'

RTENOTITLE
Salesforce51.PNG
 
Salesforce52.png

After adding an Amendment, it goes through the similar flow of Agreement from Draft till execution. 

Creating a Contract Request from an Opportunity

You can create a Contract Request if your organization does not provide the privileges to create a contract from ICI in Salesforce. To create a Contract Request from an Opportunity: 
1. Log onto Salesforce using your ICI credentials. 
2. Select ICI in the top right corner of your Salesforce page to use ICI through Salesforce.
3. Click Opportunities in the top navigation, and click the Opportunity for which you want to create a Contract Request.

4. Click “Requests” tab, the Requests grid opens.

5. Click “New Contract Request”. This opens the “Create Request” popup.

6. Select the Category and Request Type based on the request you are creating and click Next. The Attributes page opens.

7. Specify the details of the request on the various sections of this page and click “Next”.
You can also click Save if you want to save the changes and create the request later.

8.    Click “Create Request”. 

The Contract Request is created and its Accounts “Details” page opens with a “Draft” state.
 

Creating a Contract from an Opportunity

The process to create a contract from an Opportunity is same as creating a contract from an Account.

 

 

Creating a Contract Request from a Quote

The process to create a Contract Request from a Quote is same as creating a Contract Request from an Opportunity or Account. 
 

 

Creating a Contract from a Quote

The process to create a Contract from the Quote is same as Creating a Contract from an Opportunity or Account. 

 

Configuring Auto-creation of Contracts and Tasks in Salesforce

With this release, the contract creation process has been automated based on Opportunity or Quote status, thus increasing the productivity of Salesforce users.
Salesforce Administrators can now:

  • Configure the Opportunity or Quote status which can automatically trigger the contract creation.
  • Configure the contract type which should be used to create the contract based on data from an Opportunity or Quote.
  • Define the Type of Paper to be used as Own or Third Party.
  • Configure automated contract creation or automated task creation to initiate the contract creation process: 
    • For auto creation of contracts, the ICI Experience for Salesforce will determine the dependencies for the contract. For example, if the opportunity is for an extension, the existing master agreement for the account will be identified and an appropriate contract type such as an order form will be selected and associated with it.
    • For auto creation of tasks, Salesforce users will be able to create a contract using a single button click that will assemble all necessary documents for the type of contract to be created. 

 

Configuring Logs

1. Go to the ICI Configuration tab in Salesforce. The ICI Endpoint Configuration page opens.

2. Enter Duration for logs in days, for example 60.0 days. The number of days for which the logs will be preserved can be defined here.

SF 21.png

3. Set the Logging Level:
a. "Log Error: Only errors will be logged.
b. "Log Info: Only information will be logged, for example request and response.
c. "Log Always: Errors and information will be logged.

 


Displaying validations when uploading documents via Salesforce related contracts grid

To avoid any unwanted file from being uploaded and to avoid any potential risk for customer business, validations have been put in place for the following issues:

  • Invalid file types
  • Validation when uploading an older version of the agreement document
  • Add/remove/modify content control and upload
  • Association added/modified/deleted as file/table and for the differences
  • Missing mandatory/parent clause, clause modified/removed/added
  • Incorrect format for the tagged attributes
  • Invalid documents
  • Reuploading same documents
  • Virus scan
  • Invalid lookup values

1. On the Opportunities page, navigate to the “Action” column in the contracts related list (such as “Agreements” or “Requests”).

Salesforce55.png

2. Click the actions dropdown arrow. The actions available for the corresponding contract will be displayed.

3. Click the “Upload Document” icon. The Upload Document popup window is displayed.
 
Salesforce57.png

4. Click “Select File”. The browse file popup is displayed.

5. Select the document to be uploaded.

6. Click “Upload” or “Upload and Submit”. The corresponding validation will be displayed depending on the document you are trying to upload. For example, “Document is exactly same as previous document. Would you like to continue with the upload?” 

Salesforce58.png

Validations are also displayed:

  • For older document versions 
  • If differences are found in the uploaded document.
  • If any errors are found in the document or the document itself is invalid.

 



Revamping ICI Salesforce User Interface 

Agreement Sub Tabs 

  • Details 
  • Associations 
  • Amendments 
  • Collaborations 
  • Note 
  • Team 

Details Sub Tab: Details subtab displays the agreements details overview.

8.2-RevampingSFDC.png

Associations Sub Tab: The associations sub displays all the associations linked to an agreement, with hyperlink to associations details added in first column. Click the association name to view association details.

8.2-RevampingSFDC1.png

Amendments Sub Tab: Amendments sub tab gives ability to preview document using the down arrow button present at the right and then click “Preview Document” option.

8.2-RevampingSFDC2.png

After clicking “Preview Document” the “Preview Document” dialogue box pops up.

8.2-RevampingSFDC3.png

Collaboration Sub Tab: The Collaboration sub tab displays topics and messages added for collaboration. To create a new topic

1. Click on “New Topic” on Collaboration sub tab. “Create a New Topic” dialog box will open.

8.2-RevampingSFDC4.png

2. Select the participants by clicking on the “Add Participants” icon present right of the select user box.

8.2-RevampingSFDC5.png

3. The “Select Participants” dialogue box will open. Select the required participants and click “Add”.

8.2-RevampingSFDC6.png

4. The added users will be displayed inside “Selected Users” box. Add a “Subject” and a “Message” and click on “Create”.

8.2-RevampingSFDC7.png

5. New topic will be created under collaboration.

Note Sub Tab: To add a new note.

1.Click down arrow button present right of the note heading in the right scroll pane. The “Add Note” dialog box will open.

8.2-RevampingSFDC8.png

2. Enter the note and click “Add”.

8.2-RevampingSFDC9.png

3. To view all the notes, click “View All” button at the bottom of the notes box. The “View All” page will open.

8.2-RevampingSFDC10.png

4. User can “Search”, “Manage” and “Add Note” from the “View all” notes page.

8.2-RevampingSFDC11.png

Teams Sub Tab: To add a new team member 

1. Click down arrow button present right of the Teams heading in the right scroll pane. The “Add Team Member” dialog box will open.

8.2-RevampingSFDC12.png

2. Select the role from “Select Role” dropdown.

8.2-RevampingSFDC13.png

3. Set the “Step Number” if applicable, select the desired users.

8.2-RevampingSFDC14.png

4. Add a note if required, click “Add”. The team member will be added.

5. To view all the team members, click “View All” button at the bottom of the Teams box. The “View All” page will open.

8.2-RevampingSFDC15.png

6. User can “Search”, “Manage” and “Add Team Member” from the “View all” Teams page.

8.2-RevampingSFDC16.png