Flat File Connector: Creating Adapter and Process Tasks for Child Form

Description: You will be creating an adapter that is responsible for performing provisioning operations on the flat file connector roles child form. Then you will create process tasks for insert, delete, and update that use this adapter.



Child Form Adapter
This step includes creating an adapter for the roles child form. This adapter would be calling the updateChildTableValues API of the ICProvisioningManager.

1. Log into designconsole and navigate to Development Tools -> Adapter Factory.

2. Create the adapter with the following information given below.
Adapter Name: adpFFUpdateChildData
Adapter Type: Process Task
Description: This adapter updates the target with child table data. The same adapter can be used for insert/update/delete in child table data.

3. Under the Variables List, create the following adapter variables.

Name	Type	Mapped As	Description
objectType	String	Resolve at runtime	This is the object type.
processInstanceKey	Long	Resolve at runtime	Process Instance Key
itResourceFieldName	String	Resolve at runtime	IT Resource Field Name
childTableName	String	Resolve at runtime	Child Table Form Name

3. Under the Adapter Tasks tab, add a Java task to adpFFUpdateChildData.

Adapter Task Type: Functional Task -> Java

New Object Instance

Task Name: Update Child Data

API Source: ICFIntgJar:icf-oim-intg.jar

Application: oracle.iam.connectors.icfcommon.prov.ICProvisioningManager

Constructors: oracle.iam.connectors.icfcommon.prov.

ICProvisioningManager(java.lang.String,long,com.thortech.xl.dataaccess.tcDataProvider)

Methods: oracle.iam.connectors.icfcommon.prov.ICProvisioningManager.

updateChildTablesVaues(java.lang.String,java.lang.String)

Application Method Parameters:

• Constructor
• Input: String
• Map To: Adapter Variables
• Name: ITResourceFieldName
• Input: long
• Map To: Adapter Variables
• Name: processInstanceKey
• Input: com.thortech.xl.dataaccess
• Map To: Adapter References
• Name: Database reference
• Method
• Output: String
• Map To: Adapter Variables
• Name: Return variable
•  Input: String
• Map To: Adapter Variables
• Name: objectType

4. Build the adapter.

Process Task for Child Table
This step includes creating process tasks when an insert, a delete, or an update happens on the roles child table.

1. In design console, navigate to Process Management -> Process Definition.

2. Create the following process task for the Flat File process definition.
Task Name: Child table insert
Description: This task runs when an insert happens on child table.
Task Properties: Check Conditional, Allow Cancellation while Pending, and Allow Multiple Instances
Task Effect: No Effect
Child Table: UD_FLAT_CH
Trigger Type: insert

3.  Under Integration tab, attach adpADFFUPDATECHILDDATA adapter and map the variables accordingly.

Name	Map To	Qualifier	Literal Value
Adapter return value	Response Code	N/A	N/A
objectType	Literal	String	User
processInstanceKey	Process Data	Process Instance	N/A
itResourceFieldName	Literal	String	UD_FLAT_FIL_SERVER
childTableName	Literal	String	UD_FLAT_CH

4. Under Responses tab, add the following response codes:

Response	Description	Status
SUCCESS	Operation Completed	C
ERROR	Error Occurred	R

5. For update and delete process tasks, repeat steps 1 to 4. The only differences are information you specify for step 2.

Step 2 Update Process Task for Roles Child Form
Task Name: Child table update
Description: This task is called when an update happens to child table data.
Trigger Type: update

Step 2 Delete Process Task for Roles Child Form
Task Name: Child table delete
Description: This task is triggered when data in roles child table is deleted.
Trigger Type: delete