32
SAP ECC 6.00 Dec 2009 English User Guide User Experience Demo Kit for SAP Netweaver Business Client

SAP BAIO User Guide User Experience Demo Kit for NWBC En

Embed Size (px)

Citation preview

Page 1: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP ECC 6.00

Dec 2009

English

User Guide

User Experience Demo Kit for SAP Netweaver Business Client

SAP AGDietmar-Hopp-Allee 1669190 Walldorf

Page 2: SAP BAIO User Guide User Experience Demo Kit for NWBC En

Germany

Page 3: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP Best Practices User Guide - User Experience Demo Kit for SAP NWBC

Copyright

© Copyright 2009 SAP AG. All rights reserved.

No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG. The information contained herein may be changed without prior notice.

Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors.

Microsoft, Windows, Excel, Outlook, and PowerPoint are registered trademarks of Microsoft Corporation.

IBM, DB2, DB2 Universal Database, OS/2, Parallel Sysplex, MVS/ESA, AIX, S/390, AS/400, OS/390, OS/400, iSeries, pSeries, xSeries, zSeries, System i, System i5, System p, System p5, System x, System z, System z9, z/OS, AFP, Intelligent Miner, WebSphere, Netfinity, Tivoli, Informix, i5/OS, POWER, POWER5, POWER5+, OpenPower and PowerPC are trademarks or registered trademarks of IBM Corporation.

Adobe, the Adobe logo, Acrobat, PostScript, and Reader are either trademarks or registered trademarks of Adobe Systems Incorporated in the United States and/or other countries.

Oracle is a registered trademark of Oracle Corporation.

UNIX, X/Open, OSF/1, and Motif are registered trademarks of the Open Group.

Citrix, ICA, Program Neighborhood, MetaFrame, WinFrame, VideoFrame, and MultiWin are trademarks or registered trademarks of Citrix Systems, Inc.

HTML, XML, XHTML and W3C are trademarks or registered trademarks of W3C®, World Wide Web Consortium, Massachusetts Institute of Technology.

Java is a registered trademark of Sun Microsystems, Inc.

JavaScript is a registered trademark of Sun Microsystems, Inc., used under license for technology invented and implemented by Netscape.

SAP, R/3, xApps, xApp, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP Business ByDesign, and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and in several other countries all over the world. All other product and service names mentioned are the trademarks of their respective companies. Data contained in this document serves informational purposes only. National product specifications may vary.

These materials are subject to change without notice. These materials are provided by SAP AG and its affiliated companies ("SAP Group") for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty.

© SAP AG Page 3 of 25

Page 4: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP Best Practices User Guide - User Experience Demo Kit for SAP NWBC

Content

1 Introduction...........................................................................................................4

1.1 Welcome Pages....................................................................................................4

1.2 Gadgets Page Framework....................................................................................4

1.3 Where to download...............................................................................................4

1.4 Content of the Demo Kit........................................................................................5

2 Prerequisites.........................................................................................................5

2.1 SAP GUI...............................................................................................................5

2.2 Installation of the SAP NWBC 1.0.........................................................................5

2.3 Microsoft Internet Explorer 7.................................................................................5

3 Installation of the User Experience Demo Kit for SAP NWBC...............................6

3.1 Installation of the transport files for the SAP backend system..............................6

3.2 Assign the new demo roles to user.......................................................................9

4 How to start...........................................................................................................9

4.1 Logging on to your system via NWBC...................................................................9

4.2 Starting the User Experience Demo Kit for NWBC..............................................10

4.3 Predefined gadget pages....................................................................................10

5 How to change....................................................................................................11

5.1 User-specific personalization..............................................................................11

5.1.1 Personalize this Gadget.......................................................................................11

5.1.2 Replace this Gadget............................................................................................13

5.1.3 Insert a new Gadget............................................................................................14

5.2 Role specific layout.............................................................................................15

5.2.1 Accessing the configuration tables......................................................................15

5.2.2 General page layout............................................................................................16

5.2.3 Gadget Repository...............................................................................................17

