You are on page 1of 15

How-to Guide

SAP NetWeaver 04
SAP NetWeaver 04s











How To
Configure a
BI JDBC System for
Visual Composer
Version 1.03 March 2006




Applicable Releases:
SAP NetWeaver 04 SP Stack 10 or later
SAP NetWeaver 04s SP Stack 07 or later







Copyright 2005-6 SAP AG. All rights
reserved.

No part of this publication may be reproduced
or transmitted in any form or for any purpose
without the express permission of SAP AG. The
information contained herein may be changed
without prior notice.

Some software products marketed by SAP AG
and its distributors contain proprietary software
components of other software vendors.

Microsoft, Windows, Outlook,

and PowerPoint

are registered trademarks of Microsoft
Corporation.

IBM, DB2, DB2 Universal Database, OS/2,
Parallel Sysplex, MVS/ESA, AIX, S/390,
AS/400, OS/390, OS/400, iSeries, pSeries,
xSeries, zSeries, z/OS, AFP, Intelligent Miner,
WebSphere, Netfinity, Tivoli, and Informix are
trademarks or registered trademarks of IBM
Corporation in the United States and/or other
countries.

Oracle is a registered trademark of Oracle
Corporation.

UNIX, X/Open, OSF/1, and Motif are registered
trademarks of the Open Group.

Citrix, ICA, Program Neighborhood,
MetaFrame, WinFrame, VideoFrame, and
MultiWin

are trademarks or registered
trademarks of Citrix Systems, Inc.

HTML, XML, XHTML and W3C are trademarks
or registered trademarks of W3C

, World Wide
Web Consortium, Massachusetts Institute of
Technology.

Java is a registered trademark of Sun
Microsystems, Inc.

JavaScript is a registered trademark of Sun
Microsystems, Inc., used under license for
technology invented and implemented by
Netscape.

MaxDB is a trademark of MySQL AB, Sweden.
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.

These materials are provided as is without a
warranty of any kind, either express or implied,
including but not limited to, the implied
warranties of merchantability, fitness for a
particular purpose, or non-infringement.
SAP shall not be liable for damages of any kind
including without limitation direct, special,
indirect, or consequential damages that may
result from the use of these materials.
SAP does not warrant the accuracy or
completeness of the information, text, graphics,
links or other items contained within these
materials. SAP has no control over the
information that you may access through the
use of hot links contained in these materials and
does not endorse your use of third party web
pages nor provide any warranty whatsoever
relating to third party web pages.
SAP NetWeaver How-to Guides are intended
to simplify the product implementation. While
specific product features and procedures
typically are explained in a practical business
context, it is not implied that those features and
procedures are the only approach in solving a
specific business problem using SAP
NetWeaver. Should you wish to receive
additional information, clarification or support,
please refer to SAP Consulting.
Any software coding and/or code lines / strings
(Code) included in this documentation are only
examples and are not intended to be used in a
productive system environment. The Code is
only intended better explain and visualize the


SAP, R/3, mySAP, mySAP.com, xApps, xApp,
SAP NetWeaver, 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 in
several other countries all over the world. All
other product and service names mentioned are
the trademarks of their respective companies.
Data
syntax and phrasing rules of certain coding.
SAP does not warrant the correctness and
completeness of the Code given herein, and
SAP shall not be liable for errors or damages
caused by the usage of the Code, except if such
damages were caused by SAP intentionally or
grossly negligent.


1 Scenario
You have data stored in a JDBC system and youd like to be able to work with this data in
Visual Composer. Specifically, youd like to model BI queries using the BI Query Wizard and
related functionality. To do this, you need to configure your JDBC system as a BI system for
use in Visual Composer. All you need for this scenario is included in SAP NetWeaver 04,
SP Stack 10 or later, together with Visual Composer.


2 Introduction
This document provides detailed instructions on how to configure a BI JDBC system in
Visual Composer. It steps you through the process of setting up a JDBC driver using the
Web Application Servers Visual Administrator, configuring the BI JDBC Connector, and
finally creating a BI JDBC system in the portal that can be used in Visual Composer.

After configuring the BI JDBC system, refer to Visual Composer documentation to create a
model based on this system:

SAP NetWeaver 2004:
http://help.sap.com Documentation SAP NetWeaver SAP NetWeaver 2004
Application Platform SAP NetWeaver Visual Composer: User Guide Creating Portal
Content Building an iView Defining Data Services Creating BI Queries

SAP NetWeaver 2004s:
http://service.sap.com/nw-vc (SAP-internal documentation)




3 The Step By Step Solution
In the first section below you configure the JDBC driver for the BI JDBC Connector in the
SAP NetWeaver Application Servers Visual Administrator, and in the second section you
create the BI JDBC system in the SAP NetWeaver Portal.


3.1 Configure the BI JDBC Connector
Configure the BI JDBC Connector in the Visual Administrator.

1. Start the Visual Administrator using
go.bat.
2. Log on as an administrator.



3. On the Cluster tab, go to your server
node and select Services JDBC
Connector.
4. On the Runtime tab, verify that a
JDBC driver is configured for your
data source.

If a JDBC driver for your data source
has not yet been uploaded to the
Visual Administrator, proceed to the
next step.



