How to use IBM App Connect with Oracle Human Capital Management

Oracle Human Capital Management is a complete cloud-based human resource management solution that improves the Human Resources (HR) capabilities and experiences.

Availability:
  • A connector in IBM App Connect Enterprise as a ServiceApp Connect Enterprise as a Service connector
  • A local connector in a Designer instance of IBM App Connect in containers (Continuous Delivery release)Local connector in containers (Continuous Delivery release) 12.0.4.0-r1 or later
  • A local connector in a Designer instance of IBM App Connect in containers (Long Term Support)Local connector in containers (Long Term Support release)

Connecting to Oracle Human Capital Management

Complete the connection fields that you see in the App Connect Designer Catalog page or flow editor. If necessary, work with your Oracle Human Capital Management administrator to obtain these values.

Table 1. Oracle Human Capital Management connection fields
Field Description Requirement
Endpoint URL The URL of your Oracle Human Capital Management cloud instance.
Note: For example, https://servername.fa.us2.oraclecloud.com.
True
Username The username to log in to your Oracle Human Capital Management cloud instance. True
Password The password for the specified username. True

To get the connection values (Endpoint URL, Username, and Password) for Oracle Human Capital Management, see the welcome email sent to you by the Oracle Cloud service administrator. For more information, see Quick Start on the Oracle Help Center page.

To connect to a Oracle Human Capital Management endpoint from the App Connect Designer Catalog page for the first time, expand Oracle Human Capital Management, then click Connect. For more information about ways to connect to Oracle Human Capital Management, see Managing accounts in App Connect.

Tip:

Before you use the account that is created in App Connect in a flow, rename the account to something meaningful that helps you to identify it. To rename the account on the Catalog page, select the account, open its options menu (⋮), then click Rename Account.

Advanced mode editing

When you add an operation to the flow, limited fields are shown on the flow UI. You can select advanced mode to add more fields according to your requirement. For more information about advanced mode, see Using advanced mode editing on the IBM Documentation page.

When you add Additional properties using Advanced mode, make sure that the key in the Property name field matches exactly with the API keys that are given on the REST API for Oracle HCM Cloud page. Thus, you are expected to have a basic knowledge of API/Postman collection to use the Additional properties function.

    1. In this example, assume that you are using Create job requisition action in Oracle Human Capital Management, and you want to add the assignment ID of the recruiter as an additional property.
    2. Go to the REST API for Oracle HCM Cloud page and copy the object name (for example, RecruiterAssignmentId).
      Recruiter Assignment ID object in the Oracle documentation page
    3. Use the object name (RecruiterAssignmentId) as the property name in the Additional properties section and provide the necessary input. Make sure that the object name matches exactly the name on the Oracle REST API page.
      Recruiter Assignment ID object in additional properties
    1. In this example, assume that you are using Create job requisition action in Oracle Human Capital Management, and you want to add a language as an additional property.
    2. Go to the REST API for Oracle HCM Cloud page and copy the object name (for example, languages).
      Languages object in the Oracle documentation page
    3. Use the object name (languages) as the property name in the Additional properties section and provide the necessary input. Make sure that the object name matches exactly the name on the Oracle REST API page.
      Languages object in additional properties
    4. Configure Postman with the necessary language parameters. For example:
      Sample input in Postman

      An output is generated in Postman with the complex additional properties. For example:

      Sample output in Postman

General considerations

Before you use App Connect Designer with Oracle Human Capital Management, take note of the following considerations:

  • (General consideration) You can see lists of the trigger events and actions that are available on the Catalog page of the App Connect Designer.

    For some applications, the events and actions in the catalog depend on the environment (IBM® Cloud Pak for Integration or App Connect on IBM Cloud) and whether the connector supports configurable events and dynamic discovery of actions. If the application supports configurable events, you see a Show more configurable events link under the events list. If the application supports dynamic discovery of actions, you see a Show more link under the actions list.

  • (General consideration) If you are using multiple accounts for an application, the set of fields that is displayed when you select an action for that application can vary for different accounts. In the flow editor, some applications always provide a curated set of static fields for an action. Other applications use dynamic discovery to retrieve the set of fields that are configured on the instance that you are connected to. For example, if you have two accounts for two instances of an application, the first account might use settings that are ready for immediate use. However, the second account might be configured with extra custom fields.

Events and actions

Oracle Human Capital Management events

Note: Events are not available for changes in this application. You can trigger a flow in other ways, such as at a scheduled interval or at specific dates and times.

Oracle Human Capital Management actions

These are actions on this application that you want a flow to complete.

Absence plan balances
Retrieve absence plan balances
Absence records
Create absence record
Update absence record
Retrieve absence records
Update or create absence record
Candidates
Create candidate
Update candidate
Delete candidate
Retrieve candidates
Update or create candidate
Direct reports
Retrieve direct reports
Job requisitions
Create job requisition
Update job requisition
Delete job requisition
Retrieve job requisitions
Update or create job requisition
Payrolls
Create assigned payroll
Performance evaluations
Retrieve performance evaluations
Performance goals
Retrieve performance goals
Talent person profiles
Create talent person profile
Update talent person profile
Retrieve talent person profiles
Update or create talent person profile
Time records
Retrieve time records
Worker reports
Retrieve worker reports
Workers
Create worker
Update worker
Retrieve workers
Update or create worker

More items are available when you have connected App Connect to Oracle Human Capital Management.

Examples

Dashboard tile for a template that uses Oracle HCM

Use templates to quickly create flows for Oracle Human Capital Management

Learn how to use App Connect templates to quickly create flows that perform actions on Oracle Human Capital Management. For example, open the Templates gallery, then search for Oracle HCM.

Oracle HCM flow in detailed view

Use IBM App Connect to build flows that integrate with Oracle Human Capital Management.

Read the blog in the IBM Community to learn how to create a list of workers for an upcoming assignment in Google Sheets from the Oracle Human Capital Management worker records. Click Learn more to read the blog.