Configuration
Welcome to the Altrata Salesforce App. This guide will help you through the onboarding process, including:
- Configuring Data Settings: Enhance data visibility by adjusting your settings.
- Customizing Salesforce Pages: Learn how to display Altrata fields on your Salesforce profiles.
- Adding Components and Buttons: Set up manual matching and Altrata components.
Follow the instructions below to get started.
Authentication and configuration of the Altrata application can only be done by a Salesforce admin. The changes made in Field Mapping and Data Controls will apply to all Salesforce users
There are two potential methods to access the Altrata app settings.
Method 1
1. Click on the App launcher on the top left in Salesforce
2. In the search box, type Altrata.
3. Click on Altrata.
Method 2
There is a possibility that the Altrata app will appear on your Salesforce navigation bar, if so, simply click on the Altrata tab.
This will direct you to the authentication page within the app.
To enable your organization and Salesforce users to use the Altrata app, an admin must enter their service account details. Once authenticated, configuration changes can be made.
- Enter the service account username in the Username field.
- Enter the service account password in the Password field.
- Enter the API key. The API key would have been sent to the admin separately from the installation URL and installation key email.
- Click the "Verify" button.
Field mapping ensures the matching logic is optimized and high quality matches are made. Accurate field mapping is crucial for accurate bulk matching between Salesforce and Altrata.
- On the Field Mapping tab, you will see three tabs on the left-hand side, allowing you to match any of the three record types (Note: Person Account will only appear if it is enabled in your Salesforce environment).
- Fields with a red asterisk are mandatory and must be mapped.
- Mandatory fields will be pre-populated for your convenience.
- Fields without a red asterisk are optional and can be mapped at your discretion.
To change mappings:
- Press the "Edit" button in the top right corner.
2. Click into the Salesforce field and select a value from the drop-down menu.
3. Click ‘Save’.
To disable a row, click the disable icon next to each row.
Overview: The Data Controls GUI empowers customers with an intuitive interface to manage their Salesforce data integration with Altrata effectively. Through simple options including Override and Fill Empty, users can customize their data synchronization preferences to align with their business requirements. This user-friendly feature ensures data integrity while offering flexibility and control, ultimately enhancing the overall Salesforce experience.
The Data Controls GUI offers multiple features designed to streamline data management and enhance user control:
- Override Option:
- Function: Replaces existing Salesforce data with Altrata data, enabling users to synchronize data across platforms effortlessly.
- Example: If you have enabled override for your Salesforce field ‘First Name’ and in your Salesforce environment you have Bill Gates as a contact. However, in Altrata, we have him as William Gates, then that contact will display as William Gates.
- Note: Use carefully. Once the Override is set for a field, the original data is not retained. If the Override is later disabled or removed, the field will remain populated with the Altrata data unless new data is manually inputted by the user. The Override will not occur again if the Altrata data for that field changes.
- Example: Continuing with the previous example, If your first name Bill is overridden by Altrata first name William and then the Override is disabled, William will remain until manually changed, even if Altrata updates their own data from “William” to “Bill”.
- Fill Empty Option:
- Function: Populates only empty Salesforce fields with Altrata data, ensuring efficient data enrichment while minimizing unnecessary updates.
- Example: This option is ideal for filling in gaps in your data. For instance, if your Salesforce environment has 100 account records but only 50 have ticker symbols, configuring the Fill Empty option for ticker symbols will populate the missing 50 records with ticker symbols if Altrata has the relevant data.
To edit fields and data preferences:
- Press the "Edit" button in the top right corner.
- Click into the field and select a value from the drop-down menu.
- In the data preference control field, select one of the options.
- Click “Save”.
To apply one data preference control method for all fields:
- Tick the "Select All" checkbox.
- Select a data control preference in the Data Controls drop-down menu.
- Click "Save".
To include Altrata fields on the Details Tab, follow these instructions:
- Navigate to Record Page: Open a Salesforce object record page (e.g., Contact, Lead, Account).
- Edit Page: Click the gear icon in the top right corner and select ‘Edit Page’.
3. Select Fields: Click ‘Fields’ to view the available fields in the side menu.
4. Drag Fields: Click and drag a field from the side menu to your desired location on the page
5. Suggested Locations for Altrata Fields:
a. Contact Information Section
b. Custom Altrata Field Section:
- Click the '+' symbol on your desired location on the page
- Click ‘Field Section’
- Rename the section to ‘Altrata’
- Click ‘Save’ to finish
Apply Changes to Other Objects
To apply changes to other Salesforce objects (Lead, Account, Person Account if enabled), click the 'Pages' dropdown arrow and select the desired Salesforce Object.
By default, your Salesforce pages will not include Altrata components. Adding these components allows you to see relevant data and enable manual matching for some or all of your users.
To enable manual matching, you will need to do the following:
- Go to a Lead, Contact or Account record.
2. Select a record.
3. Click the gear icon on the top right hand of the page and select "Edit Page".
4. In the left-hand search bar, type “profileSearch”.
5. Click and drag the component to your desired location on the page.
6. Click “Save”.
To add page components:
- Repeat steps 1-3 from "Manual Matching".
- Select a custom component from the Custom section on the left-hand side.
- Drag the component to the desired location on the page.
- Click "Save".