Assign permission set groups

The Oneflow for Salesforce application comes with the permission set groups: 

• One for the administrator 
• One for the users. 

The user installing the application must assign the Oneflow administrator permission set to themselves or the person who will administrate the application.

Any user that will only use the application and not configure it should be assigned the Oneflow user permission set groups.

Note:
You can assign individual Oneflow permission sets. However, we do not recommend assigning them as this might make the application fail or work incorrectly.

Access Oneflow Configuration

Once you've installed the Oneflow application in Salesforce and assigned the permission set group to the administrator, you can access the Oneflow Configuration tab. 

1. To get started, navigate to Oneflow Configuration.
   

2. In Oneflow Configuration, navigate to the Getting Started page.
   

Configure Oneflow

On the Oneflow Configuration page, follow these steps: 

1. The first step is to provide your Oneflow user email. 

   Note:
   You can skip this step if your Oneflow user email matches the email connected to your Salesforce account. If it doesn't match, you must add a Oneflow email field to the user page layout.

   

2.  Authenticate with the API key generated in Oneflow.
   When you click the link inside the bullet point, the Oneflow application will open in a new window, where you will log in with your Oneflow credentials. 
   Once logged in, you will be redirected to the Extension page inside Oneflow to retrieve your API token for Salesforce.

3. To get the API token, enable the Salesforce extension.

4. Copy the token and securely save it to use in Salesforce.
   

5. Authorize Oneflow in Salesforce. This step is needed for the Oneflow application to communicate back to Salesforce.

6. In Oneflow, click the Authenticate with Salesforce button, redirecting you to Salesforce for verification. 

   Note:
   Make sure that you are authenticating using the correct salesforce URL. If installing the app on a sandbox environment, click Authenticate with sandbox.

7. Assign Oneflow licenses to users in Salesforce. 
   

   Note:
   Oneflow requires customers to have a license for each Oneflow user to use Oneflow integration. For new users, Oneflow provides a 14 days trial license.

   

8. Assign Oneflow permission sets to users in Salesforce. This step is required for granting user permission to use the Oneflow package. We have created Permission set groups for the Oneflow administrators and users. Read more in the Permission sets article.
   
   

9. Enable permission to run flows in Salesforce to allows you to create contracts. Read more in the Permission sets article.

10. The Additional Configurations step is optional. In the Configuration tab,  you can allow the creation of more contracts inside of one Opportunity and more. Click the Configuration tab to see the options on the left-hand side.
    

Configure participant data fields

Set up participant data fields

• While creating a contract from the Oneflow widget, you can choose participants of the contract. These participants may belong to any Salesforce object, depending on your configuration in the Salesforce flow.
• You can set up participant data fields. Participant data fields configuration helps you to decide how many of the participants' data fields from Salesforce should be synced to Oneflow. 
  
• Using data fields associated with your participants in the contract body is possible. 
• On a technical level, the first selected participant from the Oneflow widget has an index of 0, corresponding to 1 in the Participants Data Fields UI.
  

Configure data fields

1. Set up data fields.

• The data fields feature in Oneflow relies on default Salesforce flows which can be modified.

• Administrators can select which data fields to sync between Oneflow and Salesforce, whether when creating Oneflow contracts or updating values in either system.
  

2. Select Salesforce Object and Data Fields:

• Choose the Salesforce object you wish to sync (i.e. Opportunity) and the data fields to be synced.
• You need to specify at least one instance of the object to sync. Once you specify a number, you will see data fields related to the object listed in the window.

3. Set a Sync Direction:

• Using the checkboxes, for each field, configure sync from Salesforce to Oneflow, Oneflow to Salesforce, or both (two-way sync).
  • Salesforce to Oneflow: Allows you to sync a Salesforce field to Oneflow a data field. After configuration, the selected fields will sync to Oneflow. These data fields will also be available for mapping in Salesforce templates or contracts created from those templates.
  • Oneflow to Salesforce: Allows you to fetch updated values from a Oneflow contract back to the selected Salesforce field via a button on the Oneflow Lightning component.
    

4. Optional - Add Oneflow Contracts Lightning Component:

•  In Salesforce's Lightning App Builder, choose the object page where you want to place the Oneflow widget (i.e. the Opportunity Record Page).
  
• You can find the Oneflow objects listed under Custom - Managed. Drag the component to the desired location on the Salesforce object's page.