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.
The purpose of this Wiki is to document the process of:
It also describes the process of using the Icertis Experience for Salesforce with the standard scenarios.
The document is primarily intended for:
Prerequisites
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:
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:
Icertis Experience for Salesforce has the following key concepts:
After integrating ICI with Salesforce, you can do the following contract management tasks in Salesforce:
ICI 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 ICI in Salesforce:
1. Log on to Salesforce.
2. Open a new browser instance and go to Salesforce AppExchange to download the ICI 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.
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 ICI EndPoint Configuration only after you have installed Salesforce ICI from AppExchange.
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.
2. Click Object Manager. The Object Manager page opens.
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.
4. Click an Opportunity from the filtered list. The respective Opportunity page opens.
5. Click Field Sets in the left navigation pane. The Field Sets page opens.
6. Click New on the Field Sets tab. The New Field Set page opens.
7. Enter the description for the following fields on the New Field Set page.
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.
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.
2. Click the Opportunity from which you want to create a Contract. The Opportunity Details page opens.
3. Click New Contract in the Icertis Contracts section. The Create page opens displaying the details to be entered for creating the Contract.
4. Select the following on Create page.
5. Click Next. The Attributes page opens showing the list of Fields added in the Field Set. For example, Opportunity Id, Opportunity Name.
Note: After the Contract is created in Salesforce, it is displayed in ICI along with the Fields added in the Field Set.
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.
After you add the above information on the Remote Site Edit page, you can do the following:
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)
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 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
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.
Use the Configuration tile in the ICI application to specify the mapping details between Salesforce and ICI by creating Masterdata records for mapping entities.
Creating Client App Cross Reference Mapping
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:
5. Click Save to save the Masterdata record and enable mapping between ICI and 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 Allow Redirect 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.
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:
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.
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.
1. Click the Search icon tile on the top right corner on My Dashboard page. The Advanced Search page opens.
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 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:
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.
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.
3. Specify the Advanced parameters as follows:
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:
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.
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.
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:
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
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:
3. Provide relevant information in the respective fields:
To view widgets on the Salesforce Home page, the user needs to have Widget Dashboard enabled in ICI Preferences. If the Widget Dashboard is not configured or if there is no data in the widgets, then the No data found message is displayed.
Using Performance Metrices in Salesforce
Click the saved search link on the Performance Metrices widget, for example, Mobile Agreement Search. The Saved Search page is displayed in Salesforce.
Using My Recent Activities in Salesforce
Click a record in the My Recent Activities widget, for example Acme Supplier Contract. The agreement opens in Salesforce.
Viewing Notifications
1. Go to the Salesforce Home page.
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.
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 Account in the top navigation, and click the Account for which you want to create a Contract Request.
4. On the Account Detail page, scroll down to the Icertis Contracts section.
5. Click New Contract Request. The Create Contract Request page opens in Salesforce. The options available on this page indicate the type of contract for which you are creating this request.6. Select the Category and Request Typebased on the request you are creating and click Next.
7.Specify the details of the request on the various sections of this page
8. Click Next. The Request Summary page opens. You can also click Save if you want to save the changes and create the request later.
9. Click Create Request. The Accounts page opens showing the Contract Request you created in Draft state.
10. Click ICI in the top navigation bar and then click Contract Requests. The Contract Request page opens and it shows the list of available requests.
11.Click View next to the Request you created. The Request Details page opens.12. Use the buttons in the table below to perform a desired action:
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 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 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.
5. Complete the details in the sections below and click Next. Contract Type Details Enter the following information in this section:
AttributesBelow is the description of some of the 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.
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.
Verify
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.