5.2.4 Page Configuration..............................................................................................18

5.2.5 Configure the role................................................................................................18

6 Localization.........................................................................................................19

7 How to develop...................................................................................................19

8 Support...............................................................................................................20

8.1 Known issues......................................................................................................20

8.2 Troubleshooting..................................................................................................21

8.3 OSS Component.................................................................................................21

9 Appendix.............................................................................................................22

9.1.1 Development Package.........................................................................................22

9.1.2 Linkage to Business Roles..................................................................................22

© SAP AG Page 4 of 25

Page 5: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP Best Practices User Guide - User Experience Demo Kit for SAP NWBC

© SAP AG Page 5 of 25

Page 6: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP Best Practices User Guide - User Experience Demo Kit for SAP NWBC

User Experience Demo Kit for SAP NWBC

1 Introduction

1.1 Welcome Pages

The SAP NetWeaver Business Client is a rich desktop UI client that offers an easy-to-use single point of entry to SAP and non-SAP applications including appealing gadgets from the Internet.

The enhanced user experience demo kit for the SAP NetWeaver Business Client provides a great opportunity to maximize the audience's experience in your SAP Business All-in-One solution demos.

It provides preconfigured visually appealing welcome pages with key transactions in the underlying SAP Business All-in-One solution.

1.2 Gadgets Page Framework

1.3 Where to download

To download the User Experience Demo Kit visit http://service.sap.com/bestpractices

Choose Demonstrate & Experience

Choose User Experience

On the right-hand side, click Download the User Experience Demo Kit for SAP NWBC

© SAP AG Page 6 of 25

Page 7: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP Best Practices User Guide - User Experience Demo Kit for SAP NWBC

1.4 Content of the Demo Kit

The demo kit includes the following assets:

Transport files with the application, roles, and gadget repository

This User Guide

Presentation with further details on how to install the SAP NWBC

2 Prerequisites

2.1 SAP GUI

Before you start, please ensure to have the latest SAP GUI installed (Patch Level 15 or higher)

The latest release of the SAP GUI is available at http://service.sap.com/patches

Choose Support Packages and Patches - Entry by Application Group

Choose SAP Frontend Components

Choose SAP GUI FOR WINDOWS

Choose SAP GUI FOR WINDOWS 7.10 CORE

Choose Win32

Select the latest Patch level version and download the respective patch.

To install double click the downloaded file and follow the instructions of the installation wizard.

2.2 Installation of the SAP NWBC 1.0

Download the latest version of SAP NWBC 1.0 (version 1000.1.13.813 or higher)

The latest release of the SAP NWBC is available at http://service.sap.com/patches

Choose Support Packages and Patches - Entry by Application Group

Choose SAP Frontend Components

Choose NETWEAVER BUSINESS CLIENT

Choose NETWEAVER BUSINESS CLIENT 7.10

Choose Win32

Select the latest Patch level version and download the respective patch.

To install double click the downloaded file and follow the instructions of the installation wizard.

For further details on the required steps to setup the SAP NWBC both on the server and the client please refer to the documentation “NWBC_How_to_get_it_installed_and_running.pdf” which is also available within the demo kit package.

2.3 Microsoft Internet Explorer 7

As the NWBC uses the Microsoft Internet Explorer, please make sure you have version 7 installed on your local PC (Internet Explorer 6 and 8 are not supported).

http://www.microsoft.com/downloads/details.aspx?familyid=9AE91EBE-3385-447C-8A30-081805B2F90B&displaylang=en

© SAP AG Page 7 of 25

Page 8: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP Best Practices User Guide - User Experience Demo Kit for SAP NWBC

3 Installation of the User Experience Demo Kit for SAP NWBC

3.1 Installation of the transport files for the SAP backend system

Within the SDA file you can find two transport files named "K<number>.<system_id>" and "R<number>.<system_id>" which include the objects that need to be loaded into your SAP ERP system. These objects are in the Z*-namespace and include the BSP application Z_BAIO_SUE_1 within the package Z_BAIO_SUE_001.

Please ask your SAP system administrator to perform this task.

Extract the transport files to the respective transport directories on the target machine hard disk

\usr\sap\trans\cofiles -> K9#####.EH3 \usr\sap\trans\data ->R9#####.EH3

Import the request

Start the SAP GUI and logon to the appropriate system

Run transaction STMS (Transport Management System)

In the menu choose Overview -> Imports (F5)

Double-click on the target system-ID

In the menu, choose Extras -> Other Requests -> Add

Enter Transport Request EH3K9##### in the popup window and choose Continue

Confirm the popup window “Add Transport Request” with Yes

Mark the request and select Request -> Import (in the menu)

Enter as target client “000”, mark the flag “overwrite originals”, and start the import (confirm with Yes if necessary)

Activate the new services

Start the SAP GUI and logon to the appropriate system.

Run transaction SICF (Maintain Services)

Enter SERVICE as Hierarchy Type and Z_BAIO_SUE_1 as Service Name

Click Execute (F8)

Perform a right-click on the service z_baio_sue_1 in order to display the context menu

Choose Activate Service

Confirm with Yes to activate the service

Repeat these steps for each of the following services.

Z_BAIO_SUE_1

Z_BAIO_GADGETS

Z_EASY_TABLE_CHANGER

© SAP AG Page 8 of 25

Page 9: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP Best Practices User Guide - User Experience Demo Kit for SAP NWBC

Z_IMAGEVIEWER

Z_WD_EDIT_GADGET

Make sure, that the following services for the SAP NWBC and to enable other used functions, are activated (see also SAP Note 1163891):

Call transaction SICF

Execute (F8)

Node / Select service with the mouse / highlight

Menu Service/Host - Activate (Ctrl+F11) or use the mouse and right-click to activate the service

Services:

/default_host/sap

/public

o /bc

/icons

/icons_rtl

/pictograms

/ur

