Integrating Oracle BI Answers and Oracle Portal

September 7th, 2007 by Mark Rittman

One bit of feedback I received after running my last BI seminar, was that people were interested in interoperability between the new BIEE tools and the Standard Edition tools they were currently using. Whilst most people were keen to hear about what’s new, the reality is that they need to take gradual steps and a “big bang” approach, migrating everything at once often isn’t realistic. If there’s a way to get the old and new tools working together, at least for the time being, that’d be a useful situation.

With the current line up of Oracle’s BI tools - OBE 10.1.3.3 and Oracle BI SE 10.1.2.2 - there are in fact two main areas in which the tools can interoperate:

  • Discoverer worksheets can be a data source for BI Publisher, and
  • Oracle Answers reports can be displayed in Oracle Portal

Strictly speaking, Portal integration has been available since back in the days of Siebel Analytics, but now all the products are in the same fold the documentation is easy to get hold of and OBIEE 10.1.3.2 and 10.1.3.3 ships with portlet provider that plugs straight in to Oracle Portal, using the JSR-168 WSRP standard.

The way it works is that Answers views, the graphs, tables, pivot tables and so on that are built against data in the BI Server repository, can be rendered through Oracle Portal with all the interactivity, presentation and so on that you get in Interactive Dashboards. There’s a few prerequisities and a bit of configuration to go through, but once it’s all up and running it’s easy to bring Answers content into Portal, arguably easier than Discoverer worksheets when you think about all the work involved in refreshing content, managing connections and so on.

