how to - use epm connector for xcelsius on bpc data

75
SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com © 2011 SAP AG 1 How to Use the EPM Connector to Visualize BPC Data via SAP Crystal Dashboard Design (Xcelsius Dashboards) Applies to: SAP BusinessObjects Planning and Consolidation 7.5, version for SAP NetWeaver. For more information, visit the Enterprise Performance Management homepage . Summary This how-to guide explains the steps to visualize BPC data using SAP Crystal Dashboard Design(formerly Xcelsius). In this guide, you will learn how to use SAP BusinessObjects Extended Analytics to build a report, and the SAP BusinessObjects EPM Connector to enhance the functionality of your dashboard. Author: Rich Heilman Company: SAP Labs, LLC Created on: 7 February 2011 Author Bio Rich Heilman is a Senior Technical Specialist with the SAP Enterprise Performance Management (EPM) Regional Implementation Group (RIG), at SAP Labs LLC. He is currently focused on the SAP BusinessObjects Planning and Consolidation, version for NetWeaver product. Previously, Rich was a member of the EPM Solution Management team at SAP where he worked on a wide range of topics related to the SAP BusinessObjects Planning and Consolidation product. Before joining SAP in 2007, he worked for an SAP customer as an ABAP Developer for 6 years. Rich is also the co-author of the SAP Press book, Next Generation ABAP Development.

Upload: xxyyzzua

Post on 24-Mar-2015

1.095 views

Category:

Documents


3 download

TRANSCRIPT

Page 1: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 1

How to Use the EPM Connector to

Visualize BPC Data via SAP Crystal

Dashboard Design (Xcelsius

Dashboards)

Applies to:

SAP BusinessObjects Planning and Consolidation 7.5, version for SAP NetWeaver. For more information, visit the Enterprise Performance Management homepage.

Summary

This how-to guide explains the steps to visualize BPC data using SAP Crystal Dashboard Design(formerly Xcelsius). In this guide, you will learn how to use SAP BusinessObjects Extended Analytics to build a report, and the SAP BusinessObjects EPM Connector to enhance the functionality of your dashboard.

Author: Rich Heilman

Company: SAP Labs, LLC

Created on: 7 February 2011

Author Bio

Rich Heilman is a Senior Technical Specialist with the SAP Enterprise Performance Management (EPM) Regional Implementation Group (RIG), at SAP Labs LLC. He is currently focused on the SAP BusinessObjects Planning and Consolidation, version for NetWeaver product. Previously, Rich was a member of the EPM Solution Management team at SAP where he worked on a wide range of

topics related to the SAP BusinessObjects Planning and Consolidation product. Before joining SAP in 2007, he worked for an SAP customer as an ABAP Developer for 6 years. Rich is also the co-author of the SAP Press book, Next Generation ABAP Development.

Page 2: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 2

Table of Contents

Business Scenario .............................................................................................................................................. 3

Background Information ...................................................................................................................................... 3

Prerequisites ....................................................................................................................................................... 3

Step-by-Step Procedure ..................................................................................................................................... 4

Installation ....................................................................................................................................................... 4

Build a Simple Dashboard .............................................................................................................................. 5

Enhance the Dashboard by Using Selectors ................................................................................................ 35

Add Write Back Functionality ........................................................................................................................ 45

Add Slider Components to Change Values .................................................................................................. 57

Related Content ................................................................................................................................................ 74

Copyright........................................................................................................................................................... 75

Page 3: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 3

Business Scenario

In this scenario, the business wants to view real-time data from their SAP BusinessObjects Planning and Consolidation, version for SAP NetWeaver (hereafter referred to as BPC_NW) system via a dashboard created by the SAP Crystal Dashboard Design tool (formerly called Xcelsius). Using a flash-based dashboard provides a zero footprint solution for viewing critical data in real-time. The dashboard user would not need anything more than flash player to view the data. This type of data visualization is very attractive to high level decision makers in the enterprise.

Background Information

