How To Customize Oracle Business Intelligence Discoverer 10g (10.1.

2) Connection
Page [ID 312463.1]

Modified 21-JUL-2009 Type HOWTO Status PUBLISHED

In this Document
Goal
Solution
References

Applies to:

Oracle Discoverer - Version: 10.1.2.0.0 to 10.1.2.3

Information in this document applies to any platform.

Goal

The purpose of this document is to provide instructions for UIX file modifications that customers may
need to meet additional requirements over and beyond the functionality provided by the Oracle
Enterprise Manager Application Server Control.

 It is recommended that users use the functionality provided in the Oracle Enterprise Manager
Application Server Control to make changes to the User Interface (UI) and the look and feel of
Discoverer Pages.
 The changes documented are not supported by Oracle. While the changes documented have
been tested on a limited number of platforms, these changes are provided without any claims
to their accuracy.
 It is strongly recommended that you make appropriate backups before attempting any of the
steps described in this document. Additionally, your changes could be overwritten by future
patching.
 If you do make any changes to any UIX, UIT or any other files that are shipped with Oracle
Business Intelligence Discoverer, and if you run into issues, you must reproduce those issues
on a machine without these modifications for Oracle to provide support.

Solution

Currently the following items are documented to be customized:

 Modifying the connections names

o The connection names may not be intuitive to users in your organization.

To modify the text for the relational connection names on the connections page:
1. Navigate to:
$BIHome\j2ee\OC4J_BI_Forms\applications\discoverer\discoverer\templates
2. Create a backup of the file ConnectionAccessTypes.uit
3. Modify the text in file ConnectionAccessTypes.uit as follows:

From:
<contents xmlns="http://xmlns.oracle.com/uix/ui">
<option value="RELATIONAL" text="${uix.data.nls['
 text.access.type.RELATIONAL']}"/>
<option value="APPS" text="${uix.data.nls['text.a
ccess.type.APPS']}"/>
<option value="OLAP" text="${uix.data.nls['text.a
ccess.type.OLAP']}"/>
<rootChild name="contents"/>
</contents>
To:
<contents xmlns="http://xmlns.oracle.com/uix/ui">
<option value="RELATIONAL" text="Your text here,
for example: OracleBI Discoverer-Standard EUL"/>
<option value="APPS" text="Your text here, for ex
ample:OracleBI Discoverer-Applications EUL"/>
<option value="OLAP" text="${uix.data.nls['text.a
ccess.type.OLAP']}"/>
<rootChild name="contents"/>
</contents>

4. Restart the OC4J_BI_Forms instance for the changes to take effect.

 Removing the Discoverer for OLAP connection

o Querying multi-dimensional OLAP cubes via Discoverer may not yet be implemented
in your organization.

Note: You can remove any of the connections with this could if necessary if for
example, you only use an APPS_MODE eul. It has been noted that with 10.1.2.3 and
Discoverer cumulative patch 3 (CP2 works fine) that when you remove the 'Oracle BI
(relational)' and 'Oracle OLAP' connections and leave only the 'Oracle Applications'
connection that the page does not rebuild to add the 'responsibility' field. You will be
prompted for the Oracle E-Business Suite responsisbility on the next screen.
Generally, the responsibility field is removed anyway to avoid typographical errors
(see below). It is undertermined what has changed from CP2 to CP3 to cause this to
happen. It may or may not be investigated since this is an unsupported customization.
If the cause is determined, it will be updated here.

To remove the OLAP connection from the connections page:

1. Navigate to
$BIHome\j2ee\OC4J_BI_Forms\applications\discoverer\discoverer\template
2. Create a backup of the file ConnectionAccessTypes.uit
3. Modify the text in file ConnectionAccessTypes.uit as follows:

From:
<contents xmlns="http://xmlns.oracle.com/uix/ui"> <o
ption value="RELATIONAL" text="${uix.data.nls['text.access.ty
pe.RELATIONAL']}"/>
<option value="APPS" text="${uix.data.nls['text.access.type.A
PPS']}"/>
<option value="OLAP" text="${uix.data.nls['text.access.type.O
LAP']}"/>
<rootChild name="contents"/>
</contents>

To:
<contents xmlns="http://xmlns.oracle.com/uix/ui">
 <option value="RELATIONAL" text="${uix.data.nls['text.access.
type.RELATIONAL']}"/>
<option value="APPS" text="${uix.data.nls['text.access.type.A
PPS']}"/>
<rootChild name="contents"/> &nbs;
</contents>

4. Restart the OC4J_BI_Forms instance for the changes to take effect.

 Removing the E-Business Suite Responsibility Field from the Connections Page (for
APPS_MODE EUL)

Note: Users are prompted for the responsibility in a list of values field on the next screen if you
leave this field blank. You may want to remove this to prevent users from directly typing or
mis-typing in a responsibility and receiving an error message.

To remove the “Responsibility” input field from the main connection page, so that user can
only select the responsibility from the available list of responsibilities:

1. Navigate to $BIHome\j2ee\OC4J_BI_Forms\applications\discoverer\discoverer
2. Create a backup copy of the original file ViewerConnection.uix
3. Open the file ViewerConnection.uix in a text editor and remove the following two
<rowLayout> tags:

<rowLayout rendered="${uix.eventResult.responsibilityRendered}">....
<rowLayout><rowLayout rendered="${uix.eventResult.responsibilityRende
red}">....<rowLayout>

4. Restart the OC4J_BI_Forms instance for the changes to take effect.

 Enabling the 'Go' button to be executed by a short-cut key (like the 'enter' key)
o By default, the 'Go' button has to be executed with a left mouse click.

The following steps can be used to automatically submit the Connections page form
and to create a shortcut key for the “Go” button.

1. Navigate to
$BIHome\j2ee\OC4J_BI_Forms\applications\discoverer\discoverer\
2. Create a backup copy of the file TemporaryConnectionPage.uix
3. Open the file TemporaryConnectionPage.uix in a text editor.

To enable the user to press go button using Alt+O key combination, replace
the following text:
 <submitButton name="event" value="connect" formName="Connection
Form" text="${uix.data.nls['text.go']}" />

with:

<submitButton name="event" value="connect" formName="Connection

Form" textAndAccessKey="${uix.data.nls['button.go']}" />

o To submit the form when focus is on Password input field, replace the following text:

<textInput secret="true" name="${uix.data.constants.PASSWORD_PARAM}" c

olumns="40" id="${uix.data.constants.PASSWORD_PARAM}" shortDesc="${uix
.data.nls['text.password']}"/>

with:

<textInput secret="true" name="${uix.data.constants.PASSWORD_PARAM}" c

olumns="40" id="${uix.data.constants.PASSWORD_PARAM}" shortDesc="${uix
.data.nls['text.password']}">
<enterClientAction>
<fireAction event="connect" formSubmitted="true" />
</enterClientAction>
</textInput>

Restart the OC4J_BI_Forms instance for the changes to take effect.

References

NOTE:309239.1 - How To Customize Oracle Business Intelligence Discoverer 10gR2 Viewer

NOTE:342255.1 - How To Remove the "End User Layer" option Customize Discoverer 10g (10.1.2)
Connection Page
NOTE:400638.1 - How To Control Or Default The Discoverer 10g (10.1.2) Login Method

Related

Products

 Middleware > Business Intelligence > Discoverer > Oracle Discoverer

 Middleware > Business Intelligence > Discoverer > Oracle Discoverer

Keywords

CONFIGURATION; PRIVATE CONNECTION; PUBLIC CONNECTION

Back to top