5. (If necessary,) To import a JDBC
driver for your data source, select
the Drivers node on the Runtime tab,
and press the Create New Driver or
DataSource button.
6. In the Add Driver dialog box, enter a
name for your driver and press OK.
7. Specify the location of the JDBC
driver JARs provided to you by your
RDBMS vendor. Keep adding JARs
until all the required libraries have
been added.


8. On the Cluster tab, select Services
Connector Container, and on the
Runtime tab:

(NW 2004s and NW 2004 SP Stack
10 and later:) Select SDK_JDBC
under the node
sap.com/com.sap.ip.bi.sdk.d
ac.connector.jdbc

(NW 2004 SP Stack 09 and earlier:)
Select
sap.com/com.sap.ip.bi.sdk.d
ac.connector.jdbc/BI_JDBC_C
ONNECTOR.




9. Select the Resource Adapter tab.


10. Press Add and enter the name of the
JDBC driver to add it to the loader
references. This takes the following
format:
library:<drivername> ,
where <drivername> is the name
you entered in Step 6 above, for
example:
library:mssql



(The following step is not necessary if
this is the first time you have loaded the
BI JDBC Connector.)

Restart the BI JDBC Connector (in SP
Stack 10 and above, this step can also
be done in the Connector Container
Service):
11. On the Cluster tab, select Services
Deploy.
12. On the Runtime tab, select the BI
JDBC Connector
sap.com/com.sap.ip.bi.sdk.d
ac.connector.jdbc.
13. Press Stop Application.
14. Press Start Application.

The BI JDBC Connector is now ready
for use.








15. (Optional) To test the connection:
a) Select Services Connector Container, and select
sap.com/com.sap.ip.bi.sdk.dac.connector.jdbc/BI_JDBC_CONNECTOR.
b) On the Managed Connection Factory tab, select Properties.
c) Enter your connection properties, for example:
URL:
jdbc:microsoft:sqlserver://<hostname>:<port>;database=Northwind
Driver: com.microsoft.jdbc.sqlserver.SQLServerDriver
d) Save the settings.
e) Run the following test servlet:
NW 2004s and NW 2004 SP Stack 15 and later:
http://<hostname>:<port>/TestJDBC_Web/TestJDBCPage.jsp
NW 2004 SP Stack 14 and earlier:
http://<hostname>:<port>/TJdbc/servlet/TestJdbc

If your connection is successfully configured, a list of tables appears.




3.2 Create the BI JDBC System in the SAP NetWeaver Portal
Using the BI JDBC Connector, you now create a BI system that Visual Composer can use in
the SAP NetWeaver Portal.

Preparing your system in the portal consists of the following tasks:
Create a system in the Portal System Landscape for the JDBC database to which
you wish to connect
Prepare the connection properties
Configure the user mapping


To create a new system in the Portal
System Landscape:

16. Log on to the portal and select
System Administration System
Configuration System Landscape.
17. On the Browse tab, select a folder or
subfolder in the Portal Content folder
and right-click to access the context
menu.
18. NW 2004s SP Stack 05 or later:
Choose New System (from
template) from the context menu.
19. NW 2004:
Choose New From PAR System
from the context menu.
NW 2004 SP Stack 05 or later:
NW 2004:




20. NW 2004s SP Stack 05 or later:
In the System Wizard, on the
Template Selection screen, select BI
JDBC System and press Next.
21. NW 2004:
In the System Wizard, on the Portal
Archive Selection screen, select
com.sap.portal.systems.BIUDI,
and press Next.
NW 2004 SP Stack 05 or later:
NW 2004:



22. NW 2004 only:
On the Portal Component Selection
screen, select SAP_BI_JDBC (this
corresponds to the BI JDBC
Connector) and press Next.


23. On the General Properties screen,
configure the System Name and
System ID fields with the values of
your choice for your data source,
and press Next.
24. Press Finish to create your system.




To configure the connection properties:

25. On the <system name> tab, open
the system for edit by choosing
Open the object for editing, and
press OK.
26. From the Property Category drop-
down list, select Connection
Properties, and configure the
connection properties as pictured to
the right. Enter your own values for
Connection URL and Driver Class
Name according to your JDBC driver
documentation, for example:

URL:
jdbc:microsoft:sqlserver://<hostn
ame>:<port>;database=Northwind
Driver:
com.microsoft.jdbc.sqlserver.SQLS
erverDriver
27. Use the optional Fixed Catalog and
Fixed Schema properties to restrict
metadata access, if desired.
28. Press Save to save the values.






29. From the Property Category drop-
down list, select User Management.
30. From the User Mapping Type drop-
down list, select admin,user.
31. Press Save to save the value.




Create a new alias for this system. This
is how Visual Composer will refer to the
system:

32. Using the Display drop-down list,
select System Aliases and add an
alias to your system. In this
example, we name the alias
BI_JDBC.
33. Press Save to save the value.


To configure user mapping:

34. NW 2004s SP Stack 05 or later:
From the first-level Portal navigation, select User Administration Identity Management.
Get your user name, and in the Details section, select the User Mapping tab. Map your
Portal user to the user of the newly created system (in this case, the user of the JDBC
system), also configuring your user name and password for your system:



35. NW 2004:
From the first-level Portal navigation, select User Administration User Mapping, and
map your Portal user to the user of the newly created system (in this case, the user of
the JDBC system), also configuring your user name and password for your system:







Your BI JDBC system is now ready for use in Visual Composer. Look for it in Visual
Composer under the alias you defined in Step 32.


www.sap.com/netweaver