Administrator Guide SAP BusinessObjects Design Studio

SAP BusinessObjects Design StudioDocument Version: 1.0 SP02 - 2013-03-01

Administrator Guide: SAP BusinessObjects Design Studio

Table of Contents

1 About this Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51.1 About the documentation set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51.2 Who should read this guide?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51.3 Related guides and documentation sets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2 Getting Started. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82.1 What is SAP BusinessObjects Design Studio?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82.2 Key components of SAP BusinessObjects Design Studio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8

3 Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103.1 Analysis Application Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

3.1.1 System requirements for the Analysis Application Service. . . . . . . . . . . . . . . . . . . . . . . . . . .103.1.2 Choosing an installation for your operating system. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

3.2 Design Tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163.2.1 System requirements for the design tool installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163.2.2 Installing the design tool of SAP BusinessObjects Design Studio. . . . . . . . . . . . . . . . . . . . . . 163.2.3 Updating the design tool installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173.2.4 Uninstalling the design tool of SAP BusinessObjects Design Studio. . . . . . . . . . . . . . . . . . . . .18

4 Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194.1 Creating and managing data source connections in SAP BusinessObjects Business Intelligence. . . . . . . 19

4.1.1 Creating BW system connections. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204.1.2 Creating SAP HANA system connections. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .204.1.3 Reloading connections in the design tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

4.2 Maintaining settings on the BI platform. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214.2.1 Checking the status of the Analysis Application Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . 224.2.2 Maintaining the maximum number of client sessions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224.2.3 Creating a user group and adding view rights. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

4.3 Configuration tasks for mobile usage of analysis applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234.3.1 Creating the mobile category on the BI platform. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .244.3.2 Assigning analysis applications to the mobile category. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

4.4 Providing the Web Service URL to application designers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244.5 Maintaining settings in the design tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244.6 Sizing Guidelines. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264.7 More Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27

5 Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285.1 User management and authentication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

2© 2013 SAP AG or an SAP affiliate company. All rights reserved.

Administrator Guide: SAP BusinessObjects Design StudioTable of Contents

5.2 Authentication and Single Sign-On. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285.3 Authorizations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295.4 Network and communication security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

5.4.1 Communication at design time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305.4.2 Communication at runtime. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

5.5 Data storage security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .335.6 Security for additional applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345.7 General security recommendations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34

6 Language and Regional Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356.1 Language of the design tool texts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356.2 Language of master data and metadata. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .356.3 Language of message texts and tooltips in analysis applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

6.3.1 Supported languages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .366.4 Regional formats for numbers, dates and times. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

6.4.1 Formatting of date and time with SAP HANA data sources. . . . . . . . . . . . . . . . . . . . . . . . . . .376.5 Business case: Defining English as the preferred language of an analysis application. . . . . . . . . . . . . . . 38

7 Lifecycle Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397.1 Working with analysis applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397.2 Working with images. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427.3 Working with data source connections. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427.4 Managing access rights. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437.5 Transporting analysis applications, images and data source connections. . . . . . . . . . . . . . . . . . . . . . . 44

8 Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458.1 Activating runtime traces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458.2 Activating SAP JCo traces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458.3 Downloading analysis applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468.4 Collecting support information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468.5 Error analysis in scripting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468.6 Problems with connections. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .478.7 Managing logs in the design tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478.8 Managing logs on the BI platform. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

9 Administering Local Mode in the Design Tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489.1 Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489.2 Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

9.2.1 Defining connections to BI back-end systems in local mode. . . . . . . . . . . . . . . . . . . . . . . . . .499.2.2 Maintaining settings in the design tool in local mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

9.3 Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519.3.1 User management and authentication in local mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519.3.2 Authentication and Single Sign-On in local mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51


© 2013 SAP AG or an SAP affiliate company. All rights reserved. 3

9.3.3 Authorizations when using local mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529.3.4 Network and communication security in local mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529.3.5 Data storage security in local mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539.3.6 Data access security in local mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

9.4 Language and regional settings in local mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .549.5 Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

9.5.1 Collecting support information in local mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54



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:

TipThe 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 GuideThe Administrator Guide contains detailed information that a user needs to install, configure and manage SAP BusinessObjects Design Studio. The guide is available on the SAP Help Portal.

Application Designer GuideThe Application Designer Guide contains the conceptual information, procedures and reference material that an application designer needs to create analysis applications. The guide is available on the SAP Help Portal.

Online HelpThe online help contains the same information as the Application Designer Guide and the Administrator Guide. Click Help Help Contents to open the guides in the design tool.

1.2 Who should read this guide?

This guide is intended for system administrators. To manage SAP BusinessObjects Design Studio, you need administrator rights on the local machines where the design tool of SAP BusinessObjects Design Studio is installed, on the connected SAP NetWeaver Business Warehouse systems, and on the connected SAP HANA systems. You also need the Administrator user in the BI platform for managing integration with the BI platform.

1.3 Related guides and documentation sets

This guide contains references to additional guides and documentation sets for further details on specific tasks.The following list will help you to find the related guides on the SAP Help Portal at http://help.sap.com/bobip40:

Administrator Guide: SAP BusinessObjects Design StudioAbout this Guide


http://help.sap.com/bobip40

Related Guide Location

Business Intelligence Platform Installation Guide Installation, Upgrade, Deployment

Business Intelligence Platform Administrator Guide System Administration and Maintenance Information

Business Intelligence Platform Web Application Deployment Guide

Installation, Upgrade, Deployment

Lifecycle management console for SAP BusinessObjects Business Intelligence 4.0 User Guide

System Administration and Maintenance Information

The related guide is located on the SAP Help Portal at http://help.sap.com/boaolap40:


SAP BusinessObjects Analysis, edition for OLAP Administrator Guide

System Administration and Maintenance Information

The following list will help you to find the related guides on the SAP Help Portal at http://help.sap.com/nw731 :


Security Guide for SAP NetWeaver BW Application Help SAP NetWeaver Security Guide

Security Guides for SAP NetWeaver Functional Units

Chapter “Transport Layer Security” and chapter “Network and Communication Security” in the SAP NetWeaver Security Guide

Application Help SAP NetWeaver Security Guide

Network and Communication Security

SAP NetWeaver Library , chapter “Identity Management” Application Help SAP NetWeaver Library: Function-

Oriented View Security Identity Management

SAP NetWeaver Library , chapter “Authorizations” in the “Business Warehouse” section

Application Help SAP NetWeaver Library: Function-

Oriented View Business Warehouse Data Warehousing

Data Warehouse Management Authorizations

SAP NetWeaver Library , chapter “Trace Tool Environment” in the “Business Warehouse” section

Application Help SAP NetWeaver Library: Function-

Oriented View Business Warehouse Generic Tools and

Services Test and Trace Tools

The following list will help you to find the related guides on the SAP Help Portal at http://help.sap.com/hana_appliance:


SAP HANA Security Guide Security Information SAP HANA Overall Security Guide

SAP HANA Database - Client Installation and Update Guide Installation and Upgrade Information SAP HANA

Database Installation Guides

The related guide is located on the SAP Help Portal at http://help.sap.com/bomobileios:


Administrator and Report Designer's Guide: SAP BusinessObjects Mobile for iOS 4.4.18

Installation, Administration and Report Designing Information



http://help.sap.com/boaolap40

http://help.sap.com/nw731

http://help.sap.com/hana_appliance


http://help.sap.com/bomobileios

The related guide is located in the design tool of SAP BusinessObjects Design Studio:


Chapter “Problems view ” in the Workbench User Guide Help Help Contents Workbench User Guide

Concepts Views Problems view



2 Getting Started

2.1 What is SAP BusinessObjects Design Studio?

SAP BusinessObjects Design Studio enables application designers to create analysis applications and dashboards for browsers and mobile devices on top of BW and SAP HANA data sources. 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 in an easy and intuitive way without the need for native HTML and iPad UI programming skills.SAP BusinessObjects Design Studio can be used both locally and integrated in the BI platform. In local mode, you can create first analysis applications for presenting and evaluating SAP BusinessObjects Design Studio with users at customer side.Related LinksAdministering Local Mode in the Design Tool [page 48]

2.2 Key components of SAP BusinessObjects Design Studio

This section provides an overview of all required and optional software components and supporting systems used by SAP BusinessObjects Design Studio:

Component Relevance

SAP BusinessObjects Business Intelligence platform Used as the central content management system for analysis applications, and as a platform for managing OLAP data source connections that are required for communication with SAP HANA systems or SAP NetWeaver BW systems.

BI launch pad Installed with the BI platform. Used to access analysis applications and organize them to suit the users' preferences.Provides access to various applications (if you have the appropriate licenses and access rights), for example:

● analysis applications● BEx Web applications● BI workspaces● SAP Crystal Reports

SAP BusinessObjects Mobile Mobile solution that provides access to various BI content types in a single mobile app. The BI content supported by this mobile app includes analysis applications created with SAP BusinessObjects Design Studio, Web Intelligence, Interactive Crystal Reports and Dashboards.


Administrator Guide: SAP BusinessObjects Design StudioGetting Started

Component Relevance

Analysis Application Service for SAP BusinessObjects Design Studio

BI platform add-on installation, which makes it possible to display and execute analysis applications in the BI launch pad. It also allows communication between the design tool and the BI platform in order to save and launch analysis applications in the design tool.

Design tool of SAP BusinessObjects Design Studio Tool for creating analysis applications, which can be published and shared using the BI launch pad.

SAP NetWeaver Business Warehouse Used as a backend system, providing the business data for data analysis in analysis applications.

SAP HANA Used as a backend system, providing the business data for data analysis in analysis applications.

Administrator Guide: SAP BusinessObjects Design StudioGetting Started


3 Installation

SAP BusinessObjects Design Studio consists of the following components to be installed:

Component Description

Analysis Application Service setup for SAP BusinessObjects Design Studio

BI platform add-on installation, which makes it possible to display and execute analysis applications in the BI launch pad. It also allows communication between the design tool and the BI platform in order to save and launch analysis applications in the design tool. The Analysis Application Service setup has to be installed on the host machine(s) with the BI platform server.

Design tool setup of SAP BusinessObjects Design Studio Tool for creating analysis applications, which can be stored on the BI platform and shared using the BI launch pad. The design tool has to be installed on the client machines of the application designers who create the analysis applications.

3.1 Analysis Application Service

3.1.1 System requirements for the Analysis Application ServiceSAP BusinessObjects Business Intelligence platform 4.0 must be correctly installed before the Analysis Application Service for SAP BusinessObjects Design Studio can be installed on the BI platform. Make sure that the following conditions are met:

You have administrative rights on the machine.The machine has a 64-bit operating system.

A list of all supported operating systems and Web browsers for SAP BusinessObjects Design Studio is available in the Product Availability Matrix (PAM) on SAP Service Marketplace at http://service.sap.com/pam where you can enter SBOP DESIGN STUDIO in the search field to retrieve the information.The Analysis Application Service setup consists of the following features:

Setup Feature Description

Analysis Application Web Components This feature makes it possible to display analysis applications in the BI launch pad, and use OpenDocument links in order to send direct links of analysis applications to other recipients. It also allows communication between the design tool and the BI platform in order to save and launch analysis applications.

