Connections > Oracle HCM Cloud V1 connection properties > Connect to Oracle HCM
  

Connect to Oracle HCM

Let's configure the Oracle HCM Cloud V1 connection properties to connect to Oracle HCM Cloud.

Before you begin

Before you configure a connection, get the WebCenter Content URL where Oracle HCM Cloud uploads the output XML data and ensure that the required roles are assigned to you.
Check out Prerequisites to learn more about these tasks.

Connection details

The following table describes the basic connection properties:
Property
Description
Connection Name
Name of the connection.
Each connection name must be unique within the organization. Connection names can contain alphanumeric characters, spaces, and the following special characters: _ . + -,
Maximum length is 255 characters.
Description
Description of the connection. Maximum length is 4000 characters.
Type
Oracle HCM Cloud V1
Use Secret Vault
Stores sensitive credentials for this connection in the secrets manager that is configured for your organization.
This property appears only if secrets manager is set up for your organization.
This property is not supported by Mass Ingestion.
When you enable the secret vault in the connection, you can select which credentials that the Secure Agent retrieves from the secrets manager. If you don't enable this option, the credentials are stored in the repository or on a local Secure Agent, depending on how your organization is configured.
For information about how to configure and use a secrets manager, see Secrets manager configuration.
Runtime Environment
The name of the runtime environment where you want to run tasks.
Select a Secure Agent, Hosted Agent, or serverless runtime environment.
WebCenter Content URL
The URL of WebCenter Content Server where Oracle HCM Cloud uploads the output XML data.
Note: To validate the WebCenter Content URL, type the following URL in the web browser:
<Webcenter Content URL>/idcws/GenericSoapPort?WSDL
If the URL opens a WSDL file, then the WebCenter Content URL is valid.
HCM URL
The URL of the HCM Application Server that contains newly created data after the Secure Agent loads the XML data from the WebServer Content Server to the HCM Application Server.
The following URL shows a sample HCM URL: https://adc-xxx-hcm.oracledemo.com/
To validate the HCM URL, type the following URL in the web browser:
<HCM URL>/hcmProcFlowCoreController/FlowActionsService?WSDL
If the URL opens a WSDL file, then the HCM URL is valid.
Note: This property applies when you create an Oracle HCM Cloud V1 connection to write data to the Oracle HCM Cloud application or when you select Submit Extract in the advanced connection properties.
Authentication Type
The type of user authentication to connect to the Oracle HCM Cloud application.
Select Basic Authentication type.
Username
User name of the Oracle HCM Cloud account.
Password
Password for the Oracle HCM Cloud account.
Schema Directory
The directory path where HCM extract definitions XSD and XLSX are stored on the Secure Agent machine.
Click the Test button after you create an Oracle HCM Cloud V1 connection.
The Secure Agent creates following directories under the schema directory:
Reader
The reader directory contains the XSD files. Place all the XSD files after you generate them under the reader directory.
Writer
The writer directory contains the XLSX files. Place all the XLSX files after you download them under the writer directory.
Temp
The temp directory contains the staging files before loading.

Advanced settings

The following table describes the advanced connection properties:
Property
Description
Submit Extract
Submits HCM extract definitions with the parameter values that you specify in the request message.
Default is disabled.
When you enable the Submit Extract option, the Secure Agent submits the instance of the HCM extract definition that you specify and downloads the latest output data file corresponding to the HCM extract definition from the WebCenter Content Server.
You can also submit HCM extract definitions from the Oracle HCM Cloud application directly.
Note: This property applies when you read data from the Oracle HCM Cloud application.

Encryption mode

You can configure PGPUNSIGNED and PGPSIGNED encryption mode to access Oracle HCM Cloud. Default is None.
Select the required encryption mode to encrypt or decrypt the data when you run a mapping to write data to a target.

Related links