Network Bridge


Use the Network Bridge to run and monitor the data subscription jobs that export data from Network to Veeva CRM within Network. Previously, these jobs were run from Veeva CRM using the Network Subscription Process.

The Network Bridge integrates the CRM account mappings so the target subscription files are transformed into Veeva CRM format. Veeva CRM accounts will be updated with the data from Network; for example, accounts will be merged or deactivated, and addresses can be updated with license data (DEA, SLN, CDS, ASSMCA, OhioTDDD).

You can configure the following types of Network Bridge:

  • Single country bridge - Manage and maintain the CRM data subscription process for a single country.

  • Multi-country bridge - Manage and maintain the CRM data subscription process for a multiple countries. Each country is created as a read-only child bridge.

Enabling the Bridge

This feature is enabled by default for all new Network instances. Previously, the CRM Data Subscription was used to run these jobs; it was deprecated on October 1, 2021. Existing Network instances have been migrated to the Network Bridge.

Benefits to using the Network Bridge

Network fields are mapped to CRM accounts so that the data is integrated as soon as the subscription job completes. Depending on the Network Settings that are configured in Veeva CRM, the following actions can be taken during a subscription job:

  • Delete sub-object account records if they are inactive in Network.
  • Deactivate HCOs, HCPs, and addresses in CRM based on their inactive status in Network.
  • Populate the address sync fields in CRM if the Network Address Inheritance feature is enabled
  • Merge or deactivate CRM accounts if they are merged or inactive in Network.

  • Update CRM addresses with the following license data from Network: DEA, SLN, CDS, ASSMCA, Ohio TDDD.

  • Filter the ParentHCO records that are included in the subscription job based on the value for the Filter Allowed Relationship Types option in the Network Settings in Veeva CRM.
  • Process and load state licenses quickly in batches.
  • Update all mapped fields for records inactivated during the Network Bridge process.

    This requires the CRM setting FILTER_INACTIVE_RECORDS_vod to be enabled with a value of 1. For more information about the CRM setting and sync options, see the topic called Handling Inactive Network Records in the Veeva CRM Online Help.

  • Delete addresses with the record state Merged_Into that were associated to DEA licenses. The CRM setting, NETWORK_ADDRESS_DELETION_PROCESS_vod__c must be set to 1 or 2. When the setting value is 2, the last address or primary address on the account is not deleted. For more information about this setting, see Handling Inactive Network Records in the Veeva CRM Online Help.

  • Trigger other jobs to run when a single-country Network Bridge job completes, or trigger the Network Bridge subscription to run when other jobs (for example, source subscriptions) complete.
  • Manage and maintain the CRM data subscription process for multiple countries using one Network Bridge configuration.

Prerequisite tasks

Before you create a Network Bridge, complete the following tasks:

  • Network - Veeva CRM configuration - Ensure that the integration is complete.

  • Add Veeva CRM credentials - Create the credentials to access the CRM org.

  • Create the target subscription - Configure the subscription that will export the data to Veeva CRM.

See the sections below for details about each task.

Network - CRM configuration

Before the Network Bridge can be used, the integration between Network and CRM must be complete. For more information, see the topics in the Veeva CRM Online Help: https://crmhelp.veeva.com/doc/Content/CRM_topics/Integration/Network_Integration/Introduction_and_Background.htm.

Add Veeva CRM credentials

Salesforceâ„¢ credentials are required for the Network Bridge. You can run the Network Bridge with the CRM org credential to access the Salesforceâ„¢ credentials that are stored in Veeva CRM. Using the CRM organization ID, Network can access the Salesforce session ID so administrators only have to update the credentials in Veeva CRM.

You can also run the Network Bridge using your Salesforce credential.

Prerequisite

Before you create the CRM org credential, ensure that valid Network and Salesforce credentials are stored on the Network Administration page in Veeva CRM.

For more information, see the Administrative Tools topic in the Veeva CRM Online Help.

Add the credential

To add the CRM org credential in Network:

  1. In the Admin console, click Settings > External Credentials.
  2. On the External Credentials page, click Add Credentials.
  3. In the New External Credential dialog, choose Veeva CRM - Org ID from the list.
  4. On the New External Credential page define the following information:

    • Name - Type a meaningful name.
    • Organization ID - Type the 18-digit CRM Organization ID.

  5. Click Test Connection to ensure the credentials are valid.

    To test the credentials, an API call to Veeva CRM checks for valid Network credentials, valid Salesforce credentials, and that the Network user exists in the instance.

    A panel displays information about the environment that the credential is linked to. It also provides warnings if you are potentially connecting to the wrong environment; for example, if the credentials connect your Sandbox Network instance to a Production CRM org.

  6. Save your changes. If you did not test the credentials, they will be tested now. Invalid credentials will not be saved.
  7. The credentials are stored and can be used in the Network Bridge configuration.

Configure the target subscription

