Dokumentation (mit Web Item Analyse) (SAP-Bibliothek

Dokumentation (mit Web Item Analyse)

Verwendung

Sie möchten eine Planungsanwendung bauen, mit der Sie Umsatzbeträge zu bestimmten Kontonummern eingeben und zu einem solchen Datensatz ein Dokument anlegen können. Die Planungsanwendung soll zur Ausführungszeit etwa wie folgt aussehen:

Diese Grafik wird im zugehörigen Text erklärt

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

● Zeilenselektion mit Befehl im Web Item Analyse. Die Zeilenselektion wirkt sich unmittelbar in der Dokumentenanzeige aus.

Voraussetzungen

● Wie im Beispiel Planungsfunktion Umwerten (mit Web Item Analyse) verwenden Sie

○ eine Aggregationsebene, die folgende InfoObjects enthält: Einheit Währungsschlüssel, Zeitmerkmale Quartal und Kalenderjahr, Kennzahl Betrag, Merkmale Version, Kontonummer, Kostenstelle.

○ den Filter ACCOUNT_FILT

○ die Query QUERY_REVALUATION

● Sie haben in der InfoObject-Pflege (Transaktionscode RSD1) zum Merkmal Kontonummer (Registerkarte Allgemein) die Option Merkmal ist Dokumenteigenschaft gesetzt.

Vorgehensweise

BEx Web Application Designer: Web Template anlegen

...

1. Legen Sie im BEx Web Application Designer ein Web Template namens DOC_SELECTION an.

2. Legen Sie folgende Data Provider vom Typ Query-View-Data-Provider an:

○ DP_DOCS_ALL

○ DP_DOCS_RESTRICTED

Beide Data Provider sollen auf der Query QUERY_REVALUATION beruhen.

3. Legen Sie folgende Web Items an:

○ ANALYSIS_ITEM_1. Als (Quell-)Data Provider ist der Analysetabelle der Data Provider DP_DOCS_ALL zugeordnet.

Wählen Sie Verhalten → Zeilenauswahl → Einzelne mit Befehlen (SINGLE_WITH_COMMAND).

Hinweis

Bei der Zeilenauswahl Einzelne (SINGLE) kann der Benutzer stets nur eine Zeile selektieren; es findet kein Roundtrip zum Server statt. Bei der Zeilenauswahl Einzelne mit Befehlen kann der Benutzer ebenfalls stets nur eine Zeile selektieren; das System startet dazu jedoch einen Roundtrip zum Server und führt ggf. Aktivierungs- und Deaktivierungsbefehle aus.

Beispiel: Es sei Zeile 1 aktiv. Sie markieren jetzt Zeile 2. Das System führt ggf. das Deaktivierungskommando auf Zeile 1 aus und deaktiviert Zeile 1. Dann selektiert das System Zeile 2 und führt das Aktivierungskommando auf Zeile 2 aus.

In unserem Beispiel möchten Sie erreichen, dass bei der Auswahl einer Zeile im Web Item Analyse das zu dieser Zeilenauswahl passende Dokument angezeigt wird. Legen Sie hierfür als Aktivierungsaktion den folgenden Befehl über den Befehle-Wizard (INSTRUCTION) an:

Tabelle der Befehle

Befehl

Parameter

Data-Provider-spezifischer Befehl SET_SELECTION_STATE BY BINDING (Filterwerte nach verschiedenen Quellen setzen)

● Befehlsziel: Ziel-Data-Provider DP_DOCS_RESTRICTED

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

Setzen Sie die Eigenschaft Dokumentensymbole für Daten auf On.

○ SINGLE_DOCUMENT_ITEM_1.

Ein Dokument soll höchstens 10 Zeilen umfassen. Es soll in die Web Application eingebettet (und nicht nur als Link angezeigt) werden. Falls mehrere Dokumente erfasst werden, sollen diese als Liste angezeigt werden. Setzen Sie dementsprechend die folgenden Eigenschaften:

Interne Anzeige → Maximale Textzeilen: 10; In Web Application anzeigen: On; Web Item Liste von Dokumenten: On

Verhalten → Pflege möglich: On; Bearbeitungsmodus: On

Als (Quell-)Data Provider ist dem Dokument der Data Provider DP_DOCS_RESTRICTED zugeordnet. Die Dokumentation soll zum Ändern eines Umsatzbetrages, also zu einem Bewegungsdatensatz erfasst werden. Setzen Sie dementsprechend die folgenden Eigenschaften:

Datenanbindung → Data Provider: DP_DOCS_RESTRICTED, Dokumentenklasse: InfoProvider[MULTI]

Hinweis

Wenn Sie die Einstellung Stammdaten wählen würden, könnten Sie Dokumentation zu einer Kontonummer erfassen.

Die folgende Grafik veranschaulicht das Layout des Web Templates DOC_SELECTION:

Diese Grafik wird im zugehörigen Text erklärt

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

XHTML-Quelltext des Web Template DOC_SELECTION

<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 >Netweaver BI Web Application</title>
            <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
        </head>
        <body >
            <bi:QUERY_VIEW_DATA_PROVIDER name="DP_DOCS_ALL" >
                <bi:INITIAL_STATE type="CHOICE" value="QUERY" >
                    <bi:QUERY value="QUERY_REVALUATION" text="QUERY_REVALUATION" />
                </bi:INITIAL_STATE>
            </bi:QUERY_VIEW_DATA_PROVIDER>
            <bi:QUERY_VIEW_DATA_PROVIDER name="DP_DOCS_RESTRICTED" >
                <bi:INITIAL_STATE type="CHOICE" value="QUERY" >
                    <bi:QUERY value="QUERY_REVALUATION" text="QUERY_REVALUATION" />
                </bi:INITIAL_STATE>
            </bi:QUERY_VIEW_DATA_PROVIDER>
            <bi:TEMPLATE_PARAMETERS name="TEMPLATE_PARAMETERS" />

            <p >
                <bi:ANALYSIS_ITEM name="ANALYSIS_ITEM_1" designwidth="400" designheight="200" >
                    <bi:DATA_PROVIDER_REF value="DP_DOCS_ALL" />
                    <bi:LINKED_DATA_PROVIDER_REF_LIST type="ORDEREDLIST" />
                    <bi:NEW_LINES_COUNT value="0" />
                    <bi:SELECT_ROWS value="SINGLE_WITH_COMMAND" >
                        <bi:SINGLE_WITH_COMMAND type="COMPOSITE" >
                            <bi:ACTIVATION_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_DOCS_RESTRICTED" />
                                        </bi:TARGET_DATA_PROVIDER_REF_LIST>
                                        <bi:SELECTION_BINDINGS type="UNORDEREDLIST" >
                                            <bi:SELECTION_BINDING type="COMPOSITE" index="1" >
                                                <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:CHARACTERISTIC value="ZD_ACCNT" text="Account number" />
                                            </bi:SELECTION_BINDING>
                                        </bi:SELECTION_BINDINGS>
                                    </bi:SET_SELECTION_STATE_BY_BINDING>
                                </bi:INSTRUCTION>
                            </bi:ACTIVATION_ACTION>
                        </bi:SINGLE_WITH_COMMAND>
                    </bi:SELECT_ROWS>
                    <bi:DOCUMENT_ICONS_DATA value="X" />
                    <bi:BLOCK_COLUMNS_SIZE value="5" />
                    <bi:BLOCK_ROWS_SIZE value="5" />
                </bi:ANALYSIS_ITEM>
            </p>
            <p >
                <bi:SINGLE_DOCUMENT_ITEM name="SINGLE_DOCUMENT_ITEM_1" designheight="300" designwidth="350" >
                    <bi:DATA_PROVIDER_REF value="DP_DOCS_RESTRICTED" />
                    <bi:MAX_TEXT_LINES value="10" />
                    <bi:MAINTENANCE_POSSIBLE value="X" />
                    <bi:EDIT_MODE value="X" />
                    <bi:DOCUMENT_CLASS type="CHOICE" value="MULTI" />
                    <bi:PROPERTY_LIST type="ORDEREDLIST" />
                </bi:SINGLE_DOCUMENT_ITEM>
            </p>
        </body>
    </html>
</bi:bisp>

Ausführen im Web

...

1. Führen Sie das Web Template im Web aus.

2. Markieren Sie eine Zeile, erfassen Sie dazu einen Text, und sichern Sie. Im entsprechenden Betragsfeld in der Analysetabelle zeigt ein Dokumentensymbol an, dass es zu diesem Datensatz eine Dokumentation gibt.

3. Wenn Sie zu mehreren Zeilen Dokumente angelegt haben, werden diese als Dokumentenliste angezeigt.