3.1.1Mapping Rule Generator Adapter Variables

In Chapter 2, "Developing Adapters", you learned how to create a rule generator. Now, you must map the adapter variables of the rule generator to their proper locations to ensure that the adapter will function as intended.

To map these adapter variables, access the Data Object Manager form from the Development Tools/Business Rule Definition folder of the Design Console.

To map the adapter variables of a rule generator to their proper locations:

Open the Data Object Manager form. In the Design Console workshops, the Data Object Manager form is displayed.

The following table lists and describes the various regions of the Data Object Manager form:

Name

Description

Form Description Field

From this lookup field, select the form that contains the field to which you are attaching the rule generator.

Data Object Field

This field displays the name of the data object, which is represented by the selected form.

Attach Handlers Tab

This tab displays:

The rule generators that are attached to the selected form.

The execution schedule of the rule generators associated with this form.

The order in which Oracle Identity Manager will run the rule generators.

Insert, update, and delete permissions for roles.

Map Adapters Tab

This tab displays:

The names of the rule generators that are associated with the form;

The status of these adapters.

The names, descriptions, and mapping statuses of the rule generators' adapter variables.

Note: The Map Adapters tab is grayed out until an adapter is assigned to the current data object.

Double-click the Form Description field. A Lookup dialog box appears with the forms to which you can attach rule generators.

Select the form you want. Then, click OK.

On the toolbar, click Save.

The selected form, the form's data object, and the rule generator adapters associated with the form appear. In addition, Oracle Identity Manager enables the Map Adapters tab.

Tip:

To change the sequence of triggering a rule generator:

Click Assign. The Event Handlers dialog box is displayed.

Select the rule generator from.

Click the up arrow and down arrow buttons to modify the order of the rule generator.

For these rule generators to work properly, you must map the adapter variables to their proper locations.

Click the Map Adapters tab.

From the Name combo box, select the rule generator, which has adapter variables that can be mapped (for example, the adpCONVERTTOLOWERCASE rule generator).

The Map Adapters tab now displays the following:

The name of the rule generator that is to be attached to the form.

The status of the rule generator.

The names, descriptions, and mapping statuses of the rule generator's adapter variables.

Set the mappings for each variable that appears in the Adapter Variables region of the Map Adapters tab. To do so, double-click the row header of the variable you want to map (for example, Data). The Data Mapping for Variable dialog box is displayed.

Table 3-1 describes the various fields of the Data Mapping for Variable dialog box.

Table 3-1 Fields of the Data Mapping for Variable Dialog Box

Field Name

Description

Variable Name

This field displays the name of the adapter variable for which you are setting a mapping (for example, Data).

Data Type

This field shows the data type of the adapter variable (for example, String is the data type for the Data adapter variable).

Map To

This field contains the source and target locations of the mappings you can set for the adapter variable (for example, User Definition).

When you map the adapter variable to a location or a contact, Oracle Identity Manager enables the adjacent combo box. From this combo box, select the specific type of location or contact to which you are mapping the adapter variable.

If you are not mapping the adapter variable to a location or contact, this combo box is grayed out.

Qualifier

This field contains the qualifiers for the mapping you selected in the Map To combo box (for example, User Login).

IT Asset Type

This field enables you to select a specific IT Resource (for example, Solaris) when you map an adapter variable to an IT Resource, and this variable's data type is String.

If you are not mapping the adapter variable to an IT Resource, or the variable's data type is not String, this field does not appear.

IT Asset Property

This field enables you to select a specific field that will receive the results of the mapping (for example, User Name), when you map an adapter variable to an IT Resource, and this variable's data type is String.

If you are not mapping the adapter variable to an IT Resource, or the variable's data type is not String, this field does not appear.

Important: The IT Asset Type and IT Asset Property fields are included within this window for backward compatibility. The preferred way is to create an adapter variable with a data type of IT Resource, in which case these fields will not appear.

Literal Value

When you map the adapter variable to a literal, type the name of the specific literal in this field (for example, IBM).

If you are not mapping the adapter variable to a literal, this field does not appear.

The contents in the Status field change from Mapping Incomplete to Ready. In addition, the mapping statuses for the adapter variables change from No (N) to Yes (Y).

This signifies that all the adapter variables for the rule generator adapter have been mapped correctly. You are now ready to attach this rule generator to a provisioning process, so it can be triggered after the process is provisioned to a target user or organization.

