Web

Web

184858

Web(name, APP(appname) | URL(url), x, y, w, h)

* – Pflichtparameter

Beschreibung

Das Web-Widget ermöglicht es, Webbrowser zum Anzeigen von Inhalten in ClassiX zu nutzen. Wird ClassiX ohne MorphIT (nativ) verwendet, dann öffnet das Web-Widget die angegebene URL oder APP automatisch in dem eingestellten Browser, sobald das enthaltende Fenster geöffnet wird. Das Web-Widget kann durch einen Klick erneut geöffnet werden. Das Widget kann auch von InstantView aus über Widget Call(OpenWidget) geöffnet werden.

Query-Parameter in den Pfaden von URL und APP werden unterstützt.

Semantik URL(url)

Wird ein Web-Widget mit der Flag URL erstellt, dann wird die angegebene URL als absolute Datei-URL interpretiert und dessen Inhalt in einem MorphIT-WebWidget eingebettet. Das folgende Web-Widget würde beispielsweise beim Öffnen die angegebene HTML-Datei darstellen.

Web(web, URL("CX_ROOTDIR\\webPages\\test.html"), 0,0,100,100)

Hinweis: Absolute URLs, wie http://www.wikipedia.de werden hier aktuell noch nicht unterstützt. Dies ist aber in Zukunft geplant.

Semantik APP(appname)

Das Flag APP gibt einen relativen Pfad zu einer .html oder .htm Datei an, die statische Inhalte anzeigen kann, oder aber auch mit dem Widget in ClassiX kommunizieren und dynamische Inhalte darstellen kann. Der Pfad ist relativ zu dem in dem MorphIT-Server konfiguriertem widgetPath. Web-Widgets mit dem APP-Flag lassen sich nur öffnen, wenn ClassiX eine bestehende Verbindung zum MorphIT-Server hat, da die geöffneten HTML-WebWidgets zum einen über diese Verbindung mit ClassiX kommunizieren können und zum anderen ClassiX wissen muss, unter welcher URL der HTTP-Server des MorphIT-Servers erreichbar ist.

Statische HTML-Seiten sollten idealer Weise weder CSS noch JavaScript enthalten. Nur so kann sichergestellt werden, dass die WebWidgets sowohl nativ, als auch über MorphIT korrekt dargestellt werden. CSS-Styles und notwendige JavaScript-Scripte können in einer separaten .css-Datei & .js-Datei in dem Verzeichnis <widgetPath>/dependencies abgelegt werden, damit sie beim Anzeigen der HTML-Seite geladen sind.

Falls ein HTML-WebWidget JavaScript enthält, oder mit ClassiX kommunizieren muss, dann sollte dieses Widget in Form einer AngularJS-Direktive oder eines AngularJS-Controllers angelegt werden. 

Die HTML-WebWidgets werden in MorphIT direkt eingebunden und nativ in einem MorphIT-Wrapper (MorphIT-Frame) geöffnet, um sicherzustellen, dass sich die WebWidgets in beiden Fällen gleich verhalten. Der MorphIT-Server und der MorphIT-Frame kümmern sich darum, dass weder ClassiX noch das HTML-WebWidget den Unterschied zwischen MorphIT Modus und nativem Modus mitbekommt, obwohl jeder MorphIT-Frame eine eigene Websocket-Verbindung zum MorphIT-Server aufbauen muss, während sich die HTML-WebWidgets in MorphIT alle die bestehende Websocket-Verbindung von MorphIT teilen.

Semantik PutValue

207137

Alternativ zu URL und APP kann dem Web-Widget auch per PutValue ein Inhalt zugewiesen werden. Hiermit lässt sich auch der Wert von URL und APP überschreiben: Der über PutValue eingefügte Wert hat Priorität.

Code-Beispiel:

Web(webWidget, 10, 25, 700, 200)
[
  INITIALIZE: "<ul><li>Ein Aufzählungspunkt</li><li>Ein anderer Punkt</li></ul>" PutValue
]

Mit PutValue können auch Events  für das Widget ausgelöst werden. Mit der Provider Procedur httpTools::UseAsImgButton wird ein Web-Widget zu einem Bild-Button mit einem SELECT-Event.

Es gibt zwei Möglichkeiten:

morphitApi.services.webwidgetLoader.loadWidget()
    .then(widget => {
        const channel = morphitApi.services.webwidgetCommunication.registerWidget(widget.id);
        widget.onDestroy(() => channel.close()); // close when no longer needed

        // set onclick handler
        widget.element.onclick = () => {
            channel.send('DOCUMENT_SELECTED', {"identNo": "123"});
        };       

    });

Weitere Informationen

WebWidget-Übersicht und -Entwicklung
 

Siehe auch

• OpenWidget
• SetUrl
• SetApp