If your Salesforce object uses regular custom fields to store the address rather than employing standard Salesforce Address fields (including the new Custom Address Field) you will need to carry out some additional configuration to enable address validation of these fields. This is achieved through configuration of Touchpoints.
Click on App Launcher. Type EDQ Global Settings in the Quick Find box, and select it.
Select Touchpoints from the left-hand menu.
Click the New button found in the top right to create a new Touchpoint configuration for your Salesforce object.
Set the Touchpoint type to Address and the Address type to Custom then select your Salesforce object from the first dropdown and give your touchpoint a useful name.
Activate the optional Passive validation feature should you wish to use it.
You can then map each address element to a custom field of your choice.
The first mapped field is where our 5 field address validation component will show up in your layout. If the remaining mapped custom fields are present on the active layout, these will be hidden and instead appear as part of the address validation component.
Note that you can have 1, 2 or 3 street elements which can be configured by clicking the + icon next to the street field. Street 2 and Street 3 are optional.
Custom fields of type Text are supported for all address elements with fields of type Picklist also supported by the State/Province and Country elements.
Custom picklist values
Note that the custom picklist values for State and Country must exactly match the values configured elsewhere for this functionality to work and this will depend on whether you have the "State and Country/Territory Picklists" Salesforce feature enabled or not: Disabled: The custom picklist values must match the equivalent LEDQ Countries "Value" field configured in Custom Metadata Types or "State" field in EDQ State Settings. If necessary the LEDQ Countries "User Value" field should be populated to ensure a match. Enabled: The custom picklist values must match the equivalent "Country/Territory Name" or "State Name" values configured in "State and Country/Territory Picklists".
Multiple street elements
Depending on the number of street custom fields used, the address lines in our API response will be applied in different ways and make use of the concatenation separator configured in the global settings:
Just Street element mapped: The 3 address lines in our API response will be applied to the single chosen street custom field, separated by the configured separator.
Street and Street 2 elements mapped: The first address line in our API response will be applied to the first street custom field. The second and third address lines will be applied to the second street custom field, separated by the configured separator.
Street, Street 2 and Street 3 elements mapped: The three address lines in our API response will be applied to the equivalent street custom field.
Handling of fields missing from the Page Layout
In order for the custom fields configured in a Touchpoint to be transformed into a set of EDQ validated address fields on the page, all of the custom fields must be present in the Page Layout. If any fields are missing from the Page Layout the Touchpoint will fail to initialize and the EDQ Record Detail component will fall back to displaying the standard Salesforce fields. In addition, an error message will be displayed in the browser console indicating that this has happened and what field(s) are missing. Here is an example:
