Universe Connection Manager

Business Objects Web Intelligence Rich Client XI 3.0

windows
Copyright © 2010 SAP AG. All rights reserved.SAP, R/3, SAP NetWeaver, Duet, PartnerEdge,
ByDesign, SAP Business ByDesign, and other SAP products and services
mentioned herein as well as their respective logos are trademarks or registered
trademarks of SAP AG in Germany and other countries. Business Objects and the
Business Objects logo, BusinessObjects, Crystal Reports, Crystal Decisions, Web
Intelligence, Xcelsius, and other Business Objects products and services mentioned
herein as well as their respective logos are trademarks or registered trademarks
of Business Objects S.A. in the United States and in other countries. Business
Objects is an SAP company.All other product and service names mentioned are
the trademarks of their respective companies. Data contained in this document
serves informational purposes only. National product specifications may vary.These
materials are subject to change without notice. These materials are provided by
SAP AG and its affiliated companies ("SAP Group") for informational purposes
only, without representation or warranty of any kind, and SAP Group shall not be
liable for errors or omissions with respect to the materials. The only warranties for
SAP Group products and services are those that are set forth in the express
warranty statements accompanying such products and services, if any. Nothing
herein should be construed as constituting an additional warranty.

2010-05-24
Contents
Chapter 1 Introduction to Universe Connection Manager 5
What is Universe Connection Manager?.....................................................6

Chapter 2 Using Universe Connection Manager 7

To start Universe Connection Manager.......................................................8
The Universe Connection Manager start page............................................8
Managing connections in Universe Connection Manager...........................9
To create a connection...........................................................................9
To edit a connection.............................................................................10
Using the New Connection Wizard......................................................10
Login Parameters dialog box................................................................11
Configuration parameters dialog box ..................................................13
Custom Parameters dialog box............................................................14
To test a connection.............................................................................14
To remove a connection.......................................................................15
To assign a connection.........................................................................15
Viewing universes in Universe Connection Manager................................16
To check a universe..............................................................................16
Setting options for universes in Universe Connection Manager................16
To set default universe options.............................................................17

Appendix A More Information 19

Index 23

Universe Connection Manager 3

Contents

4 Universe Connection Manager

Introduction to Universe
Connection Manager

1
1 Introduction to Universe Connection Manager
What is Universe Connection Manager?

What is Universe Connection Manager?

Universe Connection Manager is a connection management tool that is
installed with Web Intelligence Rich Client . It allows an administrator to
create and edit connections for universes that are stored either locally or in
a shared directory. These universes do not have any security level, and are
accessed offline from the Central Management System.

6 Universe Connection Manager

Using Universe Connection
Manager

2
2 Using Universe Connection Manager
To start Universe Connection Manager

To start Universe Connection Manager

You start Universe Connection Manager as follows:
1. Click the Start button on the Task bar.
2. Point to the Programs menu.
3. Select Universe Connection Manager from the Business Objects group
of products.
Universe Connection Manager opens directly to the start page.

The Universe Connection Manager start

page
The Universe Connection Manager start page appears when you start
Universe Connection Manager. You can manage and create connections
from this page using the three tabs available:

Start page tab Description

Lists connections available to the Universe Connection

Manager. You can add a new connection, edit or remove a
Connections
connection in the list, test, or assign a connection to another
universe.

Lists the universes available to Universe Connection Manag-

Universes er. These are universes that are in the default universe
folder, either on your local machine, or in a shared directory.

You can set the default universe folder. This is the folder
that contains the universes that appear on the Universes
tab. You can also select the universe structures that are
Options
validated when you check the SQL integrity of a selected
universe. You can also set the language for the objects in
the universe.

8 Universe Connection Manager

 Using Universe Connection Manager
Managing connections in Universe Connection Manager 2
Managing connections in Universe
Connection Manager
The Connections tab lists connections that are either available in local
universes, or that can be assigned to a universe when required.

From this tab, you can create a new connection, edit, test, and remove
existing connections, and also assign a connection to another universe.

You have the following connection management options on this page:

Connection tab op-

When clicked...
tion button

Starts the New Connection wizard. You follow the

Add
wizard to create a new connection.

Opens the Edit a Connection wizard. You follow the

Edit wizard to edit login, configuration, and custom param-
eters.

Verifies that the connection is active and connects to

Test
the middleware.

Remove Deletes a selected connection from the list.

Allows you to assign the connection to a universe in

Assign
the default universe folder.

To create a connection

You create a connection from the Universe Connection Manager start page.
1. Start Universe Connection Manager.
2. Click the Connection tab.
3. Click the Add button.
The New Connection Wizard starts.
4. Follow the wizard steps to create the connection.

Universe Connection Manager 9

2 Using Universe Connection Manager
Managing connections in Universe Connection Manager

The new connection appears in the "Available connections " list.

To edit a connection

You edit a connection from the Universe Connection Manager start page.
1. Start Universe Connection Manager.
2. Click the Connection tab.
3. Click a connection in the "Available connections " list.
4. Click the Edit button.
The Edit Connection Wizard starts.
5. Follow the wizard steps to modify the parameters for the connection.

