SAP NetWeaver Business Client For Desktop 5.0 Setup

SAP NetWeaver Business Client for Desktop 5.
0
Setup
February 2015
Contents
Client-side configuration and installation of SAP NetWeaver Business Client for Desktop 5.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 NetWeaver Business Client (NWBC) for Desktop

General approach
Client-side
1. Download NWBC
for Desktop from
SAP Support Portal
2. Create and distribute NWBC &

SAP GUI system connections
and client configuration
3. Install NWBC 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
Public
1. Downloading NWBC 5.0 Desktop
Downloading NWBC 5.0

1/5
1) Download
Download it from the SAP Support Portal

https://support.sap.com/swdc
The desktop version of the

NetWeaver Business Client is
available free of charge!
Public

2/5
1) Download
1) Installations & Upgrades
2) Choose A-Z option
3) Select N
Public

3/5
1) Download
4) NetWeaver Business Client
5) Version 5.0
Public

4/5
1) Download
6) NetWeaver Business Client
Public

5/5
1) Download
7) Select the correct

download object*
8) Add to Download Basket

The NWBC is now available
for download!
* NOTE: You have 2 options:
Presentation 7.40 Compilation - a complete installation package containing NWBC 5.0 and SAP GUI for Windows 7.40
SAP NetWeaver Business Client 5.0 PLn - NWBC standalone installation; use this option if the user requires no transactions rendered in
SAP GUI for Windows.
Public
2. Creating and distributing NWBC & SAP GUI

system connections and client configuration
Creating system connections

SAP UI Landscape
2) System Connection
For both NWBC 5.0 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 NWBC connections
Predefined SAP GUI connections
Predefined search providers
For information on the migration of the previous NWBC and

SAP Logon 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
Public
11
Distributing system connections

Provision options for administrator configuration file
2) System 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
%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
12
Creating and distributing client configuration

NwbcOptions.xml and registry entries
2) Client Configuration
In the NwbcOptions.xml configuration file, the administrator can
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: NWBC 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
Public
13
3. Installing NWBC 5.0 & SAP GUI 7.40
Installing NWBC
1/2
1.
2.
2) Install
Open the .zip file

Navigate :
BD_NW_7.0_Presentation_7.40_Comp.1_
PRES1
GUI
WINDOWS
Win32
3.
Scroll down to SetupAll.exe
Public
15
Installing NWBC
2/2
4)
Choose SetupAll.exe
5)
Select both components: NWBC 5.0 and SAP GUI

for Windows 7.40 (compilation n).
3) Install
For more information:

Help Portal: Installing NWBC with SAP GUI (standard procedure)
Help Portal: Installing NWBC standalone (single installation still possible for separate patches or testing)
Public
16
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
NWBC for Desktop 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.
Public
18
5. Configuring the AS ABAP back end
5.1 Configuring the AS ABAP back end:

NWBC 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 in NWBC
Public
21
5.1.2 Activate the NWBC server runtime

Activate NWBC-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 NWBC
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 NetWeaver Business Client
Public
22
5.1.3 Make system-specific settings

(NWBC customizing, and whitelist)
This is already fine-tuning
In NWBC customizing, the administrator can for example
Define a welcome message for the Index page
Specify a theme
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.
Help Portal: Whitelist
Help Portal: Defining a Whitelist in HTTP_WHITELIST
Help Portal: Security Zones in Internet Explorer
Public
23
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
Open the Easy Access Menu and navigate to:

> Tools
> ABAP Workbench
> Development
> Switch Framework
> Business Function
Alternatively, call transaction SFW2.
Public
25

Activate side panel business function 2/2
Enter business function ERP_CA_SIDEPANEL

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

Assign side panel roles to users 1/3
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).
Public
27

Alternatively, assign the user to the role in

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

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
Public
29

Enable format conversion for data transfer from canvas to side panels
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
Public
30

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).
A browser window opens.
Public
31
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.
Public
32
5.2.5 Activate SAP GUI scripting approach 1

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.
Public
33
5.2.5 Activate SAP GUI scripting alternative approach

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.
Public
34
6. Defining user roles for NWBC 5.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 NetWeaver Business Client