Before you create the Network Bridge, define the target subscription configuration that you'll use for the bridge. There are a few recommended settings for subscriptions that are used to export data to Veeva CRM.

  1. In the Admin console, click System Interfaces > Target Subscriptions.

  2. Click Add Subscription.

    Configure the settings in each section.

  3. Details - Define the following settings:

    • Name - Type a relevant name for the subscription.

    • Type - Choose Data.

    • System - Expand the list and choose the Veeva CRM org that you will export the data to.

      If you haven't defined a system for the CRM org yet, go to System Interfaces > Systems and create the system.

    • Description - Type a meaningful description for this subscription so it is clear that is used for a multi-country Network Bridge.
  4. General Export - These setting values are recommended for target subscriptions for single country and multi-country Network Bridges.

    Targeted Record Options

    • Full Data Extract - Choose Delta to export only the changes that occurred since the subscription last ran.

    • Record Type - Choose Non-Candidate to export all records except for candidate records.

    • Record State - Choose All so records with all record states are exported.

    • Export Only Updated Sub-Objects - Do not select this setting. All sub-objects should be exported in this subscription.

  5. Hierarchy - Determine the related entities to export.

    • Level of Hierarchy to Export - By default, one level of parent will be exported to ensure that relationships are intact.

    • Apply "Export Options" to the target records related entities - Choose this option if you want to filter the related entities that are exported based on any filters that you apply in the Export Options section below.

  6. Reference Data - Do not select Include Reference Data Files. It is not required for this Network Bridge subscription.

  7. File Format - Do not change the default values in this section. Veeva CRM expects target subscriptions to be comma delimited and to have a header row.

    Format - The format of the export file. This is set to CSV by default.

    Encoding - The encoding for the export. This is set to UTF-8 by default.

    The following options help exported files to comply with CRM's file acceptance format.

    Delimiter- The character used to separate values in the exported .csv file. Choose comma (,).

    Text Qualifier - The character to identify the beginning and end of text. Choose double quotes (").

    Include header row? - Ensure that this is selected so the .csv file contains a header row.

    Export File Format - Defines how the file is exported. Choose Compressed single file (default). This means that one compressed file will be exported and it will contain .csv file for each object.

    Compression Format - Choose the Zip (zip) compression format. The target subscription will export one .zip file which will contain a .csv file for each object.

    Export File/ Folder Name - Choose one of the following options:

    • Default - The file exported with the following naming convention: exp_########.
    • Include Name and Timestamp - The file is exported with the following naming convention: <subscription name>_YYMMDDTHHMMSSSSS; for example, CRM_Target_170113T191503397.
    • Static Name - Do not choose this option. This exports the file with the same name, so the file and folder will be overridden each time the job runs.
  8. Export Locations - Choose to save the exported file in the following locations:

    • Default - The default path is outbound/<system_name>.

    • Custom - Define a custom path.

      Administrators can give users specific access to FTP folders, so identifying a custom path for this subscription enables you to protect the data. For more information about identifying FTP folder access for users, see Add a user profile. Custom paths are not validated, so ensure that they are correct so your job does not fail.

      For information about accessing the files in your Network file system, see File Explorer.

    • Export to Cloud Storage - Export the data directly to your private cloud storage. Exporting to Amazon S3 buckets are supported.

      The Amazon S3 bucket must be created with write access so you can export the files. For more information, see Exporting data to cloud storage.

  9. File & Field Selection - Displays all the enabled objects in your Network instance that you can export with this subscription.

    • Veeva standard objects - Accept the Export All Fields default value.

    • Custom objects - For each custom object, choose the level of export.

    • Custom Key - Choose Do Not Export.

  10. Export Options - Filter the objects to export.

    • Single country Network Bridge - Typically, a Primary Country filter defined.

    • Multi-country Network Bridge- Country filters are not required. They are automatically applied when the Bridge job for each country runs.

      A target subscription for a multi-country bridge will have the following filter groups defined for HCOs and HCPs:

      • Group 1

        • Field - Source System

        • Condition - Contains

        • Value - The system for the CRM org.

      • Group 2

        • Field - Defined Query

        • Value: send_to_crm__c:in:Y

          This query means that the record will be exported if the send to CRM flag is set to Y.

  11. In the Job Trigger Configuration section, accept the Manual option to run the subscription. The schedule for the subscription will be set in the Network Bridge configuration.

  12. Save your changes.

The target subscription is available and can be applied to the Network Bridge configuration.

Next step

When the prerequisite tasks are complete, you can configure the Network Bridge.

Add Network IP addresses to the CRM allowlist

If Salesforce credentials are not validating in Network, Veeva CRM administrators might need to add the Network NAT IP addresses in CRM to your allowlist.

To include the Network IP addresses as trusted IPs in Veeva CRM:

  1. Log into to Veeva CRM as a system administrator.
  2. On the right side of the page, click on the user name and select Setup.

  3. In the Administration Setup, expand the Security Controls section and select Network Access.

  4. At the top of the Network Access page, click New.

  5. Create entries by filling in the Start IP Address and End IP Address for the NAT gateway for each of the following IP addresses:

    US IP addresses EU IP addresses
    13.59.225.31 34.241.15.234
    18.188.140.111 34.243.156.248
    18.216.182.16 52.208.136.96
    18.216.246.38 52.209.181.239
    18.217.229.142 52.210.45.166
    18.218.18.216 52.210.157.80
    18.219.254.2  
    18.219.254.183  
    18.222.10.133  
    52.15.239.60  

Export Network Bridge configurations

Network administrators can update configurations between Network environments by exporting and importing configuration packages. Network Bridge configurations can be included in export packages so they can be imported to another environment. For example, you can test the Network Bridge in your Sandbox environment and then create an export package with the configuration and import it to a Production environment.

Note: Salesforce credentials are not migrated through configuration management.

Dependencies for multi-country bridges

When you create the export package and add the multi-country bridge, the following dependencies are automatically added:

  • Child bridges

  • System

  • Target subscription

The following dependencies are excluded from the package:

  • External Credentials

  • Schedules

Schedules and credentials must be created in the target environment.

Considerations for multi-country bridge name updates

Changes to the multi-country bridge name in the source environment will not update child bridge names that have been added in the target environment.

For more information about moving configurations between Network environments, see the topic called Managing Configurations.