Tip:

When you map all the adapter variables for a rule generator that is associated with a form, a quick way to see the form to which it is attached as well as the execution schedule of the rule generator, is by accessing the Usage Lookup tab of the Adapter Factory form.

After the rule generator is assigned to a process, and the process is provisioned, the rule generator will be executed by Oracle Identity Manager.

3.1.2 Associating Rule Generators with Processes

After you map the adapter variables of a rule generator to their proper locations, you must attach it to a provisioning process. Then, once the process is provisioned to a target user or organization, Oracle Identity Manager will trigger the associated rule generator.

Similarly, when a rule generator, which has been assigned to a provisioning process, is no longer needed for the process to be completed, you must remove the rule generator from the provisioning process.

To assign a rule generator to a provisioning process or remove a rule generator from a provisioning process, access the Event Handlers/Adapters tab in the Process Definition form. This form can be found in the Process Management folder.

3.1.3Removing Rule Generators from Form Fields

Sometimes, after you attach a rule generator to a form field, you can connect a different rule generator to that form field. When this occurs, you must first remove the rule generator that is currently attached to the form field.

Caution:

If you remove a rule generator from a form and if the class name of the form's data object matches the table name of a provisioning process, you will not be able to assign the rule generator to that provisioning process.

For example, suppose the adpCONVERTTOLOWERCASE rule generator is removed from the Solaris form. If the class name of the form's associated data object is UD_SOLARIS, the rule generator cannot be assigned to any provisioning process with a table name of UD_SOLARIS.

To remove a rule generator from a form field, perform the following steps:

Open the Data Object Manager form.

Select the form that contains a rule generator you want to remove.

The selected form, along with its rule generators, appear in the Data Object Manager form.

Click the rule generator that you want to remove from the form field.

Click Delete.

The selected rule generator no longer appears in the Data Object Manager form. This indicates that you have removed the rule generator from the form field.

Caution:

If you attempt to remove a rule generator from a form field, and if an error box appears, the adapter has already been associated with a provisioning process. First, detach the rule generator from the process. Then, you can remove it from the form field.

3.3 Working with Task Assignment Adapters

3.3.1Attaching Task Assignment Adapters to Process Tasks

In Chapter 2, "Developing Adapters" , you learned how to create a task assignment adapter. Once created, you must attach it to a process task so that Oracle Identity Manager can automate the assignment of the task to a user or role.

To connect a task assignment adapter to a process task, access the Assignment tab (from the Process Definition form). From this tab, you can also map any adapter variables to their proper locations.

The following procedure shows you how to attach a task assignment adapter to a process task.

Open the Process Definition form, which is located in the Process Management folder.

Within the Oracle Identity Manager workspace, the Process Definition form appears.

Select the process, which contains a task to which you want to attach an adapter.

The selected process, along with its tasks, appears in the Process Definition form.

Double-click the row header of the task to which you want to attach a task assignment adapter.

Double-click the Priority field. From this field, set the priority number for the associated task assignment rule.

Double-click the Rule lookup field. From the Lookup dialog box that is displayed, select the rule that will determine if the associated adapter will be used to automate the assignment of the process task to a user or role.

Double-click the Target Type lookup field. From the Lookup dialog box that is displayed, specify whether the task is to be assigned to an Oracle Identity Manager user or role.

Double-click the Adapter lookup field. From the Lookup dialog box that is displayed, specify the task assignment adapter that is to be associated with the rule you selected in Step 7 of this procedure.

On the toolbar that is displayed within the Assignment tab, click Save.

The mapping status of the task assignment adapter variables is displayed within the Adapter Status field. Use the following table to decide which action to perform, based on the adapter's mapping status.

Mapping Status

Action

Ready

The adapter does not have any variables that can be mapped. In other words, none of the adapter variables are return variables or have been designated as Resolve at Run time. So, proceed to Step 14 of this procedure.

Mapping Incomplete

At least one of the adapter's variable must be mapped. So, proceed to Step 11 of this procedure.

Adapter Unavailable

After the adapter had been compiled successfully, it was modified. As a result, you must recompile the adapter.

The Adapter Variables window appears. It displays the following information:

The name of the task assignment adapter that is attached to the process task;

The status of the adapter; and

