Verwendung von JavaScript in Web Applications
und Web Items
JavaScript in Web Applications verwenden
JavaScript kann auf zwei Arten in Web Applications eingebunden werden:
● Verwendung eines JavaScript-Include aus dem MIME-Repository
Laden Sie die JavaScript-Include-Datei in das MIME Repository des BI-Systems. Wählen Sie dazu aus dem SAP Easy Access Menü → Business Explorer → MIME Repository.. Kundeneigene Scripts können im MIME Repository unter SAP → BW → Customer → JavaScripts hinterlegt werden.
In der XHTML-Sicht des Web Templates können Sie jetzt die JavaScript-Include-Datei wie folgt referenzieren:
<script src="bwmimerep:///sap/bw/mime/Customer/Javascripts/myscript.js” type="text/javascript"></script>
● Einbindung von JavaScript in ein Web Template über das Web Item Skript
Ziehen Sie das Web Item Skript aus der Web-Item-Gruppierung Diverse in Ihr Web Template und wählen Sie die Registerkarte Web-Item-Parameter im Bereich Eigenschaften des Web Application Designers. Wählen Sie den Editierdialog für den Parameter Skript. Hier können Sie jetzt Ihr JavaScript einfügen. Der Befehle-Wizard hilft Ihnen das JavaScript-Coding zum Ausführen des Befehls zu erzeugen.
Beachten Sie, dass auf Grund des XHTML-Formats ein direktes Schreiben von JavaScript in das Web Template nicht unterstützt wird. Aus diesem Grund wird das eigentliche Skript unter einer Referenz abgelegt. Das Skript kann nur mithilfe des Editierdialoges geändert werden.
Bei Bedarf können Sie JavaScript nach dem Laden der Web Applications im Web Browser ausführen. Wechseln Sie im Web Application Desiger in die XHTML-Sicht und rufen Sie die JavaScript-Funktion im Event-Handler onload des Body-Tag auf:
<body onload=“javascript:<FUNCTION>();“>
<FUNCTION> ist ein Platzhalter für den Funktionsnamen.
Wenn Sie Befehle aus dem Web Design API aufrufen möchten, können Sie ebenfalls die Standardaktionen des Web Templates nutzen:
○ Aktion vor der Anzeige (ACTION_BEFORE_RENDERING)
○ Aktion vor der ersten Anzeige (ACTION_BEFORE_FIRST_RENDERING)
Weitere Informationen finden Sie unter Web-Template-Parameter.
Im JavaScript können Sie auf folgende JavaScript-Funktion zugreifen:
sapbi_page.GetMainTemplateName(); |
Technischer Name des Web Templates |
Alle anderen JavaScript-Variablen und –Funktionen sind nur für den internen Gebrauch und nicht für die Verwendung in Web Applications vorgesehen.
JavaScript in Web Items verwenden
Einige Web Items bieten neben der direkten Nutzung von Befehlen über den Befehle-Wizard auch die Möglichkeit, JavaScript-Funktionen zu verwenden. Dies kann z. B. sinnvoll sein, wenn Sie Befehle dynamisch zusammenstellen, oder Portal-Eventing verwenden und diese Aktion an ein Web Item binden wollen.
Javascript-Funktionen, die an ein Web Item gebunden sind, haben immer die gleiche Signatur:
function functionname(currentState, defaultCommandSequence)
Die Parameter currentState und defaultCommandSequence werden für Web Items verwendet, die bereits selbst einen Standardbefehl ausführen. Dies ist z.B. beim Datenanbindungstyp CHARACTERISTIC_SELECTION des Web Items Dropdown-Box der Fall. Hier wird standardmäßig der Befehl zum Setzen der Filterwerte ausgeführt. Sie können diese Standardbefehlsfolge nun einfach vor oder nach Ihrem Befehl einfügen, oder aber einfach ignorieren, um den Standardbefehl nicht auszuführen.
Ein Beispiel für die Verwendung von JavaScript in einem Web Item finden Sie unter Verwendung von JavaScript im Web Item Dropdown-Box.