Source: https://vaultcrmhelp.veeva.com/doc/Content/CRM_topics/Align/Configuration/AlignCRMIntegration.htm

## Integrating Align with Vault CRM

To import and push records between Align with Vault CRM, Align admins must connect the two systems.

Align operational users can access the integration with Vault CRM, including sync history and the field mappings, via the Integrations tab. From this tab, admins can also initiate imports and root level pushes to send records to and from the connected instance.

**Who can use this feature?**

* Align Operational Users – Browser
* [Viewing, Describing, and Editing Field Mappings](#Viewing,)
* [Importing Data from Vault CRM into Align](#Importin)
* [Pushing Data from Align into Vault CRM](#Pushing2)
* Users require an Align License

### Configuring Integrating with Vault CRM for

[![Closed](../../../../Skins/Default/Stylesheets/Images/transparent.gif)All Users](#)

To configure this feature, ensure [Configuring Align](ConfiguringAlign.htm) is complete. Admins can configure the inbound and outbound field mappings between Align and the connected instance of Vault CRM.

#### Mapped Objects Between Align and Vault CRM

Field mappings can be configured for the following objects between Align and Vault CRM:

| Align Object | Vault CRM Object |
| --- | --- |
| aln\_roster\_member\_\_v | user\_\_sys |
| aln\_territory\_\_v | territory\_\_v |

### Viewing, Describing, and Editing Field Mappings as

[![Closed](../../../../Skins/Default/Stylesheets/Images/transparent.gif)Admin Users](#)

Fields in Align are mapped to fields in Vault CRM. Admins can view, enable, or disable standard field mappings, as well as manage custom field mappings, when needed.

To manage the list of field mappings:

1. Navigate to the Vault CRM section of the **Integrations** tab.
2. Select the **Gear** icon.
3. Select **View Field Map**.
4. Select the appropriate tab. The following tabs are available:

   * CRM Objects – The default selection. Field mappings in this tab represent inbound mappings.
   * Align Objects – Field mappings in this tab represent outbound field mappings
5. Select the **+** button next to the appropriate section to view mapped fields for that object.
6. Select **Describe & Edit**.

Mappings in the System Field Mapping section can be activated or deactivated, but not edited. Additionally, admins can define custom field mappings in the Custom Field Mapping section.

When saving edits to mappings in the CRM Objects tab, admins are prompted to initiate a full refresh of records of the edited object. This can be done by initiating a Full Import from CRM from the main Integrations page.

### Importing Data from Vault CRM into Align as

[![Closed](../../../../Skins/Default/Stylesheets/Images/transparent.gif)Admin Users](#)

To import data from Vault CRM:

1. Navigate to the Vault CRM section of the **Integrations** tab.
2. Select the **Gear** icon.
3. Navigate to **Admin > Configuration > Application Configurations > Align Integration Administration**.
4. Select **Import from CRM**. A modal displays all objects that import into Align.
5. Select **Continue**.

After initiating the import, a process task is created for the import, recording the start time, end time, errors, and successes of the overall import.

Each object imported from Vault CRM has a dedicated aln\_process\_monitor\_\_v record that updates with the latest date the object was imported from Vault CRM without aborting, regardless of errors occurring during the import. Each import only retrieves records added or updated since the latest date for each object.

#### Self Assignments

Align will import any account assignments that have originated in CRM, so that they persist. This is typically in the scenario whereby a field user in CRM has self-assigned an account.

#### Account Merges

When an account is merged in Vault CRM, the following process occurs:

* The account\_territory\_\_v records from the losing account get re-parented to the winning account
* The aln\_account\_territory\_\_v records get re-parented to the winning account
* The losing account gets deleted

During the subsequent Import-to-Align, the following process occurs:

* If there is an overlapping manual aln\_account\_territory\_\_v record with the same account\_\_v, territory\_\_v and source\_\_v values on the winning account, then the winning aln\_account\_territory\_\_v record has its start and end dates extended to include the lifespan of the losing aln\_account\_territory\_\_v record. The losing aln\_account\_territory\_\_v record gets deleted.
* All other aln\_account\_territory\_\_v records that originated from the losing account persist

During subsequent rules-run in Align, the rules engine end-dates rule-sourced aln\_account\_territory\_\_v records that became duplicates due to the re-parenting performed by Vault CRM.

#### Deleted Accounts

When an account is deleted in Vault CRM, the deleted account’s manual assignments are end dated during the subsequent Import-to-Align. During the subsequent rules-run in Align, the deleted account’s rule-based assignments are end dated.

The first time Align syncs with Vault CRM, all account\_territory\_\_v records import into Align as explicit assignments. To avoid this, users should delete all account\_territory\_\_v records from Vault CRM before syncing Align with Vault CRM for the first time.

### Pushing Data from Align into Vault CRM as

[![Closed](../../../../Skins/Default/Stylesheets/Images/transparent.gif)Admin Users](#)

After linking a Vault CRM instance to an Align instance, users can push records of the following Align objects to Vault CRM:

| Align Object | Vault CRM Object |
| --- | --- |
| aln\_territory\_\_v | territory\_\_v |
| aln\_account\_territory\_\_v | account\_territory\_\_v |
| aln\_roster\_member\_\_v | user\_territory\_\_v |
| aln\_territory\_product\_\_v | my\_setup\_products\_\_v |

The push to Vault CRM performs the following operations:

* Create net-new records of objects in Vault CRM based on active assignments in Align
* Delete records that are past their end-date
* Update existing Vault CRM territories if the corresponding Align territories have been modified since the last push

This process only considers records modified since the last successful push to Vault CRM. Records that failed to update even though the last push was successful overall are also considered.

Once Align is configured and used for territory management, it is expected that all user territory assignments are sourced from Align. This means that user\_territory\_\_v records are deleted if no active aln\_roster\_member\_territory\_\_v record for that roster member / territory combination exist.

Operational users can initiate pushes to Vault CRM from either the Integrations page, or from an individual territory.

#### Pushing from the Align Integration Administration Page

Pushing from the Integrations page pushes all changes relevant to the Vault CRM instance:

1. Navigate to the Vault CRM section of the **Integrations** tab.
2. Select the **Gear** icon.
3. Navigate to **Admin > Configuration > Application Configurations > Align Integration Administration**.
4. Select **Push to CRM**. A modal displays all objects that push from Align into Vault CRM.
5. Select **Continue**.

#### Pushing at the Territory Level

Unlike pushing from the root level, pushing from a specific territory pushes only those changes associated with the selected territory and its descendants. Unrelated territories and assignments are not exported:

1. Navigate to the appropriate aln\_territory\_\_v record.
2. Select the **Gear** icon.
3. Select **Push to CRM**.

Both push processes import all new account\_territory\_\_v records into Align, regardless of which territory they apply to.

When using the [User Management](../UserMgmt/UserMgmt.htm) feature to master roster members in Align, the following behavior differences apply:

* All Roster Members mastered by Align are included in pushes to Vault CRM from the Align Integration Administration Console
* Pushing to Vault CRM from a Territory includes all Roster Members with an active Roster Member Territory assignment to that Territory or its descendants. This includes only active Roster Members that are Mastered by Align.

### Configuring Country Filters as

[![Closed](../../../../Skins/Default/Stylesheets/Images/transparent.gif)Align Operational Users](#)

Users can select a subset of countries to be mastered by Align. For example, a Vault CRM instance could cover all countries in Western Europe while users want to master assignments only for France and Germany. Users can assign a set of countries to a Vault CRM instance through the Vault CRM Instance Countries section of the Vault CRM Instance Details page. Users can only select active countries for this list.

Once users have selected a set of countries, imported objects are subject to the following logic:

* Accounts only import only if their vcountry\_\_v field references a selected country
* All addresses for such accounts are imported. Addresses belonging to accounts that do not reference a selected country are not imported, even if the address is in a selected country.
* Parent HCOs import only if both the Child and Parent Accounts belong to a selected country
* All Product Metrics for selected accounts import
* All roster members imported regardless of country, since roster members can be tasked with either regional or global territories

Users must run a Full Refresh Import after adding a new country to the list of selected countries for a Vault CRM instance. This ensures all appropriate account, address, and child account records in the Vault CRM instance are added to Align.

This selection also affects pushes to Vault CRM. Align only pushes territories to Vault CRM when the territory's country is one of the selected countries, and it only pushes account territories to Vault CRM when both the territory and account belong to one of the selected countries.

Users can remove an item from the list of selected countries by deactivating that country's record. Once a country's record is deactivated for an instance, Align no longer imports records for that country and no longer masters that country's territories and assignments in Vault CRM. However, deactivating all selected countries results in importing all records from Vault CRM, regardless of country.

### Related Topics

[Configuring Align](ConfiguringAlign.htm)

[Managing Align Territories](../TerrAssignment/ManageTerr/Territory.htm)

[Managing Geographies in Align](../TerrAssignment/ManageGeo/Geography.htm)