Show TOC

Migrating to the Server Runtime for UI ServicesLocate this document in the navigation structure

This section describes which parts of the existing SAP Business Client configuration in SAP_BASIS you need to migrate for the system to work properly if you use the server runtime for SAP NetWeaver UI services.

You need to consider the following aspects for the migration:

  • SAP Business Client configuration table (NWBC_CFG)

  • SAP Business Client SAP GUI tag tables

  • Client logon URLs

Note

The server runtime for SAP NetWeaver UI services is supported as of SAP NWBC 4.0 for Desktop or higher and NWBC for HTML 3.6.

SAP Business Client Configuration Table (NWBC_CFG)

Using the server runtime for SAP NetWeaver UI services with a version 3.6, you define configuration parameters in Customizing. If you connect to this server runtime version, the system no longer considers table NWBC_CFG that is used only with a version 3.5 of the server runtime. You must migrate configuration data manually from table NWBC_CFG to transaction /UI2/NWBC_CFG_CUST in Customizing under Start of the navigation path SAP NetWeaver Next navigation step UI Technologies Next navigation step SAP NetWeaver Business Client End of the navigation path.

In Customizing, the following views form the equivalent of table NWBC_CFG:

  • /UI2/NWBC_CFGV: Contains entries that are delivered by SAP

  • /UI2/NWBC_CFGCV: Contains entries that are maintained by the customer

    These entries can supersede the entries delivered by SAP.

SAP Business Client SAP GUI Tag Tables

No manual migration is necessary. The data for SAP GUI tags that is evaluated when using the context-sensitive side panel continues to be read from the different tables that are used if you connect to the following versions of the server runtime:

  • Version 3.5 of the server runtime for SAP Business Client (SAP_BASIS)

  • Version 3.6 of the server runtime for SAP NetWeaver UI services

If you have already defined SAP GUI tags for the server runtime for SAP Business Client and you connect to the server runtime for SAP NetWeaver UI services, this data continues to be read from the SAP_BASIS tables:

  • NWBC_S_GUI_TAG: Contains entries that are delivered by SAP

  • NWBC_C_GUI_TAG: Contains entries that are maintained by the customer

In addition, the following tag views are available if you connect to the server runtime for SAP NetWeaver UI services:

  • /UI2/NWBC_V_GT: Contains entries that are delivered by SAP

  • /UI2/NWBC_VC_GT: Contains entries that are maintained by the customer

The entries are merged following this logic:

  • The customer's entries supersede SAP entries.

  • Entries for the server runtime for SAP NetWeaver UI services supersede SAP_BASIS entries.

In order to define SAP GUI tags for side panel applications, in Customizing (transaction SPRO), choose Start of the navigation path SAP NetWeaver Next navigation step UI Technologies Next navigation step SAP NetWeaver Business Client Next navigation step Define SAP GUI Tags (Runtime for SAP NetWeaver User Interface Services) End of the navigation path.

Client Logon URLs

Logon URLs stored in SAP Business Client for Desktop on the client-side work only if you connect to the server runtime for SAP Business Client. This is because the logon URLs point to the SAP_BASIS handler of SAP Business Client. Depending on whether logon URLs use the SAP Business Client external alias, you have the following options:

  • Most of the time, logon URLs can be handled easily in the migration if they use the SAP Business Client external alias. You need to re-map the external alias /nwbc to sap/bc/ui2/nwbc instead of sap/bc/nwbc.

  • You need to update logon URLs that do not use the external alias manually as shown in the following example:

    Example

    This is an example of a logon URL that does not use an external alias:

    https://<server>:<port>/sap/bc/nwbc/

    You need to change this URL as follows:

    https://<server>:<port>/sap/bc/ui2/nwbc/

Related Information