Integrating BI Publisher and Discoverer

September 9th, 2007 by Mark Rittman

The other day I wrote about the first of the integration features between Oracle BI Suite Standard Edition and Enterprise Edition in my article “Integrating Oracle Answers and Oracle Portal”. Today, I’m going to take a look at integrating Oracle Discoverer and Oracle BI Publisher, where BI Publisher can use a Discoverer worksheet as a data source.

To get this feature up and running, you need the following releases of Oracle Application Server and Oracle BI Suite Enterprise Edition

  • Oracle Application Server 10.1.2.2.0
  • Oracle BI Suite Enterprise Edition 10.1.3.3

In addition, you’ll need a one-off patch, No. 5648158, which gets applied to your Discoverer mid-tier to install the Discoverer Web Service, which BI Publisher uses to get data from Discoverer worksheets.

Getting this all set up was quite tricky, as you’ve got to patch Discoverer to install the Web Service, but before that you need to make sure Application Server is patched up to 10.1.2.2.0, which if you’ve not done so already involves also upgrading the metadata repository database to 10.1.0.5. As well as that, you also need to integrate Discoverer with OID, which involves protecting the Discoverer Viewer and Plus URLs using SSO, and you also need to configure BI Publisher so that it uses the OID (LDAP) security model, something that’s not mentioned in the docs. Starting off with the original requirement to link BI Publisher and Discoverer, this all causes a domino effect of having to upgrade various bits of your BI infrastructure to bring them up the right levels, although of course if you’ve already patched up Application Server and Discoverer to the latest levels, turned on SSO and so on, you’re probably mostly there anyway. Where it did get particularly tricky for me was trying to get all of this running in a VM with 1.5GB of memory - I need to have two Application Server tiers up and running (infrastructure and mid-tier), 2 Oracle databases (the metadata database, and my regular Oracle database with the Discoverer EUL in it), an instance of Application Server 10.1.3.3 and Oracle BI Suite Enterprise Edition, and BI Publisher - I had to be very careful about what’s running at any one time, and all of it worked most of the time unless I tried to run the Application Server Enterprise Manager website, whereapon things mostly seized up.

Anyway, once it’s up and running, there are two ways in which you can use data from a Discoverer worksheet in a BI Publisher report. Firstly, you can use the BI Publisher Enterprise Web site to create a new report, then select “Oracle BI Discoverer” as the data source type, then pick a connection - these have to be public connections as BI Publisher logs in to the Web Service as a trusted OC4J user, but not an authenticated SSO user.

Once you select the connection, you then pick from the list of workbooks available from that connection

When the workbook and then worksheet is selected, you can then save this part of the report definition and go over to the BI Publisher Desktop interface.

Laying out the report template involves firstly connecting to the BI Publisher server using the BI Publisher menu within Microsoft Word, and then bring up the Open Template dialog to locate the report that you’ve just created using BI Publisher Enterprise. Using the dialog, you locate the report, and then double-click on the entry below the report to create a new template.

This then creates a new blank template, with a sample of the data from the Discoverer worksheet available to you to help lay out the tables, crosstabs, graphs and so on. Once the template is complete, you upload it back to BI Publisher Enterprise and you can run it along with all your other BI Publisher reports.

The other way you can create reports using Discoverer data, is to go straight in to the BI Publisher Desktop application, log in to the BI Publisher server and bring up the Open Template dialog. This time though, if you use the drop-down list to select DIscoverer from the available workspaces, like this:

you can then select a connection:

and then a workbook and worksheet:

Then, you are prompted to copy the data source definition into the BI Publisher workspace (catalog), which creates a .XDO report definition and allows you to proceed as if you’d created the report yourself using the BI Publisher web interface.

Now you can create the template as you normally would, using the data supplied by the Discoverer worksheet (which can be an OLAP worksheet, not just a relational Discoverer worksheet) in charts, tables, crosstabs and form letters.

That’s it for now, I’m off on a flight up to Glasgow to run some BI Suite Enterprise Edition training through a partner, then it back again and bags packed for my seminar tour around Melbourne, Sydney and Auckland. Exciting stuff indeed.

Comments

  1. Sunil Epari Says:

    I have a related question on integrating E Business Suite with OBIEE Administration Tool in an Fusion Intelligence environment. I have no problem launching the dashboards within the E Business Suite using this SESSION_COOKIE, but I am stuck with the Administration Tool. When I launch view data from the Physical Layer it says the Session variable NQ_SESSION.ICX_SESSION_COOKIE , has no value definition.
    Note: The Connection Pool EXECUTE ON CONNECT PROPERTY has a value: call /* valueof(NQ_SESSION.ACF) */ APP_SESSION.validate_icx_session(’valueof(NQ_SESSION.ICX_SESSION_COOKIE)’)

    Any help is greatly appreciated

    Sunil Epari

  2. Mark Rittman Says:

    Hi Sunil,

    Unfortunately I’ve not used OBIEE (or the Administrator tool) in the context of E-Business Suite, so I can’t comment on this one, sorry.

    regards, Mark

  3. Durgesh Says:

    I have a question on portal pages. I read your article Building BI Dashboard with Oracle Database 10g, Oracle discoverer, and Oracle Portal. It was very helpful for me in creating portal pages. Now I can create portal pages and can see these on my intranet but i am not able to get these pages on internet. Now my Quetion is how can i get these pages on internet?
    Any help is greatly appreciated
    Durgesh

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

    […] Standard Edition and Enterprise Edition tools will increasingly 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, […]

  5. M Wiley Says:

    I have been trying to get this working for a month now and you hit on the missing link I think in that setting up BI Publisher to use LDAP. Can you give me some specifics on how you did this? Even Oracle doesn’t know how to get this to work yet.

    Thanks

  6. Mark Rittman Says:

    M Wiley - I’m working on doing a blog post now, I need to get hold of the Discoverer patch though so I can walk through the complete installation again. In the meantime, the key things I had to do were

    1) upgrade OAS to 10.1.2.2.0
    2) Apply the Discoverer web services patch on top of the OAS mid-tier
    3) Bring Discoverer inside SSO
    4) create the account etc within OID that connects to Discoverer (see the docs)
    5) switch BIP over to LDAP security, connect it to the same OID instance that Disco is using

    it should work now - the key thing is switching the BIP security mode over to BIP, and make sure you connect to BIP afterwards using an OID user account, i.e. one that can also connect to Discoverer.

    I’ll try and do a blog posting on this soon

    regards

    Mark

  7. Rittman Mead Consulting » Detailed Configuration Steps for BI Publisher and Discoverer Integration Says:

    […] Comments APC on OOW 2007 Blogger Meetup : Thirsty Bear, Tuesday 13th Nov, 7pmMark Rittman on Integrating BI Publisher and DiscovererDimitri Gielis on OOW 2007 Blogger Meetup : Thirsty Bear, Tuesday 13th Nov, 7pmSheetalchandra K on […]