Inhaltsübersicht

WOPiXX ist eine Sammlung von ILE Prozeduren und Funktionen, mit deren Hilfe Web-Anwendungen allein mit RPG IV erstellt werden können. Kenntnisse von HTML, JavaScript, CSS oder stateless Programmierung sind nicht erforderlich. Alle Funktionen, die nichts mit dem Benutzer-Dialog zu tun haben (Datenbankzugriffe, Plausibilitätsprüfung, Berechnungen) erfolgen mit "normalem" RPG. Für den Dialog mit dem Benutzer stellt WOPiXX seine Prozeduren zur Verfügung.

...

Kontext-Menü-Punkte und Buttons zum Aufruf von Folge-Programmen können beliebig definiert werden.

Abbildung 1: Beispiel List-Anzeige/Work Table

Detail-Anzeige (oder Change Tables/Programme)

...

Auch bei der Detail-Anzeige können Buttons für Bearbeitungsoptionen (z.B. Sichern der erfassten Daten) oder zum Aufruf von Folge-Programmen definiert werden.

Abbildung 2: Detail-Anzeige / Change Table

Neuerungen seit Version 2.11

• Benannte Parameter

Informationen für den Folge-Aufruf (bzw. für die komplette Session) können in Form von benannten Parametern, d.h. unter einem beliebigen Namen gesichert werden.
Es werden Funktionen zur Verfügung gestellt, über die benannte Parameter(-Werte) in fast jedem beliebigen Datentyp (Alpha, Unicode, gepackt/gezont, ganzzahlig, Datum, Zeit und Zeitmarke) gesichert werden kann.
Des weiteren werden Funktionen zur Verfügung gestellt, über die die gesicherten benannten Parameter-Werte in den o.g. Datentypen empfangen werden können.

• Editierbare Listen

Durch die Definition des Buttons EdtList bzw. den Aufruf der Funktion Wx_WrkBtnEdtList() können Spalten-Inhalte in List-Anzeigen geändert werden.
Bei Klick auf den definierten Button werden die geänderten Spaltenwerte an das Programm zurückgegeben.
Durch die Angabe des Schlüssel-Wortes Output bei der Spalten-Definition können die Spalten vor einer Änderung geschützt werden.

• ShortCuts für Buttons und Kontext-Menü-Anzeigen

Mit Hilfe des neuen Schlüssel-Wortes ShortCut können für alle Buttons (in List- und Detail-Anzeigen), sowie für Kontext-Menü-Punkte ShortCuts definiert werden.
Die ShortCuts stellen für den Anwender eine Alternative zum Mouseclick bzw. zur Kontext-Menü-Auswahl über die rechte Mouse-Taste dar.

• Neue Schlüssel-Worte für Comboboxen
• DayNameCombobox mit Wochentagsnamen jeweils in der

Spache des aktuellen Anwenders
Rückgabe-Wert: Name des Wochentags
Sortierung nach numerischem Wochentag (Montag=1, Sonntag=7)

• DayNameNumCombobox mit Wochentagsnamen jeweils in der

Sprache des aktuellen Benutzers
Rückgabe-Wert: Numerischer Wochentag (Montag=1)
Sortierung nach dem numerischen Wochentag

• MonthNameCombobox mit Monatsnamen jeweils in der Sprache

des aktuellen Benutzers
Rückgabe-Wert: Monats-Name
Sortierung nach dem numerischen Monat

• MonthNameNumCombobox mit Monatsnamen jeweils in der Spache

des aktuellen Benutzers
Rückgabe-Wert: numerischer Monat (Januar=1)
Sortierung nach dem numerischen Monat

• Bilder in List-Anzeigen (Aufpoppen in vorgegebener Größe)

Bilder in Listanzeigen werden über das Schlüssel-Wort image gesteuert.
Wird nur das Schlüssel-Wort image angegeben, so wird beim Mouseover das Bild in Original-Größe angezeigt.
Über zusätzliche Parameter bei Schlüssel-Wort image kann die Anzeigegröße festgelegt werden  Image(Breite,Höhe)

• Schlüssel-Wort isLink

Bei Schlüssel-Wort isLink wird bei einem Klick per Default in das Folge-Programm im Änderungsmodus verzweigt.
Wird das Schlüssel-Wort isLink(Output) angegeben, wird in das Folge-Programm im Anzeigemodus verzweigt.

• Erweiterung manuelle SQL-Abfragen

