You are on page 1of 18

SAP BI 4 ELITE ENABLEMENT

Setting Up Relational Universe for SAP NetWeaver BW


Exercises / Solutions
2
1 Over vi ew of t he Busi ness Case
In this exercise we will create a relational Universe based on an InfoProvider in SAP NetWeaver BW so that the
Universe can be leveraged with the other BI clients and we will also leverage the Universe to create an index with SAP
BusinessObjects Explorer.
2 Ex er c i se 1: Set t i ng up SAP Net Weaver BW f or a r el at i onal dat a c onnec t i on
Before we can start creating and using a relational Universe on top of SAP NetWeaver BW we need to configure the
callback ID for the data federation service in SAP NetWeaver BW.
1. Logon to the SAP NetWeaver BW system with the SAP GUI
2. Start transaction SE37
3. Enter RSDRI_DF_CONFIGURE as function module
4. Press F8 on the key board to execute the function module
5. You can now use the table shown below to enter the necessary values:
Parameter Value
I_ONLY_CHECK Option to set the option, in case you just want to check the values
I_RFC_DESTINATION Name for the Callback ID
I_REMOVE_CONFIGURATION Option to set the flag for removing the callback ID.
6. Make sure the fieldI_ONLY_CHECK is empty
7. Set the value for I_RFC_DESTINATION to DF_JCO_BI4ELITE
8. Make sure the fieldI_REMOVE_CONFIGURATION is empty
9. Press F8 on the keyboard to execute the function
3
10. You can click on the Value Entry for the export message to see the status.
11. Close the SAP session
Data Federation Callback ID
By default the callback IDs are being generated automatically and are visible in transaction SM59. There might be
situations where the automatic logic is not resulting in the wanted behavior and you should configure the callback ID
manually. These steps are described as well in SAP notes 1601098 and 1712546.
4
3 Ex er c i se 2: Cr eat i ng a c onnec t i on f or a r el at i onal Uni ver se on t op of SAP
Net Weaver BW
In this activity we will setup the connection to SAP NetWeaver BW without creating the Universe so that we can
configure the data federator details and finish the configuration.
1. Start the Information Design tool by following the menu Start Programs SAP BusinessObj ects BI Platform 4
SAP BusinessObjects BI Pl atform Cl ient Tools Information Design Tool .
2. Select the menuFile New Project to create a new project for your Universe.
3. Enter BI4Elite_BW_Universe as name for the new project and click Fi nish.
4. Select your new project in the list of Local Projects.
5. Select the menu Window and make sure the windowRepository Resources is shown.
6. Select the menuInsert Session to establish a session to your SAP BusinessObjects system.
7. Use the following details to logon
System: EPM10.CSA.SAP.CORP:6400
User CSA~001/SAPUSER
Password Welcome! (case sensitive!)
Authentication SAP
Logon Dialog and User Name
Because the logon dialog does not provide separate entries for the SAP System ID and the Client number you
need to enter those details as part of the user name following the syntax : <System ID>~<Client>/<User Name>; in
our example: CSA~001/SAPUSER
5
8. Click OK.
9. Open the context menu of your established server connection in the area Connections.
10. Select the menu itemInsert Relational Connection
SAP NetWeaver BW Connection
To establish a relational connection towards the SAP NetWeaver BW connection you need to first establish a
session towards the SAP BusinessObjects system, and then create a connection starting with the repository of
your SAP BusinessObjects system, which is slightly different to the usual workflow
11. Enter a name for the connection BI4_ELITE_RELATIONAL_BW
12. Click Next.
6
13. Select the connection type SAP Java Connector in the categorySAP NETWEAVER BW.
14. Click Next.
15. Enter the necessary details of your SAP NetWeaver BW system:
Authentication Mode: Use Single Sign On
Client Number : 001
Language : EN
System ID : CSA
Application Server : EPM10.CSA.SAP.CORP
System Number 00
Authentication Mode
You can set the Authentication Mode to Use Single-Sign On, but this requires your SAP BusinessObjects
Enterprise system to be configured with the SAP Authentication.
16. You can use the Save Language option to save your settings as configured in the relational connection. In case
you leave the checkbox open, the user can influence the language by setting the user preferences in the BI
Launchpad.
17. Use the button next to the boxInfoProvi der to receive a list of possible InfoProvider.
7
18. You can use the filter as part of the screen to limit the list of InfoProvider based on the type of InfoProvider:
IOBJ =InfoObject
CUBE =InfoCube
ODSO =Operational Data Store
MRPO =MultiProvider
VIRT =Virtual InfoProvider
19. In our example we are using the MultiProvider 0D_NW_M01 from the NetWeaver Demo Model. The entry will have
a I in front of the technical name.
20. Click OK.
21. Click Finish.
22. You will be asked if you would like to create a shortcut for your connection. Click Yes.
23. Select your local project.
24. Click OK
25. Click Close.
8
4 Ex er c i se 3: Conf i gur i ng Dat a Feder at or Connec t i on Det ai l s
Before we are now going to create the relational Universe on top of SAP NetWeaver BW, we need to configure the
connection properties for our connection to SAP NetWeaver BW.
1. Start the Data Federator Administration Tool by following the menu Start Programs SAP BusinessObjects BI
Pl atform 4 SAP BusinessObjects BI Platform Client Tool s Data Federation Administration Tool.
2. Log onto your SAP BusinessObjects BI server by using your SAP credentials and using the SAP Authentication.
3. Click OK.
4. Close the Welcome screen.
5. Select the menu Window and make sure the Show / Hide Connector Configuration is checked
6. Navigate to the tab Connector Configuration
7. Select the connectionBI4_ELITE_RELATIONAL_BW.
8. Use a right-click and select the menu Create Configurati on.
9. Enter the following as value for the propertyjcoDestinationProperties :
MegaEli te.AdaptiveProcessi ngServer=DF_JCO_BI4ELITE
10. Click on the save button (top right corner).
11. Close the Data Federator Administration Tool
9
The table below shows the possible parameters and a brief description :
Property Description
packageSize Package size for callbacks.
This is the number of rows returned by SAP NetWeaver BW to the
data federation query engine, per package.
The default value is 200.
programIDMapping Defines the program IDs for the callback that SAP NetWeaver BW uses to contact
Data Federator. The IDs are provided as a list of mappings: server name =>
program ID.
This list is formatted as a string containing key/values separated by ';'. The key
represents the server name and the value represents a program ID. Each ID
must match the name of an RFC destination created on SAP
NetWeaver BW.
If this property is not defined, Data Federator will automatically create an RFC
destination. This RFC destination will be created using a program ID identical to the
name of the RFC destination. The format of the created RFC destination is:
DF_J CO_ +hostname +_ +counter. The hostname is the name of the local host
and the counter goes from 0 to 9.
However the maximal length of hostname is 23. If the name of local host is bigger
than 23 only a prefix of 23 characters is used in the RFC destination name.
If the property is defined but there is no mapping listed for the current server, an
error is returned. There is not default value for this property (which means that the
automatic mode is used).
Example 1
MySIA.AdaptiveProcessingServer=RFC1
Example 2
MySIA.DFServer1=RFC1;MySIA.DFServer2=RFC2;...
useBinaryXML When set to true, the data exchanged between the connector and
the SAP Netweaver BW server is compressed in binary XML format
instead of plain text format. This improves performance. By default
the value is true.
checkUnits When set to true, a query using a measure without its unit is refused,
and an error is raised. By default the value is false, and use of a
measure without its unit is allowed.
forcedCapabilities Lets you artificially limit the capabilities of the SAP NetWeaver BW
connector, if you want the data federation query engine to perform
operations instead of SAP NetWeaver BW.
Enter the capabilities that you want the data federation query engine
to delegate to SAP NetWeaver BW.
The valid values are as follows:
SCAN_ONLY the data federation query engine only delegates
scans to SAP NetWeaver BW.
PROJ ECTIONS_ONLY the data federation query engine only
delegates projections to SAP NetWeaver BW.
empty - the data federation query engine delegates all valid operations
to SAP NetWeaver BW
jcoDestinationProperties
jcoServerProperties
10
authorityCheck Sets the parameter in SAP NetWeaver BW that indicates whether
or not to check authorizations. The parameter in SAP NetWeaver BW specifies
whether SAP NetWeaver BW should do the following.
Should it check whether the user account is authorized to see the
requested data (read) or should authorizations not be checked at
all (none)?
true (default): SAP NetWeaver BW checks read authorizations.
false: SAP NetWeaver BW checks no authorizations
pingTimeout
maxValuesInInClause Specifies the maximum number of values in the IN clause. The default value is 0
which means that there is no limit or the limit is unknown.
semiJ oinMaxQueries Specifies the maximum number of queries that a semi-join operator can execute.
The default value is 0 which means that there is no limit or the limit
is unknown.
semiJ oinExecutionStrategies
enableAuthorizationsFiltering When set to true, authorizations filtering is enabled: the connector will ensure that
filters are automatically added to satisfy the SAP BI authorizations defined for the
current user. When the authorization filtering is disabled, the user will get an error if
he tries to get unauthorized data. By default the value is false.
debugReportPrefix
gatewayHostname The name of the machine hosting the SAP NetWeaver BW gateway.
If not specified, an RFC is executed to let SAP NetWeaver BW to choose the value
gatewayServiceName Name or port number of the SAP NetWeaver BW gateway service.
If not specified, an RFC is executed to let SAP NetWeaver BW to choose the value.
Data Federator Desti nation
Data Federator will automatically create an RFC destination for the connection to SAP NetWeaver BW. This RFC
destination will be created using a program ID identical to the name of the RFC destination. The format of the
created RFC destination is: DF_J CO_ +hostname +_ +counter. The hostname is the name of the local host and
the counter goes from 0 to 9.
If you prefer to define the destination name according to your naming conversions you can follow the outlined steps
above.
11
5 Ex er c i se 4: Cr eat i ng a r el at i onal Uni ver se on t op of SAP Net Weaver BW
Now we will setup the relational Universe on top of SAP NetWeaver BW
1. Start the Information Design Tool and open the previously created project.
2. Select your local project.
3. Select your SAP BusinessObjects BI server in the Repository Resources window.
4. Use a right-click on your server entry and use the menu Open Session
5. Enter your password
6. Click OK
7. Select the menuFile New Data Foundati on.
8. Enter BI4El ite_BW_DATA_FOUNDATION as name for the Data Foundation.
9. Click Next.
10. Select the option Multi-Source-Enabled. The connection towards SAP NetWeaver BW is not available when using
the Single Source option.
11. Click Next.
12. You will be asked to logon to your SAP BusinessObjects Enterprise system. Your credentials should already be
entered.
13. Click Next.
14. Select the shortcut which was created for the connection we established previously.
15. Click Next.
12
16. Click Advanced.
17. Ensure the option AUTOMATICALLY CREATES TABLES AND JOINS is activated.
18. Click Finish.
You are presented with a default generated star schema for the selected InfoProvider.
19. Select your local project.
20. Select the menuFile New Business Layer
21. Select the entryRelational Data Source
22. Click Next.
23. Enter BI4Elite_BW_BusinessLayer as name for the Business Layer.
24. Click Next.
25. Use the button and select the newly created Data Foundation - BI4Eli te_BW_DATA_FOUNDATION.
26. Click OK
27. Ensure the option Aut omaticall y create folders and obj ects for SAP NetWeaver BW connections
(recommended) is activated.
28. Click Finish.
13
You are being presented with a list of classes, dimensions, and measures that have been generated based on the
information retrieved from SAP NetWeaver BW.
Because the Universe has been built with the actual dimension objects representing the key values of the InfoObjects
from BW we will make a set of changes in the Universe before using it for reporting.
In the next few steps we will:
add a detail object to show the key values for the characteristics in the Universe
change the definition of the dimension object so that it shows the Text value of the characteristics
make formatting changes to the Calendar Year and Calendar Month entries
1. Open the newly created business layer.
2. Navigate to the class Country
3. Navigate to the dimension Country (SAP NW Demo)
4. You will notice that there is no entry for the key value of the dimension. The key value is what is used to create the
dimension object.
5. Use a right-click on the dimension Country (SAP NW Demo).
14
6. Select the menu New > Attribute.
7. Enter Country Key as the Name for the new attribute
8. Now select the dimension object Country (SAP NW Demo).
15
9. Select the complete syntax from the SELECT box and copy it to the clipboard.
10. Now navigate back to the newly create attribute Country Key.
11. Paste the copied syntax into the SELECT box for the newly created attribute Country Key.
12. Now select the attribute Country (SAP NW Demo) Heading.
13. Select the complete syntax from the SELECT box and copy it to the clipboard.
14. Now navigate back to the dimension object Country (SAP NW Demo).
15. Paste the copied syntax into the SELECT box for the dimension object Country (SAP NW Demo).
Follow the steps 1 to 15 shown above to make these adjustments for the following characteristics:
In class Country Key - GIS Region (SAP NW Demo)
In class Customer - Sold-to-Party (SAP NW Demo)
In class Organization - Sales Group (SAP NW Demo)
In class Product - Product (SAP NW Demo)
In class Product - Product Category (SAP NW Demo)
In class Product - Product Group (SAP NW Demo)
After we completed the latest steps we are now going to make some adjustments to the Calendar Year and Calendar
Month dimensions.
1. Open the newly created business layer.
2. Navigate to the class Time
3. Navigate to the dimensionCal endar Year
4. Navigate to the tab Advanced
5. Click
6. Select Numeri c
16
7. Click Custom Format
8. Use the 0 option from the area Digit and add four times the item 0
9. Click OK
10. Click OK
11. Navigate to the dimensionCal endar Year / Month
12. Navigate to the tab Advanced
13. Click
14. Select Numeri c
15. Click Custom Format
16. Create a custom format like 0000 / 00.
17. Click OK
18. Click OK
19. Select the menuFile > Save All.
20. Right-Click the newly generated Business Layer entry as part of your local project.
21. Select the menuPublish > To a Repository
22. Select the integrity checks you would like to perform.
23. Click Next
17
24. Select a folder for the Universe.
25. Click Finish.
26. Click Close.
27. Close the Information Design Tool
18
2012 SAP AG. All rights reserved.
SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP BusinessObjects Explorer, StreamWork, SAP HANA, 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 Software Ltd. Business Objects is an SAP company.
Sybase and Adaptive Server, iAnywhere, Sybase 365, SQL Anywhere, and other Sybase products and services mentioned herein as well as their
respective logos are trademarks or registered trademarks of Sybase Inc. Sybase is an SAP company.
Crossgate, m@gic EDDY, B2B 360, and B2B 360 Services are registered trademarks of Crossgate AG in Germany and other countries. Crossgate
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.