Connector BusinessObjects

Last modified by Aurelie Bertrand on 2023/05/11 10:24

Prerequisites

  • Follow instructions for deploying ddbobridge on Business Objects’ server (C.f. tutorial called “boconnector_technical_en.pdf”).
  • A BO server and access identifiers (cf. below)
  • A report ID (not mandatory)

Selection of the datasource

DigDash Enterprise allows you to retrieve information from your BusinessObjects' server.

Select the type of report you want to work with, in the toolbar at the bottom of the page.

bo_connector_en_html_1074d530141bae54.gif

bo_connector_en_html_96dfda34a50fc7f9.png
 

OR click on New model in the datasource manager tab and choose BusinessObjects Report.

bo_connector_en_html_339522b845b92050.png
 

bo_connector_en_html_6e5a78fd137b6cfb.png
 

Authentication

For a first-time BO connection via Digdash, the following authentication fields are required (first in Manual connection mode ; change into Named connection mode to save the fields) :

bo_connector_en_html_64b99fc266a46b73.png

Screenshot: authentication fields to connect to BO via Digdash in Manual mode

  • BO server URL : it is the BO application server (Tomcat) followed by the port number :

    http://{IP address of the BO application server}:{Tomcat’s port number}

    Example : http://boAppServer:8080

  • CMS name (or System) : it is the BO engine server followed by the port number :

    {IP address of the BO engine}:{CMS’ port number}

    Exemple : boEngServer:6400

  • Authentication type : the type is « Enterprise » most of the time
  • User
  • Password

You can check if the connection is established with the button « Test connection ».

Warning: if you deal with a secured connection (https), please refer to the end of this document to know how to proceed (Cf Part VIII “Importing the certificate for a secured connection”).

Getting a BusinessObjects report

Enter in the text field the ID of the report you want to charge as a DataSource and its type.

If the ID is valid, clicking the “Reload” button will automatically update the UI (User Interface) with data related to the chosen report.

bo_connector_en_html_d3f66d87ea5da7ea.png

Screenshot: entering the report ID the user wants to retrieve and choosing the report type

bo_connector_en_html_737f7932ce2722fe.png

Screenshot: updating the text field with information related to the selected BO report

Getting a specific BusinessObjects report instance

A dropdown list is available to give you the possibility to choose a specific instance for a given report.

Here are the available choices for picking an instance:

  • Report: it is the original document (without any update via a scheduler)
  • Last successful: it is the last successful report instance after the last schedule
  • Last: it is the last successful or not report instance after the last schedule
  • Penultimate: it is the penultimate report instance.

bo_connector_en_html_9d67f10804322beb.png

Screenshot: dropdown list displaying the options for picking a specific report instance

By default, it is the report instance that is chosen.

Note: Of course, the dropdown list will only display the possible choices for the report (i.e. if the report only has one instance, the option “penultimate” will not appear). And as previously mentioned, if the report has no instance at all, the default choice (report instance) is chosen.

Handling a BusinessObjects report’s prompts

Some BO reports contains prompts imposed by the Universe or prompts created by a user. You have the possibility via Digdash to fill these prompts in a dedicated interface to filter your BO query with the button called “Prompt values”.

bo_connector_en_html_d06ddc7dc417d7df.png

Screenshot: Button to access the prompts handler

bo_connector_en_html_69a0a2234ae5dc56.png
 

Screenshot: UI to handle prompt values for a BO report

The interface suggests you to enter for each prompt: its name (or label) and its associated value.

You can add as many name-value associations as needed.

Note : a prompt can be associated with a list of values. Use commas to separate each value.
Reload the report to apply these filters.

List of all BusinessObjects reports (Webi and DesktopIntelligence)

The UI comes with a button that will allow you to see all the BO reports on your BO server.

bo_connector_en_html_5468454bbb3a1ea9.png

Screenshot: Button to display all reports on the BO server

bo_connector_en_html_4f29806c0fa9ca89.png

Screenshot: the dialog displays all the WebI and DesktopIntelligence reports on the BO server

The dialog will display all the BO reports with, for each report:

  • its ID,
  • its name,
  • its number of instances,
  • its type and its path on the BO server.

Besides, the dialog comes with a search bar that will allow you to search for a report, faster.

Note: the filtering works for the report ID as well as for its name, its number of instances, its type and its path on the BO server.

By default, the interface lists the first 10,000 BO reports of the server. You have the possibility to increase or reduce the number of reports to display with the option “Choose the number of reports to display in the list”.*

bo_connector_en_html_65158ceaba96a20b.png

 

Note: when the option is not selected, the number of report to display comes back to 10,000;

The unique selection of a report will automatically update the fields related to the selected BO report.

Importing the certificate for a secured connection

If you deal with a secured connection (https), you need proceed as follows:

First, you need to import the Digdash certificate so that Digdash can access the application:

  • With Windows
  • Launch the command prompt and go to:

    C:\...\install_dd_20XX\jdk\jre\bin

  • Execute the command:

    keytool -import -trustcacerts -file certificat.crt -alias CA_DIGDASH -keystore ..\lib\security\cacerts

  • Enter a password (changeit by default)
  • Answer “yes” to the question
  • With Linux
  • Directly enter the command:

    keytool -import -trustcacerts -file certificat.crt -alias CA_DIGDASH -keystore $JAVA_HOME/jre/lib/security/cacerts

  • Enter a password (changeit by default)
  • Answer “yes’ to the question

In order to check if the previous operation is successful:

  • With Windows
  • Launch the command prompt and go to:

    C:\...\install_dd_20XX\jdk\jre\bin

  • Execute the command:

    keytool -list -v -keystore ..\lib\security\cacerts

  • With Linux
  • Directly enter the command:

    keytool -list -v -keystore $JAVA_HOME/jre/lib/security/cacerts