Our plugin for Salesforce supports lightning and contains the following features:
- Company Information Lookup
- TPS and CTPS checking
- Bank Account Validation
- International Telephone Validation
- Telephone Formatting
- Email Validation
- Unusable Name Validation
Our plugin makes use of the lightning update to integrate PredictiveAddress, real-time validation, and TPS checking (amongst a variety of other services) into record forms for standard and custom objects and can even be applied to custom fields.
- Install the Data8 Salesforce plugin by visiting the install link provided, or by clicking the 'Install' button below: https://login.salesforce.com/packaging/installPackage.apexp?p0=04t3w0000019pM7.
- Sign into your organisation and click the ‘Install’ button.
- Agree to allowing requests to the webservices.data-8 domain as this is necessary for our validation API’s to work.
- Once you see the installation complete screen, click the done button.
The Settings Page
This page contains all of the configuration options for Data8 Address Capture and Validation. An API key is required to use our services. This can be found on the Dashboard of your Data8 account. If you don’t already have an account, you can get a free trial of our services on the Data8 website. If you have updated our plugin from an older version, you will have noticed a big change in the layout of this page. All of the existing options are still available, along with some new options to give you further control of validation on your site. We also replaced the username and password authentication method with a more secure API key method. All validation is now performed in real-time, and no longer requires a separate Visualforce component for each service.
To get to the global settings page for the Data8 plugin, follow the below steps:
- Go to the home page of your Salesforce organisation.
- In the App Launcher (top left corner), find and click ‘Data8 Settings’ to open the settings/configuration page.
- Enter your Data8 Api key (found on your Data8 Dashboard).
- Choose the configuration options that suit your needs.
- When you're done, remember to click ‘Save’.
|API Key||This can be a server-side or client-side key. You can create a new key on your Data8 Dashboard.|
|Load Record On Save||When using the record form override implementation, this option determines whether the saved record is displayed after saving, or if a new, blank form is created (for creating records in bulk).|
|PredictiveAddress Settings||There are a variety of settings available for the PredictiveAddress service:
|Other Mappings||Use the various mapping options to set up your mappings for TPS or Bank Account Validation. Add your object from the list and then add mappings per object.|
|Minimal Company Information||Limit the amount of data which the Company Information service displays.|
|Create Contact For Directors||Create contacts for each director when using our company lookup tool.|
Permission Issues caused by the Winter '20 Update
Due to recent changes in the Winter '20 Update, non-admin users will no longer have permissions to read/write to mappings or read from Data8 Settings.
To fix these permission issues, please follow the steps below:
If you are using the updated plugin:
- As an admin go to
Setup > Users > Profiles > Standard User, and
Clonethis profile (or go to your existing custom profile for non-admin users).
Object Settings, ensure the user has
ModifyAllpermissions enabled for the following objects:
Administrative Permissions, check/enable the
If you are using an older version:
If you are on the older version of the plugin you may only need to give the user the
View All Custom Settings permission.
The Winter '20 Security Changes can also cause duplicate mappings so please check these in your Data8 settings after fixing the missing user permissions.
Non-admin users require the
ModifyAll permission for each of Data8's custom objects. Without this, duplicated mappings will be created when saving the Data8 Settings page.
Now that you have the Data8 Salesforce plugin installed and the settings configured, you can choose which services/features you wish to configure for each object.
There are two ways to configure the email and phone validation services, the existing non-realtime method, or the new record form override method that came with the lightning update.
PredictiveAddress can now be implemented into your record details page and can be mapped dynamically to fields of your choice.
The record form override method is pre-configured to use Email, Telephone, Name, and Bank Account validation, Telephone Formatting and TPS checking in real-time.
Record Form Override
Override the default record form to get real-time email, phone, bank account and name validation, telephone formatting and TPS/CTPS checking on your records.
Alternative Validation Implementation Method
The previous method used to implement Data8 validation into your Salesforce instance before the lightning update. This method will be useful to those who do not wish to override the default record form of an object.
PredictiveAddress (autocomplete) can be integrated in two ways: via a lightning record page or via a custom button on the page layout.
Bank Validation Configuration
Our Bank Validation service is integrated into our Record Form Override pages, bringing you real-time validation on bank account details as the record is saved.
Business Information Lookup Configuration
The Business Information Lookup service obtains useful information about a company from a company name or address. It can be added to the page layouts of objects and create a relationship between a record and a company.
TPS checking can be integrated in two ways: via a lightning record page or through a button default action override.
Record Details Displaying Cached Data
There is an issue with data caching on record details pages that can prevent the latest updates from being shown right away. If you experience these issues yourself, follow the steps below to force the page to get the latest data, every time.
- Go to the record details page that you are noticing delayed updates on (only have to do this once per object).
- Click the cog in the top right corner and go to 'Edit Page'.
- Drag and drop the Visualforce page component onto the page layout and then enter 'Data8_Validation_CacheFix' as the name.
- Save and activate the page as an org default.
This Visualforce page is a hidden component which forces the view to load the latest data rather than using a cached source.