The mapping statuses, names, and descriptions of the adapter's variables.

Set the mappings for each variable that appears in the Adapter Variables region of this window. To do so, double-click the row header of the variable you want to map (for example, UUID).

The Edit Data Mapping for Variable dialog box is displayed.

Table 3-2 lists the fields of the Edit Data Mapping for Variable dialog box is displayed.

Table 3-2 Fields of the Edit Data Mapping for Variable Dialog Box

Field Name

Description

Variable Name

This field displays the name of the adapter variable for which you are setting a mapping (for example, UUID).

Data Type

This field shows the data type of the adapter variable (for example, String is the data type for the UUID variable).

Map To

This field contains the types of mappings that you can set for the adapter variable (for example, IT Resources).

When you map the adapter variable to a location or a contact, Oracle Identity Manager enables the adjacent combo box. From this combo box, select the specific type of location or contact to which you are mapping the adapter variable.

In addition, if you map the adapter variable to a custom process form, and this form contains child table(s), Oracle Identity Manager enables the adjacent combo box. From this combo box, select the child table to which you are mapping the adapter variable.If you are not mapping the adapter variable to a location, contact, or child table of a custom process form, this combo box is grayed out.

Qualifier

This field contains the qualifiers for the mapping you selected in the Map To combo box (for example, IT Asset).

IT Asset Type

This field enables you to select a specific IT Resource (for example, Solaris) when you map an adapter variable to an IT Resource, and this variable's data type is String.

If you are not mapping the adapter variable to an IT Resource, or the variable's data type is not String, this field does not appear.

IT Asset Property

This field enables you to select a specific field that will receive the results of the mapping (for example, Unique ID), when you map an adapter variable to an IT Resource, and this variable's data type is String.

If you are not mapping the adapter variable to an IT Resource, or if the variable's data type is not String, this field does not appear.

Important: The IT Asset Type and IT Asset Property fields are included within this window for backward compatibility. The preferred way is to create an adapter variable with a data type of IT Resource, in which case these fields will not appear.

Literal Value

When you map the adapter variable to a literal, use this field to specify the specific literal value.

If you are not mapping the adapter variable to a literal, this field does not appear.

Old Value

By selecting this check box, you map the adapter variable to the value that was originally in the selected Qualifier field before modification.

Process task adapters associated with process tasks are conditionally triggered when some field on the process form is changed. If you click the Old Value option, and the process task is marked Conditional, the value that is passed to the adapter is the previous value of the field. This is useful in cases of fields that accept passwords.

For example, if you want to disallow setting the password to the same value, you can use the old value for comparison.

If you are not mapping the adapter variable to a field that belongs to a child table of a custom process form, this check box is grayed out.

Mapped: The mapping statuses of the adapter's variables. "Y" indicates that an adapter variable has been mapped properly; "N" indicates that this variable has not been mapped correctly.

Name: The names of the adapter variables.

Mapped to: The form fields to which the variables are mapped If an adapter variable is not yet mapped, the corresponding cell in this column will be empty.

From the Field Name combo box, select the form field, such as User ID, to which the prepopulate adapter will be attached.

Double-click the Rule lookup field. From the Lookup dialog box that is displayed, select the rule that will determine if the associated adapter will be used to populate the designated form field with information (for example, Rule for Lowercase User ID).

Double-click the Adapter lookup field. From the Lookup dialog box that is displayed, choose the adapter that will be associated with the field you selected in Step 10, for example, Display Lowercase Letters for User ID.

In the Order field, enter the priority number of the rule you selected in Step 11, for example, 2.

On the prepopulate Adapters window toolbar, click Save.

Mapping Incomplete appears within the Adapter Status field. This signifies that the adapter you selected contains variables that have not been mapped correctly. These variables can be mapped to their proper locations. Otherwise, the adapter will not work.

Set the mappings for each variable that appears in the Adapter Variables region of the prepopulate Adapters window. To do so, double-click the row header of the variable you want to map, for example, UserID.

This field displays the name of the adapter variable for which you are setting a mapping (for example, UserID).

Data Type

This field shows the data type of the adapter variable (for example, String is the data type for the UserID adapter variable).

Map To

This field contains the types of mappings that you can set for the adapter variable (for example, Process Data).

When you map the adapter variable to a location or a contact, Oracle Identity Manager enables the adjacent combo box. From this combo box, select the specific type of location or contact to which you are mapping the adapter variable.