/webdynpro/*

/webicons

o /bsp/sap

/htmlb

/public/bc

/system

o /icf_info (only required with load distribution using message server / web dispatcher)

/logon_groups

/urlprefix

/icr_group

/icr_urlprefix

o /icman

o /myssocntl

/bc

o /bsp

/kyk/dal_home

/sap

/public/bc

/system

o /dal

/demoa

o /igs_data

o /print/*

o /smart_forms

o /webdynpro

/kyk/* depending on the processes to be implemented

/sap

/lord*

/powl*

/wdk*

/wdhc_application

© SAP AG Page 9 of 25

Page 10: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP Best Practices User Guide - User Experience Demo Kit for SAP NWBC

To avoid security information message, like the following (these are not errors, but occur because of mixing HTTP content with HTTPS page calls):

Please follow these steps:

Double click (still within the transaction SICF) the node /sap/bc/dal/demoA.

Enter the change mode and go to the tab Error Pages.

Mark the bullet point System Logon and click on the button Configuration next to it.

Within the following screen, mark the bullet point Define Service-Specific Settings.

Make sure to select Do Not Switch within the dropdown box next to Protocol. This setting allows you to logon via HTTP and disables the automatic switch to HTTPS.

The other settings on this page define how the logon menu is built: you can allow and disallow the user to enter System ID, Client, Language etc., as well as defining default settings for client and language.

To be able to call evaluations and POWER lists, you must activate the switch /kyk/gen_aio_simplification in transaction SFW5 under Enterprise Business Functions.

Go to transaction SFW5

Find the entry /kyk/gen_aio_simplification within the folder Enterprise Business Functions

Mark the checkbox under “Planned Status” for this entry

Click on Activate Changes (Ctrl+F3)

Cascade client specific parts of the request to other clients

Start the SAP GUI and logon to the additional client

Run transaction SCC1 (Copy by Transport Request)

Enter the previous target / productive client as Source Client

Enter Transport Request EH3K9#####

Mark the flag “Including Request Subtasks”

Click on Start Immediately (F5)

Confirm "Change request/task EH3K9##### has no or incorrect source client ###"

Additional option

If you plan to have the request / roles copied from client 000 to all new clients in future, import to client 000 first and then to the relevant existing productive clients.

After installing the transport files, the following demo roles are also uploaded into the system:

Z_BAIO_DEMO_A_WELCOME -> Contains the welcome page for the SAP NWBC localized in the languages EN, CN, DE, ES, FR, PT, JP, IT, NL, RU

Z_BAIO_DEMO_B_APP_WORKBENCH -> Contains 4 role-based workbenches for Purchasing, Production, Selling, and Financials, available in EN

© SAP AG Page 10 of 25

Page 11: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP Best Practices User Guide - User Experience Demo Kit for SAP NWBC

Z_BAIO_DEMO_Z_ADMIN -> Contains an administration view to access three backend tables, through which you can build and configure new and existing pages.

3.2 Assign the new demo roles to user

You need to assign the demo roles Z_BAIO_DEMO_A_WELCOME and Z_BAIO_DEMO_B_APP_WORKBENCH to users so that those users can run the demo kit when they log on. To do this, please follow these steps:

Start the SAP GUI and logon to the additional client

Run transaction PFCG (Role Maintenance)

Enter role name Z_BAIO_DEMO_A_WELCOME and click on the Change button

Open the USER tab

Add existing users to the demo role

Save (CTRL+S) the changes

Repeat these steps for Z_BAIO_DEMO_B_APP_WORKBENCH and Z_BAIO_DEMO_Z_ADMIN.

Note: Please ensure that the role Z_BAIO_DEMO_A_WELCOME appears on top of those roles that are assigned to a particular user. Otherwise the Welcome Page will not be shown automatically after log-on and you have to click on the Welcome menu on the left panel to see the Welcome Page.

To validate this please follow these steps:

Start the SAP GUI and logon to the additional client

Run transaction SU01 (User Maintenance)

Enter the user name in the field USER and click the Display button

Open the Roles tab and check whether the role Z_BAIO_DEMO_A_WELCOME stays on top of the role list (they should be sorted alphabetically).

4 How to start

4.1 Logging on to your system via NWBC

Start the NWBC 1.0 and go to System/Preferences to configure a system connection. Click on Add to define a new one and enter the following values:

Name: any name you want to give this connection

Type: SAP All-in-One

Protocol: HTTP (you will get security messages if selecting HTTPS)

Host: your server address in the network (without port)

Port: the HTTP port of your server (see transaction SMICM -> Services for open port numbers or check the attached PDF for more details)

Path: /sap/bc/dal/demoA (or /demoB – see chapter 3.1)

Client: the productive client of your system, to where you transported the demo kit data.

© SAP AG Page 11 of 25

Page 12: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP Best Practices User Guide - User Experience Demo Kit for SAP NWBC

Language: your desired logon language

User: you user ID

4.2 Starting the User Experience Demo Kit for NWBC

The content of the Welcome Page is shown as first screen, currently the content is localized in the following languages: EN, CN, DE, ES, FR, PT, JP, IT, NL, RU.

In addition, click on menu entry “Workbenches” and explore the role-based workbenches for Purchasing, Production, Selling, and Financials.

Enjoy exploring the user experience demo kit with NWBC.

4.3 Predefined gadget pages

The welcome page provides 3 columns with individual gadgets and a footer. You have the possibility to personalize the gadgets by clicking on the pen symbol or collapse / decollapse them by clicking either the – or + symbol respectively.

There are predefined roles, workbenches and dashboards that can be placed on the welcome screen. It’s possible to show SAP GUI transactions, Powerlists, Webdynpros, Google Desktop Gadgets, Shockwave files, Pictures, etc.

© SAP AG Page 12 of 25

Page 13: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP Best Practices User Guide - User Experience Demo Kit for SAP NWBC

Right-click the gadget-free area to see the context menu with the following options.

Refresh Page:

Refresh the page.

Show All Gadget Headerbars:

Display all header bars, even if they are invisible. This can be used to be able to personalize the gadget which have no headerbar by default. After personalization, you can hide the headerbar again.

Restore Page to Default:

Reset all user specified settings to the defaults. This will remove all user specific settings from a gadget page.

5 How to changeThe first chapter shows how the gadgets on a page of the demo kit can easily be configured and changed by clicking on the edit symbol within the header bar of each gadget. All changes done within this screen are stored only for the current users – for other users these changes have no effect. If you want to change a page for all users or define completely new pages, refer to the second chapter within “Role specific layout”.

5.1 User-specific personalization

Click on the pen icon in the right upper corner of your gadget to personalize an individual gadget. All changes for the gadget are user-specific and will be stored for the current user only.

You will get the following dropdown menu:

There are several options you can perform like moving the gadget to another position, deleting the gadget, creating new ones, changing the content, etc.

© SAP AG Page 13 of 25

Page 14: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP Best Practices User Guide - User Experience Demo Kit for SAP NWBC

By clicking the Personalize this Gadget you will be forwarded to the Gadget Information screen, where you can change general settings for this gadget.

5.1.1 Personalize this GadgetOn the gadget information screen you can see several information for this gadget.

Gadget layout information

Click on to see further information.

Go back to the previously displayed information with .

Gadget content information

Here, you are able to change the gadget name, description, height and width. Click on to get more information about your gadget, e.g. country, language, source ID, height, width, and the URL, which you will see on the window:

If something is changed, the changes will be stored for your user by clicking on . To set it back to default and remove all of the changes you have made to this gadget click on

and close the application with .

When an enabling Full Screen Navigation, you need to select a gadget that is called, when navigating to fullscreen mode. You can also select Open in new Window, to create a new tab/session instead of replacing the current screen.

© SAP AG Page 14 of 25

Page 15: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP Best Practices User Guide - User Experience Demo Kit for SAP NWBC

5.1.2 Replace this GadgetYou have the possibility to switch to an already existing gadget. Choose one from the list and

mark the blue box on the left-hand side next to the gadget name and click to insert the chosen gadget in the page.

Moreover, you can look for an existing gadget by using the blank line and typing the requested name.

In the bottom right corner you can switch between an where you will see some further information and the .

To customize a selected gadget click the button.

Here you can change some setting for the appearance of the replacement gadget. To have a small preview, click the button on the bottom of the page.

© SAP AG Page 15 of 25

Page 16: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP Best Practices User Guide - User Experience Demo Kit for SAP NWBC

5.1.3 Insert a new GadgetThis window shows how you can create a new gadget and what kind of information about the new gadget has to be filled in.

You can create new gadgets in two ways.

Enter all information to manually create a new gadget

Click the button to open the settings from an existing gadget and change them as you need it.

The folder icon next to the gadget URL opens the tab strip gadget control where you can choose between the following options:

After choosing the content for you new gadget you have the possibility to preview the new gadget

by clicking button or to save it with .

When a complete new Gadget is created it will be stored in the Gadgets table, so that every user can use it, however the assignment you make to the screen here will be stored “user-specific”.

To divide between content delivered by SAP (which can be overwritten in later transports or updates) and content created by partners/customers, every data entry uses a data field called Source ID. There are several different values for it:

0 BAiO Development

1 BAiO Demo Development

2 BAiO Demo Services

3 Reserved for SAP

4 Reserved for SAP

© SAP AG Page 16 of 25

Page 17: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP Best Practices User Guide - User Experience Demo Kit for SAP NWBC

5 Reserved for SAP

6 Partner Standard

7 Partner Extension

8 Customer Standard

9 User Extension

By default, after implementing the transports, you are only allowed to use source ID s 8 and 9. If you’re a partner you can set a parameter, allowing you to use source ID 6 and 7. To do this, go to transaction SU01 and edit the desired user. Go to the tab “Personalization” and add a new parameter, called “Z_BAIO_GADGET_CREATE”, with the value “SAP_PARTNER”.

When there are two entries within the database, with exactly the same key information except for source ID, the one with the higher source ID is used and displayed on a page. This provides the possibility to refine a gadget or entry provided by SAP, while keeping the original one intact.

5.2 Role specific layout

The role-specific layout changes will affect all users assigned to this role. All changes will be done in the SAP backend system or through the administration role/page provided.

5.2.1 Accessing the configuration tablesThe maintenance dialogs are provided through the role Z_BAIO_DEMO_Z_ADMINIn addition the configuration tables can also be maintained using transaction SE16

Three different tables can be edited to change and build pages:

ZPAGE_LAYOUT

ZGADGETS_URLS

ZGADGETS_CONFIG

When you have added this role to your user, the navigation point “Administration” appears within the NWBC, from where you can access the tables (see screenshot below).

Note: after you have made any changes to an existing page, through the configuration tables, you need to restore the page to default, through the right-click context menu on the corresponding screen. This will refresh your user-specific changes and retrieve the new data from the tables. (see chapter 4.2 on how to restore the page to default)

© SAP AG Page 17 of 25

Page 18: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP Best Practices User Guide - User Experience Demo Kit for SAP NWBC

5.2.2 General page layout

Transaction SE16 (General Table Display)

Table Description

ZPAGE_LAYOUT General Layout Configuration.

Client-specific

This table defines the general layout of the elements on the page. Pages with three row layout types each are possible. Here, each row can have multiple columns and each column can host multiple gadgets, linking to the gadget content via configurable URLs (configured within ZGADGETS_CONFIG table). Below, the currently provided layouts in the Demo System are shown.

Layout ID: 100

Area Height [px] Columns Width [%]

Header 64 1 100

Main Max 3 26 | 37 | 37

Footer 40 1 100

Example Usage: Welcome pages with header

Layout Design Example in NWBC

Will follow

Layout ID: 200

Area Height [px] Columns Width [%]

Main Max 3 26 | 37 | 37

Footer 40 1 100

Example Usage: Welcome pages without header

Layout Design Example in NWBC

 Layout ID: 300

Area Height [px] Columns Width [%]

Header 54 4 25 | 25 | 25 | 25

Main max 1 100

Example Usage: BI reports with lookup gadgets

Layout Design Example in NWBC

 Layout ID: 500

Area Height [px] Columns Width [%]

Main max 1 100

Layout Design Example in NWBC

© SAP AG Page 18 of 25

Page 19: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP Best Practices User Guide - User Experience Demo Kit for SAP NWBC

Example Usage: Intro pages with images

Layout ID: 600

Area Height [px] Columns Width [%]

Header 255 2 33 | 33 | 33

Main max 1 100

Footer 40 1 100

Example Usage: Workbench pages

Layout Design Example in NWBC

5.2.3 Gadget RepositoryTransaction SE16 (General Table Display)

Table Description

ZGADGETS_URLS List of available gadgets.

Client-specific

This table holds an extensive list of gadgets that can be inserted in any page.

The table key consists of Country (determined within the role), Language (determined by logon-language), Source ID (please refer to chapter 5.1.3 for explanation) and Gadget ID. The Gadget ID can be any unique set of characters. When creating a new gadget through the maintenance dialogs described in the chapter before, a unique GUID is created automatically.

The Gadget Name corresponds to the displayed title of a gadget on the page.

You also need to set the GadgetType correctly, to one of the following values:

0010 Google Gadget <Script ...>

0020 Business Server Page (BSP)

0030 Link to Webpage (URL)

0040 MIME File Types (Images, SWF, etc.)

0050 Web Dynpro (incl. POWERlists)

Height and Width can be defined in pixels (no entry), as well as in percentage (‘%’), through the fields called Unit, next to Width and Height.

The first of the three URL fields contains the link to the item, used by the page. The other ones after it can be used to store links to information sources about the gadget.

Navigation Enabled enables the fullscreen navigation, linking to the gadget defined in the field Fullscreen Gadget. If the flag New Session is set, the fullscreen gadget is opened within a new session/tab, instead of replacing the current screen.

© SAP AG Page 19 of 25

Page 20: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP Best Practices User Guide - User Experience Demo Kit for SAP NWBC

5.2.4 Page ConfigurationTransaction SE16 (General Table Display)

Table Description

ZGAGDETS_CONFIG Configured pages, using layout and URLs.

Client-specific

This table is used to define new pages, based on the two tables above.

The table key consists of Country (determined within the role), Language (determined by logon-language), Source ID (please refer to chapter 5.1.3 for explanation), Gadget Bundle ID (defined by the role, see chapter 5.2.5) and Gadget Page ID (not used yet) and Position. It further uses several fields from the table ZPAGE_LAYOUT: Gadget Layout ID, Content Area and Column.

To build a new page, do the following:

Select Country, Language, Source ID and define a new Gadget Bundle ID (which needs to be set in the role afterwards). Select a Layout and add one entry to the CONFIG table, for each gadget, you want to have on your page. The fields Content Area, Column and Position define the position of the gadget on the screen. Within the field Gadget ID you can select any gadget from the table ZGADGETS_URLS.

Further options:

When Invisible is set, the gadget is not displayed on the page.

Name on Screen overrides the title of the gadget, defined in ZGADGETS_URLS, as well as Height/Width on Screen (Unit switches between pixels and percentage – see above).

Scrolling enables and disables Scrollbars within the gadget.

No Header disables the header bar of the gadget.

Collapse by default makes the gadget start minimized.

The options Fullscreen gadget and Background Gadget are not enabled yet, and only implemented for future releases.

5.2.5 Configure the roleAfter configuring a new page through the configuration tables, you need to link to this page within a role. To modify or create a new role, go to transaction PFCG. Enter the rolename and click on Create Single Role or on Modify to change existing ones. To add a new page, follow these steps:

Click on Add Other Object and select BSP Application.

Enter the following values:

o BSP Applicat. – Z_BAIO_SUE_1

o Description – Any name for your page

o Start Page – gadgets_page.htm

o Add Parameters:

gadget_bundle_id – your newly created Gadget Bundle ID (see ZGADGETS_CONFIG table), e.g. WELCOME_0010

country – this is optional. Use an acronym (like ‘US’ – see in table ZGADGETS_CONFIG) to define several pages with the same bundle id for different countries.

© SAP AG Page 20 of 25

Page 21: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP Best Practices User Guide - User Experience Demo Kit for SAP NWBC

o Click Continue.

Right click on the node and select Additional Details: here you can define more options, e.g. Invisible, to not show a page, or Homepage, to make this page the default view within a folder (there should always be one Homepage per folder).

A newly created role needs to be assigned to your user through the tab User, or through the transaction SU01.

Note: To access any backend transaction from the NWBC, you user needs to have at least one transaction assigned to any of his roles! You can easily add any transaction to a role, by clicking on Add Transaction, and entering a transaction code. If you do not want to display the transaction, you can set it to Invisible (see above).

6 LocalizationThere are different ways to localize the different parts of the application.

Navigation Menu Entries can be maintained in several languages within the role, using transaction PFCG. Right click on a node and select Display Translations.

Gadget Titles can be maintained within the ZGADGETS_URLS table, by copying the gadget and changing country and/or language. The logon-language is automatically selected and used to find the correct page within ZGADGETS_CONFIG.

The translation of the content of a gadget, depends on its heritage:

o Lookups and other BSP page gadgets provided by SAP, can be translated using the table ZGADGETS_TRANSL that stores translations of single terms, corresponding to the logon language. You can easily add new terms.

Note that not all gadgets are connected to the translation table – this may follow in later releases.

o Gadgets implemented by <script> tags, e. g. Google Gadgets can often be translated by changing parameters in their URL (so you can change those and copy the entry within the ZGADGETS_URLS table).

o Web Dynpro gadgets should be automatically translated by the system, depending on the logon-language.

o Flash files and other MIME types need to be changed and uploaded separately to translate them.

7 How to developIn the next release of this document!

© SAP AG Page 21 of 25

Page 22: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP Best Practices User Guide - User Experience Demo Kit for SAP NWBC

8 Support

8.1 Known issues

Some links in the navigation menu of the Welcome Page may not work correctly. Those are:

My Inbox

My Calendar

My Tasks

Web Browser

These links can easily corrected by doing the following:

Open the role Z_BAIO_DEMO_A_WELCOME within the transaction PFCG.

Go to the tab “Menu” and navigate to the following path: Role Menu -> Welcome -> Links.

Right-Click on the node you want to change (do this for each of the above mentioned links) and select “Change Nodes”.

In the pop-up window change the entry for “BSP Applicat.” from “Z_BAIO_SUE_1” to “Z_BAIO_GADGETS”.

Repeat this for all four nodes and save the role. To see the effect of the change, you have to logoff and logon again to the NWBC.

© SAP AG Page 22 of 25

Page 23: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP Best Practices User Guide - User Experience Demo Kit for SAP NWBC

8.2 Troubleshooting

Please refer to the following SAP Notes (you can also check other related notes referenced in those below):

1163891 SAP AIO with NWBC in SAP EhP3 for SAP ECC 6.0: Configuration

900000 Netweaver Business Client – FAQ

1378659 What to check when opening a business client support ticket

955258 PFCG: New function in menu maintenance

1069540 Printer Configuration for PDF Display in New NWBC Window

1058567 NWBC: HowTo for "partner xyz not reached" problems

1098315 Business Client runtime sends SAPGUI service 0

8.3 OSS Component

Before creating a problem ticket, please check the following note:

1378659 What to check when opening a business client support ticket

For technical questions and issues of all kinds, please use:

SV-SMB-AIO-PFW-NWBC

For questions and issues concerning the content of the demo kit, please use:

SV-SMB-AIO-AET-KIT

© SAP AG Page 23 of 25

Page 24: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP Best Practices User Guide - User Experience Demo Kit for SAP NWBC

9 Appendix

9.1.1 Development Package

Transaction SE80 (Object Navigator):

Development Package Description

Z_BAIO_SUE_001 AiO Demo Enhancements

Provided by: BAiO Development

Business Server Page (BSP) Z_BAiO_SUE_1

Gadget Framework

Z_BAiO_Gadgets

Gadgets (based on BSP’s)

9.1.2 Linkage to Business Roles

Transaction PFCG (Role Maintenance)

Role Name Role Description

Z_BAIO_DEMO_A_WELCOME Demo Role Displaying the Welcome Section

Provided by: BAiO Development

Role menu Welcome

Welcome

o BSP App: Z_BAIO_SUE_1

o Start Page: gadgets_page.htm

o gadget_bundle_id = WELCOME_0010

Role Name Role Description

Z_BAIO_DEMO_B_APP_WORKBENCH Demo role containing application workbenches

Provided by: BAiO Development

Role menu Purchasing Workbench

Purchasing Workbench

o BSP App: Z_BAIO_SUE_1

o Start Page: gadgets_page.htm

o gadget_bundle_id = PURCHASING_WB

Production Workbench

Production Workbench

o BSP App: Z_BAIO_SUE_1

o Start Page: gadgets_page.htm

o gadget_bundle_id = PRODUCTION_WB

© SAP AG Page 24 of 25

Page 25: SAP BAIO User Guide User Experience Demo Kit for NWBC En

SAP Best Practices User Guide - User Experience Demo Kit for SAP NWBC

Selling Workbench

Selling Workbench

o BSP App: Z_BAIO_SUE_1

o Start Page: gadgets_page.htm

o gadget_bundle_id = SELLING_WB

Financials Workbench

Financials Workbench

o BSP App: Z_BAIO_SUE_1

o Start Page: gadgets_page.htm

o gadget_bundle_id = FINANCIALS_WB

Role Name Role Description

Z_BAIO_DEMO_Z_ADMIN Demo Role, providing an admin page to configure gadget pages.

Provided by: BAiO Development

Role menu Administration

Administration

o BSP App: Z_BAIO_SUE_1

o Start Page: gadgets_page.htm

o gadget_bundle_id = ADMIN

© SAP AG Page 25 of 25