3 Install and Configure the Recipe

On your Oracle Integration instance, install the recipe package to deploy and configure the integrations and associated resources.

  1. On the Oracle Integration home page, scroll to the Accelerators & Recipes section.

  2. Click Search All.

  3. Find the recipe package that you want to install.

  4. Select the package, and then click the Install icon.

  5. 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 resources of the recipe package. Configure the following resources before you activate and run the recipe.

Configure the Oracle REST OIC API Connection

  1. On the Configuration Editor page, select Oracle REST OIC API Connection, and then click Edit. The connection configuration page appears.

  2. In the Connection Properties section, enter the following details:

    Field Information to Enter

    Connection Type

    Leave REST API Base URL selected.

    Connection URL

    Enter the host name of the Oracle Integration instance where you installed the recipe.

  3. In the Security section, enter the following details:

    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.

  4. Click Save. If prompted, click Save again.

  5. Click Test to ensure that your connection is successfully configured. A message confirms if your test is successful.

  6. Click Back to return to the Configuration Editor page. If prompted, click Save again.

Configure the Oracle REST OIC Internal API Connection

  1. On the Configuration Editor page, select Oracle REST OIC Internal API Connection, and then click Edit. The connection configuration page appears.

  2. In the Connection Properties section, enter the following details:

    Field Information to Enter

    Connection Type

    Leave REST API Base URL selected.

    Connection URL

    Enter the host name of the Oracle Integration instance where you installed the recipe.

  3. In the Security section, enter the following details:

    Field Information to Enter

    Security Policy

    Select Basic Authentication.

    Username

    Enter the username of the Oracle Integration user account with the Developer role. See System and Access Requirements.

    Password

    Enter the password of the Oracle Integration user account with the Developer role.

  4. Click Save. If prompted, click Save again.

  5. Click Test to ensure that your connection is successfully configured. A message confirms if your test is successful.

  6. Click Back to return to the Configuration Editor page. If prompted, click Save again.

Note:

If you want to use OAuth as the Security Policy, you can use and configure it accordingly.

Configure the Oracle HCM Cloud Connection MICROS

  1. On the Configuration Editor page, select Oracle HCM Cloud Connection MICROS.

  2. Click Edit. The connection configuration page appears.

  3. In the Connection Properties section, enter the Oracle Fusion Cloud HCM host name. For example: https://your_domain_name.fa.DC.oraclecloud.com.

  4. In the Security section, enter the following details:

    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 Fusion Cloud HCM.

    Password

    Enter the password of the account created for Oracle Integration on Oracle Cloud HCM.

  5. Click Save. If prompted, click Save again.

  6. Click Test to ensure that your connection is successfully configured. A message confirms if your test is successful.

  7. Click Back to return to the Configuration Editor page. If prompted, click Save again.

Configure the Oracle MICROS SOAP LABOR Connection

  1. On the Configuration Editor page, select Oracle SOAP OIC Connection, and then click Edit. The connection configuration page appears.

  2. In the Connection Properties section, enter the following details:

    Field Information to Enter

    WSDL URL

    Provide the WSDL Endpoint you captured earlier. See Configure Oracle MICROS Labor Management.

  3. In the Security section, enter the following details:

    Field Information to Enter

    Security

    Select Username Password Token.

    Username

    Enter the username token you captured earlier. See Configure Oracle MICROS Labor Management.

    Password

    Enter the password you captured earlier. See Configure Oracle MICROS Labor Management.

  4. Click Save. If prompted, click Save again.

  5. Click Test to ensure that your connection is successfully configured. A message confirms if your test is successful.

  6. Click Back to return to the Configuration Editor page. If prompted, click Save again.

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-HCM_MICROS_StoreMapping

This lookup holds the mapping between HCM Location Code and LM Location reference. The following table provides the description for each parameter:

Parameter Description

HCMLocationCode

Specifies the HCM Location Code.

Example value: QSR Austin

MICROSStore

Specifies the MICROS Location reference for the corresponding HCM Location Code.

Example value: SES_198

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:

Parameter Description

OIC

The OIC administrator email address that must be notified on failures.

HCM

The HCM administrator email address that must be notified on failures.

MICROS

The LM administrator email address that must be notified on failures.

Oracle-BRT-HCM_MICROS_JobMapping

This lookup table stores the mapping between HCM and LM job code, role mappings. The following table provides the description for each parameter:

Parameter Description

HCMEmployeeType

The HCM employee type.

Example value: Cashier

EmployeeRole

The role assigned to the employee in LM.

Example value: Cashier

EmployeeClass

The POS employee class POSRef assigned to this employee’s POS configuration in LM.

Example value: 301

EmployeePrivilege

The POS privileges assigned to the employee in LM.

Example value: 20004

EmployeeRolePOSReference

The POS reference for the employee role in LM.

Example value: 199

EnterprisePOSReference

The enterprise POS reference for the job code assigned to the employee record in LM.

Example value: 101

Oracle-BRT-HCM_AtomFeed_TimeStamp

This lookup holds the last successful processed entry from HCM Atom Feed. When integration is run it will query for all available entries starting from this timestamp in HCM.

Parameter Description

System

Specifies the last published entry in HCM New Hire Atom Feed that was processed successfully.

Example value: HCM

Do not modify this value.

TimeStamp

Specifies the last successfully processed Atom Feed records published Time Stamp.

Example value: 2022-05-13T11:19:14.829Z

Update this value based on the date from which you want to sync the employee records for your initial run. After initial run, the integration will pull the delta records from the last successful processed date.