Analysis Application Service This feature includes the Analysis Application Service running in the Adaptive Processing Server. The Analysis Application Service makes it possible to execute analysis applications.


Administrator Guide: SAP BusinessObjects Design StudioInstallation

http://service.sap.com/pam

Setup Feature Description

Analysis Application support for Mobile Services This feature adds mobile support to analysis applications, integrating analysis applications into SAP BusinessObjects Mobile. It allows application users to access analysis applications on mobile devices, such as the iPad.

You can install the features of the Analysis Application Service setup on different host machines. Depending on the host machine and the components installed on it, optional pre-requisites might become mandatory.The following components need to be installed:

Required Component Description

BI Platform Server The minimum version required is SAP BusinessObjects Business Intelligence platform 4.0 Support Package 4 Patch 3.

Adaptive Processing Server The setup feature Analysis Application Service requires Adaptive Processing Server to be installed. If you install this setup feature on your machine, the optional component Adaptive Processing Server becomes mandatory.

Multidimensional Analysis Service This setup feature is necessary for creating OLAP connections.

BI Platform Web Applications The setup feature Analysis Application Web Components requires BI platform Web applications to be installed. If you install this setup feature on your machine, the optional component BI Platform Web Applications becomes mandatory.

Mobile Services The setup feature Analysis Application support for Mobile Services requires Mobile Services to be installed. If you install this setup feature on your machine, the optional component Mobile Services becomes mandatory. The component Mobile Services is necessary to integrate analysis applications to the SAP BusinessObjects Mobile solution.

NoteMobile Services is available with SAP BusinessObjects Business Intelligence platform 4.0 Support Package 5. If you use a lower release version of SAP BusinessObjects Business Intelligence platform, the installation wizard displays a note informing you that the necessary requirements for Mobile Services are not met.

Before installing the Analysis Application Service on the BI platform, see the following guides for information relevant to your deployment:

Business Intelligence Platform Installation Guide Business Intelligence Platform Administrator Guide Business Intelligence Platform Web Application Deployment Guide

The guides are available on the SAP Help Portal at http://help.sap.com/bobip40.

3.1.2 Choosing an installation for your operating systemThe installation procedure you follow depends on the operating system on your host machines.




Related LinksInstalling the Analysis Application Service on Microsoft Windows [page 12]Installing the Analysis Application Service on UNIX [page 14]

Installing the Analysis Application Service on Microsoft Windows1. Go to SAP Service Marketplace at http://service.sap.com SAP Support Portal Software Downloads

Installations and Upgrades .

Note

Support packages and patches are available under SAP Support Portal Software DownloadsSupport Packages and Patches .

2. In the A - Z Index, click D.The SAP BusinessObjects Design Studio BI platform add-on installation is available for download at SBOP DESIGN STUDIO 1.0.

3. Under Comprised Software Component Versions, choose DESIGN STUDIO BIP ADD ON 1.0 Windows on x64 64bit .

4. Download the zip file for win64 and extract it.For more information, see SAP Note 1760409.

5. Double-click setup.exe.

6. Select a setup language. This is the language for the installation wizard.7. Click OK.8. If necessary, resolve the critical pre-requisites issues before continuing the installation.

NoteDepending on the host machine and the components installed on it, optional pre-requisites might become mandatory. The BI platform Web applications are mandatory for example if you want to install the analysis application Web components on this machine (see step 12).

9. Click Next.10. In the welcome dialog box, click Next.11. Read and accept the License Agreement, then click Next.

The detected directory is based upon your SAP BusinessObjects Business Intelligence platform installation directory. You can not install Analysis Application Service in an alternative directory.

NoteThe default path is C:\Program Files (x86)\SAP BusinessObjects\.

12. Click Next.13. Select the components to install.

Depending on your system landscape you can install the following components:



http://service.sap.com

Option Description

Full Installation The full installation includes all features: Analysis Application Web Components, Analysis Application Service and Analysis Application support for Mobile Devices.

Analysis Application Web Components

This feature makes it possible to display analysis applications in the BI launch pad, and use OpenDocument links in order to send direct links of analysis applications to other recipients. It also allows communication between the design tool and the BI platform in order to save and launch analysis applications.

Analysis Application Service

This feature includes the Analysis Application Service running in the Adaptive Processing Server. The Analysis Application Service makes it possible to execute analysis applications.

Analysis Application support for Mobile Services

This feature adds mobile support to analysis applications, integrating analysis applications to SAP BusinessObjects Mobile. It allows application users to access analysis applications on mobile devices, such as the iPad.

NoteThe setup feature Analysis Application support for Mobile Services requires Mobile Services to be installed. Mobile Services is available with SAP BusinessObjects Business Intelligence platform 4.0 Support Package 5. If you use a lower release version of SAP BusinessObjects Business Intelligence platform, this setup feature is not available as an option in this installation step.

14. Click Next.15. Enter your CMS logon credentials:

○ CMS name○ CMS port number○ Password of the CMS Administrator user

16. Click Next.17. Click Next to start the installation.18. Check whether you have to perform the following post-installation step:

BI platform Web applications have been changed by this installation. You need to deploy Web applications to all your Web application server nodes manually with the WDeploy tool in the following cases:

You have multiple Web application server nodes.You do not use the default Tomcat.You do not use Web Application Container Service (WACS).

The WDeploy tool automates the deployment of Web applications to supported Web application servers. For more information, see the Business Intelligence Platform Web Application Deployment Guide on the SAP Help Portal at http://help.sap.com/bobip40.

19. Click Next.20. If you want to launch the WDeploy tool after installation, select the Automatically launch WDeploy tool after

install checkbox.21. Click Finish.

After installing Analysis Application Web Components and Analysis Application Service on either one or two host machines, the Analysis Application Service for SAP BusinessObjects Design Studio has been completely installed. It enables the CMS to recognize analysis applications. Together with the installed design tool of SAP BusinessObjects Design Studio it is possible to save, open and execute analysis applications.




If you have also installed Analysis Application support for Mobile Services application users can view analysis applications on mobile devices, using the SAP BusinessObjects Mobile solution.Running a silent installationYou can set every option in the installation wizard from the command-line. This type of installation is known as a silent install. Installation options can be given directly on the command-line as a parameter, or can be stored in a response file.For complete instructions on the silent install procedure, refer to the silent installation section of the Business Intelligence Platform Installation Guide on the SAP Help portal at http://help.sap.com/bobip40.Modifying, repairing or removing the Analysis Application Service

You have installed the Analysis Application Service for SAP BusinessObjects Design Studio on the BI platform.

You can repair, modify or remove this installation.

1. In the Windows Control Panel, choose Programs and Features.A list of installed applications appears.

2. Double-click SAP BusinessObjects Design Studio Analysis Application Service.3. In the Application Maintenance dialog box, select the required option:

Option Description

Modify Allows you to change the selected components (Full Installation, Analysis Application Web Components, Analysis Application Service and Analysis Application support for Mobile Services).

Repair Reinstalls the Analysis Application Service for SAP BusinessObjects Design Studio, according to the already set parameters.

Remove Uninstalls the Analysis Application Service for SAP BusinessObjects Design Studio from this machine.

4. Click Next.5. Depending on your selection in the Application Maintenance dialog box, proceed as follows:

○ To modify the installation, change the selected components as required and proceed with the installation steps.

○ To repair the installation, enter your CMS logon credentials and proceed with the installation steps.○ To remove the installation, click Next, enter your CMS logon credentials and click Finish.

The Analysis Application Service for SAP BusinessObjects Design Studio has now been modified, repaired or uninstalled.

Installing the Analysis Application Service on UNIX1. Go to SAP Service Marketplace at http://service.sap.com SAP Support Portal Software Downloads

Installations and Upgrades .

Note


2. In the A - Z Index, click D.The SAP BusinessObjects Design Studio BI platform add-on installation is available for download at SBOP DESIGN STUDIO 1.0.

3. Under Comprised Software Component Versions, choose DESIGN STUDIO BIP ADD ON 1.0 Linux on x86_64 64bit (or AIX 64bit or Solaris on SPARC 64bit).





4. Download the zip file for your platform and extract it.For more information, see SAP Note 1760409.

5. Launch setup.sh.

6. Select the current language for the installation.7. Specify the destination folder for the installation. This must be the same installation folder that contains SAP

BusinessObjects Business Intelligence platform 4.0.A pre-requisites check screen appears. If the installer detects that critical and optional installation pre-requisites are missing, a list of missing components appears.

8. If necessary, resolve the critical pre-requisites issues before continuing the installation.The following screens appear:

Welcome to the installation wizard for Analysis Application Service for SAP BusinessObjects Design Studio 1.0SAP BusinessObjects License Agreement

9. Once you have read the agreement, press ENTER to accept.10. Press SPACE to expand the feature tree and select the features you want to install on the directory you

specified:

○ Full Installation○ Analysis Application Web Components○ Analysis Application Service○ Analysis Application support for Mobile Services

11. Press ENTER.12. In the Existing CMS Deployment Information screen, enter the following information:

○ CMS Name○ Port Number○ User Name○ Password

13. Press ENTER.14. To start the installation, press ENTER.15. Check whether you have to perform the following post-installation step:

BI platform Web applications have been changed by this installation. You need to deploy Web applications to all your Web application server nodes manually with the WDeploy tool in the following cases:

You have multiple Web application server nodes.You do not use the default Tomcat.You do not use Web Application Container Service (WACS).

The WDeploy tool automates the deployment of Web applications to supported Web application servers.16. Press ENTER.17. To exit the installation, press ENTER.18. If necessary, start the WDeploy tool to deploy the affected Web applications to the Web application servers.

For more information, see the Business Intelligence Platform Web Application Deployment Guide on the SAP Help Portal at http://help.sap.com/bobip40.

After installing Analysis Application Web Components and Analysis Application Service on either one or two host machines, the Analysis Application Service for SAP BusinessObjects Design Studio has been completely installed.




It enables the CMS to recognize analysis applications. Together with the installed design tool of SAP BusinessObjects Design Studio it is possible to save, open and execute analysis applications.If you have also installed Analysis Application support for Mobile Services application users can view analysis applications on mobile devices, using the SAP BusinessObjects Mobile solution.Uninstalling the Analysis Application Service on UNIX

1. To uninstall the Analysis Application Service, launch setup.sh.

2. Select the current language of the installation.3. Specify the destination folder of the installation. This must be the same installation folder that contains SAP

BusinessObjects Business Intelligence platform 4.0.4. To move to the field Remove, press TAB.5. Press ENTER.6. To confirm the uninstallation, press ENTER.7. In the Existing CMS Deployment Information screen, type the following information:

○ CMS Name○ Port number○ User Name○ Password

8. Press ENTER.9. To exit the uninstallation, press ENTER.

The Analysis Application Service is removed from your system.

3.2 Design Tool

3.2.1 System requirements for the design tool installationBefore installing the design tool of SAP BusinessObjects Design Studio, make sure that the following components are installed on the local machines of the application designers:

32-bit version of Java Runtime Environment 1.6 or 1.7 (http://java.com/en/download/index.jsp)Internet Explorer 9.0

During installation, the SAP BusinessObjects Design Studio setup checks whether Microsoft redistributable runtime DLLs VS2010 SP1 (x86) is installed. If it is not installed, the setup installs this component automatically.We recommend installing the design tool on a machine with SAP GUI installed. Otherwise problems might occur with connections to SAP NetWeaver BW systems that communicate through a message server.A list of all supported operating systems and Web browsers for SAP BusinessObjects Design Studio is available in the Product Availability Matrix (PAM) on SAP Service Marketplace at http://service.sap.com/pam where you can enter SBOP DESIGN STUDIO in the search field to retrieve the information.For more information about the system requirements, see SAP Note 1698927.

3.2.2 Installing the design tool of SAP BusinessObjects Design StudioThe installer for SAP BusinessObjects Design Studio is available as a single executable file (for downloading and installing on your local PC or a shared location).



http://java.com/en/download/index.jsp

http://service.sap.com/pam

1. Go to SAP Service Marketplace at http://service.sap.com SAP Support Portal Software DownloadsInstallations and Upgrades .

Note


2. In the A - Z Index, click D.The SAP BusinessObjects Design Studio client installation is available for download at SBOP DESIGN STUDIO 1.0.

3. Under Comprised Software Component Versions, choose DESIGN STUDIO CLIENT 1.0 Win32 .For more information, see SAP Note 1760409.

4. Download the exe file and execute it.The SAPSetup installation wizard appears.

5. To allow the installation of SAP BusinessObjects Design Studio, click Yes.6. Close all SAP applications and click Next.7. Select SAP BusinessObjects Design Studio in the component list of the SAP Front End Installer dialog box.8. Click Next.

The SAP Front End Installer prompts you to confirm or change the target directory for SAP BusinessObjects Design Studio.

NoteThe default path is C:\Program Files (x86)\SAP BusinessObjects\Design Studio.

9. Confirm or change the target directory and click Next to start the installation.10. In the confirmation screen, click Done.

The design tool of SAP BusinessObjects Design Studio is now installed and is ready to use.Users can access the design tool in the Windows Start menu under Design Studio or in the Windows directory under Start All Programs SAP Business Intelligence SAP BusinessObjects Design Studio Design Studio

.

3.2.3 Updating the design tool installationYou can run updates of your design tool installation.

1. Double-click SapDsSetup.exe.The SAPSetup installation wizard appears.

2. Close all SAP applications and click Next.3. Select SAP BusinessObjects Design Studio in the component list of the SAP Front End Installer dialog box.4. Click Next.

The component is being updated.5. After successful deployment and re-configuration of the SAP BusinessObjects Design Studio component, click

Close.




3.2.4 Uninstalling the design tool of SAP BusinessObjects Design StudioBefore uninstalling, make sure that the design tool is not running.

1. In the Windows Control Panel, choose Programs and Features.A list of installed applications appears.

2. Double-click SAP BusinessObjects Design Studio.The SAP Front End Installer dialog box appears.

3. Click Next.4. In the confirmation screen, click Close.

The design tool of SAP BusinessObjects Design Studio has now been uninstalled.



4 Configuration

4.1 Creating and managing data source connections in SAP BusinessObjects Business Intelligence

SAP BusinessObjects Design Studio uses SAP BusinessObjects Business Intelligence platform 4.0 as the central content management system for analysis applications, and as a platform for managing OLAP data source connections.Before designers can add data sources to the analysis applications they design, you have to create OLAP data source connections to SAP HANA systems or BW systems.An OLAP data source connection is a BI platform repository object that contains all the information that is required for SAP BusinessObjects Design Studio to connect to a data source. This connection object is then linked to an analysis application.You can create connections to individual BEx queries, BEx query views or InfoProviders of the BW system as well as to individual cubes of the SAP HANA system, or to BW or SAP HANA systems containing many of these objects. If a designer adds a data source to an analysis application, the designer must then choose an individual query or query view from the BW system connection. With SAP HANA connections, the application designer can choose individual cubes.You create new data source connection objects and manage existing connection objects for SAP HANA or BW systems in the module OLAP Connections in the Central Management Console (CMC) of the business intelligence platform.

CautionThe module OLAP Connections is only available in the CMC if you have SAP BusinessObjects Analysis, edition for OLAP installed with your BI platform installation.

Connections can be saved to a single folder, or you can create subfolders to help group your connection objects together and administer access rights. For example, you could create a folder for SAP NetWeaver BW data source connections, and another folder for SAP HANA data source connections, and grant users access to only one of the folders.

NoteIn the design tool of SAP BusinessObjects Design Studio, all data source connections are shown in a flat list even if you organize them by folders in the CMC.OLAP connections are shared with other applications, such as SAP BusinessObjects Analysis, edition for Microsoft Office, SAP BusinessObjects Analysis, edition for OLAP, and SAP Crystal Reports.

For more information about creating and managing connections in SAP BusinessObjects Business Intelligence platform 4.0, see “Data Source Connections” and “Connection settings for SAP NetWeaver Business Warehouse data sources” in the SAP BusinessObjects Analysis, edition for OLAP Administrator Guide at http://help.sap.com/boaolap40 .

Related Links

Administrator Guide: SAP BusinessObjects Design StudioConfiguration




Creating BW system connections [page 20]Creating SAP HANA system connections [page 20]

4.1.1 Creating BW system connectionsYou have to make sure that the machine that contains the Adaptive Processing Server (APS) of the BI platform can communicate with the connected BW systems. If the BW system uses a message server, this machine must specify the service name of the message server in the system's services file. With Microsoft Windows as the operating system, the system's services file is located at <systemdrive>:\WINDOWS\system32\drivers\etc\services. For more information on the location of the system's services file with other operating systems, see SAP Note 52959. Configure the system's services file of the machine with the APS accordingly.

To create a connection to a BW system, you have the following options:

You define the connection to the BW system itselfYou define the connection to a BEx query, BEx query view, or InfoProvider of the BW system

1. In the Central Management Console under OLAP Connections, click New Connection.2. Enter the name of the BW system.3. Enter the server information.4. If you want to define the connection to a query, query view or InfoProvider, click Connect.5. In the Cube Browser dialog box, select the required BW object and click Select.6. In the Authentication list, select Prompt or SSO.

With Prompt, users have to log on to the system with their credentials. They can also change the client and language in the logon dialog box.With SSO, users can log on to the system without entering their credentials. They can change the client and language in the logon dialog box however.

7. Click Save.

Once you have created BW system connections, these connections appear in the list of connections in the Select Connection dialog box, which appears after browsing for a different connection than the preselected one in the Add Data Source dialog box in the design tool of SAP BusinessObjects Design Studio. Your application designers can add them to their analysis applications.Application users can access all BEx queries and BEx query views of the connected BW system that they are authorized for by the BW authorization concept.

4.1.2 Creating SAP HANA system connectionsTo create a connection to a SAP HANA system, you have the following options:

You define the connection to the SAP HANA system itselfYou define the connection to a cube of the SAP HANA system

NoteSAP HANA system connections currently need to be configured with authentication type “Pre-defined”, specifying a fix user name and password.

1. In the Central Management Console under OLAP Connections, click New Connection.2. Enter the name of the SAP HANA system.3. Enter the server name and port.



4. If you want to define the connection to a cube, click Connect.5. In the Cube Browser dialog box, select the required cube and click Select.6. In the Authentication list, select Pre-Defined.7. Enter a user name and password.8. Click Save.

Once you have created SAP HANA system connections, these connections appear in the list of connections in the Select Connection dialog box, which appears after browsing for a different connection than the preselected one in the Add Data Source dialog box in the design tool of SAP BusinessObjects Design Studio. Your application designers can add them to their analysis applications without entering user credentials.Application users can access the SAP HANA data of the connected SAP HANA system in the analysis applications without entering user credentials.

RestrictionAll users accessing analysis applications with data from the pre-defined SAP HANA connection have the same data authorizations as the specified user for this connection. Currently it is not possible to give users different rights for viewing SAP HANA data in analysis applications.

4.1.3 Reloading connections in the design toolOnce you have created data source connections on the BI platform, you can reload the newly created connections in the design tool. This function allows application designers to proceed their work in the design tool without closing and opening it again.

NoteIf you create the data source connections on the BI platform before application designers start working with the design tool, they do not need to reload the connections. The design tool adds the newly created connections automatically.

1. In the design tool, choose Tools Preferences Application Design Backend Connections .2. Click Reload All Connections.

The new connections are added to the corresponding tables in the Preferences dialog box.The connections will be listed in the Select Connection dialog box, which appears after browsing for a different connection than the preselected one in the Add Data Source dialog box. For more information, see the Application Designer Guide: Designing Analysis Applications under Help Help Contents in the design tool.

4.2 Maintaining settings on the BI platform

After installing the Analysis Application Service for SAP BusinessObjects Design Studio on the BI platform, you perform the following configuration steps:

Check the status of the Analysis Application ServiceMaintain the maximum number of client sessionsCreate a user group and add view rights



4.2.1 Checking the status of the Analysis Application ServiceYou can check, if the Analysis Application Service has been successfully initialized.

1. Log on to the Central Management Console (CMC).2. Choose Servers.3. Expand the Service Categories node and choose Analysis Services.4. Select Adaptive Processing Server and choose Properties in the context menu.

NoteIf the Adaptive Processing Server does not exist, you need to create it.

1. Press the Create new server toolbar button.2. Select Analysis Services as service category.3. Select Analysis Application Service as service.4. Choose Next and Next again.5. Choose Create.

5. In the Analysis Application Service area at the bottom of the page, check the status of the service. The following messages can be displayed here:Message Description

Service is healthy. The Analysis Application Service has been started and successfully initialized.

Service initialization failed.

The Analysis Application Service could not be initialized. If a log ID is available, it is displayed next to this message. You can check the server log files to repair the service.On Windows platforms, the default location for the Logging directory is: Program Files <INSTALLDIR>\SAP BusinessObjects Enterprise XI 4.0\logging. On Unix, the directory is located in: <INSTALLDIR>/sap_bobj/logging.For more information, see “Managing and Configuring Logs” in the Business Intelligence Platform Administrator Guide at http://help.sap.com/bobip40.

RestrictionThis status message refers to the first initialization of the Analysis Application Service only. The system does not check the status of the service on a regular basis. If the service has been initialized successfully, but fails later on, the message Service is healthy will not disappear.

6. Choose Save & Close.

4.2.2 Maintaining the maximum number of client sessionsYou can configure the maximum number of client sessions for the Analysis Application Service.

1. Log on to the Central Management Console (CMC).2. Choose Servers.3. Expand the Service Categories node and choose Analysis Services.4. Select Adaptive Processing Server and choose Properties in the context menu.5. Under Analysis Application Service Configuration in the Analysis Application Service area at the bottom of the

page, check (and change, if necessary) the maximum number of client sessions.6. Choose Save & Close.




4.2.3 Creating a user group and adding view rightsBefore application designers and application users can work with analysis applications, you need to create a user group, add this group to the Design Studio Runtime application and assign access level View. After creating users, you need to add them to the user group.

1. In the Central Management Console under Users and Groups Group List , click Create new group.2. Enter a group name, Design Studio User for example, and a description.

3. Click OK.4. In the Central Management Console under Applications, select User Security in the context menu of Design

Studio Runtime.5. In the User Security:AAD.Plugin dialog box, click Add Principals.6. Select the group name you created in step 2 (Design Studio User for example) and add it to the selection.7. Click Add and Assign Security.8. In the Assign Security dialog box, select the access level View and add it to the selection.9. Click Apply and OK.

10. In the Central Management Console under Users and Groups User List , click Create new user.11. Enter the required data in the New User dialog box and click Create & Close.12. Select Join Group in the context menu for the new user.13. In the Join Group: <user name> dialog box, select the group name you created in step 2 (for example, Design

Studio User) and add it to the selection.14. Click OK.

Your users have view rights for the Design Studio runtime. You also need to give them the appropriate rights for the defined OLAP connections and for the folders on the BI platform. For more information, see “Setting Rights” in the Business Intelligence Platform Administrator Guide at http://help.sap.com/bobip40.Related LinksManaging access rights [page 43]

4.3 Configuration tasks for mobile usage of analysis applications

Before users can access analysis applications on the mobile app of the SAP BusinessObjects Mobile solution, you need to check whether a mobile category exists on the BI platform. If no mobile category exists, you need to create one. Then you need to assign the analysis applications to this category.

NoteThe default name of the mobile category is Mobile. Administrators can change the category name in the mobi.properties file on the Mobile server under[<WebAppServer>_Home]\webapps\MobileBIService\WEB-INF\mobi.properties. For more information, see “Configuring Categories on the Mobile Server” in the Administrator and Report Designer's Guide: SAP BusinessObjects Mobile for iOS 4.4.0 at http://help.sap.com/bomobileios.






4.3.1 Creating the mobile category on the BI platformCheck whether a mobile category exists on the BI platform. If not, you need to create one.

1. In the Central Management Console under Categories, choose Manage New Category .2. When prompted, type Mobile as the name for the new category.3. Click OK.

For more information on configuring categories, see “Configuring Categories on the Mobile Server” in the Administrator and Report Designer's Guide: SAP BusinessObjects Mobile for iOS 4.4.18 at http://help.sap.com/bomobileios.

4.3.2 Assigning analysis applications to the mobile categoryBefore users can access analysis applications on a mobile device using the SAP BusinessObjects Mobile solution, you need to assign the analysis applications to the mobile category on the BI platform.

1. In the BI launch pad, go to the folder that contains the analysis application that you want to assign to the mobile category.

2. Select the analysis application, and click More Actions Categories .The Categories dialog box appears.

3. Choose the mobile category.4. Click OK.

4.4 Providing the Web Service URL to application designers

When logging on to the design tool, application designers need to enter the Web Service URL in the Logon to SAP BusinessObjects BI Platform dialog box.The Web Service URL describes the connection to the BI platform. It consists of information about the host and port of the BI platform: http://<host>:<port>/dswsbobje/services/Session.Provide your application designers with the Web Service URL to your BI platform server. Once a Web Service URL has been added in the Logon to SAP BusinessObjects BI Platform dialog box, it is listed in the Web Service URL dropdown box. If you have several BI platform servers, the application designers can select the one they require in the Web Service URL dropdown box.

4.5 Maintaining settings in the design tool

You can define settings for the design tool in the Preferences dialog box. To start the Preferences dialog box, choose Tools Preferences Application Design .Change the default values as required and choose Apply to make the entered values effective. If you want to reset the default values, choose Restore Defaults. To close the Preferences dialog box, choose OK.The following settings are available:





GeneralYou can switch the startup mode. In the default setting, the design tool starts in local mode after installation. If you want to use SAP BusinessObjects Design Studio integrated into the BI platform, click Connect to BI Platform. After restarting the design tool, you need to log on to the BI platform.

NoteIn the Logon to SAP BusinessObjects BI Platform dialog box, you can still decide to log on locally by clicking Skip, even if the startup mode is set to Connect to BI Platform. The design tool starts in local mode.

Embedded Web ServerYou can define the network port for the embedded Web server of the design tool. Enter a number between 1024 and 65535. When an application is executed, the port number can be seen in the URL. If the port is set to 5555 for example, the URL is http://localhost:5555/aad/web.do?APPLICATION=MYAPP. If you leave the default value 0, the system automatically assigns a network port.

TipIf users create bookmarks to their applications, the network port has to be set to a fixed number. Auto-assigning the network port would not guarantee that the bookmarks will work properly.

Application Preview The language of message texts and tooltips is defined by the language setting in the BI launch pad or the Web browser. The format for numbers, dates and times varies according to the defined language setting. To preview the analysis applications in the required language and appropriate formatting, application designers can switch between the preferred viewing locale of the BI launch pad (BI Platform User Settings radio button) or the Web browser language (Web Browser radio button).

NoteThese language settings, which also affect the formatting, are not available in local mode in the design tool.

Application RecoveryIn the default setting, the system automatically saves unsaved applications every 5 minutes. You can configure the auto-save time interval as required. Select the Save application recovery information every <5> minutes checkbox and enter the required number for the auto-save time interval.

TipThe design tool needs to be restarted for the new interval to become active.

There is a background job that searches for unsaved applications in the given interval. If unsaved applications are found, the system extracts their XML code and stores it in <home directory>\.sap\com.sap.ip.bi\autosaves. The content of this file is encrypted using Eclipse secure store technology.

NoteThe auto-save function does not replace saving an application. Saving an application or closing it and answering the Save changes? question with either Yes or No will delete the XML from the autosaves file.



In the event of a system crash, the auto-saved XML persists. When restarting the design tool and opening the affected application again, the designer is informed that an auto-saved version of the application exists.

If the designer decides to restore the auto-saved version, the system takes the stored XML, saves the application and opens the application in the layout editor. The auto-saved XML is removed.If the designer decides to discard the auto-saved version, the auto-saved XML is removed as well.

Member SelectionApplication designers need to pick single members of a dimension when using statements like setFilter for a dropdown box, for example. They can pick the members in the content assistance of the Script Editor dialog box or in the Select Member dialog box. The Select Member dialog box can list small or large numbers of members by adjusting its capabilities according to a maximum threshold number of members. You can set the default threshold in the Preferences dialog box.

You can define the maximum number of members that are displayed in the Select Member dialog box. Enter the required number in the Maximum number of members to fetch from backend in dialog checkbox. The default threshold is 1000.You can define the maximum number of members that are displayed in the content assistance of the Script Editor dialog box. Enter the required number in the Maximum number of members to fetch from backend in content assistance checkbox. The default threshold is 20. If the number of available members exceeds this threshold number, the content assistance does not list single members. Instead it offers the Select Member... entry, which opens the Select Member dialog box.

TipDesigners can access the content assistance in the script editor by pressing CTRL + SPACE.

You can also decide whether the system should display warnings in the script editor whenever designers manually enter non-existent values. To activate the warnings, select the Display warnings for manually entered invalid values checkbox.

PathsSAP BusinessObjects Design Studio includes a set of templates that offer designers an easy way to get started. When creating new applications, designers can choose between different templates that are optimized for desktop Web browser applications or mobile applications in the New Application dialog box ( ApplicationNew... ). For more information, see “Creating a new analysis application” in the Application Designer Guide: Designing Analysis Applications under Help Help Contents in the design tool.In the Preferences dialog box, you see the default path to the folder where these templates are stored. You can change the path by clicking the Browse... button.

4.6 Sizing Guidelines

You can find recommendations on sizing and optimizing the performance of analysis applications in SAP Note 1177020.



4.7 More Information

For more information about configuration, update and setup of SAP BusinessObjects Design Studio, see SAP Note 1760409. This note contains up-to-date information that could not be included in this guide.



5 Security

5.1 User management and authentication

You have to configure user accounts in the following systems:

● The connected SAP NetWeaver BW systemsFor more information, see “Identity Management” in the SAP NetWeaver Library at http://help.sap.com/nw731.

● The connected SAP HANA systemsFor more information, see “User Management” in the SAP HANA Security Guide at http://help.sap.com/hana_appliance.

● The BI platformFor more information, see “Managing Users and Groups” in the Business Intelligence Platform Administrator Guide at http://help.sap.com/bobip40.

5.2 Authentication and Single Sign-On

Single Sign-On when using SAP NetWeaver BW data sourcesOnce users are logged on to SAP BusinessObjects Business Intelligence platform 4.0, Single Sign-On enables users to access SAP NetWeaver BW systems without having to provide their logon credentials. Single Sign-On works if the following conditions are met:

SAP BusinessObjects Business Intelligence is configured correctly for Single Sign-On . For more information, see “Configuring SAP authentication” under “SAP Authentication” in the Business Intelligence Platform Administrator Guide, at http://help.sap.com/bobip40.In the Central Management Console, under OLAP Connections, the Authentications parameter is set to SSO for the BW systems that should be used with Single Sign-On .

In the Central Management Console, under Users and Groups User List , the BI platform user accounts need to be mapped to the BW user accounts: In the Properties dialog box of a BI platform user, click Assign Alias... to add the corresponding BW user.The SAP NetWeaver BW system is configured as an external authentication system. Proprietary SAP tokens (assertion tickets) are used to provide a mechanism that supports Single Sign-On for design studio users connecting to BW systems. For more information, see “Setting up single sign-on to the SAP system” under “SAP Authentication” in the Business Intelligence Platform Administrator Guide, at http://help.sap.com/bobip40.

With Single Sign-On , application designers sign on once to SAP BusinessObjects Business Intelligence with their credentials when starting the design tool of SAP BusinessObjects Design Studio.Application users accessing analysis applications in the BI launch pad sign on once to SAP BusinessObjects Business Intelligence as well.Both user types can access BW data without further logons.


Administrator Guide: SAP BusinessObjects Design StudioSecurity









NoteAlternatively, you can configure the OLAP connection to SAP NetWeaver BW with authentication type “Pre-defined”, specifying a fixed user name and password. Note that all users accessing analysis applications with data from the pre-defined SAP NetWeaver BW connection have the same data authorizations as the specified user for this connection.

Single Sign-On when using SAP HANA data sourcesCurrently, Single Sign-On is not supported for SAP HANA system connections.In the Central Management Console, under OLAP Connections, SAP HANA system connections currently need to be configured with authentication type “Pre-defined”, specifying a fixed user name and password.Application designers and application users do not need to enter user credentials when accessing SAP HANA data sources.

RestrictionAll users accessing analysis applications with data from the pre-defined SAP HANA connection have the same data authorizations as the specified user for this connection. Currently it is not possible to give users different rights for viewing SAP HANA data in analysis applications.

Related LinksDefining connections to BI back-end systems in local mode [page 49]

5.3 Authorizations

For security reasons, make sure that users do not have administrator rights on the client PCs. Otherwise, these users could access trace files of other users on the client PC.For data access management, SAP BusinessObjects Design Studio uses the authorization concept of the corresponding back-end system.

With SAP NetWeaver BW, users need analysis authorizations to view the data of authorization-relevant characteristics in a query or in a query view that is used as a data source in an analysis application. For more information, see “Authorizations”, under “Business Warehouse”, in the SAP NetWeaver Library at http://help.sap.com/nw731.With SAP HANA, all users currently view the same data as the user specified for a SAP HANA connection on the CMC is authorized for. Currently, it is not possible to give users different rights for viewing SAP HANA data in analysis applications. The user specified in the CMC for a SAP HANA connection needs analytic privileges to view the data of the SAP HANA data sources that are used in analysis applications. For more information, see “Analytic Privileges”, under “Authorizations”, in the SAP HANA Security Guide, at http://help.sap.com/hana_appliance.

For content management of analysis applications, images and data source connections, SAP BusinessObjects Design Studio uses the authorization concept of the BI platform. For more information on configuring the authorizations for the folders containing these objects, see “Setting Rights”, in the Business Intelligence Platform Administrator Guide , at http://help.sap.com/bobip40.Related LinksManaging access rights [page 43]








5.4 Network and communication securityYour network infrastructure is extremely important for protecting your system. Your network needs to support the communication necessary for your business needs without allowing unauthorized access.With SAP BusinessObjects Design Studio, we distinguish between the following communication scenarios:

Communication at design time: Application designers working with the design toolCommunication at runtime (desktop): Application designers executing analysis applications on the BI platform, or application users accessing analysis applications in the BI launch padCommunication at runtime (mobile device): Application users accessing analysis applications on a mobile device using the SAP BusinessObjects Mobile solution

For more information, see “Network and Communication Security” in the Security Guide: SAP BusinessObjects Mobile (for iOS 4.4.0 and for Android) at http://help.sap.com/bomobileios.

5.4.1 Communication at design timeThe following diagram illustrates the components involved and provides an overview of the communication channels at design time:

At design time, the following components are involved:

The client tier with the Web browser and the design tool on the local computer of the application designerThe Web tier of the BI platform with the Web services providerThe storage tier with the BI back end systems (SAP NetWeaver BW or SAP HANA) and the Central Management Server (CMS) of the BI platform




The communication sequence works as follows:

Creating new analysis applicationsThe application designer starts the design tool and logs on to the BI platform. The application designer creates a new application. The embedded Web browser in the design tool's layout editor opens. It connects with the design tool's embedded Web server. This communication is carried out with a Web service connection using HTTP as the protocol.

Opening analysis applicationsWhen opening analysis applications, the design tool connects to the Web services provider to fetch the analysis application, which is stored in the BI platform's CMS repository. For more information on securing this communication channel, see “Securing the BI platform”, in the Business Intelligence Platform Administrator Guide , at http://help.sap.com/bobip40.

Adding data sources to analysis applicationsWhen the application designer adds data sources to the application (by adding a new data source or by selecting members in the script editor for example), the design tool connects to the Web services provider to fetch the connection information, which is stored in the BI platform's CMS repository. For more information on securing this communication channel, see “Securing the BI platform”, in the Business Intelligence Platform Administrator Guide, at http://help.sap.com/bobip40.The design tool reads in the connection information which BI back-end system is used and fetches the business data from this BI back-end system.With SAP NetWeaver BW as the BI back-end system, this communication is performed using a synchronous JCo Remote Function Call (RFC) connection. You can protect this RFC connection using Secure Network Communications (SNC). For more information, see “Transport Layer Security”, in the SAP NetWeaver Security Guide , at http://help.sap.com.With SAP HANA as the BI back-end system, this communication is performed using a Java Database Connectivity (JDBC) connection. You can protect this connection using the Secure Sockets Layer (SSL) protocol. For more information, see “Secure communication”, in the SAP HANA Security Guide , at http://help.sap.com.

Executing analysis applicationsIf the application designer chooses Application Execute Locally , a new Web browser window outside the design tool opens. It connects with the design tool's embedded Web server. This communication is carried out with a Web service connection using HTTP as the protocol.For more information on executing analysis applications on the BI platform, see the following chapter.Related LinksCommunication at runtime [page 31]Creating and managing data source connections in SAP BusinessObjects Business Intelligence [page 19]

5.4.2 Communication at runtimeThe following diagram illustrates the components involved and provides an overview of the communication channels at runtime:





http://help.sap.com

http://help.sap.com

At runtime, the following components are involved:

The Web browser on the local computer of the application designerThe Web tier of the BI platform with the BI launch pad or Open Document Web application



The processing tier with the Analysis Application Service on the Application Processing Server (APS)The storage tier with the BI back-end systems (SAP NetWeaver BW or SAP HANA) and the Central Management Server (CMS) of the BI platform

The communication sequence works as follows:

Executing analysis applications in the design toolWhen an application designer chooses Application Execute on BI Platform , the application is displayed in a separate Web browser window, using the document link of the application and the current session of the BI platform. The application designer does not have to log on to the BI platform when executing the application on the BI platform.For executing applications on the BI platform, the BI platform adapter of the Analysis Application Service fetches the connection information (and any images used) from the CMS repository. This communication is carried out using CORBA. For more information on securing this communication channel, see “Securing the BI platform”, in the Business Intelligence Platform Administrator Guide , at http://help.sap.com/bobip40.The Analysis Application Service reads in the connection information which BI back-end system is used and fetches the business data from this BI back-end system.With SAP NetWeaver BW as the BI back-end system, this communication is performed using a synchronous JCo Remote Function Call (RFC) connection. You can protect this RFC connection using Secure Network Communications (SNC). For more information, see “Transport Layer Security”, in the SAP NetWeaver Security Guide, at http://help.sap.com.With SAP HANA as the BI back-end system, this communication is performed using a Java Database Connectivity (JDBC) connection. You can protect this connection using the Secure Sockets Layer (SSL) protocol. For more information, see “Secure communication”, in the SAP HANA Security Guide, at http://help.sap.com.The Analysis Application Service forwards the information to the OpenDocument Web application and the analysis application is displayed in the Web browser.

Executing analysis applications in the BI launch padApplication users start an analysis application in the BI launch pad by clicking Open in the context menu of an application, or by clicking the application in the BI launch pad.In this case the same communication process applies as described above. The Analysis Application Service forwards the information to the BI launch pad Web application and the analysis application is displayed in a new tab in the BI launch pad (which is running in the Web browser). With Internet Explorer, the analysis application is displayed in a new window.

5.5 Data storage security

Analysis applicationsApplication designers store the analysis application files in folders on the BI platform. They can also store images and icons they use in their analysis applications on the BI platform.

TipWe recommend using a common root folder for all images and icons on all BI platform instances. This will make it simpler to transport analysis applications and the referenced images or icons between different BI platform systems.




http://help.sap.com

http://help.sap.com

You can protect access to the analysis application files by assigning access rights to the folders. For more information on configuring the authorizations for the folders containing analysis applications, see “Setting Rights”, in the Business Intelligence Platform Administrator Guide, at http://help.sap.com/bobip40.Application designers can use images and icons in their analysis applications from the internet or intranet as well. Your application designers should be aware that using icons and images from the internet could be a security risk.

Analysis applications historyThe analysis applications history in the Application menu is persisted in the user's cache file <home directory>\.sap\com.sap.ip.bi\cache. The content of this file is encrypted using Eclipse secure store technology.

Data source historyThe data source history in the Add Data Source dialog box is persisted in the user's cache file <home directory>\.sap\com.sap.ip.bi\cache. The content of this file is encrypted using Eclipse secure store technology.Related LinksTransporting analysis applications, images and data source connections [page 44]

5.6 Security for additional applications

SAP BusinessObjects Design Studio takes the data for the data sources from SAP NetWeaver Business Warehouse or SAP HANA.For more information on security aspects of SAP NetWeaver BW, see the Security Guide for SAP NetWeaver BW in the SAP NetWeaver Library, at http://help.sap.com/nw731.For more information on security aspects of SAP HANA, see the SAP HANA Security Guide, at http://help.sap.com/hana_appliance.SAP BusinessObjects Design Studio uses SAP BusinessObjects Business Intelligenceas ist content management system. For more information on security aspects when working with the BI platform, see “Securing BI Platform”, in the Business Intelligence Platform Administrator Guide, at http://help.sap.com/bobip.

5.7 General security recommendations

The following topics provide an overview of additional security-related information and recommendations.

Virus scanner activationAs users upload analysis application files from SAP BusinessObjects Design Studio to the BI platform document repository, we recommend using a virus scanning application to protect your BI platform server. You should only allow your users to store the files in a specific folder in the BI platform. Configure a virus scan for this folder, using a virus scanning application installed on the same server as the BI platform. Whenever a file is added or modified in this folder, the virus scanner automatically scans the file.If no virus scanning application is used, there is the risk of the server being contaminated by viruses contained in uploaded files. These viruses can be spread by users when downloading the infected files.







http://help.sap.com/bobip

6 Language and Regional Settings

In SAP BusinessObjects Design Studio, different text types are displayed in a single user interface. This applies to the design tool user interface and to the user interface texts in the executed analysis applications.

6.1 Language of the design tool texts

The texts in the design tool user interface are available in English only.

6.2 Language of master data and metadata

The texts of the data from the back-end systems, such as master data and metadata of the selected data source, are visible in the design tool's layout editor and in the nalysis applications being executed. These texts are language-dependent and are displayed in the default language from the user settings in the back-end system (SAP HANA or SAP NetWeaver BW). If you define a language in the OLAP connection to the back-end system in the BI platform's Central Management Console (CMC), this language setting overrides the language from the user settings in the back-end system, and the language defined for the OLAP connection is used for all users using this connection.

6.3 Language of message texts and tooltips in analysis applications

The language of message texts and tooltips is defined by the language setting in the BI launch pad or the Web browser according to the following rule:

If you define a language in the BI launch pad under Preferences Locales and Time Zone Preferred Viewing Locale , this language is used.

If you select Use browser locale under Preferences Locales and Time Zone Preferred Viewing Locale , the Web browser language is used.

Preview of analysis applications To preview the analysis applications in the required language, application designers can switch between these two settings in the Preferences dialog box in the SAP BusinessObjects Design Studio design tool. Under ToolsPreferences Application Design Application Preview , they can choose between the preferred viewing locale

Administrator Guide: SAP BusinessObjects Design StudioLanguage and Regional Settings


of the BI launch pad (BI Platform User Settings radio button) or the Web browser language (Web Browser radio button).

NoteThese language settings are not available in local mode in the design tool.

Related LinksSupported languages [page 36]

6.3.1 Supported languagesMessage texts and tooltips in the executed analysis applications are available in the following languages:

Language value Description

csCZ Czech

daDK Danish

deDE German

enUS English

esES Spanish

fiFI Finnish

frFR French

huHU Hungarian

itIT Italian

jaJP Japanese

koKR Korean

nlNL Dutch

noNO Norwegian

plPL Polish

ptBR Portuguese

roRO Romanian

ruRU Russian

skSK Slovakian

svSE Swedish

thTH Thai

trTR Turkish

zhCN Chinese

zhTW Traditional Chinese



6.4 Regional formats for numbers, dates and times

The format for numbers, dates and times varies according to the defined language setting in the BI launch pad or the Web browser.

If you define a language in the BI launch pad under Preferences Locales and Time Zone Preferred Viewing Locale , this language is used, and numbers, dates and times are displayed in the appropriate format.

If you select Use browser locale under Preferences Locales and Time Zone Preferred Viewing Locale , the Web browser language is used, and numbers, dates and times are displayed in the appropriate format.

ExampleGerman formatting

If you select German as the preferred viewing locale in the BI launch pad, the following parts of the analysis application are affected:

Message texts and tooltips are displayed in GermanNumbers are displayed in format 11.111,111, for example 43.484,018.Dates are displayed in format DD.MM.YYYY, for example 29.07.2012.Times are displayed in format hh:mm, for example 10:30.

ExampleEnglish formatting

If you select English as the preferred viewing locale in the BI launch pad, the following parts of the analysis application are affected:

Message texts and tooltips are displayed in EnglishNumbers are displayed in format 11,111.111, for example 43,484.018.Dates are displayed in format MM/DD/YYYY, for example 07/29/2012.Times are displayed in format hh:mm AM/PM, for example 10:30 AM.

Preview of analysis applicationsTo preview the analysis applications in the required language and appropriate formatting, application designers can switch between these two settings in the Preferences dialog box in the SAP BusinessObjects Design Studio design tool. Under Tools Preferences Application Design Application Preview , they can choose between the preferred viewing locale of the BI launch pad (BI Platform User Settings radio button) or the Web browser language (Web Browser radio button).

NoteThese language settings, which also affect the formatting, are not available in local mode in the design tool.

6.4.1 Formatting of date and time with SAP HANA data sourcesWith SAP HANA data sources, the presentation of dates and times works as follows:



Presentation of date and time dataSAP HANA supports date and time data only as characteristics, not as key figures. Unlike SAP NetWeaver BW, SAP HANA does not allow different formats of date and time characteristics.Dates and times from SAP HANA data sources are always presented in the following way:

YYYY:MM:DD - for example 2012:07:29hh:mm:ss (with an hour range from 0 to 23) - for example 10:30:25

The selected language in the BI launch pad or the Web browser does not affect the presentation of date and time characteristics from SAP HANA data sources.

Relevance of the time zone settingSAP NetWeaver BW only supports the data types DATE and TIME. Both are independent of time zones.SAP HANA supports the data types DATE and TIME as well as a TIMESTAMP data type with implicit UTC time zone. The selected time zone in the BI launch pad (under Preferences Locales and Time Zone Current Time Zone ) does not affect the presentation of time characteristics from SAP HANA data sources. These are always presented as UTC times.

6.5 Business case: Defining English as the preferred language of an analysis application

To present an analysis application in one language for all text types, and the appropriate formats for dates, times and numbers, the different settings need to be defined consistently. If you want to present an analysis application in English, perform the following steps:

1. Define English as the language in the OLAP connection to SAP NetWeaver BW.Master data and metadata, such as descriptions of characteristics and key figures, are displayed in English. These texts appear as column or row headers in a crosstab, or series and category names in a chart.

2. If you do not define a language in the OLAP connection, select English in the user settings in the BW system. Do this for all users who will receive this analysis application.

3. Select English as the preferred viewing locale in the BI launch pad.Message texts and tooltips are displayed in English. Numbers, dates and times are displayed according to English formatting conventions.

CautionIf you select Use browser locale as the preferred viewing locale, the Web browser language is used for these texts. Depending on the users' language setting in their Web browser, they might encounter inconsistent texts and formatting in the analysis application.



7 Lifecycle Management

Lifecycle of analysis applications, images and data source connectionsApplication designers create analysis applications allowing their users to analyze business data of BW and SAP HANA systems. Image resources stored on BI Platform and connection definitions to BW or SAP HANA systems are vital elements of analysis applications. The following sections provide an overview of these objects' life-cycles and outline how application designers and administrators manage them coherently.

Managing access rightsAdministrators need to give application designers and application users the required access rights.

Transporting analysis applications, images and data source connectionsTo transport analysis applications, images and data source connections, administrators use the promotion management of the BI platform.Related LinksWorking with analysis applications [page 39]Working with images [page 42]Working with data source connections [page 42]Managing access rights [page 43]Transporting analysis applications, images and data source connections [page 44]

7.1 Working with analysis applications

Creating analysis applicationsApplication designers create analysis applications by choosing Application New... in the SAP BusinessObjects Design Studio design tool.

Changing analysis applicationsApplication designers can change their analysis applications by choosing Application Open... in the design tool. As long as the design tool is running, application designers can undo or redo their changes. After closing the design tool, it is not possible to return to previously saved states of an analysis application.

RestrictionSimultaneous modification of analysis applications by more than one application designer is not supported. If several application designers open the same application, change it and want to save it on the BI platform, only the one saving the application first can save his/her changes. All other application designers will get a warning that a newer version exists on the BI platform when saving the application. They can save their version as a copy (by choosing Application Save As... ). If they save the application by choosing Application Save As... with the same name of the original application, they overwrite the version of their colleague saving the application first, and the system does not inform this colleague.

Administrator Guide: SAP BusinessObjects Design StudioLifecycle Management


CautionChanging analysis applications in a text editor and re-uploading them to the BI platform is not supported.

Deleting analysis applicationsApplication designers can delete their analysis applications by opening the application in the design tool and choosing Application Delete . The analysis applications are permanently deleted. They cannot be restored.

RestrictionIf several application designers open the same application simultaneously, and one of them deletes the application, the other designers do not receive a system notification. They only see a warning when trying to save the application. They can save the application by choosing Application Save As... . The system saves the application with a new CUID.

Uploading analysis applicationsIf application designers have created analysis applications in local mode in the design tool, they can upload these locally stored applications to the BI platform by choosing Tools Upload Local Application... in the design tool.The application designers also need to change the data source connections in the Properties view of the data sources in the design tool. Connections from local mode have to be replaced by data source connections of the BI platform.If images are included in these applications, the application designers need to upload these images to the BI platform as well. They then need to change the paths to the images in the Properties view of the Image components.

RestrictionUploading locally stored analysis applications to the BI platform as local files in the launch pad or Central Management Console is not supported.

Downloading analysis applicationsApplication designers can download analysis applications from the BI platform to their PC by choosing HelpSupport Download... in the design tool. This function makes it possible to provide the original source code of analysis applications to SAP, and helps us to resolve problems that you report to SAP as customer messages.

Moving analysis applications between foldersApplication users can move analysis applications from one folder to another by choosing Cut in the context menu of an application and choosing Paste in the context menu of the target folder in the BI launch pad. Administrators can perform the same operation in the Central Management Console.

Copying analysis applicationsApplication users can copy analysis applications from one folder to another by choosing Copy in the context menu of an application and choosing Paste in the context menu of the target folder in the BI launch pad. Administrators can perform the same operation in the Central Management Console.



Executing analysis applicationsApplication users have the following options for running analysis applications:

Application users run the applications by choosing Open in the context menu of an application, or by clicking the application in the BI launch pad. Each analysis application is displayed in a new tab in the BI launch pad. With Internet Explorer, the analysis application is displayed in a new window.Application users can open an application on a mobile device (on an iPad for example). In the Documents tab in the BI launch pad, users can choose Document Link in the context menu of an application. The URL of the application is displayed. Users can copy this URL, send it in an e-mail and run the URL on their iPad. If they want to add this URL to their bookmarks, they have to add it manually instead of pressing the corresponding button.

NoteThis is necessary because the original URL is immediately forwarded to a generic URL, keeping the application reference in the session. When bookmarking and opening this generic URL that lacks the application reference, the Web browser will show an error page only.

Application designers have the following additional options for running analysis applications:

In the design tool, application designers can choose Application Execute Locally . The application is displayed in a separate Web browser window, using a local Web server embedded in the design tool.

In the design tool, application designers can choose Application Execute on BI Platform . The application is displayed in a separate Web browser window, using the document link of the application and the current session of the BI platform. The application designer does not have to log on to the BI platform when executing the application on the BI platform. The analysis application is run with the credentials that the application designer provided when logging on to the design tool.

In the design tool, application designers can click Send to iPad (using QR Code®). Clicking the QR code causes a new Web browser window to open with the document link, but without the current session of the BI platform. The application designer has to log on to the BI platform. This is useful if the designer wants to run the application with different credentials, to check access rights or personalized result sets for example.

In the design tool, application designers can click Send to iPad (using QR Code®). To copy the document link to the clipboard they can press CTRL + C. They can paste the URL and send it in an e-mail, and execute the URL on their iPad. If they want to add this URL to their bookmarks, they have to add it manually instead of pressing the corresponding button.

NoteThis is necessary because the original URL is immediately forwarded to a generic URL, keeping the application reference in the session. When bookmarking and opening this generic URL that lacks the application reference, the Web browser will show an error page only.

Related LinksManaging access rights [page 43]Transporting analysis applications, images and data source connections [page 44]



7.2 Working with images

Creating imagesIn the design tool, application designers can upload images in the Properties view for the Image component.Administrators (or application designers) can upload images on the Documents tab in the BI launch pad by choosing New Local Document in the context menu for the folder, or in the Central Management Console by choosing Add Local Document in the context menu for the folder.

NoteIn the Central Management Console or the BI launch pad, make sure that you upload the image with a MIME type, for example image/gif or image/jpg. Otherwise the image will not be available in the Open Image dialog box of the design tool.

Changing images The content of an image cannot be changed. You need to delete the image and upload a new one.

NoteMake sure that you use the same name and location for the new image. Otherwise, the references to the images in the analysis applications will not work any more.

Deleting images When deleting an image, make sure that it is not being used any more in analysis applications.Related LinksManaging access rights [page 43]Transporting analysis applications, images and data source connections [page 44]

7.3 Working with data source connections

Creating connectionsAdministrators create data source connections to SAP HANA or BW systems in the BI platform's Central Management Console.

NoteWith connections to BW systems, you have to make sure that the machine containing the BI platform's Adaptive Processing Server (APS) can communicate with the connected BW systems. If the BW system uses a message server, this machine must specify the service name of the message server in the system's services file. With Microsoft Windows as the operating system, the system's services file is located at <systemdrive>:\WINDOWS\system32\drivers\etc\services. For more information on the location of the system's services file with other operating systems, see SAP Note 52959. Configure the system's services file of the machine with the APS accordingly.



Changing connections Administrators can change data source connections in the BI platform's Central Management Console.

Deleting connections When deleting a data source connection, make sure that the connection is not used any more in analysis applications. Connections are referenced in analysis applications by their CUID. The CUID is unique for each connection. Deleting the connection deletes the CUID as well.

CautionIf a connection that is still being used by an analysis application is deleted, the analysis application will not work anymore, even if you create a new connection to the same back-end system with the same name and locate it in the same folder as the deleted connection. You will have to change the connection assignment of the application to the newly created connection.

Moving connections between foldersIf you move a connection to a new folder, the analysis applications using this connection will still work. If connection access rights are inherited from their containing folder however, you have to make sure that the application designers and the application users still have view rights for the connection.Related LinksCreating and managing data source connections in SAP BusinessObjects Business Intelligence [page 19]Managing access rights [page 43]Transporting analysis applications, images and data source connections [page 44]

7.4 Managing access rights

Application designers need the following rights:

View rights for executing analysis applications (and the embedded images)Edit rights for changing analysis applicationsAdd rights for folders (to create analysis applications in these folders)View rights for the folder containing the images and all folders above this folder (in the folder hierarchy)View rights for data source connections

Application users need the following rights:

View rights for executing analysis applications (and the embedded images)Add rights for folders (to copy analysis applications and move them between these folders)View rights for the folder containing the images and all folders above this folder (in the folder hierarchy)View rights for data source connections

For content management of analysis applications, images and data source connections, SAP BusinessObjects Design Studio uses the BI platform authorization concept. For more information on configuring the authorizations for the folders containing these objects, see “Setting Rights”, in the Business Intelligence Platform Administrator Guide, at http://help.sap.com/bobip40.Related LinksCreating a user group and adding view rights [page 23]




7.5 Transporting analysis applications, images and data source connections

If you are running multiple BI platform instances in your system landscape, for development, testing and productive use for example, you can transport objects from one instance to another. To transport analysis applications, images and data source connections, use the promotion management of the BI platform. For more information, see “Promotion Management”, in the Business Intelligence Platform Administrator Guide, at http://help.sap.com/bobip40.When an analysis application is transported, three related entities are involved: the analysis application, the OLAP connections defined in CMC and the images used in the analysis application.When transporting these objects, make sure to perform the following actions:

Update of the data source connectionsA data source connection has the fields Name, ID and CUID. The Name can be maintained by the administrator, whereas the ID is issued by the system, and the CUID is constant, even after the connection has been transported.If you use different BW or SAP HANA systems for testing and productive usage, you need to update the transported connections in the target BI platform instance by maintaining the connection information to the associated BW or SAP HANA system. The constant CUID assures that the connection is working properly after the transport. The transported analysis applications use the connection CUID to read the appropriate connection information, and SAP BusinessObjects Design Studio builds the connection to the target system or object.

NoteYou have to make sure that the BW and SAP HANA entities used by the analysis applications (InfoProviders, queries, query views) are available in the BW system connected to the target BI platform system. With SAP HANA, the relevant SAP HANA data sources (analytic views, calculation views) need to exist in the corresponding SAP HANA system.

Providing the images in the target BI platformImages are referenced by their name and location in analysis applications. After transporting analysis applications to the target BI platform, you need to transport the referenced images to the same location on the target platform and keep the same names.

TipWe recommend using a common root folder for all images and icons on all BI platform instances. This will make it simpler to transport analysis applications and the referenced images or icons between different BI platform systems.

NoteMake sure that the BI platform instances are installed with the same language. Otherwise it might not be possible to find certain folder names in the different instances.





8 Troubleshooting

8.1 Activating runtime traces

You can record traces to analyze problems in the design tool.

1. In the design tool, choose Tools Preferences Application Design Support Settings .2. Select the Activate runtime trace checkbox.3. Click OK.

The system will create a trace file on your local hard drive. The trace file is a text file that contains a log of the activities performed in the design tool's layout editor and in the executed analysis application. It is stored in the <user home>\Analysis-workspace\com.sap.ip.bi.zen\repository\RSTT folder.The design tool also connects to the SAP NetWeaver BW system. This checks if the user requesting the trace has sufficient authorization to log traces (standard authorization object S_RS_RSTT). If this is the case, the SAP NetWeaver BW trace tool environment (transaction code RSTT in the connected BW system) is activated. In the BW system, a new trace containing your navigation steps will be created. To replay and maintain this trace, see “Trace Tool Environment ”, under “Business Warehouse”, in the SAP NetWeaver Library , at http://help.sap.com.The recorded traces help us to resolve problems that you report to SAP as customer messages.

8.2 Activating SAP JCo traces

You can record SAP JCo traces to analyze problems in the design tool.

1. In the design tool, choose Tools Preferences Application Design Support Settings .2. Select the Activate SAP JCo Trace checkbox.3. Click OK.4. Restart the design tool to enable the SAP JCo trace.

The SAP JCo trace is activated and the trace level is set to 8. You can collect all the SAP JCo trace files using the Collect Support Information function. The recorded traces help us to resolve problems that you report to SAP.Related LinksCollecting support information [page 46]

Administrator Guide: SAP BusinessObjects Design StudioTroubleshooting


http://help.sap.com

8.3 Downloading analysis applications

Application designers can download analysis applications from the BI platform to their PC. This function makes it possible to provide the original source code of analysis applications to SAP and helps us to resolve problems that you report to SAP as customer messages.

1. Choose Help Support Download... in the design tool.2. In the Download Application dialog box, select the required analysis application from the corresponding folder

of the BI platform.3. Click Download.4. In the Browse for Folder dialog box, select the required folder on your local PC.5. Click OK.

You can attach the analysis application file to your customer message.

8.4 Collecting support information

If you encounter problems in the design tool, you can collect the relevant information to send to SAP in a zip file.

1. In the design tool, choose Help Support Collect Support Information... .2. Select the target folder for the zip file.3. Click OK.

The support information is saved in the file DS_Support.zip.

4. To view the content of the zip file, click View....5. Click OK.

You can attach the zip file to a customer message and send it to SAP.

8.5 Error analysis in scripting

If analysis applications contain invalid scripts (scripts with syntax errors or that pass invalid parameter values), these are aborted at runtime. In the current version, users are not notified when a script is aborted.Application designers can use the application methods log and alert to analyze where scripts are aborted.For more information, see “Error analysis in scripting”, under “Scripting for user interaction enablement”, in the Application Designer Guide: Designing Analysis Applications , under Help Help Contents in the design tool.



8.6 Problems with connections

If a connection between the SAP BusinessObjects Design Studio design tool and the SAP NetWeaver BW system is made using a message server, make sure that the message server port is set in the services file for the client PC (where the design tool is installed). The services file is located under <WINDOWS ROOT>\windows\system32\drivers\etc\services. If the services file does not contain the message server port, the system cannot connect to the BW system and the following error message appears: com.sap.conn.jco.JCoException: (102) JCO_ERROR_COMMUNICATION: Connect to message server host failed.In this case, we recommend installing the design tool on a client PC with SAP GUI installed. SAP GUI automatically provides the necessary information about the message server in the services file.Related LinksDefining connections to BI back-end systems in local mode [page 49]System requirements for the design tool installation [page 16]

8.7 Managing logs in the design tool

You can view error messages in the design tool's Error Log view. To open this view, choose View Error Log .Press the Export Log button (in the upper right corner of the Error Log view) to save the error messages. The exported error log files help us to resolve problems that you report to SAP as customer messages.For more information, see “Problems view”, under “Concepts”, in the Workbench User Guide , under HelpHelp Contents in the design tool.

8.8 Managing logs on the BI platform

For logging and tracing, SAP BusinessObjects Design Studio uses the mechanisms of the BI platform.For more information, see “Managing and Configuring Logs”, in the Business Intelligence Platform Administrator Guide, at http://help.sap.com/bobip40.




9 Administering Local Mode in the Design Tool

From local mode to full mode in SAP BusinessObjects Design StudioWhen starting the SAP BusinessObjects Design Studio design tool after installation, it is launched in local mode in the default setting. Local mode can be used to create first analysis applications for presenting and evaluating SAP BusinessObjects Design Studio with users at customer side. You can save the analysis applications on your local machine. Without integration to the BI platform, the technical prerequisites are on a minimal level and an easy and fast evaluation can take place. The key users of a company - possibly together with consultants - can investigate whether SAP BusinessObjects Design Studio is able to cover their company's analysis and reporting requirements. After a successful evaluation phase, and with the decision to implement SAP BusinessObjects Design Studio, the requirements for the BI platform need to be provided.Once the BI platform infrastructure has been set up, application designers who have been working in local mode can easily switch the default startup mode in the Preferences dialog box and connect to the BI platform. Application designers can then upload their locally saved analysis applications to the BI platform. For more information, see “Working with the Local Mode of the Design Tool”, in the Application Designer Guide: Designing Analysis Applications , under Help Help Contents in the design tool.

RestrictionLocal mode in the design tool is not designed with offline use of the design tool in mind. You should not use it for downloading analysis applications from the BI platform, changing and saving them locally, and uploading the applications again to the BI platform.

Different administration tasks for local modeThis section provides information on differences when installing and configuring SAP BusinessObjects Design Studio in local mode. Administration tasks that are similar to full mode in SAP BusinessObjects Design Studio (with the integration to the BI platform) are not listed separately in this section. The relevant information is contained in the sections above.Related LinksMaintaining settings in the design tool in local mode [page 50]

9.1 InstallationTo use SAP BusinessObjects Design Studio in local mode, you just need to install the SAP BusinessObjects Design Studio design tool.Before defining SAP NetWeaver BW connections, you need to install SAP GUI. This is required for using SAP logon, which makes it possible to add SAP NetWeaver BW data sources.Before defining SAP HANA connections, you need to install the SAP HANA client tools. These are required for using the ODBC Data Source Administrator, which makes it possible to add SAP HANA data sources.For more information, see the SAP HANA Database - Client Installation and Update Guide at http://help.sap.com/hana_appliance.


Administrator Guide: SAP BusinessObjects Design StudioAdministering Local Mode in the Design Tool



Related LinksInstalling the design tool of SAP BusinessObjects Design Studio [page 16]

9.2 Configuration

9.2.1 Defining connections to BI back-end systems in local modeBefore designers can add data sources to their analysis applications, you have to create connections to the BI back-end systems containing the business data. SAP BusinessObjects Design Studio can access SAP HANA systems or SAP NetWeaver BW systems as BI back-end systems.

NoteIf you have already added SAP NetWeaver BW systems in the SAP Logon dialog box, these systems are automatically available in the design tool.

1. Open the design tool and choose Tools Preferences Application Design Backend Connections .2. Decide whether to create a SAP NetWeaver BW connection or a SAP HANA connection.

○ For SAP NetWeaver BW connections, click Launch SAP Logon in the upper right corner of the Connections maintained in SAP Logon area.

1. In the SAP Logon dialog box, click New .2. Add the required system parameters.

○ For SAP HANA connections, click ODBC Data Source Administrator in the upper right corner of the SAP HANA Connections maintained in ODBC Data Source Administrator area.

1. Press Add....2. Select the driver HDBODBC32.

NoteThis driver is only available if the SAP HANA client tools are installed on your local machine.

3. Press Finish.4. Enter the SAP HANA system in the Data Source Name field.5. Enter the corresponding server and port in the Server:Port field.6. Press OK. Then press OK again.

3. To display newly defined connections in the corresponding table, click Reload All Connections.4. To close the dialog box, press OK.

The defined connections will be listed in the Select Connection dialog box, which appears after browsing for a different connection than the preselected one in the Add Data Source dialog box. For more information, see the Application Designer Guide: Designing Analysis Applications under Help Help Contents in the design tool.



9.2.2 Maintaining settings in the design tool in local modeYou can define settings for the design tool in the Preferences dialog box. To start the Preferences dialog box, choose Tools Preferences Application Design .Change the default values as required and choose Apply to make these values effective. If you want to reset the default values, choose Restore Defaults. To close the Preferences dialog box, press OK.In this chapter, only settings which are important or only available in local mode are explained.

GeneralYou can switch the startup mode. In the default setting, the design tool starts in local mode after installation. If you want to use SAP BusinessObjects Design Studio integrated into the BI platform, click Connect to BI Platform. After restarting the design tool, you need to log on to the BI platform.

NoteIn the Logon to SAP BusinessObjects BI Platform dialog box, you can still decide to log on locally, even if the startup mode is set to Connect to BI Platform, by clicking Skip. The design tool starts in local mode.

Embedded Web ServerIf you want to test your application on a mobile device, you need to allow external access to the embedded Web server. Select the Allow external access to embedded Web server checkbox. The design tool must be running on your PC.

CautionNote that allowing external access is a security risk. Everyone connected to the same network can potentially access all of your applications and can see the same data that you can (as the applied data authorizations are the same).

RestrictionWith SAP HANA data sources used in the analysis application, the application designer of the PC that the design tool is running on has to enter his/her credentials and click Log on in the Logon to <SAP HANA system> dialog box, before other users can open the analysis application on an iPad. With BW data sources used in the analysis application, you can activate Single-Sign On. The application designer of the PC that the design tool is running on has to confirm client and language though (or has to change these entries if required) and click Log on in the Logon to <BW system> dialog box, before other users can open the analysis application on an iPad. Due to technical restrictions the Logon to <BW system> dialog box always appears on the PC with the design tool that is running.

Application Preview In local mode, the language of message texts and tooltips is defined by the language setting in the Web browser. The format for numbers, dates and times varies according to the defined language setting in the Web browser.For more information on settings that are available in both startup modes, see the corresponding chapter for the BI platform mode in this guide.Related LinksMaintaining settings in the design tool [page 24]



9.3 Security

9.3.1 User management and authentication in local modeYou have to configure user accounts in the following systems:

● Connected SAP NetWeaver BW systemsFor more information, see “Identity Management”, in the SAP NetWeaver Library , at http://help.sap.com/nw731.

● Connected SAP HANA systemsFor more information, see “User Management”, in the SAP HANA Security Guide , at http://help.sap.com/hana_appliance.

9.3.2 Authentication and Single Sign-On in local modeSingle Sign-On when using SAP NetWeaver BW data sourcesSingle Sign-On works if the following conditions are met:

Secure Network Communications (SNC) is installed on each client PC. For more information, see “Secure Network Communications (SNC)”, in the SAP NetWeaver Security Guide , at http://help.sap.com .Each user (application designer or application user) has a user account in the connected SAP NetWeaver BW system. For more information, see “Identity Management”, in the SAP NetWeaver Library, at http://help.sap.com.You have selected the Activate Secure Network Communication checkbox for the relevant SAP NetWeaver BW system connection in the SAP Logon dialog box.

Users sign on once to the client-based Secure Network Communications (SNC) with their credentials.Application designers can connect to the BW systems without having to enter their BW user name and password in the Logon to <BW system> dialog box when inserting a BW data source in the design tool. They can change the client and the language of the BW system in this dialog box however.Application users can connect to the BW systems without having to enter their BW user name and password when analyzing BW data in analysis applications.

RestrictionWhen using the external access to enable other users to view your analysis applications, on an iPad for example (by clicking the Allow external access to embedded Web server checkbox in the Preferences dialog box), Single Sign-On activated for your BW data sources does not work as expected. The application designer for the PC where the design tool is running has to confirm client and language (or change these entries if required) and click Log on in the Logon to <BW system> dialog box, before other users can open the analysis application on an iPad. Due to technical restrictions, the Logon to <BW system> dialog box always appears on the PC where the design tool is running.

Single Sign-On when using SAP HANA data sourcesCurrently Single Sign-On is not supported for SAP HANA system connections.Application designers have to enter their user credentials in the Logon to <SAP HANA system> dialog box when inserting a SAP HANA data source in the design tool.Application users have to enter their user credentials when analyzing SAP HANA data in analysis applications.

Restriction







http://help.sap.com

http://help.sap.com

http://help.sap.com

When using external access to enable other users to view your analysis applications, on an iPad for example (by clicking the Allow external access to embedded Web server checkbox in the Preferences dialog box), the application designer for the PC where the design tool is running has to enter his/her credentials and click Log on in the Logon to <SAP HANA system> dialog box, before other users can open the analysis application on an iPad.

9.3.3 Authorizations when using local modeFor security reasons, make sure that users do not have administrator rights on client PCs. Otherwise, users could access other user's analysis applications or trace files.For data access management, SAP BusinessObjects Design Studio uses the authorization concept of the corresponding back-end system.

With SAP NetWeaver BW, users need analysis authorizations to view the data of authorization-relevant characteristics in a query or in a query view that is used as a data source in an analysis application. For more information, see “Authorizations”, under “Business Warehouse”, in the SAP NetWeaver Library , at http://help.sap.com/nw731.With SAP HANA, users need analytic privileges to view the data of the SAP HANA data sources (Analytic Views or Calculation Views) that are used in an analysis application. For more information, see “Analytic Privileges”, under “Authorizations”, in the SAP HANA Security Guide, at http://help.sap.com/hana_appliance.

9.3.4 Network and communication security in local modeYour network infrastructure is extremely important for protecting your system. Your network needs to support the communication required for your business needs without allowing unauthorized access.The following diagram illustrates the components involved and provides an overview of the communication channels when using SAP BusinessObjects Design Studio in local mode:






The following components are involved:

The Web browser and the design tool on the application designer's local computerThe storage tier with the BI back-end systems (SAP NetWeaver BW or SAP HANA)

The communication process is as follows:The application designer creates a new application or opens an existing one. The embedded Web browser in the layout editor of the design tool opens. It connects with the embedded Web server of the design tool. This communication is performed using a Web service connection with HTTP protocol.If the application designer chooses Application Execute Locally , the same communication process applies as described above. The only difference is that the analysis application is displayed in a separate Web browser window outside the design tool.Each time the application designer inserts BW data into the application (by adding a new data source or selecting members in the script editor for example), the design tool on the client PC requests data from the BW server. This communication is performed using a synchronous JCo Remote Function Call (RFC) connection. You can protect this RFC connection using Secure Network Communications (SNC). For more information, see “Transport Layer Security”, in the SAP NetWeaver Security Guide , at http://help.sap.com.Every time the application designer inserts SAP HANA data into the application, the design tool on the client PC requests data from the SAP HANA server. This communication is performed using a Java Database Connectivity (JDBC) connection. You can protect this connection using the Secure Sockets Layer (SSL) protocol. For more information, see “Secure communication”, in the SAP HANA Security Guide, at http://help.sap.com .

9.3.5 Data storage security in local modeAnalysis applicationsApplication designers store the analysis application files in the <user home>\Analysis-workspace\com.sap.ip.bi.zen\repository folder. They can also store images and icons that they use in their analysis applications in this folder, in a subfolder of this directory, or in the internet or intranet.You can protect access to the analysis application files by assigning access rights. To ensure that the locally stored analysis applications cannot be viewed by non-authorized users, we advise against giving users administrator rights on the client PCs.

CautionNote that allowing external access to the embedded Web server of the design tool (in the Preferences dialog box under Tools Preferences Application Design Embedded Web Server ) is a security risk. Everyone connected to the same network can potentially access all of this user's applications and can see the same data that s/he can (as the applied data authorizations are the same).

Analysis applications historyThe analysis applications history in the Application menu is persisted in the user's cache file <home directory>\.sap\com.sap.ip.bi\cache. The content of this file is encrypted using Eclipse secure store technology.

Data source historyThe data source history in the Add Data Source dialog box is persisted in the user's cache file <home directory>\.sap\com.sap.ip.bi\cache. The content of this file is encrypted using Eclipse secure store technology.Related LinksData access security in local mode [page 54]



http://help.sap.com

http://help.sap.com

9.3.6 Data access security in local modeAllowing external access to the embedded Web server of the design tool is a security risk. You can activate external access in local mode in the Preferences dialog box, under Tools Preferences Application DesignEmbedded Web Server .When this function is activated, and the design tool is running, everyone connected to the same network can potentially access all of this user's applications (using the application launch URL, which is displayed in the Web browser when you execute the application).The applied data authorizations for external access are the same as for the user that you specified in the back-end connections. Everyone can therefore see the same data that this user can.

NoteNote that this does not just apply to applications that are currently running. It affects all applications that the user has created in his/her workspace.

9.4 Language and regional settings in local mode

The following chapter describes settings that are different in local mode.

Language of master data and metadataTexts for data from the back-end systems, such as master data and metadata of the selected data source, are visible in the design tool's layout editor and in the analysis applications that are running. These texts are language-dependent and are displayed in the language specified for the back-end system.Application designers can specify the language of the back-end system when adding a data source to an analysis application. After selecting the required system in the Select Connection dialog box, application designers can enter the required language in the logon dialog box. If the application designer does not enter a language value in the logon dialog box, the data texts are displayed in English.

Language of message texts in analysis applications The language of message texts and tooltips is defined by the language setting in the Web browser.

Regional formats for numbers, dates and times The format for numbers, dates and times varies according to the defined language setting in the Web browser.

9.5 Troubleshooting

9.5.1 Collecting support information in local modeIf you encounter problems in the design tool, you can collect the relevant information to send to SAP in a zip file.

1. In the design tool, choose Help Support Collect Support Information... .



2. Select the target folder for the zip file.3. Click OK.4. Choose the analysis applications you want to add.5. Click Package.

The support information is saved in the file DS_Support.zip.

6. To view the content of the zip file, click View....7. Click OK.

You can attach the zip file to a customer message and send it to SAP.



IndexAadd rights 43Additional documentation 5Analysis Application Service 10, 22analysis authorizations 29Analysis workspace 53analytic privileges 29application recovery 24assertion ticket 28

Bback-end system 49BW system connection 20BW system connections 19

Ccache file 53communication channel 52connection 49cube 20CUID 44

Ddata source 49data source connections 19date/time format 37documentation set 5

Eedit rights 43error log 47external access 54

Iinstallation 16

JJCo 52JCO_ERROR_COMMUNICATION 47JDBC 52

Llanguage 35

Mmaster data texts 35member selection 24message texts 35meta data texts 35mobi.properties file 24mobile category 24Mobile Services 10

Nnetwork port 24network security 52number format 37

OODBC Data Source Administrator 48OLAP Connections 19

Ppreferences 24, 45prerequisites 16problems view 47promotion management 44

RRSTT 45


Administrator Guide: SAP BusinessObjects Design StudioIndex

SSAP BusinessObjects Mobile 10, 24SAP GUI 47, 48SAP HANA connection 20SAP HANA system connections 19scripting 46Secure Network Communications 51Secure Network Communications (SNC) 52Secure Sockets Layer (SSL) 52services file 47settings file 53silent installation 14single sign-on 28, 51sizing 26SNC 51supported languages 36system requirements 10, 16system services file 20

Ttemplates folder 24tooltips 35trace file 24, 45trace tool environment 45transport 44

Uuser account 28

Vview rights 43virus scanner 34

WWDeploy tool 12

Administrator Guide: SAP BusinessObjects Design StudioIndex


www.sap.com/contactsap

© 2013 SAP AG or an SAP affiliate company. 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. National product specifications may vary.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.SAP 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.Please see http://www.sap.com/corporate-en/legal/copyright/index.epx for additional trademark information and notices.

http://www.sap.com/contactsap

http://www.sap.com/corporate-en/legal/copyright/index.epx

http://www.sap.com/corporate-en/legal/copyright/index.epx