45
26.27.4 Recalculate (recalculate)................................................. 337
26.27.5 Reset (reset)..........................................................337
26.27.6 Save (save)...........................................................338
26.28 PlanningFunction..............................................................338
26.28.1 Clear All Filters (clearAllFilters).............................................338
26.28.2 Clear Filter (clearFilter).................................................. 339
26.28.3 Copy Filters (copyFilters).................................................339
26.28.4 Execute (execute)......................................................340
26.28.5 Get Dimension Text (getDimensionText)......................................340
26.28.6 Get Dimensions (getDimensions)........................................... 341
26.28.7 Get Filter Ext (getFilterExt)................................................341
26.28.8 Get Filter Text (getFilterText).............................................. 341
26.28.9 Get Member List (getMemberList).......................................... 342
26.28.10 Set Filter (setFilter).....................................................343
26.28.11 Set Filter Ext (setFilterExt)................................................343
26.29 PlanningObjectWithVariables.....................................................344
26.29.1 Get Variable Value Ext (getVariableValueExt)...................................344
26.29.2 Set Variable Value Text (setVariableValueText)................................. 345
26.29.3 Set Variable Value (setVariableValue)........................................345
26.29.4 Set Variable Value Ext (setVariableValueExt)...................................346
26.30 PlanningSequence.............................................................347
26.30.1 Execute (execute)......................................................347
26.31 Popup..................................................................... 348
26.31.1 Hide (hide)...........................................................348
26.31.2 Is Showing (isShowing).................................................. 348
26.31.3 Show (show)..........................................................349
26.32 State...................................................................... 349
26.32.1 Set Personalization (setPersonalization)......................................349
26.32.2 Delete Personalization (deletePersonalization)................................. 350
26.33 String......................................................................350
26.33.1 Index Of (indexOf)......................................................350
26.33.2 Length (length)........................................................ 351
26.33.3 Split (split)............................................................351
26.33.4 Substring (substring)....................................................352
26.34 Tab....................................................................... 352
26.34.1 Get Text (getText)......................................................352
26.34.2 Is Enabled (isEnabled)...................................................353
26.34.3 Set Enabled (setEnabled).................................................353
26.34.4 Set Text (setText)......................................................353
26.35 Variable.................................................................... 354
26.36 Tabstrip....................................................................355
12
© 2014 SAP AG or an SAP affiliate company. All rights reserved.
Application Designer Guide: Designing Analysis Applications
Table of Contents
31
26.36.1 Get Selected Tab (getSelectedTabIndex)......................................355
26.36.2 Get Selected Tab Index (getSelectedTabIndex)................................. 355
26.36.3 Get Tab..............................................................355
26.36.4 On Select (onSelect).................................................... 356
26.36.5 Set Selected Tab (setSelectedTab)..........................................356
26.36.6 Set Selected Tab Index...................................................357
26.37 Text.......................................................................357
26.37.1 Get Text (getText)......................................................357
26.37.2 On Click (onClick)...................................................... 357
26.37.3 Set Text (setText)......................................................358
26.37.4 Variable............................................................. 358
27
Working with the Local Mode of the Design Tool.....................................360
27.1 Launching SAP BusinessObjects Design Studio........................................360
27.2 Creating New Analysis Applications.................................................361
27.3 Maintaining Settings in the Design Tool in Local Mode....................................362
27.4 Storage of Applications and Images................................................ 366
27.5 Selecting a Connection..........................................................367
27.5.1 Defining Connections to BI Backend Systems.................................. 368
27.6 Saving an Application Using a Different Name......................................... 369
27.7 Executing an Application........................................................ 370
27.8 Executing an Application on a Mobile Device.......................................... 370
27.9 Collecting Support Information in Local Mode..........................................371
28
Terminology Essentials........................................................372
29
Important Disclaimers on Legal Aspects...........................................373
Application Designer Guide: Designing Analysis Applications
Table of Contents
© 2014 SAP AG or an SAP affiliate company. All rights reserved.
13
26
1 About This Guide
1.1 About the Documentation Set
The documentation set for SAP BusinessObjects Design Studio comprises the following guides and online help
products:
Tip
The guides and tutorials are regularly updated and enhanced. Make sure that you have the latest version by
checking the SAP Help Portal on a regular basis.
Administrator Guide
The Administrator Guide contains detailed information, which users need in order to install, configure and manage
SAP BusinessObjects Design Studio. The guide is available on the SAP Help Portal at http://help.sap.com/boad
Application Designer Guide
The Application Designer Guide contains the conceptual information, procedures and reference material, which
application designers need in order to create analysis applications. The guide is available on the SAP Help Portal
at http://help.sap.com/boad
End User Guide
The End User Guide contains procedures and background information for users working with analysis
applications. This guide is available on the SAP Help Portal at http://help.sap.com/boad.
Developer Guide
The Developer Guide: Design Studio SDK contains procedures, reference material and background information,
which enables developers to create 3rd-party components with the Design Studio SDK and enhance the analysis
applications with custom components. The guide is available on the SAP Help Portal at http://help.sap.com/
boad.
14
© 2014 SAP AG or an SAP affiliate company. All rights reserved.
Application Designer Guide: Designing Analysis Applications
About This Guide
22
What's New Guide
The What's New Guide lists new and modified features in SAP BusinessObjects Design Studio that have been
implemented since the previous release. The guide is available on the SAP Help Portal at http://help.sap.com/
boad
Online Help
The Online Help contains the same information as the Application Designer Guide and the Developer Guide: Design
Studio SDK, plus an additional chart properties guide called Charts: Additional Information. Choose
Help
Help
Contents
to open the guides in the design tool. You can also set the online help as a view within the design tool.
Choose
View
Help
.
1.2 Who Should Read This Guide?
This guide is intended for application designers and users interested in building analysis applications using SAP
BusinessObjects Analysis Design Studio.
Application Designer Guide: Designing Analysis Applications
About This Guide
© 2014 SAP AG or an SAP affiliate company. All rights reserved.
15
43
2 Getting Started
2.1 What is SAP BusinessObjects Design Studio?
SAP BusinessObjects Design Studio enables application designers to create analysis applications and dashboards
- based on BW, SAP HANA and universe data sources - for browsers and mobile devices (iPads, for example). It is
the product of choice when full support for BW and HANA data models and engine capabilities is required. The
product offers a design tool that allows you to create applications easily and intuitively without the need for native
HTML and iPad UI programming skills.
SAP BusinessObjects Design Studio can be used locally and integrated in the following platforms:
●
SAP BusinessObjects Business Intelligence (BI platform)
●
SAP NetWeaver
●
SAP HANA
Note
In local mode, you can create demo analysis applications for evaluating SAP BusinessObjects Design Studio
with users at customer locations.
Besides analysis applications, application designers can also create planning applications that support both
manual and automated data entry and changes to data. The application user can enter the planning data manually
in the crosstab (in cells or rows) or use planning functions and planning sequences (also known as planning
objects) in SAP NetWeaver BW Integrated Planning to enter data automatically. For planning data, you have to
use a BW backend system as the planning system..
For creating planning applications, the following conditions must be met:
●
The design studio is used with BI Platform or SAP NetWeaver as the platform
●
A BW back end system is used as the planning system
●
A BW query or query view, which is defined as a planning query in the BEx Query Designer, is used as a data
source
●
A desktop browser application is used as planning application
In addition to the standard palette of components in Design Studio, which are used to visualize data and enable
user interaction, you can develop 3rd party components with the Design Studio SDK and enhance your analysis
applications with custom components. You can store and provide access to the analysis applications containing
the 3rd party components on any of the supported platforms.
Related Information
Working with the Local Mode of the Design Tool [page 360]
Creating Planning Applications [page 78]
16
© 2014 SAP AG or an SAP affiliate company. All rights reserved.
Application Designer Guide: Designing Analysis Applications
Getting Started
32
2.2 Basic Concepts
Entities
The design tool of SAP BusinessObjects Design Studio enables application designers to create and edit
applications. These applications are saved in an XML file format. Applications generally consist of user interface
components (such as charts, crosstabs, buttons) and data source aliases.
Data source and data source alias
A data source alias represents an instance of a data source (for example, a BW query, or a SAP HANA data
source) at runtime of the application. A single application can contain multiple instances of one data source. Every
instance, for example, can apply its own filters on the same data source and thus represents its own subset of
data. You can see the list of components and data source aliases used in an application in the outline view of the
design tool.
Data binding
To visualize data from a data source alias in a crosstab or chart, define a data binding in the design tool for these
components. The data binding is simply a reference to the data source alias which provides the data. When the
data of a data source alias changes (for example, a filter is applied at runtime), the system automatically updates
all components that have a data binding to that data source alias. You can also see the data binding relationships
between components and data source aliases in the outline view
User interaction
Typically you create applications that not only visualize data, but which also provide possibilities for the
application user to interact with the data; for example, changing filters, selecting drill-down dimensions or
branching into a details view for a selected set of aggregated data. To enable user interaction with the data, add
the relevant UI components to the application. For example, you could provide a row of buttons above a crosstab
and chart component to filter the visualized data by different criteria.
Eventing and script API
UI components provide a set of specific events that the application user can execute on the component. For
example, every button provides an on click event. You can see a list of all available events of the component in the
properties view of the design tool. Here, you can open the script editor and specify which actions should take
place when the application user triggers the event. The script language is a subset of JavaScript and allows a
Application Designer Guide: Designing Analysis Applications
Getting Started
© 2014 SAP AG or an SAP affiliate company. All rights reserved.
17
47
sequence of script API method calls to be defined. The script API provides access at runtime to the application
itself as well as to its components and data source aliases. Therefore, the application designer has flexible control
of the application behavior by using event scripts.
Setting properties in design time and run time
Besides the events, components also offer a variety of other properties in the properties view of the design tool.
Some properties are common for all or almost all components; the component name identifies the component
within the application, for example, and the layout properties define the size and position of the component within
the application. Other properties are specific and depend on the component type. In all cases, the property values
displayed in the properties view define the initial state of the components at application startup time. At
application runtime, you can enable modification of properties by executing event scripts, as almost all
component properties are accessible through the script API.
2.3 Launching SAP BusinessObjects Design Studio
Procedure
1. To launch SAP BusinessObjects Analysis Design Studio, choose
Start
All Programs
SAP Business
Intelligence
SAP BusinessObjects Design Studio
Design Studio
.
2. Depending on the mode you log on (BI Platform, SAP NetWeaver, SAP HANA or local), perform the following
steps.
Option
Description
BI Platform
1. In the Logon to SAP BusinessObjects BI Platform dialog box, type in your user name for the BI
Platform.
2. Type in your password for the BI Platform.
3. When you launch the design studio for the first time, type in the host and port into the Web Service
URL. For futher information, contact your system administration.
4. Select the authentication.
5. Click OK.
Note
Once you have entered the host and port in the Web Service URL, this information is stored by the
system and you do not have to type it again.
SAP
NetWeaver
1. In the Logon to SAP NetWeaver dialog box. When you launch the design studio for the first time,
select the BW system from the dropdown box.
Note
You can only select a system from the dropdown box, if you have added the system in your SAP
Logon dialog box.
18
© 2014 SAP AG or an SAP affiliate company. All rights reserved.
Application Designer Guide: Designing Analysis Applications
Getting Started
40
Option
Description
2. Type in the client for the system.
3. Type in your user for the system.
4. Type in your password for the system.
5. Type in the language you prefer.
6. Click OK.
Note
Once you have entered the system and and, this information is stored by the system and you do not
have to type it again.
SAP HANA
1. In the Logon to SAP HANA dialog box, type in your user name for the SAP HANA system.
2. Type in your password for the SAP HANA system.
3. When you launch the design studio for the first time, type in the XSEngine URL which consist of
http:// <server>:<port>
. For futher information, contact your system administration.
Local
The design studio is launched immediately, and you do not have to enter any user credentials.
Results
The design tool is launched with the welcome page.
Note
If you want to switch form a platform mode to the local mode (for example, from the BI platform to the local
mode) during logon, click Skip on the logon dialog box of the BI platform.
Related Information
Starting with the Welcome Page [page 19]
2.4 Starting with the Welcome Page
When you start SAP BusinessObjects Design Studio for the very first time, the welcome page is displayed. The
welcome page consists of different sections described below:
●
Getting Started: Enables you to learn how to use the design tool of SAP BusinessObjects Design Studio by
providing access to tutorials. These are videos and How To documents that guide you through essential and
basic tasks and concepts of the solution and help you to familiarize yourself with the design tool and its
features .
●
Create New: Enabes you to create a new analysis application. You can select different templates that are
optimized for desktop Web browser applications or mobile applications. You can choose between blank
Application Designer Guide: Designing Analysis Applications
Getting Started
© 2014 SAP AG or an SAP affiliate company. All rights reserved.
19
35
templates or predefined templates which correspond to various design and business needs. If you choose a
predefined template, the system automatically creates a copy of this template. You can change your copy
according to your needs.
●
Recently Used Analysis Applications: Enables you to open recently-used applications.
●
Useful Links: Enables you to find further useful information about the solution, for example, SAP Community
Network and SAP Help Portal.
Note
When you want the welcome page to be displayed every time the design tool is started, select the Always show
the Welcome page on startup checkbox.
On the right bottom corner of the welcome page you will find buttons for social media. Clicking a button launches
the Web browser and opens the relevant social media website.
Related Information
Creating New Analysis Applications [page 361]
2.5 Working with the Design Tool
Before you start creating applications, take a moment to familiarize yourself with the interface. The design tool
includes a layout editor, the Components, Outline and Properties views, a menu and a toolbar. You can show or
hide the views or move them to other screen positions.
Related Information
Components View [page 20]
Outline View [page 22]
Properties View [page 22]
Layout Editor [page 23]
Managing Logs in the Design Tool [page 158]
Maintaining Settings in the Design Tool [page 23]
Storage of Applications and Images [page 366]
Activating Runtime Traces [page 154]
2.5.1 Components View
The Components view contains all components that you can use for creating analysis applications. Components
are user interface elements that you can drag and drop into the layout editor and thus create the content of the
20
© 2014 SAP AG or an SAP affiliate company. All rights reserved.
Application Designer Guide: Designing Analysis Applications
Getting Started
Documents you may be interested
Documents you may be interested
