You do not have permission to edit this page, for the following reason:
You can view and copy the source of this page:
Return to Salesforce.
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.
The purpose of this guide is to document the process of:
Configuring ICM in Salesforce.
The guide also describes the process of using the ICM Salesforce connector for standard scenarios.
The document is primarily intended for:
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:
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.
To use ICM from within Salesforce:
ICM Salesforce contains the following key concepts:
After integrating ICM with Salesforce, you can do the following contract management tasks in Salesforce:
ICM is compatible with the following editions of Salesforce:
For more information about the different editions of Salesforce, refer to:
[https://help.salesforce.com/articleView?id=overview_edition.htm&type=0
To install ICM in Salesforce:
1. Log on to Salesforce.
2. Open a new browser instance and go to Salesforce AppExchange to download the ICM application.
Creating the Canvas App
Follow these steps to create a Canvas App:
1. In Salesforce, under Setup, search for Apps in the Quick Find box and select Apps.
Managing the Canvas App
1. In Salesforce, under Setup, search for Connected Apps in the Quick Find box and then select the option for managing Connected Apps.
4. Click Save.
You can perform ICM EndPoint Configuration only after you have installed Salesforce ICM from AppExchange.
ICM URL | This field is auto-populated on the ICM Endpoint Configuration page when you create a canvas application through Salesforce ICM. Note that depending on the ICM API URL, you will have to change this URL. Typically, API URL follows below convention, https://sfdcdev-api.icertis.com |
Canvas App Name Resource URI | This field is auto-populated on the ICM Endpoint Configuration page when you create the canvas application through Salesforce ICM. You can also add or edit the Canvas App Name manually from the ICM Endpoint Configuration page |
Resource URI | This field is auto-populated when you create the canvas application through Salesforce. You must create a Saved Search in ICM for the Resource URI value to get displayed in Salesforce |
Enable Reverse Integration | Select this check box to enable reverse integration. This causes the data created in ICM to be displayed in the Salesforce entities (from where the contract creation process was initiated) |
Enable Quick Contract | Select this checkbox to enable creating the Contract for all Salesforce entities with a single click from Salesforce. |
Enable Iframe | If the Iframe is disabled from the IDP, then select this checkbox to enable the Iframe in Salesforce to open the ICM page in Salesforce in a new tab for creating new Agreements and Requests. |
Entity Name | Select the entity name from the drop-down. The Entity Name denotes the Salesforce entities that are synced with ICM. |
Contract Saved Search URI | This denotes the Saved Search created in ICM to map the data between ICM and Salesforce. It is the Contract Saved Search for the corresponding Salesforce entity. |
CT Saved Search Field | Select the field name which filters the Contracts based on the Saved Search in ICM. |
CR Saved Search URI | This denotes the Saved Search created in ICM to map the data between ICM and Salesforce. It is the Contract Request Saved Search for the corresponding Salesforce entity. |
CR Saved Search Field | Select the field name, which filters the Contract Requests based on the Saved Search in ICM. |
Related Entities | Click the Related Entities textbox corresponding to the Account or Opportunity in Salesforce. The Related Entities dialog box appears. Select the Related Entities records as Associations to the ICM Agreement through Salesforce. You can also configure the conditions by clicking the Add Condition button on the Related Entities window for that specific Related Entity. The entities in this field are auto-populated based on the entity name you selected earlier. |
Button Label | This is the Text, which will appear as Button Label on UI. |
Button Type | This button type can be Contract or Contract Request. It is a read-only field, jut to specify the button type. |
Active | This checkbox Shows Enable state for the button, if it is unchecked then Button will be hidden from UI. |
Conditional Visibility | This text area will define the conditional visibility criteria of the button. |
Field | Description |
---|---|
Remote Site Name | Type the Remote Site Name. Adding a Remote Site Name allows tracking the external sites added in Salesforce. |
Remote Site URL | Type the Remote Site URL. Adding a Remote Site URL allows accessing external sites from Salesforce. |
Disable Protocol Security | Select this checkbox to allow s-controls to access the remote site regardless of HTTP or HTTPS session security. S-Controls allow adding the functionality of your application to your Salesforce organization. |
Description | Type the description for the remote site. The description should typically contain relevant important information that helps in finding the remote site from the list easily. |
Active | Select the checkbox to make the remote site active in Salesforce as soon as you create it. |
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:
1. You can Edit your existing Page layout (Opportunity Layout) and add two Visualforce pages inside the page layout as follows:
2. On the Opportunity Layout page, click Edit to edit the page layout where you want to add Visualforce pages.
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.
To enable this feature in Salesforce, ICM 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
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.
4. Click Save.
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.
8. Click Activate to complete the process.
Use the Configuration tile in the ICM application to specify the mapping details between Salesforce and ICM by creating Masterdata records for mapping entities.
Creating Client App Cross Reference Mapping
1. Log on to the ICM application.
2. Click Configuration on ICM Dashboard. The Configuration page appears.
3. Click Masterdata on the Configuration page. The Masterdata page appears.
4. Click Create Masterdata. Create Masterdata page appears.
5. Provide relevant information in the respective fields:
6. Click Next. The Attributes page appears.
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.
To create a Masterdata record:
1. Click Configuration on My Dashboard. The Configuration page appears.
5. Click Save to save the Masterdata record and enable mapping between ICM and Salesforce.
You can use advanced search option to search for existing entities. You can save these searches and pin them as favourites for easy access. Saved searches can be opened for easy access to the search results.
1. Click the Search tile on the top right corner on My Dashboard page. The Advanced Search page appears.
2. 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.
4. After selecting either of the above options, click the Search icon. The list of search results appears.
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 appear.
6. A list of these Agreements appears as search result in a tabular format. Enhance your search using wild cards as follows:
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.
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.
3. Specify the Advanced parameters as follows:
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.
If you do not configure the attribute in Salesforce, the Saved Search still executes based on the Salesforce record ID.
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
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.
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 appears
2. Click Create Masterdata. Provide relevant information in the respective fields and click Next. The Attributes page appears. Provide relevant information in the respective fields:
3. Provide relevant information in the respective fields:
The process of creating a contract from ICM 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 ICM credentials.
2. Select ICM in the top right corner of your Salesforce page to use ICM through Salesforce
3. Click Accounts in the top navigation, and click the Account for which you want to create a contract.
4. On the Account Detail page, scroll down to the Icertis Contracts section.
Click New Contract. This opens the Create Contract page in Salesforce.
Note: You can set the label of the buttons as required.
5. Complete the details in the sections below and click Next.
Contract Type Details
Enter the following information in this section:
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.
You can create a Contract Request if your organization does not provide the privileges to create a contract from ICM in Salesforce.
To create a Contract Request from an Opportunity:
1. Log on to Salesforce using your ICM credentials.
2. Select ICM in the top right corner of your Salesforce page to use ICM through Salesforce.
3. Click Opportunities in the top navigation, and click the Opportunity for which you want to create a Contract Request.
The process of creating a contract from ICM in Salesforce is dependent on the workflow implemented in your organization.
To create a Contract from an Opportunity:
1. Log on to Salesforce using your ICM credentials.
2. Select ICM in the top right corner of your Salesforce page to use ICM through Salesforce.
3. Click Opportunities in the top navigation, and click the Opportunity for which you want to create a contract.
4. On the Opportunity Detail page, scroll down to the Icertis Contracts section.
5. 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.
The rest of the process to create a Contract Request from an Opportunity is same as Creating a Contract from an Account.
The process of creating a contract from ICM in Salesforce is dependent on the workflow implemented in your organization.
To create a Contract from a Quote:
1. Log on to Salesforce using your ICM credentials.
2. Select ICM in the top right corner of your Salesforce page to use ICM through Salesforce.
3. Click Quotes in the top navigation, and click the Quotes for which you want to create a contract.
4. On the Quote Detail page, scroll down to the Icertis Contracts section.
5. 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.
The rest of the process to create a Contract from a quote is the same as Creating a Contract from an Account.
You do not have permission to edit this page, for the following reason:
You are not allowed to execute the action you have requested.
You can view and copy the source of this page:
Return to Salesforce.