Why Did CopyStorm/Restore Skip a Record?

There are a number of reasons that may cause CopyStorm/Restore to skip a record during restore. The most common include:

  • The record references another record that is not in the CopyStorm database.
  • The record references a record that failed to restore for another reason.
  • The record is already in the target Salesforce and has exactly the same timestamp.

There are also a number of Salesforce table specific reasons that will cause a record to be skipped (i.e. operations Salesforce does not allow). For example,

  • Activated Contracts cannot be written to Salesforce.
  • Converted Leads cannot be written to Salesforce.
  • Opportunity Line Items cannot be inserted if they reference an inactive price.
  • Quotes cannot be inserted if they reference an inactive price book.
  • Opportunities cannot be inserted if they reference an inactive price book.

Normally, when a record is skipped the reason is stored as part of the tracker database (an exception to this rule is make for Converted Leads and Activated Contracts). When there is a reason in the tracker database it can be found by clicking on the “Status” of a record — the reason will be displayed in a popup dialog. If no popup dialog appears, CopyStorm/Restore did not record the reason the record was skipped.

There are a few options on the “Global Parameters” tab that can increase the number of skipped record reasons that are recorded. These options can be found under the “Skipped Record Reporting Options”. If you enable all options in this section, the maximum number of “skipped record reasons” will be recorded in the tracker database.