Tuesday, December 3, 2013

Flat File Connector: Creating Adapters for Parent Form

To create an adapter, open Adapter Factory under Devlopment Tools in designconsole. Mentioned here are important adapters for the flat file connector parent form. Also, these adapters are standard for ICF connectors.


Create Adapter
This step includes creating an adapter for create provisioning operation. This adapter is responsible to take all the data from parent form and call the OIM ICF glue (icf-oim-intg.jar).

Adapter Name: adpFFCreateUser
Adapter Type: Process Task
Description: Adapter used to call the create API of the OIM ICF glue. This adapter takes all the data from the flat file parent form and passes them on to the glue, which in turn calls the connector SPI implementation where the data would be inserted into target.




In the Variable List tab, add the following 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



In the Adapter Tasks tab, add the following task to adpFFCreateUser:
Adapter Task Type: Functional Task ->Java
New Object Instance
Task Name: CreateUser
API Source: ICFIntgjar: icf-oim-intg.jar
Application: oracle.iam.connectors.icfcommon.prov.ICProvisioningManager
Methods: createObject(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



Build the adapter. The adapter should have a compile status of "OK".

Delete Adapter
This step includes creating an adapter for delete operation. This adapter is responsible to take the UID of the user being delete and pass it on to ICF OIM glue.

Adapter Details
Adapter Name: adpFFDeleteUser
Adapter Type: Process Task
Description: Adapter used to call the delete API of the OIM ICF glue. which in turn calls the connector SPI implementation where the data would be deleted from the target.

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

Adapter Tasks
Add the following task to adpFFDeleteUser:
Adapter Task Type: Functional Task ->Java
New Object Instance
Task Name: DeleteUser
API Source: ICFIntgjar: icf-oim-intg.jar
Application: oracle.iam.connectors.icfcommon.prov.ICProvisioningManager
Methods: deleteObject(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
Build the adapter.

Enable Adapter
The steps include creating an adapter for enable operation. This adapter calls the enableUser API of the ICF OIM glue.

Adapter Details
Adapter Name: adpFFEnableUser
Adapter Type: Process Task
Description: Adapter used to call the enableUser API of the OIM ICF glue. which in turn calls the connector SPI implementation where the user would be enabled on the target

Adapter Variables
Name Type Mapped As Description
processInstanceKey Long Resolve at runtime Process Instance Key
itResourceFieldName String Resolve at runtime IT Resource Field Name

Adapter Tasks
Add the following task to adpFFEnableUser:
Adapter Task Type: Functional Task ->Java
New Object Instance
Task Name: EnableUser
API Source: ICFIntgjar: icf-oim-intg.jar
Application: oracle.iam.connectors.icfcommon.prov.ICProvisioningManager
Methods: enableUser
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
Build the adapter.

Disable Adapter
This section includes creating an adapter for disable operation. This adapter is calls the disableUser API of the OIM ICF glue.

Adapter Details
Adapter Name: adpFFDisableUser
Adapter Type: Process Task
Description: Adapter used to call the disableUser API of the OIM ICF glue. which in turn calls the connector SPI implementation where the user would be disabled on the target


Adapter Variables
Name Type Mapped As Description
processInstanceKey Long Resolve at runtime Process Instance Key
itResourceFieldName String Resolve at runtime IT Resource Field Name

Adapter Tasks
Add the following task to adpFFDisableUser:
Adapter Task Type: Functional Task ->Java
New Object Instance
Task Name: DisableUser
API Source: ICFIntgjar: icf-oim-intg.jar
Application: oracle.iam.connectors.icfcommon.prov.ICProvisioningManager
Methods: disableUser
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
Build the adapter.

Update Adapter
This section includes steps to create an adapter to be used when an update happens to parent form field value.



Adapter Details
Adapter Name: adpFFUpdateUser
Adapter Type: Process Task
Description: This adapter is used when an attribute of the parent table gets updated

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
attrFieldName String Resolve at runtime Attribute Field Label on Parent Form

Adapter Tasks
Add the following task to adpFFUpdateUser:
Adapter Task Type: Functional Task ->Java
New Object Instance
Task Name: UpdateUser
API Source: ICFIntgjar: icf-oim-intg.jar
Application: oracle.iam.connectors.icfcommon.prov.ICProvisioningManager
Methods: updateAttributeValue(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
    • Input: String
      • Map To: Adapter Variables
      • Name: attrFieldName
Build the adapter.

No comments:

Post a Comment