Ex_Setup Relational Universe for SAP BW

5/20/2018 Ex_Setup Relational Universe for SAP BW

1/18

SAP BI 4 ELITE ENABLEMENT

Setting Up Relational Universe for SAP NetWeaver BW

Exercises / Solutions


2/18

2

1 Overview of the Business Case

In this exercise we will create a relational Universe based on an InfoProvider in SAP NetWeaver BW so that theUniverse can be leveraged with the other BI clients and we will also leverage the Universe to create an index with SAPBusinessObjects Explorer.

2 Exercise 1: Setting up SAP NetWeaver BW for a relational data connection

Before we can start creating and using a relational Universe on top of SAP NetWeaver BW we need to configure thecallback ID for the data federation service in SAP NetWeaver BW.

1. Logon to the SAP NetWeaver BW system with the SAP GUI2. Start transaction SE373. EnterRSDRI_DF_CONFIGUREas function module4. Press F8on 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 field I_ONLY_CHECK is empty7. Set the value forI_RFC_DESTINATIONto DF_JCO_BI4ELITE8. Make sure the field I_REMOVE_CONFIGURATIONis empty

9. Press F8on the keyboard to execute the function


3/18

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/18

4

3 Exercise 2: Creating a connection for a relational Universe on top of SAP

NetWeaver BW

In this activity we will setup the connection to SAP NetWeaver BW without creating the Universe so that we canconfigure the data federator details and finish the configuration.

1. Start the Information Design tool by following the menu Start Programs SAP Busin essObjects BI Platform 4 SAP BusinessObjects BI Platform Client Tools Information Design Tool.

2. Select the menu File New Projectto create a new project for your Universe.3. EnterBI4Elite_BW_Universe as name for the new project and click Finish .4. Select your new project in the list of Local Projects.5. Select the menu Windowand make sure the window Repository Resourcesis shown.6. Select the menu Insert Sessionto 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 sensit ive!)

Authentication SAP

Logon Dialog and User NameBecause 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 : ~/; in

our example: CSA~001/SAPUSER


5/18

5

8. Click OK.9. Open the context menu of your established server connection in the area Connections.

10. Select the menu item Insert Relational Connection

SAP NetWeaver BW Connect ionTo 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_BW12. Click Next.


6/18

6

13. Select the connection type SAP Java Connectorin the category SAP 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 BusinessObjectsEnterprise system to be configured with the SAP Authentication.

16. You can use the Save Languageoption 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 BILaunchpad.

17. Use the button next to the box InfoProviderto receive a list of possible InfoProvider.


7/18

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 InfoProvider19. In our example we are using the MultiProvider0D_NW_M01from 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 OK25. Click Close.


8/18

8

4 Exercise 3: Configuring Data Federator Connection Details

Before we are now going to create the relational Universe on top of SAP NetWeaver BW, we need to configure theconnection properties for our connection to SAP NetWeaver BW.

1. Start the Data Federator Administration Tool by following the menu Start Programs SAP BusinessObjects BIPlatform 4 SAP BusinessObjects BI Platform Client Tools 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 checked6. Navigate to the tab Connector Configuration

7. Select the connection BI4_ELITE_RELATIONAL_BW.8. Use a right-click and select the menu Create Configuration.

9. Enter the following as value for the propertyjcoDestinationProperties:

MegaElite.AdaptiveProcessingServer=DF_JCO_BI4ELITE

10. Click on the save button (top right corner).11. Close the Data Federator Administration Tool


9/18

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 thedata federation query engine, per package.The default value is 200.

programIDMapping Defines the program IDs for the callback that SAP NetWeaver BW uses to contactData 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 keyrepresents the server name and the value represents a program ID. Each IDmust match the name of an RFC destination created on SAPNetWeaver BW.

If this property is not defined, Data Federator will automatically create an RFCdestination. This RFC destination will be created using a program ID identical to thename of the RFC destination. The format of the created RFC destination is:DF_JCO_ + hostname + _ + counter. The hostname is the name of the local hostand the counter goes from 0 to 9.However the maximal length of hostname is 23. If the name of local host is biggerthan 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 theautomatic mode is used).

Example 1MySIA.AdaptiveProcessingServer=RFC1

Example 2MySIA.DFServer1=RFC1;MySIA.DFServer2=RFC2;...

