Share

Product Update Highlights: 180 Degree Integration Using Oracle EPM Integration Agent

This blog contains guide for using Oracle EPM Integration Agent for inbound as well as for outbound integration with Oracle EPM Cloud.

EPM Integration Agent Background

We can directly extract, load, and transform metadata and data from a wide variety of on-premises and third party cloud source systems for use in Oracle EPM Cloud. The agent, implemented as a data source for Data Management and Data Integration, responds and provides the specified information when a user executes data load rules.

The EPM Integration Agent provides connectivity between the EPM Cloud and on-premises sources including SQL data sources like –

  1. Oracle and Microsoft SQL Server
  2. E-Business Suite GL
  3. PeopleSoft GL

Agent can run in two different modes:-

  • Asynchronous                
  • Synchronous

The mode determines how communication is opened between your on-premises data source and the EPM Cloud.

 

Asynchronous Mode:

When integration is executed in asynchronous mode, the EPM Cloud queues for the integration job to execute. The agent polls at intervals and executes the jobs queued.

 

Synchronous Mode:

In synchronous mode EPM Cloud directly calls the agent. This requires EPM Cloud to connect over http(s) to the agent.

 

EPM Integration Agent Configuration:

The agent requires a Java Runtime Environment (JRE) 8+ to run. JRE 1.8 update 221 needs to be downloaded and installed.

Type in search CMD>> Type java -version

Login PBCS > Navigate > Data Exchange and go to Action > Download Agent

Download EPM Integrator Agent

Once downloaded, extract the zip file

EPM Integration Agent Zip File

EPM Integration Agent Zip File 2 EPM Integration Agent Zip File 3

Type command prompt in search > Run as administrator

In “bin” directory folder the following is the .bat file, which is used for configuring and running the EPM Agent

createAppFolder.bat

createAppFolder.bat – Use for creation of app folder where one registers the application to connect to Source on-premise to Target application

encryptpassword.bat – Use for encrypting password use for connection with PBCS/EPBCS URL

epmagent.bat – Use for running EPM Agent

stopagent.bat – Use for stopping EPM Agent

Next is to open Command Prompt and traverse to bin directory

Type createAppfolder.bat and press ENTER

It will create below four folders (config, data, logs, scripts)

EPM Integration Agent Script

config Folder contains an initialization file agentparams.ini where in the parameters to connect to PBCS/EPBCS are set up. So traverse to config folder and open the agentparams.ini file.

agentparams.ini

File will be open in below format - Which we will open populate along with steps

Agentparams

EPM_AGENT_HOME: Path where EPM Agent folder is located

EPM_APP_DATA_HOME: Path where Application is created i.e. appdata

AGENT_NAME: It’s the parameter name which appears in Data Exchange when connected (Explain in further process), any name can be used

CLUSTER: It is the Cluster name that is created in the Data Exchange in PBCS/EPBCS application

PORT: always 9090

CLOUD_URL: URL of PBCS/EPBCS (this should be till oracle.com)

CLOUD_DOMAIN: Domain of your cloud application

CLOUD_USER_NAME: Username

CLOUD_PASSWORD: Encrypted password which is covered in further process

POLL_INTERVAL: It is in seconds and only used for Asynchronous Mode

For setting up parameters one has to create cluster in PBCS/EPBCS, clusters provide a way of organizing integrations. Clusters are created in Data Management and can either be defined to operate in synchronous or asynchronous modes.

To create a cluster, go to Data Exchange > Action > Agent > Create New

Agent Cluster

We need to encrypt the password with “encryptpassword” script in the agent bin directory.

Go to the “bin” folder

EPM Integrator Agent Bin Folder

Open Command prompt type encryptpassword.bat > type password and press enter

The encrypted password must be manually copied to the ini file.

** Example of a completed ini file**

ini file

The EPM Cloud SSL certificate needs to be exported and copied to the agent cert folder.

  1. Click the padlock icon
  2. Select Site settings
  3. Certificate
  4. Details tab and select Copy to File
  5. Save the file to the agent “cert folder”

Cert Folder

Agent is now ready to run in asynchronous mode.

Open the command prompt and traverse to EPM Agent bin folder

EPM Agent

Go back to the Data Integration and select the cluster. You will now see the agent has been registered successfully

EPMAsync

Loading Data using EPM Integration Agent:

Before be begin the data load, we need to test the connection with the source database.

Open SQL Developer and connect with the Database

Oracle SQL Dev

We want to connect to Employee Details View

Employee Details View

Create an SQL query in Data Integration that will be executed by the agent to extract the data.

Go to Data Integration > Actions > Query

Data Integration Query

  1. Add a new query
  2. Enter a new name for the query and the SQL statement and save

Create Query

We have ~COUNTRYID~ in the SQL statement. This allows you to filter the data to be extracted. It is possible to set the value either at the data load rule level or at the application level.

Query Name Details

The next step is to create a comma separated file with a line containing all the possible columns that one needs to load the data for in Application

CSV

*Note* - The name of the file will become the name of the target application in Data Management and save the file in app data

Data Management

Now it’s time to create a Data Source.

Go to Data Management

Data Source

Target Application > Add > Data Source

Target Application Summary

Select on Premise Database OR Cloud

Source System On-Premises Database

Upload the file with the column names and select it and click Save

EPM Details Demo

The file name has been converted into the application name.

Application Details Job Title

Go to Application filter tab that provides options to configure the connection to the source database

Data Extract Query

Choose Delimiter

Choose Delimiter

Choose Credential Store – Cloud or file

JDBC driver

JDBC

JDBC URL

jdbc:oracle:thin:@dbhost:port/service

For this Case we are using jdbc:oracle:thin:@localhost:1521/DEV

JDBC URL

Username/Password are for the user you want to connect to the database

Application Filters

Click Edit to add Variable that is used in the SQL query “COUNTRYID

Application Filters Country ID

Note: The Name Country ID should be an exact match with what has been mentioned in the SQL Query

Give Filter Name, Display Prompt, Display order, and Display level and click OK

Edit Application Details

Create Import Format in Data Management

Create Import Format

Follow the normal integration procedure for creating Location and Data Load Rule. In the Data Load Rule one can see the filter for Country ID. Enter the filter as desired.

Data Load File

Click Save, and click Execute

Execute

After the execution of the rule, we can see file is processing in the Process details and also in command Prompt “Polling”

Workflow Process Details

Make Poll Data

Once the process is completed, Data Load Workbench to see the loaded data

Workflow Import

We can check the .dat file in EPM Agent under

C:\Oracle\EPMAgent\appdata[application-name]\data

 

Data Write Back using EPM Integration Agent:

Consider “ACTUALS” database as target where the adjusted data is to be written back.

The table structure is as below

Actuals Data Table

Currently data is loaded for Cash and hence the Data Source: Load

Data Source Load

The following adjustment data needs to be written from an Oracle EPM Cloud Application back into the ACTUALS database

ACTUALS Database

The first step is to register the On-premises Database in Data Management.

Create file with Headers of the Target Database i.e. ACTUALS

Note: Mentioned the exact columns which are present in the Database

EPM WB Actuals

Registering the Database in the Data Management.

For that traverse to Data Management in EPM Application by clicking Navigator->Data Management->Setup-> Target Application

Target Application Summary 2

Select Add and click on Local

Local

Select Type as “Data Source to On Premise Database” and upload the file created in the step above

Select Application

Select a File to Upload

Select the uploaded file, click save and change the Amount Target Dimension Class to “Amount” and clear the Data Table Column Name

Repeat the step for Period, Year and Scenario dimension

Target Application Details Account

Mention the credentials and Table Name in Application Options tab as shown below

Note: Workflow mode should be set to “Full”

Table Name Actuals

Now follow the normal process for creating Location and Import format.

Import format

Import Format

Location

Location

Create Data Load Rule with needed filters

Create Data Load Rule

Execute the Data Load rule

Execute Data Load

Check the progress via the Process Details and Command Prompt

One can check the .dat file in EPM Agent under

C:\Oracle\EPMAgent\appdata[application-name]\data and validate the whether the data is push to “ACTUALS” Database

Welcome Page Actuals

Become a member

Newsletter

Receive our newsletter to stay on top of the latest posts.