If you are not mapping the adapter variable to a location or contact, this combo box is grayed out.

Qualifier

This field contains the qualifiers for the mapping you selected in the Map to combo box (for example, User ID).

IT Asset Type

This field enables you to select a specific IT Resource (for example, Solaris) when you map an adapter variable to an IT Resource, and this variable's data type is String.

If you are not mapping the adapter variable to an IT Resource, or the variable's data type is not String, this field does not appear.

IT Asset Property

This field enables you to select a specific field that will receive the results of the mapping (for example, User Name), when you map an adapter variable to an IT Resource, and this variable's data type is String.

If you are not mapping the adapter variable to an IT Resource, or the variable's data type is not String, this field does not appear.

Important: The IT Asset Type and IT Asset Property fields are included within this window for backward compatibility. The preferred way is to create an adapter variable with a data type of IT Resource, in which case these fields will not appear.

Literal Value

When you map the adapter variable to a literal, use this field to specify the specific literal value.

If you are not mapping the adapter variable to a literal, this field does not appear.

The text in the Adapter Status field changes from Mapping Incomplete to Ready. In addition, the mapping statuses for the adapter's variables change from No (N) to Yes (Y).

On the prepopulate Adapters window toolbar, click Close.

The prepopulate Adapters window disappears, and the Form Designer form is active again. The prepopulate adapter, which you attached to the User ID form field (Display Lowercase Letters for User ID), appears in the prepopulate tab of the Results of 1Q Sales 2003 form.

After a process, which references this form, is provisioned to a target user or organization, the form will appear. Oracle Identity Manager will check to see if the prepopulate rule, which has the highest priority, is valid. If so, Oracle Identity Manager will assign the associated prepopulate adapter to the designated field (User ID), and execute it. At this point, one of the following actions occur:

If the Auto-prepopulate check box is selected for the provisioning process, Oracle Identity Manager will display the data that is generated by the prepopulate adapter automatically.

If the Auto-prepopulate check box is cleared, an Oracle Identity Manager user must manually trigger the displaying of the data that is generated by the prepopulate adapter. To do this, the administrator must click the prepopulate button on the form section of the direct provisioning wizard in the Web client, while provisioning the form to a user.

Tip:

Once you allocate a prepopulate adapter to a form field, and assign a prepopulate rule to the adapter, a quick way to see the association among the adapter, the form field, and the rule is by accessing the Usage Lookup tab of the Adapter Factory form.

3.4.2 Removing Prepopulate Adapters from Form Fields

If a prepopulate adapter, which has been associated with a form field, is no longer valid, you must remove the adapter from the field.

Note:

Before removing the prepopulate adapter from a form field, you must create a new version of the form.

To remove a prepopulate adapter from a form field:

Select the prepopulate adapter that you want to remove.

Click Delete. The prepopulate adapter is removed from the form field. It cannot be triggered when the form is launched.

3.5 Working with Process Task Adapters

3.5.1Guidelines for Working with a Process Task Adapter

After you create a process task adapter, you attach it to the appropriate process task by using the Integration tab of the Process Definition form. From this tab, you can also map any variables of the adapter to their proper locations, which were designated as either Resolve at Run time or as an adapter return variable.For example, the adapter named adpSOLARISPASSWORDUPDATED is connected to the Password Updated task of the Solaris process.After you attach an adapter to a process task, for the adapter to be functional, it might need data from fields of other forms. For this example, the adpSOLARISPASSWORDUPDATED adapter cannot work unless it obtains the following information:

The user's Oracle Identity Manager ID and password.

The user's Solaris ID and password.

The IP address where Solaris is located.

Therefore, it must get this information from the UserID, Passwd, SolarisUserID, SolarisUserPasswd, and ServerAddress adapter variables respectively. These five variables are created by using the Adapter Factory form. The "Y" that precedes each adapter variable signifies that it has been mapped correctly.The form that enables you to create process-specific fields, which will be used by a process to obtain the information it needs, is called the Form Designer. When you create these fields, Oracle Identity Manager stores them into a table. Then, by associating this table with a process (through the Table Name lookup field of the Process Definition form), the adapter, which you attach to a task of this process, will use the table to retrieve the appropriate data.If you want to modify this table, you can do so through the Form Designer form.The UD_SOLARIS table contains two fields: UD_SOLARIS_USERID and UD_SOLARIS_PASSWD. By accessing this record of the Form Designer form, you can edit the fields of the table.

