Command URLs 

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).

Comand URLs are usually visualized by means of text hyperlinks or pushbuttons.

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"></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, you can also use this form in Includes.

       4.      Command URLs act as placeholders that are replaced for the runtime by the required information, such as the log (http, HTTPS), server name, and status information (request number, page number).

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

Different Command Types

There are different types of commands:

·        Commands for Changing Attributes for a Web Item

·        Data Provider-Dependent Commands

·        Commands for Web Templates