Summary: Running a user sync can impact your entire employee user base in Speakap. This checklist makes sure you have reviewed and validated your changes using the Dry run results, and verified the outcomes against your most recent HR export. If needed, you can always revert to a previous sync yourself or ask our team for assistance.
1. Prerequisite knowledge
Before using this checklist, read the guide on the Dry run: Using the Dry run to validate and apply sync changes. You must understand the difference between the "Summary", "Requests to network", and "Payload" sections to perform a valid audit.
2. The mapping change audit
When you modify a Column, Group, or Role mapping, the resulting Dry run should be predictable.
- Quantify your impact: before running the Dry run, estimate how many users should be affected by your rule change.
- Verify the count: make sure the number of changes shown in the Dry run results matches your expected count. If the number is significantly higher or lower, re-examine your mapping expressions.
3. Verification through sampling
Never rely solely on the summary numbers. Verify the Payload for specific individuals.
- Open the export file: in a separate browser tab, open the raw export file from your HR system within User Sync.
- Pick sample users: select a few users from the Dry run who are marked for changes.
- Validate the action: cross-reference their data in the export file against the proposed action in Speakap:
- Suspensions: is the user truly missing from the export, or no longer compliant with the "Active" mapping rule?
- Group removals: is the group being deleted from the network, or did the user simply stop matching the group mapping criteria?
- Data updates: do field changes (like a job title or email update) reflect the exact values in the HR file?
4. The four-eye principle
Human error is the most common cause of sync issues. Use a second set of eyes for significant updates.
- Colleague review: if there is a significant volume of changes, or if you are unsure of an expression's logic, have a colleague review the Dry run results before you hit Apply.
- Final escalation: if internal doubt remains, contact the primary Network Administrator.
- Confirm the scope: specifically ask if it is correct that "X" number of users are being suspended, moved between groups, or imported for the first time.
5. Executing the sync
Only proceed to the final application of changes once all the steps above are complete:
- Click Apply changes.
- Perform the numerical confirmation by typing the exact number of changes shown.
- Monitor the Sync logs immediately after completion to make sure no unexpected errors occurred.
Still stuck?
Email us at technicalimplementations@speakap.nl with your network name and the Dry run results you are unsure about, and we'll help you out.