SAP Business Client for Desktop 6.

0 Setup
October 2015

Contents
Client-side configuration and installation of SAP Business Client for Desktop 6.0 together with SAP
GUI for Windows 7.40

System connections
Client configuration
Provisioning
Security settings

Server-side configuration
Enable NWBC core functionality
Activate Side Panel
User menus role maintenance

Further information / links

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

Installing SAP Business Client for Desktop

General approach
Client-side

1. Download SAP
Business Client from
SAP Support Portal

2. Create and distribute system

connections* and client
configuration

3. Install SAP Business Client for

Desktop together with SAP GUI
for Windows 7.40

4. Create and distribute

Internet Explorer
security options

SAP UI Landscape
NwbcOptions.xml
Registry entries
Server-side

5. Configure AS ABAP backend

6. Define user roles

HTTP framework, required ICF services

authentication, SNC,
/UI2/NWBC_CFG_CUST

*Fiori Launchpad connection, NWBC connection, SAP logon connection, and SAP shortcut
2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

1. Downloading SAP Business Client for

Desktop

Downloading SAP Business Client 6.0

1/2

1) Download

Download it from the SAP Support Portal

https://support.sap.com/home.html

The desktop version of the SAP

Business Client is available free of
charge!
2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

Downloading SAP Business Client 6.0

2/2

1) Download

1) Installations & Upgrades

2) Choose A-Z option

3) Select B

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

2. Creating and distributing system connection

and client configuration

Creating system connections

(1) SAP UI Landscape

2) System Connection

For both SAP Business Client and SAP GUI for Windows 7.40, data
required for system logon is defined based on the new SAP UI Landscape
files. The administrator configuration file typically contains:

Message server hosts and ports

Routers

Predefined SAP Fiori Launchpad connections (new)

Predefined SAP Business Client connections

Predefined SAP GUI connections

Predefined search providers

For information on the migration of the previous connection configuration,

see:

Help Portal: Migration of Configuration Data

SAP Note 2075150

The SAP UI Landscape administrator configuration file replaces former NWBC configuration settings for
system connections and search providers in %ALLUSERSPROFILE%\SAP\NWBC\NwbcOptions.xml
2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

Creating system connections

(2) New Connection Type: Fiori Launchpad

2) System Connection

With the new fiori launchpad connection SAP Business client acts as a
Windows-based desktop browser for the SAP Fiori launchpad with the
ability to launch classic Dynpro applications (SAP GUI transactions):

Protocol is either http:// or https://

Syntax for the URL is as follows:

http(s)://<server>.<domain>.<ext>:<port>/<path>

Default path:/sap/bc/ui5_ui5/ui2/ushell/shells/abap/FioriLaunchpad.html

SAP Fiori launchpad

For information on the SAP Fiori Launchpad configuration, see:

Help Portal: Setting Up the Launchpad

Help Portal: Customize the Launchpad URL

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

Distributing system connections

Provision options for administrator configuration file

2) Distributing Connection

Push

Pull

Administrator distributes the administrator configuration file from his

central data storage repository to the clients

UI client retrieves administrator configuration file from a central storage

such as a remote share or a Web service platform

%ProgramData%/SAP/<filename>.xml

%APPDATA%\SAP\Common\
SAPUILandscape.xml

Retrieves data
from
administrator
configuration file

Web Service Access

Client initiates pull request.

Read and Write:

User configuration file

NWBC, SAP GUI for Windows,

SAP GUI for Java

Help Portal: Provision of Administrator Configuration File

SAP Front End Installation Guide, Configuration with SAP NetWeaver Business Client
2015 SAP SE or an SAP affiliate company. All rights reserved.

%APPDATA%\SAP\Common\
SAPUILandscape.xml

Cache and Read:

Administrator
configuration file

More information:

Remote Share:
\\<Server>\<...>\UILandscape.xml

Read and Write:

User configuration file

NWBC, SAP GUI for Windows,

SAP GUI for Java

Public

10

Creating and distributing client configuration

NwbcOptions.xml and registry entries

2) Client Configuration

Administrator configuration, such as user settings are located in the following folder:
%ALLUSERSPROFILE%\SAP\NWBC

Predefine default values (changeable by end-users)

Prevent end-users from changing values
Prevent end-users from creating new entries
Control runtime behavior

Provisioning options:
Push to clients (%ALLUSERSPROFILE%\SAP\NWBC\NwbcOptions.xml) or provide centrally,
once defining the location in %ALLUSERSPROFILE%\SAP\NWBC\NwbcRemoteOptions.xml
For more information, see