This How-To guide provides a step-by-step instruction of how to build a dashboard that manipulates data stored in BPC_NW. The guide provides details about installing the required components, such as the SAP BusinessObjects EPM Connector and SAP BusinessObjects Extended Analytics. You will then start by building a simple dashboard which reads data from BPC_NW and presents it in a grid. You will then enhance this dashboard, by adding combo box selectors for dimension members, adding write back functionality, and finally, modifying the dashboard to incorporate sliders to change the values.

Prerequisites

Required/recommended expertise or prior knowledge

SAP BusinessObjects Planning and Consolidation 7.5, version for SAP NetWeaver,

SAP Crystal Dashboard Design (Formerly Xcelsius Enterprise 2008)

Additional Documentation

Other EPM How-To Guides

http://wiki.sdn.sap.com/wiki/display/BPX/Enterprise+Performance+Management+%28EPM%29

+How-to+Guides

Page 4: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 4

Step-by-Step Procedure

Installation

The following software is required to complete this How-To Guide. This software is required to build the dashboard only. For simply running and viewing the dashboard, only Flash Player is required. All software (except for the Microsoft Visual C++ component) can be downloaded from the SAP Service Marketplace. It is suggested to always apply the latest support package for each software component.

1) SAP BusinessObjects Extended Analytics 7.5 SP5 or higher 2) SAP Crystal Dashboard Design(formerly Xcelsius Enterprise 2008) SP3 or higher including hotfixes 3) SAP BusinessObjects EPM Connector 7.5, add-in for Xcelsius 4) SAP BusinessObjects Planning and Consolidation 7.5 Client 5) SAP BusinessObjects Planning and Consolidation 7.5 ODBO Client 6) Microsoft Visual C++ 2005 SP1 Redistributable Package(x86) 7) SAP BPCDataGrid component, add-in for Xcelsius

The step-by-step instructions of how to install these components is outlined in the BPC 7.5 Master Guide found on the SAP Service Marketplace.

http://service.sap.com/~form/sapnet?_SHORTKEY=01100035870000726399&_SCENARIO=01100035870000000202&_OBJECT=011000358700001106942009E

Additional information can be found in the EPM Connector User Guide on the Service Marketplace.

http://service.sap.com/~sapdownload/011000358700001297252009E/EPMConnector75_en.pdf

Page 5: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 5

Build a Simple Dashboard

In this section, you will build a dashboard which will retrieve BPC data at runtime and show this data via the BPC Data Grid. First you will use the Extended Analytics Analyzer plug-in to build your report definition. Next, you will create your dashboard layout and bind the user interface components to the report cells. Finally, you will use the EPM Connector plug-in to setup a connection to BPC which can be used to dynamically refresh the report at runtime. ...

1. Open SAP Crystal Dashboard Design(Xcelsius) and click on the “Analyzer” tab within the Excel sheet.

2. Click the “Edit Report” button.

Page 6: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 6

3. Click the “Add New…” button to create a new connection.

4. Select the “SAP BusinessObjects Planning and Consolidation” OLAP Data Source. Then click

“Connect”.

Page 7: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 7

5. Enter the BPC server name. Include both the host name as well as the port(<hostname>:<port>).

Also, enter the BPC user and password. This is the same user and password that you would used to

connect to BPC via the BPC Excel Client. Click “Next”.

6. Select the AppSet and click “Finish”.

Page 8: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 8

7. Select the Application (or Cube). In this case, PLANNING.

8. Next, supply a meaningful name for this connection and click “Ok”.

Page 9: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 9

9. Select the newly created connection, and click “Ok”.

10. The “Report Manager” dialog will then be launched. Here you can configure the report output.

Page 10: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 10

11. Drag and drop the P_ACCT.H1 node from the cube dimensions box into the “Row” box.

12. Drag and drop the TIME.H1 node from the cube dimensions box into the “Column” box.

Page 11: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 11

13. Drag and drop all remaining dimensions from the cube dimensions into the Page Header box.

14. Double click on the Time.TIME.H1 in the “Column” box.

Page 12: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 12

15. Select the members as shown below. Select the members by clicking the checkboxes, then clicking

the “Right-Arrow” key to move the selections into the selected members box. Then click “Ok”.

16. Double click on the P_ACCT.P_ACCT.H1 in the “Column” box.

Page 13: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 13

17. Select the members as shown below. Select the members by clicking the checkboxes, then clicking

the “Right-Arrow” key to move the selections into the selected members box. Then click “Ok”.

18. Double click on the Category.CATEGORY.H1 in the Page Header box.

Page 14: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 14

19. Select “ACTUAL” and click “Ok”.

20. Double click P_Activity.P_ACTIVITY.H1 in the Page Header box.

Page 15: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 15

21. Select “Line”, and click “Ok”.

22. Double click on P_CC.P_CC.H1 in the Page Header box.

Page 16: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 16

23. Select “US”, and click “Ok”.

24. Double click on P_DataSrc.P_DATASRC.H1 in the Page Header Box.

Page 17: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 17

25. Select “UPLOAD” and click “Ok”.

26. Double click RptCurrency.RPTCURRENCY.H1 in the Page Header box.

Page 18: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 18

27. Select “LC”, and click “Ok”.

28. Next, click “Ok” from the Report Manager dialog.

Page 19: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 19

29. The report is then generated in the excel spreadsheet. The values were retrieved from the BPC

system and statically stored in the excel sheet. Later, we will remove these values from the sheet, and

get the values from the BPC system dynamically at runtime.

30. Next, you will begin to build the layout of the dashboard. Drag and drop the BPC Data Grid

component from the components section on the left into the layout editor.

Page 20: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 20

31. You will notice the grid is then dropped into the editor, and the component property sheet is show on

the right side of the screen. Next you will use this property sheet to configure the grid and bind it to the

data in the excel sheet.

32. Click the button next to the input field for “Header Data”.

Page 21: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 21

33. Select the range of cells as shown in the image below and click “Ok”.

34. The columns of the grid have been configured based on the previous step. Next change the alignment

of each column, except for the first one, to right alignment.

Page 22: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 22

35. Next click on the button next to the input field for “Detail Data”.

36. Select the range of cells as shown below and click “Ok”.

Page 23: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 23

37. Check the checkbox for “Hide Empty Rows”.

38. Click the button next to the input field for “Selected Row”.

Page 24: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 24

39. Select the range of cells as shown below. Here you are binding this property to an empty row in the

excel sheet. When a row is selected in the grid at runtime, the values of that row will be placed in this

range of the excel sheet.

40. The final configuration of the BPC Data Grid should appear as shown below.

Page 25: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 25

41. The grid in the layout editor should now appear as shown below.

42. Next, drag and drop a Line Chart into the layout editor.

43. Click the button next to the input field for “Subtitle”.

Page 26: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 26

44. Select the cell as shown in the image below and click “Ok”. Remember this cell will be filled with the

selected row value of column 1 from the BPC Data Grid.

45. Enter the X and Y axis labels as shown below.

46. Under the “Data” section. Click the button next to the input field for “By Range”.

Page 27: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 27

47. Select the range of cells as shown below. Again, these cells will be filled at runtime when a row is

selected in the BPC Data Grid. These values will then be plotted on the Line Cart.

48. The layout editor should now look like this.

Page 28: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 28

49. The layout of the model is now finished. Next, you will add a new connection using the EPM

Connector. This connection will allow you to retrieve data from BPC at runtime, instead of getting the

values statically from the excel sheet. First, delete the values in the range of cells as show in the

image below.

50. In the appropriate cell, enter the command =GetReportDefinition() and hit enter. This command

retrieves the XML based definition of the Analyzer report and puts it in this cell. Later you will bind a

property of the EPM connector to this cell.

51. From the main menu, click “Data”, then “Connections”.

Page 29: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 29

52. The “Data Manager” dialog box will then appear. Click the “Add” button. Then select “EPM

Connector”.

53. Give a meaningful name for this connection.

Page 30: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 30

54. Next choose the EPM Application which you want to connect to. In this case, select “Planning and

