SAP NetWeaver Business Client (NWBC) - Nicx

1 SAP NetWeaver Business Client ( nwbc ). nwbc Draft SAP NetWeaver Documentation Copyright Copyright 2009 SAP AG. All rights reserved. This documentation outlines our general product direction and should not be relied on in making a purchase decision. This documentation is not subject to your license agreement or any other agreement with SAP. SAP has not obligation to pursue any course of Business outlined in this document or to develop or release any functionality mentioned in this documentation. This documentation and SAP's strategy and possible future developments are subject to change and may be changed by SAP at any time for any reason without notice. This documentation is provided without a warranty of any kind, either express or implied, including but not limited to, the implied warranties of merachantability, fitness for a particular purpose, or non-infringement.

2 SAP assumes no responsibility for errors or omissions in this documentation, except if such damages were caused by SAP intentionally or grossly negligent. 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, System i, System i5, System p, System p5, System x, System z, System z10, System z9, z10, z9, iSeries, pSeries, xSeries, zSeries, eServer, z/VM, z/OS, i5/OS, S/390, OS/390, OS/400, AS/400, S/390 Parallel Enterprise Server, PowerVM, Power Architecture, POWER6+, POWER6, POWER5+, POWER5, POWER, OpenPower, PowerPC, BatchPipes, BladeCenter, System Storage, GPFS, HACMP, RETAIN, DB2 Connect, RACF, Redbooks, OS/2, Parallel Sysplex, MVS/ESA, AIX, Intelligent Miner, WebSphere, Netfinity, Tivoli and Informix are trademarks or registered trademarks of IBM Corporation.

3 Linux is the registered trademark of Linus Torvalds in the and other countries. 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. (C) SAP AG nwbc 2.

4 Draft SAP NetWeaver Documentation SAP, R/3, 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 other countries. Business Objects and the Business Objects logo, BusinessObjects, Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, and other Business Objects products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of Business Objects in the United States and in other countries. Business Objects is an SAP. company. 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.

5 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. (C) SAP AG nwbc 3. Draft SAP NetWeaver Documentation Icons in Body Text Icon Meaning Caution Example Note Recommendation Syntax Additional icons are used in SAP Library documentation to help you identify different types of information at a glance. For more information, see Help on Help General Information Classes and Information Classes for Business Information Warehouse on the first page of any version of SAP Library.

6 Typographic Conventions Type Style Description Example text Words or characters quoted from the screen. These include field names, screen titles, pushbuttons labels, menu names, menu paths, and menu options. Cross-references to other documentation. Example text Emphasized words or phrases in body text, graphic titles, and table titles. EXAMPLE TEXT Technical names of system objects. These include report names, program names, transaction codes, table names, and key concepts of a programming language when they are surrounded by body text, for example, SELECT and INCLUDE. Example text Output on the screen. This includes file and directory names and their paths, messages, names of variables and parameters, source text, and names of installation, upgrade and database tools. Example text Exact user entry. These are words or characters that you enter in the system exactly as they appear in the documentation.

7 <Example text> Variable user entry. Angle brackets indicate that you replace these words and characters with appropriate entries to make entries in the system. EXAMPLE TEXT Keys on the keyboard, for example, F2 or ENTER. (C) SAP AG nwbc 4. Draft SAP NetWeaver Documentation Table of Contents SAP NetWeaver Business Client .. 9. 1 Overview .. 10. Business Client History .. 11. Technology Block Diagram .. 12. 2 Using NetWeaver Business Client .. 14. Starting nwbc .. 15. Shell Overview .. 16. Navigation .. 18. Canvas Types .. 20. Multi-Windows .. 20. Menus .. 21. 23. Navigation Panels and Quick 24. Logging 25. Connecting to Different Systems .. 26. Extended Supportability .. 26. nwbc for 29. 3 Installation and Client Configuration .. 30. Desktop Installation .. 30. Installation together with SAP GUI .. 32. Windows Terminal Server Installation .. 33. End-User Configuration.

8 34. Configuring Connections .. 34. Configuring Search Providers .. 36. Configuring Support Information .. 37. Configuring Personalize Settings .. 39. Administrator 40. Using nwbc with a Load Balancer .. 41. 4 Server Configuration .. 44. HTTP/HTTPS Settings in the ICM .. 45. Active Services in the ICF .. 46. Settings for Fully Qualified Domain Names (FQDN) .. 49. System Security Settings .. 51. Cockpits .. 52. Configuration via Table NWBC_CFG .. 54. (C) SAP AG nwbc 5. Draft SAP NetWeaver Documentation ~test Page .. 57. ~launch Page .. 57. Transaction nwbc .. 59. Performance Aspects .. 60. 5 Role Maintenance in 62. PFCG 64. Role Description .. 66. Navigation Tree .. 67. Default Pages and Service Maps .. 72. Link Collections .. 73. Single Top Level .. 75. Menu .. 76. Remote Systems .. 77. Object-Based Navigation (OBN) .. 80. 6 Programming Aspects .. 84. Generating an External Startup URL for nwbc .

9 84. Creating an nwbc Desktop Icon .. 90. High-Level 92. ABAP-Based APIs .. 93. HTTP REST Based APIs .. 97. nwbc Application Context .. 99. 7 Security Aspects .. 101. nwbc and Authentication .. 102. Use of Digital 103. Logon Tickets .. 106. Trusted Relationships .. 108. Configuring Authentication on the Server .. 109. ICF Configuration .. 111. Certificate Error Popups in the Browser .. 112. 8 Troubleshooting .. 115. What Information should be Included in a Problem Ticket .. 117. When is an Error an nwbc Error? .. 118. How to Activate Tracing .. 119. How to Create a Support Report .. 120. Where are the Trace Files Stored? .. 120. How to Open an HTTP Connection to a Customer Site .. 121. Why Do We Need a User with the Correct Roles Assigned? .. 121. (C) SAP AG nwbc 6. Draft SAP NetWeaver Documentation SAP GUI Version Information .. 121. How to Obtain the Portal Version.

10 122. On which SAP NetWeaver Versions is nwbc supported? .. 123. We have SP<06 and can see /sap/bc/ nwbc , but .. 123. We Have an Old Version of SAP NetWeaver , Can we Use nwbc ? .. 124. Can We Use nwbc If our SAP NetWeaver Version is Older Than Stated in Note 1368177? .. 124. Internet Explorer and Links that Open New Windows .. 125. nwbc Maintenance and 125. nwbc for Desktop Installation Errors (SAPS etup Errors) .. 126. nwbc for Desktop File 126. Manually Uninstalling nwbc for Desktop .. 126. Installation Only Extracts Without Installing .. 127. Locks After Short Dumps or 128. Searching for Technical 128. What Happens If No Roles are Assigned? .. 130. Why are Some Strings in Quotes? .. 131. Object-Based Navigation Errors .. 132. Failed to Resolve Object-Based Navigation .. 133. How to Verify OBN Configuration at Database Level .. 134. How to debug OBN .. 134. How to Handle Long Portal-Based OBN Targets.