Comments in the configuration file template

%ALLUSERSPROFILE%\SAP\NWBC\NwbcOptions.xml.template
Help Portal: SAP Business Client Settings (NWBCOptions.xml)
Help Portal: Administrator Configuration Tips

SAP UI landscape options

Set registry entries separately or together with installation via installation server

For more information about the installation server, see

SAP Front End Installation Guide, Configuring Packages and Scripting Events

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

11

3. Installing SAP Business Client and

SAP GUI for Windows 7.40

Installing SAP Business Client

1/2

2) Install

We recommend to install SAP Business Client together

with SAP GUI for Windows 7.40.
Please be aware that an automatic switch to the SAP UI
Landscape takes place.

A common installation package is planned for the next

7.40 Compilation DVD; in the meantime, you can add the
SAP Business Client 6.0 installation to 7.40 Compilation 2
(download via SAP Support Portal).
For more information, see:

Front-End Installation Guide, which is stored in the

Docu directory both on the CD and the SAP
NetWeaver SAPSetup - SAPs Front-End Software
Deployment Tool guide ( Workstation Installation
Help.chm)

Help Portal: Installing SAP Business Client with SAP

GUI

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

13

4. Creating and distributing Internet Explorer

security options

Distributing Internet Explorer security options

4) Security

Make sure server addresses corresponding to the system connections

are covered by the Local intranet or the Trusted sites zone.
For more information, see Help Portal: Security Zones in Internet Explorer

SAP Business Client renders HTML content using the Internet Explorer and thus uses the Internet Explorer zone model.
The Internet Explorer zone model is also used for navigation to SAP GUI transactions.
2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

15

5. Configuring the AS ABAP back end

5.1 Configuring the AS ABAP back end:

SAP Business Client core features
1.

Configure HTTP(S) communication, authentication, SSL and SNC on the AS ABAP

2.

Activate the NWBC server runtime

3.

Make system-specific settings (NWBC customizing, whitelist)

5.1.1 General server configuration

Proposal

5) Configure ABAP Back End

Step 1: Enable HTTP(S) communication configure ICM

Help Portal: Administration of the Internet Communication Manager

Help Portal: HTTP(S) Settings in ICM

https://<SERVER>:<PORT>/sap/bc/echo

Test: Call BSP or WDA application in browser

Step 2: Configure the AS ABAP to support SSL and SNC

Help Portal: Installing the SAP Cryptographic Library on the AS ABAP

Help Portal: Secure Network Communications (SNC)

https://<SERVER>:<PORT>/sap/bc/bsp/sap/it00

Step 3: Configure authentication

Help Portal: Authentication and Single Sign-On with SAP Business Client

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

18

5.1.2 Activate the NWBC server runtime

5) Configure ABAP Back End

Activate Business-Client specific ICF services

Help Portal: ICF Configuration
Help Portal: Active Services in ICF (UI Services)
Test: Launch NWBC for HTML (Test the NWBC ICF service in
transaction SICF)
SAP recommends the use of the server runtime for SAP NetWeaver UI services
for the following reasons:
New UI services features can be applied to SAP Business Client
New UIs and latest developments based on SAPUI5 and SAP NetWeaver Gateway
can be used with NWBC
SAP NetWeaver UI services can be supported by the provision of small-sized
support packages
New UI features are shipped with support packages within a few months

The server runtime is required for transfer of system and user data. The following two server runtimes are available:
Server runtime for SAP NetWeaver user interface services as of SAP User Interface Add-On 1.0 SPS 04 for SAP NetWeaver and SAP NetWeaver 7.4 SPS 03
Server runtime for SAP Business Client

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

19

5.1.3 Make system-specific settings

(customizing, and whitelist)

5) Configure ABAP Back End

This is already fine-tuning

In NWBC customizing, the administrator can for example

Define a welcome message for the Index page

Specify a theme

For more information, see

Help Portal: Definition of Configuration Parameters in Customizing (server runtime for NW UI services)

Help Portal: Definition of Configuration Parameters with Table NWBC_CFG (server runtime for NWBC)

Recommended

A whitelist can be defined on top of the Internet Explorer security zone model.
For more information, see

Help Portal: Whitelist

Help Portal: Defining a Whitelist in HTTP_WHITELIST

Help Portal: Security Zones in Internet Explorer

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

20

5.2 Configuring the AS ABAP back end:

Activating the side panel
1.

Activate the side panel business function

2.

Assign side panel roles to users

3.

Enable data transfer to side panels

