
For the long URL the first part consists of the short URL as described in 6.1.1 Short Form of URL, plus the following elements:
.../~canvas/<canvas type>/<client_type>/<canvas relevant sequence>/[?parameter sequence][sap parameters]
Element |
Optional |
URL |
Description |
|---|---|---|---|
Canvas delimiter and options |
/~canvas[;window=main|app|embedded] |
If this is an URL that loads a specific canvas, then this ~canvas sequence must be available. Windowing qualifiers are optional.
Example: http://<server>.<domain>.<ext>:<port>/sap/nwbc/~canvas;window=app/wda/myApplication/ |
|
Target-specific description |
/transaction/<transaction_code> [;client_type=auto] ;client_type=sapgui ;client_type=webgui /wda/[<namespace>/]<name> [;client_type=auto] ;client_type=html /url/<segment>/... /roleEntry/<role_name>:<id> /sitemap /obn/<object>.<method> /applicationAlias/<alias> |
Segment that describes the type of canvas to load. These strings describe the possible canvases that can be used.
|
|
Trailing slash / |
/ |
The extra slash / is needed to lock the previous segment and allow page-relative URLs to work. |
|
Query string |
yes |
?name=value&name=value&… |
The query string is passed as-is to the called application. It does not, and should not, contain any NWBC-relevant parameters or options.
If a transaction is to be started, the startup parameters must still be specified as normal URL parameters (in the format &name=value). At runtime, the parameters will be correctly transformed into the format required by SAP GUI for HTML. End of the note. |
SAP parameter |
yes |
&sap-client=<nnn> &sap-user=<user name> &sap-language=<XX> |
Note that an additional sap-client is always added to ensure an HTML URL always runs back into the correct client. |
For example, to start directly transaction ME21 in NWBC, use the sequence:
https://ldcibqi.wdf.sap.corp:44376/sap/bc/nwbc/~canvas/transaction/ME21/
To force-start the same transaction in SAP GUI while using NWBC for HTML, add the client_type qualifier:
https://ldcibqi.wdf.sap.corp:44376/sap/bc/nwbc/~canvas/transaction;client_type=sapgui/ME21/
To start the Web Dynpro ABAP application IT00, shipped by SAP in the default namespace, use:
https://ldcibqi.wdf.sap.corp:44376/sap/bc/nwbc/~canvas/wda/IT00/
However, if the Web Dynpro ABAP application was developed in a specific namespace, it must also be specified. For example, to start /SRM/Inbox, use:
https://ldcibqi.wdf.sap.corp:44376/sap/bc/nwbc/~canvas/wda/SRM/Inbox/
The start URL of a Web Dynpro ABAP application with certain Web Dynpro ABAP specific parameters can look as follows:
https://uxai5q35.wdf.sap.corp:44321/sap/bc/nwbc/~canvas;window=app/wda/hress_a_persinfo/?WDCONFIGURATIONID=HRESS_AC_PERSINFO&sap-client=004&sap-language=EN
For example, assume we wish to specify a BSP application myApp that needs to be started, then use the url sequence and specify the complete URL to start.
https://ldcibqi.wdf.sap.corp:44376/sap/bc/nwbc/~canvas/url/sap/bc/bsp/sap/myApp/default.htm
To start a very specific entry in a role, without knowing what the entry is, use the roleEntry sequence. For example, given the role PROCESS_MONITOR, start entry 27 with this sequence:
https://ldcibqi.wdf.sap.corp:44376/sap/bc/nwbc/~canvas/roleEntry/PROCESS_MONITOR:27/
To embed all roles in an external portal, you can use for example an NWBC for HTML link that shows a service map for all roles:
https://ldcibqi.wdf.sap.corp:44376/sap/bc/nwbc/~canvas;window=embedded/sitemap/
To embed one complete role in an external portal, you can use for example an NWBC for HTML link that selects a complete role and shows a service map for the role:
https://ldcibqi.wdf.sap.corp:44376/sap/bc/nwbc/SAP_ESS/~canvas;window=embedded/sitemap/
To use a symbolic call, consider to use an OBN call that is only resolved at runtime via the specific assigned roles. For example, to start a process monitor application, map the OBN sequence process.Monitor in the assigned role and use this startup URL:
https://ldcibqi.wdf.sap.corp:44376/sap/bc/nwbc/~canvas/obn/process.Monitor/
To start an overview application, assuming the application alias OVERVIEW_APP has been defined for a specific entry within the user-assigned roles, use:
https://ldcibqi.wdf.sap.corp:44376/sap/bc/nwbc/~canvas/applicationAlias/OVERVIEW_APP/