Once you attach the process task adapter to a dependent process task, and the status of this process task is Pending (the status of the previous process task is Completed), Oracle Identity Manager will trigger the adapter automatically. When the process task is an independent task, Oracle Identity Manager will execute the adapter as soon as the process is requested.The result of the adapter being executed represents the state of the process task. When the adapter is finished successfully, the process task to which this adapter is attached will have a status of Completed.On the other hand, if the adapter cannot perform its designated function, the process task to which this adapter is attached will have a status of Rejected. By discovering the cause of the error, you can modify the process task and/or adapter so it can run successfully.

Note:

To determine why a process task might have failed:

Find the process task. When the process task has not yet been provisioned to the target user or organization, it is located in the To Do List or Pending Approvals. To find the task:

Log in as the user.

Select the To Do List link or the Pending Approvals links in the left side of the window.

3.5.2Attaching Process Task Adapters to Process Tasks

In the previous chapter, you learned how to create a process task adapter. You must attach it to a process task to execute that process task automatically.To connect an adapter to a process task, access the Integration tab (from the Process Definition form). From this tab, you can also map any adapter variables to their proper locations.The following procedure shows you how to attach a process task adapter to a process task:

Open the Process Definition form, which is located in the Process Management folder.

In the Oracle Identity Manager Workspace, the Process Definition form appears.

Select the process, which contains a task to which you want to attach an adapter. The selected process, along with its tasks, appears in the Process Definition form. For this example, the Solaris process has been selected.

Double-click the row header of the task to which you want to attach an adapter. The Editing Task window appears, containing information about the task (for example, the Password Updated process task).

Click the Integration tab.

Click Add.

The Handler Selection window appears.

To access Oracle Identity Manager adapters, click the Adapter option.

The adapters appear, which you can attach to the process task.

From this region, select the adapter that you want to attach to the process task, for example, the adpSOLARISPASSWORDUPDATED adapter.

Tip:

For classification purposes, the first three letters of each adapter's name are adp. For classification purposes, the first three letters of each adapter's name are adp.

From the Handler Selection window's toolbar, click Save.

A dialog box appears, stating that the adapter was successfully added to the process task.

Click OK.

The dialog box disappears, and the Integration tab is now active. This tab now displays the following:

The name of the adapter that is attached to the process task;

The status of the adapter; and

The names, descriptions, and mapping statuses of the adapter's variables.

Note:

An adapter can have one of three mapping statuses:

Ready. This adapter has been successfully compiled, and all of its variables have been mapped correctly.

Mapping Incomplete. This adapter has been successfully compiled, but at least one of its variables have not been mapped correctly.

Adapter Unavailable. After this adapter had been compiled successfully, it was modified, and recompiled.

Note:

If an adapter does not have any mappable variables, the Adapter Variables region is empty. In addition, the Status field will display either Ready or Adapter Unavailable, depending on whether the adapter has to be recompiled.

Note:

A mappable adapter variable either has been designated as ResolveatRun time or it is an adapter return variable.

Note:

Once you attach the adapter to the process task, any responses that you defined for the adapter appear in the Responses tab of the Editing Task window.

Set the mappings for each variable that appears in the Adapter Variables region of the Integration tab. To do so, double-click the row header of the variable you want to map (for example, SolarisUserID).

The Data Mapping for Variable window is displayed.

Table 3-5 describes the fields of the Data Mapping for Variable window.

Table 3-5 Fields of the Data Mapping for Variable WIndow

Field Name

Description

Variable Name

This field displays the name of the adapter variable for which you are setting a mapping (for example, SolarisUserID).

Data Type

This field shows the data type of the adapter variable (for example, String is the data type for the SolarisUserID variable).

Map To

This field contains the types of mappings that you can set for the adapter variable (for example, IT Resources).When you map the adapter variable to a location or a contact, Oracle Identity Manager enables the adjacent combo box. From this combo box, select the specific type of location or contact to which you are mapping the adapter variable. In addition, if you map the adapter variable to a custom process form, and this form contains child table(s), Oracle Identity Manager enables the adjacent combo box. From this combo box, select the child table to which you are mapping the adapter variable. If you are not mapping the adapter variable to a location, contact, or child table of a custom process form, this combo box is grayed out.

