Restore Deleted Exchange Items and Uncancel Exchange Calendar Items

Contents:

• Introduction.
  • Requirements.
  • Results of the restoration.
• Restore deleted contacts –or– Restore deleted tasks –or– Restore deleted calendar items and uncancel canceled calendar items.
  • In Riva 2.4.55 or higher.
  • In Riva 2.4.45 through Riva 2.4.54.

Introduction

Such restorations can be made

• with a preview (a "dry run") of the changes to be made;
• within a specified Modified Date range; and
• for one, some, or all users.
   

The restoration may be necessary, for example, if some of the CRM permissions essential to Riva were mistakenly revoked.

Requirements

• The metadata of the Riva transactions that took place during the specified Modified Date range is still available.
• Exchange is set to soft-delete the types of items that need to be restored (contacts, tasks, and/or calendar items).
• No one has permanently deleted the items that were soft-deleted within the specified Modified Date range.

Results of the restoration

Specifically, the Exchange items that were deleted or canceled within the Modified Date range are processed as follows:
 

Restore Deleted Contacts –or– Restore Deleted Tasks –or– Restore Deleted Calendar Items and Uncancel Canceled Calendar Items

• In Riva 2.4.55 or higher.
• In Riva 2.4.45 through Riva 2.4.54.

Restore deleted items in Riva 2.4.55 or higher

To restore deleted contacts –or– restore deleted tasks –or– restore deleted calendar items and uncancel canceled calendar items:

1. While preparing to re-initialize the affected users, be sure to do the following in the Re-Initialize Users window:

   1. In the Module field, select the module that the items to restore or uncancel belong to.

   2. In the Category field, select Troubleshooting.

   3. In the Type field, select Restore deleted items.

   4. Below the re-init option, to the right, select Configure.

      Result: The Restore Deleted Exchange Items window appears. Its fields list the selectable advanced options in plain English.

2. In the Restore Deleted Exchange Items window, configure the following items:

   1. Select the module type: Select the module or modules that the items to be restored belong to.

   2. Start Date: The beginning date of the Modified Date range designated for the restoration.

   3. End Date: The end of the Modified Date range designated for the restoration.

   4. Run in dry-run: — Highly recommended. — Executes the Restore deleted items re-init option in a dry run (investigative mode) instead of performing the restoration. The dry run lists, in the logs, all the changes that the re-init option would perform during an actual restoration. By viewing the logs, you can ensure that the restoration will do exactly what you expect. If the dry run results are satisfactory, re-open this window, clear the Run in dry-run check box, and continue with the remaining steps.

   5. Select OK to save the advanced options.

3. In the Re-Initialize Users window, select OK to save the re-init option and the list of users to apply the option to.

4. Save the policy.

5. Enable the policy.

   Result:

   • If you selected the Run in dry-run check box, the logs display all the changes the restoration would make.

   • If you ran this procedure a second time with the check box cleared, the restorations are made.

The following procedure applies to earlier versions of Riva.

Restore deleted items in Riva 2.4.45 through Riva 2.4.54

To restore deleted contacts –or– restore deleted tasks –or– restore deleted calendar items and uncancel canceled calendar items:

1. Apply the following advanced options to the sync policy or to one or more users:

   • Sync.Crm.ReinitRestoreDeletedItems.MinDate = [date] (The beginning date of the Modified Date range designated for the restoration.)

   • Sync.Crm.ReinitRestoreDeletedItems.MaxDate = [date] (The end of the Modified Date range designated for the restoration.)

   • Sync.Crm.ReinitRestoreDeletedItems.TombstoneReplicaId = [type of items]
     where [type of items] is one of the following:

     • CA: Restricts the search in the metadata to CRM calendar items that the sync deleted or canceled in Exchange.
     • CC: (Supported in Riva 2.4.47 or higher.) Restricts the search in the metadata to CRM contacts that the sync deleted in Exchange.
     • CT: (Supported in Riva 2.4.47 or higher.) Restricts the search in the metadata to CRM tasks that the sync deleted in Exchange.

     Note: Only one type of items can be restored at a time. To restore another type of items, repeat the procedure.

   • Sync.Crm.ReinitRestoreDeletedItems.DryRun = true (Highly recommended. Executes the Restore deleted items re-init option in a dry run (investigative mode) instead of performing the restoration. The dry run lists, in the logs, all the changes that the re-init option would perform during an actual restoration. By viewing the logs, you can ensure that the restoration will do exactly what you expect. If the dry run results are satisfactory, proceed with the actual restoration, as described later in this procedure.)

2. Perform a re-initialization with the Restore deleted items re-init option for the same users that the advanced options were applied to.

3. Sync.

4. Examine the logs to see if the results are what you need during the actual restoration.

5. If they are, remove the Sync.Crm.ReinitRestoreDeletedItems.DryRun advanced option or set it to false. Apply the Restore deleted items re-init option to the same users as previously, and sync.

   This time, the sync actually restores the deleted items and/or uncancels the canceled items as described in the table.

6. To restore another type of items, repeat steps 1–5.