3 Install and Configure the Recipe
On your Oracle Integration instance, install the recipe package to deploy and configure the integrations and associated resources.
-
On the Oracle Integration home page, scroll to the Accelerators & Recipes section.
-
Click Search All.
-
Find the recipe package you want to install.
-
Select the package, and then click the Install icon.
-
After the package is installed, click the Configure icon on the recipe card to configure the resources deployed by the package.
The Configuration Editor page opens, displaying all the resources of the recipe package. Configure the following resources before you activate and run the recipe.
Configure the Oracle REST OIC API Connection
-
On the Configuration Editor page, select Oracle REST OIC API Connection, then click Edit. The connection configuration page appears.
-
In the Connection Properties section, enter the following details.
Table 3-1 Connection Properties
Field Information to Enter Connection Type
Leave REST API Base URL selected.
Connection URL
Enter the host name of the Oracle Integration instance in which you have installed the recipe.
-
In the Security section, enter the following details.
Table 3-2 Security
Field Information to Enter Security Policy
Select Basic Authentication.
Username
Enter the username of the Oracle Integration user account with the Service Invoker role. See System and Access Requirements.
Password
Enter the password of the Oracle Integration user account with the Service Invoker role.
-
Click Save. If prompted, click Save for a second time.
-
Click Test to ensure that your connection is successfully configured. A confirmation message is shown if your test is successful.
-
Click Back to return to the Configuration Editor page. Click Save again if prompted.
Configure the Oracle HCM Cloud Connection MICROS
-
On the Configuration Editor page, select Oracle HCM Cloud Connection MICROS.
-
Click Edit. The connection configuration page appears.
-
In the Connection Properties section, enter the Oracle Cloud HCM host name. For example:
https://your_domain_name.fa.DC.oraclecloud.com
. -
In the Security section, enter the following details.
Table 3-3 Security
Field Information to Enter Security Policy
Select Username Password Token.
Username
Enter the username of the account created for Oracle Integration on Oracle Cloud HCM. See Configure Oracle Cloud HCM
Password
Enter the password of the account created for Oracle Integration on Oracle Cloud HCM.
-
Click Save. If prompted, click Save for a second time.
-
Click Test to ensure that your connection is successfully configured. A confirmation message is shown if your test is successful.
-
Click Back to return to the Configuration Editor page. Click Save again if prompted.
Configure the Oracle MICROS FTP Connection
-
On the Configuration Editor page, select Oracle MICROS FTP Connection, then click Edit. The connection configuration page appears.
-
In the Connection Properties section, enter the following details:
Table 3-4 Connection Properties
Field Information to Enter FTP Server Host Address
Enter the FTP Server HostName.
FTP Server Port
SFTP Connection
Enter the FTP Server Port number.
Select YES from the drop-down list.
-
In the Security section, enter the following details:
Table 3-5 Security
Field Information to Enter Security
Select FTP Server Access Policy.
User Name
Enter the FTP Server username.
Password
Enter the FTP Server password.
-
Click Save. If prompted, click Save for a second time.
-
Click Test to ensure that your connection is successfully configured. A confirmation message is shown if your test is successful.
-
Click Back to return to the Configuration Editor page. Click Save again if prompted.
Configure the Lookup Tables
Edit the lookup tables and enter the necessary values. On the Configuration Editor page, select a lookup table, and click Edit.
This recipe package contains the following lookup tables:
Oracle-BRT-MICROS_HCM_TimeCard_Config
This lookup holds the mapping between HCM and LM. The following table provides a description for each parameter:
Table 3-6 Oracle-BRT-MICROS_HCM_TimeCard_Config
Key | Description |
---|---|
SimphonyTimeCardFilePattern |
This represents the file format of the timecard export zip file. Example Value: standard.Payroll_* |
SimphonyTimeCardFileDir |
File directory on the FTP server from which the integration picks up the export files. Example Value: LaborManagement/OICRecipe/HCM/Timecard |
FailedTCFiles |
Directory on external FTP server to write the failed records, if there are failures in processing timecard files in HCM. Example Value: LaborManagement/OICRecipe/HCM/Timecard/Failed Note: The FTP server for failed records should not be the same as the MICROS LM FTP server. Failed records need to be monitored and action needs to be taken to resubmit and reprocess the failed records. |
PayrollRegularTimeType |
Timecard type for processing in HCM. Each timecard is created with this type for processing. Example Value: TL_Regular |
Oracle-BRT-HCM_Micros_Notification_Config
This lookup table contains the information needed to trigger the error handlers. The following table provides the description for each parameter:
Table 3-7 Oracle-BRT-HCM_Micros_Notification_Config
Name | Description |
---|---|
OIC |
The email address for the OIC administrator that must be notified on failures. |
HCM |
The email address of the HCM administrator that must be notified on failures. |
MICROS |
The email address of the LM administrator that must be notified on failures. |