Designer Page Menu Section

Developing Resource Objects 11-27 – Create New Lookup: When you click this button, the Create Lookup Event dialog box is displayed, as shown in Figure 11–13 . Figure 11–13 Create Lookup Event Dialog Box – Edit Selected Lookup: When you click this button, the Edit Lookup Event dialog box is displayed, as shown in Figure 11–14 . Figure 11–14 Edit Lookup Event Dialog Box – Remove Selected Lookup: When you click this button, the Remove Lookup Event dialog box is displayed, as shown in Figure 11–15 . Figure 11–15 Remove Lookup Event Dialog Box ■ Org Event: This provides a list of tasks that are run based on the events on organizations. They have the following default names: – Change Organization Type – Change Organization Name – Move Organization An organization event can be inserted into the workflow by clicking the + icon next to the Org Event menu item. Clicking the + icon opens the Add Organization Event Lookups dialog box with a list of currently available event tasks, as shown in Figure 11–16 . You can select a task and click Add Event to Workflows to create a new menu item under the Org Event menu and open the page for that workflow. 11-28 Oracle Fusion Middleware Developers Guide for Oracle Identity Manager Figure 11–16 Add Organization Event Lookups Dialog Box The Add Organization Event Lookups dialog box also provides the following options to create new lookup events and edit or remove existing lookup events: – Create New Lookup: When you click this button, the Create Lookup Event dialog box is displayed, as shown in Figure 11–17 . Figure 11–17 Create Lookup Event Dialog Box – Edit Selected Lookup: When you click this button, the Edit Lookup Events dialog box is displayed, as shown in Figure 11–18 . Developing Resource Objects 11-29 Figure 11–18 Edit Lookup Event Dialog Box – Remove Selected Lookup: When you click this button, the Remove Lookup Events dialog box is displayed, as shown in Figure 11–19 . Figure 11–19 Remove Lookup Event Dialog Box ■ Resource Event: This provides a list of tasks that are inserted into the workflow and run when an event occurs on the resource. These events are defined as disabled or enabled events on the resource. There are submenu items for Enable Resource and Disable Resource under the Resource Event menu item. A resource event can be inserted into the workflow by clicking the + icon next to the Resource Event menu item. Clicking the + icon opens the Add Resource Event Lookups dialog box with two options, Enable Resource and Disable Resource, as shown in Figure 11–20 . You can select an option and click Add Event to Workflows to create a new menu item under the Resource Event menu and open the page for that workflow. 11-30 Oracle Fusion Middleware Developers Guide for Oracle Identity Manager Figure 11–20 Add Resource Event Lookups Dialog Box ■ Form Event: This provides a list of tasks that get inserted and run based on an event on a form field or child table. For events on parent process form fields, the name of the tasks have the following convention: Field field_name Updated The events on child tables are named based on the child table name and the type of event such as insert, update, and delete. A form event can be inserted into the workflow by clicking the + icon next to the menu item. Clicking the + icon opens the Add Form Event Lookups dialog box with the fields shown in Figure 11–21 . Developing Resource Objects 11-31 Figure 11–21 Add Form Event Lookups Dialog Box In the Add Form Event Lookups dialog box, you can select either parent form or child form in the Form Type field. When you select Parent Form, the fields in the Child Form section are disabled. Similarly, when you select Child Form, the fields in the Parent Form section are disabled. In the Parent Form section, only the Update operation is available. In the Child Form section, the available operations are Insert, Update, and Delete. These operations trigger the event. Each section has fields for the form fields of the parent form, or the form names in case of child forms. The Task names for only the child table event tasks can be modified after creation. ■ Attestation: This menu item is for the attestation events. There are two types of attestation events, User Attestation and Resource Attestation. No new events can be added to attestation although the existing workflows can be modified similar to other subworkflows.

11.6.4 Creating and Configuring Tasks and Responses