Qualifier

This field contains the qualifiers for the mapping you selected in the Map to combo box (for example, IT Asset).

IT Asset Type

This field enables you to select a specific IT Resource (for example, Solaris) when you map an adapter variable to an IT Resource, and this variable's data type is String.

If you are not mapping the adapter variable to an IT Resource, or the variable's data type is not String, this field does not appear.

IT Asset Property

This field enables you to select a specific field that will receive the results of the mapping (for example, User Name), when you map an adapter variable to an IT Resource, and this variable's data type is String.

If you are not mapping the adapter variable to an IT Resource, or the variable's data type is not String, this field does not appear.

Important: The IT Asset Type and IT Asset Property fields are included within this window for backward compatibility. The preferred way is to create an adapter variable with a data type of IT Resource, in which case these fields will not appear.

Literal Value

When you map the adapter variable to a literal, use this field to specify the specific literal value.

If you are not mapping the adapter variable to a literal, this field does not appear.

Old Value

By selecting this check box, you map the adapter variable to the value that was originally in the selected Qualifier field before modification.

Process task adapters associated with process tasks are conditionally triggered when some field on the process form gets changed. If you click the Old Value option, and the process task is marked Conditional, the value that is passed to the adapter is the previous value of the field, before it got modified. This is useful in cases of fields that accept passwords. For example, if you want to disallow setting the password to the same value, you can use the old value for comparison.

If you are not mapping the adapter variable to a field that belongs to a child table of a custom process form, this check box is grayed out.

The Data Mapping for Variable window disappears. The Integration tab is active again.

On the Editing Task window toolbar, click Save.

The contents in the Status field change from Mapping Incomplete to Ready. In addition, the mapping statuses for the adapter's variables change from No (N) to Yes (Y).

On the toolbar, click Close.

The Editing Task window disappears, and the main screen is active once again. The adapter you added to the Password Updated task (adpSOLARISPASSWORDUPDATED) appears in the Process Definition form.This signifies that the adpSOLARISPASSWORDUPDATED process task adapter was attached to the Password Updated process task.

Tip:

Once you attach a process task adapter to a process task, a quick way to see the process and task to which it is connected is by accessing the Usage Lookup tab of the Adapter Factory form.

3.5.3Removing Process Task Adapters from Process Tasks

If a process task adapter is no longer necessary for Oracle Identity Manager to complete the process task automatically, or when you wish to attach a different adapter to a process task, you must first remove the adapter that is attached to the process task.This procedure will show you how to remove a process task adapter from a process task.

3.5.3.1 To Remove a Process Task Adapter from a Process Task

Open the Process Definition form.

In the Design Console workspace, the Process Definition form appears.

Select the process, which contains a task from which you want to remove an adapter (for example, the Solaris process).

The selected process, along with its tasks, appears in the Process Definition form.

Double-click the row header of the process task from which you want to remove the adapter (for example, the Password Updated task).

The Integration tab displays information about the adapter that is attached to the process task.

Click Remove.

A dialog box appears, asking if you want to remove the adapter from the process task.

Click OK.

A dialog box appears, signifying that the adapter has been removed from the process task.

Click OK.

The contents of the adapter no longer appear in the Integration tab.

On the toolbar, click Close.

The Editing Task window disappears, and the main screen is active once again. The adapter that was once linked to the Password Updated task (adpSOLARISPASSWORDUPDATED) no longer appears in the child table of the Process Definition form.

This signifies that you have removed the adapter from the process task.

3.6Adapter Mapping Information

An adapter is a Java class, generated by the Adapter Factory, which enables Oracle Identity Manager to interact with an external JAR file, a target IT resource (for example, a resource asset), or a user-defined form. The Adapter Factory is a code-generation tool provided by Oracle Identity Manager, which enables a User Administrator to create Java classes.

An adapter extends the internal logic and functionality of Oracle Identity Manager. It automates process tasks, and defines the rules for the auto-generation and validation of data in fields within Oracle Identity Manager. There are five types of adapters: task assignment adapters, task adapters, rule generator adapters, pre-populate adapters, and entity adapters.

3.6.1 Adapter Task Mapping Information