Bereits in den früheren WOPiXX-Versionen konnten für List-Programme SQL-Statements manuell vorgegeben werden.
Die Tabellen oder Views aus denen jedoch die einzelnen Spalten und Filter-Felder stammen, mussten wie beim automatisch generierten SQL mit allen Join-Anweisungen hinterlegt werden.
Durch die letzte Erweiterung ist es nicht mehr erforderlich bei manuellen SQL-Statements die Tabellen extra zu definieren. Spalten müssen nur dann noch über die Funktion Wx_WrkFld() definiert werden, wenn nicht der Spalten-Name, sondern eine abweichende Überschrift ausgegeben werden soll oder eine spezielle Aufbereitung für die Spalte erforderlich ist.
Zur Definition von Filter-Feldern für die manuellen SQL-Abfragen, wurden eine Reihe von neuen Funktionen eingeführt, über die Filter-Felder mit dem gewünschten Datentypen definiert werden können. Die Filter-Informationen werden von WOPiXX automatisch generiert und zu dem manuellen SQL-Statement hinzugefügt.

• Ermitteln Spalten-Listen über Funktion für manuelle SQL-Statements

Auch für manuelle SQL-Statements müssen die Schlüssel- und Spalten mit den Wx_WrkKeyRRN/Wx_WrkKeyFld bzw. mit den Funktionen Wx_WrkFld() definiert werden. Zumindest dann, wenn eine Überschrift angegeben oder Aufbereitungs-Optionen gesetzt werden müssen.
Sofern es sich bei den Spalten in dem manuellen SELECT-Statment nicht um Ausdrücke (z.B. Menge * Preis oder Date(Digits(NumDate) concat '000000') handelt, werden mehrere Funktionen zur Verfügung gestellt, über die in den WOPiXX-Funktionen definierten Spalten durch Kommata getrennt aufgelistet werden.

• Wx_WrlSQLManKey() – Schlüssel-Werte
• WX_WrkListColumns() – Spalten
• WxX_WrkListKeyAndColumns – Schlüssel und Spalten.

Das Ergebnis aus diesen Funktionen kann innerhalb des manuellen SELECT-Statements verwendet werden.

• Schüssel-Wort Icn(Icon) für Funktion Wx_ChgNavTab()

Mit Hilfe des Schlüssel-Wortes Icn(Icon) kann für Reiter/Navigation Tabs ein Icon angegeben werden.
Die Icons werden ohne Pfad angegeben und müssen im Icons-Verzeichnis der Anwendung hinterlegt werden.
/www/dirweb/htdocs/icons/ANWENDUNG

• Schlüssel-Wort HelpDoc für die Funktionen Wx_OpnHTMLWrk() und Wx_OpnHTMLChg()

Für jede Change oder List-Anzeige kann ein universelles Hilfe-Dokument hinterlegt werden.
Dieses Hilfe-Dokument wird in der linken oberen Ecke der der List- bzw. der Detail-Anzeige ausgegeben werden und kann durch Klick auf das Icon geöffnet werden.
Bei dem Hilfe-Dokument kann es sich wahlweise um ein PDF-Dokument, das im Anwendungsverzeichnis für Hilfe-Dokumente hinterlegt sein muss, oder um einen Link handeln.

• Schlüssel-Wort DoubleClick für die Funktion Wx_OpnHTMLWrk

Standardmäßig wird bei DoubleClick auf einen Satz in der List-Anzeige das Folge-Programm im Änderungs-Modus eröffnet.
Vielfach ist dies jedoch nicht erwünscht, d.h. entweder soll das Folge-Programm bei Doppelklick im Anzeige-Modus geöffnet werden, oder bei Doppelkllick soll keine Aktion erfolgen.
Mit Hilfe des Schlüssel-Wortes DoubleClick kann das Standard-Verhalten beeinflusst werden, d.h. es kann festgelegt werden, ob und in welchem Modus das Folge-Programm geöffnet wird.
Weiterhin ist es möglich beim Doppeklick, bevor das Folge-Programm im Änderungs-Modus geöffent wird ein Bestätigungs-Fenster auszugeben.

• Maximum 1000 Ein-/Ausgabe-Felder in Change Tabellen

• Beschleunigung

• Cachen von Message-Texten

Im Zuge der Beschleunigung werden die mehrsprachigen Texte nicht mehr bei jedem Durchlauf neu ermittelt, sondern einmalig pro Sprache.
Sofern ein Nachrichten-Text noch nicht ermittelt wurde erfolgt die Ermittlung automatisch.
Sofern Nachrichten-Texte geändert werden, müssen die gecachten Message-Texte gelöscht werden.
Die Berarbeitung der Message-Texte erfolgt über das Programm mit Cache MsgId Einträgen arbeiten.

• Anzeige der Versions-Nr.

Sofern für die Anwendung eine Versions-Nr. vorliegt, wird diese in den Überschriften, nach der Anwendung angezeigt.
Die Versions-Nr. kann nur beim Exportieren einer Anwendung erfasst werden.
Die Versions-Nr. besteht aus 3 Teilen: Version.Release.PTF.

• Gruppierung

Durch das Schlüssel-Wort Group bei Aufruf der Funktion WX_OpnHTMLWrk kann wird ans Ende des Kontext-Menüs ein zusätzliches Item „Gruppieren" hinzugefügt.
Bei Auswahl dieses Kontext-Menü-Punktes werden die Daten in der Spalte, auf der der Cursor gerade steht, verdichtet.
Sofern einzelne Spalten nicht verdichtet werden sollen oder dürfen, kann dies durch Angabe des Schlüssel-Wortes NoGroup bei Aufruf der Funktion Wx_WrkFld unterbunden werden.

• Wahlweise Anzeige von Icons und/oder Texten in Verbindungng mit Schlüssel-Wort CTL

In Listanzeigen kann über das Schlüssel-Wort CTL gesteuert werden, ob nur die hinterlegten Icons oder die Icons zusammen mit den erklärenden Texten angezeigt werden.
Das Schlüssel-Wort CTL wurde um einen Parameter erweitert, CTL(Kennung, Text). Wird im 2. Parameter Text angegeben, wird der Text zusätzlich zu dem Icon angezeigt.

• Spaltenauswahl in List-Anzeigen

Bei Rechtsklick auf die Überschriften einer List-Anzeige können die anzuzeigenden Spalten ausgewählt werden,
Alle definierten Spalten werden angezeigt.
Bei Klick auf „Spalten-Aufbereitung zurücksezten" werden alle ausgeblendeten Spalten wieder aktiviert.
Das Feature kann nicht deaktiviert werden.

• Schlüssel-Wort Footer in List-Anzeigen

Angabe in Wx_WrkFld(). Festlegung von Aggregat-Funktionen (*SUM/*AVG/*MAX/*MIN) oder Anzeige eines Footer-Textes

• Hilfe-Texte für Buttons und Kontext-Menü-Anzeigen

Sofern in der Message-Id für die selbstdefinierten Buttons oder Kontext-Menü-Punkte ein Level2 Message-Text in der Message-File vorhanden ist, wird dieser bei Mouse Over über den Button angezeigt.
Über das Schlüssel-Wort HelpText, das im Parameter Options übergeben wird können auch andere Hilfe-Texte angegeben werden. Sofern das Schlüssel-Wort HelpText in den Options übergeben wird, wird dieser angezeigt, während der Level2-Message-Text nicht angezeigt wird. Bei Schlüssel-Wort HelpText kann wahlweise eine Message-Id, z.B. HelpText(MSG4711) oder ein Hilfe-Text hinterlegt werden.
Sofern kein Hilfe-Text angezeigt werden soll, kann die Ausgabe und Anzeige des Level2 Hilfe-Textes durch Angabe des Schlüssel-Wortes NoHelpText unterbunden werden.

• Schlüssel-Wort bgcolor(Farbe) zum Ändern der Hintergrund-Farbe von Spalten einer List-Anzeige.
• Sichern und Empfangen von Filter-Werten aus Work-Programmen in Folge-Programmen

Filter-Werte, die in Work-Programmen erfasst werden, können in den Folge-Programme durch einen Funktions-Aufruf abgerufen und weiterverwendet werdenwerden.

• Fehlerhandling in Editierbaren List-Anzeigen

Die erfassten Werte werden über XML-Daten mit dem WOPiXX-Programm ausgetauscht.
Die erfassten/empfangenen Werte werden im WOPiXX-Programm geprüft.
Im Fehler-Fall können über die Funktionen WX_WrkFldErr() und Wx_MultWrkFldErr(). Fehler-Nachrichten ausgegeben werden.

• Schlüssel-lWort WaitMsg für Buttons und Kontextmenü-Einträge

Bei (längerlaufenden) Programmen ohne Bildschirm-Anzeige, die über Klick auf einen
Button oder eine Kontext-Menü-Auswahl aktiviert werden, kann mit dem Schlüssel-Wort eine Uhr aktiviert werden, die erst dann abgeblendet wird, wenn die Verarbeitung abgeschlossen wurde. Nach Ende der Verarbeitung werden die Anzeigen (mit den geänderten Werten) aktualisiert.