Create, Test, and Edit a Riva Connection to Dynamics CRM 2011+

Article ID: 959
Last updated: 03 Jun, 2019
NOTE: This article applies only to the Microsoft Dynamics CRM 2011+ connection.

If you plan to connect Riva to Microsoft Dynamics CRM 4 and 2011 up to and including Rollup 10 (RU 10), use the procedures found in Create a Microsoft Dynamics CRM legacy connection (Dynamics CRM 4 & 2011).

The Riva connection to Dynamics CRM requires the credentials of an admin account that can impersonate into the target CRM user accounts.

To create, test, and edit a Riva connection to Dynamics CRM:

  1. Ensure that the additional system requirements are met.
  2. Create the Dynamics CRM connection.
  3. If connection errors occur in earlier versions of Riva, upgrade Riva for Dynamics CRM 2016+ compatibility.
  4. Test the Dynamics CRM connection.
  5. Configure contact filter options.
  6. Review how Riva will sync contacts.
  7. Optional: Assign a user-friendly Display Name.
  8. Apply support for the Dynamics CRM plug-in.

Step 1: Ensure That the Additional System Requirements Are Met

In Riva On-Premise 2.4.42 or higher, the XRM-based Riva connection is dependent on the installation of .NET 4.5.2 Framework on the Windows system hosting Riva.

Step 2: Create the Dynamics CRM Connection

  1. Ensure that you have followed the Prepare Microsoft Dynamics CRM for Riva procedure.

    If preparations are not completed, the connection wizard will fail.

  2. Start the Riva Manager application. On the menu bar, select Setup. In the left pane, select CRM: Microsoft Dynamics CRM 2011+ to open the Microsoft Dynamics CRM 2011 Wizard.

  3. On the wizard's Welcome page, do as follows:

    • In Riva 2.4.41 or higher, select Next.
    • In Riva 2.4.40 or earlier, select Install and Start to install and start the Omni Riva (CRM Remote Agent for Dynamics 2011) windows service. When a dialog box displays ON: Service has been detected and is running, select Next.
       
  4. Provide the required information:

    • User Name: Provide the user name for the Riva connection account. This user name can use either one of these formats:

      • The NTLM format of DOMAIN\Username (for example OMNIDEVLABS8\administrator), or

      • The UPN format of username@AD-Domain (for example administrator@omnidevlabs8.com) - Usually used for Office 365 Dynamics Online.

    • Password: Provide the password for the Riva connection account.

    • Address: Provide the URL link to the root-level Dynamics CRM login screen:

      • For Office 365: Select the connection end-point from the drop-down list. Riva supports both Office 365 and Live ID authentication methods for data centers in North America, EMEA, and APAC. It also supports Office 365 authentication for South America and several specific countries: Australia, Japan, Canada, India, and the United Kingdom.

      • For On-Premises or Commercially Hosted: If the URL is actually https://crm.mycompany.com, set Address to https://crm.mycompany.com. Riva also supports port values in the URL, for example https://crm.mycompany.com:444, if that is the root URL.

        For the correct URL, ask your CRM administrator.

    • Organization: Do one of the following:
      • Enter the case sensitive Unique Name. How to find it. Riva validates the entry in the CRM.
        • If it is valid, the ID is used to sync.
        • If it not valid, the sync is prevented and an error appears in the log.
          Note: In Riva 2.4.43.40898 or earlier, if the name was not valid, the first name available on the list of organizations in Dynamics CRM was used, which sometimes caused the sync to be performed for the wrong organization.
        - OR -
      • Leave the field blank.
        • If your Dynamics CRM environment has only one organization, it is used for the sync.
        • If there are multiple organizations, the first organization found on the list of organizations in Dynamics CRM is used for the sync.
           
    • Auth Method: Select either

      • Standard, if the Dynamics server was originally configured for IFD using AD FS 2.0; or

      • Active Directory, if the Dynamics server is configured for direct authentication to AD.

    • Use proxy: Specify a unique HTTP or HTTPS proxy setting that will apply to this CRM connection.

    • Advanced Options: Opens the Advanced Options window, where you can apply advanced options or custom options to this connection. For instructions on how to use the window, select the version of Riva that you are using: Riva 2.4.43 or higher. Riva 2.4.42 or earlier. If you are unsure, see Determine which version is installed.

    • Check user privileges before sync: (Selected by default.)

      • When this option is selected, the sync is prevented for users whose Sync to Outlook CRM privilege is enabled. For more information, see Dynamics CRM privilege error prvSyncToOutlook.
      • When this option is cleared, Riva does not check whether the Sync to Outlook CRM privilege is enabled. In this case, it is absolutely critical that the users currently being synchronized by Riva do NOT use the Outlook plug-in or any other synchronization solutions concurrently.
  5. Select Next.

  6. (Riva 2.4.47 or higher.) On the Additional Connection Options page, optionally select the check box Is the connection user dedicated for synchronization: [user name]. For guidance, see Is the connection user dedicated for synchronization.

  7. On the Successful Connection page, select Finish.

    The Riva Manager application creates a Dynamics CRM connection object.

