Configure the Primavera Unifier Connections

This accelerator delivers two connections that are required for connecting with Primavera Unifier through Oracle Integration:

  • Unifier basic - used to resolve tenancy metadata in multi-tenant deployments.
  • Unifier token - used to call Primavera Unifier REST APIs for data synchronization.

Note:

Both connections use the standard REST Adapter to make API requests.

Unifier basic 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 Basic Authentication.
    2. In the Username and Password fields, enter the login credentials of your Primavera Unifier integration user.
  4. Click Test to ensure that your connection is successfully configured.
    A message confirms if your test is successful.
  5. Click Save. If prompted, click Save again.
  6. To return to the project workspace, click Go back Back icon.

Unifier token 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. In the Optional security section, enter values for these fields in the following format:
    • $access_token = access_token
    • $expiry = expires_in
    • $access_token_usage (required) = -H Authorization: Bearer ${access_token}

    Note:

    If Primavera Unifier requires tenant headers in multi-tenant environments, the accelerator handles them automatically.
  5. Click Test to ensure that your connection is successfully configured.
    A message confirms if your test is successful.
  6. Click Save. If prompted, click Save again.
  7. To return to the project workspace, click Go back Back icon.