Show TOC Anfang des Inhaltsbereichs

Vorgehensweisen Pfad verwenden  Dokument im Navigationsbaum lokalisieren

Verwendung

Die Verwendung des ermittelten Pfades stellt den dritten und letzten Schritt dar, die Pfad-Ersetzung zur dynamischen Parametrisierung von Befehlen und Web Items zu nutzen. Sie können den ermittelten Pfad direkt im Web Template verwenden oder als URL-Parameter angeben.

Pfad im Web Template verwenden

In der Regel hat jeder Parameter ein value-Attribut, das den Wert des Parameters enthält. Wenn Sie das value-Attribut durch ein path-Attribut mit Pfad-Referenzierung ersetzen, können Sie dem Parameter dynamisch zur Laufzeit einen neuen Wert zuweisen.

Eine Pfad-Referenzierung kann nicht direkt in der Layout-Sicht oder im Befehle-Wizard eingesetzt werden. Führen Sie daher folgende Schritte durch, um den Pfad einzusetzen:

...

       1.      Fügen Sie das gewünschte Web Item oder über den Befehle-Wizard den gewünschten Befehl wie gewohnt in Ihre Web Application ein.

       2.      Legen Sie alle notwendigen Parameter des Web Items oder Befehls fest. Sie sollten insbesondere auch einen Wert für den dynamisch zu bestimmenden Parameter festlegen, damit dieser auch in der XHTML-Sicht erscheint.

       3.      Wechseln Sie in die XHTML-Sicht des Web Application Designers.

       4.      Markieren Sie in der XHTML-Sicht das von Ihnen eingefügte Web Item oder Befehl und löschen bei dem dynamisch zu ersetzenden Parameter das value-Attribut.

Hinweis

Merken Sie sich den technischen Namen des Parameters in der Layout-Sicht oder im Befehle-Wizard, um den zu ersetzenden Parameter einfacher zu finden.

       5.      Fügen Sie anstelle des value-Attributes das path-Attribut ein.

       6.      Geben Sie für den Wert des path-Attributes den ermittelten Pfad an.

Pfad als URL-Parameter angeben

Möchten Sie die dynamische Ersetzung innerhalb einer URL-Parametrisierung vornehmen, achten Sie darauf, das der dynamische Parameter mit einem * markiert wird und der Pfad URL-escaped wird:

      ‚:’ muss durch ‚%3A’ ersetzt werden

      ‚?’ muss durch ‚%3F’ ersetzt werden

      ‚/’ muss durch ‚%2F’ ersetzt werden

      ‚@’ muss durch ‚%40’ ersetzt werden

Ergebnis

Sie haben den Pfad im Web Template verwendet oder als URL-Parameter angegeben. Der Pfad wird bei der Ausführung ausgewertet, d.h. der Wert eines Parameters wird dynamisch an einen Befehl oder an ein Web Item übergeben.

Beispiel

Beispiel für die Verwendung des Pfades in einem Web Template

Der Textinhalt eines Web Item Text soll durch einen dynamischen Wert (Variable 0P_MAT) ersetzt werden

Web Item ohne Pfad-Referenzierung

<bi:TEXT_ITEM name="TEXT_ITEM_1" designheight="70" designwidth="200" >

<bi:TEXT_BINDING type="CHOICE" value="TEXT_CONTENT" >

<bi:TEXT_CONTENT value="Text..." >" />

</bi:TEXT_BINDING>

</bi:TEXT_ITEM>

Pfad auf Wert der Variablen 0P_MAT im Data Provider DP_1 (Einzelwertvariable, deshalb mit Index [1])

DATA_PROVIDER:DP_1?/BICS_VIEW/VARIABLES/VARIABLE[@name='0P_MAT']/SELECTIONS/SELECTION[1]/MEMBER/@name

Web Item mit Pfad-Referenzierung

<bi:TEMPLATE_PARAMETERS name="TEMPLATE_PARAMETERS" >

                <bi:WEB_TEMPLATE_ACTIONS type="COMPOSITE" >

                    <bi:ACTION_BEFORE_FIRST_RENDERING type="COMPOSITE" >

                        <bi:INSTRUCTION >

                            <bi:SET_ITEM_PARAMETERS >

                                <bi:cmd_item_parameters type="TEXT_ITEM" >

                                    <bi:TEXT_BINDING type="CHOICE" value="TEXT_CONTENT" >

                                        <bi:TEXT_CONTENT path="DATA_PROVIDER:DP_1?/BICS_VIEW/VARIABLES/VARIABLE[@name='0P_MAT']/SELECTIONS/SELECTION[1]/MEMBER/@name" />

                                    </bi:TEXT_BINDING>

                                </bi:cmd_item_parameters>

                                <bi:TARGET_ITEM_REF value="TEXT_ITEM_1" />

                            </bi:SET_ITEM_PARAMETERS>

                        </bi:INSTRUCTION>

                    </bi:ACTION_BEFORE_FIRST_RENDERING>

                </bi:WEB_TEMPLATE_ACTIONS>

            </bi:TEMPLATE_PARAMETERS>

Beispiel für die Verwendung des Pfades im URL-Parameter

Die Höhe eines Web Items (im Beispiel nicht genauer angegeben) soll die Höhe des Web Items BUTTON_GROUP_1 zugeordnet bekommen.

Pfad

ITEM:BUTTON_GROUP_1?/ITEM/INIT_PARAMETERS/HEIGHT/@value

URL-Parameter

&HEIGHT*=ITEM%3ABUTTON_GROUP_1%3F%2FITEM%2FINIT_PARAMETERS%2FHEIGHT%2F%40value

Ende des Inhaltsbereichs