Differences

This shows you the differences between two versions of the page.

--- tutorial:adm:roles_-_import_data_from_csv [2019/06/07 17:37]
hanakp
+++ tutorial:adm:roles_-_import_data_from_csv [2019/06/12 14:15]
hanakp
@@ Line 1: / Line 1: @@
-====== Prepare CSV file ======
+====== Roles - Import of data from CSV ======
+===== 1a. Prepare some virtual system =====
+Please use [[tutorial:adm:how_to_create_virtual_system|this]] tutorial to do so!
+==== 1b. Prepare CSV file ====
 Here is an example of CSV file which can be used for import roles.
@@ Line 14: / Line 20: @@
 </code>
-As you can see roles column can be single or multivalued. For multivalued roles, description will be added to every role.
+As you can see roles column can be single or multivalued. For multivalued roles, description from the same row will be added to every role.
+CSV file can have optional number of columns, role and description columns are specified in setup of LRT.
-====== Create new LongRunningTask ======
+==== Create new LongRunningTask ====
 Now we will create the new LongRunningTask(LRT). As shown in the picture, go to Settings → Task scheduler → Scheduled tasks and hit green "Add" button to add new LRT.
-====== Fill all attributes ======
+==== Fill all attributes ====
 Now we need to create new LRT with these attributes:
@@ Line 26: / Line 33: @@
 - Task type - **ImportRolesFromCSVExecutor**
 - Import csv file - dropzone to select or drop csv file
-- Column with roles - Name of the column with roles
+- Column with roles - Name of the column with roles in csv file
-- Column with description - name of the column with role description
+- Column with description - name of the column with role description, can be also used to update description
-- Column separator - separator of columns in csv
+- Column separator - separator of columns in csv file
-- Multi value separator - separator of multi value values in csv
+- Multi value separator - ( Char, default: new line ) separator of multi valued role names in csv file, new line separator is default export from excel, but for better clarity of csv file, it's recommended to use some symbol instead
 - System name - name of the system to connect with roles
-- MemberOf attribute name - ( default: rights ) - name of multi valued attribute for merge
+- MemberOf attribute name - ( default: rights ) - name of multi valued attribute for merge, attribute named "rights" is automatically created on every virtual system, but you can create your own and change setup of LRT
-- Can be requested - ( Boolean ) - Fills can be requested
+- Can be requested - ( Boolean ) - Fills can be requested, can be also used to update already imported settings
+{{:tutorial:adm:import-roles-lrt.png?500|}}
+==== Run the task ====
+Now we just need to hit run.
+{{:tutorial:adm:aaaaaaaa6.png?100|}}
+And we also need to process it in all tasks.
+{{:tutorial:adm:aaaaaaaa7.png?400|}}
+You can check status about created roles in "all tasks" panel in task detail. Here you can find information about created, updated or already existing roles.
+Everything should be set up so far and when the task ends, roles are imported in IdM, placed in catalogue named by system name.
+==== Known issues ====
-====== Run the task ======
+If you delete or upload new file via dropzone, you should delete old files, created from previous uploads.
-Now we just need to hit run
-You can check status about created roles in All tasks panel in task detail.