====== Externs management ====== * [[.:externs_management#idm_configuration|IdM Configuration ]] * [[.:externs_management#show_externs_management_feature_in_hub|Show “Externs management” feature in HUB ]] * [[.:externs_management#turn_on_approval_of_externs_created_from_hub|Turn on approval of externs created from HUB]] * [[.:externs_management#externs_management|Externs management]] * [[.:externs_management#create_an_extern|Create an extern ]] * [[.:externs_management#update_an_extern|Update an extern]] * [[.:externs_management#deactivateactivate_an_extern|Deactivate/activate an extern]] * [[.:externs_management#delete_an_extern|Delete an extern]] ====== IdM Configuration ====== ===== Show “Externs management” feature in HUB ===== Users with permission to create identities will see “Externs management” feature in HUB, but it’s required to set up other permissions, to see and update all fields in form projection and to delete and activate/deactivate users. - Create role for externs manager. E.g. externs-manager - Set permissions for externs-manager. Which evaluator you will use is up to your requirements. Other permissions might be required based on your requirements (e.g. to show a code list) |Forms - definitions (IdmFormDefinition)|Read \\ Create \\ Update \\ Delete \\ View in select box (autocomplete)| |Forms - projections (IdmFormProjection)|Read \\ Create \\ Update \\ View in select box (autocomplete)| |Forms - values (IdmIdentityContractFormValue)|Create \\ Delete \\ Read \\ Update| |Forms - values (IdmIdentityFormValue)|Read \\ Update| |Users (IdmIdentity)|Create \\ Delete \\ Read \\ Update \\ Change phone \\ Change email| |Contracted positions (IdmIdentityContract)|Create \\ Delete \\ Read \\ Update| |Assigned roles (IdmIdentityRole)|Create \\ Read \\ Update| |Roles (IdmRole)|Can be requested| |Tree nodes (IdmTreeNode)|SETTOCONTRACT \\ View in selectbox (autocomplete)| Now every user with externs-manager role should see and be able to use “Externs management” feature in HUB ===== Turn on approval of externs created from HUB ===== To approve creation of externs created in HUB, you need module Extras in version 4.5.2 or later, configured by following instructions: [[:devel:documentation:modules_extras:approval_of_extern_created_from_hub|]] ====== Externs management ====== ===== Create an extern ===== - Go to externs management by clicking on “Management of externs” in navigation menu \\ {{.:hub_externs_management:hub_externs_nav.png?nolink&664x584}} - On the top right corner, under your name, click on “Add extern” button. If you don't see this button, you probably don't have permissions to create externs or there isn't any Form Projection created in IdM. \\ {{.:hub_externs_management:hub_add_extern_btn.png?nolink&664x584}} - You should see a form to create an extern. If you can create more than one type of extern, you’ll see a dropdown with available options. Selecting one of these options will take you to the proper form. Every form looks different, depending on your environment configuration. \\ {{.:hub_externs_management:hub_create_extern_form.png?nolink&2582x1428}} - Fill the form and submit it by clicking on the “Save extern” button. Notifications will inform you about the status. ===== Update an extern ===== - Go to externs management by clicking on “Management of externs” in navigation menu \\ {{.:hub_externs_management:hub_externs_nav.png?nolink&664x584}} - Here you will see a table with available externs. You can search and sort this table to find an extern you want to edit. If the table is empty, the reason might be there isn't any extern in the system or you don't have permission to see externs. \\ {{.:hub_externs_management:hub_externs_list.png?nolink&2702x1624}} - Click on the row with the extern you want to edit. It will take you to the extern’s details. \\ {{.:hub_externs_management:hub_extern_detail.png?nolink&2702x1624}} - In the extern’s detail, click on the “Edit” button. If you don’t see this button, you might not have permission to edit this user or the user is Disabled or waiting for approval. - Edit values you want to change and click on the “Save extern” button to save changes, or the “Cancel” button to quit edit mode and cancel any non saved changes. ===== Deactivate/activate an extern ===== - Go to externs management by clicking on “Management of externs” in navigation menu \\ {{.:hub_externs_management:hub_externs_nav.png?nolink&664x584}} - Here you will see a table with available externs. You can search and sort this table to find an extern you want to edit. If the table is empty, the reason might be there isn't any extern in the system or you don't have permission to see externs. \\ {{.:hub_externs_management:hub_externs_list.png?nolink&2702x1624}} - Click on the row with the extern you want to edit. It will take you to the extern’s details. \\ {{.:hub_externs_management:hub_extern_detail.png?nolink&2702x1624}} - In the extern’s detail, click on the “Deactivate” or “Activate” button. If you don’t see this button, you might not have permission to edit this user, or the user is waiting for approval. ===== Delete an extern ===== - Go to externs management by clicking on “Management of externs” in navigation menu \\ {{.:hub_externs_management:hub_externs_nav.png?nolink&664x584}} - Here you will see a table with available externs. You can search and sort this table to find an extern you want to edit. If the table is empty, the reason might be there isn't any extern in the system or you don't have permission to see externs. \\ {{.:hub_externs_management:hub_externs_list.png?nolink&2702x1624}} - Click on the row with the extern you want to edit. It will take you to the extern’s details. \\ {{.:hub_externs_management:hub_extern_detail.png?nolink&2702x1624}} - In the extern’s detail, click on the “Delete extern” button. You will be asked if you’re sure you want to delete the extern. After confirming, extern will be deleted and you will be informed about it in notification. If you don’t see the “Delete extern” button, you might not have permission to edit this user, or the user is waiting for approval.