4.

Activate SAP GUI scripting

5.2.1 System settings:

Activate side panel business function 1/2

5) Configure ABAP Back End

Open the Easy Access Menu and navigate to:

> Tools
> ABAP Workbench
> Development
> Switch Framework
> Business Function

Alternatively, call transaction SFW2.

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

22

5.2.1 System settings:

Activate side panel business function 2/2

5) Configure ABAP Back End

Enter business function ERP_CA_SIDEPANEL

and choose Activate
The business function documentation is available
in the SAP Help Portal:
Deutsch / English

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

23

5.2.2 System settings:

Assign side panel roles to users 1/3

5) Configure ABAP Back End

As of ECC 6.0 SP07, a new generic side

panel role is available:
SAP_BSSP_SIDEPANEL_ALL

To enable the side panels for the users, you

must assign the side panel roles in User
Maintenance (SU01).

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

24

5.2.2 System settings:

Assign side panel roles to users 2/3

5) Configure ABAP Back End

Alternatively, assign the user to the role in

Role Maintenance (PFCG)
For more information, see the SAP Help Portal:
Deutsch / English

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

25

5.2.2 System settings:

Assign side panel roles to users 3/3

5) Configure ABAP Back End

If the SP status is ECC 6.0 SP06 or below,

specific roles need to be assigned

For more information, see the SAP Help Portal:

Deutsch Sidepanel einrichten
English Setting Up the Side Panel

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

26

5.2.3 System settings:

Enable format conversion for data transfer from canvas to side panels

5) Configure ABAP Back End

Execute HTTP Service Hierarchy

Maintenance (Transaction SICF)
> Enter Hierarchy Type SERVICE

> Enter Service Path /sap/bc/ui2/nwbc/

(server runtime for NW UI services)
> Execute

Ensure that the SICF service nwbc_ext2int

responsible for data format conversion is
active

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

27

5.2.4 System settings:

Enable global data transfer to side panels 1/2

1.

In Object Navigator (transaction SE80),

select Web Dynpro Comp./Intf.
WD_GLOBAL_PARAMETERS.

2.

Navigate to Web Dynpro application

WD_GLOBAL_SETTING. Set the focus to
the object and choose Test/Execute (F8).

5) Configure ABAP Back End

A browser window opens.

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

28

5.2.4 System Settings:

Enable global data transfer to side panels 2/2

3.

Go to change mode and open section

Side-Panel.

4.

Activate the 2 Web Dynpro parameters

WDSIDEPANELREMOTECONSUMER
and
WDSIDEPANELREMOTEPRODUCER.

5.

Save changes.

5) Configure ABAP Back End

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

29

5.2.5 Activate SAP GUI scripting approach 1

5) Configure ABAP Back End

1.

Start the Profile Parameter Maintenance

(transaction RZ11).

2.

Enter parameter sapgui/nwbc_scripting, and

choose Display.
Attention: parameter name is case sensitive!

3.

Choose Change Value.

4.

Set the value to TRUE and save changes.

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

30

5.2.5 Activate SAP GUI scripting alternative approach

5) Configure ABAP Back End

1.

Start the Profile Parameter Maintenance

(transaction RZ11).

2.

Enter parameter sapgui/user_scripting and

choose Display.
Attention: parameter name is case sensitive!

3.

Choose Change Value.

4.

Set the value to TRUE and save changes.

5.

Repeat for the parameter

sapgui/user_scripting_set_readonly and set
the value to TRUE.

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

31

6.

Defining user roles for SAP Business

Client 6.0

Role-based navigation
6) Define Roles

General
Roles are used to define authorization settings as well
as the navigation structure used by the UI client
Roles match the real life roles that people play within a
work environment

SAP Business Client

The Business Client runtime retrieves all roles assigned
to a specific user and makes the navigation structure
available to the shell
If the role doesnt provide a navigation structure,
Business Client uses the SAP Menu
For Web AS connections, maintain the navigation in
transaction PFCG, tab Menu
A set of attributes specifically dedicated to the navigation
frame presentation has been introduced to PFCG in the
last releases
Other Node Details and Menu Options
Help Portal: Role Maintenance in PFCG
2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

33

Role-based navigation merging of navigation trees

6) Define Roles

General
If a user has more than one role assigned, the entries in the navigation
tree appear merged as in one role
Two entries that are the same in two roles, appear only once
The role order depends on the sort index defined for the role
Help Portal: Merging of Navigation Trees

