ORACLE CORPORATION

Integrating Oracle Business Intelligence Applications with Oracle E-Business Suite

Saurabh Gautam 6/9/2011

OracleOasis.1.ATG_PF.Version: 7.5 and later Business Intelligence Suite Enterprise Edition .Applies to: Business Intelligence Applications Consumer .delta. there are no pre-requisite patches required since base R12 has all the functionality that OBIEE leverages. dashboards. 1. namely the OBIEE profile is defined in b5869360.jsp and APP_SESSION package which are in base R12. For Oracle EBS R12. If you are on later RUP patchsets.5 and later Information in this document applies to any platform.Version: 11.9. they will also contain all required patches for integration. This document does not describe the mechanism to embed Oracle BI EE charts. These steps are detailed in this bulletin with an example of how to achieve this in the Oracle BI Applications.5 and later] Business Intelligence Reporting and Publishing Option .Version: 11.5 .ldt.1.5.3 and later Oracle Business Intelligence Applications Foundation .1. 1. . Required setup on Oracle E-Business Suite This section describes the necessary steps to achieve SSO integration and to embed links to the Oracle BI Interactive Dashboards and to Oracle BI Answers within Oracle E-Business Suite Applications.5473858 contains all required patches for integration.6. Purpose This document details the steps required to integrate Oracle BI Applications with Oracle E-Business Suite Applications in the following ways:    Single Sign-On first into Oracle E-Business Suite and have that authentication passed through to Oracle BI EE Embed links to Oracle BI EE dashboard/catalog in Oracle E-Business Suite pages Create Action Links within Oracle BI EE reports and dashboards that take you back into Oracle E-Business Suite in context Setup is required both on the E-Business Suite Application and Oracle BI EE sides to perform this integration.ATG_PF.1.H.1.delta.Version: 11.5) 11i. Required patch for Oracle BI EE integration The following patch is a pre-requisite on the Oracle E-Business Suite Applications 11i instance for this functionality to work: · patchset 5473858 (which is 11i.H. or reports in the E-Business Suite application.8 and later [Release: 11.

Then.1. . log in to Oracle E-Business Suite as the system administrator (for example. From the Application menu. select Function. select the System Administrator responsibility from the responsibility navigator pane on the left. The available menus appear on the right. in sequence:      Function Menu Responsibility User Profile Creating the function 1.1. sysadmin).2. 1.2. Before you begin. you need to create a form function and then assign menus and responsibilities. Follow the steps in this section to create the following objects. The Form Functions dialog appears. Embedding Links to Oracle Business Intelligence in Oracle E-Business Suite To embed a link in Oracle E-Business Suite that opens Oracle Business Intelligence dashboards.

Creating the Menu 1. The Menus dialog appears. 4. Save your changes using the Save button on the toolbar 1. 7. 6. From the Application menu.2. select Menu.2.2. 2. 3. enter OracleOasis. Enter the name of the Menu Enter a User Menu Name For Function. 4.jsp?mode=OBIEE&function=Answers b. Enter the name of the function in the Function Field Enter the User Function Name Enter a description Save your changes using the Save button on the toolbar Select the Properties tab Specify the Type as SSWA jsp function 8. enter OracleOasis. enter the name of the function(s) created in the previous section . Select the Web HTML tab 9. enter one of the following options: a. To link to answers. 3. 5. For the HTML Call.jsp?mode=OBIEE&function=Dashboard 10. To link to dashboards.

enter Standard for Name and re-enter the application name for Application . Save you changes using the Save button on the toolbar. and then close the Menus dialog. 6. 4. Below steps shows how to create a new responsibility: 1. From the Security Menu. Click on Responsibility and select Define Enter the name of the responsibility Select the application for which the responsibility is being created Specify a unique Responsibility Key For Available Form. 5.5.2. Assigning Menu to Responsibility You can create a new responsibility or an existing responsibility can be used. 1.3. Select Oracle Self Service Web Applications For Data Group. 2. 3.

enter the name of the menu you created in the previous section 8.4. Below steps shows how to create a new user: 1. From the Security Menu. and then close the responsibilities dialog. Save you changes using the Save button on the toolbar.7. For Menu. Enter the name of the user . Click on User and then Select Define 2.2. 1. Assigning Responsibility to User You can create a new user or an existing responsibility can be used.

4. Save you changes using the Save button on the toolbar. 1. Setting up a Profile 1.5.3. From the Applications menu. Click on Profile and then select System Profile 2. Specify the responsibilities that this user will have access to. and then close the Users dialog. Select Responsibility and then enter the name of the responsibility which you created earlier .2.

On the resulting screen. enter the Web server port where Oracle Business Intelligence is running (for example.domain. For example: http://my_server.com:port For port. Click Find 5. 9704). Note: The BI Url should be the fully qualified hostname including the domain name. It shouldn’t be an . specify the Oracle Business Intelligence URL.3. Enter %Business Intelligence% in the Profile field 4.

open the rpd 2. Save you changes using the save button on the toolbar 2. In the Oracle BI Administration tool. Select the Oracle EBS OLTP Initblocks Connection Pool . RPD Changes 2. Setting up Connection Pool for Oracle e-Business Suite database 1.1.IP Address 6.

If it exists. then Session and then Initialization Block 5. On the Connection Scripts tab. Select Manage and then Variables 3.2.RESP_APPL_ID. FND_GLOBAL. From the Action menu. Check whether the Initialization Block EBS Security Context exists or not. Enter the name of the initialization block 6. For default Initalization string enter the following: SELECT FND_GLOBAL. select new and then select New. FND_GLOBAL. Open the rpd 2.RESP_ID. .validate_icx_session(‘valueof(NQ_SESSION.ACF) */ APP_SESSION. please skip steps 4 and 5 below and verify that the settings for this initialization block is similar to as mentioned below(Steps 6-12) 4.SECURITY_GROUP_ID.3. the value of Execute on Connect property should be: call /* valueof(NQ_SESSION. Setting up Authentication 1. If not. please follow steps 4-12 mentioned below.ICX_SESSION_COOKIE)’) 2.

USER_ID. FND_GLOBAL. FND_GLOBAL. Select Required for authentication checkbox. Click Browse and select the Oracle EBS OLTP Initblocks Connection Pool 8. FND_GLOBAL. Click Edit Data Target 10. Create the following session variables: EBS_RESP_ID EBS_RESP_APPL_ID EBS_SEC_GROUP_ID EBS_RESP_NAME EBS_USER_ID EBS_EMPLOYEE_ID USER 11. For Connection Pool. Click ok 12.USER_NAME FROM DUAL 7.EMPLOYEE_ID. .RESP_NAME. Clock Ok 9.FND_GLOBAL.

xml for editing. Click on ok. For example: <RequestVariable source="cookie" type="auth" nameInSource="VIS" biVariableName="NQ_SESSION. Open the file authenticationschemas.ICX_SESSION_COOKIE" /> . This file can be found at: ORACLE_HOME/bifoundation/web/display 2.1. Locate the sub-element RequestVariable source="cookie" and change the value of the nameInSource attribute from ICX_SESSION to the name of the EBS ICX authentication cookie prefix.13.xml 1. OBIEE Configuration Changes 3. 3. Find the following element in the file: <AuthenticationSchema name="EBS-ICX" 3. Updating authenticationschemas.

5. the EBS ICX authentication cookie is VIS=ZcEJeoLNVqcHGiGYvCpzTx3N:S.cookie) The cookie is displayed. . You can find this file at: ORACLE_INSTANCE/config/OracleBIPresentationServicesComponent/coreapplication_obipsn 2.ADMINCONSOLESESSION=0yQmLP2D67vJKgtXLxsNl534QTWlThYkyvXfR0fjFK0LPsD3Hh83 !1322564050 The value you need to provide in authenticationschemas. Enter the following text in the address bar of your browser: javascript:alert(document.xml is the prefix of the EBS ICX authentication cookie. In the previous example. follow these steps to find the cookie name: Log in to Oracle E-Business Suite.ORA_UCM_SRVC=3*OTN~1~0~//~null~*OPN~1~0~//~SE1%3ASE1%3ASE1%3ASE1%3ASE1%3ASE1%3ASE1%3ASE1%3A~* EMP~1~0~/34/~null~*GMO~1~0~//~null. Save and close the file. 4. Updating instanceconfig. and the prefix is VIS. In the same entry (RequestVariable source="cookie"). For example: ORA_BIPS_LBINFO=1262d6a5f9a. ORA_UCM_ INFO=3~00027147766664614052270216870092~Taylor~Michael~mike. ORA_UCM_VER=%2FMP%2F8kgic%2Cr_ wjmp%3Emp_ajc%2CamkMP%2F8iega*p%5Duhkn%3Ckn%5D_ha*_kiMP%2F8%2F26%2C65%2C7%2C22MP%2F804*43*5*00.Impersonate-soap.Impersonate. Include EBS-ICX in the list of enabled schemas.2. EBS-ICX must be manually added to the EnabledSchemas element. Find the following element: <SchemaKeyVariable source="cookie" Change the value of the nameInSource attribute from ICX_SESSION to the name of the EBS ICX authentication cookie prefix (often VIS). Save and close the file.VIS=ZcEJeoLNVqcHGiGYvCpzTx3N:S. 3. For example: <EnabledSchemas>UidPwd. 3.xml for editing..tay lor@oracle. Locate the Authentication element. Ignore the comment in instanceconfig.UidPwd-soap. ORA_MOS_LOCALE=en%7CUS.Note: Ask your Oracle E-Business Suite administrator for the name of the EBS ICX authentication cookie if you do not know it. Alternatively.xml 1. ensure that the value of the biVariableName attribute is the same as the value you entered as part of the connection script when you created the connection pool for the Oracle E-Business Suite database. 5. Open the file instanceconfig.xml that says this setting is centrally managed.com~USA~en~~~~~1. For example: <SchemaKeyVariable source="cookie" nameInSource="VIS" forceValue="EBS-ICX"/> 6. ORA_TAHITI_PREFS=-0-------------.EBS-ICX</EnabledSchemas> 4.

The file can be found at: <Oracle Middleware Home>\user_projects\domains\bifoundation_domain\config\fmwconfig\biinstances\coreapplication 2. Passing Context to EBS Forms 1. Log into OBIEE b. Save and close the file 4. Edit the ActionFrameworkConfig file to include the following element: <ebusinesssuiteconfig><visible>true</visible></ebusinesssuiteconfig> 3. a.6.2.1. Identify the parameters required by the Form/Page. Open the ActionFrameworkConfig.1.1. Configure Oracle BI EE Action Framework: 1. 4. Please refer to e-Business Suite Documentation for details. 2. Action Links to EBS Forms 4. Identify the e-Business Suite Form that is to be linked to.xml. Click on New -> Action . Restart Oracle Business Intelligence. Create a new Action which will enable OBIEE to call the e-Business Suite Target form.

Specify the connection pool (mentioned under section rpd changes ). . FunctionCode and Connection pool need to be specified. In the Resultant Screen. Specify the function code of the target form which need to be launched.c. Also. For FunctionCode. create new parameters which has the same name as the identified parameter (Identified in Step 1) and specify a value. In addition to these two mandatory parameters. two mandatory parameters. Select ‘Navigate to e-Business Suite’ d. In the resultant screen.

Save the Action f. e.For better user experience. Mark the FunctionCode and ConnectionPool parameters as Hidden. Navigate to location where the Action is saved and Click on Execute to test the Action .

Click on Interaction tab 6. Refer to Oracle Business Intelligence Enterprise Edition documentation. Login into OBIEE 2. how to use Action Links in Analysis/Dashboard. Select a Subject Area and then select a column on which the Action Link is to be set as an Interaction 4. Select Primary Interaction as Action Link under Value 7. The Action Link created above can be used in Analysis/Dashboards. Navigate to Column Properties 5. Navigate to New->Analysis 3. Steps below provides a simple example on how to use Action Link in Analysis: 1. f. Click on + icon and Specify the Action Link (which was created in earlier step). For details.Clicking on Execute should launch e-Business Suite Form. .

Click on ok. Specify parameters if a dialog box for parameters is prompted. Login to e-Business Suite. 11. Save the Analysis 10.8. 12. Check the Hidden Checkbox. 9. Set the value to be based on Column. Click on the OBIEE Answers link to navigate to OBIEE Open the newly created Analysis Click on the column value to navigate back to e-Business Suite. .

Sign up to vote on this title
UsefulNot useful