useBinaryXML When set to true, the data exchanged between the connector andthe SAP Netweaver BW server is compressed in binary XML formatinstead of plain text format. This improves performance. By defaultthe 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.forcedCapabi li ties Lets you artif icially limit the capabilities of the SAP NetWeaver BW

connector, if you want the data federation query engine to performoperations instead of SAP NetWeaver BW.Enter the capabilities that you want the data federation query engineto delegate to SAP NetWeaver BW.The valid values are as follows:

SCAN_ONLY the data federation query engine only delegatesscans to SAP NetWeaver BW.

PROJECTIONS_ONLY the data federation query engine onlydelegates projections to SAP NetWeaver BW.

empty - the data federation query engine delegates all valid operationsto SAP NetWeaver BW

jcoDestinationProperties

jcoServerProperties


10/18

10

authorityCheck Sets the parameter in SAP NetWeaver BW that indicates whether or not to check authorizations. The parameter in SAP NetWeaver BW specifieswhether SAP NetWeaver BW should do the following.

Should it check whether the user account is authorized to see therequested data (read) or should authorizations not be checked atall (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 0which means that there is no limit or the limit is unknown.

semiJoinMaxQueries 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 limitis unknown.

semiJoinExecutionStrategies

enableAuthorizationsFiltering When set to true, authorizations filtering is enabled: the connector will ensure thatfilters are automatically added to satisfy the SAP BI authorizations defined for thecurrent user. When the authorization filtering is disabled, the user will get an error ifhe tries to get unauthorized data. By default the value is false.

debugReportPrefixgatewayHostname 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 Destination

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_JCO_ + 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 stepsabove.


11/18

11

5 Exercise 4: Creating a relational Universe on top of SAP NetWeaver 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 Resourceswindow.4. Use a right-click on your server entry and use the menu Open Session

5. Enter your password6. Click OK7. Select the menu File New Data Foundation.8. EnterBI4Elite_BW_DATA_FOUNDATIONas 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 usingthe 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/18

12

16. ClickAdvanced.17. Ensure the optionAUTOMATICALL Y CREATES TABLES AND JOINSis 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 menu File New Bus iness Layer21. Select the entry Relational Data Source22. Click Next.23. EnterBI4Elite_BW_BusinessLayeras name for the Business Layer.24. Click Next.

25. Use the button and select the newly created Data Foundation - BI4Elite_BW_DATA_FOUNDATION .26. Click OK

27. Ensure the optionAutomaticall y create fo lders and objects for SAP NetWeaver BW connections(recommended) is activated.

28. Click Finish .


13/18

13

You are being presented with a l ist 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 InfoObjectsfrom 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 Country3. 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 thedimension object.

5. Use a right-click on the dimension Country (SAP NW Demo).


14/18

14

6. Select the menu New > Att ribute.

7. EnterCountry Keyas the Namefor the new attribute8. Now select the dimension object Country (SAP NW Demo).


15/18

15

9. Select the complete syntax from the SELECTbox and copy it to the clipboard.10. Now navigate back to the newly create attribute Country Key.11. Paste the copied syntax into the SELECTbox for the newly created attribute Country Key.12. Now select the attribute Country (SAP NW Demo) Heading.13. Select the complete syntax from the SELECTbox 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 SELECTbox 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 Time3. Navigate to the dimension Calendar Year4. Navigate to the tabAdvanced

5. Click6. Select Numeric


16/18

16

7. Click Custom Format8. Use the 0 option from the area Digitand add four times the item 0

9. Click OK10. Click OK11. Navigate to the dimension Calendar Year / Month12. Navigate to the tabAdvanced

13. Click14. Select Numeric

15. Click Custom Format16. Create a custom format like 0000 / 00.17. Click OK18. Click OK19. Select the menu File > Save All.20. Right-Click the newly generated Business Layer entry as part of your local project.21. Select the menu Publish > To a Repos itory22. Select the integrity checks you would like to perform.23. Click Next


17/18

17

24. Select a folder for the Universe.25. Click Finish .26. Click Close.27. Close the Information Design Tool


18/18

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 BusinessObjects 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 theirrespective 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. Crossgateis an SAP company.

All other product and service names mentioned are the trademarks of their respective companies. Data contained in this document servesinformational 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") forinformational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect tothe 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.

Documents

Ex_Setup Relational Universe for SAP BW