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 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 the 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, then click Edit. The connection configuration page appears.

  2. 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.

  3. 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.

  4. Click Save. If prompted, click Save for a second time.

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

  6. Click Back to return to the Configuration Editor page. Click Save again if prompted.

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 Cloud HCM host name. For example: https://your_domain_name.fa.DC.oraclecloud.com.

  4. 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.

  5. Click Save. If prompted, click Save for a second time.

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

  7. Click Back to return to the Configuration Editor page. Click Save again if prompted.

Configure the Oracle MICROS FTP Connection

  1. On the Configuration Editor page, select Oracle MICROS FTP Connection, then click Edit. The connection configuration page appears.

  2. 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.

    See Configure MICROS Labor Management.

    FTP Server Port

    SFTP Connection

    Enter the FTP Server Port number.

    Select YES from the drop-down list.

  3. 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.

  4. Click Save. If prompted, click Save for a second time.

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

  6. 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.