Consolidation, version for SAP NetWeaver”.

55. Next, enter the host name of the BPC web server. Enter both the host name and port. Then click

“Connect”.

56. For the “Operation Type”, select “Retrieve data using Analyzer report”.

Page 31: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 31

57. At this point, you may be required to enter your BPC user name and password. Enter the user

name(including domain) and password and click “Ok”. You are connected when you see the “Data

Source” field filled in as shown below.

58. Click the button next to the input field for “Report Definition Cell”.

59. Select the cell where the Analyzer report definition resides and click “Ok”.

Page 32: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 32

60. The finished connection configuration should now look like this. Notice that the cell range for the

output has automatically been configured based on the Analyzer report definition. Click “Close”.

61. Drag and drop a “Connection Refresh Button” from the components list into the layout editor as shown

below.

Page 33: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 33

62. Configure the refresh button, by checking the connection in the refresh button property sheet.

63. The model is now complete. You can test it out by clicking the “Preview” button.

64. Once the dashboard is loaded, click the “Refresh” button.

Page 34: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 34

65. You will then be asked to enter the BPC user name and password. Then click “Ok”.

66. The live data will then be loaded into the dashboard. Select a line of the BPC Data Grid, and notice

that the Line Chart changes.

Page 35: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 35

Enhance the Dashboard by Using Selectors

In this section, we will enhance the model which you build in the previous section. You will add a combo box

selector to select the Category dimension member, which will change the report selection dynamically at

runtime, and retrieving a different slice of data from the backend server. Again, continue to use the previous

model in this section.

1. First, add the word “Category” to the excel sheet at cell A15. This is just a label so that you can know

where the dimension member values will be stored in the excel sheet.

2. From the main menu, click “Data”, then “Connections”.

3. Next, click “Add”, then “EPM Connector”.

Page 36: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 36

4. Give the new connection a meaningful name like “readCategoryMembers”.

5. For the EPM Application, choose “Planning and Consolidation, version for SAP NetWeaver”.

6. Enter the host name, and click “Connect”.

Page 37: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 37

7. For Operation Type, choose “Display Dimension Members”.

8. You will know that a connection has been made when the “Data Source” field is filled in. Also, defaults

for Application Set and Application will be filled as well. Change the Application Set to

APSHELL_HTG and the Application to PLANNING.

9. Next select the dimension that you want the members for, in this case, it is the Category dimension.

First, click the “Select a Member” button. Then open the “CATEGORY” node and select

“[CATEGORY].[PARENTH1]. Simply click out of this dialog to close it after the selection.

10. The selection should now show in the “Dimension Member” box.

Page 38: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 38

11. Next, click the icon next to the input field for “Insert In”.

12. Select the cell range as shown below. This range will contain the member values for the Category

dimension. Make sure to use two columns here.

13. The cell range selection should now show in the “Insert In” input field.

14. Next, close the “Data Manager” dialog.

Page 39: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 39

15. Next, you will add a “Selector” UI component which will allow you to switch member selection for the

CATEGORY dimension. Drag and drop the “Combo Box” UI component into the model layout editor.

16. In the property sheet for the Combo Box, add the labels by clicking the icon next to the input field for

“Labels”.

17. Select only the cell range as shown below. Note: only Column A is selected here.

Page 40: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 40

18. Add “Category” to the “Data Insertion” box, by simply typing into the “Name” box. Also, select “Row”

as the “Insertion Type”.

19. Next, click the icon next to the input field for “Source Data”.

20. Select the cell range as shown below. Note: both Columns A and B are selected here.

21. Click the icon next to the input field for “Destination”

Page 41: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 41

22. Select the cell range as shown below. Here you are saying that you want the selection of the Combo

Box to overwrite the value here in the spreadsheet. This value is used in the EA Analyzer report to

select data.

23. Click “Yes”.

24. The selection should now appear in the “Destination” box.

25. Click on the “Refresh” button in the layout editor.

Page 42: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 42