Step 3: If Connection Errors Occur in Earlier Versions of Riva, Upgrade Riva for Dynamics CRM 2016+ Compatibility

While the connection can be successfully created, connection errors may occur in these releases:

  • 2.4.41 or earlier;
  • 2.4.42.33656 or earlier; or
  • 2.4.43.33658 or earlier.
     

This issue exists with Dynamics 2016 On-Premises only; connections to Dynamics Online (Office 365) work without error.

Your version of Riva may need to be upgraded to make it compatible with Dynamics CRM 2016 or higher On-Premises. For instructions, see Upgrade Riva for Dynamics 2016+ compatibility.

Step 4: Test the Dynamics CRM Connection

To test the new connection to confirm that user impersonation is working:

  1. In the Riva Manager application, on the menu bar, select Setup.

  2. In the right pane, double-click the Microsoft Dynamics CRM connection object to open the CRM Connection Edit window.

  3. Select the Connection Test tab, and select Test Connection.

    The Riva CRM connection account is tested to ensure that the credentials are correct.

  4. In the Test succeeded message box, select OK.

  5. In the User E-mail field, provide the email address for a CRM target user, and select Run Test.

    The system tests that the Riva connection account is able to impersonate into the Dynamics CRM target user account.

  6. In the Test succeeded message box, select OK.

Step 5: Configure Contact Filter Options

In Riva 2.4.35 or higher, the Microsoft Dynamics CRM Connection Edit window includes Pre-defined Filters to define how to filter the contact sync.

Step 6: Review How Riva Will Sync Contacts

For the First Time Sync: Riva creates contacts in Exchange based on the contact filter selected (defined) at step 4.

Poll Changes: Riva syncs changes to contact records based on the filter:

  • Ownership (Owner = current user): As is.
  • My Connections: Relates to contacts only. Changes are updated only if a contact is connected to the user
  • Admin-defined view: Changes are updated based on the defined view.

CRM Contact Deletions: Only if the option to not resync from CRM deleted Exchange contacts is enabled:

  • Ownership (Owner = current user): Regular physical deletion. After a contact is deleted in the CRM, it is deleted in all related mailboxes.
  • My Connections: Relates to contacts only. A contact is not deleted from the CRM, but Riva removes its Connection to the current user.
  • Admin-defined view: Deletions are synced based on the defined view.

Step 7: (Optional.) Assign a User-Friendly Display Name

(The Display Name is supported in Riva 2.4.46 or higher.)

  1. In the Riva Manager application, on the menu bar, select Setup.

  2. In the right pane, double-click the Microsoft Dynamics CRM connection object to open the CRM Connection Edit window.

  3. Optional: Assign a user-friendly Display Name.

Step 8: Apply Support for the Dynamics CRM Plug-In

Riva 2.4.36.18616 or higher includes support for the Dynamics CRM Outlook plug-in (plug-in "compatibility" mode).

To apply support for the Dynamics CRM plug-in:

  1. Apply the following advanced options to the Microsoft Dynamics CRM connection:

    Crm.MsCrm.SetPrimaryClient = true
    MsCrm.PluginCompat.All = true

  2. Disable the "Sync to Outlook" privilege in the Dynamics CRM Role that the target CRM users are assigned to. For instructions and more information, see How to resolve the Microsoft Dynamics CRM privilege error "prvSyncToOutlook".

Applies to

  • Riva On-Premise for Dynamics CRM 2011 or higher,
  • Riva 2.4.36.18616 or higher (for plug-in compatibility),
  • Riva 2.4.38.22199 or higher for the latest pre-defined filter options, and
  • Riva 2.4.42.33657 (or higher) or Riva 2.4.43.33659 (or higher) for compatibility with Dynamics 365 CRM and Dynamics CRM 2016.

This article was:   Helpful | Not helpful Report an issue


Article ID: 959
Last updated: 03 Jun, 2019
Revision: 22
Views: 10820
Comments: 0
Also listed in
folder Riva On-Premise - CRM Sync -> Manage Riva On-Premise (Admin Guides) -> CRM Systems -> Microsoft Dynamics CRM

Prev     Next
Microsoft Dynamics CRM       Filter Dynamics CRM Contacts in Riva with Custom Views


Back to Top