A workflow can consist of more than one task. This section discusses the following topics related to tasks: ■ General Menu Options ■ Task Options ■ Response Options Note: The parent form field event names are fixed, and the task name fields cannot be edited. Although the name is inherently in a fixed format, it can be customized and localized by updating the global.workflow.startMarker.UpdatedField property in the xlRichClient.properties file. See Chapter 28, Customizing Oracle Identity Manager Interfaces for information about customizing the UI. 11-32 Oracle Fusion Middleware Developers Guide for Oracle Identity Manager ■ Link Options ■ Configuring Tasks ■ Configuring Responses

11.6.4.1 General Menu Options

You can right-click the designer page to display a menu with general options to create tasks and responses. The general menu options are: ■ Create New Task: Creates a new task with a default name, which can be further modified and configured. The task is represented as an icon. ■ Insert Existing Task: Displays the Existing Tasks dialog box with the list of all existing tasks across the subworkflows except the tasks present in the current subworkflow and the main user, organization, resource, and form event tasks for provisioning workflows. You can select a task and insert it in the current workflow. ■ Create Response: Creates a new response with a default response code, which can be further modified and configured. The response is represented as an icon. Various options are available when you right-click the task icons, response icons, and the links between the tasks and responses.

11.6.4.2 Task Options

You can right-click a task icon to display a menu that provides the following options related to tasks: ■ Link To Response: This option is used to link a task to a response. To use this option, first create a response. When you select this menu item, a link is displayed starting from the task icon. This link extends with the mouse pointer. When you click the response, the arrowhead of the link positions itself on the response, and the response is created for the task. ■ Link To Undo Task: This option is used to link two tasks with the undo relationship. It is used when you want to add a task as the undo task of the current selected task. To do this: 1. Select the task to which the undo task is to be added.

2. Right-click the task icon, and select the Link To Undo Task menu item.

3. Select the target tasks icon to add it as the undo task. ■ Link To Recovery Task: This is used to link two tasks with the recovery relationship. It is used when you want to add a task as the recovery task of the currently selected task. To do this: 1. Select the task to which the recovery task is to be added.

2. Right-click the task icon, and select the Link To Recovery Task menu item.

3. Select the target task to add it as the recovery task. Note: If the Display Undo Tasks option in the Display Options toolbar is selected with the value No, then the Undo task will not be visible after creating the undo relationship. To see the undo task, select Yes for the Display Undo Tasks option. Developing Resource Objects 11-33 ■ Remove Task and Subflow: This is used to remove a task and all the elements under the task. This includes all the links originating from the task and all their child elements and their child elements and so on. When the same task is present in multiple subworkflows and it is removed from one subworkflow, it gets removed from all the subworkflows where this task has the same parent task, which is the task whose response-generated tasks contain the current removed task. Removing a task or the children will not delete the tasks from the system but only from the workflows. Deleting a task from the system permanently can be done from the Task Library. Removing tasks from the designer page still keeps the task definitions and removes them only from the workflows.

11.6.4.3 Response Options

You can right-click a response icon to display a menu that provides the following options related to responses: ■ Add Response Generated Task: This is used to add a task as a response-generated task for the selected response. To do this:

1. Create the response-generated task.

2. Right-click the response, and select Add Response Generated Task. A link is

created.

3. Select the task. The link positions on the task and the relationship are created.

■ Remove: This is used to remove a response. When you select this option, a confirmation page is displayed. Confirming the deletion removes the response and all its children. When a response is removed that contains generated tasks, then those tasks will be removed but not deleted. When a task is removed, it is removed only from the workflow and is not deleted permanently. You can permanently delete a task from the Task Library.

11.6.4.4 Link Options

You can remove the relationships between some elements by right-clicking the link and clicking the Remove option. This option is not available for all links. For example, for reconciliation workflows, you cannot delete the default tasks connected to the start marker. Therefore, you cannot remove the relationship between the start markers and the default tasks. The link for which you can remove the relationship is highlighted with a broken arrow when you roll your mouse on the relationship. When the arrow is highlighted, right-click the arrow and the Remove option is displayed. This helps in removing the link between a response and a task and to assign another response to the task, or to assign another task to the response, without the need to delete the link and create new ones. Note: If the Display Recovery Tasks option in the Display Options toolbar button is selected with the value No, then the recovery task will not be displayed after creating the recovery relationship. To display the recovery task, select Yes for the Display Recovery Tasks option.