Setup Custom Lookup For SharinPix Form Response

Overview

In this article, we will demonstrate how to setup the SharinPix Form Response Sync. To do so we will:

1. Create a lookup relationship field on the SharinPix Form Response object

2. Configure the SharinPix Form Response Setting custom metadata

Prerequisite:

• The SharinPix Form Response Sync Setting component works alongside the SharinPix Form feature. Therefore, before configuring this Sync Setting, ensure that the SharinPix Form feature has been configured properly. For more information on how to configure the SharinPix Form, please refer to the following article: SharinPix Form

• The SharinPix Package with version 1.340 (or later) should be installed; refer to the article below to upgrade your current package: How to upgrade SharinPix package

• The SharinPix Forms Admin or SharinPix Forms User permission set should be assigned to all users to ensure they have the right to create, edit, and delete the SharinPix Form Response record through the SharinPix Form Response Sync Setting. For more information on these two permission sets, check SharinPix Permission Sets.

Creation of a Lookup Relationship Field

Depending on the Object you want to use SharinPix Form Response Sync on, you must create a lookup relationship field on the SharinPix Form Response Object which links to the parent object. This demo will make use of the SharinPix Visit object.

Follow the steps below:

• Go to Setup, then access Object Manager

• Type form in the search bar, press Enter, and click SharinPix Form Response

• On the left menu, click on Fields and Relationships and then click on New

For the new field:

• Select Lookup Relationship as Data Type then click Next

• For the field Related To, select SharinPix Visit then click Next

• On the next page, the field Field Label will be auto-populated

• Enter a Field Name; as an example Visit_Lookup__c

• Leave the other fields as default

• Proceed to the next steps and finally save the new relationship.

When you take a look back at the Fields & Relationships section, you should see the new relationship displayed as shown in the figure below.

• Copy the field name: Visit_Lookup__c as we will need this in our next step.

Warning:

Ensure that you provide at least read access to the lookup field (Visit_Lookup__c in this case) for all users viewing/creating SharinPix Form Response records.

Configure the Custom Metadata

This section demonstrates how to configure the SharinPix Form Response Setting custom metadata.

To do so, follow the steps below:

• Go to Setup and type metadata, then click on Custom Metadata Types

• Select the Manage Records action next to the label SharinPix Form Response Setting

• Create a new record.

• For the field Label, as an example, enter Form Sync on Visit

• The field SharinPix Form Response Setting Name is auto-populated when clicking anywhere outside the text box.

• For the field Parent Object Name, enter the object API name; in our case it is sharinpix__Visit__c

• For the field Parent Field Name, enter the field name of the lookup relationship field created in the previous section, that is Visit_Lookup__c (Remember the field name we asked you to copy? You can now paste it here)

• Click Save when done.

Warning:

You should be careful when entering values for the fields Parent Object Name and Parent Field Name.

• The field Parent Object Name refers to the object's API Name. In case you are using a custom object, you should ensure that the API name is correctly entered. For example, if you are using a custom object named My Custom Object, the value to be entered for the field Parent Object Name will be My_Custom_Object__c.

• The field Parent Field Name on the other hand refers to the field name of the lookup relationship. You should ensure that the value entered for the field Parent Field Name matches the corresponding field name value in the lookup relationship.