Configure the Delivered Connections

This recipe delivers two connections:

  • Aconex Connection - uses the standard REST Adapter to make calls to the Aconex REST API.
  • Unifier Connection - uses the standard REST Adapter to make calls to the Primavera Unifier REST API.

Configure the Aconex Connection

To configure the Aconex Connection connection:

  1. In the Connections section, click Actions Actions icon on the connection, then select Edit.
  2. In the Properties section, do the following:
    1. In the Connection type field, 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

  3. In the Security section, do the following:
    1. In the Security policy field, 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.
  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. To return to the project workspace, click Go back Back icon.

Configure the Unifier Connection

To configure the Unifier Connection connection:

  1. In the Connections section, click Actions Actions icon on the connection, then select Edit.
  2. In the Properties section, do the following:
    1. In the Connection type field, select REST API Base URL.
    2. In the Connection URL field, enter the URL of your Primavera Unifier instance, including your region (if applicable), the host server, and your specific company code.

      For example: https://<region>.unifier.oraclecloud.com/<companycode>

      If there is no region, the base connection URL is:

      https://unifier.oraclecloud.com/<companycode>

  3. In the Security section, do the following:
    1. In the Security policy field, select OAuth Custom Two Legged Flow.
    2. In the Access Token Request field, enter the access token request in the following format:
      -X GET "https://<SERVER_URL>/ws/rest/service/v2/auth/token" \
  -H "Authorization: Basic <Base64-encoded-username-and-password>" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials"

      Where:

      • <SERVER_URL> is the base URL of your Primavera Unifier instance, including your region (if applicable), host server, and your specific company code (for example: <region>.unifier.oraclecloud.com/<companycode>).

      • <Base64-encoded-username-and-password> is the encoded username and password value of your Primavera Unifier integration user. See Prepare Base64-Encoded Credentials.

  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. To return to the project workspace, click Go back Back icon.