Using the New Connection Wizard

The New Connection wizard steps you through the process of creating a
connection. Use it to select a target data source, and configure the data
access driver.

Use the New Connection wizard to set the following parameters:

Connection wizard stage Description

Locate the database middleware to

Database middleware connect to, and assign a name for
the connection.

Set the connection mode, and specify

Login parameters the login details for connecting to the
middleware.

10 Universe Connection Manager

 Using Universe Connection Manager
Managing connections in Universe Connection Manager 2
Connection wizard stage Description

Configure connection parameters, for

example the connection timeout de-
tails, array fetch and bind sizes, and
Configuration parameters
login time-out. These vary depending
on the database to which you are
connecting.

Customize parameters to optimize

your connection. These vary depend-
Custom parameters
ing on the database to which you are
connecting.

Note:
The parameters that the New Connection wizard displays vary depending
on the options that you select, for example the database middleware, and
the connection mode.

Related Topics
• Login Parameters dialog box
• Configuration parameters dialog box
• Custom Parameters dialog box

Login Parameters dialog box

The New Connection wizard's Login Parameters dialog box can contain
the following parameters:

Note:
If you accessing the connection wizard from Universe Connection Manager
(UCM), or are working in Offline mode (no CMS), the only Authentification
mode available is Use specified username and password.

Universe Connection Manager 11

2 Using Universe Connection Manager
Managing connections in Universe Connection Manager

Parameter Description

• Use specified user name and

password: uses the login details as
authentication.
• Use Business Objects credential
mapping: the user is prompted for
a database user password associat-
ed with their BusinessObjects ac-
count to refresh a report. This is set
using the parameters dbuser and
dbpass. These are set at the admin-
istrative level. Refer to Business
Authentication mode Objects Enterprise Administrator's
Guide for information on setting up
this option.
• Use Single Sign On when refresh-
ing reports at View Time: When
selected, the username and pass-
word used to access the CMS are
automatically used as the database
login parameters. See the Business
Objects Enterprise Administration
Guide for informtaion on setting
Single Sign-On (SSO).

Your database user name. This is normal-

User name ly assigned to you by the database admin-
istrator.

Your database password. This is normal-

Password ly assigned to you by the database admin-
istrator.

Datasource (<Host>:<port>): The data source details.

Database The database name.

12 Universe Connection Manager

 Using Universe Connection Manager
Managing connections in Universe Connection Manager 2

Configuration parameters dialog box

The Configuration Parameters dialog box contains parameters that you

can set to override default configuration options. These configuration
parameters override:
• Any corresponding parameters set in the cs.cfg file
• Any corresponding parameters set in the <driver>.sbo file.

You can set the following parameters:

From the drop down list, select the method

Connection pool mode to use to keep the connection active. Only
necessary if using a connection pool.

If you select Keep the pool active for in the

Pool timeout previous field, specifies the length of time to
keep the connection open.

Enter the maximum number of rows autho-

rized with each fetch.

If you enter 20, and your query retrieves 100

rows, the connection executes 5 fetches to
retrieve your data.

If you enter 1, array fetch is deactivated and

data is retrieved row by row.
Array fetch size
Note:
Deactivating array fetch is the safest way of
retrieving your data but row-by-row retrieval
slows down server performance. The greater
the value in the Array fetch size option, the
faster your rows are retrieved. You must, how-
ever, ensure you have adequate client system
memory.
The default value is 20.

Universe Connection Manager 13

2 Using Universe Connection Manager
Managing connections in Universe Connection Manager

Enter the size of the bind array that Connec-

tion Server uses before sending to the
repository. The bind array is the area in
memory where Connection Server stores a
batch of data to be loaded (sent to the
Array bind size
repository). When the bind array fills, it is
transmitted to the database. Generally, the
larger the bind array, the more rows (n) can
be loaded in one operation, and the better
your performance.

Specifies the number of seconds before a

Login timeout connection attempt times out and an error
message is displayed.

Custom Parameters dialog box

Use this dialog box to configure any custom configurations that apply to the
connection. The parameters that appear depend on the other parameters
that you have set. The parameters set here override:
• Any corresponding parameters set in the cs.cfg file
• Any corresponding parameters set in the <driver>.sbo file.

For information on the parameters, refer to the SBO file parameter reference
information.

To test a connection

You test a connection from the Universe Connection Manager start page.
1. Start Universe Connection Manager.
2. Click the Connection tab.
3. Click a connection in the "Available connections " list.

14 Universe Connection Manager

 Using Universe Connection Manager
Managing connections in Universe Connection Manager 2
4. Click the Test button.
A result box appears with details of the connection validation.

To remove a connection

You remove a connection from Universe Connection Manager as follows:

1. Start Universe Connection Manager.
2. Click the Connection tab.
3. Select a connection in the Available connections list.
4. Click the Remove button.
The connection is removed from the list.

To assign a connection

