SAP ABAP Data Element UPB_Y_POFO_XML (Portfolio Graphic: XML)
Hierarchy
SAP_BW (Software Component) SAP Business Warehouse
   BW-PLA-BPS (Application Component) Business Planning and Simulation
     UPBPM (Package) Planning Folders
Basic Data
Data Element UPB_Y_POFO_XML
Short Description Portfolio Graphic: XML  
Data Type
Category of Dictionary Type     Direct Type Entry
Type of Object Referenced     No Information
Domain / Name of Reference Type      
Data Type RAW   Uninterpreted sequence of bytes 
Length 255    
Decimal Places 0    
Output Length 510    
Value Table      
Further Characteristics
Search Help: Name    
Search Help: Parameters    
Parameter ID   
Default Component name    
Change document    
No Input History    
Basic direction is set to LTR    
No BIDI Filtering    
Field Label
  Length  Field Label  
Short 10 XML 
Medium 15 XML 
Long 20 XML 
Heading 20 XML 
Documentation

Portfolio Graphics

Characteristic attributes can be analyzed dependent on several key figure values with portfolio graphics (in contrast to other graphic types, which plot a key figure value over a characteristic combination).

Portfolio graphics are created as XMLCHART with the Internet Graphics Server (IGS) as of release 6.25. This is connected using RFC connection IGS_RFC_DEST. The IGS and the RFC connection must be installed before portfolio graphics can be generated.

You find a description of the general procedure for using portfolio graphics in the SAP Library (Help -> Application Help). Below we explain how you proceed to change the preset standard procedure to generate user-specific portfolio graphics.

XML Customizing

Two XML files with different contents belong to every portfolio graphic:

  • Data points and data series of the graphic
  • Customizing-specific instructions

Templates can be defined for both files in which variances are described in comparison with the standard procedure (for example, other colors, texts, definition of quadrants, additional constant reference data points, attributes of mini graphics, minimum size of data points) The template for the standard procedure is loaded with the "standard template" function. You can save standard templates locally, change them in the IGS Chart Designer, and import them again afterwards.

Each template change overwrites the behavior of the standard procedure. For example, if a heading is entered in the Chart Designer, this is displayed instead of the header characteristics of the layout. The modified templates are not checked for content. However, the XML files generated from the layout and the templates can be saved locally using the context menu when executing the portfolio graphic. You will find more information in the documentation of the Chart Designer and the Chart Engine.

Comment on Generated XML File of Data Points

An ID is assigned for every data series and data point when generating the graphics. You can refer to these IDs in the templates (for example, to determine the color or form of a data series). The ID of a series is always put together from the prefix "S_" and the attributes of the fixed characteristic values of the series; the IDs of the data points are put together from the prefix "B_" and all characteristic values of the lead columns of the layout. In the special case "no distribution in series" there is only a series with the ID "S_".

In addition, the system forms categories from all characteristic combinations of the characteristic that are not contained in the series, the names of which are put together from the prefix "C_" and the characteristic values.

Instructions for Dynamic Modification of Generated XML Files

  • OTR (Online Text Repository) texts should be used for translation relevant texts. They can be included in the templates with &lt;%=OTR(<Alias>/<ID>)%&gt; (if you edit the template in the Chart Designer, you can enter the enclosing angle brackets directly, therefore "<%=OTR(...)%>". In the Customizing of the planning folder, you must use the escape sequence "&lt;" or "&gt;" for syntactical reasons). The system then includes the appropriate OTR text when generating the graphic.
  • Numeric values that can only be determined at runtime (for example, limits of a quadrant) can be read from SEM-BPS variables of the type number. These can be referenced with &lt;%=VAR(<Gebiet>/<Variable>)%&gt; .
    If an element <NAME> is not available in the XML tree of the template or only figures can be entered in the Chart Designer at the desired node, you can create the reference to a text element (heading or extension) of the higher-level node with &lt;%=...(...)\<NAME>%&gt; .
  • The axes of the graphic can also be divided with the help of categories. For this you must include at least one value range object with the ID &lt;%=MR(CAT)%&gt; for the axis. As a result, the system numbers the categories of the graphic beginning with zero and generates an area of the width one for every category at the appropriate positions.
  • The rules to generate data points from columns can be changed, if a template template series is included in the template for XML data file that contains one data point. The label of this data point must have the following value: &lt;%=MR()%&gt; .
    The individual elements of the point must have the usual structure of the XMLCHART format: <Value type="<NAME>"> &lt;%=MR(...)%&gt; </Value>. Here "&lt;%=MR(...)%&gt;" either describes a column of the layout (for example, &lt;%=MR(1)%&gt; for the first data column) or references the categories (&lt;%=MR(CAT)%&gt;). <NAME> specifies to which target the transferred values refer (for example, X or Y axis).
    The row <Value type="trendX"> &lt;%=MR(3)%&gt; </Value> has the effect, for example, that x coordinates for trend arrows are always generated from the data of the third column and a row of the type <Value type="x"> &lt;%=MR(CAT)%&gt; </Value> has the effect that the categories are plotted on the abscissa. Any other graphic types can also be realized with this procedure.

Example

   

   

History
Last changed by/on SAP  20130604 
SAP Release Created in 320