Creating IT Shop requests from existing user accounts, assignments, and role memberships
You can create One Identity Manager requests for existing user accounts, membership in system entitlements, assignments to employees, and hierarchical roles when IT Shop goes into operation. One Identity Manager provides several methods to implement this. Using these methods, requests are created that are completed and approved. These requests can therefore be canceled at a later date. In addition to the initial request data, you can run a custom script from each method that sets other custom properties for a request.
Table 19: Methods for transforming direct assignments into requests
CreateITShopOrder (string CustomScriptName) |
Creates a request from a direct assignment. This method can be applied to all tables used to find a UID_Person. |
CreateITShopOrder (string uidOrgProduct, string uidPersonOrdered, string CustomScriptName) |
Creates an assignment request from an assignment or membership. This method can be applied to all tables that cannot be used to find a UID_Person. |
CreateITShopOrder (string uidOrgProduct, string uidWorkdeskOrdered, string uidPersonOrdered, string CustomScriptName) |
Creates an assignment request from an assignment or membership and, in addition, saves a UID_WorkdeskOrdered with the request procedure. |
CreateITShopWorkdeskOrder (string uidPerson, string CustomScriptName) |
Creates a request for a workdesk from a direct assignment. This method can be applied to the WorkDeskHasApp, WorkDeskHasESet and WorkDeskHasDriver tables. |
To run the methods
-
Create a script in the Designer with the Script Editor to call the desired method.
You can find an example script for calling a Customizer method in VB syntax on the One Identity Manager installation medium in the Modules\QBM\AddOn\SDK\ScriptSamples\03 Using database objects\11 Call database object methods.vb directory. You can use this example script as a template to create a script for call the methods described here.
-
Run the script.
You can use the script test from the Script Editor to do this.
For more information about creating scripts, see the One Identity Manager Configuration Guide.
Creating requests for employees
You can create requests for employees or memberships in system entitlements with CreateITShopOrder (string CustomScriptName). Prepare the IT Shop accordingly in order to create the requests.
To create requests from direct assignments to employees or memberships in system entitlements
-
Prepare the company resources or system entitlements for use in the IT Shop.
-
Assign the company resources or system entitlements to a shelf in the IT Shop.
-
Link each user account for whose memberships requests are to be created with an employee.
-
Add employees as customers to shops to which the company resources or system entitlements are assigned as products.
-
(Optional): Create a script that populates other properties of the requests.
-
Create a script to run CreateITShopOrder (CustomScriptName string) for the affected tables.
One Identity Manager creates requests from direct assignments to employees in the following way:
-
Determine employees and their assigned company resources.
-
Determine shops assigned to company resources and employees.
- Create the requests with initial data.
- Execute custom scripts.
- Save the requests (entry in the PersonWantsOrg table).
-
Assign employees to the product structure (entry in PersonInITShopOrg table).
-
Transform direct company resource assignments into indirect assignments to employees (for example, in the PersonHasQERResource table).
One Identity Manager creates requests for memberships in system entitlements in the following way:
-
Establish the user accounts and their memberships.
-
Determine the affected employees.
-
Determine the shops to which employees and the system entitlements are assigned.
- Create the requests with initial data.
- Execute custom scripts.
- Save the requests (entry in the PersonWantsOrg table).
-
Assign employees to the product structure (entry in PersonInITShopOrg table).
-
Transform direct company memberships into indirect memberships for affected user accounts (for example, in the ADSAccountInADSGroup table).
Related topics
Creating user account requests
To assign user accounts to employees, use One Identity Manager account definitions. You can request matching account definitions for existing user accounts linked to the employees through the IT Shop. To create these requests, you can use CreateITShopOrder (string CustomScriptName). This method can be used for all user account tables (for example, ADSAccount or SAPUser) and for the ADSContact, EX0MailBox, EX0MailContact, and EX0MailUser.
Prepare the IT Shop accordingly in order to create the requests.
To create requests for user accounts
-
Create an account definition for the target system. Assign the account definition to the target system.
-
Prepare the account definition for use in the IT Shop.
-
Assign the account definition to a shelf in the IT Shop.
-
Link the user account to an employee.
-
Add employee as customers to shops to which the account definition is assigned as product.
-
(Optional): Create a script that populates other properties of the requests.
-
Create a script that runs the method for the tables affected.
One Identity Manager creates requests for user accounts in the following way:
-
Determine the valid account definition.
-
Determine the affected employees.
-
Determine the shops to which employees and the account definition are assigned.
- Create the requests with initial data.
- Execute custom scripts.
- Save the requests (entry in the PersonWantsOrg table).
-
Assign employees to the product structure (entry in PersonInITShopOrg table).
-
Transform any possible direct account definition assignments to indirect assignments (entry in PersonHasTSBAccountDef table).
Related topics
Creating workdesk requests
Requests for workdesks are created with CreateITShopWorkdeskOrder (string uidPerson, string CustomScriptName). Prepare the IT Shop accordingly in order to create the requests.
To create requests from assignments to workdesks
-
Prepare the company resources (software, system role, or driver) for use in the IT Shop.
-
Assign the company resources to a shelf in the IT Shop.
-
Select an employee as requester for the assignment to workdesks.
-
Add the selected employee as a customer to the shops to which the company resources are assigned as products.
-
(Optional): Create a script that populates other properties of the requests.
-
Create a script to run CreateITShopWorkdeskOrder (string uidPerson, string CustomScriptName) for the affected tables.
One Identity Manager creates requests for workdesk requests in the following way:
-
Determine workdesks and their assigned company resources.
-
Determine requester from the uidPerson parameter.
-
Determine shops assigned to company resources and requester.
- Create the requests with initial data.
- Execute custom scripts.
- Save the requests (entry in the PersonWantsOrg table).
-
Assign employees to the product structure (entry in PersonInITShopOrg table).
-
Transform direct company resource assignments into indirect assignments to workdesks (for example, in the WorkDeskHasApp table).
Related topics