Survey
* Your assessment is very important for improving the workof artificial intelligence, which forms the content of this project
* Your assessment is very important for improving the workof artificial intelligence, which forms the content of this project
HELP.BW_INTERNAL Web API Reference Release BW 3.5 SAP Online Help 25.02.2005 Copyright © Copyright 2004 SAP AG. All rights reserved. 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, Outlook, and PowerPoint are registered trademarks of Microsoft Corporation. IBM, DB2, DB2 Universal Database, OS/2, Parallel Sysplex, MVS/ESA, AIX, S/390, AS/400, OS/390, OS/400, iSeries, pSeries, xSeries, zSeries, z/OS, AFP, Intelligent Miner, WebSphere, Netfinity, Tivoli, and Informix are trademarks or registered trademarks of IBM Corporation 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. MaxDB is a trademark of MySQL AB, Sweden. SAP, R/3, mySAP, mySAP.com, xApps, xApp, SAP NetWeaver, 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 in several other countries all over the world. 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. 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. Web API Reference BW 3.5 2 SAP Online Help 25.02.2005 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. 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. <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. Web API Reference BW 3.5 3 SAP Online Help 25.02.2005 Web API Reference......................................................................................................................... 9 Web items .................................................................................................................................. 10 General Attributes .................................................................................................................. 12 Table....................................................................................................................................... 16 Chart....................................................................................................................................... 21 Dropdown Box ........................................................................................................................ 24 Radio Button Groups.............................................................................................................. 27 Checkboxes............................................................................................................................ 30 Generic Navigation Block ....................................................................................................... 32 Hierarchical Filter Selection.................................................................................................... 36 Filters...................................................................................................................................... 38 Label....................................................................................................................................... 41 Text Elements......................................................................................................................... 43 List of Exceptions ................................................................................................................... 46 List of Conditions.................................................................................................................... 47 Alert Monitor ........................................................................................................................... 48 Role Menu .............................................................................................................................. 52 Ticker...................................................................................................................................... 56 Maps....................................................................................................................................... 57 Map Attributes..................................................................................................................... 59 Attributes for Map Layers ................................................................................................ 63 Special Attributes for Color Shading ........................................................................... 65 Special Attributes for Bar Charts ................................................................................. 67 Special Attributes for Pie Charts ................................................................................. 69 Special Attributes for Pie Charts (split)........................................................................ 71 Special Attributes for Dot Density................................................................................ 72 Special Attributes for Symbols .................................................................................... 74 Special Attributes for Symbol (Size-dependent) ......................................................... 76 Special Attributes for Symbol (Color-dependent)........................................................ 78 Special Attribute: Line.................................................................................................. 80 Special Attribute: Line (Size-dependent)..................................................................... 82 Special Attributes for Lines (Color-dependent) ........................................................... 84 Array Attributes ............................................................................................................... 86 Map Renderer ................................................................................................................. 88 Single Document .................................................................................................................... 91 List of Documents................................................................................................................... 95 Web API Reference BW 3.5 4 SAP Online Help 25.02.2005 Object Catalog of the Web Application .................................................................................. 98 Data Provider – Information ................................................................................................... 99 Web Template ...................................................................................................................... 100 Broadcaster .......................................................................................................................... 103 Query View – Selection ........................................................................................................ 104 Key Figure Overview ............................................................................................................ 107 Ad-hoc Query Designer........................................................................................................ 109 ABC Classification................................................................................................................ 114 What If Prediction ................................................................................................................. 115 Web Template Properties..................................................................................................... 117 Web Templates ........................................................................................................................ 119 Overriding Attributes ................................................................................................................ 121 Object Tags.............................................................................................................................. 124 Object Tag for the Properties of Web Templates................................................................. 125 Adjusting and Enhancing the Context Menu .................................................................... 131 Adjusting the Context Menu .......................................................................................... 132 Enhancing the Context Menu........................................................................................ 139 Object Tag for Data Provider................................................................................................ 142 Object Tag for Web Items .................................................................................................... 144 Command URLs....................................................................................................................... 145 Changing Web Item Attributes ............................................................................................. 147 Resetting and Reinitializing Web Items................................................................................ 148 Commands for Web Templates............................................................................................ 150 Calling up Web Templates................................................................................................ 151 Calling Parameterized Web Templates ........................................................................ 153 Default Variables for Web Applications......................................................................... 154 Switching Web Templates ................................................................................................ 158 Personalizing Web Templates .......................................................................................... 159 Creating Bookmarks ......................................................................................................... 160 Changing Symbol Directory .............................................................................................. 161 Releasing Web Templates................................................................................................ 162 Ending the Session........................................................................................................... 163 Variables ........................................................................................................................... 164 Calling up the Variables Screen.................................................................................... 165 Changing the Values of Variables................................................................................. 166 Calling the Broadcaster .................................................................................................... 167 Calling the Open Dialog.................................................................................................... 170 Web API Reference BW 3.5 5 SAP Online Help 25.02.2005 Data Provider - Commands.................................................................................................. 172 General Data Provider Commands .................................................................................. 174 Properties of Data Providers ......................................................................................... 175 Resetting and Reinitializing Data Providers.................................................................. 177 Back and Back to Start.................................................................................................. 179 Jumping Using Report-Report Interface ....................................................................... 180 Exporting Data .............................................................................................................. 181 Saving the Query View.................................................................................................. 182 Displaying a Copy of the Data Provider on a New Page .............................................. 183 Calling the Ad-hoc Query Designer .............................................................................. 184 Filter .................................................................................................................................. 185 Removing Filters ........................................................................................................... 188 Drilldown ........................................................................................................................... 189 Remove Drilldown ......................................................................................................... 190 Switching Characteristics/Structures ................................................................................ 191 Swap Axes ........................................................................................................................ 192 Setting the Navigational Status ........................................................................................ 193 Sorting............................................................................................................................... 195 Setting Properties of Display Attributes ............................................................................ 197 Results Row Position........................................................................................................ 198 Suppressing Result Rows................................................................................................. 199 Setting the Display............................................................................................................ 200 Displaying Documents ...................................................................................................... 201 Dialogs .............................................................................................................................. 202 Calling Dialog Query Properties.................................................................................... 203 Calling Up Dialog Box for Formula Definition................................................................ 204 Calling up Input Help..................................................................................................... 205 Calling the Characteristic Properties Dialog ................................................................. 206 Calling a Dialog for Currency Translation ..................................................................... 207 Calling a Dialog for Defining Exceptions....................................................................... 208 Calling a Dialog for Defining Conditions ....................................................................... 209 Calling a Dialog for Cell Properties ............................................................................... 210 Save Query View Dialog Box ........................................................................................ 211 Creating Your Own Dialogs........................................................................................... 213 Exceptions and Conditions ............................................................................................... 216 Commands for Exceptions ............................................................................................ 217 Setting the Status of an Exception................................................................................ 220 Web API Reference BW 3.5 6 SAP Online Help 25.02.2005 Commands for Conditions............................................................................................. 221 Setting the Status of a Condition .................................................................................. 223 Commands for Currency Translation................................................................................ 224 Commands for Values Cells ............................................................................................. 225 List Calculations................................................................................................................ 226 Operations for Display Hierarchies................................................................................... 228 Command Sequences.......................................................................................................... 232 Using Forms............................................................................................................................. 234 Use of JavaScript Functions .................................................................................................... 237 Send Commands.................................................................................................................. 238 Execute URL in the Same Window .................................................................................. 239 Execute URL in a New Window........................................................................................ 240 URL from a New Window in the Opening Window ........................................................... 241 Closing Windows .............................................................................................................. 242 Executing a Form in a New Window................................................................................. 243 Executing a Form in the Opening Window ....................................................................... 244 Enhancing the Context Menu with JavaScript...................................................................... 245 Adding a Menu Entry using JavaScript............................................................................. 246 Command Processing ...................................................................................................... 248 Properties of Page Objects .................................................................................................. 251 Web Item Attributes .......................................................................................................... 252 Characteristics for Data Providers.................................................................................... 253 Specifying Properties for Web Templates ........................................................................ 255 Calendar for Date Filter ........................................................................................................ 257 Logon Language .................................................................................................................. 258 Language-Dependent Texts .................................................................................................... 259 Creating ABAP Programs for Maintaining Language-Dependent Texts .............................. 260 More Complex Examples of Applications ................................................................................ 262 Dynamically Changing Attributes ......................................................................................... 263 Using Several Tab Pages..................................................................................................... 266 Example Scenario for the Parameter NO_OUTPUT............................................................ 270 XML Web Item: Data Provider Information .......................................................................... 274 Web Design API for Tables...................................................................................................... 277 Creating and Using ABAP Classes ...................................................................................... 278 Table Interface ..................................................................................................................... 281 Attributes........................................................................................................................... 282 Datasets ........................................................................................................................ 284 Web API Reference BW 3.5 7 SAP Online Help 25.02.2005 AXIS_INFO................................................................................................................ 285 AXIS_DATA............................................................................................................... 287 CELL_DATA .............................................................................................................. 289 TXT_SYMBOLS ........................................................................................................ 291 Events ............................................................................................................................... 292 Manipulating Cell Contents............................................................................................... 293 Headers......................................................................................................................... 295 Scaling Factors ............................................................................................................. 296 Characteristic Values .................................................................................................... 297 Attribute Values............................................................................................................. 299 Structural Components ................................................................................................. 300 Data Cells...................................................................................................................... 301 Error Cells ..................................................................................................................... 302 Labeling Area of the Navigation Block .......................................................................... 303 Filter Area of the Navigation Block................................................................................ 305 Service Methods ............................................................................................................... 307 Creating Navigation URLs............................................................................................. 308 Information on the Navigation Status............................................................................ 309 Information on a Specific Cell ....................................................................................... 311 Symbols......................................................................................................................... 313 Sending Messages........................................................................................................ 314 JavaScript Functions..................................................................................................... 315 Determining Specific Attributes for the Table Interface ................................................ 316 Web API Reference BW 3.5 8 SAP Online Help 25.02.2005 Web API Reference Purpose The Business Explorer Web Application Design enables you to apply generic OLAP navigation to BW data in Web applications and Business Intelligence cockpits in simple to highly specialized scenarios. You can use standard markup languages and Web Design APIs to implement highly individual scenarios with user-defined interface elements. Web application design comprises a broad spectrum of interactive Web-based business intelligence scenarios that you can adjust to meet your requirements using standard Web technologies. This document is intended for Web designers who want to create highly-specialized applications (BI cockpits, and so on) on the basis of Web application design. You can access BW data in Web applications using a Web browser. This is usually installed with the operating system. No additional software installation is required. Demands on the Web browser are minimal as the solution offered is based entirely on HTML. Within SAP BW 3.0A, the preferred method of accessing BEx Web Applications is via a conversion to the SAP Web Application Server. For this reason, all exampleURLs are configures to the SAP Web Application server. Web API Reference BW 3.5 9 SAP Online Help 25.02.2005 Web items Definition Web items are objects that obtain data from data providers [Seite 172] and make the data available as HTML. Web items have attributes such as header, width, height, and create navigation links. You use parameters or specific commands to change these attributes. If the data, the navigational status, or the attributes change, the HTML for the Web item is regenerated. A Web item must always be assigned to a data provider. Structure The following Web items are used in Web applications: • Table [Seite 16] • Chart [Seite 21] • Dropdown Box [Seite 24] • Radio Button Group [Seite 27] • Checkboxes [Seite 30] • Generic Navigation Block [Seite 32] • Hierarchical Filter Selection [Seite 36] • Filter [Seite 38] • Label [Seite 41] • Text Element [Seite 43] • List of Exceptions [Seite 46] • List of Conditions [Seite 47] • Alert Monitor [Seite 48] • Role Menu [Seite 52] • Ticker [Seite 56] • Map [Seite 57] • Single Document [Seite 91] • List of Documents [Seite 95] • Data Provider - Information [Seite 99] • Object Catalog of the Web Application [Seite 98] • Web Template [Seite 100] • Broadcaster [Seite 103] • Key Figure Overview [Seite 107] • Query View - Selection [Seite 104] Web API Reference BW 3.5 10 SAP Online Help • Ad-hoc Query Designer [Seite 109] • ABC Classification [Seite 114] • What If Prediction [Seite 115] 25.02.2005 Integration In the BEx Web Application Designer or the BEx Web Application wizard, on the Standard tab, you can use the Web items listed above as master Web items [Extern] You choose a master Web item from the list, assign a data provider to the Web item and edit the attributes. You have now created your own Web item that your can add to your Web template or save in the library to be used again. Web API Reference BW 3.5 11 SAP Online Help 25.02.2005 General Attributes Use General attributes are attributes that are valid for all Web items in Web applications. Features The following general attributes are available: Attributes Description Logical name of a Web item (ITEM or NAME) As well as the Web item key (ITEMID) that is assigned when the Web item is created in the Web Application Designer you also have to assign a logical name when using the Web item in the Web application. This enables you to use the same Web item several times in a Web application. If commands are sent to this Web item you always have to specify the name of the Web item as the parameter ITEM. SAP recommends that you keep to the conventions supported by the Web Application Designer when specifying names: The name should be a maximum of 30 characters long and consist of characters “A-Z”, “0-9” and “_”. It cannot start or end with “_”. Adhering to these conventions facilitates the upgrade to future SAP releases. You cannot use a command-URL to change this attribute. Web item key (ITEM_ID) (option 1) You create a Web item for a Web application based on a Web item setting that you have made in the Web Application Designer. You cannot use a command-URL to change this attribute. Class name for the Web item class (ITEM_CLASS) (option 2) Name of the ABAP object class that generates the output. This corresponds to the use of nonreusable Web items (standard Web items) in the Web Application Designer. Web items are created with the default values for the attribute. The class name for the table is, for example, CL_RSR_WWW_ITEM_GRID Web API Reference BW 3.5 12 SAP Online Help Logical name of the Data Provider for the Web item (DATA_PROVIDER) 25.02.2005 You have to assign every Web item to (exactly) one data source. The Web item gets the data and metadata from this Data source that is needed to generate the output as well as commands. SAP recommends that you keep to the conventions supported by the Web Application Designer when specifying names: The name should be a maximum of 30 characters long and consist of characters “A-Z”, “0-9” and “_”. It cannot start or end with “_”. Adhering to these conventions facilitates the upgrade to future SAP releases. Height (HEIGHT) You can only specify the height in pixels. This attribute is not used in tables. The parameters ITEMID and WBID (ITEM_WBID) used in BW 2.x are still supported. However, we recommend that you no longer use these. In the BEx Web Application Designer, in the Properties area, you can set the following attributes in the Web Item tab page, under General: Attributes Description Caption (CAPTION) You can enter a caption. If you do not enter a caption, then an appropriate value is suggested. Generate caption (GENERATE_CAPTION) By activating this attribute ('X' = Yes), an additional row containing the Web item is generated in the table. The text you have entered under Caption is displayed in this table. 'X' = Yes, ' ' = No, 'BORDER' = Borders only If you choose Borders Only, a border is generated without any additional lines for the caption. In this way you are able to realize all border types that are available under the Border Type attribute, without generating a caption line. The SAPBEXTableCaption style is used for the caption. Web API Reference BW 3.5 13 SAP Online Help Width in pixels (WIDTH) 25.02.2005 You can only specify the width in pixels. You can use the suggested width or determine a new width using Change Attribute... Note that the Web browser automatically increases the widths of tables if the one you have chosen is too small. Border type (BORDER_STYLE) Here, you can choose the following display types for the Web item: • 'BORDER' = With border With border Set as default value for table, generic navigation block, Alert Monitor, filter, text elements, menu, list of conditions, and list of exceptions. ‘NO_BORDER’ = Without border ‘FORM’ = Form The border is only displayed if GENERATE_CAPTION=X. • Without border Set as default value for maps, charts, and individual documents. • For form The content of the Web item is normally displayed with a blue background. Set as default value for document list, hierarchical context menu, label, dropdown box, radio button group, and checkboxes. The standard value settings represent the recommended display type for the Web item. Closed (CLOSED) ‘X’ = Yes, ‘ ’ = No You can close the Web item (CLOSED=X): The Web item is not displayed. Only the caption still appears (if there is one) and the open/close symbol for this Web item. By clicking on the open/close symbol, you can make the Web item visible or invisible. To be able to see the caption, you have to activate the attributes Generate Caption and Objects with Navigation Links. Web API Reference BW 3.5 14 SAP Online Help 25.02.2005 You can hide the Web item (HIDDEN=X): Although the Web item embedded in the Web template, it is not visible. The Web item and the caption with the open/close symbol are not shown. Hide object (HIDDEN) ‘X’ = Yes, ‘ ’ = No If you do not want the user of the Web application to be able to navigate within it or if you want the user to be able to print the display, and therefore the context menu is no longer to be displayed, then deactivate this function. Objects with navigation links (GENERATE_LINKS) ‘X’ = Yes, ‘ ’ = No This attribute creates the open/close symbol, with which you can open or close the Web item. Behind this symbol is a link that calls up the Web application with the corresponding parameters. Web item controls different data providers (TARGET_DATA_PROVIDER_I) (optional) For many Web items, this attribute appears under the respective special attributes. These Web items obtain their data from a view. If a Web item is to control several data providers, for example, a navigation block, it can be expressed by this parameter. If it is not specified, the Web item always controls its own data provider. The values specified under this parameter are the logical names of the data providers, for example, references using wild cards. You do not have to specify the data provider belonging to the Web item. If it is missing, the Web item does not control its own data provider. The Web item output generation is always based on the item’s own data provider and does not include the others. The commands are forwarded to the target data provider. Web API Reference BW 3.5 15 SAP Online Help 25.02.2005 Table Definition A Web item that obtains data from a query view to create a table for a Web application. Navigation links are incorporated with the table. Use The Web item Table displays the value of a query view in the Web application in the form of a table. The same list geometry that is used in the BEx Analyzer is supported. Characteristics and structures can be displayed in both the rows and the columns. Structure As well as its general attributes [Seite 12], the Web item Table has the following attributes: Attributes Description Alternating styles for table rows (ALT_STYLES) In the rows, the formats SAPBEXstdData and SAPBEXstdDataOdd are used alternately to display numerical values. You can adjust them in the CSS file assigned to the template. 'X' = Yes, ' ' = No Totals cells are removed from this display. Only allow hierarchy navigation The context menu is hidden in this mode, and you can only expand and collapse from the list. Only hierarchy navigation (ONLY_HIERARCHY_NAVIGATION) 'X' = Yes, ' ' = No Suppress repetition texts Suppressing repetition texts (SUPPRESS_REPETITION_TEXTS) If you set this attribute to ‘ ‘, the cells in the table are not merged and the texts and keys are repeated. 'X' = Yes, ' ' = No If you do not specify a value for this attribute, the texts are suppressed. Number of data rows displayed at one time (BLOCK_SIZE) Specifying this attribute allows you to determine the number of data rows that are displayed after which an area for scrolling is inserted. If the value is set to 0, the complete table is displayed, regardless of the number of data rows. The attribute is set to 100 by default. Web API Reference BW 3.5 16 SAP Online Help Rows scrolled per step (BLOCK_STEP_SIZE) Default setting: “0” 25.02.2005 This attribute allows you more flexibility in structuring the scrolling logic: You are able to determine the number of data rows scrolled per step. The default setting “0” corresponds to 2/3 of the display rows. The value entered corresponds to the number of rows scrolled through. If you enter the value “2”, two rows will be scrolled through. If you want to scroll through all the displayed data rows, enter the same value as you entered for the attribute Number of data rows displayed at one time (BLOCK_SIZE). Number of data columns displayed at one time (BLOCK_SIZE_COLUMNS) Specifying this attribute allows you to determined the number of data columns that are displayed after which an area for scrolling is inserted. If the value is set to 0, the complete table is displayed, regardless of the number of data columns. The attribute is set to 0 by default. Columns scrolled per step (BLOCK_STEP_SIZE_COLUMNS) Default setting: “0” This attribute allows you more flexibility in structuring the scrolling logic: You are able to determine the number of data columns scrolled per step. The default setting “0” corresponds to 2/3 of the display columns. The value entered corresponds to the number of columns scrolled through. If you enter the value “2”, two columns will be scrolled through. If you want to scroll through all the displayed data rows, enter the same value as you entered for the attribute Number of data columns displayed at one time (BLOCK_SIZE_COLUMNS). Table: Scrolling area top (SHOW_PAGING_AREA_TOP) 'X' = Yes, ' ' = No Web API Reference Display the scrolling area at the start of the table The attribute is specified with default ' '. BW 3.5 17 SAP Online Help 25.02.2005 Display the scrolling area at the end of the table The attribute is set to ‘X’ by default. Table: Scrolling area bottom (SHOW_PAGING_AREA_BOTTOM) 'X' = Yes, ' ' = No Display the labels above the data The attribute is set to ‘X’ by default. Display column headers (SHOW_COLUMN_HEADER) 'X' = Yes, ' ' = No Display the labels to the left of the data The attribute is set to ‘X’ by default. Display column headers SHOW_ROW_HEADER) 'X' = Yes, ' ' = No The data cells are shown by default. That is, the attribute is set to ‘X’ by default. Display data cells (SHOW_DATA_CELLS) 'X' = Yes, ' ' = No List of data providers to which all table commands are sent. Affected data provider (TARGET_DATA_PROVIDER) Display data from value row (DATA_ROW_FROM) Data row after which data is displayed The attribute is set to 1 by default. Display data to value row (0=to the end) Data row to which data is displayed The attribute is set to 0 by default. If the value is 0, the system tries to display all of the rows. If there are too many, a scrolling area is inserted. If the value is not 0, data is displayed up to the specified row and there is no scrolling area. (DATA_ROW_TO) Display data from value column (DATA_COLUMN_FROM) Data column after which the data is displayed The attribute is set to 1 by default. Display data to value column (0=to the end) Data column to which data is displayed The attribute is set to 0 by default. If the value is 0, the system tries to display all of the columns. If there are too many, a scrolling area is inserted. If the value is not 0, data is displayed up to the specified column and there is no scrolling area. (DATA_COLUMN_TO) Attributes that cannot be set in the Web Application Designer: MODIFY_CLASS ABAP class that changes the table contents By using the Web design API for tables, you can adjust the contents of the table cells individually. Also see: Web Design API for Tables [Seite 277] Display the table with a maximum of 5 visible data columns and 10 visible data rows. Start at row 30 and show a scrolling area above and below the values <object> Web API Reference BW 3.5 18 SAP Online Help 25.02.2005 <param name=’OWNER’ value=’SAP_BW’> Web API Reference BW 3.5 19 SAP Online Help 25.02.2005 <param name=’CMD’ value=’GET_ITEM’> <param name='ITEM' value='Table'> <param name='ITEM_CLASS' value='CL_RSR_WWW_ITEM_GRID'> <param name='DATA_PROVIDER' value='View1 > <param name='DATA_ROW_FROM' value='30'> <param name='SHOW_PAGING_AREA_TOP' value='X'> <param name='SHOW_PAGING_AREA_BOTTOM' value='X'> <param name='BLOCK_SIZE' value='10'> <param name='BLOCK_SIZE_COLUMNS' value='5'> ITEM :Table </object> Display only the 3 data rows without headers <object> <param name=’OWNER’ value=’SAP_BW’> <param name=’CMD’ value=’GET_ITEM’> <param name='ITEM' value='Table'> <param name='ITEM_ID' value='MYTABLE'> <param name='DATA_PROVIDER' value='View1 > <param name='DATA_ROW_FROM' value='3'> <param name='DATA_ROW_TO' value='3'> <param name='SHOW_COLUMN_HEADER' value=' '> ITEM :Table </object> You can find more information on using the Table Web item and its functionality under Context Menu Functions [Extern] and Table [Extern]. Web API Reference BW 3.5 20 SAP Online Help 25.02.2005 Chart Definition A Web item that obtains data from a query view to create a graphic for a Web application. Use The Chart Web item enables you to display data graphically in your Web application. Structure As well as its general attributes [Seite 12], the Chart Web item has the following specific attributes: Attributes Description Edit Chart: Chart Designer The button with the three dots brings you to the Chart Designer. You can choose the chart type and make a number of settings for the chart. See Editing Charts [Extern]. (CUSTOMIZE) The totals rows/columns of the source data provider are not displayed in the chart. This means that you can suppress totals that may affect the chart display adversely, without having to change the data provider. Suppress Totals (SUPPRESS_SUMS) 'X' = Yes, ' ' = No You can swap the chart axes in the display without changing the navigational state of the query view itself. Swap Display Axes (SWITCHMATRIX) 'X' = Yes, ' ' = No This has the same effect as swapping the two free characteristics with one another in the initial query view. You can remove open nodes when you create charts in active presentation hierarchies. This ensures that the total of the values displayed is the overall result. Hide Expanded Hierarchy Nodes (SUPPRESS_OPENHIERARCHIENODES) 'X' = Yes, ' ' = No List of data providers to which all chart commands are sent. Affected Data Provider (TARGET_DATA_PROVIDER) Automatic Display of Units and Currencies (AUTOMATIC_LABELS) 'X' = Yes, ' ' = No Web API Reference If the units and currencies or other settings in the query are the same, and you select the attribute, these are the units, currencies, and settings which are displayed automatically on the chart. Alternatively, you can set the display of units and currencies manually. See Formatting Axes and Gridlines [Extern] in the section „Inserting or Removing Axes Titles and Units “. BW 3.5 21 SAP Online Help 25.02.2005 Language-dependent text for the title of the chart. Chart Title (Language-Dependent) (TITLE) Language-dependent text for the subtitle of the chart. Chart Subtitle (Language-Dependent) (SUBTITLE) Language-dependent text for the title of the category axis (X). Category Axis (X): Title (LanguageDependent) (TITLE_CATEGORIES) Language-dependent text for the unit of the category axis (X). Category Axis (X): Unit (LanguageDependent) (UNIT_CATEGORIES) Language-dependent text for the title of the primary value axis (Y). Primary Value Axis (Y): Title (LanguageDependent) (TITLE_VALUES) Language-dependent text for the unit of the primary value axis (Y). Primary Value Axis (Y): Unit (LanguageDependent) (UNIT_VALUES) Secondary Value Axis (Y): Title (LanguageDependent) Language-dependent text for the title of the secondary value axis (Y). (TITLE_SEC_VALUES) Secondary Value Axis (Y): Unit (LanguageDependent) Language-dependent text for the unit of the secondary value axis (Y). (UNIT_SEC_VALUES) Language-dependent text for the title of another axis. This attribute is only needed for specific chart types such as a histogram or a scatter chart. Another Axis: Title (TITLE_SEC_CATEGORIES) Language-dependent text for the unit of another axis. This attribute is only needed for specific chart types such as a histogram or a scatter chart. Another Axis: Unit (UNIT_SEC_CATEGORIES) If you activate this attribute no exceptions are displayed in the chart, although the data provider on which it is based has exceptions. See Display of Exceptions for Maps and Charts [Extern]. Ignore Exception in Chart Display (IGNORE_EXCEPTIONS) Automatic Axis Labeling for Simple Charts (AUTOMATIC_DESCRIPTION) This attribute enables the system to create labels automatically for the chart axes for very simple charts such as column-, bar, or line diagrams. For example, the name of a key figure appears on the Y axis in a bar chart. For more information, see Automatic Axis Labels for Simple Charts [Extern]. The texts, such as chart title, chart subtitle, as well as title and units of the axes, are all language dependent. You can find additional information under Language-Dependent Texts [Seite 259]. Web API Reference BW 3.5 22 SAP Online Help 25.02.2005 You can enter the texts both in the Web Application Designer for the respective attributes and in the Chart Designer. Note the following for the Heading attribute under General (general attributes): Heading You can enter a heading for the chart. This heading is not a part of the chart. Within Chart Designer, you also have the option of specifying a heading. This is not a part of the chart, however. The heading is displayed only if the attribute Generate Heading is active at the same time. In addition, you can use the following attribute (parameter), which is not available to you in the Web Application Designer, which, however, can be inserted using the HTML view of the Web template. Attribute Description Show Data Table If you use this attribute the system shows the data in a table below the chart. (SHOW_DATATABLE) You can find more information on using the Chart Web item and its functions under Context Menu Functions [Extern]. Web API Reference BW 3.5 23 SAP Online Help 25.02.2005 Dropdown Box Definition The Web item Dropdown Box allows you to filter characteristic values from a Web application in a dropdown box. Use When you select a value, the assigned query view is filtered according to this value. If a different method is used to select a filter value for the characteristic in the dropdown box, the current filter value appears in the dropdown box. Structure As well as its general attributes [Seite 12], the Dropdown Box Web item also has the following attributes: Attributes Description Index in the filter command (INDEX) Must have a clear value for all dropdown boxes and radio button groups [Seite 27] within the form tag. This attribute must be changed only if the ONLY_VALUES attribute is active. Characteristics / structure (IOBJNM) Name of characteristic / structure according to which you want to filter Specify the technical name of the characteristic (for example, 0COUNTRY) or the structure (25 characters) The technical name of the characteristic is stored in the query definition. In the BEx toolbar, choose Change Query View → Change Query (Local View) or (Global View) → . The technical names of the InfoObjects are displayed. Note that the characteristic you have chosen must be included in the query that the Web application is based on. Web API Reference BW 3.5 24 SAP Online Help Read mode (BOOKED_VALUES) 25.02.2005 Specifies which values in the master data table are copied to the Checkboxes Web item as filter values: • M: All values from the master data table. In some circumstances values that do not appear in the data provider under the current filter conditions and that produce the result No suitable data found when filtered, might also be displayed. However, this process is fastest under certain conditions. Maximum number of values in the dropdown box (MAXVALUES) • D: Values that are basically posted, whereby the current drilldown status is not fully taken into consideration. • Q: Only values that are also posted in the Data Provider under the currently valid filter conditions are displayed. It can take a long time under certain circumstances. Contains the maximum number of values that are displayed in the dropdown box. (optional) If this attribute has the value 0, all the available values are written in the dropdown box. Label (SHOW_LABEL) Use BW description as label 'X' = Yes, ' ' = No If this attribute is activated, the long text of the characteristic is written as a label in front of the dropdown box. In addition, you can use the context menu related to the description of the characteristic in this label. Display values only (ONLY_VALUES) Create dropdown box only 'X' = Yes, ' ' = No If you activate this attribute, only the HTML form Web item for the value list is created. In this case you have to create the form in which the dropdown box is contained manually. (optional) This attribute is suitable for creating forms [Seite 234] that contain several dropdown boxes. Do not display entry All values (NO_REMOVE_FILTER) If this field is not blank, the entry All values is not set as a selection option in the radio button group. 'X' = Do not offer “All values”, ' ' = Display entry “All values” Web API Reference BW 3.5 25 SAP Online Help Data provider affected (TARGET_DATA_PROVIDER) 25.02.2005 Contains a list of all data providers to which the filter commands are sent. If you filter according to a characteristic and then activate this attribute, the different data providers for the Web item are notified. For further information about this attribute, see General Attributes [Seite 12]. You will find more information on using the Dropdown Web item and its functionality under Dropdown Box, Radio Button Group, Checkboxes, Hierarchical Filter Selection. [Extern] Web API Reference BW 3.5 26 SAP Online Help 25.02.2005 Radio Button Groups Definition The Radio Button Group Web Item buttons. allows you to filter characteristic values in a group of radio Use When you select a value, the assigned query view is filtered according to this value. If you select a filter value in another way for the characteristic of the radio button group, the current filter value is selected. Structure As well as its general attributes [Seite 12], the Radio Button Group Web item has the following attributes: Attributes Description Characteristics / structure (IOBJNM) Name of the characteristic / structure by which the system is to filter Specify the technical name of the characteristic (for example, 0COUNTRY) or the structure (25 characters) The technical name of the characteristic is stored in the query definition. In the BEx toolbar, choose Change Query View → Change Query (Local View) or (Global View) → . The technical names of the InfoObjects are displayed. Note that the characteristic you have chosen must be included in the query that the Web application is based on. Web API Reference BW 3.5 27 SAP Online Help Read mode (BOOKED_VALUES) 25.02.2005 Specifies which values in the master data table are copied to the Checkboxes Web item as filter values: • M: All values from the master data table. In some circumstances values that do not appear in the data provider under the current filter conditions and that produce the result No suitable data found when filtered, might also be displayed. However, this process is fastest under certain conditions. Maximum number of displayed values (MAXVALUES) • D: Values that are basically posted, whereby the current drilldown status is not fully taken into consideration. • Q: Only values that are also posted in the data provider under the currently valid filter conditions are displayed. It can take a long time under certain circumstances. Contains the maximum number of values that are displayed in the radio button group. (optional) If you set the value to 0, all the available values in the radio button group are displayed. Label (SHOW_LABEL) Use BW description as label 'X' = Yes, ' ' = No If this attribute is activated, the long text of the characteristic is written as a label in front of the radio button group. In addition, you can use the context menu related to the description of the characteristic in this label. Entries next to one another (HORIZONTAL_ALIGNMENT) If this attribute is activated, the different characteristic values are grouped vertically. If this attribute is deactivated, the characteristic values are grouped horizontally. 'X' = Yes, ' ' = No Number of entries next to one another/below one another (HORIZONTAL_NUMBER) Web API Reference Contains the number of entries listed next to one another or below one another, depending on the attribute settings for HORIZONTAL_ALIGNMENT. BW 3.5 28 SAP Online Help 25.02.2005 Display values only (ONLY_VALUES) Create radio button group only ‘X’ = Yes, ‘ ’ = No If you activate this attribute, only the HTML form Web item for the radio button group is created. Here you have to create the form, in which the radio button group is contained, manually. This attribute is suitable for creating forms [Seite 234] that contain several radio button groups. Do not display entry All values (NO_REMOVE_FILTER) If this field is not blank, the entry All values is not set as a selection option in the radio button group. 'X' = Do not offer “All values”, ' ' = Display entry “All values” Affected data provider (TARGET_DATA_PROVIDER) Index in the filter command (INDEX) (optional) List of data providers to which all selection button commands are sent. Must have a unique value for all dropdown boxes and radio button groups [Seite 27] within the form tag. This attribute must be changed only if the ONLY_VALUES attribute is active. You will find more information on using the Radio button-group Web item and its functionality under Dropdown Box, Radio Button Group, Checkboxes, Hierarchical Filter Selection [Extern]. Web API Reference BW 3.5 29 SAP Online Help 25.02.2005 Checkboxes Definition Checkboxes checkboxes. is a Web item that places characteristic values to be filtered in a group of Use The Checkboxes Web item can be used to easily filter a connected query view according to a particular characteristic. You can set or remove filter values in the Web application by setting the indicators. Structure As well as its general attributes [Seite 12], the Checkboxes Web item has the following attributes: Attribute Values Description Characteristic/structure Selection list Select the technical name of the characteristic. (IOBJNM) Characteristics and structures are read from data providers. The characteristic values are provided in a dropdown box in the Web application as filter values. Read mode • Master data table (M) (BOOKED_VALUES) • Dimension table (D) • Posted values (Q) Standard setting “Dimension table” Specifies which values in the master data table are copied to the Checkboxes Web item as filter values: • M: All values from the master data table. In some circumstances values that do not appear in the data provider under the current filter conditions and that produce the result No suitable data found when filtered, might also be displayed. However, this process is fastest under certain conditions. • Web API Reference BW 3.5 D: Values that are basically posted, whereby the current drilldown status is not fully taken into consideration. 30 SAP Online Help 25.02.2005 • Maximum number Default value: “0” (MAXVALUES) Maximum length Q: Only values that are also posted in the data provider under the currently valid filter conditions are displayed. This can take a long time in some instances. Maximum number of displayed filter values If "0", all values are displayed. Maximum number of characters in the label. (MAXLENGTH) Label ‘X’ = Yes, ‘ ’ = No (SHOW_LABEL) Default setting: ‘X’ = Yes Affected data provider Selection list List of data providers to which all checkbox commands are sent. ‘X’ = Yes, ‘ ’ = No Order entries next to one another (TARGET_DATA_PROVIDER) Entries next to one another (HORIZONTAL_ALIGNMENT) Default setting: ‘ ‘ = No If this attribute is activated, the long text of the characteristic is written as a label in front of the control box. If this attribute is activated, the different characteristic values are grouped vertically. If this attribute is deactivated, the characteristic values are grouped horizontally. Number of entries next to/under one another (HORIZONTAL_NUMBER) Default value: 1 Contains the number of entries listed next to one another or below one another, depending on the attribute settings for HORIZONTAL_ALIGNMENT. You will find more information on using the Checkboxes Web item and its functionality under Dropdown Box, Radio Button Group, Checkboxes, Hierarchical Filter Selection. [Extern] Web API Reference BW 3.5 31 SAP Online Help 25.02.2005 Generic Navigation Block Definition A Web item that obtains data from a query view to create a generic navigation block for a Web application. This block contains keys that you can use to transfer characteristics, for example, into rows or columns. Use The Web item (Generic Navigation Block) displays the navigational state of a query view in the Web application in the form of a table. All characteristics and structures in the query view are listed in the table and their filter values are displayed. You can change the navigational status of the query view. You can transfer characteristics and structures to an axis (rows or columns) or from an axis. You can filter according to single values and remove the filter again. Structure As well as its General Attributes [Seite 12], the Generic Navigation Block Web item has the following attributes: Attributes Description Read mode This attribute specifies which values in the master data table are copied to the Checkboxes Web item as filter values: (BOOKED_VALUES) (BOOKED_VALUES_N) • “Master data table” M: All values from the master data table. In some circumstances values that do not appear in the data provider under the current filter conditions and that produce the result No suitable data found when filtered, might also be displayed. However, this process is fastest under certain conditions. “Dimension table” “Posted values” • D: Values that are basically posted, whereby the current drilldown status is not fully taken into consideration. • Q: Only values that are also posted in the data provider under the currently valid filter conditions are displayed. It can take a long time under certain circumstances. Read mode for filter items The “master data” read mode may lead to many unposted values being displayed; the “posted values” read mode may be slow. Grouping axes (SHOW_AXES_GROUPING) ‘X’ = Yes, ‘ ’ = No Web API Reference If you set the indicator for this attribute, free characteristics, characteristics in the rows and the characteristics in the columns will be displayed in groups. BW 3.5 32 SAP Online Help Characteristics of the rows collapsed (ROWS_CLOSED) 25.02.2005 If you set the indicator for this attribute, the characteristics for the rows are displayed collapsed in the grouped display. ‘X’ = Yes, ‘ ’ = No Characteristics of the columns collapsed (COLUMNS_CLOSED) If you set the indicator for this attribute, the characteristics for the columns are displayed collapsed in the grouped display. ‘X’ = Yes, ‘ ’ = No Free characteristics collapsed (FREE_CHARACTERISTICS_CLOSED) If you set the indicator for this attribute, the free characteristics will be displayed collapsed in the grouped display. ‘X’ = Yes, ‘ ’ = No Display empty filter (SHOW_EMPTY_SLICER) 'X' = Yes, ' ' = No Delimitation between the characteristics (SHOW_MARGIN) If you set the indicator for this attribute, the empty filters will be displayed in the grouped display. If you set the indicator for this attribute, the characteristics in the non-grouped display are separated from one another. ‘X’ = Yes, ‘ ’ = No Order entries next to one another (HORIZONTAL_ALIGNMENT) ‘X’ = Yes, ‘ ’ = No Entries next to one another (HORIZONTAL_NUMBER) Default value: 3 As well as arranging the characteristics below one another, you can also display them next to one another. In many cases, this makes better use of the display area and there is a stronger visual link between, for example, the table and the navigation block. Describes the maximum number of characteristics that can be displayed next to one another. If the navigation block contains more than the specified number of characteristics, then it is automatically displayed in more than one row, where the number of characteristics per row is optimized regarding the equal distribution of rows and the required number of characteristics. This attribute is only included when HORITONTAL_ALIGNMENT (Define entries next to one another) is activated. Maximum filter value length (FILTER_VALUE_LENGTH) Default value: 80 You specify the number of characters, according to which filter value is indicated, by <Number>. If you set the value to 0, then the complete filter value is displayed. Web API Reference BW 3.5 33 SAP Online Help Display characteristics of the rows (SHOW_ROWS) 25.02.2005 If you set the indicator for this attribute, the characteristics of the rows are displayed. ‘X’ = Yes, ‘ ’ = No Display characteristics of the columns (SHOW_COLUMNS) If you set the indicator for this attribute, the characteristics of the columns are displayed. ‘X’ = Yes, ‘ ’ = No Display free characteristics (SHOW_FREE_CHARACTERISTICS) If you set the indicator for this attribute, the free characteristics are displayed. ‘X’ = Yes, ‘ ’ = No Displaying navigation icons (SHOW_NAVIGATION_ICONS) Display filter icons (SHOW_FILTER_ICONS) If you set the indicator for this attribute, the icons for navigation are displayed. If you set the indicator for this attribute, the icons for filtering are displayed. ‘X’ = Yes, ‘ ’ = No Frame name for input help (TARGET_HELP_FRAME) (optional) You can display input help in a different frame from the data. If you activate this attribute, input help is displayed in the same window. This parameter is not offered in the Web Application Designer and can only be used for parameterization in the Web template. List of characteristics with read mode (IOBJNM_LIST) Affected data provider (TARGET_DATA_PROVIDER) This attribute contains a list of characteristics with read mode. You can select a characteristic of a structure and activate the read mode for it. This attribute contains a list of all data providers to which the navigation block is sent. If you filter according to a characteristic and then activate this attribute, the different data providers for the Web item are notified. For further information about this attribute, see General Attributes [Seite 12]. Table interface class (MODIFY_CLASS) Table interface class By using the Web design API for tables, you can adjust the cell content individually in the navigation block. See also: Web Design API for Tables [Seite 277] Web API Reference BW 3.5 34 SAP Online Help 25.02.2005 Listing the names of characteristics and structures enables you to determine which entries appear in the navigation block, and in which order. List of navigation block entries (ITEM_NAV_BLOCK_IOBJNM_N) (optional) In the WAD, this attribute is displayed using the List of Characteristics with Read Mode attribute (IOBJNM_LIST). If you do not specify this parameter, all characteristics and structures in the navigation block are displayed. You can find more information on using the Generic navigation block Web item and its functions under Generic Navigation Block [Extern]. Web API Reference BW 3.5 35 SAP Online Help 25.02.2005 Hierarchical Filter Selection Definition Web item that creates a hierarchical filter selection from the hierarchy of a characteristic or structure. The hierarchy nodes appear as menu entries and can be set as a filter. Use Using the hierarchical filter selection you can filter a query view by hierarchy nodes. Structure As well as its general attributes [Seite 12], the Web item Hierarchical Filter Selection has the following attributes: Attribute Values Description Reload level dynamically (DYNAMIC) ‘X’ = Yes, ‘ ’ = No Default setting: ‘X’ = Yes Reload from levels underneath the start level. If this attribute is set, the levels below the start level are reloaded dynamically, if required. Otherwise, they are not offered. Characteristic/structure Selection list (IOBJNM) Select the technical name of the characteristic/structure. The hierarchy and structure nodes are read from the data provider and can be used as filter values in the selection. Hierarchy name Selection list Technical name of the hierarchy which should be used for filtering nodes. If the field is blank, the system uses the hierarchy that is currently set. Selection list Version of the hierarchy that should be used for filtering nodes. If the field is blank, the current version of the presentation hierarchy is used. (HIERARCHY_NAME) Version (HIERARCHY_VERSION) Key Date Key date for which the hierarchy is evaluated. (DATE) The hierarchy is used as it existed on the given date. If this field is blank, the key date of the query is used. Web API Reference BW 3.5 36 SAP Online Help 25.02.2005 You can remove the key date using the Delete Date pushbutton. Label (SHOW_LABEL) ‘X’ = Yes, ‘ ’ = No Default setting: ‘X’ = Yes Display the description for the characteristic. This attribute allows you to either show or hide the display of the characteristic description. Drill level Default value: “3” (DRILL_LEVEL) Affected data provider List of data providers to which all hierarchy commands are sent. (TARGET_DATA_PROVIDER ) Web API Reference Maximum drill level of the filter selection (blank= drill level corresponding to query definition) BW 3.5 37 SAP Online Help 25.02.2005 Filters Definition A filter is a Web item that displays the filter values resulting from navigation for a query view in the Web application. Use The Web item Filter displays the filter values that have been generated by navigating in a query view in a Web application. You also use filters to select individual values. Structure As well as its general attributes [Seite 12], the Filter Web item has the following attributes: Attributes Description Display Filter Values The filter value is displayed in accordance with the setting. If no display is specified for an index, the index 0 display (no index) is used. PRESENTATION (optional) PRESENTATION_N (optional) 'KEY' = key If this parameter is not specified, the display, which is valid for the characteristic, is used. 'TEXT' = Descriprtion 'KEY_TEXT' = Key and description 'TEXT_KEY' = Description and key List of characteristics List of characteristics with display (ITEM_LIST) Maximum filter value length (FILTER_VALUE_LENGTH) Default value: 0 You specify the number of characters, according to which a filter value is indicated, by “...”. If you keep the value as 0 (default), the complete filter value is displayed. Only display values (ONLY_VALUES) When you activate this attribute, the filter values are displayed without any labeling, and the formatting is separated using semi-colons. "X" = Yes, " " = No Web API Reference BW 3.5 38 SAP Online Help 25.02.2005 Listing the names of characteristics and structures enables you to determine which entries appear in the filter and in which order. Only those entries for which a filter value exists are displayed. The remaining entries are skipped over. List characteristics and structures (ITEM_FILTER_IOBJNM_N) (optional) This attribute is displayed in the Web Application Designer in the attribute list of the characteristic (ITEM_LIST). If you do not specify this parameter, all the characteristics and structures that are filtered are displayed. If you combine ONLY_VALUES=X and ITEM_FILTER_IOBJNM=MyInfoObject, it is possible to identify a single filter value in the Web template. This is also useful in headers, for example. Displaying filter values for the characteristic Calendar year without formatting <object> <param name=’OWNER’ value=’SAP_BW’> <param name=’CMD’ value=’GET_ITEM’> <param name=’ITEM’ value=’Filter’> <param name='ITEM_ID' value='FILTER'> <param name='DATA_PROVIDER' value='View1 > <param name=’ONLY_VALUES’ value=’X’> <param name=’ITEM_FILTER_IOBJNM’ value=’0CALYEAR’> ITEM :Filter </object> Input field for filtering according to Calendar year with preassigned dynamic filters (only works with single value filters) <form action="<SAP_BW_URL DATA_PROVIDER='View 1' FILTER_IOBJNM='0CALYEAR'>" method="post"> Calendar year: <input name="FILTER_VALUE_EXT" size=4 maxlength=4 value=" <object> <param name=’OWNER’ value=’SAP_BW’> <param name=’CMD’ value=’GET_ITEM’> <param name=’ITEM’ value=’Filter’> <param name='ITEM_ID' value='FILTER'> <param name='DATA_PROVIDER' value='View1 > <param name=’ONLY_VALUES’ value=’X’> <param name=’ITEM_FILTER_IOBJNM’ value=’0CALYEAR’> <param name='PRESENTATION' value='KEY'> ITEM :Filter </object> <input type=submit value="Submit"> <input type=reset value="Reset"> </form> Web API Reference BW 3.5 39 SAP Online Help Web API Reference 25.02.2005 BW 3.5 40 SAP Online Help 25.02.2005 Label Definition The Web item Label allows you to display the descriptions of characteristics, attributes, or structural components. You can also create a link to the context menu of these characteristics, attributes, or structural components. Use This Web item, together with the Web items Dropdown-Box [Seite 24] and Radio Button-Group [Seite 27], can be used for configuring a comfortable cockpit. You can create navigation blocks by putting different labels for characteristics and structural components into a table. Structure As well as its general attributes [Seite 12], the Label Web item has the following attributes: Attribute Description Context menu (CONTEXT_MENU) 'X' = Yes, ' ' = No If this attribute is activated, a link to the context menu of the characteristic or the structural component is displayed in the description of the characteristic. Characteristics / structure (IOBJNM) Name of the characteristic/structure Specify the technical name of the characteristic (for example, 0COUNTRY) or the structure (25 characters) The technical name of the characteristic is stored in the query definition. In the BEx toolbar, choose Change Query View → Change Query (Local View) or (Global View) → . The technical names of the characteristics are displayed. Structural component (STRUCTURE_MEMBER) Structural component whose text or context menu is displayed. Attribute name (ATTRINM) Technical name of the attribute whose header is to be displayed as a label. Only display values Unformatted display (ONLY_VALUES) Only the link to the context menu is generated. 'X' = Yes, ' ' = No If this attribute is activated, only the link to the context menu is displayed. The label is displayed without formatting. You can determine in the Web template how you would like to put the link underneath. Web API Reference BW 3.5 41 SAP Online Help 25.02.2005 If you would like to add a label for a structural component in your Web application, then you have to enter the technical name of the structure under InfoObject and enter the filter value of the structure under Structural Component (STRUCTURE_MEMBER). The correct values are determined as follows: a. Execute a Web application that contains the structural component. b. Filter according to the structural component in question: Choose Keep as filter value in the context menu of the structural component. c. Copy the parameter value FILTER_IOBJNM from the URL into the clipboard. d. Choose the attribute in the Web Application Designer and enter the value that was saved in the clipboard. e. Copy the parameter value FILTER_VALUE from the URL into the clipboard. f. Choose the attribute Structural component from the Web item Label in the Web Application Designer and enter the value that was saved in the clipboard. g. Save your entries. You can find more information on using the Label Web item and its functionality under Context Menu Functions [Extern]. Web API Reference BW 3.5 42 SAP Online Help 25.02.2005 Text Elements Definition Web item that displays the text elements for a query view in a Web application. Use The Web item Text Element provides information on the query, on which the query view, and therefore the Web application, is based. You can also select text elements individually. Structure The text elements are similar to the text elements in the BEx Analyzer and are made up of the following parts: • general text elements: − technical name of the query (REPTNAME) − description of the query (REPTXTLG) − InfoProvider (INFOCUBE) − key date for the query (SRDATE) − validity of the data (date and time) (ROLLUPTIME) − the person who wrote the query (AUTHOR) − the last time the query was changed (date and time) (MODTIME) − the last person to make changes to the query (MODUSER) − current user (SYUSER) − the last time the query was refreshed (date and time) (SYUZEIT) • Variables • static filter values As well as its general attributes [Seite 12], the Text Elements Web item has the following attributes: Attributes Description Display general text elements (SHOW_COMMON_ELEMENTS) If you activate this attribute, the common text elements are displayed. ‘X’ = Yes, ‘ ’ = No Display static filter values (SHOW_FILTERS) ‘X’ = Yes, ‘ ’ = No Display variable values (SHOW_VARIABLES) ‘X’ = Yes, ‘ ’ = No Web API Reference If you activate this attribute, the filter values that you determined in the filter area of the query definition are displayed. If you activate this attribute, the variable values for the query (on which the Web application is based) are displayed. BW 3.5 43 SAP Online Help 25.02.2005 List of text elements (ELEMENT_NAME_N) By listing the text element names in combination with their type ELEMENT_TYPE_N, you are able to determine which entries appear as text items and the order in which they appear. With general text elements the name corresponds to one of the values listed above (under General Text Items). With variables the name corresponds to the variable name, and with filters the name corresponds to the name of the characteristic. If you do not specify this parameter, all the filtered characteristics and filtered structures are displayed. See above: List of Text Elements List of the types of text elements (ELEMENT_TYPE_N) COMMON = General text element FILTER = Static filter value Both attributes, List of Text Elements (ELEMENT_NAME_N) and List of Text Element Types (ELEMENT_TYPE_N), are addressed in the Web Application Designer in the Element List (ITEM_LIST) attribute that lies below. VARIABLE = Variable value VARIABLE_KEY = Key for variable value This attribute contains a list of text elements with type and name. You can choose the type of text element from the list or enter the name of the item manually. List of elements (ITEM_LIST) Only display values (ONLY_VALUES) ‘X’ = Yes, ‘ ’ = No If you activate this attribute, the values for the text elements are displayed without any labeling, and the formatting is separated by semi-colons. The combination of ONLY_VALUES=X, ITEM_TYPE =COMMON, and ITEM_NAME=REPTXTLG, makes it possible to access a text element directly in the Web template, here for example, the query name. The name is used in a title, for example. Display of validity of data, filter value for cost center and values for 2 variables <object> <param name='OWNER' value='SAP_BW'> <param name='CMD' value='GET_ITEM'> <param name='ITEM' value='Text'> <param name='ITEM_CLASS' value='CL_RSR_WWW_TEXT_ELEMENTS'> <param name='ELEMENT_TYPE_1' value='COMMON'> Web API Reference BW 3.5 44 SAP Online Help 25.02.2005 <param name='ELEMENT_NAME_1' value='ROLLUPTIME'> <param name='ELEMENT_TYPE_2' value='FILTER'> <param name='ELEMENT_NAME_2' value='0COSTCENTER'> <param name='ELEMENT_TYPE_3' value='VARIABLE'> <param name='ELEMENT_NAME_3' value='myFirstVariable'> <param name='ELEMENT_TYPE_4' value='VARIABLE'> <param name='ELEMENT_NAME_4' value='mySecondVariable'> <param name='DATA_PROVIDER' value='MyDataProvider'> ITEM :Text </object> Web API Reference BW 3.5 45 SAP Online Help 25.02.2005 List of Exceptions Definition A Web item that lists the existing exceptions and their status (active/not active) for a stored query view in the Web application. Use The List of Exceptions Web item displays the status of the exceptions for a stored query view in the Web application, in the form of a table. For each exception, the status of the exception (active/not active) is also displayed. You can activate or deactivate the exceptions by clicking on the symbol. Structure The Web item List of Exceptions has only general attributes. See General Attributes [Seite 12] You can find more information on using exceptions under Exception Reporting [Extern]. You can find more information on using the List of Exceptions Web item and its functions under Context Menu Functions [Extern] and List of Exceptions [Extern]. Web API Reference BW 3.5 46 SAP Online Help 25.02.2005 List of Conditions Definition A Web item that displays all of the existing conditions and their status (active/not applicable/not used) for a stored query view in the Web application. Use The List of Conditions Web item displays the status of conditions for a stored query view in the Web application, in the form of a table. All of the conditions that can be applied to the current navigation status for the query view are listed. The status of the condition is displayed for every symbol to activate/deactivate the condition (active/not applicable/not used). You use the conditions. You can find additional information on navigation options in the list of conditions under List of Conditions [Extern]. Structure The Web item List of Conditions only has general attributes. See General Attributes [Seite 12]. Also see: You can find additional information about the scope of functions of conditions under Conditions [Extern]. You can find additional information about the usability and status descriptions of conditions under Using Conditions [Extern]. You can find more information on using the List of Conditions Web item and its functions under List of Conditions [Extern]. Web API Reference BW 3.5 47 SAP Online Help 25.02.2005 Alert Monitor Definition A Web item that the query views display as a list or a hierarchy in a Web application. These query views were found during background processing by the Reporting Agent [Extern]. Use With the help of the Alert Monitor Web item, you can go to the query views generated in the Exception Reporting [Extern] and Reporting Agent processes and see at a glance any noticeable, deviating key figures from defined threshold values. You can also set filters. Since there is only one data source for the Alert Monitor, there is no need to set up the Alert Monitor Web item as a separate data provider. The Alert Monitor Web item generates a suitable data provider for itself and transfers the filter operations to this data provider automatically. Structure In addition to its general attributes [Seite 12], the Alert Monitor Web item has the following attributes: Attributes Description Query (FILTER_QUERY) You can use this attribute to filter according to entries that come under a specific query. If you do not specify a query, no filter applies. Display minimal view list (MINIMAL_VIEW) When you go to the detail view, only the key figure columns are displayed for which exceptions can arise. (optional) 'X' = Yes, ' ' = No If you do not specify the parameter, the key figures are shown as scheduled. InfoCube (FILTER_INFOCUBE) You can use this attribute to filter according to entries that come under a specific InfoCube. If you do not specify an InfoCube, no filter applies. InfoArea (FILTER_INFOAREA) You can use this attribute to filter according to entries that come under a specific InfoArea. If you do not specify an InfoArea, no filter applies. Red entries (FILTER_RED) If you activate this attribute, you see the rows with at least one red entry. "X" = Yes, " " = No Yellow entries (FILTER_YELLOW) "X" = Yes, " " = No Green entries (FILTER_GREEN) "X" = Yes, " " = No Web API Reference If you activate this attribute, you see the rows with at least one yellow entry. If you activate this attribute, you see the rows with at least one green entry. BW 3.5 48 SAP Online Help Do not display number of alerts (SUPPRESS_NUMBERS) "X" = Yes, " " = No Display highest alert level (DISPLAY_MAX_LEVEL) "X" = Yes, " " = No 25.02.2005 You can use this attribute to determine that the number of alerts not be displayed in the alert monitor. Only the current alert symbol is shown. Instead of displaying red, yellow, and green entries with their frequency for each query view, you can display just the entry with the highest alert level. This may make the display easier to study. Number of rows in table (BLOCK_SIZE) Number of rows displayed at once in the table. Default value: 10 With the help of this attribute, you can determine the number of entries you want to display at the same time. We recommend that you restrict the number of entries, especially when the number of alerts is high. If you set the value to 0, all entries are displayed. If there are more rows with alerts, an index is added for you to scroll down. Display as hierarchy (HIERARCHY) "X" = Yes, " " = No Template for display (TARGET_TEMPLATE_ID) If you activate this attribute, the alerts are displayed in a hierarchy, starting with the level of InfoArea, InfoProvider, and query, and going up to the individual query views. If you deactivate this attribute, the alerts are displayed as a flat list. This means only the query views are displayed (no InfoAreas, InfoProviders, or queries). Web template upon which the detail view display is based. (optional) Web API Reference BW 3.5 49 SAP Online Help List display (LIST_FOCUS_LEVEL) 25.02.2005 This setting only affects the non-hierarchical display. You can set the criteria according to which alerts are to be displayed. You can choose from the following types: • VIEW: Navigational state • CELL: Individual Cells • EXCEPTIONS: Exceptions • INFOAREA: InfoArea • InfoCube: INFOCUBE • QUERY: Query Only lines of this type are displayed according to the selection. List of columns with labels (COLUMN_LIST) You can structure the columns however you want and display headers for the individual columns. Under Column Name, choose the type of column and enter the desired column heading for each. The following column types are available: • TEXT: Text • ACTION: Action • VALUE: Value with individual cells • DOCUMENT: Document display • MAX_LEVEL: Display greatest alert level • RED: Number of red exceptions • YELLOW: Number of yellow exceptions • GREEN: Number of green exceptions • DATE: Creation date • TIME: Creation time In the Reporting Agent you can make a setting so that the alert monitor entries are given a URL. To do this you need to maintain an entry in the Action (ACTION) column here. You can find more information under Editing Follow-Up Actions: Alert Monitor Entry [Extern]. This attribute compounds the attributes COLUMN_NAME and COLUMN_CAPTION. Display column captions (DISPLAY_COLUMN_CAPTION) If you do not activate this attribute, then the column headings are not displayed. 'X' = Yes, ' ' = No Web API Reference BW 3.5 50 SAP Online Help 25.02.2005 Display toolbar If this attribute is specified, then the user can control the attributes FILTER_RED, FILTER_YELLOW, FILTER_GREEN, HIERARCHY, and LIST_FOCUS_LEVEL using a toolbar. (DISPLAY_TOOLBAR) 'X' = Yes, ' ' = No Display Data Provider (DISPLAY_DATA_PROVIDER) (optional) 'X' = Yes, ' ' = No The detail view for an entry can also be displayed in the same Web template. To do this, the logical name of the DataProvider to be used for the display must be specified. The Web items that retrieve your data from this DataProvider display the detail view for the Alert Monitor entry automatically. In addition, you can use the following attribute, which is not available to you in the Web Application Designer, which, however, can be inserted using the HTML view of the Web template. Attribute Description Detail frame (TARGET_FRAME) Name of the frame for the detail view If you do not specify a detail frame, the detail view is displayed using pure HTML in the same window and opens a separate window using activated Java Script. The parameters JUMP_WBID and JUMP_PAGEID used in BW 2.x are still supported. However, we recommend that you no longer use these. Web API Reference BW 3.5 51 SAP Online Help 25.02.2005 Role Menu Definition The Role Menu Web item displays user favorites and/or roles in a tree. Prerequisites You have maintained roles and assigned them to the users. You can find more information under Users and Roles (BC-SEC-USR) [Extern] and under Setting Up Authorizations with Role Maintenance [Extern]. Use You can restrict the role menu to user favorites and roles or to a particular role. No menu entries are shown if the user is not assigned to this particular role. You can filter the menu entries according to various categories. A menu entry is a URL in a BEx Web application, for example. You can use the attribute TARGET to define in which window the URL is executed. Structure As well as its general attributes [Seite 12], the Role Menu Web item has the following attributes: Attributes Description List of Roles • Restriction to favorites and/or specific roles • If no entry is made, the assigned roles and favorites of the user are displayed. • The favorites can be displayed with ROLE=SAP_BW_FAVORITES_ (with two ‘_’ between SAP_BW and FAVORITES_). Do so by selecting the entry Own Favorites from the list. • If you want to restrict the display to specific roles, choose these roles from the list. • You can also use multiple selection of roles to display individual roles within a collective role using the Role Menu Web item. However, the collective roles are not available as F4 help. (ROLE_1, ROLE_2, ROLE_...) Number of levels. Number of levels that are initially read. (LEVEL) The role menu is initially loaded with the specified levels. Further levels are read dynamically by expanding folders. All levels are read for LEVEL=0. ‘0’ = all levels Web API Reference BW 3.5 52 SAP Online Help 25.02.2005 Filters Filter menu entries according to type (FILTER) You can filter according to the following types or type combinations. • 'U' = URLs • 'P ' = Web templates • ‘Y’ = Queries • 'R ' = Crystal Reports All entries for these types are displayed when a filter is not specified. For example, the filter ‘UP’ shows all URLs and Web templates with reference to ROLE. Name of Target Frame (TARGET) Name of the frame for executing menu entries. The URL is executed in the specified frame behind a menu entry. Scroll Bar Display Scrollbar display (SCROLL_STYLE) Scrollbars are displayed either dependently on the size of the contents (Auto) or independently of the size, either always (Yes) or never (No). “Auto” = Automatic (when needed) “Yes” = Scrollbar always displayed “No” = Scrollbars never displayed Web API Reference BW 3.5 53 SAP Online Help 25.02.2005 Display with IFrame Display as IFrame (IFRAME) You can display the Role Menu Web item in an Iframe (a frame imbedded in HTML) or in a frameset. On the one hand, the combination from other Web items with the Role Menu Web item is possible for an IFrame. On the other hand, Netscape 4.7 and PDAs do not support IFrames. Only the Role Menu Web item is displayed for the Frameset. The other Web items are ignored. 'X' = Yes, ' ' = No The advantage of IFrames is that they allow you to structure the HTML page for the role menu freely, for example, with text, logos, or other Web items. The role menu in the frame set is created generically and cannot be changed externally. If a role menu is called up with IFrame on Netscape 4.7 or on a PDA, the IFrame is ignored and a frameset is automatically sent to the Web browser. Display with Frame around IFrame Displaying the frame around the IFrame (IFRAME_STYLE) A frame border is displayed around the IFrame. The proposed value is ‘ ‘ = No. ‘X’ = Yes, ‘ ’ = No User and logo display User and logo display (DISPLAY_USER) Above the role menu, the user name is displayed along with a logo. 'X' = Yes, ' ' = No Logo Icon Path Path of the logo icon (ICON_LOGO) The path of the icon in the MIME repository that is displayed as a logo. You can only use this attribute in the context of DISPLAY_USER. For example: ‘Bex/Icons/s_logo.gif’ Logo Height in Dots Logo height in dots (HEIGHT_LOGO) You can use this attribute to individually adjust the height of your logo. It particularly makes sense to set this attribute when you have specified your own logo using the attribute Logo Icon Path (ICON_LOGO), and where the height of this logo does not match the default SAP logo height. Hierarchy display with colors Each hierarchy level is displayed with a different color. (HIERARCHY_COLOR) ‘X’ = Yes, ‘ ’ = No Web API Reference BW 3.5 54 SAP Online Help First level not displayed (HIDE_FIRST_LEVEL) 25.02.2005 The entries in the second hierarchy level are displayed. ‘X’ = Yes, ‘ ’ = No Display with icons (DIFF_ICONS) The entries in the role menu are each given an appropriate icon, regardless of the type. ‘X’ = Yes, ‘ ’ = No Web API Reference BW 3.5 55 SAP Online Help 25.02.2005 Ticker Definition The Web item Ticker enables you to display the content of a table as a ticker. Use To use the ticker, you need a Web browser that enables JavaScript. Structure As well as its general attributes [Seite 12], the Role Menu Web item has the following attributes: Attributes Description Create invisible form Create invisible form. (ONLY_VALUES) You can create an invisible form so that you can further process the ticker text. ‘X’ = Yes, ‘ ’ = No Separator (SEPARATOR) Separator between two ticker rows. Speed in milliseconds. Time in milliseconds until the ticker moves again. (SPEED) Separators are added when the data for a new data row is displayed. Default value: 200 Width of the ticket text in characters Width of the ticket text in characters. (TICKER_SIZE) Default value: 60 Place title at start of ticker text Place title at start of ticker text. (USE_CAPTION) ‘X’ = Yes, ‘ ’ = No Default setting: ‘X’ = Yes Delay in milliseconds Delay in milliseconds until the ticker starts run. (DELAY) Default value: 3000 Web API Reference BW 3.5 56 SAP Online Help 25.02.2005 Maps Purpose Many characteristics in the Business Information Warehouse, for example, customer, sales region, and country, contain important geographical characteristics. The geographical information can be evaluated in a map together with the business-orientated, relevant key figures. Use maps to visualize business-oriented connections and distributions. You can clearly display specific key figures as color shading, pie charts, or bar charts for a country, a region, or a city. You have the option to change the view of a map in which you either zoom in to display a detailed view or zoom out for an overall view. In this way, it becomes easier to view, for example, the sales analysis of a specific product that refers to a specific region or a country You can recognize the potential or dangers of a market all at a glance. Integration Maps help you with reporting geo-relevant data. By using the map Web item, you determine a geographical display in the BEx Web Application Designer for your business-oriented data for the Web application. Geo-relevant InfoObjects are stored and maintained in the Metadata Repository. The master data for geo-InfoObjects is equipped with geo-attributes. Assigning the range of geographic to business-oriented data (mapping/geocoding) using an external tool: ArcView from ESRI (Environmental Systems Research Institute). Features With maps you prepare and evaluate data of a geographical nature (characteristics such as customer, sales region, and country, for example). The geo-relevant data is displayed graphically on a map. Using enhanced navigation options (“geographical drilldown”), regional information can Web API Reference BW 3.5 57 SAP Online Help 25.02.2005 be evaluated more easily at different levels of detail. A map shows the spatial proximity of places and regions, allowing geographical connections to be more clearly represented. Process Flow The following graphic illustrates the geographic evaluation of data run by the system: Business Explorer Browser Browser An Analyzer alyzer Map MapData Data Grid GridData Data API BW Server OL AP PProcessor rocessor OLAP Administrator Workbench Meta Meta Data Repository Repository GIS InfoObject InfoCubes InfoCubes Master Data Data Geo Coordinates SStaging taging Engin e Engine BAPI Geo Coding ... 1. In the InfoObject maintenance, flag the geo-relevant characteristics (country, for example) that you want to use as geo-characteristics. 2. You load the corresponding shapefiles [Extern] into the BW system. You maintain the assignment of shape file and master data (mapping between geo-characteristic and shape file). See SAPBWKEY Maintenance for Static Geo-Characteristics [Extern] If you want to use the maps to report on geo-characteristics that show information in point form (customer, plant, sales office, for example) you have to geocode these characteristics. See Geocoding [Extern]. 3. In the BEx Web Application Designer you include a map in your Web application and connect these with a data source and a previously-defined query. By using these attributes, you determine the map display and the business-oriented data. Finally, you publish the application on the Web. You navigate in the map to report further on the geo-relevant data. See also: Additional Cartographic Information [Extern] Displaying Additional Cartographic Information [Extern] Web API Reference BW 3.5 58 SAP Online Help 25.02.2005 Map Attributes Definition The Map Web item consists of the objects Map and Map Layer. They are used to display business data geographically. Use You use the Map object to define a map’s basic display. The Map Layer object is used to define the different map layers. Map layers are components, with which you construct a map. Attributes control how a map and its layers are displayed in the Web application. You can find information about layer attributes under Attributes for Map Layers [Seite 63]. The following section describes the attributes for the Map object. Structure The Map object has two kinds of attributes, as do all Web items: ... 1. General attributes that are fundamental to all display types. The general attributes for the Map object are the same as the general attributes [Seite 12] for all Web items. The Map object has a few additional general attributes. In the Web Application Designer, you can find the general attributes in the Properties window, on the Web Item → General tab page. 2. Special attributes which are particular to the individual Web item. In the Web Application Designer, you can find the special attributes in the Properties window, on the Web Item → Special tab page. General Attributes Attribute Values Description Caption (CAPTION) Title of the map Generate caption • ‘X’ = Yes (GENERATE_CAPTION) • ‘ ’ = No Default setting ‘X’ = Yes Width Entry in pixels (WIDTH) Default setting “300” Height of map in pixels Entry in pixels (HEIGHT) Default setting “300” Calculate map height automatically (IGNORE_HEIGHT) Web API Reference • ‘X’ = Yes • ‘ ’ = No Default setting ‘X’ = Yes BW 3.5 Setting the indicator automatically generates a title for the map in accordance with "SAPBEXTableCaption". Width of the map and legend in pixels Height of the map in pixels taking geographical relation into consideration Ignores the height set manually (map height attribute) and calculates the height automatically using the 59 SAP Online Help 25.02.2005 height/width relationship in the underlying map. Border style (BORDER_STYLE) • With border • Without border • For form Type of border drawn around object. Default setting “No borders” Closed • ‘X’ = Yes (CLOSED) • ‘ ’ = No If you set this indicator, the map is collapsed when the Web application is opened. Default setting ‘ ’ = No Hide object • ‘X’ = Yes (HIDDEN) • ‘ ’ = No Default setting ‘ ’ = No Objects with navigation links • ‘X’ = Yes (GENERATE_LINKS) • ‘ ’ = No Default setting ‘X’ = Yes If the indicator is set, neither the map nor the title is displayed in the Web application. When the indicator is set, an image map is generated for the map which enables navigation within it. At the same time, the corresponding attributes of all the levels belonging to the map are also set to ‘X’ = Yes. Special Attributes Attribute Values Description Map layers This attribute defines the layers and the number of layers on which your map is structured. See Attributes for Map Levels [Seite 63]. (LAYERS) AXL file (cartography) Name of AXL file for cartography description (stored in directory for shape files) (CART_AXL_NAME) Cartography information on/off • ‘X’ = Yes (CART_AXL_VISIBLE) • ‘ ’ = No Default setting ‘ ’ = No Geo-functions • Do not display (GEO_FUNCTIONS_POS) • Top • Bottom • Left • Right With this attribute you can specify whether additional cartography information, which you described in an AXL file, needs to be displayed. See… Position of the geographic function bar in relation to the map. Default setting: "Do not display" Web API Reference BW 3.5 60 SAP Online Help 25.02.2005 Advanced geo-function bar • ‘X’ = Yes (GEO_FUNCTIONS_ADVANCED) • ‘ ’ = No Enhancement of the geo-function bar for executing interactive functions on the map itself. Default setting ‘ ’ = No The advanced geofunction bar is supported by Web browsers from Microsoft Internet Explorer 5.0 and Netscape 6.2 and higher You determine the position of the advanced geo-function bar using the Geo-functions (GEO_FUNCTIONS_POS) attribute. If you do not select the Advanced Geo-function Bar (GEO_FUNCTIONS_ADVANCED) attribute, the basic geo-function bar is displayed for the Geofunctions (GEO_FUNCTIONS_POS) attribute, corresponding to the value you selected. See also: Functions of the Advanced GeoFunction Bar [Extern] Position of legend • Left of the map (LEGEND_POSITION) • Right of the map • No legend Position of the legend in relation to the map. Default setting "Right of the map" Size of legend Entry in pixels (LEGEND_SIZE) Default setting “150” Extent of the map • Data with geography • Data only • Data and complete geography available (MAP_EXTENT) Default setting: “Data with geography” Map background transparent Web API Reference • ‘X’ = Yes BW 3.5 Size of the legend in pixels Specifies which areas of a map are displayed in the Web application. This depends on the data stored in the application. “Data with geography”, the default setting, allows you to display data taking the corresponding geographic context into account. If you set this indicator, the "Map 61 SAP Online Help (CART_COLOR_TRANSPARENT) Background color 25.02.2005 Default setting ‘X’ = Yes background color" attribute is ignored and the background appears as transparent in the Web application. Color value Background color of the map. • ‘ ’ = No (CART_BACKGROUND_COLOR) Fill color (no data) You select the color values in a color selection dialog. Color value (CART_FILL_COLOR) Fill color of a region if it is not stored with data. You select the color values in a color selection dialog. Map outline color Color value (CART_OUTLINE_COLOR) Color of the map outline. You select the color values in a color selection dialog. Map outline width Entry in pixels (CART_OUTLINE_WIDTH) Default setting “1” Projection No projection = ‚NONE’ (PROJECTION) Flat projection = ‚FLAT’ Width of the map outline in pixels. Projection used in map Mercator projection = ‘MERC’ You can find more information on using the Map Web item and its functions under Navigating in Maps [Extern]. Web API Reference BW 3.5 62 SAP Online Help 25.02.2005 Attributes for Map Layers Definition Objects that define the different layers in a map. Use The layers of a map contain different geographic and business information. The individual layers are laid over one another in the Web application and, in this way, make up the overall view of the map. You can show or hide individual layers and change the information contained in a map. For each map layer, you must define how the data is displayed in this layer. Do this by selecting a Map Renderer [Seite 88]. Structure The Map Layer object has two kinds of attributes, as do all other Web items: ... 1. General attributes that are fundamental to all display types. The general attributes for the Map Layer object are the same as the general attributes for all Web items. In the Web Application Designer, you can find the general attributes in the Properties window, on the Web item → General tab page. See General Attributes [Seite 12] 2. Special attributes that vary according to the selected map renderer. Special attributes appear in the Web Application Designer depending on the map renderer, in the Web item → Special tabpage. You can select the map renderer from the selection list of the Renderer for a Map on the Web Item → Special tabpage. You can find additional information about the special attributes for the individual map renderer under Special Attributes for Color Shading [Seite 65] Special Attributes for Bar Charts [Seite 67] Special Attributes for Pie Charts [Seite 69] Special Attributes for Pie Charts (split) [Seite 71] Special Attributes for Dot Densities [Seite 72] Special Attributes for Symbol [Seite 74] Special Attributes for Symbol (Size-dependent) [Seite 76] Special Attributes for Symbol (Color-dependent) [Seite 78] Special Attributes for Line [Seite 80] Special Attributes for Line (Size-dependent) [Seite 82] Special Attributes for Lines (Color-dependent) [Seite 84] Web API Reference BW 3.5 63 SAP Online Help Web API Reference 25.02.2005 BW 3.5 64 SAP Online Help 25.02.2005 Special Attributes for Color Shading Definition A map renderer with which you determine how BW data is displayed on a map layer. Use The color shading map renderer allows you to display color classes that correspond to special value classes. Structure Attribute Values Description Number of classes Number of color levels (variable “n”) (CLASSES) Initial color Color value Defines the color of the symbol that represents the smallest data value in the connected data source. (COLOR_START) You select the color values in a color selection dialog. End color Color value Defines the color of the symbol that represents the largest data value in the connected data source. (COLOR_END) You select the color values in a color selection dialog. Individual values List Individual values entry for color and class boundaries. Color interpolation RGB (Color value) (COLOR_INTERPOLATION) HSB (color area) You can determine the color interpolation method here. Colors between the start and the end color are interpolated linearly. Color (if no data) Color value (CS_DYN) Defines a color value for filling all the regions of a map that do not have data in the connected data source. (COLOR_NONE) You select the color values in a color selection dialog. Tooltip for map layer ‘X’ = Yes, ‘ ’ = No (GENERATE_TOOLTIP) Default setting: ‘X’ = Yes Generate class boundaries ‘X’ = Yes, ‘ ’ = No (GENERATE_BREAKS) Default setting: ‘ ‘ = No Web API Reference BW 3.5 This attribute allows you to display tooltips for the map layer. This attribute enables better automatic distribution of the color shading. 65 SAP Online Help 25.02.2005 Map Layer Label “No Label” (LABEL) “Text as Label” This attribute allows you to label the map. “Key as Label” Default setting: “No Label” Highlight label ‘X’ = Yes, ‘ ’ = No Highlight map layer label List List of data providers to which all commands of the map layer are sent. “Normal context menu with click on map” How the map interaction appears. You can use this attribute to determine which action is to take place when you click on the map, as an alternative to the context menu. (HIGHLIGHT_LABEL) Affected data provider (TARGET_DATA_PROVIDER ) Map interaction control (IMAGEMAP_PATTERN) “Filtering for data providers with click on map” You can find additional information about this attribute in the WEB API Reference, section Web Item → Map → Map Layer. Ignore exceptions when displaying the map level ‘X’ = Yes, ‘ ’ = No (IGNORE_EXCEPTIONS) Exceptions that are activated with the basic data provider are not displayed in the map level. See Display of Exceptions for Maps and Charts [Extern]. Attribute to be displayed in the map Name of the characteristic attribute, the value of which is to be displayed on the map. (ATTRINM) Web API Reference BW 3.5 66 SAP Online Help 25.02.2005 Special Attributes for Bar Charts Definition A map renderer with which you determine how BW data is displayed on a map layer. Use You can display values in the form of bars with the bar chart map renderer. Structure Attribute Values Description Bar height Entry in pixels (BAR_HEIGHT) Default value: “30” Defines the maximum height of a bar in the diagram. This height corresponds to the largest value of the connected data source. Bar width Entry in pixels (BAR_WIDTH) Default value: “10” Individual color values Defines the width of the bar in the diagram. Entry for individual color values (COLOR_VALUE) Tooltip for map layer ‘X’ = Yes, ‘ ’ = No (GENERATE_TOOLTIP) Default setting: ‘X’ = Yes Generate class boundaries ‘X’ = Yes, ‘ ’ = No (GENERATE_BREAKS) Default setting: ‘ ‘ = No Map Layer Label “No Label” (LABEL) “Text as Label” This attribute allows you to display tooltips for the map layer. This attribute enables better automatic distribution of the color shading. This attribute allows you to label the map. “Key as Label” Default setting: “No Label” Highlight label ‘X’ = Yes, ‘ ’ = No Highlight map layer label List List of data providers to which all commands of the map layer are sent. “Normal context menu with click on map” How the map interaction appears. You can use this attribute to determine which action is to take place when you click on the map, as an alternative to the context (HIGHLIGHT_LABEL) Affected data provider (TARGET_DATA_PROVIDER ) Map interaction control (IMAGEMAP_PATTERN) “Filtering for data providers with click on map” Web API Reference BW 3.5 67 SAP Online Help 25.02.2005 menu. You can find additional information about this attribute in the WEB API Reference, section Web Item → Map → Map Layer. Ignore exceptions when displaying the map level ‘X’ = Yes, ‘ ’ = No (IGNORE_EXCEPTIONS) Exceptions that are activated with the basic data provider are not displayed in the map level. See Display of Exceptions for Maps and Charts [Extern]. Attribute to be displayed in the map Name of the characteristic attribute, the value of which is to be displayed on the map. (ATTRINM) Web API Reference BW 3.5 68 SAP Online Help 25.02.2005 Special Attributes for Pie Charts Definition A map renderer with which you determine how BW data is displayed on a map layer. Use You can display values in the form of pie charts with the pie chart renderer. Structure Attribute Values Description Individual color values Entry for individual color values (COLOR_VALUE) Pie diameter (maximum) Entry in pixels (PIE_MAX) Defines the largest diameter of a circle in the diagram. This diameter is the sum of all the maximum values displayed in the Web application. If you set "circle diameter (minimum) = circle diameter (maximum)“, all the circles in the Web application are displayed with the same diameter. Pie diameter (minimum) Entry in pixels (PIE_MIN) Defines the smallest diameter of a circle in the diagram. This diameter is the sum of all the minimum values displayed in the Web application. If you set "circle diameter (minimum) = circle diameter (maximum)“, all the circles in the Web application are displayed with the same diameter. Tooltip for map layer ‘X’ = Yes, ‘ ’ = No (GENERATE_TOOLTIP) Default setting: ‘X’ = Yes Generate class boundaries ‘X’ = Yes, ‘ ’ = No (GENERATE_BREAKS) Default setting: ‘ ‘ = No Map Layer Label “No Label” (LABEL) “Text as Label” This attribute allows you to display tooltips for the map layer. This attribute enables better automatic distribution of the color shading. This attribute allows you to label the map. “Key as Label” Default setting: “No Label” Web API Reference BW 3.5 69 SAP Online Help Highlight label 25.02.2005 ‘X’ = Yes, ‘ ’ = No Highlight map layer label List List of data providers to which all commands of the map layer are sent. “Normal context menu with click on map” How the map interaction appears. You can use this attribute to determine which action is to take place when you click on the map, as an alternative to the context menu. (HIGHLIGHT_LABEL) Affected data provider (TARGET_DATA_PROVIDER ) Map interaction control (IMAGEMAP_PATTERN) “Filtering for data providers with click on map” You can find additional information about this attribute in the WEB API Reference, section Web Item → Map → Map Layer. Ignore exceptions when displaying the map level ‘X’ = Yes, ‘ ’ = No (IGNORE_EXCEPTIONS) Exceptions that are activated with the basic data provider are not displayed in the map level. See Display of Exceptions for Maps and Charts [Extern]. Attribute to be displayed in the map Name of the characteristic attribute, the value of which is to be displayed on the map. (ATTRINM) Web API Reference BW 3.5 70 SAP Online Help 25.02.2005 Special Attributes for Pie Charts (split) Definition A map renderer, with which you determine how BW data is displayed in a map layer. Use You can use the split pie chart renderer to display values in the form of split pie charts. In a split pie chart, the split occurs automatically if there is a "change of group" (that is from sales for the 1st quarter of 2001 to the sales for the 2nd quarter of 2001). Structure The special attributes of the split pie chart renderer are identical with the special attributes of the pie chart renderer. See Special Attributes for the Pie Chart Renderer [Seite 69]. Web API Reference BW 3.5 71 SAP Online Help 25.02.2005 Special Attributes for Dot Density Definition A map renderer with which you determine how BW data is displayed on a map layer. Use You can use the dot density renderer to display values in a map using dot densities. Structure Attribute Values Description Dot base value Describes the basis value for a dot (symbol). Example: When choosing the value 1000 for the BASE_VALUE (“BASE_VALUE = 1000”), and the data value for France, say, is 7400, the system produces the result 7400/1000= 7.4 (rounded to 7). 7 dots appear in the France map area, and these dots are distributed randomly. (BASE_VALUE) Color (COLOR) Color value Dot color (symbols) The color value is selected via a color selection dialog box. Maximum density, per cent Input in percent (DENSITY) Defines how dense the points should be displayed in a region for the largest value of the connected data source. The attributes "Value for a symbol" and "Maximum density in %" are selfexclusive and may not be used at the same time. Size/Width Entry in pixels Defines the size of the points (symbols). Symbol type “Circle” (STYLE) “Rectangle” Defines the symbol with which the data is displayed in a layer. (SIZE) “Triangle” “Cross” Tooltip for map layer ‘X’ = Yes, ‘ ’ = No (GENERATE_TOOLTIP) Default setting: ‘X’ = Yes Generate class boundaries ‘X’ = Yes, ‘ ’ = No Web API Reference BW 3.5 This attribute allows you to display tooltips for the map layer. This attribute enables better 72 SAP Online Help 25.02.2005 (GENERATE_BREAKS) Default setting: ‘ ‘ = No automatic distribution of the color shading. Map Layer Label “No Label” (LABEL) “Text as Label” This attribute allows you to label the map. “Key as Label” Default setting: “No Label” Highlight label ‘X’ = Yes, ‘ ’ = No Highlight map layer label List List of data providers to which all commands of the map layer are sent. “Normal context menu with click on map” How the map interaction appears. You can use this attribute to determine which action is to take place when you click on the map, as an alternative to the context menu. (HIGHLIGHT_LABEL) Affected data provider (TARGET_DATA_PROVIDER ) Map interaction control (IMAGEMAP_PATTERN) “Filtering for data providers with click on map” You can find additional information about this attribute in the WEB API Reference, section Web Item → Map → Map Layer. Ignore exceptions when displaying the map level ‘X’ = Yes, ‘ ’ = No (IGNORE_EXCEPTIONS) Exceptions that are activated with the basic data provider are not displayed in the map level. See Display of Exceptions for Maps and Charts [Extern]. Attribute to be displayed in the map Name of the characteristic attribute, the value of which is to be displayed on the map. (ATTRINM) Web API Reference BW 3.5 73 SAP Online Help 25.02.2005 Special Attributes for Symbols Definition A map renderer with which you determine how BW data is displayed on a map layer. Use You can display values using symbols with the Symbol renderer. Structure Attribute Values Description Color Color value Symbol color as RGB value (VALUE) Size/Width You select the color values in a color selection dialog. Entry in pixels Defines the size of the symbols that represent the data. Symbol type Circle (STYLE) Rectangle Defines the symbol with which the data is displayed in a layer. (SIZE) Triangle Cross Tooltip for map layer ‘X’ = Yes, ‘ ’ = No (GENERATE_TOOLTIP) Default setting: ‘X’ = Yes Generate class boundaries ‘X’ = Yes, ‘ ’ = No (GENERATE_BREAKS) Default setting: ‘ ‘ = No Map Layer Label “No Label” (LABEL) “Text as Label” This attribute allows you to display tooltips for the map layer. This attribute enables better automatic distribution of the color shading. This attribute allows you to label the map. “Key as Label” Default setting: “No Label” Highlight label ‘X’ = Yes, ‘ ’ = No Highlight map layer label List List of data providers to which all commands of the map layer are sent. “Normal context menu with click on map” How the map interaction appears. You can use this attribute to determine which (HIGHLIGHT_LABEL) Affected data provider (TARGET_DATA_PROVIDER ) Map interaction control (IMAGEMAP_PATTERN) Web API Reference BW 3.5 74 SAP Online Help 25.02.2005 “Filtering for data providers with click on map” action is to take place when you click on the map, as an alternative to the context menu. You can find additional information about this attribute in the WEB API Reference, section Web Item → Map → Map Layer. Ignore exceptions when displaying the map level ‘X’ = Yes, ‘ ’ = No (IGNORE_EXCEPTIONS) Exceptions that are activated with the basic data provider are not displayed in the map level. See Display of Exceptions for Maps and Charts [Extern]. Attribute to be displayed in the map Name of the characteristic attribute, the value of which is to be displayed on the map. (ATTRINM) Web API Reference BW 3.5 75 SAP Online Help 25.02.2005 Special Attributes for Symbol (Size-dependent) Definition A map renderer with which you determine how BW data is displayed on a map layer. Use You can use the symbol (size-dependent) renderer to display values using size-dependent symbols. The renderer takes the location and data values for this location into consideration. The size of the symbols depends on the data. Structure Attribute Values Description Number of classes Number of size levels (variable “n”) (CLASSES) Color Color value Symbol color (COLOR) Individual values You select the color values in a color selection dialog. List Individual values entry for symbol sizes and class boundaries. Entry in pixels Defines the symbol size / line width that represents the largest data value in the connected data source. Entry in pixels Defines the symbol size / line width that represents the smallest data value in the connected data source. Symbol type “Circle” (Style) “Rectangle” Defines the symbol with which the data is displayed in a layer. (SG_SYM_DYN) Symbol (end size)/ Line (end width) (SIZE_END) Symbol (starting size) / Line (starting width) (SIZE_START) “Triangle” “Cross” Tooltip for map layer ‘X’ = Yes, ‘ ’ = No (GENERATE_TOOLTIP) Default setting: ‘X’ = Yes Generate class boundaries ‘X’ = Yes, ‘ ’ = No (GENERATE_BREAKS) Default setting: ‘ ‘ = No Map Layer Label “No Label” Web API Reference This attribute allows you to display tooltips for the map layer. This attribute enables better automatic distribution of the color shading. This attribute allows you to BW 3.5 76 SAP Online Help (LABEL) 25.02.2005 “Text as Label” label the map. “Key as Label” Default setting: “No Label” Highlight label ‘X’ = Yes, ‘ ’ = No Highlight map layer label List List of data providers to which all commands of the map layer are sent. “Normal context menu with click on map” How the map interaction appears. You can use this attribute to determine which action is to take place when you click on the map, as an alternative to the context menu. (HIGHLIGHT_LABEL) Affected data provider (TARGET_DATA_PROVIDER ) Map interaction control (IMAGEMAP_PATTERN) “Filtering for data providers with click on map” You can find additional information about this attribute in the WEB API Reference, section Web Item → Map → Map Layer. Ignore exceptions when displaying the map level ‘X’ = Yes, ‘ ’ = No (IGNORE_EXCEPTIONS) Exceptions that are activated with the basic data provider are not displayed in the map level. See Display of Exceptions for Maps and Charts [Extern]. Attribute to be displayed in the map Name of the characteristic attribute, the value of which is to be displayed on the map. (ATTRINM) Web API Reference BW 3.5 77 SAP Online Help 25.02.2005 Special Attributes for Symbol (Color-dependent) Definition A map renderer with which you determine how BW data is displayed on a map layer. Use You can display values using color-dependent symbols with the Symbol (color-dependent) renderer. The renderer takes the location and data values for this location into consideration. The color of the symbols depends on the data. Structure Attribute Values Description Individual values Individual values entry for color values and class boundaries. (CG_SYM_DYN) Number of classes Number of color levels (variable “n”) (CLASSES) End color Color value Defines the color of the symbol that represents the largest data value in the connected data source. (COLOR_END) You select the color values in a color selection dialog. Color interpolation RGB Color interpolation method (COLOR_INTERPOLATION) HSB Defines the method with which the color values that are located between the starting and end colors are interpolated. These color values represent the data that is located between the smallest and largest values of the data source. Initial color Color value Defines the color of the symbol that represents the smallest data value in the connected data source. (COLOR_START) You select the color values in a color selection dialog. Size/Width Entry in pixels Defines the size of the symbols that represent the data. Symbol type Circle (STYLE) Rectangle Describes how a symbol is displayed. (SIZE) Web API Reference BW 3.5 78 SAP Online Help 25.02.2005 Triangle Cross Tooltip for map layer ‘X’ = Yes, ‘ ’ = No (GENERATE_TOOLTIP) Default setting: ‘X’ = Yes Generate class boundaries ‘X’ = Yes, ‘ ’ = No (GENERATE_BREAKS) Default setting: ‘ ‘ = No Map Layer Label “No Label” (LABEL) “Text as Label” This attribute allows you to display tooltips for the map layer. This attribute enables better automatic distribution of the color shading. This attribute allows you to label the map. “Key as Label” Default setting: “No Label” Highlight label ‘X’ = Yes, ‘ ’ = No Highlight map layer label List List of data providers to which all commands of the map layer are sent. “Normal context menu with click on map” How the map interaction appears. You can use this attribute to determine which action is to take place when you click on the map, as an alternative to the context menu. (HIGHLIGHT_LABEL) Affected data provider (TARGET_DATA_PROVIDER ) Map interaction control (IMAGEMAP_PATTERN) “Filtering for data providers with click on map” You can find additional information about this attribute in the WEB API Reference, section Web Item → Map → Map Layer. Ignore exceptions when displaying the map level ‘X’ = Yes, ‘ ’ = No (IGNORE_EXCEPTIONS) Exceptions that are activated with the basic data provider are not displayed in the map level. See Display of Exceptions for Maps and Charts [Extern]. Attribute to be displayed in the map Name of the characteristic attribute, the value of which is to be displayed on the map. (ATTRINM) Web API Reference BW 3.5 79 SAP Online Help 25.02.2005 Special Attribute: Line Definition A map renderer with which you determine how BW data is displayed on a map layer. Use The Line renderer displays values with a line going from a starting to an end point. Structure Attribute Values Description Color Color value Line color. (COLOR) You select the color values in a color selection dialog. Layer (starting points) Layer for starting points (FROM_LAYER) Defines the layer on which the line’s starting points lie. All starting points must be located on one layer. Line type “Continuous” (LINE_STYLE) “Dotted” Defines how the lines are displayed. “Dashed” Size/Width Entry in pixels Defines the width of the line. (SIZE) Layer (end points) Layer for end points (TO_LAYER) Defines the layer on which the end points of the lines are located. All end points must be located on one layer. Tooltip for map layer ‘X’ = Yes, ‘ ’ = No (GENERATE_TOOLTIP) Default setting: ‘X’ = Yes Generate class boundaries (GENERATE_BREAKS) ‘X’ = Yes, ‘ ’ = No Default setting: ‘ ‘ = No This attribute enables better automatic distribution of the color shading. Map Layer Label “No Label” (LABEL) “Text as Label” This attribute allows you to label the map. Web API Reference BW 3.5 This attribute allows you to display tooltips for the map layer. 80 SAP Online Help 25.02.2005 “Key as Label” Default setting: “No Label” Highlight label ‘X’ = Yes, ‘ ’ = No Highlight map layer label List List of data providers to which all commands of the map layer are sent. “Normal context menu with click on map” How the map interaction appears. You can use this attribute to determine which action is to take place when you click on the map, as an alternative to the context menu. (HIGHLIGHT_LABEL) Affected data provider (TARGET_DATA_PROVIDER ) Map interaction control (IMAGEMAP_PATTERN) “Filtering for data providers with click on map” You can find additional information about this attribute in the WEB API Reference, section Web Item → Map → Map Layer. Ignore exceptions when displaying the map level ‘X’ = Yes, ‘ ’ = No (IGNORE_EXCEPTIONS) Exceptions that are activated with the basic data provider are not displayed in the map level. See Display of Exceptions for Maps and Charts [Extern]. Attribute to be displayed in the map Name of the characteristic attribute, the value of which is to be displayed on the map. (ATTRINM) Web API Reference BW 3.5 81 SAP Online Help 25.02.2005 Special Attribute: Line (Size-dependent) Definition A map renderer with which you determine how BW data is displayed on a map layer. Use You can use the bar chart map renderer to display values in the form of bars. Structure Attribute Values Description Number of classes Number of size levels (variable “n”) (CLASSES) Color Color value Line color. (COLOR) You select the color values in a color selection dialog. Line type “Continuous” (LINE_STYLE) “Dotted” Defines how the lines are displayed. “Dashed” Individual values Entry of individual values for line width and class boundary. (SG_LI_DYN) Symbol (end width) / line (end width) Symbol/line end width (SIZE_END) Symbol (start width) / line (start width) Symbol/Line start width Layer (starting points) Layer for starting points (FROM_LAYER) Layer (end points) Layer for end points (TO_LAYER) Tooltip for map layer ‘X’ = Yes, ‘ ’ = No (GENERATE_TOOLTIP) Default setting: ‘X’ = Yes Generate class boundaries ‘X’ = Yes, ‘ ’ = No (GENERATE_BREAKS) Default setting: ‘ ‘ = No Map Layer Label “No Label” (LABEL) “Text as Label” This attribute allows you to display tooltips for the map layer. This attribute enables better automatic distribution of the color shading. This attribute allows you to label the map. “Key as Label” Web API Reference BW 3.5 82 SAP Online Help 25.02.2005 Default setting: “No Label” Highlight label ‘X’ = Yes, ‘ ’ = No-{}- Highlight map layer label List List of data providers to which all commands of the map layer are sent. “Normal context menu with click on map” How the map interaction appears. You can use this attribute to determine which action is to take place when you click on the map, as an alternative to the context menu. (HIGHLIGHT_LABEL) Affected data provider (TARGET_DATA_PROVIDER ) Map interaction control (IMAGEMAP_PATTERN) “Filtering for data providers with click on map” You can find additional information about this attribute in the WEB API Reference, section Web Item → Map → Map Layer. Ignore exceptions when displaying the map level- ‘X’ = Yes, ‘ ’ = No (IGNORE_EXCEPTIONS) Exceptions that are activated with the basic data provider are not displayed in the map level. See Display of Exceptions for Maps and Charts [Extern]. Attribute to be displayed in the map Name of the characteristic attribute, the value of which is to be displayed on the map. (ATTRINM) Web API Reference BW 3.5 83 SAP Online Help 25.02.2005 Special Attributes for Lines (Color-dependent) Definition A map renderer with which you determine how BW data is displayed on a map layer. Use The line (color-dependent) renderer displays values with a line from the starting to the end point. The data values define the color of a line. Structure Attribute Values Description Individual values Individual values entry for color values and class boundaries. (CG_LI_DYN) Number of classes Number of color levels (variable “n”) (CLASSES) End color Color value Defines the color of the symbol that represents the largest data value in the connected data source. (COLOR_END) You select the color values in a color selection dialog. Color interpolation RGB Defines the method with which the color values that are located between the starting and end colors are interpolated. These color values represent the data that is located between the smallest and largest values of the data source. HSB Initial color Color value Defines the color of the symbol that represents the smallest data value in the connected data source. (COLOR_START) You select the color values in a color selection dialog. Line type “Continuous” (LINE_STYLE) “Dotted” Defines how the lines are displayed. “Dashed” Size/Width Entry in pixels Defines the width of the line. (SIZE) Layer (starting points) Web API Reference Layer for starting points BW 3.5 84 SAP Online Help 25.02.2005 (FROM_LAYER) Layer (end points) Layer for end points (TO_LAYER) Tooltip for map layer ‘X’ = Yes, ‘ ’ = No (GENERATE_TOOLTIP) Default setting: ‘X’ = Yes Generate class boundaries ‘X’ = Yes, ‘ ’ = No (GENERATE_BREAKS) Default setting: ‘ ‘ = No Map Layer Label “No Label” (LABEL) “Text as Label” This attribute allows you to display tooltips for the map layer. This attribute enables better automatic distribution of the color shading. This attribute allows you to label the map. “Key as Label” Default setting: “No Label” Highlight label ‘X’ = Yes, ‘ ’ = No Highlight map layer label List List of data providers to which all commands of the map layer are sent. “Normal context menu with click on map” How the map interaction appears. You can use this attribute to determine which action is to take place when you click on the map, as an alternative to the context menu. (HIGHLIGHT_LABEL) Affected data provider (TARGET_DATA_PROVIDER ) Map interaction control (IMAGEMAP_PATTERN) “Filtering for data providers with click on map” You can find additional information about this attribute in the WEB API Reference, section Web Item → Map → Map Layer. Ignore exceptions when displaying the map level ‘X’ = Yes, ‘ ’ = No (IGNORE_EXCEPTIONS) Exceptions that are activated with the basic data provider are not displayed in the map level. See Display of Exceptions for Maps and Charts [Extern]. Attribute to be displayed in the map Name of the characteristic attribute, the value of which is to be displayed on the map. (ATTRINM) Web API Reference BW 3.5 85 SAP Online Help 25.02.2005 Array Attributes Use There are certain map attributes that are known as array attributes. You can recognize these attributes by the suffix “(n)” (see Attributes for Maps [Seite 59] andAttributes for Map Layers [Seite 63]). This section describes the function of array attributes. The following are array attributes: • Symbol size (n) • Class boundary (n) • Color value (n) • Line width (n) • Bar Color (n) • Segment color (n) The variable n is the number of classes. You can set this variable with the attribute class number Example Use the above attributes to change the default settings in the system. The default settings provide a linear calculation of the interim values for each class. For example: symbol size (n) If the attribute symbol size (n) is not set, the size of the symbols displayed in a map, starting with starting value A and ending with end value B, are distributed linearly across the number of classes. If you have for example 4 classes, a starting size of 8 and an end size of 20 points, you would get the following values for the individual class sizes: • Class 1 -8 points • Class 2 -12 points • Class 3 -16 points • Class 4 -20 points You can adjust this automatic assignment by manually setting the values for the attribute symbol size (n), for example, in the following way: • Class 1 -8 points • Class 2 -10 points • Class 3 -12 points • Class 4 -20 points Web API Reference BW 3.5 86 SAP Online Help 25.02.2005 The attributes symbol size (n), color value (n) and line width (n) are always bound to the attribute class boundary (n). That is, when you set one of these attributes, you also need to set a value for the corresponding class boundary. Web API Reference BW 3.5 87 SAP Online Help 25.02.2005 Map Renderer Definition With a map renderer, you determine how BW data is displayed on a map layer. Structure There are 11 different map renderers in the BEx Web Application Designer. These renderers are divided into three different classes: Class 1: Renderers that relate to polygonal areas (static geo-characteristics). They display the following: • Color shading (COLORSHADING or CS) • Bar charts (BAR) • Pie charts (PIE) • Pie charts (divided) (SPLITPIE) • Pixel density (DOTDENSITY or D_DENSITY) For these renderers, the static geo-characteristic must appear in the related data provider in the rows and the values to be displayed in the renderer must be in the columns. You can use hierarchies in both cases. You cannot have any other characteristic other than the geocharacteristic, or any key figure in the rows. You can use several characteristics or key figures in the columns. Class 2: Renderers that relate to locations (dynamic geo-characteristics). They display the following: • Symbol (SYMBOL) • Symbol (size-dependent) (SIZEGRADUATEDSYMBOL or SG_SYMBOL) • Symbol (color-dependent) (COLORGRADUATEDSYMBOL or CG_SYMBOL) • Bar charts (BAR) • Pie charts (PIE) • Pie charts (divided) (SPLITPIE) For these renderers the dynamic geo-characteristic must appear in the data provider belonging to it in the rows. You must have also selected the Longitude and Latitude display attributes to be displayed. You cannot have any other characteristics or key figures in the rows. Only the first column is considered by the symbol renderers. The renderers bar chart, pie chart and pie chart (divided) consider all columns. Class 3: Renderers that display relationships between locations (dynamic geo-characteristics): • Line (LINE) • Line (size-dependent) (SIZEGRADUATEDLINE or SG_LINE) • Line (color-dependent) (COLORGRADUATEDLINE or CG_LINE) It is important to have at least three map layers for these renderers. You define Start Point in one map layer and the End Point in another map layer. The prerequisites described in class 2 are also valid for both of these map layers. The third map layer contains the relationship between the dynamic geo-characteristics Start Point and End Point, that is, Web API Reference BW 3.5 88 SAP Online Help 25.02.2005 both characteristics must be in the rows. The same prerequisites are valid for the columns as described in class 2. For those map renderers that have a long technical name, you can specify a shorter, alternative name (for example, COLORGRADUATEDLINE or CG_LINE). Both variations are supported. Integration So that you can present the BW business data on individual map layers graphically, you have to assign a map renderer to each map layer in the BEx Web Application Designer and determine the properties for this renderer. Example of a Renderer in Class 3 Map layer query view that describes the relationship Sales Office Sales Representative Sales A 1 100 $ A 2 150 $ A 3 120 $ B 11 90 $ B 12 80 $ Map layer query view that describes the start point Sales Office Longitude Latitude # Employees A 2.3 3.4 120 A 2.3 3.4 15 A 2.3 3.4 120 B -3.5 -2.0 87 B -3.5 -2.0 80 Map layer query view that describes the end point Sales Longitude Latitude # Customers 1 2.8 4.7 12 2 2.6 5.7 11 3 2.4 6.7 13 11 -3.8 -1.2 23 12 -3.4 -1.8 21 Representative Web API Reference BW 3.5 89 SAP Online Help Web API Reference 25.02.2005 BW 3.5 90 SAP Online Help 25.02.2005 Single Document Definition Web item allowing you to display single documents that you created in the Administrator Workbench or in master data maintenance for master data in the Web application. Use You can create the documents in different formats and versions (see Documents [Extern]). You can add several documents such as route directions and a picture of the local office for each value of a characteristic, such as Business Partner. You can use the document type attribute to decide which document you want to display in the Web application. Structure As well as its general attributes [Seite 12], the Web item specific attributes: Single Document has the following Attributes Description Document class (DOCUMENT CLASS) Document class for which documents are displayed (master data or InfoProvider data). ‘MAST’ = master data (default setting) ‘TRAN’ = InfoProvider data Web API Reference BW 3.5 • If you choose ‘MAST’ = master data, you have to specify a characteristic. The documents for the values of this characteristic are then displayed in the Web item. • If you choose ‘TRAN’ = InfoProvider data, the document that is relevant for the current navigational state is displayed in the Web item. This is worthwhile, for example, if you have created a document (a report on the business area) for all combinations of month and business area and both of these characteristics are contained in the filter. The document is then always displayed in the Web item for the selected business area and month. 91 SAP Online Help Document type (WWW_DOC_TYPE) 25.02.2005 You can specify a type of document here. Only documents of this type are then displayed. You can display several documents for the values of a characteristic at the same time in a Web application. For example, for the characteristic Customer, you can display a logo (in a Web item of the document type LOGO)and a sketch with directions (in a Web item of the document type MAP If you create a new document or change an existing document, you can maintain the document type for this document. The various document types for the existing document are offered for you to choose from in the Web item. If you do not make any entries here, the system assumes that only one document is suitable for the Web item. If this is not the case you get a message Characteristic (IOBJNM) − That no document was found or − That the document is not unique (there is more than one) Characteristic for which master data documents are displayed You need to select a characteristic in this attribute when you have chosen in the attribute Document Class (DOCUMENT_CLASS) the entry ‘MAST’ = master data: Web API Reference BW 3.5 92 SAP Online Help Display frame (TARGET_FRAME) 25.02.2005 HTML frame for displaying the document (IFrames are possible). If you are working with frames in your Web application (including internal frames, or IFrames), you can divert the document output into a different frame instead of displaying it in the Web item itself. This is useful for documents that you cannot display in the Web item itself, such as Microsoft Word and PDF documents, but which you want to display immediately. We recommend that you do not create a title for the Single Document Web item if you want to display the document in a different frame. At the moment, you can display the following types of files [Extern] in the Web item itself: Nesting depth of frame (TARGET_FRAME_LEVEL) Default setting “0” Display in same browser window (IS_INPLACE) • Images: image/jpeg, image/gif • Text: text/plain • Html: text/ html This attribute specifies how many levels in the frame hierarchy have to be skipped to reach the display frame. Setting this attribute is particularly worthwhile when you are working with framesets. • With the default setting “0”, the display frames are addressed on the same HTML page. • With the setting “1”, frames are addressed that are defined on the same hierarchy level on which the frame that contains the current HTML page is also defined . You can define if the single document is displayed ‘X’ = Yes, ‘ ’ = No • In the Web application (‘X’) or • As a link that the document calls up in a separate browser window (‘ ‘) . This attribute is interpreted only if the attribute TARGET_FRAME is empty. You can only display documents in the same browser window (‘X’) for file types specified in the attribute TARGET_FRAME. The other file types are always displayed as a link. Web API Reference BW 3.5 93 SAP Online Help 25.02.2005 You can use this attribute to determine whether you can link from the document to the general document display. If the value is set to X, clicking on the picture displays all documents for the currently filtered characteristic value (or all documents for the characteristic master data, if no value is in the filter) in a separate browser window. This attribute is interpreted only if the attribute TARGET_FRAME remains empty. Links to document display (LINK_TO_BROWSER) ‘X’ = Yes, ‘ ’ = No Default picture (DEFAULT_PICTURE_URL) Absolute or relative URL for a picture. This picture is displayed in a Web item if no document has been found, or if the document is not consistent. Pictures from the MIME Repository can be selected here using a relative address. You can find more information on using the Single Document Web item and its functionality under Using Documents in Web Applications [Extern]. Web API Reference BW 3.5 94 SAP Online Help 25.02.2005 List of Documents Definition Web item that displays a list of documents in the Web application. You can also create new documents [Extern] yourself in the Web application. Use The Web item List of Documents enables you to call or create context-sensitive information about the transaction data used in the Web application. If you navigate in the Web application and, for example, restrict a characteristic to a certain characteristic value, the list of documents is automatically adjusted. This means that only the documents that are relevant for the restricted navigation status appear. The documents for the characteristics that were set as the Document Properties in the Administrator Workbench appear automatically in the list. Structure The Web item • List of Documents has the following structure: Functions You can also: • − Create a New Document [Extern] − Set whether or not the characteristics of the documents are to be displayed − Define whether the selection for the documents is to be displayed. If the selection is displayed, you can also change it so that you can look for documents in other areas. In order to be able to change the selection, the attribute Display Selection (see below) must be set accordingly. Selection The selection is the counterpart to the navigation block and shows the characteristics that are Document Properties and are contained in the basic data provider (query or query view), and their values. If you have already inserted a navigation block into your Web template, you do not need the selection information in the list of documents if you want to see only those documents that refer to the numbers of the table. The selection is adjusted dynamically depending on the navigation in the Web application. This means that the list of documents displays only those documents that refer to the requested data in the table. If the selection can be changed, you can also focus on the documents and, for example, display all the documents that refer to the InfoProvider. You can set the following in the Web Application Designer using attributes: { Whether you want to display the selection { Whether or you can change the selection in the Web application Web API Reference BW 3.5 95 SAP Online Help • 25.02.2005 List of documents The links to the documents are listed here in alphabetical order. In addition to its general attributes [Seite 12], the List of Documents Web item has the following attributes: Attributes Description Display Properties This attribute indicates if the document property is to be displayed. The document properties tell you about how the documents are assigned, for example base planning object 4711, month of May. The selection to which the document was restricted determines the assignment. (SHOW_PROPERTIES) ‘X’ = Yes, ‘ ’ = No If a document property is identical for all selected documents, this property is not displayed under the document link. You define the initial display with the Document Properties attribute. Using the Properties on/off button, you can toggle the display of the properties in the Web application. Furthermore, in the PROPERTY_LIST attribute you can set which additional document properties need to be displayed here. With this attribute you can indicate whether the the selection conditions for the documents for the List of Documents Web item are displayed as well as whether these selection conditions are changeable. Display Selection (SHOW_CONTEXT) ' ' = can be changed, is not displayed at first 'N' = cannot be changed, is displayed at first 'X' = can be changed, is displayed at first '0' = cannot be changed, is not displayed at first Number of Rows in the Table (BLOCK_SIZE) Maximum Number of Displayed Values (MAXVALUES) Web API Reference With this attribute you can define the number of rows (document links and properties) that are displayed at one time. If there are not enough rows, an index for scrolling appears in the bottom row. With this attribute you can define the maximum number of characteristic values to be displayed in the dropdown box of the selection. BW 3.5 96 SAP Online Help Document Changeable (DOCUMENTS_ARE_CHANGEABLE) 25.02.2005 With this attribute you can define whether documents can be created, changed, or deleted. ‘X’ = Yes, ‘ ’ = No Frame for Display (TARGET_FRAME) Here, you can specify an HTML frame in which the individual documents that you call from the list of documents is displayed. The HTML frame must be integrated in the Web template. If you use the Web template within a frame set, you can also integrate the called-up document in another frame of this set. If you do not define an HTML frame, the individual documents are displayed in separate windows. Additional Properties (PROPERTY_LIST) Additional document properties that are displayed for each document displayed in the Web item. Here, you can set the following properties: LAST_CHANGED_BY: Last person to make changes LAST_CHANGED_AT: Change time CREATED_BY: Creator CREATED_AT: Creation time CHECKOUT_USER: Editor LANGUAGE: Language You can find more information on using the List of Documents Web item and its functions under Using Documents in Web Applications [Extern]. Web API Reference BW 3.5 97 SAP Online Help 25.02.2005 Object Catalog of the Web Application Definition Web item with which you can generate information (as XML) about the current Web template properties, data providers and Web items used in the Web template. The Web item is not visualized in the Web application. You can see the generated XML in the source text for the Web application. Structure In addition to its general attributes [Seite 12], the Object Catalog of the Web Application Web item has the following attributes: Attribute Description Output Web template properties If you set the indicator for this attribute, the Web template properties are output as XML in the source text of the Web application. (PROPERTIES) Output list of the data providers (DATA_PROVIDERS) Output list of Web items (ITEMS) Web API Reference If you set the indicator for this attribute, a list of the data providers used is output as XML in the source text of the Web application. If you set the indicator for this attribute, a list of the Web items used is output as XML in the source text of the Web application. BW 3.5 98 SAP Online Help 25.02.2005 Data Provider – Information Definition Web item that you can use for XML generation of query results data or of the navigation state of a query. The Web item is not visualized in the Web application. You can see the generated XML in the source text for the Web application. Structure In addition to its general attributes [Seite 12], the Data Provider Information Web item has the following attributes: Attribute Description Output navigational state If you set the indicator for this attribute, the navigational state of the query is output as XML in the source text of the Web application. (NAVIGATIONAL_STATE) Output results data (RESULT_SET) If you set the indicator for this attribute, the query results are output as XML in the source text of the Web application. You can generate a description of the navigation state, as well as the amount of results for a query in the form of XML, using the Web service for accessing the query data or with the data provider command EXPORT. See also Web Service for Accessing Query Data [Extern] and Exporting Data [Seite 181]. Example You can find a description of an example scenario under XML Web Item: Data Provider Information [Seite 274]. Web API Reference BW 3.5 99 SAP Online Help 25.02.2005 Web Template Definition Web Item used to help you insert other Web templates into a Web template. Use With the Web Template Web Item, you can easily manage consistent sections in your Web applications centrally in a Web template and can integrate them into any Web template as needed. In this way, you can define a header or footer section with the corporate logo and heading as a Web template and can integrate this Web template into your Web applications as a Web Template Web item. This Web template is then inserted during runtime. In contrast to HTML frame technology, the system does not generate a new page during this process. The context of the main template remains the same. Structure In addition to its general attributes [Seite 12], the Web item Web Template has the following specific attributes: Attributes Description Only <body> tag Only use the contents of the <body> tag (USE_ONLY_BODY) If you set this attribute, only the contents of the body tag will be used for the Web template to be inserted. 'X' = Yes (standard setting), ' ' = No This attribute has to be set if the Web template to be inserted represents an entire HTML document including <HTML> tag. Web Template (TEMPLATE_ID) Web API Reference Technical name of the Web template that is to be inserted. BW 3.5 100 SAP Online Help 25.02.2005 Prefix for the logical name of the objects that are contained in the Web template. Prefix for the logical name (NAME_PREFIX) (optional) Since the objects in the main template and in the inserted Web template share a namespace and can be linked to one another through their names, you can make them unique in an associated scenario with the prefix assignment for the main template and the inserted Web template. The prefix assignment is useful when the same logical name for Web items and data providers are used in both the main template and in the inserted Web template, but when these should be separated from one another. Example: You are using a data provider DP1 in the main template with the query “sales revenue". In the inserted Web template, a data provider DP1 is also used, but this time with the query "costs". In order to have the „costs“ query displayed in the inserted Web template, it is necessary to assign the data provider for the inserted Web template with a prefix. The following table provides you with an overview of the effects of the prefix assignment on working with the Web API. Prefix assignment and its significance Prerequisites Name Prefix Assignment No Name Prefix Assignment Same logical name of Web items in the main template and in the inserted Web template. Web API – commands must address the Web item of the inserted Web template with name prefix and logical name. The following conventions apply: Initialization of the Web item corresponds to the initialization of the main template. PREFIX.NAME Example: The Web Item of the inserted Web template has the logical name ITEM_1 and the prefix is ABC. The Web item is addressed with ABC.ITEM_1. Same logical name of data providers in the main template and in the inserted Web template. Web API – commands must address the data provider of the inserted Web template with name prefix and logical name. The following conventions apply: The data binding takes place using the data provider of the main template. PREFIX.NAME Example: The data provider of the inserted Web template has the logical name ITEM_1 and the prefix is ABC. The data Web API Reference BW 3.5 101 SAP Online Help 25.02.2005 provider is addressed with ABC.DP_1. In addition, you can use the following attributes (parameters), which are not available to you in the Web Application Designer, which, however, can be inserted using the HTML view of the Web template. Attribute Description Overwriting the Web item initialization If you use this attribute, the initial Web item settings in the Web template to be inserted will be overwritten. For a possible scenario for the use of this attribute, see example 3 under Web Template [Extern]. (SET_ITEM_I; ITEM_ID_I / ITEM_CLASS_I) Overwriting the data provider initialization (SET_DATA_PROVIDER_I) (optional) If you use this attribute, the initial data provider settings in the Web template to be inserted will be overwritten. All executed attributes cannot be changed using command URLs. For more information about using the Web Template Web item and its functions, see Web Template [Extern]. Web API Reference BW 3.5 102 SAP Online Help 25.02.2005 Broadcaster Definition A Web item that serves as a tool for precalculation and distribution of BW objects. Use When you use the Web item Broadcaster, you can precalculate Web templates, queries and workbooks and can distribute them by e-mail or into the Enterprise Portal. Structure In addition to its general attributes [Seite 12], the Broadcaster has the following attributes: Attribute Description Type of reporting object Using this attribute, you can determine the type of reporting object with which the broadcaster is started. (SOURCE_OBJECT_TYPE) You can choose from the following objects: • Web template • Query • Workbook • Data providers Depending on which object you select, one of the following attributes appears for specifying the corresponding technical name. Name of the Web template (SOURCE_TEMPLATE) Name of the query (SOURCE_QUERY) Name of the workbook (SOURCE_WORKBOOK) Name of the data provider (SOURCE_DATA_PROVIDER) Technical name of the Web template with which the Broadcaster should be started. Technical name of the query with which the Broadcaster should be started. Technical name of the workbook with which the Broadcaster should be started. Logical name of the data provider with which the Broadcaster should be started. You can find more information on using the Broadcaster Web item and its functions under BEX Broadcaster Functions [Extern]. Web API Reference BW 3.5 103 SAP Online Help 25.02.2005 Query View – Selection Definition Web item with which you can navigation between various queries and query views. Use With the Web item Query View – Selection, in one step you can switch from a data provider (query or query view) and its graphical presentation (such as a table, for example) to another data provider that is perhaps presented in a different way (in a chart, for example). Structure In addition to its general attributes [Seite 12], the Query View – Selection Web item has the following attributes: Attribute Description Affected Web item Enter the name of the Web item here that is to be used for visualization of the data and that you have inserted into the Web template. This attribute is mandatory because the Web item Query View – Selection can only be dragged into a Web template in connection with a Web item for visualization off the data. (VIEW_DD_TARGET_ITEM) Web API Reference BW 3.5 104 SAP Online Help List of query views (ASSIGNMENT) 25.02.2005 List of data providers, their description and their assignment to a Web item Before you set this attribute, you must first assign a data provider to the Web template. Depending on whether you select a query or a query view as data provider, you will have to specify this query or the query view once in the rows of the list. This data provider will then be displayed initially in the Web application. Every row in the list represents an entry in the dropdown box. For each entry, establish the following: • Name of the query You can specify the technical name of the query that you want to visualize here. This entry is optional: If you want to specify a query view, skip this column. See Name of the Query View • Name of the query view You can specify the technical name of the query view here or you can select an entry from the input help for the query view. Specification of the query view is optional: If you want to specify a query, go back to the first column. See Name of the Query Display create/delete button (VIEW_DD_SHOW_BUTTONS) • Technical name of the Web item that was previously saved in a library and that should be used for visualization of the data. This information about the Web item for visualization is optional. If you do not specify anything, the affected Web item will be used for visualization. • Description for the entry in the dropdown box. A description is mandatory for every entry in the dropdown box. With this attribute, you can determine whether the buttons for creating or deleting new entries in the dropdown box should be displayed. New entries in the dropdown box are only visible locally. This means that they can only be seen by the person that created them. If you set the indicator for this attribute, a standard Web template for display will be provided. If you want to use your own Web template for display, enter this under the Web Template to Create New Entries for the Dropdown Box attribute (VIEW_DD_CREATE_TEMPLATE). Web API Reference BW 3.5 105 SAP Online Help 25.02.2005 Keep filter values for query views If you set the indicator for this attribute, the filter values are kept when you swap query views in the dropdown box. (VIEW_DD_RRI) Keep settings for the affected Web item If you set the indicator for this attribute, the settings for the affected Web item (width and size of the Web item, as well as number of data rows) are kept when you switch to another entry in the dropdown box. (VIEW_DD_KEEP_SIZE) Use all query views for a query If you set the indicator for this attribute, all query views for a query are used as entries in the dropdown box. (VIEW_DD_USE_ALL_QUERY_VIEWS) First select the desired query as data provider. The settings for the List of Query Views attribute are not used in this case. Sort query views alphabetically If you set the indicator for this attribute, the query views are sorted alphabetically in the dropdown box. Otherwise the query views are sorted according to the sequence of entries for the List of Query Views attribute. (VIEW_DD_SORT) Web template for creating new entries for the dropdown box (VIEW_DD_CREATE_TEMPLATE) Specify the technical name of the Web item to create new entries for the dropdown box using the create button. It only makes sense to set this attribute if you would like to have the create/delete buttons displayed (see Display Create/Delete Button). You can find more information on the use and function of the Query View – Selection Web item under Query View - Selection [Extern]. Web API Reference BW 3.5 106 SAP Online Help 25.02.2005 Key Figure Overview Definition Web item [Seite 10] that displays a table containing important key figures for business from the component Strategic Enterprise Management (SAP SEM). Use The Web item Key Figure Overview provides the user with a selection of important key figures for business. For each key figure, the user has the option of navigating to the associated Web templates. The Web template shows the user the origin of the key figure (that is the query or query view). Structure As well as its General Attributes [Seite 12], the Key Figure Overview Web item also has the following special attributes: Attribute Description Automatic Personalization (AUTOMATIC_PERSONALIZATION) Using this attribute, you can enable automatic personalization, that is a permanent userspecific selection of key figures from the key figure catalog. If this attribute is highlighted, the selection of key figures that a user can make using the Display Key Figure Catalog function can be permanently transferred. To use automatic personalization, general personalization must be activated in the system. For more information, see Personalization in BEx [Extern]. Customer Web Template Prefix (CUST_TEMPLATE_PREFIX) This attribute contains the Web template prefix that should be positioned in front of the technical name of the query or query view of the customer. SAP Web Template Prefix (SAP_TEMPLATE_PREFIX) This attribute contains the Web template prefix that should be positioned in front of the technical name of the query or query view of supplied by SAP. RFC Connection SEM System (SEM_RFC_DEST) In this attribute you can store an RFC connection to an SEM system from which the Key Figure Catalog is read. The user (current user or fixed user) maintained in the RFC connection is used for the authorization check in the SEM system. In the Strategic Enterprise Management (SAP SEM) component, only queries and query views are saved, not Web templates. The special attributes of the Web item are thus required to make the Web templates from the Web item callable. The Web API Reference BW 3.5 107 SAP Online Help 25.02.2005 technical name of a Web template is made up of the following: Web template name = prefix + query/query view name. Integration The data provider for the Web item Key Figure Overview is the Measure Builder (CPM-MB) of the SAP SEM component Corporate Performance Monitor (SEM CPM). The key figures that are displayed in the Web item Key Figure Overview are defined in the Measure Builder and are put together as a catalog. For more information about the Measure Builder, see the Internet under help.sap.com → SAP Cross Industry Solutions → mySAP Financials → SAP Strategic Enterprise Management in the documentation for Release SAP SEM-BW 3.50 (or in the SAP Library) under SEM – Strategic Enterprise Management → Corporate Performance Monitor (SEM CPM) → Measure Builder (CPM-MB). See also: Function description Key Figure Overview [Extern] Web API Reference BW 3.5 108 SAP Online Help 25.02.2005 Ad-hoc Query Designer Definition A Web item that enables you to create and change queries in a Web application on an ad-hoc basis. Use You can use the Ad-hoc Query Designer Web item in the Web Application Designer to structure Web applications in which you create or change queries. The Web item is as a tool for designing ad-hoc queries in a Web environment. In particular it enables you to: • Create queries by assigning characteristics from an InfoProvider to rows, columns, filters, and free characteristics, and including key figures from the InfoProvider in the key figure structure of the query. • Restrict or filter key figures and characteristics • Use predefined key figure structures and restricted or calculated key figures in the query • Set or change query properties and key figure/characteristic properties in the query • Create or change conditions and exceptions When compared with the BEx Query Designer [Extern], the Ad-hoc Query Designer Web item has the following restrictions when creating or changing queries: • You cannot integrate variables into the query directly. However, you can use variables in reusable structures, or restricted or calculate key figures, which are used in the Ad-hoc Query Designer • The query can contain only one structure. This structure has to be the key figure structure and be in the rows or columns of the query. − You cannot use key figures or key figure structures in the filter. − You cannot define exception cells, since this requires two structures. You cannot create the following objects using the Ad-hoc Query Designer Web item: − Reusable structures − Reusable restricted key figures − Reusable calculated key figures − Local calculated key figures You can create local, restricted key figures using the Ad-hoc Query Designer Web item. Web API Reference BW 3.5 109 SAP Online Help 25.02.2005 You can edit existing queries in the Ad-hoc Query Designer Web item, if the queries adhere to the restrictions laid out above The Ad-hoc Query Designer checks these requirements when loading a query. If the query is too complex, the query can be loaded into the Ad-hoc Query Designer but you cannot change it there. You then receive the appropriate message. You can still check and execute the query. Structure In addition to its general attributes [Seite 12], the Ad-hoc Query Designer Web item has the following attributes: Attributes Description InfoProvider Name (INFOCUBE) Technical name of the InfoProvider used to start the Ad-hoc Query Designer. Double-click on the empty value cell next to the attribute InfoProvider Name. The BEx Open dialog box appears. Select the InfoProvider that you want to use from your history or from the complete list under InfoAreas. Technical name of the query used to start the Ad-hoc Query Designer. Name of Query (QUERY) Double-click on the empty value cell next to the attribute Name of Query. The BEx Open dialog box appears. Select the query from your history, favorites or roles of from the complete list under InfoAreas. Template for Output (TARGET_TEMPLATE_ID) Name of the Web template used to display the query result. optional Double-click on the empty value cell next to the attribute Template for Output. The BEx Open dialog box appears. Select the Web template from your history, favorites, roles, or the list of workbooks. If you do not specify a Web template, the default Web template is used. Frame for Query Output (TARGET_FRAME) optional Frame in which the query is displayed when executed. If you specify a frame, the query output is controlled within this frame. Otherwise the query is displayed in a new browser window. Prerequisites for specifying a frame: You have created a frameset in an external HTML editor or manually (in Notepad). Web API Reference BW 3.5 110 SAP Online Help Action on Execution (ON_EXECUTE) 25.02.2005 You can use this attribute to determine what happens to the Ad-hoc Query Designer Web item in the Web Application after clicking on the Execute pushbutton in the Ad-hoc Query Designer. The following options are available: • No change to the item The query is executed. No change is made to the Ad-hoc Query Designer Web item. • Item is hidden The Ad-hoc Query Designer disappears when executing the query. If you want to open the Ad-hoc Query Designer again, while using the standard Web template, click on in the symbol toolbar. If you are using a different Web template, you need to install the option of calling up the Ad-hoc Query Designer again manually in the Web template. • Item is collapsed The Ad-hoc Query Designer is collapsed when executing the query. You now see the Web item with a collapsed arrow and title. If you want to open the Ad-hoc Query Designer again, use the arrow to open it. Web API Reference BW 3.5 111 SAP Online Help Action on closing (ON_CLOSE) 25.02.2005 You can use this attribute to determine what happens to the Ad-hoc Query Designer Web item in the Web Application after clicking on the Close pushbutton in the Ad-hoc Query Designer. The following options are available: • No change to the item During closing the query is closed in the Ad-hoc Query Designer. The individual fields (rows, columns, filter, free characteristics) are now empty. There is no change to the Web item itself. • Item is hidden The Ad-hoc Query Designer disappears when closing. If you want to open it again in the standard Web template, click on the symbol toolbar. in If you are using a different Web template, you need to install the option of calling up the Ad-hoc Query Designer again manually in the Web template. • Item is collapsed The Ad-hoc Query Designer is collapsed when closing. You now see the Web item with a collapsed arrow and title. If you want to open the Ad-hoc Query Designer again, use the arrow to open it. Display Data Provider (DISPLAY_DATA_PROVIDER) optional Data provider through which you want to display the query in the current Web template after you have executed it. Specify the name of the DataProvider with which you want to display the query in the Web template. When you double-click on an empty value cell next to the Data Provider Display attribute, a dropdown box containing a list of the data providers available appears. If you specify DISPLAY_DATA_PROVIDER but not TARGET_FRAME or TARGET_TEMPLATE_ID, when you execute the query the display data provider specified is replaced in the current Web template. Web API Reference BW 3.5 112 SAP Online Help 25.02.2005 If you do not specify the optional attributes DISPLAY_DATA_PROVIDER, TARGET_FRAME and TARGET_TEMPLATE_ID, the query results are displayed in a new browser window in the Standard Web Template for Ad-hoc Analysis [Extern]. Integration You can work with all queries in the BEx Query Designer, regardless of the tool with which they were created. Web API Reference BW 3.5 113 SAP Online Help 25.02.2005 ABC Classification Definition The ABC Classification web item allows you to classify objects (Customers, Products or Employees) based on a particular measure (Revenue or Profit) using certain classification rules. For further information, see ABC Classification [Extern] and Using ABC Classification in Web Applications [Extern]. This web item supports only the old data mining models in the Data Mining Workbench. It is not applicable to the results of transformation of ABC Classification in the Analysis Process Designer. Structure The ABC Classification web item has the following specific attributes: Attributes Description ABC_NAME (optional) Name of the ABC Classification The name of the ABC Classification model that would be used. If you do not enter a model name, a drop down box containing the names of all the models that are ready for prediction in the selected service would appear in the web item. SHOW_ABC_CLASSIFICATION Show ABC Classification "X" = Yes, " " = No Specifies whether the drop down box for selecting ABC Classification should be displayed in the web item. This option is relevant only if you have specified the ABC Classification. Otherwise, it will not have any effect. SHOW_STAT Display Statistics "X" = Yes, " " = No Specifies whether statistical information about the selected ABC Classification should be displayed in the web item. SHOW_CHART Display ABC Classification Chart "X" = Yes, " " = No Specifies whether the selected ABC Classification should be displayed as chart in the web item. SHOW_MODEL Display Model Name "X" = Yes, " " = No Specifies whether meta data (which Info Object is classified by which key figure from which Query) about the selected ABC Classification should be displayed in the web item. Web API Reference BW 3.5 114 SAP Online Help 25.02.2005 What If Prediction Definition The What If Prediction web item enables you to perform online prediction for a single customer record on models defined under services such as Decision Tree, Scoring and Clustering. For more details, see Executing What If Prediction Analysis [Extern] and Using What If Prediction in Web Applications [Extern]. Use The prediction for prospective customer behavior is based on specific attributes of that customer. For example, when a customer applies for a loan, you can predict if the customer is creditworthy or not, based on certain attributes such as income, profession or transaction history. Structure The What If Prediction web item has the following specific attributes: Attributes Web API Reference Description BW 3.5 115 SAP Online Help MODEL_NAME (optional) 25.02.2005 Name of the mining model The name of the model that would be used to perform the prediction. If you do not enter a model name, a drop down box containing the names of all the models that are ready for prediction in the selected service would appear in the web item. If you specify a model name, but do not specify the corresponding service name to which it belongs, an error will be generated. SERVICE_NAME (optional) Name of the service The name of the service for the web item. If you do not enter the service name, you can choose the service from a drop down box containing the list of services that support What If Prediction. If you specify the service name and the model name, then the web item will be for that particular service and model only. If you specify the service name but do not specify the model name, then the web item will be published for that service. You can choose the name of the model from the drop down box. DISPLAY_MODEL "X" = Yes, " " = No Display Model Name Specifies whether the model name should be displayed in the web item. This option is relevant only if you have specified the model name. Otherwise, it will not have any effect. DISPLAY_SERVICE "X" = Yes, " " = No Display Service Name Specifies whether the service name should be displayed in the web item. This option is relevant only if you have specified the service name. DISPLAY_CHART_OPT Display Chart Customize "X" = Yes, " " = No Specifies whether the option to customize the what if prediction analysis chart must be displayed or not. Web API Reference BW 3.5 116 SAP Online Help 25.02.2005 Web Template Properties Definition Web Item that is used to determine the properties of a Web template. Structure The Web item Web Template Properties has the following general attributes: Attributes Description Status-free navigation The status is removed on the server after each navigation step. Only recommended with pages that are rarely navigated to. STATELESS Use personalized template, if available USE_PERSONALIZATION Do not display system messages If available, a personalized Web template is used. System messages are not displayed. SUPPRESS_SYSTEM_MESSAGES Do not display warnings SUPPRESS_WARNINGS Force variable screen display VARIABLE_SCREEN Reset variables to default values VARIABLES_CLEAR Display same variables only once MELT_VARIABLES Open dialogs in new windows ENABLE_OPEN_WINDOW Read mode for data DATA_MODE Output optimization (device-dependent) DEVICE_OPTIMIZATION Session encoding in the URL (NO_SESSION_COOKIE) Web API Reference Apart from error messages, warnings are not displayed. The variable screen display is forced. Otherwise the variable screen is only displayed if mandatory variables have not been filled. Also see Object Tag for Properties of Web Templates [Seite 125]. Variables are reset to default values. Also see Object Tag for Properties of Web Templates [Seite 125]. The same variables for different queries are only displayed once. Also see Object Tag for Properties of Web Templates [Seite 125]. Dialogs are displayed in new windows. Also see Object Tag for Properties of Web Templates [Seite 125]. With this attribute you determine the read mode for data. Also see Object Tag for Properties of Web Templates [Seite 125]. Automatic device-dependent optimization of Web item settings for runtime (chart size for PDAs, for example). Session encoding in the URL, instead of by cookie. Each application runs in its own session. Also see Object Tag for Properties of Web Templates [Seite 125]. BW 3.5 117 SAP Online Help 25.02.2005 Resources are automatically released on the server when you leave the page. See Web Template Properties [Extern]. Automatic session management (USE_PAGE_WRAPPER) With this attribute you are able to control Report/Report Interface jumps: Show jump target in (RRI_DISPLAY_TARGET) • When the standard setting is selected (menu bar RRI), the jump takes place in a window with a menu bar. • If you do not make an entry, the jump takes place using a new window. • If you specify a frame name, the jump takes place in this frame. • If you enter the name of a window, the jump takes place in this window. As well as the general attributes, you are also able to determine entries for the context menu. Also see Modifying the Context Menu [Seite 132] on this. Integration From a technical perspective, a Web item is made up of Web template properties. This means that you can also save the Web Template Properties Web item in a library in the Web Application Designer, and reuse them in SAP Reference IMG → Business Information Warehouse → Reporting-Relevant Settings → Web-Based Settings → Determining Settings for Web Templates → Template Properties. Eigenschaften wiederverwenden. The Web item Web Template Properties is not listed in the Web item tree in the Web Application Designer. See also: Web Template Properties [Extern] Working with the Library for Web Items [Extern] Overriding Attributes [Seite 121] Web API Reference BW 3.5 118 SAP Online Help 25.02.2005 Web Templates Definition A Web template determines the structure of a Web application. You use the Web Application Designer to insert placeholders into a HTML document for Web items [Seite 10] (in the form of object tags [Seite 124]), data providers [Seite 142] (in the form of object tags) and BW URLs. The HTML document with the BW-specific placeholders is called a Web template. Web templates are checked into the Web Application Designer. The HTML page that is displayed in the Internet browser is called a Web application. Depending on which Web items you have inserted into the Web template, a Web application contains one or more tables, an alert monitor, charts, maps, and so on. Structure The Web template is the keystone of a Web application. It contains placeholders for Web items and command URLs [Seite 145]. Data providers, Web items, and command URLs are generated for Web applications. In the Web template, you determine from which data provider and it what way (Web items) the BW data is displayed. You also determine which additional options there are (BW URLs). When a request is sent from a Web application to the SAP Web Application Server, a template object is generated. The structure of the requested HTML page is derived from this object. The following objects are generated on the basis of this template: • Data Providers • Web Item Integration As of BW 3.0, Web templates are stored on the SAP Web Application Server. The option to store Web templates (for BW 2.0B or BW 2.1C, for example) on the ITS is still possible. We recommend, however, that you use the SAP Web Application Server. Example The following is an example of a simple Web template with a navigation block [Seite 32] and a table [Seite 16]: <html> <head> <link rel="stylesheet" href="Bex/StyleSheets/BWReports.css"> <title>New Page 1</title> </head> <body> <!--Template properties --> <object> Web API Reference BW 3.5 119 SAP Online Help 25.02.2005 <param name=’OWNER’ value=’SAP_BW’> <param name='CMD' value='SET_PROPERTIES'> <param name='VARIABLE_SCREEN' value='X'> <param name='USE_PERSONALIZATION' value='X'> </object> <!--Create the data provider --> <object> <param name=’OWNER’ value=’SAP_BW’> <param name=’CMD’ value=’SET_DATA_PROVIDER’> <param name='DATA_PROVIDER' value='View1 > <param name='DATA_PROVIDER_ID' value='VIEW1'> DATA_PROVIDER :View1 </object> <!--Create and get the navigational block --> <object WIDTH=”350”> <param name=’OWNER’ value=’SAP_BW’> <param name=’CMD’ value=’GET_ITEM’> <param name=’ITEM’ value=’Nav Block’> <param name='ITEM_ID' value='NAVBLOCK'> <param name='DATA_PROVIDER' value='View1 > ITEM :Nav Block </object> <br> <!--Create and get the table --> <object WIDTH=”600”> <param name=’OWNER’ value=’SAP_BW’> <param name=’CMD’ value=’GET_ITEM’> <param name='ITEM' value='Table'> <param name='ITEM_ID' value='TABLE'> <param name='DATA_PROVIDER' value='View1 > ITEM :Table </object> </body> Web API Reference BW 3.5 120 SAP Online Help 25.02.2005 Overriding Attributes Use All attributes for Web items and all Web template properties can be overridden. At the time of execution, the respective attribute value is specified for Web items, corresponding to the sequence URL->Object Tag in Web Template -> Library Web Item -> System Default of the corresponding attribute value. This is likewise valid for the Web template properties. Here the specification occurs, corresponding to the sequence URL-> Web Template Properties -> Library Web Item -> Web Template Properties defined in Customizing for the Business Information Warehouse under Web-based Settings -> System Default. Example of the Web item attribute WIDTH (Width in Points) for the Web item Table URL Parameterization WIDTH = ‘600’ Web Item in Web Template WIDTH = ‘500’ Library Web Item WIDTH = ‘400’ Default WIDTH = ‘300’ Example of Web template property SUPPRESS WARNINGS Web API Reference BW 3.5 121 SAP Online Help URL Parameterization 25.02.2005 X SUPPRESS_WARNINGS = ‘ ‘ Web Template Library Web Item X Web Template Properties in Customizing SUPPRESS_WARNINGS = ‘X‘ SUPPRESS_WARNINGS = ‘ ‘ X Default SUPPRESS_WARNINGS = ‘X‘ SUPPRESS_WARNINGS = ‘X‘ General Rules for Overriding Settings The following graphic shows the priority rules when overriding settings of the Web template properties and the Web item attribute. Web Template Properties Web Item Attributes URL Parameterization URL Parameterization Template Settings for Web Template Properties Template Settings for Web Item Attributes Library Setting for Web Template Properties Library Setting for Web Item Attribute Customizing Setting for Web Template Properties SAP Standard Web API Reference SAP Standard BW 3.5 122 SAP Online Help Web API Reference 25.02.2005 BW 3.5 123 SAP Online Help 25.02.2005 Object Tags Definition By using object tags, you can determine properties of Web templates, create data provider and Web items in a Web template, and supply them with attributes. These object tags are created in the Web Application Designer. Structure An object tag starts with “<object...>” and ends with “</object>”. The SAP_BW object tags are identified by the attribute “owner” and the value “SAP_BW”. Only this type of object is replaced in the Web template. All other types of object are transferred unchanged into the Web application. Attributes for BW object tags should be set within the object tag in the form of a parameter tag. <object> <param name='owner' value='SAP_BW'> <param name='WIDTH' value='350'> ... </object> In runtime, however, attributes can also be set in the object tag at the beginning: <object WIDTH='350' HEIGHT='234' owner='SAP_BW' ...></object> This is not recommended as it is not supported in the Web Application Designer. Object tags are also displayed in non-HTML code mode in many HTML editors. Some HTML editors also give you the option of changing the size, and maintaining the attributes of the object tag. It is usually possible to use the drag and drop function to move the object tags around a page. The following object tags play an important role in BEx Web Applications: Object Tag for Properties of Web Templates [Seite 125] Object Tag for Data Provider [Seite 142] Object Tag for Web Items [Seite 144] Web API Reference BW 3.5 124 SAP Online Help 25.02.2005 Object Tag for the Properties of Web Templates Definition Object Tag for defining the properties of Web templates. Use The attributes of a Web template can be defined in an object tag. In addition to the Web template attributes listed below, all of the context menu properties also belong. These properties can also be transferred with URL when calling up the Web template. Parameter 'CMD' must be set to 'SET_PROPERTIES' to indicate that these are the attributes of the Web template. Attributes Description TEMPLATE_ID Name of the Web template Name under which you stored the Web template in the Web Application Designer. STATELESS (optional) Status-free navigation ‘X’ = Yes, ‘ ’ = No For Web templates that are used almost exclusively for display without further navigation, it is more useful to set the attribute STATELESS. The session on the application server is terminated when the Web template is created. This saves resources on the application server. If this attribute is not specified, it is assumed that the page is still needed for navigating. USE_PERSONALIZATION (optional) 'X' = Yes, ' ' = No STYLE_SHEET (optional) Use personalized Web template, if available If the parameter is set to ‘X’, the personalized Web template for the current user is used. If personalization does not exist for the Web template or the parameter is not set, the Web template is executed without personalization. Path to a stylesheet that you want to use to display the Web template. This overwrites any stylesheet that you may have already assigned to the Web template. Example for a path specification: /sap/bw/mime/BEx/StyleSheets/Meadow_BWReports.css Web API Reference BW 3.5 125 SAP Online Help 25.02.2005 JAVASCRIPT (optional) Using JavaScript ’X’ = activate, ‘ ’ = do not activate Using this parameter, you ensure that Web applications are created using JavaScript (extensive interaction options) or suppress the use of JavaScript (restricted interaction). If this attribute is not transferred, JavaScript is activated automatically in Web browsers of version >=4.0. SNIPPET_OPERATIONS (optional) Reload changed components of the page ’X’ = activate, ‘ ’ = do not activate You use this attribute to control whether only changed objects are loaded in navigation. This function has higher Web browser requirements. For this reason, this function is only supported by MS Internet Explorer version >=5.0. If this attribute is not transferred, loading is activated automatically for the suitable Web browsers. ENABLE_OPEN_WINDOW (optional) ’X’ = activate, ‘ ’ = do not activate Open dialogs in new windows Using this attribute, you can control whether a new browser window is opened, for example, for the properties dialog box or for filtering. If this attribute is not specified, new windows are opened (if supported by the Web browser). VARIABLE_SCREEN (optional) Force variable screen display ‘X’ = activate variable screen, ‘ ’ = do not activate, if possible If you call up a Web template that has query views containing variables that are ready for input, you can use these attribute to display the variable screen. If you do not set this attribute, or set it to ‘ ’, the variable screen is hidden, wherever possible. However, it is still shown if, for example, the required variables that are ready for input have not yet been filled. MELT_VARIABLES (optional) Display same variables only once ‘X’ = merge, ‘ ’ = display each query individually The same variables for different queries are only displayed once. If you call up a Web template containing several query views that have variables that are ready for input and you go to the variable screen display, you can determine, through these parameters, whether variables, which are used in all query views and in the same context (same compounding, same initial value), are to be provided for input only once. If the variables correspond to different InfoProviders, then the input help is automatically read from the master data table. Web API Reference BW 3.5 126 SAP Online Help 25.02.2005 VARIABLES_CLEAR (optional) Reset variables to default values ‘X’ = reset variable, ‘ ’ = do not reset If you call up a Web template that contains one or more query views that have variables that are available for entry, you can specify this attribute to reset the default variables through the query view. Afterwards, the variables have the default settings from the variable definition. SUPPRESS_WARNINGS (optional) Do not display warnings ‘X’ = do not display warnings, ‘ ’ = display warnings SUPPRESS_SYSTEM_MESSAGES (optional) ‘X’ = do not display system messages, ‘ ’ = display system messages With this attribute, warnings are not displayed. Terminations are still displayed. Do not display system messages With this attribute, system messages are not displayed. If you assign the value ‘CONDITIONAL’, system messages are only displayed once a day for each user. 'CONDITIONAL' = only display system messages for the user once a day. DATA_MODE (optional) Read mode for data ‘NEW’ = use current data If you do not specify this attribute, a request is without exception sent to the OLAP processor and the current data is read. ‘STORED’ = Use precalculated data ‘HYBRID’ = use precalculated data; request current data if this is missing. For the modi ‘STORED’ and ‘HYBRID’, data has to be precalculated using the Reporting Agent [Extern]. See Defining the Web Templates Setting [Extern]. ‘STATIC’ = use pre-calculated HTML pages ‘STATIC_HYBRID’= use precalculated HTML pages. If there are none, search for pre-calculated data; if nothing found, request current data. DEVICE_OPTIMIZATION Output optimization (device-dependent) By selecting this attribute, you bring about an automatic, devicespecific optimization of Web item settings at runtime (for example, chart size for PDAs). Web API Reference BW 3.5 127 SAP Online Help NO_SESSION_COOKIE ‘X’ = session encoding in the URL, ‘ ‘ = no session encoding in the URL 25.02.2005 Session encoding in the URL, instead of by cookie. Each Web application runs in its own session. A cookie is used by default to manage the session for a stateful BEx Web Application. This can lead to possible problems; however, you can eliminate these with the help of this attribute. In the following cases it is preferable to use session encoding in the URL: • You are integrating a BSP-Application (BC-BSP) [Extern] into a BEx Web Application. The BEx Web Application is also sent to the BSP application. The BSP application exits the session, for example because it is stateless. This causes a timeout in the BEx Web Application. You can use the attribute Session Encoding in the URL instead of by Cookie to avoid this problem. The BEx Web Application then uses the session coding in the URL and no session cookie is sent to the BSP application. • Several initials call-ups from different BEx Web Applications occur simultaneously in the same Web Browser (for example in the case of a frameset, where the frames contain different URLs from BEx Web Applications). In this case the default use of session cookies causes errors. As there is no initial session, each request produces a new session on the server. Accordingly, each reply sent back to the Web Browser contains a new session cookie. However the session cookie always has the same name and is therefore overwritten in the Web Browser with each reply. Navigation to the BEx Web Application, for example sent back from the server first, also uses the session cookie from the previous reply. However, in this session the state of the Web Application is not given. You can use the attribute Session Encoding in the URL instead of by Cookie to avoid this problem. The session is then always contained within the URLs and is not influenced by other BEx Web Applications. • The Web Browser used does not support cookies (this is the case for example with some mobile devices). However in this case, the automatic device recognition [Extern] starts the application for such devices in the NO_SESSION_COOKIE=X session. When using the attribute Session Encoding in the URL instead of by Cookie, no session bundling between different BEx Web Applications follows. Each Web Application is allocated its own session on the server. USE_PAGE_WRAPPER Automatic session management ' ' = not active, 'X' = active, 'PING' = prevent timeout If you select this attribute, the resources are automatically released to the server. You can find additional information about this attribute under Web Template Properties [Extern]. Web API Reference BW 3.5 128 SAP Online Help RRI_DISPLAY_TARGET Standard setting: menu barRRI 25.02.2005 • Show jump target in With this attribute you can control the RRI jump from the context menu. When the standard setting is selected, the RRI jump takes place in a window with a menu bar. If you do not make an entry, the RRI jump always takes place using a new window. If you enter a frame name, the RRI jump takes place in this frame. If you enter the name of an existing window, the RRI jump takes place in the window with the specified name. Also see Web Template Properties [Seite 117] and Properties of a Web Template [Extern]. Examples The Web template should appear with variables entry <object> <param name=’OWNER’ value=’SAP_BW’> <param name='CMD' value='SET_PROPERTIES'> <param name='VARIABLE_SCREEN' value='X'> </object> Context menu should not contain an enhanced menu <object> <param name=’OWNER’ value=’SAP_BW’> <param name='CMD' value='SET_PROPERTIES'> <param name='MENU_ENHANCED' value=' '> </object> The following, additional attributes for setting data providers or special data providers / Web items are usually set only in conjunction with command URLs for calling up Web templates. However, they can also appear statically in the object tag. The index in the parameter is indicated in the following by '_I'. Displaying a query Attributes Description INFOCUBE Technical name of the InfoProvider QUERY Technical name of the query VARIANT (optional) Variant, if you are not required to enter a variable. Display of another query view Attributes Description DATA_PROVIDER_ID Technical name of the saved query view VARIANT (optional) Variant, if you are not required to enter a variable. Web API Reference BW 3.5 129 SAP Online Help 25.02.2005 The attributes PAGEID and WBID that are used in BW 2.x are supported for the Web templates created under BW 2.x. However, we recommend that you no longer use these. Attributes for overwriting the data provider initialization Attributes Description SET_DATA_PROVIDER_I Logical name of the data provider Name of the data provider for which you want to set a new initialization. INFOCUBE_ I (Option 1) Technical name of the InfoProvider QUERY_ I (Option 1) Technical name of the query DATA_PROVIDER_ID_ I (Option2) Technical name of the saved query view VARIANT (optional) Variant, if you are not required to enter a variable. Attributes for overwriting the Web item initialization Attributes Description SET_ITEM_I Logical name of the Web item Name of the Web item for which you want to set a new initialization. ITEM_ID_I (Option 1) Web item key A Web item is created for a Web template on the basis of a Web item setting made in the Web Application Designer. ITEM_CLASS_I (Option 2) Class name of the Web item class Name of the ABAP object class that output generation transfers. This corresponds to the use of non-reusable Web items (standard Web items) in the Web Application Designer. Web items are created with the default values for the attribute. The class name for the table is CL_RSR_WWW_ITEM_GRID for example. Web API Reference BW 3.5 130 SAP Online Help 25.02.2005 Adjusting and Enhancing the Context Menu Use You can adjust the context menu that is created automatically for table cells to your companyspecific needs and scenarios. You can copy functions of the enhanced context menu to the context menu that is not enhanced or you can hide functions. You can also integrate your own context-specific entries in the context menu. Functions The following options are available: Adjusting the Context Menu [Seite 132] Enhancing the Context Menu [Seite 139] Web API Reference BW 3.5 131 SAP Online Help 25.02.2005 Adjusting the Context Menu Use Along with properties such as VARIABLE_SCREEN, you can also modify the context menu for a Web template. You can turn every entry in the menu on or off or place it in the Enhanced Menu. Features All entries in the context menu are listed in the following list of attributes: Menu entries that are not specified retain their default value. The default values are underlined in the list Attributes Description Back Menu entry: “Back” Undo one navigation step on a data provider (MENU_BACK) ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Back to start (MENU_BACK_TO_START) Menu entry: “Back to Start” Undo all navigation steps on a data provider ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Keep filter value Menu entry: “Keep Filter Value” (MENU_FILTER) ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Keep filter value on axis Menu entry: “Keep Filter Value on Axis” (MENU_FILTER_ON_AXIS) ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Web API Reference BW 3.5 132 SAP Online Help Select Filter Value 25.02.2005 Menu entry: “Select Filter Value” (MENU_SELECT_FILTER) ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Keep Filter Value on Axis for Diagram (MENU_FILTER_ON_AXIS_CHART) ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Keep Filter Value for Diagrams (MENU_FILTER_CHART) ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Filter and Drilldown According to Menu entry: “Keep Filter Value on Axis for Diagram” When considering diagrams, it is often more useful to use the command “Keep Filter Value on Axis” than it is to keep the filter, which is removed when you drilldown. The geometry of the list remains the same and the chart/or map can still be interpreted. Therefore, there are separate settings for these Web items. Menu entry: “Keep Filter Value” for Diagrams When considering diagrams, it is often more useful to use the command “Keep Filter Value on Axis” than it is to keep the filter, which is removed when you drilldown. The geometry of the list remains the same and the chart/or map can still be interpreted. Therefore, there are separate settings for these Web items. Menu entry: “Filter and Drilldown According to” (MENU_FILTER_DrILL_DOWN) ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Drilldown According to Menu entry: “Drilldown According to” (MENU_DRILL_UP) ‘ ’= Not displayed “Drilldown” with the exception of navigation in maps. ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Drilldown According to in Context of Map (MENU_DRILL_UP_GIS) Menu entry: “Drilldown According to” in Context of Map ‘ ’= Not displayed “Drilldown” in the context of navigation in maps. ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Web API Reference BW 3.5 133 SAP Online Help Insert Drilldown According to 25.02.2005 Menu entry: “Insert Drilldown According to” (MENU_DRILL_DOWN) ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Swap ... with ... (MENU_EXCHANGE_OBJECTS) Menu entry: “Swap ... with ...” Swap characteristics or structures. ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Remove drilldown Menu entry: “Remove Drilldown” (MENU_REMOVE_DRILL_DOWN) ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Swap Axes Menu entry: “Swap Axes” (MENU_SWITCH_AXIS) ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Expand/Collapse Hierarchy Nodes Menu entry: Expand/Collapse Hierarchy Nodes (MENU_HIERARCHY_NODE_DRILL) ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Expand Hierarchy Menu entry: “Expand Hierarchy” (MENU_HIERARCHY_DRILL) ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” (De)activate Hierarchy Menu entry: “(De)activate Hierarchy” (MENU_HIERARCHY_STATE) ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Web API Reference BW 3.5 134 SAP Online Help Sorting (MENU_SORT) 25.02.2005 Menu entry: “Sort” Sort by characteristic cells and data cells. ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Calculate result as... (MENU_CALCULATE_RESULT) Menu entry: “Calculate Result as” Calculations for value cells. ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Calculate single values as... (MENU_CALCULATE_VALUE) Menu entry: “Calculate Single Values As...” Calculations for value cells. ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Cumulated (MENU_CUMULATE_VALUE) Menu entry: “Cumulated” Calculations for value cells. ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Displaying Documents Menu entry: “Display Documents” (MENU_DISPLAY_DOCUMENTS) ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Create Document Menu entry: “Create New Document” (MENU_DOCUMENT_CREATE) ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Show/Hide Document Properties (MENU_DISPLAY_DOCUMENT_PROP) Menu entry: “Show/Hide Document Properties” In the context of the Web item List of Documents. ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Web API Reference BW 3.5 135 SAP Online Help Show/Hide Document Selection Criteria (MENU_DISPLAY_DOCUMENT_SELEC) ‘ ’= Not displayed 25.02.2005 Menu entry: “Show/Hide Document Selection Criteria” In the context of the Web item List of Documents. ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Report/Report Jump Targets Menu entry: For report/report jump targets (MENU_RRI) ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Export as …CSV File Menu entry: “Export as... CSV File” (MENU_EXPORT_TO_CSV) ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Export as ... MS Excel 2000 File Menu entry: “Export as ... MS Excel 2000 File” (MENU_EXPORT_TO_XLS) ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Bookmark (MENU_BOOKMARK) Menu entry: “Bookmark” Create bookmarks. ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Bookmark with Displayed Data (MENU_BOOKMARK_WITH_DATA) ‘ ’= Not displayed Menu entry: “Bookmark with Displayed Data” Create bookmark with the current data. When you call up the bookmark later, the “historical” data is displayed. ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Personalize Web Page Menu entry: “Personalize Web Page” (MENU_PERSONALIZE) ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Web API Reference BW 3.5 136 SAP Online Help 25.02.2005 Display Charactieristic Properties (MENU_CHARACTERISTIC_PROPERTIES) Menu entry: “Display Characteristic Properties” Properties for characteristic cells. ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Value Cell Properties (MENU_VALUE_PROPERTIES) Menu entry: For value cell properties Properties for value cells. ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Query Properties Menu entry: “Query properties” (MENU_QUERY_PROPERTIES) ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Display variable screen (MENU_VARIABLE_SCREEN) Menu entry: For calling up variables screen Variable entry call up if there are queries have variables in the Web Application. ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Currency translation (MENU_CURRENCY_CONVERSION) Menu entry: “Currency Translation” Calls up the currency translation dialog box. ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” Enhanced Menu (MENU_ENHANCED) Menu entry: “Enhanced Menu” Display option for entries in the enhanced context menu. ‘ ’= Not displayed ‘X’= “Always Display” in the basic menu ‘E’= Displayed in the “enhanced menu” ENHANCED_MENU ‘ ‘ = Start with basic menu ‘X’ = Start with enhanced menu Start with Enhanced Menu You decide here whether the page opens with the basic menu (standard setting) or the enhanced menu. Examples For this example, Swap Axes appears in the basic context menu and the currency translation is completely hidden. Web API Reference BW 3.5 137 SAP Online Help 25.02.2005 <object> <param name='OWNER' value='SAP_BW'> <param name='CMD' value='SET_PROPERTIES'> <param name='MENU_SWITCH_AXIS' value='X'> <param name='MENU_CURRENCY_CONVERSION' value=' '> </object> Web API Reference BW 3.5 138 SAP Online Help 25.02.2005 Enhancing the Context Menu Use As well as being able to make entries in the context menu visible, entries in the enhanced menu visible or entries in the enhanced menu invisible, you can also hang scenario-specific entries in the menu. You have two options: • You define the new entries using the Web Template Properties object tag. • You add the new entries to the menu using the JavaScript function. The first way is described in this section. In both cases, you have to write a JavaScript function that transfers the processing when you select the menu entry. You can find out more about this under Command Processing [Seite 248]. Features New entries are defined using different series of attributes in the Web template properties as follows: Attribute Description CMENU_LABEL_I Labeling text in the menu CMENU_FUNCTION_I JavaScript function for processing the command You implement this function in JavaScript and use it to execute commands after you have selected the menu entry. CMENU_PARAMETER_I Free parameter This attribute is passed to the JavaScript function 'CMENU_FUNCTION' and can be evaluated there as required. The attribute makes it possible to use a function for more than one menu entry. CMENU_CELL_TYPE_I Context of the entry ‘ ’ = No restriction If you want the menu entry to appear only in certain contexts and not in all context menus, you can define this with ‘cell_type’ and ‘filter’. ‘CHARACTERISTIC’ = Characteristic ‘CHARACTERISTIC_VALUE’ = Characteristic value ‘STRUCTURE’ = Structure ‘STRUCTURE_VALUE’ = Structure component value ‘DATA’ = Data cell ‘EXCEPTIONS’ = Exceptions item ‘CONDITIONS’ = Conditions item 'DOCUMENT_LIST' = Document list item Web API Reference BW 3.5 139 SAP Online Help CMENU_FILTER_I 25.02.2005 Context of the entry According to the value of ‘cmenu_cell_type’, different values are useful here: ‘CHARACTERISTIC’, ‘CHARACTERISTIC_VALUE’, ‘STRUCTURE’, ‘STRUCTURE_VALUE’: Iobjnm ‘EXCEPTIONS’: Exception ID ‘CONDITIONS’: Condition ID ‘DOCUMENT_LIST’: Document ID See Examples. CMENU_VISIBILITY_I Visibility of the entry ‘ ’= Not displayed You specify whether the entry is to appear in the basic menu or also in the enhanced menu. ‘X’= Displayed in the “basic menu” ‘E’= Displayed in the “enhanced menu” CMENU_POSITION_I Position of the entry ‘TOP’ = Before the “normal” entries The entries are inserted in the order in which they were called up. You can choose whether the entry is to appear before the “normal” entries or after them in the menu. You cannot position the entries in between the “normal” entries. ‘BOTTOM’ = After the “normal” entries Examples . <object> // Menu entry at the beginning and only on customer cells <param name=’OWNER’ value=’SAP_BW’> <param name='CMD' value='SET_PROPERTIES'> <param name='CMENU_LABEL_1' value='Customer details'> <param name='CMENU_FUNCTION_1' value='myMenuProcessor'> <param name='CMENU_PARAMETER_1' value='1'> <param name='CMENU_CELL_TYPE_1' value='CHARACTERISTIC_VALUE'> <param name='CMENU_FILTER_1' value='0CUSTOMER'> <param name='CMENU_VISIBILITY_1' value='X'> <param name='CMENU_POSITION_1' value='TOP'> // Menu entry at the end for IT homepage <param name='CMENU_LABEL_2' value='Customer details'> <param name='CMENU_FUNCTION_2' value='myMenuProcessor'> <param name='CMENU_PARAMETER_2' value='2'> <param name='CMENU_VISIBILITY_2' value='X'> <param name='CMENU_POSITION_2' value='BOTTOM'> // Menu entry at the beginning and only on material groups <param name='CMENU_LABEL_3' value='Materials'> <param name='CMENU_FUNCTION_3' value='myMenuProcessor'> Web API Reference BW 3.5 140 SAP Online Help 25.02.2005 <param name='CMENU_PARAMETER_3' value='3'> <param name='CMENU_CELL_TYPE_3' value='CHARACTERISTIC_VALUE'> <param name='CMENU_FILTER_3' value='0MATGROUP'> <param name='CMENU_VISIBILITY_3' value='X'> <param name='CMENU_POSITION_3' value='TOP'> </object> You can find an example implementation for the JavaScript function “myMenuProcessor” under JavaScript [Seite 237]. Web API Reference BW 3.5 141 SAP Online Help 25.02.2005 Object Tag for Data Provider Definition Object tag for creating Data Providers (BW-BEX) [Extern]. Use The attributes that you need for creating a data provider are available in the Web Application Designer. Data provider properties Attributes Description Notes DATA_PROVIDER ( or Name ) Logical name of the data provider SAP recommends that you keep to the conventions supported by the Web Application Designer when specifying names: The name should be a maximum of 30 characters long and consist of characters “A-Z”, “0-9” and “_”. It cannot start or end with “_”. Adhering to these conventions facilitates the upgrade to future SAP releases. This name is used to attach Web items to a particular data provider and to send commands to the data provider. The name must be unique within the Web template [Seite 119]. DATA_PROVIDER_ID (optional) Key for a query view You cannot change this attribute with a command URL [Seite 145]. QUERY (optional) Technical name of a query You cannot change this attribute with a command URL [Seite 145]. INFOCUBE (optional) Technical name of the InfoProvider This attribute is necessary if the QUERY attribute is specified. You cannot change this attribute with a command URL [Seite 145]. VARIANT (optional) Name of the variant used to fill the variables You cannot change this attribute with a command URL [Seite 145]. When you save a query view, the current variable values are saved with it. You can overwrite the values by specifying a variant (optional). You create variants on the variables screen. HOME_FRAME (optional) Name of the main frame If you use HTML frame technology to display the data, and you want to display the F4 Web API Reference BW 3.5 142 SAP Online Help 25.02.2005 Help in a separate frame to the Web template, for query views, you have to specify in the HOME_FRAME attribute, the name of the frame where the Web template is displayed. You also have to specify the attribute TARGET_HELP_FRAME for the navigation block Web item. • The attributes VIEWID and WBID (DATA_PROVIDER_WBID) used in BW 2.x are still supported. However, we recommend that you no longer use these. • The ‘CMD’ parameter has to be filled with the ‘SET_DATA_PROVIDER’ to indicate that you are creating a data provider • You can add additional attributes, for example, in order to send a command to the data provider before calling up the page. Examples Create query view <object> <param name=’OWNER’ value=’SAP_BW’> <param name=’CMD’ value=’SET_DATA_PROVIDER’> <param name='DATA_PROVIDER' value='View1 > <param name='DATA_PROVIDER_ID' value='VIEWABC'> DATA_PROVIDER :View1 </object> Query view filtered by country (USA) <object> <param name=’OWNER’ value=’SAP_BW’> <param name=’CMD’ value=’SET_DATA_PROVIDER’> <param name='DATA_PROVIDER' value='View1 > <param name='DATA_PROVIDER_ID' value='VIEWABC'> <param name=’FILTER_IOBJNM’ value=’0COUNTRY’> <param name=’FILTER_VALUE’ value=’US’> DATA_PROVIDER :View1 </object> Web API Reference BW 3.5 143 SAP Online Help 25.02.2005 Object Tag for Web Items Definition Object tag for creating a Web item. Use The attributes that you need for creating a Web item are available in the Web Application Designer. You can add additional attributes to adjust the size at a later point, or to set a title, for example. The parameter ‘CMD’ has to be filled with ‘GET_ITEM’ to indicate that you are creating a Web item. Example Creating a Web Item <object> <param name=’OWNER’ value=’SAP_BW’> <param name=’CMD’ value=’GET_ITEM’> <param name='ITEM' value='NavBlock'> <param name='ITEM_ID' value='NAVBLOCK'> <param name='DATA_PROVIDER' value='View1 > ITEM :Nav Block </object> Creating a Web item with height 400 pixels, width 500 pixels, and the title “Business Graphic” <object WIDTH=’400’ HEIGHT=’500’> <param name=’OWNER’ value=’SAP_BW’> <param name=’CMD’ value=’GET_ITEM’> <param name='ITEM' value='Chart1'> <param name='ITEM_ID' value='PIECHART'> <param name='DATA_PROVIDER' value='View1 > <param name=’GENERATE_CAPTION’ value=’X’> <param name='CAPTION' value='Business Grafik'> ITEM :Chart 1 </object> Web API Reference BW 3.5 144 SAP Online Help 25.02.2005 Command URLs Definition You can set command URLs in a Web template [Seite 119], as well as an object tag [Seite 124]. 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: 3. Hyperlink as text <a href="<SAP_BW_URL cmd='LDOC' TEMPLATE_ID='EXAMPLE_TEMPLATE'>" target="_Blank">Example Call up Template in New Window</a> 4. 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> 5. 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_TEM PLATE’); 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. 6. Enhancing the context menu You can also use command URLs during Enhancing the Context Menu with JavaScript [Seite 245]. 7. Using Forms You can also use command URLs when Using Forms [Seite 234]. Web API Reference BW 3.5 145 SAP Online Help 25.02.2005 8. 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. Use language-dependent texts [Seite 259] 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_i d=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 [Seite 232] Sending Commands [Seite 238] Different Command Types There are different types of commands: • Commands for Changing Attributes of a Web Item [Seite 147] • Data Provider Dependent Commands [Seite 172] • Commands for Web Templates [Seite 150] Web API Reference BW 3.5 146 SAP Online Help 25.02.2005 Changing Web Item Attributes Use In a Web application you can reset the Web item attributes for the runtime in a simple and easy way. All attributes are available for this, which you can also set in the Web Application Designer. You can find the attributes available for this under Web Items [Seite 10] as well as an explanation of the individual Web items. Features Parameter Description ITEM Item name You are able to apply a command to several Web items. In addition to the explicit specification of Web items, the quantity can also be limited by means of wild cards (MUTLI=’X’). The command is applied to all Web items, as long as they support this action. You must specify the Web item(s). MULTI Use Web item as template If MULTI is set to ‘X’, the command is applied to all the Web items that have ITEM in their name. ’*’ corresponds to all Web items. This parameter is optional. ‘X’ = Yes, ‘ ’ = No Example Pushbutton for activating alternating styles for table rows: <table class="SAPBEXBtnStdBorder" cellspacing="0" cellpadding="0" border="0"><tr><td><table><tr><td class="SAPBEXBtnStd"><a href=”<SAP_BW_URL item=’TABLE_1’ ALT_STYLES=’X’>”>Alternierende Styles</a></td></tr></table></td></tr></table> Web API Reference BW 3.5 147 SAP Online Help 25.02.2005 Resetting and Reinitializing Web Items Use You use this command to reinitialize an existing Web item. The Web item is recreated according to the parameters and is given the data provider [Seite 172] and the logical name of its predecessor. This allows you, for example, to create a graphic easily from a table without having to create both objects in the Web template. You can use this command to create almost every kind of Web item. The Map Web item is however an exception. Map Web items cannot be created consistently using this command. Features CMD RESET_ITEM Parameter Description ITEM Name of the Web item that is to be reinitialized. ITEM_CLASS Name of the ABAP object class that generates the output. The class name for the Web item Table is, for example CL_RSR_WWW_ITEM_GRID or CMD RESET_ITEM Parameter Description ITEM Name of the Web item that is to be reinitialized. ITEM_ID Technical name of a library Web item In order to overwrite individual attributes of the Web item to be reinitialized you can enter them as parameters. Conversion of Web item “item1” to a Web item table without alternating rows: <SAP_BW_URL ITEM='Item1' CMD='RESET_ITEM' ITEM_CLASS='CL_RSR_WWW_ITEM_GRID' ALT_STYLES=''> Conversion of the Web item “item1” to a pre-defined Web item Chart. <SAP_BW_URL ITEM='Item1' CMD='RESET_ITEM' ITEM_ID='myChart'> When combined with a dropdown box (as HTML form), you can display several charts in one place by leafing through the dropdown box. You can find an example of this in the standard Web template for the Ad-hoc Analysis (subtemplate 0ADHOC_CHARTS). Web API Reference BW 3.5 148 SAP Online Help Web API Reference 25.02.2005 BW 3.5 149 SAP Online Help 25.02.2005 Commands for Web Templates Use Commands for Web templates include all commands that are neither specific to data providers or to Web items. They include commands for calling up and changing Web templates and for generating bookmarks. For more information, see: Calling up a Web Template [Seite 151] Calling up Parameterized Web Templates [Seite 153] Changing a Web Template [Seite 158] Personalizing Web Templates [Seite 159] Generating Bookmarks [Seite 160] Changing the Symbol Directory [Seite 161] Releasing Web Templates [Seite 162] Ending a Session [Seite 163] Variables [Seite 164] Web API Reference BW 3.5 150 SAP Online Help 25.02.2005 Calling up Web Templates Use The URL for calling a Web template is generated by the Web Application Designer. You can extend the URL by various parameters when you call up a Web template. These parameters can: • influence the contents or display of the data for the result that is returned (see Calling Up Parameterized Web Templates [Seite 153]) • activate or deactivate different functions on the server. Features Choose from the following options to call up the template: Standard call up and properties of Web templates You can find the permitted attributes for Web template properties under Object Tag for Properties of Web Templates [Seite 125]. CMD LDOC Parameter Description TEMPLATE_ID Name of the Web template Name under which you stored the Web template in the Web Application Designer. TRACE (optional) ’X’ = activate, ‘ ’ = do not activate Activate OLAP trace You usually need a trace to analyze problems in SAP. You can activate the trace with the help of note 112458 or by using the TRACE attribute. Any other parameters for parameterizing your Web template See Object Tag for Properties of Web Templates [Seite 125]. The parameters PAGEID and WBID that are used in BW 2.x are supported for the Web templates created under BW 2.x. However, we recommend that you no longer use these. Calling up the Web template without navigating http://yourAppServer:yourPort/SAP/BW/BEx?CMD=LDOC&TEMPLATE_ID=yourTe mplate&STATELESS=X Calling up the Web template with an activated trace http://yourAppServer:yourPort/SAP/BW/BEx?CMD=LDOC&TEMPLATE_ID=yourTe mplate&TRACE=X Calling up the Web template with reset variables and active variable screen Web API Reference BW 3.5 151 SAP Online Help 25.02.2005 http://yourAppServer:yourPort/SAP/BW/BEx?CMD=LDOC&TEMPLATE_ID=yourTe mplate&VARIABLE_SCREEN=X&VARIABLES_CLEAR=X Calling up the Web template with a different data provider This call-up replaces all data providers [Seite 172] of the type 'query view' with the data provider specified. This makes it possible to make a query or query view available without making any further settings in the Web, and then use predefined Web templates for the page layout. You can find the description of the necessary parameters under Object Tag for Properties of Web Templates [Seite 125] Displaying a query by using a Web template of your choice http://yourAppServer:yourPort/SAP/BW/BEx?CMD=LDOC&TEMPLATE_ID=yourTe mplate&infocube=myCube&query=myQuery Setting your own Web template objects As well as being able to define a new initialization for all data providers of a Web template, you can also convert each data provider specifically and each Web item, using parameterization. By doing this, you allow even your more complicated Web templates to be reused. You can find the description of the necessary parameters under Object Tag for Properties of Web Templates [Seite 125] Swapping two data providers and a Web item when calling up a Web template http://yourAppServer:yourPort/SAP/BW/BEx?CMD=LDOC&TEMPLATE_ID=yourTe mplate&SET_DATA_PROVIDER_1=myDataProvider1&infocube_1=myCube&qu ery_1=myQuery&SET_DATA_PROVIDER_2=myDataProvider2&data_provider_ id_2=mySpecialView&SET_ITEM_3=myItem&ITEM_ID_3=myPieChart Using a standard Web template for a data provider If you call up the previous variant without specifying a TEMPLATE_ID, a standard Web template is used automatically. To make a Web template the standard Web template, go to BW Customizing Implementation Guide → Business Information Warehouse → Settings Relevant for Reporting → Web-Based Settings → Determine a Standard Web Template. If there is no setting made here, the system uses a Web template generated by SAP. You can find more information on the Standard Web Template under Standard Web Template for Ad-hoc Analysis [Extern]. Calling up a query without making any preparations in the Web http://yourAppServer:yourPort/SAP/BW/BEx?CMD=LDOC&infocube=myCube&qu ery=myQuery Web API Reference BW 3.5 152 SAP Online Help 25.02.2005 Calling Parameterized Web Templates Use The URL for calling a Web template is generated by the Web Application Designer. It is possible to copy the URL, and use it again as many times as you like. A typical URL looks like this: http://myAppServer:myPort/SAP/BW/BEx?CMD=LDOC&template_id=yourTemplate The first part of the URL ((http://myAppServer:myPort/SAP/BW/BEx?) calls the BEx service in the SAP Web Application Server in the BW system. The next step is to call the Web template. The command ‘LDOC’ with the parameters 'TEMPLATE_ID' calls the Web template. The command LDOC requests a new HTML page. The Web template is used to construct this HTML page. The Web application corresponding to the Web template is displayed in the Web Browser. You parameterize the Web template by adding further parameters to the URL. These parameters are passed on to all data providers and Web items. Parameterizing the URL allows you to filter all the query views according to a particular country or cost center. Examples Filtering all query views according to Germany http://myAppServer:myPort/SAP/BW/BEx?CMD=LDOC&template_id=yourTemplate&FILTER_IO BJNM=0COUNTRY&FILTER_VALUE=DE Filtering all query views according to Germany, 2000 http://myAppServer:myPort/SAP/BW/BEx?CMD=LDOC&template_id=yourTemplate&FILTER_IO BJNM_1=0COUNTRY&FILTER_VALUE_1=DE&FILTER_IOBJNM_2=0CALYEAR&FILTER_V ALUE_2=2000 Displaying all Web items with title http://myAppServer:myPort/SAP/BW/BEx?CMD=LDOC&template_id=yourTemplate&GENERAT E_CAPTION=X Web API Reference BW 3.5 153 SAP Online Help 25.02.2005 Default Variables for Web Applications Use Variables [Extern] play a central role in BW queries. For example, the entire query or only individual parts of the query can be filtered before reading data according to values. There are variables with automatic substitution, substitution from authorizations, or variables that are ready for input. The variables for Web applications can be processed in the background (without a variable screen) using the parameter VARIABLE_SCREEN=%20 or in the foreground (with a variable screen) using the parameter VARIABLE_SCREEN=X. In both cases, we recommend you specify default variables through parameterization. Therefore, all types of variables that are ready for input are supported. For more information about the VARIABLE_SCREEN, see Object Tag for the Properties of Web Templates [Seite 125]. In contrast to filtering, the external value for specifying default values has to be specified for the variables. The date, for example, is transferred as it has been entered. Features Specifying default variables is achieved by parameterizing the URL. The variable values are separated from each other by different indexes. The index in the parameter is indicated in the following by '_I'. Characteristic Value Variables Parameter variables or variables for several single values are predefined as follows: Parameter Description VAR_NAME_I Technical name of the variables VAR_VALUE_EXT_I Attribute value in external display Key for characteristic value in external display Interval variables are predefined as in the following: Parameter Description VAR_NAME_I Technical name of the variables VAR_VALUE_LOW_EXT_I “From” characteristic value in external display Key for characteristic value in external display VAR_VALUE_HIGH_EXT_I “To” characteristic value in external display Key for characteristic value in external display Selection option variables are predefined as in the following: parameter Description VAR_NAME_I Technical name of the variables Web API Reference BW 3.5 154 SAP Online Help 25.02.2005 VAR_OPERATOR_I An operator 'EQ' = Individual value 'BT' = Interval 'LT' = Less than 'LE' = Less than or equal to 'GT' = Greater than 'GE' = Greater than or equal to VAR_VALUE_LOW_EXT_I “From” characteristic value in external display Key for characteristic value in external display VAR_VALUE_HIGH_EXT_I “To” characteristic value in external display Key for characteristic value in external display This value must only be specified with VAR_OPERATOR='BT'. VAR_SIGN_I Row properties 'I' found values are added, 'E' found values are removed. Variables for precalculated value sets are preassigned as follows: Parameter Description VAR_NAME_I Technical name of the variables VAR_VALUE_EXT_I Name of value set Variables for Single Hierarchy Nodes or Variables for Several Hierarchy Nodes Parameter Description VAR_NAME_I Technical name of the variables VAR_VALUE_EXT_I Node key in external display Key for hierarchy node VAR_NODE_IOBJNM_I Node characteristic name With characteristic nodes and text nodes, you have to specify the characteristic name (0HIER_NODE). Hierarchy, Formula, and Text Variables Parameter Description VAR_NAME_I Technical name of the variables VAR_VALUE_EXT_I Hierarchy name, formula value, text Examples Predefining the parameter variable http://yourAppServer:yourPort/SAP/BW/BEx?CMD=LDOC&template_id=yourTemplate&var_nam e_1=myParameterVariable&var_value_ext_1=4711 Predefining the parameter variable (4711) and select options variable (1, 7 to 12) Web API Reference BW 3.5 155 SAP Online Help 25.02.2005 http://yourAppServer:yourPort/SAP/BW/BEx?CMD=LDOC&template_id=yourTemplate&var_nam e_1=myParameterVariable&var_value_ext_1=4711&var_name_2=mySelOptVar&var_operat or_2=EQ&var_sign_2=I&var_value_low_ext_2=1&var_name_3=mySelOptVar&var_operator _3=BT&var_sign_3=I&var_value_low_ext_3=7&var_value_high_ext_3=12 Predefining hierarchy nodes variable (DE, 0HIER NODE) http://yourAppServer:yourPort/SAP/BW/BEx?CMD=LDOC&template_id=yourTemplate&var_nam e_1=myHryNodeVariable&var_value_ext_1=DE&var_node_iobjnm_1=0HIER_NODE Web API Reference BW 3.5 156 SAP Online Help Web API Reference 25.02.2005 BW 3.5 157 SAP Online Help 25.02.2005 Switching Web Templates Use As well as being able to call up Web templates [Seite 151] you are also able to switch between different Web templates. When you switch to a different Web template, all the Web items and data providers in the Web template in which you started, are retained. The Web items and data providers that appear in the new Web template, and for which there is no object with the same name, are generated from scratch. The system identifies the objects by their logical name. The main difference between calling a Web template and switching to a different Web template is that when you switch to a different Web template, the objects from the initial Web template are transferred without being modified into the new Web report. This means, for example, that the query view of the navigation status stays the same. This function is particularly useful for switching from overview pages (often containing only diagrams) to detailed pages (with tables and navigation blocks). Features CMD CHANGE_TEMPLATE Parameter Description TEMPLATE_ID Name of the Web template Name under which you stored the Web template in the Web Application Designer. The parameters PAGEID and WBID that are used in BW 2.x are supported for the Web templates created under BW 2.x. However, we recommend that you no longer use these. If you still want to set paratmeters for the new Web template, you can use command sequences [Seite 232]. With the parameter APPLY_CMD_ON_TARGET = X, the command sequence can then be used from the newly created page. <SAP_BW_URL CMD='CHANGE_TEMPLATE' TEMPLATE_ID=’DETAILS'> Web API Reference BW 3.5 158 SAP Online Help 25.02.2005 Personalizing Web Templates Use With this command you can personalize a Web template for the user who is logged on. The next time this user calls up the Web template with parameter USE_PERSONALIZATION=X, the navigational state in the personalization template is displayed. This mechanism is especially useful for portal pages. CMD PERSONALIZE Example <SAP_BW_URL CMD='PERSONALIZE'> Removing Personalization You can use this command to reset the Web template personalization for the current user. CMD RESET_PERS Example <SAP_BW_URL CMD='RESET_PERS'> Web API Reference BW 3.5 159 SAP Online Help 25.02.2005 Creating Bookmarks Use Command that allows you to mark a Web application as a bookmark. The result of this instruction is to display a Web application with a bookmark-enabled URL. You can call this URL at any time, which results in a Web application that displays the same navigation status (including whether the hierarchy is expanded) as the Web application from which the instruction was called. CMD BOOKMARK Parameter Description BOOKMARK_DATA Store historical data about the bookmark (optional) The Web application with the historical data is displayed when you call up the bookmark. Bookmarks are normally used without data. 'X' = Yes, ' ' = No Example <SAP_BW_URL CMD='BOOKMARK'> Web API Reference BW 3.5 160 SAP Online Help 25.02.2005 Changing Symbol Directory Use You use this command if you are working on a special Web application, and you want to use symbols other than the symbols that are generally used, for example, for expanding and collapsing hierarchies. The command assigns a different symbol directory to the Web template. The names of the symbols remain unchanged. In the new directory the symbols have to appear with their original names, but you are able to alter them in other ways. Features CMD SET_URLS Parameter Description ICON_PREFIX Relative path to a symbol directory in the MIME repository or on the ITS Example Displaying a Web template using symbols from a different directory http://yourAppServer:yourPort/SAP/BW/BEx?CMD=LDOC&template_id=yourTemplate&cmd_1= cmd%3DSET_URLS%26ICON_PREFIX%3DmyPath A command sequence is used in this example. See also: Command Sequences [Seite 232] Web API Reference BW 3.5 161 SAP Online Help 25.02.2005 Releasing Web Templates Use You use this command to remove the current Web template and all its objects from the memory of the application server. The Web template can no longer be accessed once you have carried out this command. If you want to access the Web template again, you have to use the Call up Web Template [Seite 151] command to recreate it. You can call up other Web templates by using commands in a command sequence. Features CMD PAGE_FREE <SAP_BW_URL CMD='PAGE_FREE'> Web API Reference BW 3.5 162 SAP Online Help 25.02.2005 Ending the Session Use This command closes the current session on the application server. Features CMD LOG_OFF ~command (optional) Delete ITS logon ‘logoff’ = log off from ITS If you transfer this parameter, you need to log on to the system again with your user and password to reconnect. This parameter is only required when accessing via ITS. <SAP_BW_URL CMD='LOG_OFF> <SAP_BW_URL CMD='LOG_OFF' ~command='logoff'> Web API Reference BW 3.5 163 SAP Online Help 25.02.2005 Variables Use With the commands for variables you can call up the variable screen again or change the variable values. For more information, see: Calling the Variable Screen [Seite 165] Changing Variable Values [Seite 166] Default Variables for Web Applications [Seite 154] Web API Reference BW 3.5 164 SAP Online Help 25.02.2005 Calling up the Variables Screen Use This command allows you to call up the variables screen again for the current page. In the variables screen, you are able to change the values of the variables that have been used so far. You can also transfer new values over, as described in Default Variables for Web Applications [Seite 154]. Along with the values already set, these new values are used as the default values in the variables screen. If the variables screen appears when you call up a Web application, you have to adjust the Web template call (see Calling Web Templates [Seite 151]→ Standard Call). You are not able to add filter parameters to the Call Variables Screen command. Features CMD PROCESS_VARIABLES SUBCMD VARIABLE_SCREEN <SAP_BW_URL CMD='PROCESS_VARIABLES' SUBCMD='VARIABLE_SCREEN'> Web API Reference BW 3.5 165 SAP Online Help 25.02.2005 Changing the Values of Variables Use You can use this command to change the values of variables on the current page. Enter the variable values as described in Default Variables for Web Applications [Seite 154]. Variables that you do not specify maintain their previous value. With the Variable Value Change command, you cannot append filter parameters. Features CMD PROCESS_VARIABLES SUBCMD VAR_SUBMIT Example <SAP_BW_URL CMD='PROCESS_VARIABLES' SUBCMD='VAR_SUBMIT' VAR_NAME_1=’myParameterVariable’ VAR_VALUE_EXT_1=’4711’> Web API Reference BW 3.5 166 SAP Online Help 25.02.2005 Calling the Broadcaster Use You can use this command to call the BEx Broadcaster. If nothing else is defined, the standard Web template for broadcasting is called (0BROADCASTING_TEMPLATE). This is set in the Customizing of SAP BW. You can specify your own standard Web template for broadcasting in Customizing under the following path: SAP Customizing Implementation Guide→ SAP NetWeaver → SAP Business Information Warehouse → Reporting-Relevant Settings → BEx Web → Determine Settings for Web Templates Features CMD START_BROADCASTER Parameter Description SOURCE_OBJECT_TYPE (optional) Type of reporting object This parameter establishes the type of reporting object with which the broadcaster is started. The following values are possible: HT: Web template QU: Query WB: Workbook DP: Data provider SOURCE_TEMPLATE (optional) Technical name of the Web template with which the Broadcaster should be started. SOURCE_WORKBOOK (optional) Technical name of the workbook with which the Broadcaster should be started. SOURCE_QUERY (optional) Technical name of the query with which the Broadcaster should be started. SOURCE_DATA_PROVIDER (optional) Logical name of the data provider with which the Broadcaster should be started. START_WIZARD (optional) Using this parameter, you determine whether the Broadcaster should be started as a wizard. X = Yes, ' ' = No The wizard mode is only possible when the source object is known. Web API Reference BW 3.5 167 SAP Online Help 25.02.2005 DISTRIBUTION_TYPE (optional) Presetting of distribution type. In order to be able to work with this parameter, you must start the Broadcaster as a wizard (see the parameter START_WIZARD). The following values are possible: KM_EXPORT: Distribute to Enterprise Portal MAIL: Distribute by e-mail • If the SOURCE_OBJECT_TYPE parameter is not specified, however one of the SOURCE_TEMPLATE, SOURCE_WORKBOOK, SOURCE_QUERY or SOURCE_DATA_PROVIDER parameters is, the type of the reporting object is determined automatically. If the SOURCE_OBJECT_TYPE parameter is specified, it has to match the corresponding reporting object. • Only one of the SOURCE_TEMPLATE, SOURCE_WORKBOOK, SOURCE_QUERY or SOURCE_DATA_PROVIDER parameters may be used. An additional command LAUNCH_BROADCASTER exists for calling the BEx Broadcaster from a running Web application: CMD LAUNCH_BROADCASTER In contrast to the START_BROADCASTER command, the running Web application is automatically distributed when the BEx Broadcaster is called and the current navigation state and stylesheet are transferred. Parameter Description START_WIZARD (optional) Using this parameter, you determine whether the Broadcaster should be started as a wizard. ‘X’ = Yes default setting ‘ ’ = No DISTRIBUTION_TYPE (optional) Presetting of distribution type. In order to be able to work with this parameter, you must start the Broadcaster as a wizard (see the parameter START_WIZARD). The following values are possible: KM_EXPORT: Distribute to Enterprise Portal MAIL: Distribute by e-mail Example Calling the Broadcaster for the DP1 data provider in wizard mode, and for distribution by E-Mail Web API Reference BW 3.5 168 SAP Online Help 25.02.2005 <SAP_BW_URL CMD='START_BROADCASTER ' SOURCE_OBJECT_TYPE=’DP’ SOURCE_DATA_PROVIDER='DP1' START_WIZARD=’X’ DISTRIBUTION_TYPE=’MAIL’> Web API Reference BW 3.5 169 SAP Online Help 25.02.2005 Calling the Open Dialog Use You can use this command to call an open dialog for queries or query views. You can then determine follow-up actions. Prerequisites In order to use this command you have to register the help service to a Web item. The following additional attributes have to be added to a Web item in the HTML view in the Web Application Designer: Attribute Description HELP_SERVICE Name of the help service: HW_OPEN_DIALOG HELP_SERVICE_CLASS Technical name of the help service class: CL_RSR_WWW_HWIND_OPEN_DIALOG Features Command structure CMD Process_help_window Parameter Description HELP_SERVICE Name of the help service: HW_OPEN_DIALOG ITEM Logical name of the Web item with which you have registered the help service. SUBCMD Subcommand: SELECTION OBJECT_TYPE Type of reporting object: QU: query; VW: query view SUBMIT_PARAMETER Command that is to be executed after successful object selection. Parameters DATA_PROVIDER_ID or QUERY and INFOCUBE are added to this command. Example Call open dialog for queries and reinitialize DATAPROVIDER_1 with the selected query <SAP_BW_URL cmd='PROCESS_HELP_WINDOW' HELP_SERVICE='HW_OPEN_DIALOG' item='WEB_ITEM_1' subcmd='SELECTION' object_type='QU' SUBMIT_PARAMETER='CMD=RESET_DATA_PROVIDER&DATA_PROVIDER=DATAPROVID ER_1'> Web API Reference BW 3.5 170 SAP Online Help Web API Reference 25.02.2005 BW 3.5 171 SAP Online Help 25.02.2005 Data Provider - Commands Definition Commands It is possible to apply commands, such as filters, to data providers. In most cases, you must specify parameters for these commands. Some commands allow you to specify a list of parameter values. The parameter name is given an index “_1”, “_2”, ... This is shown in the following with “Parametername_N”. There is at least one example given for every command. This is displayed in the same syntax as described under Command URLs [Seite 145]. All commands have the following parameters in common: Parameter Description CMD Name of the command Most commands are triggered by this parameter. As well as this type of command, there are also generic commands with parameters that you are able to assign to other commands. Generic commands are always applied after the named command. DATA_PROVIDER DATA_PROVIDER_N Name of the data provider You are able to apply a command to several data providers. You either specify a particular data provider, or display a list of possible data providers, or restrict the number of data providers by using wildcards (MULTI=‘X’). The command is applied to all these data providers, as long as they support this action. You must specify the data provider(s). Using the DATA_PROVIDER as a reference If MULTI is set to ‘X’, the command is applied to all the data providers that have ‘DATA_PROVIDER’ in their name. ‘*’ means all data providers, for example. The parameter has to be set to ‘X’ if several data providers are specified in the form DATA_PROVIDER_N. MULTI This parameter is optional. ‘X’ = Yes, ‘ ’ = No • Web API Reference For some data provider commands you have to specify the 25-character UIDs for structures or their elements. This can be specified as follows: BW 3.5 172 SAP Online Help 25.02.2005 In the Web application designer, drag the Web item Dropdown Box into your Web template. Assign the desired data provider to the Web item. Under the attribute Characteristic/Structure for the Web item Dropdown Box, select the respective structure. Here you can see the UID. If you execute the Web template, you can copy this UID from the HTML code. To do this, find the input tag with the name FILTER_IOBJNM_1; the UID is in the attribute ‘value’. For the individual structure items, you find the UID in the ‘value’ attribute for the respective option tags. • Since the commands for variables technically belong to the Web templates and not to the data providers, you can also find the commands for variables under the commands for Web templates. See Variables [Seite 164]. Example Applying the command to the data provider ‘DP 1’ <SAP_BW_URL DATA_PROVIDER='DP 1' CMD='...' ...> Applying the command to the data providers ’DP 1’ and ’DP 2’ <SAP_BW_URL DATA_PROVIDER_1='DP 1' DATA_PROVIDER_2='DP 2' MULTI='X' CMD='...' ...> Applying the command to all the data providers that contain ‘USA’ in their name <SAP_BW_URL DATA_PROVIDER='*USA*' MULTI='X' CMD='...' ...> Web API Reference BW 3.5 173 SAP Online Help 25.02.2005 General Data Provider Commands Use General data provider commands include: Properties of Data Providers [Seite 175] Resetting and Reinitializing Data Providers [Seite 177] Back and Back to Start [Seite 179] Jumping using the Report-Report Interface [Seite 180] Exporting Data [Seite 181] Saving Query Views [Seite 182] Displaying a Copy of the Data Provider on a New Page [Seite 183] Web API Reference BW 3.5 174 SAP Online Help 25.02.2005 Properties of Data Providers Definition Command for a data provider. Use A data provider has a great variety of properties. You can change the properties by specifying the parameter and its value. Therefore, you do not have to specify parameter 'CMD'. The data provider properties are evaluated after the command processing has ended. Structure Parameter Description ZERO_SUPPRESSION Hide zeros which occur in the inner or outer rows and columns of a cross-classified table. A cross-classified table contains characteristics in both the rows and columns. Example of a cross-classified table: You create a query in which you analyze the net revenue of your products in relation to your customers. The Product characteristic is located in the rows and the Customer characteristic and the key figure Net Revenue 2004 are located in the columns. See also the table below on Zero Suppression for Structures. For more information, see Zero Row and Zero Column Suppression [Extern]. ' ' = do not hide any zeros 'X' = hide overall results columns and rows which contain zero values '1' = only hide columns which have zeros in the cross-classified table '2' = only hide overall results columns which contain zeros '3' = only hide rows which have zeros in the cross-classified table '4' = only hide rows and columns which have zeros in the cross-classified table '6' = only hide overall results rows which contain zeros ZERO_PRESENTATION Zero value display '0' = display '1' = display without currency/unit '2' = do not display '3' = display zero text ZERO_TEXT Text for zero value display '3' SHOW_SCALING_FACTORS Display scaling factors and exclude currency / unit 'X' = Yes, ' ' = No SIGN_PRESENTATION +/- sign display '1' = sign before number '2' = sign after number '3' = concatenated display Web API Reference BW 3.5 175 SAP Online Help FULL_CONCAT_KEYS 'X' = Yes, ' ' = No SHOW_DOCUMENTS 'X' = Yes, ' ' = No SHOW_DR_LINKS 25.02.2005 Display of characteristic and attribute keys fully concatenated Show document links for each characteristic variant Show Drag&Relate master data 'X' = Yes, ' ' = No UHRY_ACTIVE_ROWS Display rows as hierarchy 'X' = Yes, ' ' = No UHRY_CAPTION_ROWS Labeling for rows for hierarchical display UHRY_LEVEL_ROWS Number of objects (characteristics, hierarchies, structures) on the rows that are initially visible as hierarchy when display is switched on. UHRY_ACTIVE_COLUMNS Display columns as hierarchy 'X' = Yes, ' ' = No UHRY_CAPTION_COLUMNS Labeling for columns for hierarchical display UHRY_LEVEL_COLUMNS Number of objects (characteristics, hierarchies, structures) on the columns that are initially visible as hierarchy when display is switched on. Zero Suppression for Structures Parameter Description SUPPRESSION The structure is included In the zero suppression. 'X' = Yes, ' ' = No STRUCTURE_NAME Technical name of structure (UID) In order to use zero suppression for structures, both parameters have to be specified. <sap_bw_url data_provider='*' multi='X' structure_name='DTG057U7OQ8K2ALKCMR2AWM14' suppression=’X’> <sap_bw_url data_provider='*' multi='X' structure_name_1='DTG057U7OQ8K2ALKCMR2AWM14' suppression_1=’X’ suppression_2=’ ‘ structure_name_2=’ EFG057U7OQ8K2JKKCMR2AWM67’> Integration The data provider properties can be added to every other command. Web API Reference BW 3.5 176 SAP Online Help 25.02.2005 Resetting and Reinitializing Data Providers Use You use this command to reinitialize existing data providers [Seite 172] of the query or query view type. The data provider is recreated according to the parameters. The corresponding Web items display the data for the new data providers [Seite 142]. If you are using a Web item that requires, for example, a specific characteristic (such as filter dropdown box [Seite 24] ), you need to make sure that the new data provider also supports this characteristic. Features CMD RESET_DATA_PROVIDER Parameter Description INFOCUBE Technical name of the InfoCube QUERY Technical name of the query VARIANT (optional) Variants, if you are required to enter a variable RRI (optional) The report-report interface is used to convert the data provider. Jump targets by report-report interface do not have to be maintained for this purpose. ‘X’ = Yes, ‘ ’ = No or CMD RESET_DATA_PROVIDER Parameter Description DATA_PROVIDER_ID Technical name of the view VARIANT (optional) Variants, if you are required to enter a variable RRI (optional) The report-report interface is used to convert the data provider. Jump targets by report-report interface do not have to be maintained for this purpose. ‘X’ = Yes, ‘ ’ = No Converting the ‘View1’ data provider to another query: <SAP_BW_URL DATA_PROVIDER='View1' CMD='RESET_DATA_PROVIDER' INFOCUBE='myCube' QUERY='myQuery'> Converting the ‘View1’ data provider to a saved view: <SAP_BW_URL DATA_PROVIDER='View1' CMD='RESET_DATA_PROVIDER' DATA_PROVIDER_ID='myViewID'> Web API Reference BW 3.5 177 SAP Online Help 25.02.2005 Converting the ‘View 1’ data provider to a saved view with transfer of filters and variable values: <SAP_BW_URL_DATA_PROVIDER=’View1’ CMD=’RESET_DATA_PROVIDER’ DATA_PROVIDER_ID=’myViewID’ RRI=’X’> Web API Reference BW 3.5 178 SAP Online Help 25.02.2005 Back and Back to Start Definition Back and Back to Start is a command for a data provider in the Web template. Use With the help of this command, you can perform the following functions for a data provider: • undo the last action • undo all actions In contrast to using the Back function in the Web browser, these commands only affect the specified data provider and not the entire page. Structure CMD Description BACK Undoes the last action executed for this data provider. RESET Goes back to the navigation status that was visible when the Web application was called The last action for data provider ‘View 1’ is to be undone <SAP_BW_URL DATA_PROVIDER='View1' CMD='BACK'> All query views are to be reset to the status that was set when they were called up <SAP_BW_URL DATA_PROVIDER='*' MULTI='X' CMD='RESET'> Web API Reference BW 3.5 179 SAP Online Help 25.02.2005 Jumping Using Report-Report Interface Definition Command for a data provider. Use You can use this command to execute a report-to-report jump. You can jump from one Web template to another Web template, to another query, or to a transaction in an R/3 system and much more. Structure CMD RRI Parameter Description RRI_RECEIVER RRI Recipient ID You can determine this ID in the Maintain Sender Receiver Assignment screen in the BW system (choose SAP Menu → Business Explorer → Query → Jump Targets in the SAP Easy Access Menu of the BW system). DATA_ROW (optional) DATA_COLUMN (optional) IOBJNM (optional) Data row Context from which jump is made Data column Context from which jump is made A characteristic Context from which jump is made Example Jump to QURY0001 <SAP_BW_URL DATA_PROVIDER='View1' CMD='RRI' RRI_RECEIVER='QURY0001'> See also: Report-Report Interface [Extern] Editing Sender/Receiver Assignments to the R/RI in BW [Extern] Web API Reference BW 3.5 180 SAP Online Help 25.02.2005 Exporting Data Definition Command for a data provider. Use You can export the data of a data provider to a CSV or MS Excel 2000 file or an XML file with this instruction. Structure CMD EXPORT Parameter Description FORMAT Format 'CSV' = CSV file 'XLS' = MS Excel 2000 file 'XML' = XML file REDIRECT_URL (optional) This parameter is optional for use fort he XML format: The generated XML can be automatically forwarded to antoher service as a form field if this address is specified as the REDIRECT_URL when the export command“is called. This enhancement is especially useful for integration scenarios in which postprocessing of query data should occur in another service. Notes about the XML format The XML scheme is equivalent to data description in the Table Interface [Seite 281] of the Web API reference. You can find more information under Web Service for Access to Query Data [Extern]. Example Exporting data to MS Excel 2000 <SAP_BW_URL DATA_PROVIDER='View1' CMD='EXPORT' FORMAT='XLS'> Web API Reference BW 3.5 181 SAP Online Help 25.02.2005 Saving the Query View Definition Command for a data provider. Use You use this command to save a data provider as a reusable object (query view). Structure CMD SAVE_VIEW Parameter Description TECH_NAME Technical name of the view DESCRIPTION Description OVERWRITE Overwrite existing view 'X' = Yes, ' ' = No Web API Reference BW 3.5 182 SAP Online Help 25.02.2005 Displaying a Copy of the Data Provider on a New Page Use This command enables you to display a copy of the current navigation status of a data provider [Seite 172] on a new page. This command is suitable for detailed windows, in which you navigate independently of the overview window (see example). Features CMD RELEASE_DATA_PROVIDER Parameter Description TEMPLATE_ID (optional) Name of the Web template Name under which you stored the Web template in the Web Application Designer. If the parameter is not specified, the standard Web template is used. Any other parameters for parameterizing your Web template See Object Tag for Properties of Web Templates [Seite 125]. Displaying a copy of the status of the “View 1” data provider on a new page: <SAP_BW_URL DATA_PROVIDER='View1' CMD='RELEASE_DATA_PROVIDER'> Displaying a copy of the status of the “View 1”data provider in a new window with template 1: JavaScript call: SAPBWOpenWindow("<SAP_BW_URL DATA_PROVIDER='View1' CMD='RELEASE_DATA_PROVIDER'>","Details",600,400); If you still want to set parameters for the new page, you can use command sequences [Seite 232]. With the parameter APPLY_CMD_ON TARGET = X, the command sequence can then be used from the newly created page. Web API Reference BW 3.5 183 SAP Online Help 25.02.2005 Calling the Ad-hoc Query Designer Use With this command, you can call the Ad-hoc Query Designer for a data provider in its own window (Web Template). If the data provider has already been installed, the query it is based on is transferred to the Ad-hoc Query Designer. Otherwise the Ad-hoc Query Designer is started initially. When closing the Ad-hoc Query Designer, the data provider with the associated query is reinitialized. To execute a command, you need a Web template as a target template that contains the Web item Ad-hoc Query Designer. An example of the construction of a target template is Web template 0ADHOC_QUERYDESIGN. Features CMD LAUNCH_QUERY_DESIGNER Parameter Description TEMPLATE_ID Technical name of the Web template that contains the Web item Ad-hoc Query Designer. Example Calling the Ad-hoc Query Designer for the Data Provider 'DP1' <SAP_BW_URL DATA_PROVIDER='DP1' CMD='LAUNCH_QUERY_DESIGNER' TEMPLATE_ID=’0ADHOC_QUERYDESIGN’> Web API Reference BW 3.5 184 SAP Online Help 25.02.2005 Filter Definition Filter is a command for a data provider in the Web template. Use Filter values can be set for characteristics and structures for a data provider. When calling the command you can set several filters for the same characteristic/structure, or the same filter for several different characteristics/structures. Filter is a generic command, which means you do not have to set the ‘CMD’ parameter. The filter parameters can be added to any command, with the exception of calling the variable screen [Seite 165] and changing the values of variables [Seite 166]. The actual filtering process is carried out at the end of the operation. In the internal display (see table below) you can easily determine the name of the characteristic and the filter value using the URL parameter &snippet_operations=%20 (see also Object Tag for the Properties of Web Templates [Seite 125]). Call the Web application with this URL parameter. If you filter using the context menu, the parameters FILTER_IOBJNM and FILTER_VALUE are automatically added to the URL in the Web browser. You can then use the desired values with Command URLs [Seite 145] in hyperlinks. Structure Parameter Description FILTER_IOBJNM Name of the characteristic / structure by which the system is to filter FILTER_IOBJNM_N (optional) FILTER_COLLAPSE (optional) ‘X’ = Yes, ‘ ’ = No Web API Reference Specify the technical name of the characteristic (for example, 0COUNTRY) or the structure (25 characters) Removing filter characteristics from the drilldown The characteristics that are specified under FILTER_IOBJNM are taken from the axes after the filter has been applied. If you do not specify the parameters, the system assumes you want to use the value ‘X’ = Yes. BW 3.5 185 SAP Online Help FILTER _SIGN_N (optional) 25.02.2005 Row properties 'I' found values are added, 'E' found values are removed. If the parameter is not specified, then the system assumes you want to use the value 'I'. If FILTER_IOBJNM_N is not specified for index n, the value from FILTER_IOBJNM is used, if available. For filtering individual values, the following parameters are also specified: Parameter Description FILTER_VALUE Filter Value Value, by which the system is to filter. FILTER_VALUE_N FILTER_VALUE_EXT FILTER_VALUE_EXT_N If the variant with ending 'EXT' is selected, the fully compounded value has to be entered in the external format, for example, 24.12.2000. If the ending 'EXT' is not used, the fully compounded value has to be entered in the internal format, for example, 20001224 for 24.12.2000. FILTER_VALUE_TYPE (optional) FILTER_VALUE_TYPE_N (optional) FILTER_OPERATOR (optional) FILTER_OPERATOR_N (optional) Type of value specified under FILTER_VALUE ‘VALUE’ : Characteristic value key 'VARIABLE_EXIT' : Exit variable name. The filter is set using the values returned by the variable exit. Parameter, interval, and selection option variables are allowed for customer and SAP exit variables, as well as for default values. An operator 'EQ' = Individual value 'LT' = Less than 'LE' = Less than or equal to 'GT' = Greater than 'GE' = Greater than or equal to If no operator is specified, then the system assumes you want to use the value 'EQ'. Web API Reference BW 3.5 186 SAP Online Help 25.02.2005 The following parameters are also accepted for filtering intervals: Parameter Description FILTER_VALUE_LOW Filter value – lower limit (not compounded) FILTER_VALUE_LOW_N FILTER_VALUE_LOW_EXT FILTER_VALUE_LOW_EXT_N Filter value – upper limit (not compounded) FILTER_VALUE_HIGH FILTER_VALUE_HIGH_N FILTER_VALUE_HIGH_EXT FILTER_VALUE_HIGH_EXT_N The following parameters are also accepted for filtering hierarchy nodes: parameter Description FILTER_VALUE Hierarchy node name FILTER_VALUE_N Node characteristic name This parameter must be specified if the system filters by hierarchy nodes. The characteristic name has to be specified for characteristic nodes and for text nodes (0HIER_NODE). FILTER_NODE_IOBJNM (optional) FILTER_NODE_IOBJNM_N (optional) Examples Filter Data Provider ’View1’ by Country: Germany <SAP_BW_URL DATA_PROVIDER='View1' FILTER_IOBJNM='0COUNTRY' FILTER_VALUE='DE'> Filter Data Provider ’View1’ by First 3 Months <SAP_BW_URL DATA_PROVIDER='View1' FILTER_IOBJNM='0CALMONTH' FILTER_VALUE_LOW_EXT='1' FILTER_VALUE_HIGH_EXT='3'> Filter All Data Providers by Costs and Countries: Germany and USA <SAP_BW_URL DATA_PROVIDER='*' MULTI='X' FILTER_IOBJNM_1='DRB9ZVVMBCHVX4F04Z1JGKYVC' FILTER_VALUE_1='DTG057U7OQ8K2ALKCMR2AWM14' FILTER_IOBJNM_2='0COUNTRY' FILTER_VALUE_2='DE' FILTER_IOBJNM_3='0COUNTRY' FILTER_VALUE_3='US'> Filter All Data Providers by Current Month <SAP_BW_URL DATA_PROVIDER='*' MULTI='X' FILTER_IOBJNM='0CALMONTH' FILTER_VALUE='0CMONTH' FILTER_VALUE_TYPE='VARIABLE_EXIT'> Web API Reference BW 3.5 187 SAP Online Help 25.02.2005 Removing Filters Definition Remove Filter is a command for a data provider in the Web template. Use You use this command to remove the filter from a characteristic or a structure for one or more data providers. Structure CMD Remove_Filter Parameter Description IOBJNM Name of the characteristic/structure IOBJNM_N Specify here the technical name of the characteristic (0COUNTRY, for example) or structure (25 characters) from which you want to delete the filter. It is also possible to specify a list of characteristics/structures. ALL Remove all filters 'X' = Yes, ' ' = No Alternatively to listing characteristics and structures, you can remove all filters. Examples Remove filter by country for data provider ‘View1’ <SAP_BW_URL DATA_PROVIDER='View1' CMD='Remove_Filter' IOBJNM='0COUNTRY' > Remove filter for country from all data providers and filter according to calendar year 2000: <SAP_BW_URL DATA_PROVIDER='*' MULTI='X' CMD='Remove_Filter' IOBJNM='0COUNTRY' FILTER_IOBJNM='0CALYEAR' FILTER_VALUE='2000'> Remove all filters by country from data providers and filter according to calendar year 2000 <SAP_BW_URL DATA_PROVIDER='*' MULTI='X' CMD='Remove_Filter' ALL='X' FILTER_IOBJNM='0CALYEAR' FILTER_VALUE='2000'> Web API Reference BW 3.5 188 SAP Online Help 25.02.2005 Drilldown Definition Drilldown is a command for a data provider in the Web template. Use Use this command to change the position of a characteristic or a structure for one or more data providers. Structure CMD Expand Parameter Description IOBJNM Name of the characteristic/structure Specify the technical name of the characteristic here (for example, 0COUNTRY) or the structure (25-place character sequence that you want to bring into the drilldown. Axis on which the characteristic/structure is to be based AXIS (optional) ‘X’ = columns If the PARENT_IOBJNM parameter is not specified, the characteristic/structure is brought onto the axis behind the other characteristics/structures. If you do not specify the parameter AXIS, the value ‘Y’ is used for characteristics, and ‘X’ for structures. ‘Y’ = rows ’ ’ = Free characteristics (=remove drilldown) PARENT_IOBJNM (optional) Name of a characteristic/structure on the axis Specify this parameter to move a characteristic/structure behind another one on an axis. Examples Drilldown data provider, ‘View1’ by country <SAP_BW_URL DATA_PROVIDER='View1' CMD='Expand' IOBJNM='0COUNTRY' > Drilldown data provider view1 according to country and filter according to calendar year 2000 <SAP_BW_URL DATA_PROVIDER='View1' CMD='Expand' IOBJNM='0COUNTRY' FILTER_IOBJNM='0CALYEAR' FILTER_VALUE='2000'> Drag periods 1, 2, and 3 (2000) from data provider ‘View1’ to the columns <SAP_BW_URL DATA_PROVIDER='View1' CMD='Expand' IOBJNM='0FISCPER' AXIS='X' FILTER_IOBJNM='0FISCPER' FILTER_VALUE_1='2000001' FILTER_VALUE_2='2000002' FILTER_VALUE_3='2000003'> Web API Reference BW 3.5 189 SAP Online Help 25.02.2005 Remove Drilldown Definition Remove Drilldown is a command for a data provider in the Web template. Use Use this command to remove a characteristic or a structure from the drilldown for one or more data providers. This command is the same as the command Drilldown [Seite 189] if the parameter AXIS=’ ‘ is set. Structure CMD Collapse Parameter Description IOBJNM Name of the characteristic/structure Specify the technical name of the characteristic here (for example, 0COUNTRY) or the structure (25-place character sequence) that you want to remove from the drilldown. Example Remove drilldown by country for data provider ‘View1’ <SAP_BW_URL DATA_PROVIDER='View1' CMD='Collapse' IOBJNM='0COUNTRY'> Web API Reference BW 3.5 190 SAP Online Help 25.02.2005 Switching Characteristics/Structures Definition Swap characteristics/structures is a command for a DataProvider in the Web template. Use Calling up this command allows you to switch characteristics/structures for one or more DataProviders. Structure CMD Exchange Parameter Description IOBJNM_1 Name of characteristic/structure Specify the technical name of the 1st characteristic (0COUNTRY, for example) or the 1st structure (25 characters) here. IOBJNM_2 Name of characteristic/structure Specify the technical name of the 2nd characteristic (0COUNTRY, for example) or the 2nd structure (25 characters) here. Example Replace drilldown by country with drilldown by calendar year in DataProvider ‘View1’ <SAP_BW_URL DATA_PROVIDER=’View 1’ CMD=’Exchange’ IOBJNM_1=’0COUNTRY’ IOBJNM_2=’0CALYEAR’> or <SAP_BW_URL DATA_PROVIDER=’View 1’ CMD=’Exchange’ IOBJNM_1=’0CALYEAR’ IOBJNM_2=’0COUNTRY’> Web API Reference BW 3.5 191 SAP Online Help 25.02.2005 Swap Axes Definition Swap Axes is a command for a DataProvider in the Web template. Use This command switches the roles of the axes (the list is reversed). All the characteristics and structures in the rows are moved into the columns, and all the characteristics and structures in the columns are moved into the rows. Structure CMD Switch_Axes Swap axes for DataProvider ‘View1’ <SAP_BW_URL DATA_PROVIDER='View 1' CMD='SWITCH_AXIS'> Web API Reference BW 3.5 192 SAP Online Help 25.02.2005 Setting the Navigational Status Definition Set Navigation Status is a command for a Data Provider in the Web Template. Use By calling up this command, you can restructure or redistribute characteristics and structures on the axes. Structure CMD SET_NAV_STATE Parameter Description ALL Redistribute all characteristics and structures 'X' = Yes, ' ' = No If this parameter is set to ‘X’, then all characteristics and structures are taken from the axes and redistributed according to the other parameters. If the parameter is not set or is set to ‘ ‘, then the listed characteristics are assigned according to the parameters on the axes. IOBJNM Name of the characteristic/structure IOBJNM_N Specify here the technical name of the characteristic (such as 0COUNTRY) / structure (25 character string) that you want to place on the axis. AXIS Axis on which the characteristic/structure is to be based AXIS_N ‘X’ = columns ‘Y’ = rows The characteristic or structure is based on the axis. The parameter POSITION determines its position on the axis. ' ' = free characteristics POSITION Position on an axis POSITION_N By specifying the position, the characteristic or structure is set for this position on the axis. If the position is not specified or set to ‘0’, the characteristic/structure is placed at the end of the drilldown sequence. Web API Reference BW 3.5 193 SAP Online Help 25.02.2005 Moving the key figure structure to the rows and removing the calendar year and planned/actual structure from the columns <SAP_BW_URL DATA_PROVIDER='View1' CMD='SET_NAV_STATE' ALL='X' IOBJNM_1='DTG057U7OQ8K2ALKCMR2AWM14' AXIS_1='Y' IOBJNM_2='0CALYEAR' POSITION_2='1' AXIS_2='X' IOBJNM_3='EFG057U7OQ8K2JKKCMR2AWM67' POSITION_3='2' AXIS_3='X'> Make sure that the cost centers are in drilldown for all DataProviders and not the materials <SAP_BW_URL DATA_PROVIDER='*' MULTI='X' CMD='SET_NAV_STATE' IOBJNM_1='0COSTCENTER' AXIS_1='Y' IOBJNM_2='0MATERIAL' AXIS_2=' '> Web API Reference BW 3.5 194 SAP Online Help 25.02.2005 Sorting Definition Sort is a command for a DataProvider in the Web template. Use You use this command to sort according to characteristics or values, depending on parameterization. Structure CMD Sort Parameter Description SORT_TYPE Type of sort 'K' = Key Characteristics can be sorted by key, by name or by hierarchy (if a display hierarchy is active for the characteristic). Or they can be sorted according to a selection (providing that there is a restriction on several single values in the query definition or dynamically on the DataProvider. You can also sort according to values. 'T' = Text 'H' = Hierarchy 'S' = Selection 'W' = Value SORT_DIRECTION Required sort direction 'A' = Ascending 'D' = Descending IOBJNM The sort direction for sort_type=H is always 'A'. Characteristic that you want to sort Only for sorting characteristics. STRUCTURE_MEMBER_1 Only for sorting according to value. STRUCTURE_MEMBER_2 Only for sorting according to value. Web API Reference This parameter is omitted when you are sorting according to values. Structural component of the first structure If the system sorts by a value, the value cell must be set precisely. To do this, you have to specify the components of the structure (25character string) for all the occurring structures (maximum 2). Component of the second structure If 2 structures are defined in the query, the structural component of the second structure must also be specified. BW 3.5 195 SAP Online Help 25.02.2005 Sort customers for DataProvider ‘View1’ by Text in ascending order <SAP_BW_URL DATA_PROVIDER='View1' CMD='SORT' IOBJNM='0CUSTOMER' SORT_TYPE='T' SORT_DIRECTION='A'> Sorting List According to Actual Sales, in Descending Order <SAP_BW_URL DATA_PROVIDER='View 1' CMD='SORT' SORT_TYPE='V' SORT_DIRECTION='D' STRUCTURE_MEMBER_1='DTG057U7OQ8K2ALKCMR2AWM14' STRUCTURE_MEMBER_2='EFG057U7OQ8K2JKKCMR2AWM67'> Web API Reference BW 3.5 196 SAP Online Help 25.02.2005 Setting Properties of Display Attributes Definition Command for a data provider. Use You can change the properties of display attributes with this command. Structure CMD SET_ATTRIBUTE Parameter Description IOBJNM Name of characteristic Specify the technical name of the characteristic (0COUNTRY, for example) to which the attribute belongs here. ATTRINM Name of the attribute Define the technical name of the display attribute here. ACTIVE Display attribute 'X' = Yes, ' ' = No POSITION Position of the attribute within the attribute PRESENTATION Layout 'KEY' = key 'TEXT' = shortest text 'TEXT_MD' = middle-length text 'TEXT_LG' = long text 'KEY_TEXT' = key and text 'TEXT_KEY' = text and key Web API Reference BW 3.5 197 SAP Online Help 25.02.2005 Results Row Position Definition Command for a data provider. Use You can define the position of the results row with this command. Hierarchy nodes are also based on this setting if there are other objects with competing settings on the hierarchy axis. Structure Results Position CMD SET_RESULT_POSITION Parameter Description AXIS Axis on which the result position should be set ‘X’ = columns ‘Y’ = rows RESULT_POSITION Results Position 'TOP' = Top/left 'BOTTOM' = Bottom/right Hierarchy Node Position CMD SET_RESULT_POSITION Parameter Description IOBJNM Name of characteristic Enter the technical name of the characteristic on which the hierarchy node position should be defined here. RESULT_POSITION Node position 'TOP' = Top (left) The information in brackets represent what happens if the characteristic is on the columns. 'BOTTOM' = Bottom (right) Web API Reference BW 3.5 198 SAP Online Help 25.02.2005 Suppressing Result Rows Definition Command for a data provider. Use You can suppress results row with this command. Structure CMD SET_SUPPRESSION Parameter Description IOBJNM Name of characteristic Define the technical name of the characteristic (e.g. 0COUNTRY) here. RESULT_SUPPRESSION Suppression method 'NEVER' = No suppression 'CONDITIONAL' = Conditional suppression 'ALWAYS' = Always suppress Web API Reference BW 3.5 199 SAP Online Help 25.02.2005 Setting the Display Definition Command for a data provider. Use You can change the display of characteristics, hierarchy node types and attributes with this command. Structure CMD SET_PRESENTATION Parameter Description IOBJNM Name of characteristic Define the technical name of the characteristic (e.g. 0COUNTRY) here. NODE_IOBJNM (Option 1) Node characteristic name With characteristic nodes and text nodes, you have to specify the characteristic name (0HIER_NODE). ATTRINM (Option 2) Name of the attribute Define the technical name of the display attribute here. PRESENTATION Layout 'NONE' = No display (only for characteristics) 'KEY' = key 'TEXT' = shortest text 'TEXT_MD' = middle-length text 'TEXT_LG' = long text 'KEY_TEXT' = key and text 'TEXT_KEY' = text and key 'KEY_TEXT' = Key and medium text 'KEY_TEXT' = Key and long text For data provider DATAPROVIDER_1, set the display of the InfoObject 0CUSTOMER to key and text <SAP_BW_URL DATA_PROVIDER='DATAPROVIDER_1' CMD='SET_PRESENTATION' IOBJNM='0Customer' PRESENTATION='KEY_TEXT'> Web API Reference BW 3.5 200 SAP Online Help 25.02.2005 Displaying Documents Definition Command for a data provider. Use You can call the document display for the selected context with this command. Structure You can access four different contexts: CMD DOCUMENTS Parameter Description NAVIGATIONAL_STATE (Option 1) Documents for the current navigation status 'X' = Yes, ' ' = No DATA_ROW (Option 2) Documents for a data cell: Y coordinate Coordinates in the data block DATA_COLUMN (Option 2) Documents for a data cell: X coordinate Coordinates in the data block IOBJNM (Option 3) Documents for a characteristic IOBJNM (Option 4) Documents for a characteristic value: characteristic VALUE (Option 4) Documents for a characteristic value: key Characteristic value in internal representation (without conversion exit) Web API Reference BW 3.5 201 SAP Online Help 25.02.2005 Dialogs Use With the commands for dialogs, you can call up the respective dialogs in order to make settings there. You can find the descriptions for individual dialogs in Web applications under Analysis & Reporting: BEx Web Applications [Extern]. For more information on the individual commands for dialogs, see Calling the Query Properties Dialog Box [Seite 203] Calling the Dialog Box for Defining Formulas [Seite 204] Calling up Input Help [Seite 205] Calling the Dialog Box for Properties of Characteristics [Seite 206] Calling the Currency Translation Dialog Box [Seite 207] Calling the Dialog Box for Defining Exceptions [Seite 208] Calling the Dialog Box for Defining Conditions [Seite 209] Calling the Dialog Box for Cell Properties [Seite 210] Saving the Dialog Query View [Seite 211] Under Creating Your Own Dialogs [Seite 213] you can find information on how you can implement your own dialogs using an ABAP class. Web API Reference BW 3.5 202 SAP Online Help 25.02.2005 Calling Dialog Query Properties Definition Command for a data provider. Use You can call the Query Properties dialog with this instruction. Structure CMD Process_help_window Parameter Description HELP_SERVICE Name of the help service: QUERY_PROPERTIES Web API Reference BW 3.5 203 SAP Online Help 25.02.2005 Calling Up Dialog Box for Formula Definition Definition Command for a data provider. Use You can use this command to call up a dialog box for defining a new or an existing formula. Structure CMD Process_help_window Parameter Description HELP_SERVICE Name of the help service: DP_VIEW_SET_CALC_MEMBER SUBCMD NEW FORMULA_STRUCTURE Technical name of structure CMD Process_help_window Parameter Description HELP_SERVICE Name of the help service: DP_VIEW_SET_CALC_MEMBER SUBCMD CHANGE FORMULA_ID Technical name of formula Web API Reference BW 3.5 204 SAP Online Help 25.02.2005 Calling up Input Help Definition Calling Value Help is a command for a data provider in the Web template. Use With the help of this command, you can call up input help for a characteristic or a structure of a data provider. Structure CMD Process_help_window Parameter Description HELP_SERVICE Name of the help service: DP_VIEW_FILTER IOBJNM Name of the characteristic/structure Specify the technical name of the characteristic here (for example, 0COUNTRY) or the structure (25-place character sequence) for which you want to call value help. BOOKED_VALUES Using posted values for value help If this parameter is not specified or is not set to ‘X’, only values are displayed in the input help that are also booked in the InfoProvider within the scope of the currently valid filter conditions. It can take a long time under certain circumstances. If the parameter is set to ' ', all dimension table values are displayed. This can be quicker, but can also display values that do not appear in the InfoProvider under the current filter conditions and when filtering can give the result No corresponding data found. Web API Reference BW 3.5 205 SAP Online Help 25.02.2005 Calling the Characteristic Properties Dialog Definition Command for a data provider. Use You can call the Characteristic Properties dialog with this command. Structure CMD Process_help_window Parameter Description HELP_SERVICE Name of the help service: CHAR_PROPERTIES IOBJNM Name of characteristic Define the technical name of the characteristic (e.g. 0COUNTRY) here. Web API Reference BW 3.5 206 SAP Online Help 25.02.2005 Calling a Dialog for Currency Translation Definition Command for a data provider. Use You can call the dialog for currency translation with this command. Structure CMD Process_help_window HELP_SERVICE CURRENCY_CONVERSION Web API Reference BW 3.5 207 SAP Online Help 25.02.2005 Calling a Dialog for Defining Exceptions Definition Command for a data provider. Use You can call the dialog for defining exceptions with this command. Structure CMD Process_help_window Parameter Description HELP_SERVICE Name of the help service: EXCEPTION_DEFINITION EXCEPTION_ID Name of exception Enter the technical name of the exception here if you want to change an existing exception. If no value is defined for this parameter, a new exception will be created. Web API Reference BW 3.5 208 SAP Online Help 25.02.2005 Calling a Dialog for Defining Conditions Definition Command for a data provider. Use You can call the dialog for defining conditions with this command. Structure CMD Process_help_window Parameter Description HELP_SERVICE Name of the help service: CONDITION_DEFINITION CONDITION_ID Name of the condition Enter the technical name of the condition here if you want to change an existing condition. If no value is defined for this parameter, a new condition will be created. Web API Reference BW 3.5 209 SAP Online Help 25.02.2005 Calling a Dialog for Cell Properties Definition Command for a data provider. Use You can call the dialog for cell properties with this command. Structure CMD Process_help_window Parameter Description HELP_SERVICE Name of the help service: STRUC_MEMBER_PROPERTIES STRUCTURE_MEMBER_1 Structural component of the first structure Enter the value of the first structural component here. The combination of structural components defines the coordinates for a cell. STRUCTURE_MEMBER_2 Structural component of the second structure (if it exists) Enter the value of the second structural component here. The combination of structural components defines the coordinates for a cell. Web API Reference BW 3.5 210 SAP Online Help 25.02.2005 Save Query View Dialog Box Use With this command you call a dialog for saving a query view. You can specify a follow-up action here if necessary. Also see Saving Query Views [Seite 182]. Prerequisites In order to use this command you have to register the help service to a Web item. The following additional attributes have to be added to a Web item that is assigned to the corresponding data provider in the HTML view in the Web Application Designer: Attribute Description HELP_SERVICE Name of the help service (SAVE_VIEW) HELP_SERVICE_CLASS Technical name of the help service class (CL_RSR_WWW_HWIND_SAVE_VIEW) Features Command structure CMD Process_Help_Window Parameter Description HELP_SERVICE Name of the help service: SAVE_VIEW ITEM Logical name of the Web item with which you have registered the help service. LOCAL_VIEW A query view can be saved locally (that is, without specifying a technical name). The query view does not appear in the open dialog in this case. When you save locally, only a GUID (Global Unique Identifier) is generated. 'X' = Yes; ' ' = No (standard setting) It is usually only useful to use this parameter if you also specify the SUBMIT_TARGET parameter. SUBMIT_TARGET Web API Reference URL for the follow-up action. When you execute the URL the parameters DATA_PROVIDER_ID (technical name of the query view) and DESCRIPTION (name of the query views) are added to it. BW 3.5 211 SAP Online Help 25.02.2005 Example Call dialog for saving a query view that is connected to Web Item WEB_ITEM_1 <SAP_BW_URL CMD="PROCESS_HELP_WINDOW" HELP_SERVICE="SAVE_VIEW" item="WEB_ITEM_1"> Call help service for save view, where the view is saved as a local view (parameter LOCAL_VIEW) and a new entry is added to item VIEWDDITEM in the template that is calling the help service (parameter SUBMIT_TARGET). Call help service for the Save Query View dialog, where the query view is saved as a local query view (parameter LOCAL_VIEW) and a new entry is to be added to the Web item VIEWDDITEM (query view – selection) in the Web template calling the help service (parameter SUBMIT_TARGET) SAPBWOpenURL('<SAP_BW_URL CMD="PROCESS_HELP_WINDOW" HELP_SERVICE="SAVE_VIEW" item="WEB_ITEM_1" LOCAL_VIEW="X">&SUBMIT_TARGET=' + escape(opener.SAP_BW_URL_Get() + '&CMD=ADD&ITEM=VIEWDDITEM&ITEM_ID=MYITEM') Web API Reference BW 3.5 212 SAP Online Help 25.02.2005 Creating Your Own Dialogs Use With your own dialogs, you can generate your own HTML pages and call them from Web applications. To do this, you create your own ABAP class that inherits the associated properties and parameters from the class CL_RSR_WWW_HELP_WINDOW and you redefine one or more methods for this class. In your own ABAP class, you create the HTML code or create an URL for redirecting. The ABAP class enables access to the current navigational state of the Web application. Within the ABAP class you can process commands and call any ABAP code (function modules and so on). In this way it is possible to display data as checkboxes, to change it, and then to write it to database tables using ABAP function modules. Your own Business Server Page (BSP) applications provide an alternative to this procedure. BSP applications, however, cannot access the current navigational state of the Web application. For more information, see Business Server Pages [Extern]. The use of your own dialogs allows redirects of URLs. URLs can be extended with additional parameters that are not known when the Web application is first called. If the parameters are known during the first call, they can be inserted into the HTML code as JavaScript variables using the Web Design API for tables. Often, however, parameters are only required for specific, rare user actions. In these cases, due to performance and network issues, it makes sense to determine the parameters using your own dialog. If standalone HTML pages or redirects are not necessary, and instead only parts of the Web application need to be changed, it makes sense to use the Web Design API for Tables [Seite 277] or JavaScript functions. Prerequisites You have created a Web application that contains at least one Web item. This Web item is necessary to use the ABAP class in the Web template (see below). Procedure Creating an ABAP Class ... 1. From the SAP Easy Access screen, choose Tools → ABAP Workbench → Development → Class Builder (transaction SE24). See also Class Builder [Extern]. You can also use the Object Navigator from the ABAP Workbench (transaction SE 80) to generate a class. See also Object Navigator [Extern]. 2. To create a new class, under Object Type, enter a technical name for your class (for example, ZCL_RSR_WWW_HELP_WINDOW) and choose (Create). The Create Class YourClassName dialog box then appears. 3. Save your class. You get to the Object Catalog screen. Web API Reference BW 3.5 213 SAP Online Help 25.02.2005 4. Depending on the system configuration in regard to changes and the transport of objects, either choose a package or save your class as a local object. For more information, speak to your system administrator. The Class Builder: Change Class YOURCLASSNAME screen. 5. Choose Superclass on the Properties tab page. Under Inherits from, enter CL_RSR_WWW_HELP_WINDOW as the superclass. 6. To see all of the inherited properties and methods of the class CL_RSR_WWW_HELP_WINDOW in your ABAP class, choose (Save). 7. On the Methods tab page, choose the method PROCESS_CMD that you want to redefine and choose (Redefine). 8. To change the implementation of the method, call up the method name by double clicking. 9. To get back to the original screen, choose (Back) 10. Save your changes. 11. To activate event linking, choose (Activate). Using the ABAP Method PROCESS_CMD • The ABAP method PROCESS_CMD is automatically called by the Web Application Framework when you call your own dialog from a Web application. Using this method, the commands received and their parameters can be processed. • The commands and parameters from the URL are transferred to the method PROCESS_CMD in the import parameter I_R_PARAMETER. With the I_R_PARAMTER>GET ABAP method, individual commands and parameters can be queried. • Access to the information from the Web Application Framework is possible using the attribute N_R_PAGE. data: l_cmd type string. l_cmd = i_r_parameter->get( i_id = cl_rsr_www_page=>c_parameter_subcmd ). • For better structuring, it makes sense to distribute processing of individual commands to separate ABAP methods. These methods generate the HTML. • The result of the ABAP method PROCESS_CMD can be an HTML page or redirecting for a URL. The HTML page is returned to the attribute N_SX_OUTPUT-STRING as a character string. The return of the URL occurs in the attribute N_SX_OUTPUT-REDIRECT_URL. Using an ABAP Class in a Web Template 12. To be able to use the ABAP class you created, it must be included in a Web template. ... 1. Open your Web template, which includes at least one Web item, in the BEx Web Application Designer. 2. Use the HTML tab page to switch to the HTML view of the Web Application Designer. 3. Navigation to the object tag of the Web item and insert the following parameter lines into the HTML, to make the ABAP class known as HELP_SERVICE within the Web template. <object>… <param name="HELP_SERVICE" value=“YourDialog"/> <param name=“ HELP_SERVICE_CLASS “ value=”YourClassName”/> Web API Reference BW 3.5 214 SAP Online Help 25.02.2005 …</object> <object>… <param name=“HELP_SERVICE “ value=”DIALOG_1”/> <param name=“HELP_SERVICE_CLASS“ value=” ZCL_RSR_WWW_HELP_WINDOW”/> …</object> The parameter HELP_SERVICE contains the name of your own dialog within the Web template. The parameter HELP_SERVICE_CLASS includes the name of the ABAP class. 4. Insert a Command URL [Seite 145] as a hyperlink, context menu or form. Specification of the parameter CMD; HELP_SERVICE, ITEM is mandatory. You can also attach your ownoptional commands (for example, SUBCMD, and so on). Example in HTML <a href="<SAP_BW_URL CMD='PROCESS_HELP_WINDOW’ HELP_SERVICE='DIALOG_1’ ITEM=’TABLE_1’ SUBCMD=’COMMAND_2’>">Open Dialog</a> Example in JavaScript SAPBWOpenURL( SAP_BW_URL_Get() + "&CMD=PROCESS_HELP_WINDOW” + “&HELP_SERVICE=DIALOG_1” + “&ITEM=TABLE_1” + “&SUBCMD=COMMAND_2"); For more information on calling dialogs, see Saving Dialog Query Views [Seite 211]. 5. Save the changes. 6. Execute the Web template in the browser. Note that already existing Bookmarks [Seite 160] for a Web template into which you have integrated your own dialog (HELP_SERVICE) in the meantime do not recognize this dialog. In addition to the current navigational state (data provider), bookmarks also save the current state of the Web item. Debugging the ABAP Class For more information on debugging ABAP classes in Web applications, see Creating and Using ABAP Classes [Seite 278]. Result You have created an ABAP class and have redefined one or more methods to extend a Web application with your own HTML pages. Web API Reference BW 3.5 215 SAP Online Help 25.02.2005 Exceptions and Conditions Use With the commands for exceptions and conditions, you can create new exceptions or conditions, change existing exceptions or conditions, or set their status (inactive/active). You can find additional information about the individual commands under Commands for Exceptions [Seite 217] Setting the Status of an Exception [Seite 220] Commands for Conditions [Seite 221] Setting the Status of a Condition [Seite 223] Web API Reference BW 3.5 216 SAP Online Help 25.02.2005 Commands for Exceptions Definition Command for a data provider. Use 'You can change existing (local) exceptions and define new (local) ones with this command. Exceptions that were defined in the Query Designer cannot be changed. Structure CMD SET_EXCEPTION Parameter Description EXCEPTION_ID ID of the exception to be changed If there is no exception with this ID, a new one is created. A new exception is also created if this parameter is not filled. For how to determine the Exception_ID, see the notes below. (optional) ACTIVE Exception active 'X' = Yes, ' ' = No DESCRIPTION Description This text is displayed in the list of exceptions. IOBJNM_I Context in which a characteristic must be The exception is only evaluated if the data cell for the given characteristic is in the context described by parameters OPERATOR and VALUE. STRUCTURE_MEMBER_1 Structural component of the first structure Values: ‘UID’ or ‘ALL’ If the exception refers to one specific structural component, you have to specify this by entering the unique ID (UID). This is the 25 character string. STRUCTURE_NAME_1 If the exception refers to all structural elements and you have assigned the value ‘ALL’ to the STRUCTURE_MEMBER parameter, you also have to specify the parameter STRUCTURE_NAME_1 by entering the structure name (25 character string). STRUCTURE_MEMBER_2 Component of the second structure See the remarks on STRUCTURE_MEMBER_1. STRUCTURE_NAME_2 Web API Reference BW 3.5 217 SAP Online Help 25.02.2005 RELATIVE_VALUES (optional) Validity area for all characteristics not listed If you assign the value ‘X’ to the parameter, the values for all characteristics that are not listed can be arbitrary. This is to be recommended for relative values such as, for example, percentage deviations. If you assign the value ‘ ’ to the parameter, all characteristics that are not listed have to be aggregated. The exception is only valid fort he aggregated values of the characteristics that are not listed. See Defining Exceptions [Extern]. OPERATOR_I Context in which a characteristic must be Valid operators are: 'AL' = No restrictions 'AG' = Aggregated (no filtering) 'EQ' = A certain value 'NA' = Restricted to a value 'HL' = Hierarchy level VALUE_I Context in which a characteristic must be Key of the characteristic value if operator 'EQ' and hierarchy level if operator 'HL'. ALERT_LEVEL_J Alert Level The alert level can have the values 1, 2 and 3 for good numbers, 4, 5 and 6 for critical numbers and 7, 8, and 9 for bad numbers. OPERATOR_J Operator for the data values 'EQ' = Equal to 'NE' = Not equal to 'BT' = Interval 'LE' : Less than or equal to 'LT' = Less than 'GE' : Greater than or equal to 'GT' = Greater than VALUE_LOW_J Data cell value VALUE_HIGH_J Data cell value to This parameter is only needed for interval operators. To determine the Exception_ID, proceed as follows: • Create a Web application with the List of Exceptions Web item. • Call the Web application and deactivate the snippet operations (SNIPPET_OPERATIONS=' ') in the Web application URL. Web API Reference BW 3.5 218 SAP Online Help • 25.02.2005 Choose Activate or Deactivate in the context menu for the List of Exceptions (Activate/Deactivate). or choose You can now see the Exception_ID in the URL. Alternatively, you can also see the Exception_ID in the source code for the Web application (View Source). Web API Reference BW 3.5 219 SAP Online Help 25.02.2005 Setting the Status of an Exception Definition Set Status of an Exception is a command for a DataProvider in the Web template. Use Calling up this command allows you to change the status for a DataProvider exception. Structure CMD Set_Exception_State Parameter Description EXCEPTION_ID Technical name of the exception Give the technical name of the exception here (25 character string). ACTIVE (Option 1) Required exception status ‘X’ = activate, ‘ ’ = deactivate TOGGLE_STATE (Option 2) Change the exception status ‘X’ = switch, ‘ ’ = do not switch If this parameter is set to ‘X’, the exception is activated if it was previously not active and deactivated if active. Examples Set exception “Problems in Sales” from DataProvider ‘Query View 1’ to active <SAP_BW_URL DATA_PROVIDER=’View1’ CMD=’Set_Exception_State’ EXCEPTION_ID=’DTG057U7OQ8K2ALKCMR2AWM14’ ACTIVE=’X’> Switch exception “Problems in Sales” from DataProvider ‘Query View1’ <SAP_BW_URL DATA_PROVIDER=’View1’ CMD=’Set_Exception_State’ EXCEPTION_ID=’DTG057U7OQ8K2ALKCMR2AWM14’ TOGGLE_STATE=’X’> Web API Reference BW 3.5 220 SAP Online Help 25.02.2005 Commands for Conditions Definition Command for a data provider. Use 'You can change existing (local) conditions and define new (local) ones with this command. Conditions that were defined in the Query Designer cannot be changed. Structure CMD SET_CONDITION Parameter Description CONDITION_ID ID of the condition to be changed If there is no condition with this ID, a new condition is created. A new condition is also created if this parameter is not filled. For how to determine the CONDITION_ID, see the notes below. (optional) ACTIVE Condition active 'X' = Yes, ' ' = No DESCRIPTION Description This text is displayed in the list of conditions. IOBJNM_I List of characteristics List of the characteristics for which the condition should be applied in combination. If no characteristic is specified, the condition is applied to all characteristics. STRUCTURE_MEMBER_1_I Structural component of the first structure A condition always refers to exactly one value cell. To do this, you have to specify the components of the structure (25-character string) for all the occurring structures (maximum 2). STRUCTURE_MEMBER_2_I Structural component of the second structure (if it exists) Web API Reference BW 3.5 221 SAP Online Help 25.02.2005 OPERATOR_I An operator 'EQ' = Equal to 'NE' = Not equal to 'BT' = Interval 'LE' : Less than or equal to 'LT' = Less than 'GE' : Greater than or equal to 'GT' = Greater than 'TC' = Top n 'TP' = Top percent 'TS' = Top sum 'BC' = Bottom n 'BP' = Bottom percent 'BS' = Bottom sum VALUE_LOW_I Numerical value for operator VALUE_HIGH_I Numerical value for operator Only the interval operator needs this value. To determine Condition_ID, proceed as follows: • Create a Web application with the List of Conditions Web item. • Call the Web application and deactivate the snippet operations (SNIPPET_OPERATIONS=' ') in the Web application URL. • Choose Activate or Deactivate in the context menu for the List of Conditions (Activate/Deactivate). or choose You can now see the Condition_ID in the URL. Alternatively, you can also see the Condition_ID in the source code for the Web application (View Source). • Web API Reference BW 3.5 222 SAP Online Help 25.02.2005 Setting the Status of a Condition Definition Set Status of a Condition is a command for a DataProvider in the Web template. Use Calling up this command allows you to change the status for a DataProvider condition. Structure CMD Set_Condition_State Parameter Description CONDITION_ID Technical name of the condition Give the technical name of the condition here (25 character string). ACTIVE (Option 1) Required status for the condition ‘X’ = activate, ‘ ’ = deactivate TOGGLE_STATE (Option 2) Change the status of the condition ‘X’ = switch, ‘ ’ = do not switch If this attribute is set to ‘X’, the condition is activated, if it is not active already, and deactivated, if it is active. Examples Set condition “Top 10 Customers” from the DataProvider ‘Query View1’ to Active <SAP_BW_URL DATA_PROVIDER='View1' CMD='Set_Condition_State' CONDITION_ID='DTG057U7OQ8K2ALKCMR2AWM14' ACTIVE='X'> Switch condition “Top 10 Customers” from DataProvider ‘Query View1’ <SAP_BW_URL DATA_PROVIDER='View1' CMD='Set_Condition_State' CONDITION_ID='DTG057U7OQ8K2ALKCMR2AWM14' TOGGLE_STATE='X'> Web API Reference BW 3.5 223 SAP Online Help 25.02.2005 Commands for Currency Translation Definition Command for a data provider. Use You can define a new currency translation for the data provider with this command. Structure CMD CURRENCY_CONVERSION Parameter Description CUR_CONV_METHOD Currency translation type CUR_CONV_TYPE ‘0’ = database currency '1' = as in the query definition '2' = to target currency '3' = to target currency via query definition currency Translation type TARGET_CURRENCY Target currency Only need be specified for CUR_CONV_TYPE 2 and 3 Web API Reference BW 3.5 224 SAP Online Help 25.02.2005 Commands for Values Cells Definition Command for a data provider. Use You can change the properties of value cells with this command. Structure CMD SET_VALUE_PROPERTIES Parameter Description STRUCTURE_MEMBER_1 Structural component of the first structure The properties are defined for a value cell. To do this, you have to specify the components of the structure (25-character string) for all the occurring structures (maximum 2). STRUCTURE_MEMBER_2 Structural component of the second structure (if it exists) SCALING_FACTOR Scaling factors 0=No scaling, 1=Factor 10, 2=Factor 100, ... DECIMAL_PLACES Number of displayed decimal places EMPHASIS Display with highlighting 'X' = Yes, ' ' = No Web API Reference BW 3.5 225 SAP Online Help 25.02.2005 List Calculations Definition List Calculations is a command for a data provider in the Web template. Use With this command you can change the settings for calculating lists for a value cell. Structure CMD SET_LIST_CALCULATION Parameter Description STRUCTURE_MEMBER_1 Structural component of the first structure The value cell must be determined exactly for calculating lists. To do this, you have to specify the components of the structure (25-character string) for all the occurring structures (maximum 2). STRUCTURE_MEMBER_2 Structural component of the second structure (if it exists) APPLY_TO_RESULTS (optional) Use calculation guidelines also for event cells 'X' = Yes, ' ' = No CUMULATION (optional) Cumulated output 'X' = Yes, ' ' = No VALUE_CALCULATION (optional) Web API Reference Calculations ' ' = No list calculation 'R' = Normalizing for query result 'G’ = Normalizing for overall result 'C' = Normalizing for result 'S' = Ranking list 'O' = Ranking list (Olympic) BW 3.5 226 SAP Online Help RESULT_CALCULATION (optional) 25.02.2005 Calculations for result cells '00' = No list calculation '01' = Summation '02' = Maximum '03' = Minimum '04' = Count of all values '05' = Count of all values <> 0 '06' = Average using all values '07' = Average using all values <> 0 '08' = Standard deviation '09' = Variance '10' = Suppress results '11' = First value '12' = Last value Example Display maximum plan sales <SAP_BW_URL DATA_PROVIDER='View1' CMD='SET_LIST_CALCULATION' STRUCTURE_MEMBER_1='DTG057U7OQ8K2ALKCMR2AWM14' STRUCTURE_MEMBER_2='EFG057U7OQ8K2JKKCMR2AWM67' VALUE_CALCULATION='02'> See also: OLAP Functions for Active Cells [Extern] Web API Reference BW 3.5 227 SAP Online Help 25.02.2005 Operations for Display Hierarchies Definition Operations on Display Hierarchies contains commands for a data provider in a Web template. Use There are five operations that you apply to display hierarchies: ... 1. With the SET_HIERARCHY_STATE command, you activate or deactivate a display hierarchy that has been assigned to a characteristic (for example, in the query definition or in a query view). CMD SET_HIERARCHY_STATE Parameter Description IOBJNM Name of characteristic Characteristic with a display hierarchy assigned to it already. ACTIVE (Option 1) Required status of the display hierarchy. ‘X’ = activate, ‘ ’ = deactivate TOGGLE_STATE (Option 2) ‘X’ = switch, ‘ ’ = do not switch Switch the status of a hierarchy If this parameter is set to ‘X’, the display hierarchy is activated if it was previously not active and deactivated if active. Activating a Hierarchy for the Cost Center Characteristic for Data Provider ‘View1’ <SAP_BW_URL DATA_PROVIDER='View1' CMD='Set_Hierarchy_State' IOBJNM='0COSTCENTER' ACTIVE='X'> 2. You use the SET_HIERARCHY command to assign a display hierarchy to a characteristic. CMD SET_HIERARCHY Parameter Description IOBJNM Name of characteristic Characteristic that you want to assign a display hierarchy to. HIERARCHY_NAME Technical name of the hierarchy HIERARCHY_VERSION Hierarchy version If the hierarchy has a particular version, you must specify the version. Otherwise you can leave out this parameter. Web API Reference BW 3.5 228 SAP Online Help HIERARCHY_DATE 25.02.2005 Key date for the hierarchy You specify the key date for time-dependent hierarchies here. The date must be formatted as YearMonthDay (for example, 20001224). If the parameter is not transferred, the key date in the query is copied. Required status of the display hierarchy. ACTIVE ‘X’ = activate, ‘ ’ = deactivate Assigning ‘MyHierarchy’ to the Cost Center Characteristic for Data Provider ‘View1’ <SAP_BW_URL DATA_PROVIDER='View1' CMD='Set_Hierarchy' IOBJNM='0COSTCENTER' Hierarchie_Name='MyHierarchy' ACTIVE='X'> 3. You use the DRILL_TO_LEVEL command to expand the display hierarchy up to a specified hierarchy level. CMD DRILL_TO_LEVEL Parameter Description IOBJNM Name of characteristic Characteristic, to which an active display hierarchy is assigned. LEVEL Hierarchy level Level to which you want to expand the hierarchy. Level 1 is the root level. If a hierarchy node is filtered at the same time, make sure that the level is higher than the level of the filtered node. Drilldown Cost Center Characteristic for Data Provider ‘View1’ up to Level 3 <SAP_BW_URL DATA_PROVIDER='View1' CMD='Drill_To_Level' Iobjnm='0COSTCENTER' Level='3'> 4. You use the SET_DRILL_STATE command you can expand and collapse a node from a display hierarchy. Note that the node must be visible in the list in the current navigation status. The command is a useful way of influencing the extent to which the hierarchy is expanded when you are calling a Web application, activating a hierarchy, or determining and Web API Reference BW 3.5 229 SAP Online Help 25.02.2005 activating a hierarchy. Command sequences are used in order to execute both commands at the same time. CMD SET_DRILL_STATE Parameter Description IOBJNM Name of characteristic Characteristic, to which an active display hierarchy is assigned. POSITION Data position in the drilldown Since several objects can be drilled down on an axis, the node specifications are no longer unique. Therefore, the axis position is used instead. For example, the fifth data line. Level to which you want the hierarchy to be expanded DRILL_STATE (optional) 'E' = hierarchy nodes expanded 'C' = collapse 'U' = by activating “Display as Hierarchy” on the axis: drilldown according to the next object on the axis If the parameter is not specified, the collapsed or expanded status will change. This means that a collapsed hierarchy node will be expanded and an expanded hierarchy node will be collapsed. Specifying the Hierarchy for the Cost Center Characteristic for Data Provider ‘View1’ and Simultaneously Expanding the Fifth Node on the Axis <SAP_BW_URL DATA_PROVIDER='View1' CMD='Set_Hierarchy' IOBJNM='0COSTCENTER' Hierarchie_Name='MyHierarchy' ACTIVE='X' CMD_1='CMD=set_Drill_State&Data_Provider=View1&iobjnm=0COSTCENTER&P OSITION=5&Drill_State=E'> A command sequence is used in this example. See also: Command Sequences [Seite 232] 5. With the command SET_HIERARY_NODE_SUPP, the property Display/Suppress Nodes with Only One Child can be set. CMD SET_HIERARY_NODE_SUPP Parameter Description IOBJNM Name of characteristic Characteristic, to which an active display hierarchy is assigned. Web API Reference BW 3.5 230 SAP Online Help RESULT_SUPPRESSION ‘CONDITIONAL’ = Suppress Nodes with Only One Child 25.02.2005 Display/Suppress Nodes with Only One Child ‘NEVER’ = Display Nodes with Only One Child Activate For Cost Center Characteristic for Data Provider ‘View1’ Suppress Node with Only One Child <SAP_BW_URL DATA_PROVIDER='View1' CMD='SET_HIERARCHY_NODE_SUPP' Iobjnm='0COSTCENTER' RESULT_SUPRESSION='CONDITIONAL'> 6. Web API Reference BW 3.5 231 SAP Online Help 25.02.2005 Command Sequences Use Many questions require you to change several objects in different ways with commands [Seite 145]. For example, you cannot use the current methods with a single request (command) for filtering a data provider [Seite 172] for the fiscal year 1999 and another data provider for 2000. A command sequence allows you to add new commands to an original command. Data is requested from the OLAP processor and the HTML page is sent back to the Web Browser only after all of the commands have been processed. • The subsequent command sequences are added to the original command as parameter CMD_N. If the command is within an >SAP_BW_URL> tag, you need to make sure that the complete command sequence is set in quotation marks. No quotation marks can be set within the command sequence. If the command sequence is transported using a URL, you have to make sure that you replace the characters ‘=’ and ‘&’ with their hexadecimal display in the command sequence { Replace ‘=’ with ‘%3D’ { Replace ‘&’ with ‘%26’ Each subsequent command can have a maximum of 250 characters. If it contains more characters, these extra characters are cut off. If the command sequence is too large to fit in a URL then you can add the parameter ‘NO_OUTPUT' to a command. As a result, the command is executed and an empty page is returned. However, no data is read. This is useful, for example, if a main frame is addressed from a control frame. Using JavaScript, you can carry out a sequence of single commands in the main frame and leave out the ‘NO_OUTPUT’ parameter from the last command. See also Example Scenario for the Parameter NO_OUTPUT [Seite 270]. See examples 1 and 2 below. • The parameter APPLY_CMD_ON_TARGET and its values “X” and “ ” allow you to choose whether the subsequent commands are used in a new page created by the main command or whether they are used in the same page as the main command. See example 3 below. Examples ... 1. Start a Web application and filter data provider 1 according to DE and data provider 2 according to US http://myAppServer:myPort/SAP/BW/BEx?CMD=LDOC&template_id=yourTemplate&CMD _1=DATA_PROVIDER%3DDP1%26FILTER_IOBJNM%3D0COUNTRY%26FILTER_VAL UE%3DDE&CMD_2=DATA_PROVIDER%3DDP2%26FILTER_IOBJNM%3D0COUNTRY %26FILTER_VALUE%3DUS 2. Command URL to filter Data Provider 1 according to calendar year 2000, change the title of the GRAPHIC graphic to ‘2000’, and change the title of the TABLE table to ‘Details2000’ Web API Reference BW 3.5 232 SAP Online Help 25.02.2005 <SAP_BW_URL DATA_PROVIDER='DP1' FILTER_IOBJNM='0CALYEAR' FILTER_VALUE='2000' CMD_1='ITEM=GRAPHIC&CAPTION=2000' CMD_2='ITEM=TABLE&CAPTION=Details2000'> 3. Page 1 contains a link to the details. This link starts page 2. The navigation status of the page 1 print parameters is transferred and at the same time the target page is parameterized, for example, navigation is switched off. <SAP_BW_URL cmd="release_data_provider" data_provider="dp" template_id="template_2" apply_cmd_on_target="X" cmd_1="item=*&multi=X&generate_links="> 4. Swap the axes of DataProvider 1 and place the 0Country characteristic in the rows <SAP_BW_URL cmd=“SWITCH_AXES“ data_provider=“dp“ cmd_1=“data_provider=dp&cmd=expand&iobjnm=0Country&axis=y“> Web API Reference BW 3.5 233 SAP Online Help 25.02.2005 Using Forms Use With HTML forms you can integrate input fields easily into an HTML page. You can also use this HTML technology to create BEx Web applications. Features Web Template Parameterization By using forms, you can set customized parameters when calling up Web applications. Do this by creating an HTML document with a form from which the actual Web application URL is called up with set parameters. After calling up the following HTML document, the user is offered a form in which he or she can choose a calendar year and a country from dropdown boxes. After clicking on submit, the Web application appears with preset filters in the query views. <html> <body> <table> <form method="POST" Action=" http://myAppServer:myPort/SAP/BW/BEx?CMD=LDOC&template_id=yourTemplate&FILTER_IOB JNM_1=0CALYEAR&FILTER_IOBJNM_2=0COUNTRY "> <tr> <td>calendar year</td> <td><select size="1" name="FILTER_VALUE_1"> <Option value="1997">1997</Option> <Option value="1998">1998</Option> <Option value="1999">1999</Option> <Option value="2000">2000</Option> </select></td> </tr> <tr> <td>Land</td> <td><select name="FILTER_VALUE_2"> <Option value="BR">Brazil</Option> <Option value="DE">Germany</Option> <Option value="FR">France</Option> <Option value="GB">Great Britain</Option> <Option value="JP">Japan</Option> <Option value="RU">Russia</Option> <Option value="ES">Spain</Option> <Option value="US">USA</Option> </table> <input type="submit" value="Submit" name="Submit"> </form> </body> Web API Reference BW 3.5 234 SAP Online Help 25.02.2005 </html> Buttons and Forms in Web Templates <form method="POST" action="<SAP_BW_URL DATA_PROVIDER=’*’ MULTI=’X’ FILTER_IOBJNM_1=’0CALYEAR’ FILTER_IOBJNM_2=’0COUNTRY’>"> <table> <tr> <td>calendar year</td> <td><select size="1" name="FILTER_VALUE_1"> <Option value="1997">1997</Option> <Option value="1998">1998</Option> <Option value="1999">1999</Option> <Option value="2000">2000</Option> </select></td> </tr> <tr> <td>Land</td> <td><select name="FILTER_VALUE_2"> <Option value="BR">Brazil</Option> <Option value="DE">Germany</Option> <Option value="FR">France</Option> <Option value="GB">Great Britain</Option> <Option value="JP">Japan</Option> <Option value="RU">Russia</Option> <Option value="ES">Spain</Option> <Option value="US">USA</Option></select></td> </tr> </table> <input type="submit" value="Submit" name="Submit"> </form> You can also generate the <option> tags from the BW system. Do so using the Web item Dropdown Box. Set the attributes ONLY_VALUES (Only Display Values) to ‘X’ and GENERATE_CAPTION (Generate Caption) to ‘ ‘. As a result, the system generates the characteristic values of the InfoObjects as an <option> tag. You can then set the enclosing select and form tag into your HTML coding as you require. You can use this to create a multi-select box for example – displayed in the example below, in order to refrain from sending the request to the server until all dropdown boxes. <form name="form_1" method="post" action="<SAP_BW_URL DATA_PROVIDER='DATAPROVIDER_1' FILTER_IOBJNM_1=’MYOBJ_1’ FILTER_IOBJNM_2='MYOBJ_2'>"> <select name="FILTER_VALUE_1" size="1"> <object> <param name="OWNER" value="SAP_BW"> <param name="CMD" value="GET_ITEM"> <param name="NAME" value="DROPDOWNBOX_1"> <param name="ITEM_CLASS" value="CL_RSR_WWW_ITEM_FILTER_DDOWN"> <param name="DATA_PROVIDER" value="DATAPROVIDER_1"> <param name="GENERATE_CAPTION" value=""> <param name="IOBJNM" value="MYOBJ_1"> Web API Reference BW 3.5 235 SAP Online Help 25.02.2005 <param name="ONLY_VALUES" value="X"> ITEM: DROPDOWNBOX_1 </object> </select> <select name="FILTER_VALUE_2" size="1"> <object> <param name="OWNER" value="SAP_BW"> <param name="CMD" value="GET_ITEM"> <param name="NAME" value="DROPDOWNBOX_2"> <param name="ITEM_CLASS" value="CL_RSR_WWW_ITEM_FILTER_DDOWN"> <param name="DATA_PROVIDER" value="DATAPROVIDER_1"> <param name="GENERATE_CAPTION" value=""> <param name="IOBJNM" value="MYOBJ_2"> <param name="ONLY_VALUES" value="X"> ITEM: DROPDOWNBOX_2 </object> </select> <input type="submit" value="Submit "> </form> Buttons that filter the Data Provider ‚View1’ according to calendar years <form method="POST" action="<SAP_BW_URL DATA_PROVIDER=’View1’ FILTER_IOBJNM=’0CALYEAR’>"> <input type="submit" value="1998" name="FILTER_VALUE"> <input type="submit" value="1999" name="FILTER_VALUE"> <input type="submit" value="2000" name="FILTER_VALUE"> </form> Web API Reference BW 3.5 236 SAP Online Help 25.02.2005 Use of JavaScript Functions Use You can execute commands or command sequences with JavaScript as well as by using <SAP_BW_URL> tags. Another JavaScript application is the enhancement of the context menu to include customerspecific entries. All subsequent examples refer to excerpts from JavaScript. Features You can choose from the following functions: Send Commands [Seite 238] Enhancing the Context Menu with JavaScript [Seite 245] Properties of Page Objects [Seite 251] Logon Language [Seite 258] Web API Reference BW 3.5 237 SAP Online Help 25.02.2005 Send Commands Use You have to create a URL before you can send it. The following options are available: • Use the <SAP_BW_URL> tag • Using the BW JavaScript function <SAP_BW_URL_Get>(). This produces the same result as the <SAP_BW_URL> tag, but can also be called up outside of your own frame. Features JavaScript Function SAP_BW_URL_GET Return value Start of an URL for calling an instruction that should be executed in the same page context. Prepare Bookmark URL url = "<SAP_BW_URL CMD='BOOKMARK'>"; produces the same result as url = "<SAP_BW_URL>" + "&CMD=BOOKMARK"; or url = SAP_BW_URL_Get() + "&CMD=BOOKMARK"; There are a number of JavaScript functions for sending instructions. As a result, functions are made available that simplify the management of windows. For example, these functions allow properties dialog boxes to be called up in separate windows. These functions take into account whether or not the Web browser can use JavaScript. Thus, with a pocket IE device, no new windows are generated. You can choose from the following JavaScript functions: Execute URL in the Same Window [Seite 239] Execute URL in a New Window [Seite 240] URL from a New Window in the Opening Window [Seite 241] Close Window [Seite 242] Execute Form in a New Window [Seite 243] Execute Form in the Opening Window [Seite 244] Web API Reference BW 3.5 238 SAP Online Help 25.02.2005 Execute URL in the Same Window Use JavaScript function for sending commands. Features JavaScript Function SAPBWOpenURL Parameter Description url URL to be launched. Example Send Bookmark URL SAPBWOpenURL(SAP_BW_URL_Get() + "&CMD=BOOKMARK"); or in HTML: <a href="JavaScript:SAPBWOpenURL(SAP_BW_URL_Get() + '&CMD=BOOKMARK');">Create Bookmark</a> Open SAP Portals Homepage SAPBWOpenURL("http://www.sapportals.com"); Web API Reference BW 3.5 239 SAP Online Help 25.02.2005 Execute URL in a New Window Use JavaScript function for sending commands. Features The URL is executed in a new window (output device permitting). This can be useful for selecting filter values and in properties dialogs. JavaScript Function SAPBWOpenWindow Parameter Description url URL to be launched. Name Window name Width Width of the window Height Height of the window Example Call Select filter value dialog for characteristic 0Costcenter of Data Provider ABC SAPBWOpenWindow(SAP_BW_URL_Get() + "&CMD=PROCESS_HELP_WINDOW&HELP_SERVICE=DP_VIEW_FILTER&DATA_PROVIDE R=ABC&IOBJNM=0COSTCENTER","FILTER",800,600); or in HTML: <a href="JavaScript:SAPBWOpenWindow(SAP_BW_URL_GET() + '&CMD=PROCESS_HELP_WINDOW&HELP_SERVICE=DP_VIEW_FILTER&DATA_PROVIDER =ABC&IOBJNM=0COSTCENTER','FILTER',800,600);">Define filter value for cost center</a> Display tailor-made form in a new window SAPBWOpenWindow("http://.../CustomerForm.htm","CONFIG",300,200); Open SAP Portals homepage in a new window SAPBWOpenWindow("http://www.sapportals.com","SAPPORTALS",800,600); Web API Reference BW 3.5 240 SAP Online Help 25.02.2005 URL from a New Window in the Opening Window Use JavaScript function for sending commands. Features You can send a URL on the opening window from a new window with this function. The properties of the output device are taken into acccount here. JavaScript Function SAPBWSetOpenerUrl Parameter Description url URL to be launched in the opening window. close Then close window true = close, false = leave open Example Start a new Web application in the main window SAPBWSetOpenerUrl(SAP_BW_URL_Get() + "&CMD=LDOC&TEMPLATE_ID=NewTemplate"); or in HTML: <a href="JavaScript:SAPBWSetOpenerUrl(SAP_BW_URL_GET() + "&CMD=LDOC&TEMPLATE_ID=NewTemplate");">New Web report</a> Web API Reference BW 3.5 241 SAP Online Help 25.02.2005 Closing Windows Use JavaScript function for sending commands. Functions With this function you can close a window without having to execute a command. The properties of the output device are taken into consideration. If the output device does not accept JavaScript, the function pages back by one page. JavaScript Function SAPBWCloseWindow Example Close window SAPBWCloseWindow(); or in HTML: <a href="JavaScript:SAPBWCloseWindow();">Close window</a> Web API Reference BW 3.5 242 SAP Online Help 25.02.2005 Executing a Form in a New Window Use JavaScript function for sending commands. Functions The form is executed in a new window (if the output device permits this). You can use this function to create your own forms for control in a Web template. JavaScript Function SAPBWWForm Parameter Description name Window name formname Name of form width Width of the window height Height of the window Example Execute a Form in a New Window SAPBWWForm("WindowName","FormName",800,600); or in HTML: <a href="JavaScript:SAPBWWForm("WindowName","FormName",800,600);">Evaluate form in a new window</a> Web API Reference BW 3.5 243 SAP Online Help 25.02.2005 Executing a Form in the Opening Window Use JavaScript function for sending commands. Functions You can execute a form on the opening window from a new window with this function. The properties of the output device are taken into consideration. JavaScript Function SAPBWOpenerSubmitForm Parameter Description formname Name of form close Then close window true = close, false = leave open Example Execute form in the opening window and close window SAPBWOpenerSubmitForm("FormName",true); or in HTML: <a href="JavaScript:SAPBWOpenerSubmitForm('FormName',true);">Execute form and close window</a> Web API Reference BW 3.5 244 SAP Online Help 25.02.2005 Enhancing the Context Menu with JavaScript Use As well as being able to make entries in the context menu visible, entries in the enhanced menu visible or entries in the enhanced menu invisible, you can also hang scenario-specific entries in the menu. There are several options: • You define the new entries for the Web template properties with the object tag. You can find additional information under Object Tag for the Properties of Web Templates [Seite 125] and Enhancing Context Menus [Seite 139]. • You hang the new entries in the context menu with a JavaScript function. You can find additional information under Adding Menu Entries with JavaScript [Seite 246] and Command Processing [Seite 248]. In both cases you must write a JavaScript function that processes the menu entry selection. Web API Reference BW 3.5 245 SAP Online Help 25.02.2005 Adding a Menu Entry using JavaScript Use You can add new entries to the context menu either using the Web template property or with a JavaScript call. Functions JavaScript Function SAPBWAddToMenu Parameter Description label Labeling text in the menu func JavaScript function for processing the command You implement this function in JavaScript and use it to execute commands after you have selected the menu entry. parameter Free parameter This parameter is passed to the JavaScript function ‘func’ and you can evaluate it there as required. The parameter allows you to use a function ‘func’ for more than one menu entry. cell_type Context of the entry ‘ ’ = No restriction If you want the menu entry to appear only in certain contexts and not in all context menus, you can define this with ‘cell_type’ and ‘filter’. ‘CHARACTERISTIC’ = Characteristic ‘CHARACTERISTIC_VALUE’ = Characteristic value ‘STRUCTURE’ = Structure ‘STRUCTURE_MEMBER = Structural component ‘DATA’ = Data cell ‘EXCEPTIONS’ = Exceptions item ‘CONDITIONS’ = Conditions item ‘DOCUMENT_LIST’ = Document list item Web API Reference BW 3.5 246 SAP Online Help filter 25.02.2005 Context of the entry Different values are relevant here, depending on the value of ‘cell_type’: ‘CHARACTERISTIC’, ‘CHARACTERISTIC_VALUE’, ‘STRUCTURE’, ‘STRUCTURE_VALUE’: Iobjnm ‘EXCEPTIONS’: Exception ID ‘CONDITIONS’: Condition ID ‘DOCUMENT_LIST’: Document ID See Examples. visibility Visibility of the entry ‘ ’= Not displayed Here you define if the entry is to appear in the basic menu or in the enhanced menu. ‘X’= Displayed in the “basic menu” ‘E’= Displayed in the “enhanced menu” position Position of the entry ‘TOP’ = Before the “normal” entries The entries are inserted in the order in which they were called. You can choose if the entry is to appear before the “normal” entries or after them in the menu. You cannot position the entries in between the “normal” entries. ‘BOTTOM’ = After the “normal” entries Data_provider Name of the data provider Name of the data provider (if the entry is to be made only for a specific data provider). Item Name of the Web item Name of the Web item (if the entry is to be made only for a specific Web item). Example See the examples under Command Processing [Seite 248] Web API Reference BW 3.5 247 SAP Online Help 25.02.2005 Command Processing Use When you enhance the context menu with customer-specific entries (with Web template properties or JavaScript function 'SAPBWAddToMenu'), you must define a JavaScript function that is executed when a customer-specific entry is selected. This function is responsible for processing the command. Features The function must support the following interface: JavaScript Function JavaScript function for processing the command Parameter Description parameter Free parameter The parameter makes it possible to process more than one menu entry with one function. See Examples. cell_type Context of cell ' ' = No special ‘CHARACTERISTIC’ = Characteristic ‘CHARACTERISTIC_VALUE’ = Characteristic value ‘STRUCTURE’ = Structure ‘STRUCTURE_VALUE’ = Structure component value ‘DATA’ = Data cell 'EXCEPTIONS' = Web Item List of Exceptions 'CONDITIONS' = Web Item List of Conditions 'DOCUMENT_LIST' = Web Item List of Documents Filters Context of cell Different values are suitable, depending on the value of ‘cell_type’: ‘CHARACTERISTIC’, ‘CHARACTERISTIC_VALUE’, ‘STRUCTURE’, ‘STRUCTURE_VALUE’: Iobjnm ‘EXCEPTIONS’: Exception ID ‘CONDITIONS’: Condition ID ‘DOCUMENT_LIST’: Document ID See Examples. Web API Reference BW 3.5 248 SAP Online Help 25.02.2005 parameter1 Exact definition of the context of the cell cell_type = 'CHARACTERISTIC_VALUE': Key for characteristic value cell_type = 'STRUCTURE_VALUE': STRUCTURE_MEMBER_ID_1 parameter2 Exact definition of the context of the cell cell_type = 'CHARACTERISTIC_VALUE': Node type for a hierarchy node cell_type = 'STRUCTURE_VALUE': STRUCTURE_MEMBER_ID_2 item Name of the Web item on which the menu is called dataprovider Name of the data provider for which the menu is called up x Cell is on data column x This parameter is needed especially for the report/report interface. Y Cell is on data row y This parameter is needed especially for the report/report interface. You can use all the JavaScript functions that were listed for processing. Example <SCRIPT language="JavaScript"> <!-// menu entry at start and only for customer cells, only for data provider DP1 SAPBWAddToMenu("Customer details","myMenuProcessor","1","CHARACTERISTIC_VALUE","0CUSTOMER","X","TOP","DP1", ""); // Menu entry at the end to the IT Home Page // Menu entry at the end to the IT Home Page // Menu entry at the beginning and only on material groups SAPBWAddToMenu("Materials","myMenuProcessor","3","CHARACTERISTIC_VALUE","0MATE RIAL","X","TOP","",""); // Command Processing function myMenuProcessor(parameter,cell_type,filter,parameter1,parameter2,item,dataprovider,x,y){ switch (parameter){ case "1": // Report-report-interface jump to customer details Web application in a new window SAPBWOpenWindow(SAP_BW_URL_Get() + "&CMD=RRI&DATA_ROW=" + y + "&DATA_COLUMN=" + y + "&IOBJNM=0CUSTOMER&RRI_RECEIVER=ABC&DATA_PROVIDER=" + escape(dataprovider) ,"CustDetails",600,400); break; case "2": Web API Reference BW 3.5 249 SAP Online Help 25.02.2005 // Call IT help page SAPBWOpenWindow("http://…/it/olap/help.htm","Help",600,400); break; case "3": // Filter material group and expand by material SAPBWOpenUrl(SAP_BW_URL_Get() + "&CMD=EXPAND&" + "DATA_PROVIDER=" + escape(dataprovider) + "&IOBJNM=0MATERIAL&IOBJNM_PARENT=0MATGROUP&FILTER_IOBJNM=0MATGROUP" + "&FILTER_VALUE=" + escape(parameter1) + "&FILTER_NODE_IOBJNM=" + escape(parameter2)); break; } } ---> </SCRIPT> Web API Reference BW 3.5 250 SAP Online Help 25.02.2005 Properties of Page Objects Use This section lists the JavaScript functions for the properties of Web items and data providers: • You can access the current attribute value of a Web item. See Web Item Attributes [Seite 252] • You can determine which characteristics a data provider has. See Data Provider Characteristics [Seite 253]. • You can specify the properties of a Web template. See Determining Web Template Properties [Seite 255]. Web API Reference BW 3.5 251 SAP Online Help 25.02.2005 Web Item Attributes Use You can access the current attribute values of a Web item using this JavaScript function. For example, you can specify whether a Web item is visible. This will help you to create a Web application in which you can switch between two views, for example between a chart and a table, using a link. Features JavaScript Function SAPBWGetItemProp Parameter Description Name Logical name of the Web item Return value Array with Web item properties The information is stored as follows: new Array(itemName, new Array(attributeName1,attributeValue1), new Array(attributeName2,attributeValue2), ...) Specifying whether a Web item is visible: <SCRIPT language="JavaScript"> <!-var prop = SAPBWGetItemProp("myItem"); var hidden = true; if (prop != null){ for(i=1;i<prop.length;i++){ if (prop[i][0] == "HIDDEN") hidden = (prop[i][1] == "X"); } } ---> </SCRIPT> Web API Reference BW 3.5 252 SAP Online Help 25.02.2005 Characteristics for Data Providers Use You can use this JavaScript function to determine which characteristics belong to a data provider. By doing this, you can then, for example, fill a dropdown box for changing drilldowns with the relevant characteristics and do not have to create a dropdown box manually for each data provider. Moreover, this function is language-independent, which means the selections are adjusted automatically for each language. The texts are shown according to the logon language. Features JavaScript Function SAPBWGetDataProviderDimensions Parameter Description Name Logical name of the saved query view Return value Array of characteristics and structures of the data provider The individual characteristics and structures are stored as arrays, as in the example: new Array(dimArray1, dimArray2, ...) The individual characteristics and structures have the following structure: new Array(iobjnm,is_structure ( ,X),hierarchyAssigned( ,X), activeHierarchy( ,X), axis (X,Y, ), filtered ( ,1 (single value), X(multiple filter values)), caption, unsupported properties) There are other properties in addition to those listed, but these have not yet been officially released. Listing characteristics and structures: <SCRIPT language="JavaScript"> <!-var dim = SAPBWGetDataProviderDimensions("myDataProvider"); var text = ""; if (dim != null){ for(i=0;i<dim.length;i++){ text = text + dim[i][6] + ", "; } alert(text); Web API Reference BW 3.5 253 SAP Online Help 25.02.2005 } ---> </SCRIPT> Web API Reference BW 3.5 254 SAP Online Help 25.02.2005 Specifying Properties for Web Templates Use With this JavaScript function you can specify properties for Web templates. See also Object Tag for Properties of Web Templates [Seite 125]. For example, you can specify a technical name for the Web template or decide if dialogs need to be displayed in a new window. Features JavaScript Function SAPBWGetProperty Parameter Description Name Name of Web Template Property SUPPORTS_OPEN_WINDOW: Are you permitted to open new windows? (true, false) SUPPORTS_DOCUMENTS: Can document links be displayed? (true, false) SUPPORTS_EXPORT: Is an export according to XLS/CSV possible? (true, false) SUPPORTS_PERSONALIZATION: Is personalization possible? (true, false) TEMPLATE_PERSONALIZED: Is the Web template already personalized? (true, false) NO_BOOKMARKING_SUPPORTED: Are bookmarks impossible? (true, false) SUPPORTS_VARIABLE_SCREEN: Is a variable screen possible? (true, false) DATE_FORMAT: Date format (1: DD.MM.YYYY, 2: MM/DD/YYYY, 3: MM-DDYYYY, 4: YYYY.MM.DD, 5: YYYY/MM/DD, 6: YYYY-MM-DD) ACCESSIBILITYMODE_ACTIVE: Web template was called up with parameter ACCESSIBILITY=X (see also Barrier Freedom for Web Applications [Extern]) (true, false) TEMPLATE_ID: Technical name for Web template RUNS_AS_IVIEW: Web Application runs as iView (true, false) RRI_TARGET_FRAME: Attribute RRI_DISPLAY_TARGET (see Object Tag for Properties of Web Templates [Seite 125]) Return value Web API Reference See above BW 3.5 255 SAP Online Help 25.02.2005 The Web template properties do not have to completely agree with the set properties in the Web template. Sometimes when the device recognition properties are switched off, the Web template properties are then activated. Example Specifying the technical name of the Web template <SCRIPT language="JavaScript"> <!-var text=SAPBWGetProperty('TEMPLATE_ID'); alert(text); ---> </SCRIPT> Web API Reference BW 3.5 256 SAP Online Help 25.02.2005 Calendar for Date Filter Use You can use this JavaScript function to call up a calendar. When you select a value, the system filters the data characteristic for the specified DataProvider. Features JavaScript Function SAPBWSetFilterByCalendar Parameter Description dataProvider Logical name of the DataProvider When the filter operation is only to be applied to a DataProvider, specify its logical name here. dataProviderArray Logical name of data provider When the filter operation is to be applied to several data providers, specify their logical names here, for example, new Array (“DP1”,“DP2”,“DP3”) iobjnm Date characteristic The system is to filter according to this characteristic. displayDate (optional) Start date Date the calendar displays when it appears. This parameter is optional. The date format has 4 characters for the year, 2 for the month and 2 characters for the day: YYYYMMDD Filter DP1 according to 0CALDAY <a href=”Javascript:SAPBWSetFilterByCalendar(‘DP1’,’null’,’0CALDAY’,’20020213’);”> Filter Calday</a> Web API Reference BW 3.5 257 SAP Online Help 25.02.2005 Logon Language Use With this function you can define the logon language and thereby take the different input formats of the various languages into consideration in JavaScript. Features JavaScript Function SAP_BW_Get_Language Return value Logon Language For example, EN for English and DE for German. Web API Reference BW 3.5 258 SAP Online Help 25.02.2005 Language-Dependent Texts Definition By using this BW-specific tag, you can install language-dependent texts in a Web application. Use You create text elements for an ABAP report. These can then be translated. With the help of the SAP_BW_TEXT tag that you insert into a Web template, you can access the texts as follows: <SAP_BW_TEXT PROGRAM=’MYREPORT’ KEY=’001’> You can also use language-dependent headings for Web items. You can specify the headings as parameters either in the object tag of the Web item <param name=’CAPTION’ value=’SAP_BW_TEXT?PROGRAM=MYREPORT&KEY=001’> Or fill the heading in the Web Application Designer as follows: SAP_BW_TEXT?PROGRAM=MYREPORT&KEY=001 You can find additional information about language-dependent texts under Creating ABAP Programs for Maintaining Language-Dependent Texts [Seite 260]. Web API Reference BW 3.5 259 SAP Online Help 25.02.2005 Creating ABAP Programs for Maintaining LanguageDependent Texts Use To make Web applications independent from static texts, you can maintain and translate the text in an ABAP table. The Web application is then filled with the corresponding texts according to the logon language. Prerequisites You are in the ABAP Editor (transaction SE38) Procedure ... 1. In the Program field enter the name of the program, for example ZHTML_TEXTS and in the subobject screen, select Source Code. 2. Choose (Create). You reach the ABAP: Program Properties <Name of Program> Change screen. 3. Enter the title of the program, for example Web Application Texts. 4. Under Type in the Attributes field, choose Executable Program and then Save. You reach the Create Object Catalog Entry dialog box. 5. In the Attributes field under Package enter $TMP and save the program as a Local Object. You have created an ABAP report called ZHTML_TEXTS 6. In the menu bar choose Goto → Text Elements → Text Symbols. You reach the ABAP Text Elements: Display Text Symbols Language English screen. Choose (Create <-> Change). Enter your texts in the empty table. ... a. In the Sym field enter the numerical key of the new text element (0-999), for example, 001. b. In the Text field, enter the name of the text element, for example, Credit Memos. The dLen field is filled automatically with the actual length of the text you entered, for example, 12 in the case of Credit Memos. c. In the mLen field, enter the maximum length of the text field. If the maximum length of the text field (mLen) is smaller than the actual length of the text field (dLen), the system asks you whether you want the text to be shortened to the maximum length. (Activate). You reach the ABAP d. When you have entered all your texts, choose Text Elements: Change Text Symbols Language English screen. 7. In the menu bar of the ABAP Text Elements: Change Text Symbols Language English, choose Goto → Translation. You reach the Target Language for Translation screen. ... a. Select the target language, into which you want to translate the texts, for example, DE and choose (Continue). You reach the Translation: ABAP Text Pool: <Name Web API Reference BW 3.5 260 SAP Online Help 25.02.2005 of Program> ($) from Language <X> to <Y>, on which your texts and translation proposals from the ABAP text pool are displayed. For example, “Credit Memos” is translated as “Gutschriften”. You can transfer the proposals or edit them as you wish. The program generated the text translations from the ABAP text pool if corresponding entries are available there. For texts without proposals you have to enter the translation yourself. b. Choose Save. Result In the Web template, you can now insert the following tag for the example text used here ZHTML_TEXTS: <SAP_BW_TEXT PROGRAM=’ZHTML_TEXTE’ KEY=‘001’>. The command inserts the text that you maintained with the key 001 in the table, in accordance with the logon language in the Web template, for example as the table title. <th><SAP_BW_TEXT PROGRAM=‘ZHTML_TEXTE’ KEY=‘001‘></th> Web API Reference BW 3.5 261 SAP Online Help 25.02.2005 More Complex Examples of Applications In the following you will find more complex examples of applications that show you how you can create your own cockpits and execute command sequences in an optimized way with the help of command URLs and with the JavaScript functions. To understand the examples, you need to have an understanding of JavaScript and HTML. The following examples of applications are available: Dynamically Changing Attributes [Seite 263] Using Several Tab Pages [Seite 266] Example Scenario for the Parameter NO_OUTPUT [Seite 270] XML-Web Item: Data Provider Information [Seite 274] Web API Reference BW 3.5 262 SAP Online Help 25.02.2005 Dynamically Changing Attributes A toggle button needs to be activated and deactivated for the alternate table styles. The toggle button style changes according to the currently set attribute (ALT_STYLES) for the table. To do this, a toggle button is created in HTML. The style class for the toggle button is set dynamically. <!-- BW data source object tags --> <object> <param name="OWNER" value="SAP_BW"> <param name="CMD" value="SET_DATA_PROVIDER"> <param name="NAME" value="DATAPROVIDER_1"> <param name="DATA_PROVIDER_ID" value=""> DATA_PROVIDER: DATAPROVIDER_1 </object> <object> <param name="OWNER" value="SAP_BW"> <param name="CMD" value="SET_PROPERTIES"> <param name="TEMPLATE_ID" value="EXAMPLE_TEMPLATE_1 "> TEMPLATE PROPERTIES </object> <HTML> <HEAD> <TITLE>Example Template 1</TITLE> <link href= "/sap/bw/mime/BEx/StyleSheets/BWReports.css" type="text/css" rel="stylesheet"> <script type="text/javascript"> <!-/* This function switches the attribute ALT_STYLES (alternate Tablestyles) for item mytable 1. Get actual value for attribute ALT_STYLES 2. Send Commando with new attribute to BW Server */ function switch_table_style(mytable) { var prop = SAPBWGetItemProp(mytable); var table_style='X'; if (prop != null){ for(i=1;i<prop.length;i++){ if (prop[i][0] == "ALT_STYLES") table_style = prop[i][1]; } } if (table_style =='X') { Web API Reference BW 3.5 263 SAP Online Help 25.02.2005 table_style=' ' } else table_style = 'X'; SAPBWOpenURL(SAP_BW_URL_Get() +'&item=' + mytable +'&alt_styles=' + table_style); } /* function to set the correct button style for button mybutton depending on ALT_STYLES attribute for item mytable 1. Get actual value for attribute ALT_STYLES for table mytable 2. Change class Attribute for button mybutton*/ function set_button(mytable, mybutton) { var prop = SAPBWGetItemProp(mytable); var table_style='X'; if (prop != null){ for(i=1;i<prop.length;i++){ if (prop[i][0] == "ALT_STYLES") table_style = prop[i][1]; } } if (table_style !='X') { document.getElementById(mybutton).setAttribute('className', 'SAPBEXBtnEmph','false'); } } --> </script> </HEAD> <BODY> <P><object> <param name="OWNER" value="SAP_BW"> <param name="CMD" value="GET_ITEM"> <param name="NAME" value="TABLE_1"> <param name="ITEM_CLASS" value="CL_RSR_WWW_ITEM_GRID"> <param name="DATA_PROVIDER" value="DATAPROVIDER_1"> <param name="GENERATE_CAPTION" value=""> <param name="WIDTH" value="399"> ITEM: TABLE_1 </object></P> <!-- Include a button in HTML with id mybutton1. By clicking on link the function switch_table_style for item TABLE_1 will be executed --> <table class="SAPBEXBtnStdBorder" cellspacing="0" cellpadding="0" border="0"><tr><td> <table> <tr> <td class="SAPBEXBtnStd" id="mybutton1"><A href="javascript:switch_table_style('TABLE_1');">Alternate Styles</A> Web API Reference BW 3.5 264 SAP Online Help 25.02.2005 </td> </tr> </table> </td> </tr> </table> <!-- call function set_button, to set the correct style class for button mybutton1--> <script type="text/javascript"> <!-set_button('TABLE_1', 'mybutton1'); --> </script> </BODY> </HTML> If you copy the code from the example, make the following changes in the formatting: • Remove the space between the character ‘=’ and ‘”’ in the BW object tags. • Make sure that the character string for HTML comments is set correctly. Before ‘<! ‘ (Beginning of HTML comment) or before ‘>’ (end of HTML comments) there should be two minus signs / hyphens (--). Web API Reference BW 3.5 265 SAP Online Help 25.02.2005 Using Several Tab Pages In this example, a tab page is to be created. Tab pages can also be created using frameset technology in which different Web templates are used. This example uses DHTML to create the tab page; all objects are contained in a Web template. You cannot work with pure DHTML since the complete page is frequently reloaded for server requests. Instead, the page status must be transferred back to the server. A dedicated BW object whose attribute is set or not set to ‘hidden’ is suitable here. The HTML tags that display the tab pages are accessed via head_TABx. X is a whole number counting up from 1. The HTML tags for the actual display area are accessed via TABx. There is a Web item in each display area (technical name: TABx). Additional Web items can also be added. The technical names of these Web items must begin with TABx. When switching the tab pages, a request is sent to the server that sets the hidden attribute of the appropriate Web item to ‘ ‘. All other Web items are set to hidden=’X’. The JavaScript function set_actual_tab checks which Web item (TABx) is currently visible. The respective tab page is marked as selected for this Web item. For other Web items, the associated display area is switched to hidden. From Release SAP BW 3.5, you can also work with the Web item Web Template as an alternative. When you do this, each display area is saved in a subtemplate. The subtemplates are inserted into the main template using the Web Template Web item and are made visible or hidden as needed. You can find more information on the Web Template Web Item under Web Template [Seite 100]. <!-- BW data source object tags --> <object> <param name="OWNER" value="SAP_BW"> <param name="CMD" value="SET_DATA_PROVIDER"> <param name="NAME" value="DATAPROVIDER_2"> <param name="DATA_PROVIDER_ID" value=""> DATA_PROVIDER: DATAPROVIDER_2 </object> <object> <param name="OWNER" value="SAP_BW"> <param name="CMD" value="SET_DATA_PROVIDER"> <param name="NAME" value="DATAPROVIDER_1"> <param name="DATA_PROVIDER_ID" value=""> DATA_PROVIDER: DATAPROVIDER_1 </object> <object> Web API Reference BW 3.5 266 SAP Online Help 25.02.2005 <param name="OWNER" value="SAP_BW"> <param name="CMD" value="SET_PROPERTIES"> <param name="TEMPLATE_ID" value="EXAMPLE_TEMPLATE_2"> TEMPLATE PROPERTIES </object> <HTML> <HEAD> <TITLE>BW Web Application</TITLE> <link href= "/sap/bw/mime/BEx/StyleSheets/BWReports.css" type="text/css" rel="stylesheet"> <script type="text/javascript"> <!-/* function goto_tab: Show all items, starting with tabname, Hide all other items */ function goto_tab(tabname) { SAPBWOpenURL(SAP_BW_URL_Get()+'&item=TAB*&multi=X&hidden=X&cmd_1=item%3d'+tabname+'*%26hid den%3d %26multi%3dX'); } /* DHTML function to set correct span-Tag visible For each Tab in Tab-Header (head_TAB) check, if item TABx is visible If Item is visible set Header as selected Otherwise set corresponding span-Tag to not visible */ function set_actual_tab() { i=0; do { i++; if (document.getElementById('head_TAB'+i) != null) { /* Check if Object tag is hidden */ var prop = SAPBWGetItemProp('TAB'+i); var hidden=true; if (prop != null){ for(j=1;j<prop.length;j++){ if (prop[j][0] == "HIDDEN") hidden = (prop[j][1]=='X'); } } if (hidden) { document.getElementById("TAB"+i).setAttribute('style', 'display:none;visibility:false;',false); } else { document.getElementById("head_TAB"+i).setAttribute('className', 'SAPBEXTbsTABsel',false); } Web API Reference BW 3.5 267 SAP Online Help 25.02.2005 } } while (document.getElementById('head_TAB'+i) != null) } --> </script> </HEAD> <BODY> <table cellspacing="0" cellpadding="5" border="0" id="tabheader"> <tr> <td class="SAPBEXTbsTab" id="head_TAB1"><A href="javascript:goto_tab('TAB1')">Tab 1</A> </td> <td class="SAPBEXTbsTab" id="head_TAB2"><A href="javascript:goto_tab('TAB2')">Tab 2</A> </td> </tr> </table> <table width="100%" class="SAPBEXTbsBdyEdg" cellspacing="0" cellpadding="5" border="0"> <tr> <td valign="top" > <span id="TAB1"> <object> <param name="OWNER" value="SAP_BW"> <param name="CMD" value="GET_ITEM"> <param name="NAME" value="TAB1"> <param name="ITEM_CLASS" value="CL_RSR_WWW_ITEM_GRID"> <param name="DATA_PROVIDER" value="DATAPROVIDER_1"> ITEM: TAB1 </object> </span> <span id="TAB2" > <object> <param name="OWNER" value="SAP_BW"> <param name="CMD" value="GET_ITEM"> <param name="NAME" value="TAB2"> <param name="ITEM_CLASS" value="CL_RSR_WWW_ITEM_GRID"> <param name="DATA_PROVIDER" value="DATAPROVIDER_2"> <param name="HIDDEN" value="X"> ITEM: TAB2 </object> </span> </td> </tr> Web API Reference BW 3.5 268 SAP Online Help 25.02.2005 </table> <script type="text/javascript"> <!-/* This function call is needed to set the correct state */ set_actual_tab(); --> </script> </BODY> </HTML> If you want to copy the coding from the example, you need to remove the space between ‘ =’ and ‘ “ ‘ in the BW object tags. Web API Reference BW 3.5 269 SAP Online Help 25.02.2005 Example Scenario for the Parameter NO_OUTPUT In the example scenario, you use a frameset with a display area and a control frame. You want to influence the display area from the control frame. For each structure element of the data provider, the scaling factor should be set to 1,000. Since, potentially, there could be some structure elements, it could happen that the sequence of commands becomes to large due to the length limitations for URLs. For this reason, the commands (SET_VALUE_PROPERTIES) are sent individually to the display template; the parameter NOT_OUTPUT is used during this process so that the data are read only after the last command. The following describes the example scenario for the involved Web templates: Web Template NOT_OUTPUT_EXAMPLE_FRAMESET <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd"> <html> <head> <title>No Output Example Frameset Template</title> </head> <frameset rows="20%,80%"> <frame src="<SAP_BW_URL cmd='LDOC' TEMPLATE_ID='NO_OUTPUT_FRAME_TOP'>" name="Top"> <frame src="<SAP_BW_URL cmd='LDOC' TEMPLATE_ID='NO_OUTPUT_FRAME_DISPLAY'>" name="display"> <noframes> Browser doesn’t support frames <noframes> </frameset> </html> The frameset template loads the Web template NO_OUTPUT_FRAME_TOP into the upper frame and the Web template NO_OUTPUT_FRAME_DISPLAY into the lower frame. Note that this example can only be edited in text mode due to the use of framesets in the Web Application Designer. For more information, see Enhanced Editing in Text Mode [Extern]. Web Template NO_OUTPUT_FRAME_DISPLAY <HTML> <!-- BW data source object tags --> <object> Web API Reference BW 3.5 270 SAP Online Help 25.02.2005 <param name="OWNER" value="SAP_BW"/> <param name="CMD" value="SET_DATA_PROVIDER"/> <param name="NAME" value="DATAPROVIDER_1"/> DATA_PROVIDER: DATAPROVIDER_1 </object> <object> <param name="OWNER" value="SAP_BW"/> <param name="CMD" value="SET_PROPERTIES"/> <param name="TEMPLATE_ID" value="NO_OUTPUT_FRAME_DISPLAY"/> TEMPLATE PROPERTIES </object> <HEAD> <META NAME="GENERATOR" Content="Microsoft DHTML Editing Control"> <TITLE>BW Web Application</TITLE> <link href= "/sap/bw/Mime/BEx/StyleSheets/BWReports.css" type="text/css" rel="stylesheet"/> </HEAD> <BODY> <P><object> <param name="OWNER" value="SAP_BW"/> <param name="CMD" value="GET_ITEM"/> <param name="NAME" value="TABLE_1"/> <param name="ITEM_CLASS" value="CL_RSR_WWW_ITEM_GRID"/> <param name="DATA_PROVIDER" value="DATAPROVIDER_1"/> ITEM: TABLE_1 </object></P> <P id="keyfigures" style="DISPLAY: none; VISIBILITY: hidden"><object> <param name="OWNER" value="SAP_BW"/> <param name="CMD" value="GET_ITEM"/> <param name="NAME" value="DROPDOWNBOX_1"/> <param name="ITEM_CLASS" value="CL_RSR_WWW_ITEM_FILTER_DDOWN"/> <param name="DATA_PROVIDER" value="DATAPROVIDER_1"/> <param name="GENERATE_CAPTION" value=""/> <param name="IOBJNM" value="BHEFB4AILNIG728R8DP3ET51R"/> <param name="SHOW_LABEL" value=""/> <param name="ONLY_VALUES" value="X"/> ITEM: DROPDOWNBOX_1 </object></P> </BODY> </HTML> Web API Reference BW 3.5 271 SAP Online Help 25.02.2005 In addition to containing the table for data display, the Web template contains the Web item Dropdown Box, with which the structure elements can be selected. This Web item possesses the attribute SHOW_LABEL=” “, ONLY_VALUES=X and GENERATE_CAPTION=” “. This leads to generation of <Oprtion> tags only. The Web item can be found within a <P> tag that is switched to hidden. In order to address the <P> tag, an ID is also assigned. Web Template NO_OUTPUT_FRAME_TOP <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <!-- BW data source object tags --> <object> <param name="OWNER" value="SAP_BW"/> <param name="CMD" value="SET_PROPERTIES"/> <param name="TEMPLATE_ID" value=" NO_OUTPUT_FRAME_TOP "/> TEMPLATE PROPERTIES </object> <head> <title> BW Web Application </title> <script> <!-function set_scaling() { /* Get the optionnode */ optionnode = parent.display.document.getElementById('keyfigures').firstChild; /* While node exist */ while (optionnode!= null) { /* Check whether correct node type */ if ((optionnode.nodeType == '1') && (optionnode.nodeName == 'OPTION') ) { kyf = optionnode.getAttribute('value'); if (kyf!= '!ALL') { /* For keyfigure fire URL with NO_OUTPUT */ url = parent.display.SAP_BW_URL_Get() + '&CMD=SET_VALUE_PROPERTIES&data_provider=DATAPROVIDER_1&STRUCTURE_MEMBER_1=' + kyf + '&SCALING_FACTOR=3&NO_OUTPUT=X'; parent.display.SAPBWOpenURL(url); } } optionnode = optionnode.nextSibling; } /* Fire URL without NO_OUTPUT */ url = parent.display.SAP_BW_URL_Get(); Web API Reference BW 3.5 272 SAP Online Help 25.02.2005 parent.display.SAPBWOpenURL(url); } --> </script> </head> <body> <A href="javascript:set_scaling()">Set Scaling factor</A> </body> </html> The complete JavaScript logic is contained in this Web template. If you click on the link Set Scaling Factor link in the Web application, the JavaScript function set_scaling is called. This JavaScript function processes the generated <Option> tags of the Web item from the Web template NO_OUTPUT_FRAME_DISPLAY. If a corret tag is found, the tag attribute „value“ is read. The Unique-ID (UID) of the structure element is found here that is used to change the scaling factor of the structure element with the help of the Web API command SET_VALUE_PROPERTIES. The NO_OUTPUT parameter is used so that the data are not yet read. Once all of the key figures have been processed, a command is sent to the server again without setting the parameter NO_OUTPUT this time. The data is read and returned. Web API Reference BW 3.5 273 SAP Online Help 25.02.2005 XML Web Item: Data Provider Information For clarity we are providing a short example of using the Web item Data Provider Information. In order to make good use of the XML Web item, you will need JavaScript or XSLT knowledge. In this example, the internal values of a data provider will be read and displayed in a message box using the Web item Data Provider - Information [Seite 99]). <HTML> <!-- BW data source object tags --> <object> <param name="OWNER" value="SAP_BW"/> <param name="CMD" value="SET_DATA_PROVIDER"/> <param name="NAME" value="DATAPROVIDER_1"/> DATA_PROVIDER: DATAPROVIDER_1 </object> <object> <param name="OWNER" value="SAP_BW"/> <param name="CMD" value="SET_PROPERTIES"/> <param name="TEMPLATE_ID" value="XML_EASY_EXAMPLE"/> TEMPLATE PROPERTIES </object> <HEAD> <META NAME="GENERATOR" Content="Microsoft DHTML Editing Control"> <TITLE>BW Web Application</TITLE> <link href= "/sap/bw/Mime/BEx/StyleSheets/BWReports.css" type="text/css" rel="stylesheet"/> <script type="text/javascript"> <!-function alert_internal_values() { startnode = document.getElementById('XMLQUERYVIEWDATA_1'); /* Parse DOM until item_node for cell_data is reached */ item_node = startnode.firstChild.firstChild.nextSibling.nextSibling.nextSibling.firstChild.firstChild.firstChild; myalert = 'The internal values are: '; while (item_node!= null) { /* The internal value is the second Child element of the item_node */ myalert = myalert + ' ' + item_node.firstChild.nextSibling.firstChild.nodeValue; item_node = item_node.nextSibling; /* nextr item_node */ } alert(myalert); } Web API Reference BW 3.5 274 SAP Online Help 25.02.2005 --> </script> </HEAD> <BODY> <P><object> <param name="OWNER" value="SAP_BW"/> <param name="CMD" value="GET_ITEM"/> <param name="NAME" value="TABLE_1"/> <param name="ITEM_CLASS" value="CL_RSR_WWW_ITEM_GRID"/> <param name="DATA_PROVIDER" value="DATAPROVIDER_1"/> ITEM: TABLE_1 </object></P> <P><object> <param name="OWNER" value="SAP_BW"/> <param name="CMD" value="GET_ITEM"/> <param name="NAME" value="XMLQUERYVIEWDATA_1"/> <param name="ITEM_CLASS" value="CL_RSR_WWW_ITEM_XML_QUERYVIEW"/> <param name="DATA_PROVIDER" value="DATAPROVIDER_1"/> <param name="GENERATE_LINKS" value=""/> <param name="GENERATE_CAPTION" value=""/> <param name="NAVIGATIONAL_STATE" value=""/> <param name="RESULT_SET" value="X"/> ITEM: XMLQUERYVIEWDATA_1 </object></P> <A href="javascript: alert_internal_values();">Click here to see the internal values of the table </a> </BODY> </HTML> The generated XML is provided here to explain the JavaScript function alert_internal_values: <xml id="XMLQUERYVIEWDATA_1"> <queryview status="DataAvailable"> <?xml version="1.0" encoding="iso-8859-1"?> <asx:abap xmlns:asx="http://www.sap.com/abapxml" version="1.0"> <asx:values...</asx:values></asx:abap> <?xml version="1.0" encoding="iso-8859-1"?> <asx:abap xmlns:asx="http://www.sap.com/abapxml" version="1.0"> <asx:values> <CELL_DATA> <item><CELL_ORDINAL>000000</CELL_ORDINAL><VALUE>1931710.04800</VALUE><FORMATTED_VALUE >$ 1.931.710,05</FORMATTED_VALUE>...</item> Web API Reference BW 3.5 275 SAP Online Help 25.02.2005 <item><CELL_ORDINAL>000001</CELL_ORDINAL><VALUE>153849431</VALUE><FORMATTED_VALUE>15 3.849.431 PC</FORMATTED_VALUE>...</item> ... </CELL_DATA> </asx:values> </asx:abap> </queryview> </xml With startnode = document.getElementById('XMLQUERYVIEWDATA_1'); you get the start node <xml id="XMLQUERYVIEWDATA_1">. The first lower level node of the start node is the tag <queryview>. The first lower level node of this node is the control statement <?xml >. The second lower level node of the <queryview> tag is <asx:abap xmlns:asx="http://www.sap.com/abapxml" version="1.0">. Since only the cell data are of interest for this scenario, the fourth lower level node of the <queryview> tag is relevant. The first lower level node of this tag is <asx:values>. The lower level node of this node is then <CELL_DATA>. Within the <CELL_DATA>, there are individual <item> tags. In order to get to the internal value (tag <VALUE>) within the <item> tags, the second lower level node has to be considered. The content of the <VALUE> tag is an (implicit) text node, thus it is a lower level node of the <VALUE> tag. Web API Reference BW 3.5 276 SAP Online Help 25.02.2005 Web Design API for Tables Purpose The Web Design Application Programming Interface (Web Design API) is aimed at Web designers and ABAP programmers that want to create Web applications for highly individual scenarios, such as BI cockpits, based on BEx Web application design and want to change the display of tables or navigation blocks to meet their own requirements. The Web Design API enables you to modify individual cell data (characteristic values, column headers, value cells, and so on) with relation to content, display and navigation options. Making good use of the Web Design API for tables depends on the technical design and economic questions. Thus it does make sense to use the Web Design API for Tables in every case. Certain modifications in relation to content, display and navigation options can also be made with the BEx Query Designer [Extern]. Other adaptations can be made with the BW Stylesheets [Extern]. In this way, many changes to the display can be made using BW stylesheets (for example, color) or the Query Designer (for example, scaling). This is especially important when all cells of a cell type (for example, all number values in data cells) are to be changed. When only certain cells of a cell type are to be changed in their display, the Web Design API for Tables with its own CSS classes would be useful. Complex modifications to the content (for example display as symbol) or to the navigation options (for example, inserting your own links) can usually only be done using the Web Design API for Tables. Process Flow For extensive information on the required creation of the ABAP class for the Web Design API for Tables, see Creating and Using an ABAP Class [Seite 278]. For extensive information on the options that are available with the Web Design API for Tables for modification of cell contents and display, see Table Interface [Seite 281]. ... Result The next time you call up the Web template, your class for adjusting the table contents is called up. For test purposes, you can examine the generation of the HTML in the ABAP debugger. For more information, see Using and Creating ABAP Classes [Seite 278]. Web API Reference BW 3.5 277 SAP Online Help 25.02.2005 Creating and Using ABAP Classes Use The Web Design API for Tables enables you to modify individual cell data in relation to content, display and navigation options. To do this, you create your own ABAP class that inherits the associated properties and parameters from the class CL_RSR_WWW_MODIFY_TABLE and you redefine one or more methods for this class. Prerequisites You have created a Web application that includes the Web item Table and/or the Web item Generic Navigation Block. Procedure Create ABAP Class ... 1. From the SAP Easy Access screen, choose Tools → ABAP Workbench → Development → Class Builder (transaction SE24). See also Class Builder [Extern]. You can also use the Object Navigator from the ABAP Workbench (transaction SE 80) to generate a class. See also Object Navigator [Extern]. 2. To create a new class, under Object Type, enter a technical name for your class (for example, ZCL_RSR_WWW_MODIFY_TABLE) and choose (Create). The Create Class YourClassName dialog box then appears. 3. Save your class. You get to the Object Catalog screen. 4. Depending on the system configuration in regard to changes and the transport of objects, either choose a package or save your class as a local object. For more information, speak to your system administrator. The Class Builder: Change Class YOURCLASSNAME screen. 5. Choose Superclass on the Properties tab page. Under Inherits from, enter CL_RSR_WWW_MODIFY_TABLE as the superclass. 6. To see all of the inherited properties and methods of the class CL_RSR_WWW_MODIFY_CLASS in your ABAP class, choose (Save). 7. On the Methods tab page, choose a method (for example, CHARACTERISTIC_CELL or GET_CELL_INFO) that you want to redefine and choose (Redefine). 8. To change the implementation of the method, call up the method name by double clicking. 9. To get back to the original screen, choose (Back) 10. Save your changes. 11. To activate event linking, choose (Activate). Using an ABAP Class in a Web Template To be able to use the ABAP class you created, it must be included in a Web template. ... Web API Reference BW 3.5 278 SAP Online Help 25.02.2005 1. Open your Web template that contains the Web item Table and/or Generic Navigation Block in the BEx Web Application Designer. 2. Use the HTML tab page to switch to the HTML view of the Web Application Designer. 3. Navigate to the Object Tag of the Web Item Table and/or the Web Item Generic Navigation Block (CL_RSR_WW_ITEM_GRID and/or CL_RSR_WWW_ITEM_NAV_BLOCK) and insert the following parameter line into the HTML: <object>… <param name=“MODIFY_CLASS“ value=”YourClassName”/> …</object> <object>… <param name=“MODIFY_CLASS“ value=”ZCL_RSR_WWW_MODIFY_TABLE”/> …</object> 4. Save the changes. 5. Execute the Web template in the browser. Debug ABAP Class For test purposes, you can debug the ABAP class. By setting breakpoints in the redefined methods and using the ABAP debugger, you can determine when the individual methods are called and which information they provide. To better understand the individual methods, you can redefine the methods for test purposes. You can set a breakpoint on the individual method without inserting code. You can see all values for the parameters assigned to the method in the debugger. See also Debugger [Extern]. ... 1. From the SAP Easy Access screen, choose Tools → ABAP Workbench → Development → Class Builder (transaction SE24). 2. Under the object type, enter the name of the ABAP class you created. 3. Choose (Change). 4. Double click on one of the methods in the Methods tab page that you have changed when creating your ABAP class. 5. To set an external (HTTP) breakpoint in your method, in the menu, choose Utilities → Breakpoints → Set/Delete. • Two types of breakpoints exist: External (HTTP) Breakpoints enable debugging in the Web browser. Session Breakpoints enable debugging within transactions. BEx Web Applications are usually executed in the Web browser. The query monitor (RSRT2) transaction allows you to display a BEx Web application in the SAP GUI. Depending on how you call up your Web application you can choose the appropriate breakpoint type. • To be able to set an external breakpoint, you have to set the external debugging to active. You can set external debugging to active in the menu under Utilities → Settings... → ABAP Editor → Debugging in the External Debugging field. . Web API Reference BW 3.5 279 SAP Online Help 25.02.2005 6. Close all Web browser windows or query monitor instances (RSRT2) before you call the Web application in which you have included your ABAP class. Otherwise the debugger could not stop at the set breakpoint. 7. Execute the Web application in the Web browser or in the query monitor transaction. You reach the ABAP debugger that stops at the breakpoint you set. Result You have created an ABAP class and have redefined one or more methods to specifically change the display of tables and the generic navigation block with the help of the Web Design API for tables. Web API Reference BW 3.5 280 SAP Online Help 25.02.2005 Table Interface Use The table interface enables you to display tables or navigation blocks in BEx Web applications as you choose. Features Your options include anything from making simple changes to the display to making data-specific enhancements to the navigation options and display. The technical realization is done with an ABAP class. For extensive information on creating the ABAP class and its use in a Web template, see Creating and Using an ABAP Class [Seite 278]. The table interface has the following functions: • Attributes [Seite 282] The attributes include the data from the data provider and general information, such as generation parameters of the table (parameters from the URL), as well as information on whether navigation links are to be created or whether the use of JavaScript is allowed. • Events [Seite 292] The results enable determination of information on various times, such as at the time of initialization of the table. • Methods for Manipulation of Cell Contents [Seite 293] The methods for manipulation of cell contents are central to the table interface. Only implement (redefine) the methods for the cell types that you want to manipulate. Note that generally, not all cells of a cell type are manipulated - only specific cells depending on the characteristic, the key figure and/or the value. These specific cells can be identified using the importing parameters of methods for manipulation of cell contents. • Service Methods [Seite 307] Service methods can be used within methods for manipulation of cell contents or within the events. Service methods enable you to generate links, insert JavaScript, send messages, request information on specific cells or on the current navigational state, read the path of symbol directories in the MIME Repository and to determine specific attributes for the table interface. Web API Reference BW 3.5 281 SAP Online Help 25.02.2005 Attributes Definition Functional components of the table interface. Structure The following instance attributes of the class are filled automatically. They get their values from the Web application framework. The attributes are read-only. Attribute Description N_ITEM_NAME Logical name of the table This attribute is needed for command URLs. You can use this attribute, for example, to change attributes in the table. N_GENERATE_LINKS Generate navigation links If the value = “X”, URLs can be generated. If the value is blank, the item is for display only. It is not possible to interact with the item. N_ALT_STYLES Display zebra list If the value = “X”, the formatting is the same in every other row. N_STATELESS Calling the Web application without interaction If the value = “X”, the Web application is called and the session is dismantled on the application server. SAP BW 2.0 supports no further interaction. Web API Reference BW 3.5 282 SAP Online Help N_R_CREATION_PARAMETERS 25.02.2005 Creation parameters for the table Using the reference for an instance of the class CL_RSR_PARAMETER, the system is able to read the value-name pairs that have been used in the generation of the table. Methods such as GET are used to read the values. The parameters of the start URL and the name-value pairs specified in the object tag of the item in the Web template belong to these name-value pairs. This means that the start URL or object tag (in the Web template) can transfer parameters to the class. This increases the number of times a class can be reused and the different areas where the class can be used, for example, by using customer-specific parameters that configure the class individually. N_JAVASCRIPT Using Java Script If the value = “X”, Java Script functions are supported. Otherwise, you must not use Java Script functions, since you cannot be sure that the requesting Web browser supports Java Script. N_DATA_PROVIDER_NAME Logical name of the data provider Needed in the generation of navigation URLs. N_NO_DATA No relevant data found N_NO_AUTHORIZATION No authorization for displaying data N_R_DATA_SET Data in the data provider This attribute is needed only for special applications. As a rule, the information that is transferred by the method interfaces is enough to determine the cell contents. For more information see Datasets [Seite 284]. Web API Reference BW 3.5 283 SAP Online Help 25.02.2005 Datasets Definition The dataset contains the data for the query view. Use Special applications require information that cannot be obtained using the method interfaces. For some applications you need more information than is contained in the cell contents. For example, you need the list of available characteristics or the contents of the dynamic filter before you are able to jump from one report into another. An understanding of the enhancement described below is not necessary for the use of the table interface. You have made sure that the data from the dataset (N_R_DATA_SET) is always up to date. The N_SX_VERSION_20A_1 attribute, type RSRDS_SX_DATA_SET_20A_1, is filled automatically. The data consists of both the metadata (a catalog of characteristics (AXIS_INFO) and so on) and the displayed values (AXIS_DATA and CELL_DATA). Structure The instance attribute N_R_DATA_SET → N_SX_VERSION_20A_1 has the following components: Component Description AXIS_INFO [Seite 285] Metadata description of the characteristics, attributes, and structures on the axes. AXIS_DATA [Seite 287] Characteristic values, attribute values, and structural components according to the sequence they appear in on the axes. CELL_DATA [Seite 289] Value cells: The cells are arranged by row first, and then by column. TXT_SYMBOLS [Seite 291] Text elements for the query Web API Reference BW 3.5 284 SAP Online Help 25.02.2005 AXIS_INFO Definition This component describes the properties of the structures, characteristics, and attributes, and how they are distributed between the axes. Structure The AXIS_INFO is a table of axes (rows, columns, and filters) with the appropriate axes components. AXIS_INFO Description AXIS Axis ID 0 : Columns 1 : Rows 255 : Filters NCHARS Value cells The cells are arranged by row first, and then by column. NCOORDS Number of objects on the axis (number of rows / columns / filter values) CHARS Characteristics with their attributes and structures on the axis. The complex table CHARS has the following structure: CHARS Description CHANM Name of the characteristic or of the structure HIENM Hierarchy name, if the hierarchy is active VERSION Hierarchy version DATETO Key date for the hierarchy CAPTION Name of the characteristic or of the structure CHAPRSNT Characteristic display 0 : key and text 1 : Text 2 : Key 3 : Text and key 4 : Long text 5 : Medium text 6 : No display ATTRINM Web API Reference Attributes for this characteristic BW 3.5 285 SAP Online Help 25.02.2005 ATTRINM is a table of the attributes for the characteristic. It has the following structure: ATTRINM Description ATTRINM Name of the attribute CAPTION Name of the attribute CHAPRSNT Attribute display 0 : key and text 1 : Text 2 : Key 3 : Text and key 4 : Long text 5 : Medium text Web API Reference BW 3.5 286 SAP Online Help 25.02.2005 AXIS_DATA Definition The component AXIS_DATA describes the contents of the axis. Structure AXIS_DATA is a table with the following structure: AXIS_DATA Description AXIS Axis ID 0 : Columns 1 : Rows 255 : Filters SET Axis contents The complex table SET has the following structure: SET Description TUPLE_ORDINAL Number of the entry beginning with 0 on the axis CHANM Name of the characteristic or of the structure CAPTION Text for the characteristic value CHAVL Internal key value for the characteristic value This is needed, for example, for the filter operations. CHAVL_EXT External key value for the characteristic value This corresponds with CHAVL after the application of the conversion exit. NIOBJNM With hierarchy nodes, this is the name of the node characteristic (0HIERNODE for text nodes). TLEVEL Hierarchy level of the entry DRILLSTATE Extent to which the entry is expanded (for an active hierarchy). L : Hierarchy leaf - : Expanded node + : Collapsed node Web API Reference BW 3.5 287 SAP Online Help OPT 25.02.2005 Only with filters: EQ : Single value LT : Less than LE : Less than or equal to GT : Greater than GE : Greater than or equal to BL : From-value with intervals (two rows) BH : To-value with intervals SIGN I : Include E : Exclude ATTRIBUTES Attribute values ATTRIBUTES is a table with the following structure: ATTRIBUTES Description ATTRINM Name of the attribute CAPTION Text for an attribute value ATTRIVL Key for the attribute value This describes the contents of an axis. Web API Reference BW 3.5 288 SAP Online Help 25.02.2005 CELL_DATA Definition The CELL_DATA component describes the value cells. The number cells of the query view are given as the assigned table of rows for BAPI type BAPI6111CD. If you display the query view data as a table, the assignment of cells corresponds to that of the data block, in which the assignment is run first using the rows and then using the columns. The index of a specific value is therefore calculated as follows: Index = Column position + (row position – 1)* number of columns Structure The data structure is as follows: Component Description CELL_ORDINAL Numbering of the values begins with 0 CELL_ORDINAL is always smaller by 1 than the index of the rows VALUE Value FORMATTED_VALUE Formatted value Unit and currency are used already in this field VALUE_TYPE Value type The value type accepts the following values: ‘ ’ normal, valid value ‘0’ division by 0 ‘1’ value cannot be determined ‘3’ value constructed from different currencies ‘5’ zero value ‘9’ surplus ‘D’ date ‘T’ time ‘A’ no authorization for this value CURRENCY Currency identifier UNIT Unit identifier Web API Reference BW 3.5 289 SAP Online Help MWKZ 25.02.2005 Amount/value key figure The amount/value key figure accepts the following values: 'W' value ‘M’ amount ‘P’ price ‘Q’ ratio ‘%’ percentage value ‘C’ counter ‘F’ real number ‘D’ date ‘T’ time NUM_SCALE Scaling factors 0 for 1, 1 for 10, 2 for 100, 3 for 1000, ... NUM_PREC Precision of the number in decimal places CELL_STATUS Not used BACK_COLOR Not used Web API Reference BW 3.5 290 SAP Online Help 25.02.2005 TXT_SYMBOLS Definition The component TXT_SYMBOLS describes the text elements of the query. The text elements are available as a table made up of RRX_TXT_SYMBOLS rows. Structure The text elements have the following structure (only the most important components): Component Description SYM_TYPE Type of text element ‘V’ for variable ‘F’ for filter value ‘C’ for general text element SYM_NAME Name of the object With variables this is the variable name, with filters it is the filter characteristic, and with general text elements it is the name of the element. A list of the names of the general text elements is stored under Text Elements [Seite 43]. SYM_FS Follow-on record number A text element can be distributed over several rows, for example, in intervals. This field gives you the row number of a component within a text element. If SYM_FS=0, the text element is a new text element. SYM_BEGIN_GROUP New group within a text element Groups are usually separated by semicolons (;) SYM_CAPTION Name of the text element SYM_VALUE Value of the component of the text element Web API Reference BW 3.5 291 SAP Online Help 25.02.2005 Events Definition Functional components of the table interface. Use Events allow you to initialize tables. Structure Initialization Initializing a table: You call this method is before processing. Using the reference from the dataset, you can analyze metadata for the navigational state as well as the data itself. All attributes of the class that were listed beforehand are filled at this point. Method Start New Rows You call the following method before starting a new row. You can execute a suitable initialization for the rows. Method New_Row Importing Parameter Description I_Y New row numbers Header Completed The following method is called after you have processed the table header. You can execute a suitable initialization for the rows. Method Header_Finished Importing Parameter Description I_Y New row numbers Completion This method gives you the option of carrying out further operations after you have finished the table. For example, setting Java Script functions using the method “Set_Javascript_Function” (see Service Methods [Seite 307]) or cleaning up the table. Method Web API Reference Finished BW 3.5 292 SAP Online Help 25.02.2005 Manipulating Cell Contents Definition Functional components of the table interface. Use You can use a set of methods to manipulate cell contents. Only implement the methods for the cell types that you want to manipulate. Standard contents will be used for all other cell types. Standard contents may change between releases/support packages. If you want to change the contents of a cell, we recommend that you overwrite the contents of, for example, C_CELL_CONTENT completely and do not process the field with REPLACE or a similar operation. Features You can use the following methods to manipulate cell contents: • CAPTION_CELL: Headers [Seite 295] • SCALING_FACTOR_CELL: Scaling Factors [Seite 296] • CHARACTERISTIC_CELL: Characteristic Values [Seite 297] • ATTRIBUTE_CELL: Attribute Values [Seite 299] • STRUCTURE_CELL: Structural Components [Seite 300] • DATA_CELL: Data Cells [Seite 301] • ERROR_CELL: Error Cells [Seite 302] • NAV_BLOCK_LABEL: Label Area of Navigation Block [Seite 303] • NAV_BLOCK_VALUE: Filter of Navigation Block [Seite 305] All methods for manipulation of cell contents include Importing and Changing Parameters. The importing parameters provide cell-specific information such as content, style, coordinates, characteristic, key figure, value, etc. The importing parameters depend on cell type. You can use the changing parameters, which provide the standard values, to change the ID of the cell, the cell content, the style of the cell and the extension of the TD tag. As these parameters are methodindependent, they are listed only once here. Changing Parameter Description C_CELL_ID Cell ID If you leave this parameter empty, the cell has no ID. The ID is used to process the cell contents with JavaScript. C_CELL_CONTENT Cell Contents The cell contents themselves can be very simple (for example, a number) or very complex (for example, for hierarchy nodes: icons with expanded/collapsed URL and text). Web API Reference BW 3.5 293 SAP Online Help 25.02.2005 C_CELL_STYLE Style of Cell The style defines the color, font, font size, spacing, and so on of the cell. The styles are defined in the cascading stylesheet. The cascading stylesheet is assigned to the Web template. C_CELL_TD_EXTEND Extension of TD tag Here you can set the properties such as the width, height, alignment or color of the cell. This parameter is not normally set because many of the properties are already defined when the style is defined. The cell contents (C_CELL_CONTENT) corresponds to the inside part of the TD tag. The extension of the TD tag is inserted into the opening TD tag. The HTML <td> and </td> is automatically generated by the Web Application Framework: ..._CELL <td C_TD_EXTEND> C_CELL_CONTENT </td> The changing parameters can be changed depending on the importing parameters. If the information from the importing parameters is not sufficient, additional information can be found using the attributes or the service method GET_CELL_INFO (see Information for a Specific Cell [Seite 311]). Detailed information about the individual importing parameters can be found in the description of the methods for the individual cell types. For more information, see the links under “Features”. You can easily insert MIME objects (images, symbols, logos, etc.) into the contents of the cells. To do this, enter the relative path as a URL, that is, the path information is provided without naming the Web protocol, the host name and the port number. The path should begin with /sap/bw/Mime. This corresponds to the path for service of the SAP Web Application Server (see the transaction maintenance of the service, SICF). Extend the path with the path information for the MIME object in the MIME Repository (transaction SE80) below the /SAP/BW level. Example: Path in the MIME Repository: /SAP/BW/BEx/Icons/pixel.gif Relative path : /asp/bw/Mime/BEx/Icons/pixel.gif For more information on the use of SAP MIME objects, as well as your own MIME objects, see Storing Stylesheets and Symbols [Extern]. Web API Reference BW 3.5 294 SAP Online Help 25.02.2005 Headers Definition You use the Caption_Cell method to adjust the contents of header cells. Structure Method Caption_Cell Importing Parameter Description I_X X coordinate of the cell in the table I_Y Y coordinate of the cell in the table I_IS_EMPTY Cell is empty 'X' = empty I_IOBJNM_ROW Characteristic in the rows In the rows axis, the characteristic, whose header you want to display in the cell. I_ATTRINM_ROW Attribute for characteristic in the rows In the rows axis, the attribute for the characteristic, whose header you want to display in the cell. I_TEXT_ROW Text for characteristic / attribute I_IOBJNM_COLUMN Characteristic in the columns In the columns axis, the characteristic, whose header you want to display in the cell. I_ATTRINM_COLUMN Attribute for characteristic in the columns In the columns axis, the attribute for the characteristic, whose header you want to display in the cell. I_TEXT_COLUMN Text for characteristic / attribute I_ROWSPAN Number of cells that you want to merge along the rows axis I_COLSPAN Number of cells that you want to merge along the columns axis I_IS_REPETITION Repetition 'X' = cell contents is a repetition Web API Reference BW 3.5 295 SAP Online Help 25.02.2005 Scaling Factors Definition You use the Scaling_Factor_Cell method to adjust the contents of cells that display the scaling factors. Structure Method Scaling_Factor_Cell Importing Parameter Description I_X X coordinate of the cell in the table I_Y Y coordinate of the cell in the table I_TEXT Scaling text I_IS_SUM Sum total cell ‘X’ = sum total cell I_NUM_SCALE Scaling factor I_CURRENCY Currency I_UNIT Unit Web API Reference BW 3.5 296 SAP Online Help 25.02.2005 Characteristic Values Definition You use the Characteristic_Cell method to adjust the contents of cells containing values for characteristics. Structure Method Characteristic_Cell Importing Parameter Description I_X X coordinate of the cell in the table I_Y Y coordinate of the cell in the table I_IOBJNM Name of characteristic I_AXIS Axis on which the characteristics are arranged in the drilldown 'X' = columns, 'Y' = rows I_CHAVL_EXT Characteristic value in external display Key value of the characteristic value according to its application in the conversion exit. I_CHAVL Characteristic value in internal display Key value of the characteristic value. This is needed for the filter operations. I_NODE_IOBJNM Name of the node characteristic With characteristic nodes and text nodes, you have to specify the characteristic name (0HIER_NODE). I_TEXT Text for characteristic value I_HRY_ACTIVE Status of the display hierarchy ‘X’ = active I_DRILLSTATE Extent to which the node is expanded 'E' = expanded, 'C' = collapsed I_DISPLAY_LEVEL Display hierarchy level of the node / leaf I_USE_TEXT Cell contents 'X' = text, ' ' = key I_IS_SUM Sum total cell ‘X’ = sum total cell I_IS_REPETITION Repetition 'X' = cell contents is a repetition I_FIRST_CELL Web API Reference First data cell of the characteristic value BW 3.5 297 SAP Online Help 25.02.2005 I_LAST_CELL Last data cell of the characteristic value I_CELLSPAN Number of cells that you want to merge along the drilldown axis I_CELLSPAN_ORT Number of cells that you want to merge vertically along the drilldown axis Web API Reference BW 3.5 298 SAP Online Help 25.02.2005 Attribute Values Definition You use the Attribute_Cell method to adjust the contents of the cells containing attribute values. Structure Method Attribute_Cell Importing Parameter Description I_X X coordinate of the cell in the table I_Y Y coordinate of the cell in the table I_IS_EMPTY Cell is empty 'X' = empty I_IOBJNM Name of characteristic I_ATTRINM Name of attribute I_AXIS Axis on which the characteristics are arranged in the drilldown 'X' = columns, 'Y' = rows I_CHAVL_EXT Attribute value in external display Key value of the attribute value according to its application in the conversion exit. I_CHAVL Attribute value in internal display Key value of the attribute value. I_TEXT Text for attribute value I_USE_TEXT Cell contents 'X' = text, ' ' = key I_IS_SUM Sum total cell ‘X’ = sum total cell I_CELLSPAN Number of cells that you want to merge along the drilldown axis I_IS_REPETITION Repetition 'X' = cell contents is a repetition Web API Reference BW 3.5 299 SAP Online Help 25.02.2005 Structural Components Definition You use the Structure_Cell method to adjust the contents of structural components. Structure Method Structure_Cell Importing Parameter Description I_X X coordinate of the cell in the table I_Y Y coordinate of the cell in the table I_IOBJNM Name of the structure I_AXIS Axis on which the characteristics are arranged in the drilldown 'X' = columns, 'Y' = rows I_STRUCTUR_MEMBER Name of the structural component Key value of the structural component. I_STRUCTUR_MEMBER_2 Name of the structural component of the other structure Key value of the structural component of a second structure (if a second structure is available). This is needed, for example, for sort operations. I_TEXT Name of the structural component I_IS_SUM Sum total cell ‘X’ = sum total cell I_IS_REPETITION Repetition 'X' = cell contents is a repetition I_CELLSPAN Number of cells that you want to merge along the drilldown axis I_CELLSPAN_ORT Number of cells that you want to merge vertically along the drilldown axis Web API Reference BW 3.5 300 SAP Online Help 25.02.2005 Data Cells Definition You use the Data_Cell method to adjust the contents of data cells. Structure Method Data_Cell Importing Parameter Description I_X X coordinate of the cell in the table I_Y Y coordinate of the cell in the table I_VALUE Values of the cell without scaling I_DISPLAY_VALUE Values of the cell after scaling I_NUMERICAL_SCALE Scaling factors I_NUMERICAL_PRECISION Number of places after the decimal point I_CURRENCY Currency Three-character currency ID, for example, USD, ATS, or DEM. I_UNIT Unit Unit according to the application of the threecharacter conversion exit. I_ ALERTLEVEL Alert level 1, 2, 3 = green; 4, 5, 6 = yellow; 7, 8, 9 = red I_IS_SUM Sum total cell ‘X’ = sum total cell You can make many changes, for example, choose to display the alerts as icons, or change the way currencies and units are displayed (units as text, for example). Web API Reference BW 3.5 301 SAP Online Help 25.02.2005 Error Cells Definition You use the Error_Cell method to adjust the contents of error cells. Structure Method Error_Cell Importing Parameter Description I_X X coordinate of the cell in the table I_Y Y coordinate of the cell in the table I_TEXT Error text I_TYPE Error type (S, E, A, I, W) Web API Reference BW 3.5 302 SAP Online Help 25.02.2005 Labeling Area of the Navigation Block Definition You can adjust the contents of the labeling cells of the navigation block with method NAV_BLOCK_LABEL. Structure The area for labeling can be divided in up to 4 columns. Method NAV_BLOCK_LABEL Importing Parameter Description I_IOBJNM Technical name of the characteristic or structure I_IS_STRUCTURE Object is a structure ‘X’ = Yes, ‘ ’ = No I_AXIS Axis on which the characteristics / structure are arranged in the drilldown 'X' = columns, 'Y' = rows I_CAPTION Label text I_HRY_ACTIVE Status of the display hierarchy 'X' = Active Changing Parameter Description C_CELL1_ID ID of cell 1 If you leave this parameter empty, the cell has no ID. The ID can be used to process the cell contents with JavaScript. C_CELL2_ID ID of cell 2 C_CELL3_ID ID of cell 3 C_CELL4_ID ID of cell 4 C_CELL1_CONTENT Cell contents 1 The cell contents themselves can be very simple (for example only a number) or very complex (for example for hierarchy nodes: icons with expanded/collapsed URL and text). C_CELL2_CONTENT Cell contents 2 C_CELL3_CONTENT Cell contents 3 C_CELL4_CONTENT Cell contents 4 Web API Reference BW 3.5 303 SAP Online Help C_CELL1_STYLE 25.02.2005 Style of cell 1 The style defines the color, font, font size, distances, etc. of the cell. The styles are defined in the Cascading Style Sheet. The Cascading Style Sheet is assigned to the template. C_CELL2_STYLE Style of cell 2 C_CELL3_STYLE Style of cell 3 C_CELL4_STYLE Style of cell 4 C_CELL1_TD_EXTEND Extension of TD tag 1 Here you can set the properties such as the width, height, alignment or color of the cell. This parameter is not normally set because many of the properties are already defined when the style is defined. C_CELL2_TD_EXTEND Extension of TD tag 2 C_CELL3_TD_EXTEND Extension of TD tag 3 C_CELL4_TD_EXTEND Extension of TD tag 4 C_CELL1_WIDTH Width of column 1 C_CELL2_WIDTH Width of column 2 C_CELL3_WIDTH Width of column 3 C_CELL4_WIDTH Width of column 4 Web API Reference BW 3.5 304 SAP Online Help 25.02.2005 Filter Area of the Navigation Block Definition You can adjust the contents of the filter cells of the navigation block with method NAV_BLOCK_VALUE. Structure The area for the filter can be divided in up to 4 columns. Method NAV_BLOCK_VALUE Importing Parameter Description I_IOBJNM Technical name of the characteristic or structure I_IS_STRUCTURE Object is a structure ‘X’ = Yes, ‘ ’ = No I_AXIS Axis on which the characteristics / structure are arranged in the drilldown 'X' = columns, 'Y' = rows I_CAPTION Label text I_HRY_ACTIVE Status of the display hierarchy 'X' = Active Changing Parameter Description C_CELL1_ID ID of cell 1 If you leave this parameter empty, the cell has no ID. The ID can be used to process the cell contents with JavaScript. C_CELL2_ID ID of cell 2 C_CELL3_ID ID of cell 3 C_CELL4_ID ID of cell 4 C_CELL1_CONTENT Cell contents 1 The cell contents themselves can be very simple (for example only a number) or very complex (for example for hierarchy nodes: icons with expanded/collapsed URL and text). C_CELL2_CONTENT Cell contents 2 C_CELL3_CONTENT Cell contents 3 C_CELL4_CONTENT Cell contents 4 Web API Reference BW 3.5 305 SAP Online Help C_CELL1_STYLE 25.02.2005 Style of cell 1 The style defines the color, font, font size, distances, etc. of the cell. The styles are defined in the Cascading Style Sheet. The Cascading Style Sheet is assigned to the template. C_CELL2_STYLE Style of cell 2 C_CELL3_STYLE Style of cell 3 C_CELL4_STYLE Style of cell 4 C_CELL1_TD_EXTEND Extension of TD tag 1 Here you can set the properties such as the width, height, alignment or color of the cell. This parameter is not normally set because many of the properties are already defined when the style is defined. C_CELL2_TD_EXTEND Extension of TD tag 2 C_CELL3_TD_EXTEND Extension of TD tag 3 C_CELL4_TD_EXTEND Extension of TD tag 4 C_CELL1_WIDTH Width of column 1 C_CELL2_WIDTH Width of column 2 C_CELL3_WIDTH Width of column 3 C_CELL4_WIDTH Width of column 4 Web API Reference BW 3.5 306 SAP Online Help 25.02.2005 Service Methods Definition Functional components of the table interface. Use Service methods are offered along with methods for manipulating cell contents [Seite 293]. You need these when creating new cell contents. Features You can use the following service methods: Creating Navigation URLs [Seite 308] Information on the Navigation Status [Seite 309] Information on a Specific Cell [Seite 311] Symbols [Seite 313] Sending Messages [Seite 314] JavaScript Functions [Seite 315] Determining Specific Attributes for the Table Interface [Seite 316] Web API Reference BW 3.5 307 SAP Online Help 25.02.2005 Creating Navigation URLs Use You generate command URLs using the following method. This ensures that the request is sent to the correct page instance of the current session. Features Method GET_URL Importing parameter Description I_R_PARAMETER Command parameter The command parameter is transferred using instances of the class CL_RSR_PARAMETER. Use the methods in this class, for example, ADD, to fill the parameter. Returning parameter Description R_URL Command URL You can also use the following service methods: Symbols [Seite 313] Information on the Navigation Status [Seite 309] Information on a Specific Cell [Seite 311] Sending Messages [Seite 314] JavaScript Functions [Seite 315] Determining Specific Attributes for the Table Interface [Seite 316] Web API Reference BW 3.5 308 SAP Online Help 25.02.2005 Information on the Navigation Status Use This method returns information on the current navigation status. You can call it up at any time. Features Method GET_STATE_INFOS Exporting parameter Description E_THX_AXIS_INFO Distribution of the structures, characteristics and attributes on the axes and their properties For details about structures, see Dataset [Seite 284] and AXIS_INFO [Seite 285] E_T_SLICER Dynamic filter Filter that you can change in navigation and, for example, see in the navigation block. For details about tables, see Dataset [Seite 284] and Axis Data [Seite 287] Unlike in the set, the ATTRIBUTES component is not offered. E_T_TXT_SYMBOLS Query text element The text element contains general information (for example, the query key date), information about the variable values and information for fixing query filters. For details about tables, see Dataset [Seite 284] and TXT_SYMBOLS [Seite 291] In addition, you can use the following service methods: Creating Navigation URLs [Seite 308] Information on a Specific Cell [Seite 311] Symbols [Seite 313] Sending Messages [Seite 314] JavaScript Functions [Seite 315] Determining Specific Attributes for the Table Interface [Seite 316] Web API Reference BW 3.5 309 SAP Online Help Web API Reference 25.02.2005 BW 3.5 310 SAP Online Help 25.02.2005 Information on a Specific Cell Use This method returns details for cells at a specific cell coordinate. Prerequisites You cannot call up this method in the START method. Features Method GET_CELL_INFO Importing parameter Description I_ROW Row co-ordinate of cell in table I_COLUMN Column co-ordinate of cell in table Exporting parameter Description E_AXIS Axis of the cell 0 = on the columns, 1 = on the rows, -1 otherwise E_DATA_ROW Data row Row coordinate in data area This information is important, for example, when jumping from one report to another. E_DATA_COLUMN Data column Column coordinate in data area. This information is important, for example, when jumping from one report to another. E_CELL_TYPE Type of cell 0 = Empty cell 1 = Data cell 2 = Structure component 3 = Characteristic value 4 = Characteristic header 5 = Display attribute value 6 = Display-attribute header 7 = Scaling factor E_IOBJNM Characteristic/structure name This parameter is filled only for cells of type 2, 3, 4, 5 and 6. E_ATTRINM Display-attribute name This parameter is filled only for cells of type 5 and 6. Web API Reference BW 3.5 311 SAP Online Help 25.02.2005 Cell Restrictions E_T_CELL_RESTRICTIONS Restrictions arising from the position of the cell in the table. For example, there are restrictions on the display of data cells on the axes. For details about tables, see Dataset [Seite 284] and Axis Data [Seite 287] T T T T Unlike in the set, the ATTRIBUTES component is not offered. Information about data cells Information about data cells, for example, the value of the data cell, is available from here. For details about structures, see Dataset [Seite 284] and CELL_DATA [Seite 289] E_S_CELL_DATA T T T T You can also use the following service methods: Creating Navigation URLs [Seite 308] T T Information on the Navigation Status [Seite 309] T T Symbols [Seite 313] T T Sending Messages [Seite 314] T T JavaScript Functions [Seite 315] T T T Determining Specific Attributes for the Table Interface [Seite 316] T Web API Reference BW 3.5 312 SAP Online Help 25.02.2005 Symbols Use You use IMG tags in HTML for symbols. To fill the IMG tag attribute SRC, you need the path of the symbol directory from the MIME Repository or the ITS. The following method returns this path: Features Method GET_ICON_PATH Returning parameter Description R_PATH Path to symbol directory You use this path in the HTML IMG tag for SRC. You only need to enter the screen name. You can also use the following service methods: Creating Navigation URLs [Seite 308] T T Information on the Navigation Status [Seite 309] T T Information on a Specific Cell [Seite 311] T T Sending Messages [Seite 314] T T JavaScript Functions [Seite 315] T T T Determining Specific Attributes for the Table Interface [Seite 316] T Web API Reference BW 3.5 313 SAP Online Help 25.02.2005 Sending Messages Use You use the following method to send messages. These appear as a table at the start of the HTML page. You mostly use this function to notify users of errors. Features Method SEND_MESSAGE Importing parameter Description I_CLASS Message class I_TYPE Message type (I, W, E, A, X) I_NUMBER Message number I_MSGV1 Message variable value 1 I_MSGV2 Message variable value 2 I_MSGV3 Message variable value 3 I_MSGV4 Message variable value 4 You can also use the following service methods: Creating Navigation URLs [Seite 308] T T Information on the Navigation Status [Seite 309] T T T Information on a Specific Cell [Seite 311] T Symbols [Seite 313] T T T T JavaScript Functions [Seite 315] T Determining Specific Attributes for the Table Interface [Seite 316] T Web API Reference BW 3.5 314 SAP Online Help 25.02.2005 JavaScript Functions Use The following method enables you to manage JavaScript source code centrally. The source code is set at the start of the HTML page. You can use this function to construct your own JavaScript source code and, for example, call up manipulated cells from there. Features Methods SET_JAVASCRIPT_FUNCTION Importing parameter Description I_NAME Name of the section of source code This name is unique. Any source code already stored that has the same name is overwritten. The name I_NAME is not the name of a JavaScript function (see I_CODING). JavaScript source code I_CODING The source code I_CODING is the inner part of the HTML tag script and can be the definition of JavaScript functions (with function) and/or the definition of JavaScript variables (with var). T T T T The source code of one or more calls of the method is collected and automatically positioned at the beginning of the HTML page. You can also use the following service methods: Generate a Navigation URL [Seite 308] T T Information on the Navigational State [Seite 309] T T Information on a Specific Cell [Seite 311] T T Symbols [Seite 313] T T Sending Messages [Seite 314] T T Determining Specific Attributes for the Table-Interface [Seite 316] T T Web API Reference BW 3.5 315 SAP Online Help 25.02.2005 Determining Specific Attributes for the Table Interface Use You need this method if you have defined your own attributes for an object tag for the table interface. The basic table does not recognize these and are lost when you drilldown on a bookmark if you do not do anything with them. To make the Web application suitable for bookmarks, you have to use the following method to make important attributes for your table interface known to the Web item. We recommend that you call this method in the initialization (START method). Features Method SET_TABLE_INTERFACE_ATTRIBUTE Importing parameter Description I_ID Attribute name I_VALUE Attribute value You can also use the following service methods: Creating Navigation URLs [Seite 308] T T Information on the Navigation Status [Seite 309] T T Information on a Specific Cell [Seite 311] T T Symbols [Seite 313] T T Sending Messages [Seite 314] T T JavaScript Functions [Seite 315] T T Web API Reference BW 3.5 316