An adapter task is one of the several possible components within an adapter. And this is a logical step within an adapter, equivalent to calling a programming language method. The following types of adapter tasks are available: Functional Tasks (Java Task, Remote Task, and Stored Procedure Task), Utility Tasks (Utility Task and Oracle Identity Manager API Task), and Logic Tasks (Set Variable Task and Error Handler Task).

This section lists the mappings that you can set for the parameters of an adapter task, in the following topics:

3.6.1.1 Adapter Variables

The following table lists and describes the items of the Map To list box of the Data Mapping for Variable window and the Name list box to which you can map the parameters of an adapter variable for an adapter task.

Map To Combo Box

Name Combo Box

Description

Adapter Variables

A list of adapter variables are displayed

You can map the parameter to the adapter variables that you created for this adapter.

Note: When the adapter variable's classification type is Object, it cannot be used with process task adapters.

Note: If the adapter variable's classification type is IT Resource, then an Attribute combo box is displayed. From this combo box, select the attribute of the IT resource to which you wish to map the parameter.

3.6.1.2 Adapter Task

The following table lists and describes the items of the Map To, Name, and Output combo boxes of the Adapter Factory form to which you can map the parameters of an adapter task.

Map To Combo Box

Name Combo Box

Output combo Box

Description

Adapter Task

A list of adapter tasks are displayed.

A list of output variables pertaining to the selected adapter task is displayed.

You can map the parameter to the adapter tasks that you created for this adapter.

3.6.1.3Literal

The following table lists and describes the items of the Map To and Type combo boxes, as well as the Value field of the Adapter Factory form, to which you can map the parameters of a constant (or literal) for an adapter task.

3.6.1.4 Adapter References

The following table lists and describes the items of the Map To and Type combo boxes of the Adapter Factory form to which you can map the parameters of an adapter reference for an adapter task.

Map To Combo Box

Type Combo Box

Description

Adapter References

Event Handler Name or Database Reference

You can map the parameter to the active adapter.

3.6.1.5Organization Definition

The following table lists and describes the items of the Map To and Field combo boxes of the Adapter Factory form to which you can map the parameters of an organization definition for an adapter task.

Map To combo box

Field Combo Box

Description

Organization Definition

Organization Name

You can map the parameter to the Organization Name field of the Organizations form.

Organization Type

You can map the parameter to the Type field of the Organizations form.

Organization ID

You can map the parameter to the Organization # field of the Organizations form.

Organization Parent

You can map the parameter to the Parent Organization field of the Organizations form.

Organization Status

You can map the parameter to the Status field of the Organizations form.

Organization Parent ID

You can map the parameter to the parent_key field in the ACT database table.

Any fields that are displayed in the User Defined Fields tab of the Organizations form.

You can map the parameter to the selected user-defined field.

3.6.1.6Process Definition

The following table lists and describes the items of the Map To and Field combo boxes of the Adapter Factory form to which you can map the parameters of a process definition for an adapter task.

Map To Combo Box

Field Combo Box

Description

Process Definition

Name

You can map the parameter to the Name field of the Process Definition form.

Type

You can map the parameter to the Type field of the Process Definition form.

3.6.1.7User Definition

The following table lists and describes the items of the Map To and Field combo boxes of the Adapter Factory form to which you can map the parameters of a user definition for an adapter task.

Map To Combo Box

Field Combo Box

Description

User Definition

User Key

You can map the parameter to a key, representing a unique record of the Users form.

First Name

You can map the parameter to the First Name field of the Users form.

Middle Initial

You can map the parameter to the Middle Name field of the Users form.

Last Name

You can map the parameter to the Last Name field of the Users form.

User Login

You can map the parameter to the User ID field of the Users form.

Password

You can map the parameter to user password of the Users form.

Type

You can map the parameter to the Xellerate Type field of the Users form.

User Status

You can map the parameter to the Status field of the Users form.

Role

You can map the parameter to the Role field of the Users form.

Identity

You can map the parameter to the Identity field of the Users form.

Disabled

You can map the parameter to the Disable User check box of the Users form.

Organization

You can map the parameter to the Organization field of the Users form.

Manager

You can map the parameter to the Manager field of the Users form.

Start Date

You can map the parameter to the Start Date field of the Users form.

End Date

You can map the parameter to the End Date field of the Users form.

Email

You can map the parameter to the Email field of the Users form.

Provisioning Date

