Creating and Mapping Custom Fields - Salesforce (Classic)

Overview

This process allows you to create any required custom fields in Salesforce and then map them with the custom fields in Responsive.

Permissions

Users must have the System Administrator privilege in Salesforce to complete the installation.

Creating Custom Fields in Salesforce

1. Click Setup from the top navigation bar, then click Customize from the left pane.
   
2. Select the object type you want to create the custom field for (Opportunities, for example), then select Fields.
   
3. Click New in the section Opportunity Custom Fields & Relationships section.
   
4. Select the required field you want to add and click Next.
   
5. Enter the details of the custom field and click Next.
   Note: Fields marked with red are mandatory fields.
   
6. Specify the field level security and click Next.
   
7. Select the layouts you want to add the custom fields to.
   
8. Click Save. The newly added custom field displays in the Opportunity Custom Fields & Relationships section.
   Note: Click Save & New to save this custom field and create new one.
   

Repeat a similar process to create custom fields for Leads and Accounts.

Note: In order to map Lookup fields from Salesforce, you have to create a formula field in Salesforce and then map the Formula field in Responsive's custom field mapping. To create formula field in salesforce, follow the steps below:

1. Perform steps 1-3 described in the previous section (Creating Custom Fields in Salesforce). 
2. In step 4, select Formula and then click Next.
   
3. Enter Field label and field name. (Mandatory)
4. Select a Formula Return Type, and click Next.
   
5. The Enter Formula page appears. Click Insert Field.
6. The Insert Field pop-up appears. Select the required field, and click Insert.
   
7. The inserted field appears in the formula field of Enter Formula page.
8. Click Check Syntax to verify the formula syntax. Once the syntax is verified, click Next.
9. Next, follow steps 6-8 from the previous section (Creating Custom Fields in Salesforce).

Mapping Custom Fields from Responsive

Custom fields created in Salesforce should be mapped to project custom fields in Responsive so they appear during project creation and in reports.

1. Go to Organization Settings > Project > Custom Fields and click Add Field.
   
2. Select the category for which the custom field has to be created.
   
3. Specify the Merge Tag Name.
4. Enter a Display Name for the custom field.
5. Specify a Group Name.
6. Select the Project Type for which the custom field has to be created.
7. Select the Type of the field response.
8. Check the Required box to make the field mandatory.
9. Check the Associate with Salesforce (instance) box to associate the field with Salesforce. A section as shown below will be displayed:
   
10. Select the custom field you want to associate with the object from the Salesforce Fields drop-down list.
    
11. Click Add. The field displays in the Custom Fields section of the Organization Settings.
    
    
    While creating projects from Opportunity in Salesforce, the mapped field displays as shown below:
    

Repeat a similar process to create custom fields for the Account and Leads object types.

Example

• While creating a custom field in Salesforce, the field was not marked as mandatory. While mapping it from Responsive, it was marked as a required field. After successful mapping, the Phone Number field displays under the Basic Details section as a mandatory field.
• While creating a new Salesforce associated project from Responsive, the value for the custom field created for that object type will be auto-populated as shown below. The value from the opportunity will be auto-filled in the phone number custom field here.