1. Define the evidence before comparing it.
Write down the object or subset, extraction time, filters, expected source population and the fields that matter. Keep a copy of both exports and the rules used for each run.
The checker records input hashes and selected rules. A file hash helps identify the bytes used for a run; it cannot establish that the extraction itself included the right population. The migration owner must verify the exports against the intended scope.
Compare a defined set of deal records from a test migration. Match the retained source deal ID. Check amount, owner ID and company ID. Review live permissions and attachments through separate checks.
2. Establish record identity.
The current checker expects a stable source identifier retained in the destination export. A destination system’s newly assigned ID is not a substitute unless the agreed matching route preserves the source ID.
Inspect missing identifiers, duplicate identifiers and source records without a match. Multiple destination rows carrying one retained source ID create an ambiguous match. Resolve the ambiguity before treating those records as compared.
DEMO-D005 appears twice in the destination. Both target rows are skipped for that identifier. DEMO-D006 has no matching target row. The report therefore compares four of six source records.
3. Agree what equality means for each field.
Use exact text when the value must be preserved as written. Decimal equality can compare numeric representations such as 2500.00 and 2500, but it does not establish the correct currency, unit or business meaning.
If a migration deliberately changes a value, document the expected transformation before accepting it. An explicit accepted mapping should describe the approved change. Retain the original findings and rule set when rules change, so the reason for the rerun remains visible.
Two blank fields can be equal while both are invalid business data. Comparing an owner or company ID as text also cannot establish that the referenced record exists or has the right access.
DEMO-D002 changes from 2500.00 to 2400.00. Decimal comparison identifies a difference. A reviewer must decide whether it reflects an error or an approved business change.
4. Read coverage alongside findings.
Record how many source records were compared and how many were skipped. Read identity findings before interpreting field differences. Equal source and target row totals can hide missing records and duplicates.
| Run | Source rows | Target rows | Compared | Findings |
|---|---|---|---|---|
| Original sample | 6 | 6 | 4 of 6 | 5 |
| Corrected sample | 6 | 6 | 6 of 6 | 0 |
Both runs have the same row totals. The original still contains a duplicate, a missing record and three selected-field differences. The corrected sample deliberately restores the matches and chosen values.
Read the HTML, CSV and JSON evidence. These are fictional fixtures, not measured customer outcomes.
5. Keep a decision record and rerun the same scope.
For each finding, capture the record ID, affected field, source and target evidence, decision, responsible owner and next action. Classify expected transformations separately from defects that need correction.
After corrections, rerun the agreed comparison using fresh exports. Preserve the earlier report. If the fields, rules, scope or extraction filters changed, document that change; a lower finding count alone cannot establish that the same checks passed.
The website’s review notes are separate annotations. Marking an item reviewed does not alter the checker’s finding or repair the underlying record.
Use the ten-point review checklist →6. Keep the wider acceptance decision visible.
State what the comparison covered and what still needs separate evidence. A zero-findings result applies to the supplied rows, selected fields and rules. It does not certify the whole migration.
- Confirm extract completeness against the intended business population.
- Check unselected fields and required business values.
- Test attachment content and accessibility.
- Review effective permissions, automations and workflows in the live system.
- Verify relationships and downstream behaviour where relevant.
A named business owner should make the final acceptance decision using the combined evidence and unresolved risks.
Put a defined check into practice
Start with an example.
Then agree your own scope.
Download the local evaluation, or discuss a £395 indicative reviewed pilot for one object or agreed subset: up to 5,000 records per export, five agreed fields and one scoped rerun.