26. From the property sheet, click on the “General” tab. Check the checkbox next to

“readCategoryMembers”. Now when the “Refresh” button is pressed, it will trigger both connections.

27. Click on the “Combo Box” component in the layout editor.

28. From the property sheet, click the “Behavior” tab, and click the icon next to the input field for “Item”.

Page 43: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 43

29. Select the cell range as shown below. Here you are setting the default value of the Combo Box

selection to the hardcoded Category value of the report.

30. The selection should then show in the input field.

31. The model is now complete. You can test it out by clicking the “Preview” button.

Page 44: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 44

32. Click the “Refresh” button. Enter the user name and password, then click “Ok”.

33. The data is then populated, and the selected Category is filled in the Combo Box as well.

34. Next, click the Combo Box, and change to the “PLAN” category, then click “Refresh”. Notice that new

data has been populated in the grid based on the “Category” selection.

Page 45: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 45

Add Write Back Functionality

In this section, you will enhance the model further by adding write back functionality. Once again, you will use an EPM Connector connection to write back data from the BPCDataGrid component to the backend server.

1. Click on the BPCDataGrid component.

2. From the property sheet, change the “Editable“ values for the 2008.JAN, 2008.FEB, and 2008.MAR

columns to “True“. This will allow you to change the value in the grid.

3. Add the words “WriteBack Results” to the excel sheet at cell C15. This is just a label so that you can

know where the write back result values will be stored in the excel sheet.

Page 46: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 46

4. From the main menu, click “Data”, then “Connections”.

5. Next, click “Add”, then “EPM Connector”.

6. Give the new connection a meaningful name like “writeData”.

Page 47: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 47

7. For the EPM Application, choose “Planning and Consolidation, version for SAP NetWeaver”.

8. Enter the host name, and click “Connect”.

9. For Operation Type, choose “Enter and Save Data using Analyzer Report”.

10. Click the icon next to the input field for “Report Definition Cell“.

Page 48: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 48

11. Select the cell where you typed =GetReportDefinition() earlier and click “Ok“.

12. The selection should now appear in the input box.

13. Click the icon next to the input field for “Insert In“.

14. Select the cells as shown below and click “Ok“. These three cells will be filled with the number of cells

submitted, accepted, and rejected, in that order.

Page 49: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 49

15. Next, click the icon next to the input field for “Message In“.

16. Select the cell as shown below. The cell will be filled with any messages from the EPM Connector

connectio

17. Click “Close“.

Page 50: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 50

18. Drag and drop a “Label“ component to the layout editor.

19. Enter the label text as “Submitted“.

20. Repeat steps 18 and 19 for labels, “Accepted“, “Rejected“ and “Message“. The layout should now

look as shown below.

Page 51: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 51

21. Next, drap and drop an „“Input Text“ component into the layout, next to the “Submitted“ Label.

22. From the properties sheet, click the radiobutton for “Link to Cell“, then click on the icon next to the

input field.

23. Select the cell as shown below. Remember this value is filled by the writeData EPM Connector

connection. Click “Ok“.

24. Again, drap and drop an “Input Text“ component into the layout, next to the “Accepted“ Label.

Page 52: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 52

25. From the properties sheet, click the radiobutton for “Link to Cell“, then click on the icon next to the

input field.

26. Select the cell as shown below. Remember this value is filled by the writeData EPM Connector

connection. Click “Ok“.

27. Again, drap and drop an “Input Text“ component into the layout, next to the “Rejected“ Label.

28. From the properties sheet, click the radiobutton for “Link to Cell“, then click on the icon next to the

input field.

Page 53: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 53

29. Select the cell as shown below. Remember this value is filled by the writeData EPM Connector

connection. Click “Ok“.

30. Again, drap and drop an “Input Text“ component into the layout, next to the “Message“ Label. Extend

this field a bit to accomodate a longer message.

31. From the properties sheet, click the radiobutton for “Link to Cell“, then click on the icon next to the

input field.

Page 54: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 54

32. Select the cell as shown below. Remember this value is filled by the writeData EPM Connector

