Sync User Attributes From Salesforce
Sync User Attributes from Salesforce to Ambition
Using Ambition's User Attribute Sync, you can automatically map over changes in user attributes from Salesforce to Ambition. Administrators can configure these sync settings for multiple Ambition User Fields at once (i.e. Roles, Permissions, Groups, Locations.).
Once the user attributes are mapped over to Ambition, any changes to the user's profile in Salesforce will automatically be reflected in Ambition.
If you have existing groups tied to scorecards in Ambition, read these additional directions.
Note: If you wish to map users into specific Group Types - Location, Competition Team, Department, etc - ensure those Group Types exist in Ambition before attempting to sync.
Learn more about Groups and Group Types here.
Enable User Attribute Syncing
1. Open the left navigation and click Administration > Data > Integrations.
2. Click Edit in line with the Salesforce integration.
3. Click on User Sync Configuration.
Don't see the User Sync Configuration tab or the User Attributes option? The feature can be enabled by any user with system admin permissions. Enable Feature: Open the left navigation and click Administration > Features. Locate the Salesforce User Field Syncing feature, and toggle "On". Click the Update Features button to save.
4. Click Add to begin mapping your Salesforce User Attributes to the corresponding Ambition field.
Salesforce Fields: Salesforce User fields that contain the input value to map to Ambition. For example, when mapping to an Ambition group, choose the Salesforce field that contains the name of the group.
- These fields include any attribute found in your Salesforce account. In order to quickly find the correct field, begin typing to search by name.
Changes Made in Salesforce will be mapped to Ambition.
Ex: Spelling Errors: If a field (team, department, etc.) is misspelled in Salesforce, Ambition will create a new Group with the incorrect spelling and assign the User with the incorrect spelling to the newly created Group in Ambition.
Ambition Fields: Ambition user attributes that serve as the destination for the mapped value.
- Available fields consist of User permission levels and any Group Type available in your Ambition account.
5. Once you're finished mapping over the Salesforce User Attributes, click the Save Data Format button.
After your sync'd attributes are submitted, Ambition User data will automatically update whenever the selected fields are updated in Salesforce.
Group Syncing with Existing Ambition Groups
These options are intended for Ambition/Salesforce customers who would like to automatically sync user attributes (e.g. UserRole assignments) from Salesforce objects to Ambition groups, but who already have Ambition groups tied to configuration like scorecards. If group names in Salesforce don't match those in Ambition, new groups will be created and the associated users will be reassigned in Ambition.
There are two options to help facilitate a sync when Ambition Groups already exist:
If you can afford to change either the group names in Ambition to reflect those in Salesforce, or vice versa, this is the simpler option. You only need to be an admin of Ambition or Salesforce, depending on where you want to update the names. It is extremely important that you guarantee that the names in both systems match exactly.
If changing group names in Salesforce or Ambition is not an option, you can use the following work-around to achieve the same configuration:
In this example, we'll be implementing the work-around for the UserRole object to map to Ambition Role-type group assignments
- Add a custom, string-type field to UserRole (e.g. UserRole.Ambition_Name__c)
- Set the value of this field for all UserRole records that have associated Ambition users. These values must match the corresponding group names in Ambition exactly.
- Create a support ticket to re-sync User fields in Ambition, in order to recognize the newly created custom field
- Within Data Configuration, configure the sync'd attributes as you normally would, but select the new custom field as the Salesforce field and Group: Role as the Ambition field
- Submit the form