Import Tasks in GUI
MidPoint graphical user interface features a streamlined wizard helping you configure import tasks without needing to delve into XML configurations. You can use the wizard to the set up a simulated import and check the simulation results before running the import for real.
|
Make sure you have configured synchronization and mapping rules before your run an import task. |
Import Objects From a Resource
The steps below illustrate creating an import task to import user accounts. Adjust your resource object-related settings if you’re importing a different kind of objects.
|
We suggest setting up tasks as simulations first. This helps to make sure your resource configuration works as expected before you let the task make actual changes to your data. |
Figure 1. Create tasks using the Tasks menu in the resource account list
-
In Resources > All resources, select your resource.
-
In the resource-specific left-side menu, select Accounts.
-
Click Tasks ▼ and select Create task.
-
Click Import task.
-
Optionally, switch on the Simulate task toggle to preview what would the task do.
-
-
Click Create task.
Configuration
On this screen, fill in the basic task attributes, such as the task name or a description of its purpose. We suggest giving the task a descriptive name so that you can easily recognize it later in the task list.
Click Next: Resource objects to continue to the next screen.
Resource Objects
Select which resource objects should be processed by the task. In most cases, you can keep the settings on this screen as they are.
If you need to change the object selection, refer to Resource Object Set Specification. It’s important to remember that you can specify objects either by the object class, or by the combination of kind and intent. Don’t use all the three properties together.
Click Next: Execution to continue to the next screen.
Execution
This screen appears only if you switch on the simulation toggle at the beginning.
The task execution options dictate the modus operandi of the task. The mode and configuration give a fair number options. Let’s cover the basics here:
-
If you want to simulate import and ensure the task doesn’t modify data, select Mode: Preview and Predefined (configuration): Development.
-
If you want to actually import the accounts (i.e., create focal objects for the resource objects), select Mode: Undefined and Predefined (configuration): Production.
Refer to these resources for more information on the topic:
Click Next: Distribution to continue to the next screen.
Distribution
This is the last screen. You don’t need to change the settings here unless you want to distribute the task to multiple threads. You can learn more in Distribution.
-
Click Save & Run to run the task immediately.
-
Click Save settings to save the task for later.
Find and Run Saved Tasks
You can find all tasks you’ve created for a resource in the resource-specific left-side menu under Defined Tasks.
Once you find the task you want to adjust, run, or inspect, click the name of the task.
The top of the task detail screen tell you all about the status of the task.
Figure 2. Status and action bars in the task detail screen
-
The status of the task above is Unknown and the task is Suspended, meaning that it has never run.
-
The type of the task is Import task.
-
The only available Task operation is Resume because it never ran before.
You can use the screens under Activity to adjust settings of the task, such as the execution mode and configuration. After you make changes, click Save or Save & Run.
Use the Resume button to run a task that has never been run before, such as the one in the picture above. After you run a task once, the button changes to Run now.
Read Simulation Results
After you run a simulation task and it finishes the processing, the top bar in the task detail screen shows a new button: Show simulation result.
Figure 3. View simulation results button at the top bar of the task screen details screen
Click the Show simulation result button to get an overview of the simulated changes, i.e., what would have happened if it weren’t only a simulation. Nothing of what you see in the overview has really happened, but it gives you a great option to inspect whether all your resource and object type settings behave as you wish.
Figure 4. Task simulation results overview
-
The numbers in the left sidebar are links you can use to inspect each category of affected objects.
-
The cards on the right are an easy-to-scan overview of important events.
-
The above screen tells that 33 users from the HRIS would have their foci activated while shadows of 15 resource objects would stay unmodified because of errors.
Simulate Import of a Single Object
Before importing objects from a resource to midPoint, it’s useful to simulate import of a single object to see whether all the mappings behave as expected.
Simulating import of a single object is particularly useful if you’re working with a resource that contains thousands of objects because it could take a long time to simulate import of them all. You’ll likely have to simulate the import of all of them eventually anyway, but it’s faster to debug your configuration on a handful of cherry-picked objects beforehand.
-
In Resources > All resources, select your resource.
-
In the resource-specific left-side menu, select Accounts.
-
Pick an account you want to test with.
-
Click the dropdown menu button ▼ at the far right of the row and select Import preview.
-
In the modal dialog that appears, select the task execution mode:
-
Simulated production if your resource or parts of its configuration you want to test are in the Active lifecycle state.
-
Simulated development if your resource or parts of its configuration you want to test are in the Proposed lifecycle state.
-
-
Click Select
Figure 5. Account list with the dropdown menu to create an import task for a single account
Check the Simulation Results
Once the task finishes, you’re taken to the Processed objects screen. There, you see:
-
The shadow object with no changes.
-
A new user object that would be added were it not for the simulation.
(The type of the focus object depends on what you’re actually importing.)
Click the name of the user object to see its details, mapping results in particular.
Figure 6. List of processed objects
Figure 7. Details of the simulated new user object
Was this page helpful?
YES
NO
Thanks for your feedback