connection. Click “Ok“.

33. Drag and drop a “Connection Refresh Button“ component into the layout as shown below.

Page 55: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 55

34. From the property sheet, change the label of the button to “Save“. Then click the checkbox next to the

“writeData“ connection.

35. The model is now complete. You can test it out by clicking the “Preview” button.

Page 56: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 56

36. Click the “Refresh” button. Enter the user name and password, then click “Ok”.

37. Change some values in the grid, in this case, we have changed the values in the second row.

Page 57: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 57

38. Finally, click the “Save“ button. The connection will then pass the data from the grid to the backend,

and display the response as shown in the image below. Note that the the number of submitted cells is

9. Even though we only changed 3 cells, all cells are send back via the write back connection.

Add Slider Components to Change Values

In this section, you will add slider UI components which will change the values in the grid. There will be one slider for every cell within the grid. Each account will have a separate tab containing the slider for each month. Again, continue using the model which you have been working with throughout this guide.

1. First, adjust the line chart to handle multple accounts. Remove the binding for the “Subtitle“ field, by

clicking on the icon next to the input field.

2. Now, clear the binding and click “Ok“.

Page 58: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 58

3. Next, change the “Data“ section to insert “By Series“.

4. Create a series called CE0004010 binding the “Name“ property to the correct cell of the report. Click

the icon next to the input field.

5. Bind to the A8 cell in the report. This should be the cell containing the account CE0004010

6. Bind the “Values(Y)“ property to the detail data for the CE0004010 by clicking the button next to the

input field as shown in the image below.

Page 59: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 59

7. Select the range of cells as shown in the image below, then click “Ok“.

8. Create another Series by clicking on the “+“ sign.

9. Repeat steps 4 through 7 for the other two accounts, CE0004020 and CE0004030, binding to the

appropriate cells in the report. The final configuration for these accounts should be similar to the

below images.

10. Next, add a tab container to the layout by selecting it from the components list and dragging and

dropping it into the layout editor.

Page 60: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 60

11. Resize the Tab container so that extends to the bottom of the grid on the left side of the screen.

12. Click anywhere inside of the tab container, so that that individual tab is selected, and the property

sheet is shown at the right side of the screen.

13. Enter the value CE0004010 as the label.

Page 61: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 61

14. Next add another tab by clicking on the “+“ sign.

15. Enter CE0004020, and click “Ok“.

16. Add one final tab called CE0004030 by clicking on the “+“ sign.

17. Enter CE004030, and click “Ok“.

18. Next, click on the CE0004010 tab from within the layout editor. Make sure that the “Tab Set 1“ is

selected and is being show in the property sheet window on the right side of the screen.

Page 62: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 62

19. Next, click in the body of this tab. Make sure that the “Canvas 1“ is showing in the property sheet

window on the right side of the screen.

20. Next you will add UI components within this canvas within this tab, the CE0004010 tab. Select and

drag and drop the Vertical Slider component into the layout editor as shown below.

Page 63: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 63

21. Resize the slider as desired, but make sure to leave room at the top for the label, and to the right side

for the other two sliders you will add next.

22. From the property sheet of the slider, first set the Title as 2008.JAN by binding this property to the

appropriate cell(B7) of the excel spreadsheet. Also, bind the “Data“ property to the specific cell of the

report, cell B8. Finally, set the max limit to 20000.

Page 64: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 64

23. Create another slider, by selecting the first slider in the layout editor, and right-clicking on it. Then

choose, “Copy“.

24. Right click inside this canvas, and choose “Paste“.

Page 65: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 65

25. An exact copy has been inserted into the layout editor.

26. Modify this slider component to manipulate the data for 2008.FEB for the CE0004010 account. Bind

the “Title“ and “Data“ properties to the appropriate cells of the report, C7 and C8 respectively.

Page 66: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 66

27. Repeat steps 23 through 26 once again for the last slider in this tab. Modify this slider to manipulate

the data for 2008.MAR for the CE0004010 account. Bind the “Title“ and “Data“ properties to the

