Riva CRM Integration - Documentation and Knowledge Base

Advanced Options to Control Riva Delete Polls for CRM Data

Article ID: 890
Last updated: 30 Sep, 2015

There is a solution if Riva consumes too many API calls or web service calls when sending queries to the CRM, asking if there are item deletions that need to be synced to Exchange. Advanced custom options are available to control the frequency for delete polls and scheduling when delete polls are permitted.

Delay the Execution of Delete Polls

Riva 2.4.29 included an advanced option that can be applied to the service or in a sync policy. It prevents the delete portion of normal polls until a minimum amount of time has elapsed.

To apply the custom option

  1. To apply the delete poll delay to

  2. Apply the following custom option key and value:

    "Sync.Crm.MinDeletePollIntervalSeconds" = "xxx..." (Specify an integer value for the number of seconds for the desired delay.)

    Example. Set a delay of once every 4 hours = 60 seconds * 60 minutes * 4 hours = 14400

    "Sync.Crm.MinDeletePollIntervalSeconds" = "14400"

Notes

  • If this option is applied to a sync policy, it takes effect after the sync policy is saved.
  • If this option is applied to the Omni.Riva.CrmAgentEx.exe.config file, the service must be restarted before the option takes effect.

Schedule When Delete Polls Are Permitted

Riva 2.4.32 added custom options that can be applied to the service or in a sync policy. They permit scheduling a "time window" (start and end times) when Riva can execute delete polls.

To apply the custom option

  1. To apply the schedule of delete polls to

  2. Apply the following custom option keys and values:

    Sync.Crm.AllowedDeletePollTimePeriod.StartTime = "HH:MM" (Set the start time for the schedule window; for example "08:00" for 8 am, and "22:00" for 10 pm.)
    Sync.Crm.AllowedDeletePollTimePeriod.EndTime = "HH:MM" (Set the end time for the schedule window.)

    Example. Set a delay of once every 4 hours = 60 seconds * 60 minutes * 4 hours = 14400

    "Sync.Crm.AllowedDeletePollTimePeriod.StartTime" = "19:00"
    "Sync.Crm.AllowedDeletePollTimePeriod.EndTime" = "23:00"

    Module-level scheduling is supported. Indicate "Contact", "Lead", "Calendar", "Task", "Email", "Case", "Opportunity", "Contract", "Project", etc.

    "Sync.Crm.AllowedDeletePollTimePeriod.StartTime.Contact" = "21:00"
    "Sync.Crm.AllowedDeletePollTimePeriod.EndTime.Contact" = "23:00"

Notes

  • Specified times match the time zone and time settings of the Windows system hosting the Riva server.
  • If these options are applied to a sync policy, they take effect after the sync policy is saved.
  • If these options are applied to the Omni.Riva.CrmAgentEx.exe.config file, the service must be restarted before the option takes effect.
  • If the custom option to delay the execution of delete polls has been enabled, reset the interval to be a maximum 50% of the total length of the delete poll schedule time window. For example, if the schedule provides a time window of 4 hours, reset the delay to a maximum of 2 hours. This guarantees that the delete poll executes at least once during the scheduled delete poll window.
  • Added to Snapshot Polling - Riva 2.4.37+

Applies to

Article ID: 890
Last updated: 30 Sep, 2015
Revision: 2
Views: 6506
Also listed in