Establishing the Connection to Oracle EPM

A Connection object contains the parameters that make the communication between the Agent and the target system possible. These parameters (target system endpoint, login data and so on) are required to authenticate on and connect to the target cloud solution.

As an administrator user, you create the EPM Connection objects that provide the log in data required to establish the connection to the Oracle EPM system.

As a developer or object designer, you assign the respective Connection object to the Start EPM Job jobs to create and execute them on Oracle EPM without leaving the Automic Web Interface.

The Connection Object definition consists of an Agent-specific page and other pages that are common to all Connection objects.

This topic guides you through configuring the EPM Connection object.

This page includes the following:

Adding a Connection Object

  1. In the Automic Web Interface, go to the Process Assembly perspective. It opens to the Explorer view that contains the list of jobs that are available to you in your system.

  2. You have two options:

    • Right-click anywhere on the list and select Add > Add Object.

    • Click the Add Object button on the toolbar.

  3. On the Add Object dialog, start typing the name of the relevant integration in the Search field.

  4. Select the corresponding Connection object and click Add. The Object Name dialog is displayed.

  5. Enter a descriptive Name.

  6. Optionally, enter a short and descriptive Title that helps you recognize the purpose of the object.

  7. Click OK. A new page opens where you can start with the object definitions.

Oracle EPM Page

This page contains a Connection and a Proxy section.

Connection Section

  • Endpoint

    URL pointing to the application where the EPM services are running.

  • Authentication Type

    The Oracle EPM Agent Integration supports Basic and OAuth2 authentication. Select the relevant one:

    Basic:

    • Username

      Username used for the authentication.

    • Password

      Password for the user used for authentication.

    OAuth2:

    • Authentication Endpoint

      URL that clients call to request the authentication token.

    • Client ID

      Identifier as defined in your OAuth2 system.

    • Client Secret

      Encrypted secret value as defined in your OAuth2 system.

    • OAuth2

      The connection object supports OAuth2 v1.0 and v2.0.

    • Resource / Scope

      Range of applications that the token will grant access to. Define the Resource for OAuth2 v1.0 or the Scope for OAuth2 v2.0.

Proxy Section

If the Oracle EPM system is behind a proxy server, you define the parameters relevant for the connection to that system in this section.

  • Proxy Host Name

    Host name or IP address of the proxy server to which you want to connect.

  • Proxy Port

    Port used by the proxy server.

  • Proxy Username

    User name used to authenticate the proxy server.

  • Proxy Password

    Password of the user used to authenticate the proxy server.

Common Definition Pages

In addition to the Agent-specific connection parameters, you can also specify optional properties. You do so on the following definition pages:

Once the Connection object is configured, developers and object designers can select it when defining the Start EPM Job Jobs.

See also: