Entering content frame

Object documentation Command URLs Locate the document in its SAP Library structure

Definition

You can set command URLs in a Web template, as well as an object tag.

With the help of command URLs, you make changes, such as to properties of Web items or to the conditions of data providers. Furthermore, you can also realize several other navigation options (for example, report/report interface, export as Excel file, and call-ups from other Web templates).

Command URLs are usually visualized by means of text hyperlinks or pushbuttons. In addition, command URLs can be used to enhance the context menu or when using formulas.

Structure

Command URLs have the following structure:

<SAP_BW_URL Parameter1='Value1' Parameter2='Value2' ...>

You can also add other parameters with “&“ behind the <SAP_BW_URL> tag.

If you use command URLs as hyperlinks in a Web template, the command URLs are embedded in the Web template as follows:

       1.      Hyperlink as text

<a href="<SAP_BW_URL cmd='LDOC' TEMPLATE_ID='EXAMPLE_TEMPLATE'>" target="_Blank">Example Call up Template in New Window</a>

       2.      Hyperlink behind pushbutton

<table><tr><td class="SAPBEXBtnStdBorder" cellspacing="0" cellpadding="0" border="0"><tr><td>

<table><tr><td class="sapbexbtnstd" ><a href="<SAP_BW_URL cmd='LDOC' TEMPLATE_ID='EXAMPLE_TEMPLATE'>" target="_Blank">Call Example Template in Separate Window</a></td></tr></table>

</td></tr></table>

       3.      Using hyperlinks in JavaScript functions

SAPBWOpenURL('<SAP_BW_URL cmd=”LDOC” TEMPLATE_ID=”EXAMPLE_TEMPLATE”>’);

Within JavaScript you can also use the JavaScript function SAP_BW_URL_Get(), for example:

SAPBWOpenURL(SAP_BW_URL_Get()+’&cmd=LDOC&TEMPLATE_ID=EXAMPLE_TEMPLATE’);

In contrast to the <SAP_BW_URL> form, the SAP_BW_URL_Get() form can also be used in JavaScript includes because the URL is first composed at runtime.

       4.      Enhancing the context menu

You can also use command URLs during Enhancing the Context Menu with JavaScript.

       5.      Using Forms

You can also use command URLs when Using Forms.

       6.      Command URLs act as placeholders that are replaced at runtime by the required information, such as the log (HTTP, HTTPS), server name, port number and status information (request number, page number). Do not specify absolute URLs when naming the log, server name and port number, instead specify command URLs with the <SAP_BW_URL> form. Note only command URLs are transportable between different BW systems when they are replaced at runtime.

Note

Use language-dependent texts during visualization of command URLs as hyperlinks, pushbuttons or in enhancement of the context menu.   <SAP_BW_URL> and <SAP_BW_TEXT> can be combined in one link.

Example:

Command URL in the Web template:

<a href=”<SAP_BW_URL cmd=’ldoc’ TEMPLATE_ID=’EXAMPLE_TEMPLATE’>”></a>

Command URL for the runtime if the Web template is started by the user:

<a href=”http://myAppServer:myPort/SAP/BW/BEx?pageno=1&request_no=8&cmd=ldoc&template_id=EXAMPLE_TEMPLATE“></a>

This URL requests a new page from the BW server. The parameters are removed from the BW server side. The status of the previous page is changed due to the transfer of the parameters (for example, filters are set).

See also:

Command Sequences

Sending Commands

Different Command Types

There are different types of commands:

·        Commands for Changing Attributes of a Web Item

·        Data Provider Dependent Commands

·        Commands for Web Templates

 

Leaving content frame