You can map the parameter to the Provisioning Date field of the Users form.

Provisioned Date

You can map the parameter to the Provisioned Date field of the Users form.

Deprovisioning Date

You can map the parameter to the Deprovisioning Date field of the Users form.

Deprovisioned Date

You can map the parameter to the Deprovisioned Date field of the Users form.

Any fields that are displayed in the User Defined Fields tab of the Users form.

You can map the parameter to the selected user-defined field.

3.6.2 Adapter Variable Mapping Information

For a newly created adapter to work, you can map data to the parameters of the adapter's tasks. For this reason, you create placeholders, also known as adapter variables, to map the data at run time. Once an adapter variable is not needed for the adapter to run, you can remove it from the adapter. After you have deleted the adapter variable, recompile the adapter.

When an adapter variable is not the adapter return variable, or it is not designated as Resolve at Run time, it should be mapped within the Variable List tab of the Adapter Factory form. On the other hand, if the adapter variable is classified as an adapter return variable, or the adapter variable is set to Resolve at Run time, it can be mapped at another location within Oracle Identity Manager. This location is contingent upon the adapter's type. For example, the variables of a process task adapter will be mapped at a different place than the variables of a pre-populate adapter. The following table lists the variables of a particular type of adapter that can be mapped.

The fields of the Users form to which you can map the adapter variable.

Literal

If you are mapping the adapter variable to a literal, and the variable's data type is String, Character, Byte, Integer, Float, Long, Short, or Double, a Literal Value field is displayed below the Qualifier combo box. Within the field, enter the value of this literal.

When you are mapping the adapter variable to a literal, and the variable's data type is Boolean, two Literal Value options are displayed below the Qualifier combo box: True and False. Select the option that corresponds to the value of the adapter variable.

If you are mapping the adapter variable to a literal, and the variable's data type is Date, a Literal Value lookup field is displayed below the Qualifier combo box. Double-click this lookup field. From the Date & Time window that is displayed, select the date and time that will be the value of this literal.

String

IT Resources

If you are mapping the adapter variable to an IT Resource, three combo boxes are displayed below the Map To combo box: Qualifier, IT Asset Type, and IT Asset Property. From these combo boxes, select the qualifier for the mapping, the specific name of the IT resource, and the field of the IT resource that will receive the results of the mapping.

Note: If the data type of the adapter variable is not String, IT Resources cannot be selected from the Map To combo box.

3.6.2.3Task Assignment Adapter Variable Mappings

The following table lists the task assignment adapter variable mappings.

Variable Type

Map To

Qualifier/Description

IT Resource

Object Data

You can map the parameter to an IT resource's instance key. This IT resource is a member of the IT resource type that is displayed in parenthesis from within the Data Type field.

IT Resource

You can map the parameter to an IT resource.

Object (Adapter Return Value)

Object Data

You can map the parameter to a field of either the associated custom resource object form, or a child table that belongs to this form.

Response Code

NA

Task Information

The fields of the Task List form to which you can map the adapter variable.

Process Definition

The fields of the Process Definition form to which you can map the adapter variable.

Organization Definition

The fields of the Organizations form to which you can map the adapter variable.

User Definition

The fields of the Users form to which you can map the adapter variable.

If you are mapping the adapter variable to a literal, and the variable's data type is String, Character, Byte, Integer, Float, Long, Short, or Double, a Literal Value field is displayed below the Qualifier combo box. Within the field, enter the value of this literal.

When you are mapping the adapter variable to a literal, and the variable's data type is Boolean, two Literal Value options are displayed below the Qualifier combo box: True and False. Select the option that corresponds to the value of the adapter variable.

If you are mapping the adapter variable to a literal, and the variable's data type is Date, a Literal Value lookup field is displayed below the Qualifier combo box. Double-click this lookup field. From the Date & Time window that is displayed, select the date and time that will be the value of this literal.

String

IT Resources

If you are mapping the adapter variable to an IT Resource, three combo boxes are displayed below the Map To combo box: Qualifier, IT Asset Type, and IT Asset Property. From these combo boxes, select the qualifier for the mapping, the specific name of the IT resource, and the field of the IT resource that will receive the results of the mapping.

Note: If the data type of the adapter variable is not String, then IT Resources cannot be selected from the Map To combo box.

Scripting on this page enhances content navigation, but does not change the content in any way.