Flat File Connector: Process Definition and Process Tasks

Here you are going to create a process definition for the Flat File connector. Then you will need create several standard process tasks. For these process tasks, you will attach the adapters you've created in Flat File Connector: Creating Adapters for Parent Form section.

The Create User process task is executed whenever you provision a Flat File account to an OIM User. The Delete User process task is called whenever you revoke a user's Flat File account in OIM. The Enable User process task is called whenever you manually enable a user's Flat File account in OIM. For each attribute on the Flat File parent process form excluding Server attribute, you will need to create an update process task.
 
In designconsole, open Process Defintion under Process Management.


Process Definition
Purpose: Create a process definition for the Flat File connector.
Name: Flat File
Type: Provisioning
Object Name: FLATFILERESOURCE
Table Name: UD_FLAT_FIL

Process Tasks
This section includes steps to create process tasks for create, delete, enable, disable and update operations. Under the Tasks tab, add the following process tasks given below.

1. Create Process Task
Task Name: Create User
Task Description: Creates a user on the target
Check Required for Completion and Allow Cancellation While Pending
Task Effect: No Effect

On the Integration tab, add the create user adapter.
Handler Type: Adapter
Handler Name: adpADPFFCREATEUSER

Map the adapter variables. The literal value for the itResourceFieldName should be the IT Resource field column name on the process form.

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

On the Responses tab, add the following responses given below.

Response	Description	Status
SUCCESS	Operation Completed	C
ERROR	Error Occurred	R

On the Task to Object Status Mapping tab, change the C status to have Object Status of "Provisioned".

Save the process task. You should see the Create User task on the Flat File process definition.

2. Delete Process Task
Task Name: Delete User
Task Description: Deletes the user on the target
Check Conditional and Allow Cancellation While Pending
Task Effect: No Effect

On the Integration tab, add the delete user adapter and map the adapter variables accordingly.
Handler Type: Adapter
Handler Name: adpADPFFDELETEUSER

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

On the Responses tab, add the following responses given below.

Response	Description	Status
SUCCESS	Operation Completed	C
ERROR	Error Occurred	R

On the Task to Object Status Mapping tab, change the C status to have Object Status of "Revoked".

Open the "Create User" task and under Undo/Recovery section assign "Delete User" as an Undo task.

3. Enable Process Task
Task Name: Enable User
Task Description: This enables the user on the target system
Check Conditional, Allow Cancellation while Pending, and Allow Multiple Instances
Task Effect: Enables Process Or Access To Application

On the Integration tab, add the enable user adapter and map the adapter variables accordingly.
Handler Type: Adapter
Handler Name: adpADPFFENABLEUSER

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

On the Responses tab, add the following responses given below.

Response	Description	Status
SUCCESS	Operation Completed	C
ERROR	Error Occurred	R

On the Task to Object Status Mapping tab, change the C status to have Object Status of "Enabled".

4. Disable Process Task
Task Name: Disable User
Task Description: This disables a user on the target system
Check Conditional, Allow Cancellation while Pending and Allow Multiple Instances
Task Effect: Disables Process Or Access To Application

On the Integration tab, add the disable user adapter and map the adapter variables accordingly.
Handler Type: Adapter
Handler Name: adpADPFFDISABLEUSER

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

On the Responses tab, add the following responses given below.

Response	Description	Status
SUCCESS	Operation Completed	C
ERROR	Error Occurred	R

On the Task to Object Status Mapping tab, change the C status to have Object Status of "Disabled".

5. Update Process Task
You will need to create an update process task for AccountID, Email, FirstName, and LastName (The fields on the Flat File parent process form). Substitute <> with the approiate value. FirstName is used as an example in the screenshots given below.

Task Name: <Field Label Name> Updated
Task Description: This task is triggered when <Field Label Name> attribute of parent form gets updated.
Check Conditional, Allow Cancellation while Pending, and Allow Multple Instances.
Task Effect: No Effect

On the Integration tab, add the update user adapter and map the adapter variables accordingly.
Handler Type: Adapter
Handler Name: adpADPFFUPDATEUSER

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
attrFieldName	Literal	String	<Field Label Name>

On the Responses tab, add the following responses given below.

Response	Description	Status
SUCCESS	Operation Completed	C
ERROR	Error Occurred	R