You can assign a connection to any universe in the default universe folder.
The path to this folder is defined in the Options tab of the start up page.
1. Start Universe Connection Manager.
2. Click the Connection tab.
3. Select a connection in the Available connections list
4. Click the Assign button.
The Assign connection dialog box appears. It lists the universes available
in the default universe folder.
5. Click a universe in the list. This is the universe that you want to use the
new connection.
6. Click OK.
The connection is assigned to the universe. When a query is run in Web
Intelligence Rich Client, the returned data is from the data source for the
newly assigned connection.

Universe Connection Manager 15

2 Using Universe Connection Manager
Viewing universes in Universe Connection Manager

Viewing universes in Universe

Connection Manager
You can view the universes available to Universe Connection Manager in
the Universes tab of the start page. The universes are stored in the default
universe folder. The path to this folder is defined in the Options tab. The
universes listed are also available to Web Intelligence Rich Client. You can
check the SQL validity for the objects and structure of the a universe.

To check a universe

You can check certain SQL and structural components of a selected universe.
If you find errors, or problems that could affect the returned data, you need
to use Business Objects Designer to open and repair the universe.
1. Start Universe Connection Manager.
2. Click the Universes tab.
3. Select a universe and click the Check universe button.
A status box appears listing the structures checked and the errors found.

Setting options for universes in Universe

Connection Manager
You can set default settings for the following options that apply to universes
in the universes folder:

Option Description

Folder that stores the universes ac-

cessed by Web Intelligence Rich Client
Default universes folder
. you can browse to set a different path
for the default folder.

16 Universe Connection Manager

 Using Universe Connection Manager
Setting options for universes in Universe Connection Manager 2
Option Description

Select the universe components that

are validated when you click the Check
button in the Connections page. Refer
to the Designer's Guide for the Busi-
ness Objects Designer for complete
information on checking a universe and
solving SQL and schema problems.
You have the following options:
• Universe structure: The table
structure of the universe is parsed
Check universe structure to check for schema problems
that should be resolved before
reports are created on the uni-
verse.
• Objects: The SQL definition for
dimensions and measures is veri-
fied.
• Joins: The cardinality of joins is
verified.
• Conditions: Condition objects are
verified.

You can set the default language for

Language
objects in universes.

To set default universe options

1. Start Universe Connection Manager.
2. Click the Options tab.
3. Select default settings to apply to all universes in the default universes
folder.
4. Click Close.

Universe Connection Manager 17

2 Using Universe Connection Manager
Setting options for universes in Universe Connection Manager

18 Universe Connection Manager

More Information

A
A More Information

Information Resource Location

SAP BusinessObjects product

http://www.sap.com
information

Select http://help.sap.com > SAP BusinessObjects.

You can access the most up-to-date documentation cover-

ing all SAP BusinessObjects products and their deployment
at the SAP Help Portal. You can download PDF versions
or installable HTML libraries.
SAP Help Portal Certain guides are stored on the SAP Service Marketplace
and are not available from the SAP Help Portal. These
guides are listed on the Help Portal accompanied by a link
to the SAP Service Marketplace. Customers with a mainte-
nance agreement have an authorized user ID to access
this site. To obtain an ID, contact your customer support
representative.

http://service.sap.com/bosap-support > Documentation

• Installation guides: https://service.sap.com/bosap-inst
guides
• Release notes: http://service.sap.com/releasenotes
The SAP Service Marketplace stores certain installation
guides, upgrade and migration guides, deployment guides,
SAP Service Marketplace
release notes and Supported Platforms documents. Cus-
tomers with a maintenance agreement have an authorized
user ID to access this site. Contact your customer support
representative to obtain an ID. If you are redirected to the
SAP Service Marketplace from the SAP Help Portal, use
the menu in the navigation pane on the left to locate the
category containing the documentation you want to access.

https://boc.sdn.sap.com/
Developer resources
https://www.sdn.sap.com/irj/sdn/businessobjects-sdklibrary

20 Universe Connection Manager

 More Information
A
Information Resource Location

SAP BusinessObjects articles https://www.sdn.sap.com/irj/boc/businessobjects-articles

on the SAP Community Net-
work These articles were formerly known as technical papers.

https://service.sap.com/notes
Notes These notes were formerly known as Knowledge Base ar-
ticles.

Forums on the SAP Communi-

https://www.sdn.sap.com/irj/scn/forums
ty Network

http://www.sap.com/services/education

Training From traditional classroom learning to targeted e-learning

seminars, we can offer a training package to suit your
learning needs and preferred learning style.

http://service.sap.com/bosap-support

The SAP Support Portal contains information about Cus-

tomer Support programs and services. It also has links to
Online customer support a wide range of technical information and downloads.
Customers with a maintenance agreement have an autho-
rized user ID to access this site. To obtain an ID, contact
your customer support representative.

http://www.sap.com/services/bysubject/businessobjectscon
sulting

Consultants can accompany you from the initial analysis

Consulting stage to the delivery of your deployment project. Expertise
is available in topics such as relational and multidimensional
databases, connectivity, database design tools, and cus
tomized embedding technology.

Universe Connection Manager 21

A More Information

22 Universe Connection Manager

Index
C O
connection overview
parameters overview 10 connection parameters 10

Universe Connection Manager 23

Index

24 Universe Connection Manager