3 Install and Configure the Recipe

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

  1. On the Oracle Integration Home page, scroll to the Accelerators & Recipes section.
  2. Click Search All.
    The list of available recipes is displayed.
  3. Find and select the recipe package that you want to install, then click Install Install icon..
    A message confirms that the recipe was successfully installed, and the recipe card shows INSTALLED.
  4. After the package is installed, click Configure Configure icon on the recipe card.

    The Configuration Editor opens, displaying all the resources of the recipe package. Configure the following resources before you activate and run the recipe.

Configure the Oracle REST Primavera Connection

Use the following steps to configure the ORCL-BRT-PRIMAVERA_CLOUD_CON connection.

  1. In the Configuration Editor, select the connection, then click Edit Edit icon.
  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 your Oracle Primavera Cloud instance URL.
  3. In the Security section, enter the following details:
    Field Information to Enter
    Security Policy Select OAuth Client Credentials.
    Access Token URI Enter https://<Primavera_Host_Name>/primediscovery/apitoken/request.
    Client Id Enter the username of your Oracle Primavera Cloud instance.
    Client Secret Enter the password of your Oracle Primavera Cloud instance.
    Scope Enter http://{Primavera_Host_Name}/api.
    Client Authentication Select Send client credentials as basic auth header.
  4. Click Save. If prompted, click Save again.
  5. Click Test to ensure that your connection is successfully configured. In the resulting dialog, click Test again.
    A message confirms if your test is successful.
  6. To return to the Configuration Editor, click Back Back icon . Click Save again if prompted.

Configure the Oracle Jira Connection

Use the following steps to configure the ORCL-BRT-JIRA_CONNECTION connection.

  1. In the Configuration Editor, select the connection, then click Edit Edit icon.
  2. In the Connection Properties section, enter the Atlassian host name.
  3. In the Security section, enter the following details:
    Field Information to Enter
    Security Policy Select Authorization Code Credentials.
    Client ID Enter the integration key of the OAuth application created in Jira. See Configure Jira.
    Client Secret Enter the client secret of the OAuth application created in Jira.
    Scope Enter read:jira-work, manage:jira-project, write:jira-work, manage:jira-configuration, read:jira-user.
  4. Click Save. If prompted, click Save again.
  5. Click Provide Consent.
  6. In the resulting Sign in dialog, enter your Oracle Integration user name and password, and click Sign in.
    You'll now be redirected to the Jira login page.
  7. Enter your Jira account credentials and click Continue to log in.
    You are now displayed a page that prompts you to authorize the connection to the Jira application created previously.
  8. On the Jira web page, click ACCEPT.
    You're informed that access to Jira is allowed. You can now switch back to the Jira Connection window of Oracle Integration to test your connection.
  9. In the Oracle Jira Connection window, click Test to ensure that your connection is successfully configured.
    A message confirms if your test is successful.
  10. To return to the Configuration Editor, click Back Back icon . Click Save again if prompted.

Configure the Lookup Tables

Edit the following lookup tables to map the fields between your Jira and Oracle Primavera Cloud instances.

  • ORACLE-BRT-PRIMAVERA_CONSTANTS: Used to map the fields between Jira and Oracle Primavera Cloud.

  • ORACLE-BRT-JIRA_PRIMAVERA_STATUS: Used to map the status of the issue in Jira with the status of the corresponding activity in Oracle Primavera Cloud.

  1. In the Configuration Editor, select the lookup table, then click Edit Edit icon.
  2. To configure the ORACLE-BRT-PRIMAVERA_CONSTANTS lookup table:
    1. In the Name column, enter the name of the Oracle Primavera Cloud field you want to map.
    2. In the Value column, enter the name of the field in Jira to which the Oracle Primavera Cloud field has to be mapped.
  3. To configure the ORACLE-BRT-JIRA_PRIMAVERA_STATUS lookup table:
    1. In the JIRA_STATUS column, enter the status of the issue in Jira.
    2. In the PRIMAVERA_STATUS column, enter the status of the corresponding activity in Oracle Primavera Cloud.
  4. Click Save. If prompted, click Save again.
  5. To return to the Configuration Editor, click Back Back icon . Click Save again if prompted.

Configure the Integration Flow

Update the integration flow of the recipe with the ID of the custom field you created in Jira.

  1. Configure the Switch condition.
    1. On the Configuration Editor page, select the Oracle Jira Primavera Task Activity Sync integration.
    2. Click Edit Edit icon.
    3. On the integration canvas, select the first switch case (IF customfield_10064), and then click Edit.
    4. On the resulting page, select Expression Mode. In the Source section, search and select the ID of the custom field you created in Jira previously. See Configure Jira.
    5. Click the move button to add the custom field to the expression editor.
    6. Click Validate, and then Close.
  2. Update the data mapping.
    1. On the integration canvas, select Map to updateActivity, and then click Edit.
    2. In the data mapper, under Source section search for the ID of the custom field you created in Jira previously and map it to Activity Code within the Request Wrapper.
    3. Click Validate, and then Close.