Planungsfunktion Umwerten (mit Web Item Analyse)

Verwendung

Sie möchten eine Planungsanwendung bauen, mit der Sie Umsatzbeträge zu bestimmten Kontonummern eingeben und mit einem einstellbaren Faktor umwerten können. Wenn Sie eine Zeile der Tabelle markieren, soll nur der Betrag dieser Zeile umgewertet werden. Wenn Sie keine Zeile auswählen, sollen alle Werte umgewertet werden. Die Planungsanwendung soll zur Ausführungszeit etwa wie folgt aussehen:

Dieses Beispiel soll insbesondere das Zusammenspiel zwischen einer Planungsfunktion und einem Web Item Analyse verdeutlichen. Besondere Eigenschaften hierbei sind:

Variablenbehandlung in der Planungsfunktion
Zeilenselektion im Web Item Analyse

Voraussetzungen

Sie haben im Planning Modeler eine Aggregationsebene angelegt, die folgende InfoObjects enthält: Einheit Währungsschlüssel, Zeitmerkmale Quartal und Kalenderjahr, Kennzahl Betrag, Merkmale Version, Kontonummer, Kostenstelle.

Planungsfunktion und Query sollen dieselben Daten dieser Aggregationsebene verwenden.

Vorgehensweise

Planning Modeler: Planungsfunktion, Variablen und Filter anlegen

Wählen Sie die Registerkarte Planungsfunktionen, und legen Sie eine Planungsfunktion vom Typ Umwerten mit dem technischen Namen REVALUATE und der Beschreibung Umwerten zu Ihrer Aggregationsebene an.
Legen Sie auf der Registerkarte Zu den Parametern über die Wertehilfe zum Umwertungsfaktor die Variable REVAL_FACTOR mit der Beschreibung Umwertungsfaktor an. Die Variable soll im Detail wie folgt spezifiziert sein: Die Variable soll eine Pflichtvariable und eingabebereit sein, sie soll den Typ Zahl, aber keinen Standard-Vorschlagswert haben.
Wählen Sie die Registerkarte Filter, und legen Sie einen Filter mit dem technischen Namen ACCOUNT_FILT und der Beschreibung Umwertungsselektion zu Ihrer Aggregationsebene an.
Markieren Sie nacheinander die Merkmale, und wählen Sie das Symbol für die Wertehilfe in der Spalte nach Merkmalseinschränkungen. Sie gelangen auf ein Dialogfenster zur Festlegung der Merkmalseinschränkung. Legen Sie die gewünschten Einschränkungen fest (in unserem Beispiel Version = VERSION 1, Quartal = Quartal 1, Kalenderjahr = 2007, Kostenstelle = 100002, Währung = Euro; für Kontonummer werden alle Werte übernommen), wählen Sie Hinzufügen, und sichern Sie die getroffene Auswahl mit OK.

Wählen Sie Erweiterte Einstellungen einblenden, und stellen Sie sicher, dass das Merkmal Version nicht änderbar zur Ausführungszeit ist. (Änderbar soll die Kennzahl Betrag sein.)

Hinweis
Weitere Informationen über das Anlegen von Planungsfunktionen, Variablen und Filtern finden Sie unter Planning Modeler .

BEx Query Designer: Query anlegen

Legen Sie im BEx Query Designer eine Query Umwerten (technischer Name: QUERY_REVALUATION) zu Ihrer Aggregationsebene an.
Ziehen Sie den Filter ACCOUNT_FILT in den Bereich Merkmalseinschränkungen für Filterwerte. Damit sind alle Merkmale bereits auf Einzelwerte eingeschränkt.
Ziehen Sie das Merkmal Kontonummer in den Bereich für Vorschlagswerte.
Legen Sie fest, dass das Merkmal Kontonummer in den Zeilen steht. Die Werte hierfür kommen aus den Stammdaten.
Legen Sie fest, dass die Kennzahl Betrag in den Spalten steht. Die Werte hierfür können geändert werden; wählen Sie auf der Registerkarte Planung die Option Daten können durch Benutzereingaben oder Planungsfunktionen geändert werden.
Sichern Sie Ihre Querydefinition.

BEx Web Application Designer: Web Template anlegen

Legen Sie im BEx Web Application Designer ein Web Template namens REVALUATION an.
Legen Sie folgende Data Provider an:
- DP_PLAN_DATA vom Typ Query-View-Data-Provider, beruhend auf der Query QUERY_REVALUATION
- DP_FILT_REVALUATION_FUNCTION vom Typ Filter. Die Datenanbindung soll aus dem Filter ACCOUNT_FILT kommen.
Legen Sie folgende Web Items an:
- INPUT_FIELD_REVALUATION_FACTOR. Legen Sie den Vorschlagswert auf 10 fest (Interne Anzeige → Text: 10).
- BUTTON_GROUP_ REVALUATION. Legen Sie über Interne Anzeige die Drucktaste 1 mit der Beschriftung Umwertung an, und weisen Sie als Aktion folgende Befehle über den Befehle Wizard (INSTRUCTION) zu:

Tabelle der Befehle

Befehl	Parameter
Data-Provider-spezifischer Befehl SET_SELECTION_STATE BY BINDING (Filterwerte nach verschiedenen Quellen setzen)	Befehlsziel: Ziel-Data-Provider DP_FILT_REVALUATION_FUNCTION Datenanbindung: Selektionsanbindung über das Merkmal Kontonummer (ZD_ACCNT), wobei der Wert über den Bindungstyp Web-Item-Auswahl aus dem Web Item ANALYSIS_ITEM_1, Merkmal Kontonummer (ZD_ACCNT) kommen soll.
Planungsspezifischer Befehl EXEC_PLANNING_FUNCTION_SIMPLE (Planungsfunktion ausführen [Einfach])	Datenanbindung: Referenz auf Data Provider vom Typ Filter DP_FILT_REVALUATE_FUNCTION, wobei der Wert aus der Variable REVAL_FACTOR über den Bindungstyp Web-Item mit manueller Eingabe (ITEM_INPUT), nämlich aus INPUT_FIELD_REVALUATION_FACTOR kommen soll. befehlsspezifischer Parameter: Planungsfunktion REVALUATE

ANALYSIS_ITEM_1. Als (Quell-)Data Provider ist der Analysetabelle der Data Provider DP_PLAN_DATA zugeordnet.
Wählen Sie Verhalten → Zeilenauswahl → Mehrfach (MULTIPLE).

Hinweis
In diesem Fall soll es möglich sein, mehrere Zeilen zu selektieren und auf allen markierten Zeilen den Umwertungsbefehl auszuführen. Deshalb kann der Befehl nicht mit der Zeilenselektion mitgegeben, sondern muss auf eine Drucktaste gelegt werden.

Legen Sie ein CONTAINER_LAYOUT_ITEM_1 an (Web Items → Erweitert → Container).
Richten Sie den Container in Spalten ein, wählen Sie die Anzeigeoption Mit Tray, und geben Sie unter Tray-Einstellungen die Beschriftung Umwertung ein.

Legen Sie in den Container die folgenden Web Items:
- 1. Zeile, 1. Spalte: INPUT_FIELD_REVALUATION_FACTOR
  1. Zeile, 2. Spalte: BUTTON_GROUP_ REVALUATION
- 2. Zeile, 1. Spalte (mit der Option Colspan=2, d.h. mit einem Merge der Spalten 1 und 2): ANALYSIS_ITEM_1
Die folgende Grafik veranschaulicht das Layout des Web Templates REVALUATION:

Die folgende Tabelle enthält den XHTML-Quelltext des Web Template REVALUATION:

XHTML-Quelltext des Web Template REVALUATION

