Connector to Oracle Human Capital Management (HCM) Cloud

With the Oracle® HCM Cloud connector, you can use commands in a chain to retrieve grades, jobs, locations, and organizations from Oracle Human Capital Management® Cloud.

Note: This connector is built by Workiva and connects to a third-party system. While our Support team can help configure this connector within your workspace, we are unable to troubleshoot or otherwise assist with any issues that originate outside of the Workiva platform.

Prerequisites

To enable the connection, the connector uses the Oracle HCM Cloud REST API, secured with basic username and password authentication. To set up the connector, you'll need:

• A designated integration user set up in Oracle HCM Cloud for the connector
• The integration user's authentication credentials
• The host URL for the Oracle HCM Cloud environment to connect to, such as service.tenant.dataCenter.oraclecloud.com. Don't include the protocol—such as https://—or any path at the end.

Set up the Oracle HCM Cloud connector

Note: To make the connector available for use in your organization's chains, an org security administrator first enables it from Configuration.

1. From Chain Builder, click Connections  compare_arrows, and then Create at the top right.
2. Under BizApp Connection, select Oracle HCM Cloud and the default CloudRunner.
   
3. Under Basic Info, enter a unique name and description to help identify the connection.
4. Under Properties, enter the connector's details:
   
   

   Property	Details
   User name	Enter the username of the connector's integration user in Oracle HCM Cloud.
   Password	Enter the password for the User Name property.
   URL host	Enter the host URL of the Oracle HCM Cloud application to connect to, such as service.tenant.dataCenter.oraclecloud.com. Don't include the protocol—such as https://—or any path at the end.

   Note: All sensitive credentials are automatically encrypted and stored at Advanced Encryption Standard (AES)-256 encryption.

5. Select the environments to use with the connection, and click Save.
6. To test the connection, create and run a chain with the connector's Get Jobs command, and verify it returns a valid output.

Troubleshooting

If the connection to Oracle HCM Cloud fails:

• Verify the authentication credentials of the connector's integration user.
• Check the host URL of the Oracle HCM Cloud application to connect to. Ensure the connector's URL Host property doesn't include the protocol—such as https://—or any path at the end.