The NWBC 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, NWBC
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
Public
36
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
Public
37
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
NWBC 4.0, 5.0
NWBC 3.5
Public
38
Further information / links
Documentation
For detailed documentation of the Netweaver
Business Client please refer to the SAP Help Portal
SAP Note 2030419 contains details about the patches

for NWBC 5.0
Public
40
SAP NetWeaver Business Client Administration Guide (Excerpt 1)

Installation and Client Configuration
NWBC for Desktop Installation
o Installing NWBC for Desktop (Standalone)
o Installing NWBC 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
NWBC Settings
Administrator Configuration Tips
Configuring Support Information
Using NWBC with a Load Balancer
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 NWBC
5.0 for Desktop
o HTTP(S) Settings in ICM
o Active Services in ICF (UI Services)
o Settings for Fully Qualified Domain Names
o System Security Settings
o Cockpits
o Definition of Configuration Parameters in Customizing
Server Runtime for SAP NetWeaver Business Client
o HTTP(S) Settings in ICM
o Active Services in ICF
o Settings for Fully Qualified Domain Names
o System Security Settings
o Cockpits
o Definition of Configuration Parameters with Table NWBC_CFG
Public
41
SAP NetWeaver 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 NWBC
o Configuring Authentication on the Server
o ICF Configuration
o Security Zones in Internet Explorer
White List
o Enabling Single Sign-On with Secure Login Client for NWBC
Programming Aspects
Generating an External Startup URL for NWBC
Integrating the Context-Sensitive Side Panel
Public
42
Further information about NWBC 5.0

Join the SAP Community Network (SCN) for information
about the SAP Netweaver Business Client:
http://scn.sap.com/community/netweaver-business-client
For more information on NWBC and its integration

with SAPs UX strategy, see the UX Explorer:
UX Explorer: NWBC
Public
43

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.
Public
44

SAP NetWeaver Business Client For Desktop 5.0 Setup

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

SAP NetWeaver Business Client For Desktop 5.0 Setup

Uploaded by

Copyright:

Available Formats

SAP NetWeaver Business Client for Desktop 5.

Further information / links

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

Installing SAP NetWeaver Business Client (NWBC) for Desktop

2. Create and distribute NWBC &

3. Install NWBC for Desktop

4. Create and distribute

5. Configure AS ABAP backend

6. Define user roles

HTTP framework, required ICF services

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

1. Downloading NWBC 5.0 Desktop

Downloading NWBC 5.0

Download it from the SAP Support Portal

The desktop version of the

Downloading NWBC 5.0

1) Installations & Upgrades

2) Choose A-Z option

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

Downloading NWBC 5.0

4) NetWeaver Business Client

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

Downloading NWBC 5.0

6) NetWeaver Business Client

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

Downloading NWBC 5.0

7) Select the correct

8) Add to Download Basket

* NOTE: You have 2 options:

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

2. Creating and distributing NWBC & SAP GUI

Creating system connections

Message server hosts and ports

Predefined NWBC connections

Predefined SAP GUI connections

Predefined search providers

For information on the migration of the previous NWBC and

Help Portal: Migration of Configuration Data

SAP Note 2075150

Distributing system connections

Administrator distributes the administrator configuration file from his

UI client retrieves administrator configuration file from a central storage

Web Service Access

Client initiates pull request.

Read and Write:

NWBC, SAP GUI for Windows,

Help Portal: Provision of Administrator Configuration File

Cache and Read:

Read and Write:

Creating and distributing client configuration

In the NwbcOptions.xml configuration file, the administrator can

Predefine default values (changeable by end-users)

Push to clients (%ALLUSERSPROFILE%\SAP\NWBC\NwbcOptions.xml) or provide centrally,

Comments in the configuration file template

SAP UI landscape options

For more information about the installation server, see

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

3. Installing NWBC 5.0 & SAP GUI 7.40

Open the .zip file

Scroll down to SetupAll.exe

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

Select both components: NWBC 5.0 and SAP GUI

For more information: