The Read job reads all entities from the source system and provisions only new or updated entities to the target one. If the job is run in delta read mode, it reads and provisions only new or updated entities in the source system.
A Read job checks only for changes in the source system. If there have been changes in the target system, they are not affected by the job.
Although the name of the job implies reading users, a Read job could also lead to deleting users from the target system. This could happen if any of the following changes occur after you have run a provisioning job (Read or Resync):
-
A user has been deleted in the source system. As a result, on the next run of the Read job, the deleted user won’t be read from the source system and will be deleted in the target system.
-
A user filter is applied in the source system. As a result, on the next run of the Read job, the users not matching the filtering criteria will be deleted in the target system.
-
A condition is applied either in the source or in the target system. As a result, on the next run of the Read job, the users not matching the condition criteria will be skipped or deleted in the target system.
-
The mapping of the targetVariable
entityIdSourceSystem
orentityIdTargetSystem
has been changed.
You have a source system with users A, B, C and D.
Run a Read Job.
Users A, B, C and D are created in the target system.
In the source system, update user C, delete user D and add a new user E.
Run a second job.
If the second job is a Read Job: It reads users A, B, C and E from the source system and then creates user E, updates user C, and deletes user D in the target system.
If the second job is a Delta Read job: It reads users C and E from the source system and then creates user E and updates user C.
If the second job is a Resync job: It reads users A, B, C and E from the source system and then creates user E, updates users A, B and C, and deletes user D.
To run a read job, select a source system and choose Jobs > Read Job > Run Now. This starts a read job immediately.
To schedule a read job, select a source system and choose Jobs > Read Job > Schedule. This runs the job at the scheduled time period.
Option |
Description |
---|---|
ON/OFF |
Turn the job scheduler on or off:
|
Run job every (minutes) |
Schedule how often a read job to be run. The number must be larger than 30 (minutes). This option sets the time period but does not run the job immediately. Thus, after you set a scheduled period, turn ON the job scheduler. Use cases:
|
Run job on a specific day of the week and time: |
Specify the day and time to run the job. You must select at least one day of the week and the exact time. Day and time fields cannot be empty. The job is run in customer's time zone.
|