Setting up Answers and Portal integration consists of the following steps:

  • First of all, you need to install Oracle Application Server 10.1.2 (docs, software) and upgrade Portal to 10.1.4 (upgrade docs, software
  • Next, download the Oracle Portlet Container from OTN, which is needed in order to deploy JSR-168 portlets in Oracle Portal 10.1.4
  • Once you’ve upgraded Portal and download the Portlet Container, create a new OC4J container to hold your WSRP portlets, and then follow in the instructions in the Portlet Container download to copy across a JAR file and use Application Server Control to deploy it in the new WSRP OC4J container.
  • Now that Portal’s configured, you go across to the Oracle BIEE 10.1.3.2 or 10.1.3.3 installation and get hold of a file called “sawjsr168portlets.war” in the /OracleBI/web/sdk directory, which then needs to be unpacked and a file called “portlet.xml” extracted, which you then edit to provide the credentials for the BI Presentation Server. Once you’re repacked the .war file, you then upload it to the WSRP container and deploy as an application.
  • The final configuration step is then to register the OBIEE WSRP details with Portal as a remote provider, once you’ve done that you can start adding OBIEE portlets into your Portal page.

Starting with a blank Portal page, adding an Answers portlet involves creating a region and then pressing the “Add Item” button in the Edit Page view, then browsing the Portlet repository to find the Answers provider, which I’ve called “Analytics” in this example:

After adding the Oracle Business Intelligence Report View Portlet, the portlet is initially in an unconfigured state, and you need to add the path to the view and the view type:

The portlet provides two text fields for providing these parameters:

This is where it’s slightly tricky. As this is a fairly early example of integration, there’s no “report picker” or similar dialog to help you select a report, you have to go back to the Catalog Manager is OBIEE to find the report, and more importantly it’s catalog path, to key into the first text box.

Going back to Answers, I find the report I want within the Course folder within Paint Demo and Shared Folders, and translating the physical path address below it, I come back with the view address “/shared/Paint Demo/Course/Units and Sales By Brand”.

I key this into the two portal configuration fields, like this:

Now, I can save the portal details and take a look at how it looks.

And there we go - a full Answers view, but displayed within Portal. As far as I’m aware, you can pass parameters to it, it can pick up on who the logged in Portal user is and thereafter scope the data, you can even drill, download to Excel and so on. Not bad.

I’m currently working on the Discoverer and BI Publisher integration stuff - this is a bit trickier, as it seems that Discoverer, BI Publisher and OBIEE all need to be within Oracle Single Sign-On (assuming BIP and BIEE are running integrated) to get it working - Disco must be linked in to OID for the Public Connections the Disco Web Service uses, which has a cascade effect on BI Publisher and OBIEE which also need to be within SSO to be able to talk to Disco. I’m working through it now and hopefully I’ll update the blog on how I get on over the weekend. For now though, the Portal integration works just nicely, once you get Portal working with WSRP portlets its pretty much plain sailing after that.

Comments

  1. Rittman Mead Consulting » Integrating BI Publisher and Discoverer Says:

    […] Integrating Oracle BI Answers and Oracle Portal […]

  2. dave Says:

    I’m getting this error when trying the above steps.

    Required parameter is missing: name

    Any ideas where this is coming from? I believe it’s a fresh install of Oracle BI with the latest WAR file.

  3. Rajiv Says:

    I followed your instructions, but no luck. I am stuck at step 4. I modify portel.xml from sawjsr168portlets.war and then deploy to WSRP. But after that when I call it like http://test-cm.mycompany.com/OBIEE/sawbridge I am getting this error - java.lang.IllegalArgumentException followed by bunch of lines.

    Not sure what’s going on… can you please help. Do you have any other document(step by step)

  4. Mark Rittman Says:

    Dave, Rajiv

    I haven’t encountered the issues you’ve mentioned in your comments, but the two areas where I had the most trouble were in editing the portlet.xml file - I didn’t add the username, password and URL elements properly, my end element tags were like this rather than this - , and getting the provider to register properly. It was a very fiddly task in the end, my best advice would be to run through the Oracle docs properly and re-check everything, it does work in the end but it’s a bit tricky to set up.

  5. dave Says:

    Mark,
    Thanks for the reply. Do you mind posting your portlet.xml (with dummy data if protected information is provided)? I think I’m setting up everything correctly, but wouldn’t mind cross-checking it against yours. When you added items to the portlet.xml, what do you mean ‘properly’? I’m just providing the details as I know them. Is there anything special required?

    Thanks.

  6. Andrew Says:

    Hello,

    I’ve done the steps and when I try and look at a report, the report itself doesn’t show. The searching icon has a broken JPEG icon, and it never seems to find the report. Oddly enough, the PDF, Excel, download, etc. options do appear, just not the data. Any thoughts?

    Thanks

  7. Rittman Mead Consulting » Five Oracle BI Trends for the Future Says:

    […] interoperate. Already, BI Publisher can use Discoverer worksheets as a data source, and Answers reports can be embedded in an Oracle Portal page. Going into the 11g timeframe, Discoverer reports will be able to be scheduled using Delivers, with […]

  8. Ntaly Says:

    Hello!
    I have
    oas 10.1.2.0.2 portal 10.1.4
    Oracle BI 10.1.3.2
    1./OracleBI/web/sdk/sawjsr168portlets.war
    edit portlet.xml:
    oracle.bi.presentation.sawserver.URL
    http://localhost/analytics/saw.dll
    2. deploy sawjsr168portlets.war.
    but
    I have
    SAWBridgeServlet Status Not Loaded com.siebel.analytics.web.integration.SAWHTTPBridge
    Why?
    Thank, Nataly.

  9. Alf Says:

    Hi!
    when i tried to put a portlet in a portal page it sends a message of wrong username or password i guess that it is in portlet.xml, can you send to me an example of this file?
    tx in advance!

  10. SEBSSI Says:

    HI

    Hello!
    I have the same problem as Nataly
    SAWBridgeServlet Status Not Loaded
    and also when i try to register the portlet with this url : http://localhost:7778/sawjsr168/portlets?WSDL

    i get 404 response

    Thanks in advance

  11. Tina Says:

    Acutally you have to add the account of the portal to biee without a SSO env.
    Null password will also call some problem.

  12. Gayathri Says:

    Hi
    I am seeing same behavior as Andrew after following these steps.when I try and look at a report, the report itself doesn’t show. The searching icon has a broken JPEG icon, and it never seems to find the report. But the PDF, Excel, download, etc. options do appear, just not the data. Any thoughts?