3 Install and Configure the Recipe

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

1. On the Oracle Integration Home page, in the Get Started section, click Browse store.
2. Search for this recipe:
   Aconex — Unifier | Sync Issues
3. After you find the recipe, click Get on the recipe card.

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

4. Click Configure on the recipe to configure its resources.

The project workspace opens, displaying all the resources of the recipe.

Now that the recipe is installed, you must configure the following resources before you can run the integrations in this recipe:

1. Configure the Aconex Connection.
2. Configure the Unifier Connection.
3. Update the Sync Aconex Issues with Unifier Integration Properties.
4. Update the Sync Unifier Issues with Aconex Integration Properties.

Configure the Aconex Connection

1. In the Connections section of the project workspace, find the connection named Aconex Connection.
2. Click Actions next to the connection and select Edit.
3. In the Properties section, do the following:
   1. From the Connection Type list, select REST API Base URL.
   2. In the Connection URL field, enter the base URL of your Aconex API.

      For example:

      https://<region>.aconex.com/field-management/api

4. In the Security section, do the following:
   1. From the Security policy list, select Basic Authentication.
   2. In the User name field, enter the user name of the integration account.
   3. In the Password field, enter the password of the integration account.
5. Click Save. If prompted, click Save again.
6. 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.

7. To return to the project workspace, click Go back .

Configure the Unifier Connection

1. In the Connections section of the project workspace, find the connection named Unifier Connection.
2. Click Actions next to the connection and select Edit.
3. In the Properties section, do the following:
   1. From the Connection Type list, select REST API Base URL.
   2. In the Connection URL field, enter the endpoint URL.
4. In the Security section, do the following:
   1. From the Security policy list, select OAuth Custom Two Legged Flow.
   2. In the Access Token Request field, specify the request using cURL syntax to fetch the access token.
   3. Expand Optional security, then in the access_token_usage field, specify how the access token should be passed to access the endpoint.
5. Click Save. If prompted, click Save again.
6. 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.

7. To return to the project workspace, click Go back .

Update the Sync Aconex Issues with Unifier Integration Properties

In order for the Sync Aconex Issues with Unifier integration to be able to synchronize issues, you must activate the integration and then define the following integration property values.

1. In the Integrations section of the project workspace, find the Sync Aconex Issues with Unifier integration.
2. Activate the integration.
   1. Click Actions next to the integration, then select Activate.
   2. In the Activate integration panel, select the appropriate tracing level, then click Activate.
3. Update the integration property values.
   1. Click Actions next to the integration, then select Update property values.
   2. In the Update property values panel, do the following:
      1. Click to expand the API_Key property, then in the New value field, enter the ID to identify the client making the request. This is also known as the Integration ID and only needs to be filled in once.
      2. Click to expand the Email_Id property, then in the New value field, enter the email address of the user who will receive the notifications if the integration fails to run successfully.
      3. Click to expand the Aconex_Project_Id property, then in the New value field, enter the Aconex project number whose issues you want to synchronize.
      4. Click to expand the Unifier_Project_Number property, then in the New value field, enter the Unifier project number with which you want to synchronize the issues.
      5. Click to expand the Issue_Type property, then in the New value field, enter the issue type name.
      6. Click to expand the Aconex_Area_Id property, then in the New value field, enter the ID of the area where the Aconex issue is located.
   3. Click Submit.

Update the Sync Unifier Issues with Aconex Integration Properties

In order for the Sync Unifier Issues with Aconex integration to be able to synchronize issues, you must activate the integration and then define the following integration property values.

1. In the Integrations section of the project workspace, find the Sync Unifier Issues with Aconex integration.
2. Activate the integration.
   1. Click Actions next to the integration, then select Activate.
   2. In the Activate integration panel, select the appropriate tracing level, then click Activate.
3. Update the integration properties.
   1. Click Actions next to the integration, then select Update property values.
   2. In the Update property values panel, do the following:
      1. Click to expand the API_Key property, then in the New value field, enter the ID to identify the client making the request. This is also known as the Integration ID and only needs to be filled in once.
      2. Click to expand the Aconex_Project_Id property, then in the New value field, enter the Aconex project number.
      3. Click to expand the Unifier_Project_Number property, then in the New value field, enter the Unifier project number.
      4. Click to expand the Aconex_Area_Id property, then in the New value field, enter the ID of the area where the Aconex issue is located.
      5. Click to expand the EmailAddress property, then in the New value field, enter the email address of the user who will receive the notifications if the integration fails to run successfully.
   3. Click Submit.