appropriate cells of the report, cells D7 and D8 respectively.

28. The configuration of the first account tab is complete. Next, we will copy the sliders from the first tab

into the second account tab. Select all three sliders by holding down CTRL and clicking each slider in

the layout, then right click and choose “Copy“.

Page 67: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 67

29. Next click the CE0004020 tab at the top. Make sure that “Tab Set 1“ is showing in the property sheet

window on the right.

30. Then click in the canvas of this tab. Make sure that Canvas 2 is showing in the property sheet window

on the right.

31. Right-click and choose “Paste“. You should now see the three sliders showing in the CE0004020 tab.

But these sliders are still configured to point to the CE0004010 account from the first tab. You must

now re-configure them for CE0004020.

Page 68: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 68

32. Click on the first slider component. Modify the “Data“ property to point to the appropriate cell for

account CE0004020 and 2008.JAN, cell B9.

33. Click on the second slider component. Modify the “Data“ property to point to the appropriate cell for

account CE0004020 and 2008.FEB, cell C9.

Page 69: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 69

34. Click on the third slider component. Modify the “Data“ property to point to the appropriate cell for

account CE0004020 and 2008.MAR, cell D9.

35. Repeat steps 28 through 34 for the third tab, account CE0004030. Make sure to bind the “Data“

property of each slider to the appropriate cell for the CE0004030 account within the report, cells B10,

C10, and D10. For example, the last slider for 2008.MAR on the third tab( account CE0004030 )

should be configured as shown below.

Page 70: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 70

36. The final layout should be similar to the image below.

37. The model is now complete. You can test it out by clicking the “Preview” button.

Page 71: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 71

38. Click the “Refresh“ button to refresh the data from the server. Enter the user name and password,

then click “Ok”.

39. The data is then shown in the line chart, the grid, and the slider components as well. Click through

each of the tabs in the tab strip. Notice that each slider represents a different cell within the grid

component. You can adjust the value in the grid, simply by sliding the slider component up or down.

Of course, after adjusting the values using the sliders, you can also write these values back simply by

clicking the “Save“ button.

Page 72: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 72

40. Finally, export the model to a Flash file by selecting File, Export, Flash(SWF).

41. Choose a destination and enter the file name and click “Save”.

Page 73: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 73

42. You can then simply send this SWF to a distribution list. The consumers only need to have a value

BPC user name and password. They are not required to have the BPC client installed, nor do they

require Extended Analytics Analyzer, nor Xcelsius. They simply need to have the flash player installed

on their local machine.

Page 74: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 74

Related Content

For more information, visit the Enterprise Performance Management homepage.

Page 75: How to - Use EPM Connector for Xcelsius on BPC Data

SAP COMMUNITY NETWORK SDN - sdn.sap.com | BPX - bpx.sap.com | BOC - boc.sap.com | UAC - uac.sap.com

© 2011 SAP AG 75

Copyright

© Copyright 2011 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, Excel, Outlook, and PowerPoint are registered trademarks of Microsoft Corporation.

IBM, DB2, DB2 Universal Database, System i, System i5, System p, System p5, System x, System z, System z10, System z9, z10, z9, iSeries, pSeries, xSeries, zSeries, eServer, z/VM, z/OS, i5/OS, S/390, OS/390, OS/400, AS/400, S/390 Parallel Enterprise Server, PowerVM, Power Architecture, POWER6+, POWER6, POWER5+, POWER5, POWER, OpenPower, PowerPC, BatchPipes, BladeCenter, System Storage, GPFS, HACMP, RETAIN, DB2 Connect, RACF, Redbooks, OS/2, Parallel Sysplex, MVS/ESA, AIX, Intelligent Miner, WebSphere, Netfinity, Tivoli and Informix are trademarks or registered trademarks of IBM Corporation.

Linux is the registered trademark of Linus Torvalds in the U.S. and other countries.

Adobe, the Adobe logo, Acrobat, PostScript, and Reader are either trademarks or registered trademarks of Adobe Systems Incorporated 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.

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.