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, in the Pick a Recipe/Accelerator section, click View All.

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

  3. Hover over the recipe, then click Install media/image1.png.

    A message confirms that the recipe was successfully installed, and the recipe card shows INSTALLED.

  4. Hover over the recipe again and click Configure media/image2.png to configure the resources of the recipe.

    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. In the Configuration Editor, under Connections, hover over the connection, then click Editmedia/image3.png.

  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 in which you’ve 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 test the connection.A confirmation message appears if your test is successful.

  6. To return to the Configuration Editor, click Go back media/image4.png.

Configure the Oracle HCM Cloud Connection MICROS

  1. In the Configuration Editor, under Connections, hover over the connection, then click Edit media/image3.png.

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

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

    Password

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

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

  5. Click Test to test the connection.A confirmation message appears if your test is successful.

  6. To return to the Configuration Editor, click Go back media/image4.png.

Configure the Oracle MICROS FTP Connection

  1. In the Configuration Editor, under Connections, hover over the connection, then click Edit media/image3.png.

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

    Field

    Information to Enter

    FTP Server Host Address

    Enter FTP Server Hostname

    See Configure MICROS Labor Management

    FTP Server Port

    SFTP Connection

    Enter FTP Server Port number

    Select YES from the drop-down list

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

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

  5. Click Test to test the connection.A confirmation message appears if your test is successful.

  6. To return to the Configuration Editor, click Go back media/image4.png.

Configure the Lookup Tables

In the Configuration Editor, click Lookups to view the lookup tables in the recipe. Hover over the lookup table to edit, then click Edit media/image3.png.

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 the description for each parameter:

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:

FTP server for failed records should not be same as 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 will be 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:

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.