<bi:bisp  xmlns="http://www.w3.org/TR/REC-html40" xmlns:bi="http://xml.sap.com/2005/01/bi/wad/bisp" xmlns:jsp="http://java.sun.com/JSP/Page" >     <html >         <head >             <title >BEx Web Application</title>             <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />         </head>         <body >             <bi:QUERY_VIEW_DATA_PROVIDER name="DP_PLAN_DATA" >                 <bi:INITIAL_STATE type="CHOICE" value="QUERY" >                     <bi:QUERY value="QUERY_REVALUATION" text="QUERY_REVALUATION" />                 </bi:INITIAL_STATE>             </bi:QUERY_VIEW_DATA_PROVIDER>             <bi:SELECTOR_DATA_PROVIDER name="DP_FILT_REVALUATION_FUNCTION" >                 <bi:SELECTOR_INITIAL_STATE type="CHOICE" value="SELECTION_OBJECT" >                     <bi:SELECTION_OBJECT value="ACCOUNT_FILT" />                 </bi:SELECTOR_INITIAL_STATE>             </bi:SELECTOR_DATA_PROVIDER>             <bi:TEMPLATE_PARAMETERS name="TEMPLATE_PARAMETERS" />             <bi:CONTAINER_LAYOUT_ITEM name="CONTAINER_LAYOUT_ITEM_1" designwidth="250" designheight="30" >                 <bi:WIDTH value="250" />                 <bi:HEIGHT value="30" />                 <bi:WITH_TRAY type="CHOICE" value="X" text="" >                     <bi:TRAY_SETTINGS type="COMPOSITE" >                         <bi:CAPTION value="Umwertung" />                     </bi:TRAY_SETTINGS>                 </bi:WITH_TRAY>                 <bi:ROW_LIST type="ORDEREDLIST" >                     <bi:ROW type="ORDEREDLIST" index="1" >                         <bi:COLUMN type="COMPOSITE" index="1" >                             <bi:CHILD_ITEM_REF value="INPUT_FIELD_REVALUATION_FACTOR" />                         </bi:COLUMN>                         <bi:COLUMN type="COMPOSITE" index="2" >                             <bi:CHILD_ITEM_REF value="BUTTON_GROUP_REVALUATION" />                         </bi:COLUMN>                     </bi:ROW>                     <bi:ROW type="ORDEREDLIST" index="2" >                         <bi:COLUMN type="COMPOSITE" index="1" >                             <bi:CHILD_ITEM_REF value="ANALYSIS_ITEM_1" />                             <bi:COLSPAN value="2" />                         </bi:COLUMN>                     </bi:ROW>                 </bi:ROW_LIST>                 <bi:INPUT_FIELD_ITEM name="INPUT_FIELD_REVALUATION_FACTOR" designheight="70" designwidth="40" >                     <bi:WIDTH value="40" />                     <bi:TEXT_CONTENT value="10" />                     <bi:TEXT_ALIGNMENT value="END" />                 </bi:INPUT_FIELD_ITEM>                 <bi:BUTTON_GROUP_ITEM name="BUTTON_GROUP_REVALUATION" designheight="70" designwidth="50" >                     <bi:WIDTH value="50" />                     <bi:BUTTON_LIST type="ORDEREDLIST" >                         <bi:BUTTON type="COMPOSITE" index="1" >                             <bi:CAPTION value="Umwertung" />                             <bi:ACTION type="CHOICE" value="INSTRUCTION" >                                 <bi:INSTRUCTION >                                     <bi:SET_SELECTION_STATE_BY_BINDING >                                         <bi:TARGET_DATA_PROVIDER_REF_LIST type="ORDEREDLIST" >                                             <bi:TARGET_DATA_PROVIDER_REF index="1" value="DP_FILT_REVALUATION_FUNCTION" />                                         </bi:TARGET_DATA_PROVIDER_REF_LIST>                                         <bi:SELECTION_BINDINGS type="UNORDEREDLIST" >                                             <bi:SELECTION_BINDING type="COMPOSITE" index="1" >                                                 <bi:CHARACTERISTIC value="ZD_ACCNT" text="Account number" />                                                 <bi:SELECTION_BINDING_TYPE type="CHOICE" value="ITEM_CHARACTERISTIC" >                                                     <bi:ITEM_CHARACTERISTIC type="COMPOSITE" >                                                         <bi:ITEM_REF value="ANALYSIS_ITEM_1" />                                                         <bi:CHARACTERISTIC value="ZD_ACCNT" text="Account number" />                                                     </bi:ITEM_CHARACTERISTIC>                                                 </bi:SELECTION_BINDING_TYPE>                                             </bi:SELECTION_BINDING>                                         </bi:SELECTION_BINDINGS>                                     </bi:SET_SELECTION_STATE_BY_BINDING>                                     <bi:EXEC_PLANNING_FUNCTION_SIMPLE >                                         <bi:SELECTOR_DATA_PROVIDER_REF value="DP_FILT_REVALUATION_FUNCTION" />                                         <bi:PLANNING_FUNCTION value="REVALUATE" text="Umwerten" />                                         <bi:VARIABLE_VALUES type="ORDEREDLIST" >                                             <bi:VARIABLE_VALUE type="COMPOSITE" index="1" >                                                 <bi:VARIABLE value="REVAL_FACTOR" text="" />                                                 <bi:VARIABLE_TYPE type="CHOICE" value="ITEM_INPUT" >                                                     <bi:ITEM_INPUT type="COMPOSITE" >                                                         <bi:ITEM_REF value="INPUT_FIELD_REVALUATION_FACTOR" />                                                     </bi:ITEM_INPUT>                                                 </bi:VARIABLE_TYPE>                                             </bi:VARIABLE_VALUE>                                         </bi:VARIABLE_VALUES>                                     </bi:EXEC_PLANNING_FUNCTION_SIMPLE>                                 </bi:INSTRUCTION>                             </bi:ACTION>                         </bi:BUTTON>                     </bi:BUTTON_LIST>                 </bi:BUTTON_GROUP_ITEM>                 <bi:ANALYSIS_ITEM name="ANALYSIS_ITEM_1" designwidth="400" designheight="200" >                     <bi:DATA_PROVIDER_REF value="DP_PLAN_DATA" />                     <bi:SELECT_ROWS type="CHOICE" value="MULTIPLE" />                 </bi:ANALYSIS_ITEM>             </bi:CONTAINER_LAYOUT_ITEM> <!-- insert data providers, items and other template content here -->         </body>     </html> </bi:bisp>

Ausführen im Web

Führen Sie das Web Template im Web aus.
Erweitern Sie die URL zum Testen um den Parameter &debug=X.
Wenn Sie diesen Parameter gesetzt haben, wird im Abschnitt Executing planning function die Selektion angezeigt.
Geben Sie zu einer oder mehreren Kontonummern Beträge ein, ändern Sie ggf. den Umwertungsfaktor (Vorschlagswert = 10), markieren Sie die gewünschten Zeilen und wählen Sie Umwertung.
Tipp
Geben Sie z.B. in der ersten Zeile den Betrag 100 ein, behalten Sie den Umwertungsfaktor 10 bei und wählen Sie Umwertung. Sowohl in der markierten Zeile als auch als Gesamtergebnis (sofern Sie keine anderen Werte eingegeben haben) gibt die Query einen Betrag von 110 aus.