Rules
If roles contain identical folders in equal hierarchies, their folder contents
are merged and redundant folders are not visible
Identical folder means that the following attributes are identical:
Name of the entry (object field)
Level of the entry in the tree
Type of the entry (standard entry, side panel or link collection)
Referenced entry (for side panel and link collection)

The entries of the merged folder are sorted according to the sort index,
ie. entries from the role with the lower sort index come first

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

34

Role-based navigation: sort index

6) Define Roles
ZAP_NWBC_HOME
Sort index 0 (home role)

ZAP_NWBC_USER_STANDARD
Sort index 10

ZAP_NWBC_USER_POWER
Sort index 100

Newer Business
Client versions

NWBC 3.5
2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

35

Further information / links

Documentation

For detailed documentation of the Netweaver

Business Client please refer to the SAP Help Portal
Latest documentation regarding Business Client 6.0
see on SAP Community Network (SCN): Getting
Started

2015 SAP SE or an SAP affiliate company. All rights reserved.

SAP Note 2201009 contains details about the patches

for SAP Business Client

Public

37

SAP Business Client Administration Guide (Excerpt 1)

Installation and Client Configuration
SAP Business Client for Desktop Installation
o Installing SAP Business Client (Standalone)
o Installing SAP Business Client with SAP GUI
o Windows Terminal Server Installation
Administrator Configuration
Connection Configuration
o SAP UI Landscape
o Migration of Configuration Data
o Provision of Administrator Configuration File
SAP Business Client Settings
Administrator Configuration Tips
Configuring Support Information
Using SAP Business Client with a Load Balancer

2015 SAP SE or an SAP affiliate company. All rights reserved.

Server Configuration
Server Runtime for SAP NetWeaver User Interface Services
o Migrating to the Server Runtime for UI Services
o Configuring the Server Runtime for UI Services for SAP
Business Client
o HTTP(S) Settings in ICM
o Active Services in ICF (UI Services)
o Settings for Fully Qualified Domain Names
o Configuring Authentication on the Server
o Cockpits
o Definition of Configuration Parameters in Customizing
Server Runtime for SAP Business Client
o HTTP(S) Settings in ICM
o Active Services in ICF
o Settings for Fully Qualified Domain Names
o Configuring Authentication on the Server
o Cockpits
o Definition of Configuration Parameters with Table NWBC_CFG
Public

38

SAP Business Client Administration Guide (Excerpt 2)

Role Maintenance in PFCG
o PFCG Overview
o Navigation Tree
o Default Pages and Service Maps
o Menu
o Search Providers
o Side Panel
o Remote Systems
o Object-Based Navigation
o Merging of Navigation Trees

Security Aspects
Authentication and Single Sign-On with SAP Business Client
o ICF Configuration
o Security Zones in Internet Explorer
White List
o Enabling Single Sign-On with Secure Login Client for SAP
Business Client

Programming Aspects
Generating an External Startup URL for NWBC
Integrating the Context-Sensitive Side Panel

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

39

Further information about SAP Business Client

Join the SAP Community Network (SCN) for information
about the SAP Business Client:
http://scn.sap.com/community/netweaver-business-client

For more information on SAP Business Client and

its integration with SAPs UX strategy, see the UX
Explorer:
UX Explorer: SAP Business Client

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

40

 2015 SAP SE 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 SE or an SAP affiliate company.
SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP SE (or an SAP affiliate
company) in Germany and other countries. Please see http://global12.sap.com/corporate-en/legal/copyright/index.epx for additional trademark information and notices.
Some software products marketed by SAP SE and its distributors contain proprietary software components of other software vendors.
National product specifications may vary.
These materials are provided by SAP SE or an SAP affiliate company for informational purposes only, without representation or warranty of any kind, and SAP SE or its
affiliated companies shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP SE or SAP affiliate company 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.
In particular, SAP SE or its affiliated companies have no obligation to pursue any course of business outlined in this document or any related presentation, or to develop
or release any functionality mentioned therein. This document, or any related presentation, and SAP SEs or its affiliated companies strategy and possible future
developments, products, and/or platform directions and functionality are all subject to change and may be changed by SAP SE or its affiliated companies at any time
for any reason without notice. The information in this document is not a commitment, promise, or legal obligation to deliver any material, code, or functionality. All forwardlooking statements are subject to various risks and uncertainties that could cause actual results to differ materially from expectations. Readers are cautioned not to place
undue reliance on these forward-looking statements, which speak only as of their dates, and they should not be relied upon in making purchasing decisions.

2015 SAP SE or an SAP affiliate company. All rights reserved.

Public

41