Audience: ClassLink Administrator
Syncs are the devices by which OneSync operates. They include imports from sources, exports to destinations, and dry runs which act as trial runs for exports. When properly set up with automatic syncs, OneSync will provision user accounts from sources to destinations and will require minimal maintenance thereafter. OneSync also allows for manual imports and exports if you want to more closely monitor sync activity.
- Dry Runs
Manual imports can be run by clicking the Run button next to the desired source on the source page. Alternatively, you can enable an automatic import to run for each source by clicking the Automatic Run toggle next to the Run button. By default, automatic imports are set to run every Sunday at midnight. However, you can set a sync schedule within a source's details.
Automatic exports for destinations run continuously and are inherent to OneSync. However, they must be enabled for the desired destinations via the Automatic Export toggles on the destinations page, as well as in the Settings. If Automatic Exports are disabled, an alert will be displayed in the navigation bar. In addition, any changes made to a destination's mappings or user collections will trigger an export if automatic exports are enabled.
There are two ways to trigger manual exports. On the destinations page, next to the desired destination, you can switch the Automatic Export toggle from Disabled to Enabled, which will trigger a prompt asking if you want to run an export. Exports will only be queued if any changes have been made to the destination. The second method can be triggered by pressing the play button to the right of the Automatic Export toggle. This will trigger a Full Sync, which will export to the destination regardless if any changes have been made to it.
Dry runs are an optional trial runs, or mock exports, meant to assess a destination for potential errors. Their activity logs will highlight errors that should be corrected before exporting. They will only queue users to be added or updated, not including already existing users.
To run a dry run, you can click the Dry Run button next to the desired destination on the destinations page. You can then view the dry run activity for that destination to check for errors and fix them prior to actual exports.
Updated: Jan 2019