Inhaltsübersicht

Was ist RPGWX?

RPGWX ist eine Sammlung von ILE Prozeduren und Funktionen, mit deren Hilfe Web-Anwendungen allein mit RPG IV erstellt werden könnenkö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 RPGWX seine Prozeduren zur Verfügung.Die Darstellung im Browser wird von RPGWX eigenständig mit mit Hilfe von AJAX-Technologien (Asynchronous Javascript And XML) durchgeführt. Der Programmierer muss Dabei muss der oder die Programmierer:in lediglich über RPGWX die anzuzeigenden Dateien, Felder oder Spalten definieren und sofern gewünscht Aufbereitungsoptionen für die einzelnen Felder angeben.

Weiterhin liefert Directweb Werkzeuge zur Verwaltung und Integration der Web-Programme. So können die Web-Programme in einem Menü hinterlegt werden. Bibliothekslisten können auf Programm- oder Anwendungsebene zugeordnet werden. Es bestehen Möglichkeiten zur Hinterlegung von Informationen und SQL-Statements, die in die RPGWX-Programme eingebunden werden können, und die zur Laufzeit als Combo-Boxen oder Matchcode-Programme aufbereitet werden.

Aktuell werden von Dirweb/RPGWX die folgenden Anzeige-Formate unterstützt:

• List- oder WRK-Programme (entsprechen Subfile-Programmen)
• Detail- oder CHG-Programme (Bearbeiten einzelne Sätze)

. Eine Reihe von Aufbereitungsoptionen erlaubt es, die Darstellung der Felder anzupassen (Matchcode-Programme, Comboboxen, Dezimalstellen, Datumsaufbereitung etc.).

Im Grunde ersetzen die RPGWX-Funktionen den Befehl EXFMT des klassischen RPG durch einen enstprechenden "Wx_Open"-Befehl).Dabei wird zwischen zwei Darstellungsarten unterschieden:

• List-Anzeigen (entsprechen Subfile-Programmen) - werden in RPGWX als "WRK"-Programme bezeichnet
• Detail-Anzeugen zum Bearbeiten einzelner Sätze - werden in RPGWX als "CHG"-Programme bezeichnet

Die Wx_ - Prozeduren und Funktionen

Die Namen aller RPGWX-Prozeduren und Funktionen beginnen mit "Wx_".

Bei Programmen für List-Anzeigen heisst die ILE-Prozedur, die anstelle von EXFMT zu verwenden ist: Wx_OpnHTMLWrk().

Bei Programmen für Detail-Anzeigen heisst die ILE-Prozedur, die anstelle von EXFMT zu verwenden ist: Wx_OpnHTMLChg().

Es gibt Wx_ - Prozeduren und Funktionen,

• die nur in WRK-Programmen verwendet werden können, siehe: Prozeduren für WRK-Programme
• die nur in CHG-Programmen verwendet werden können, siehe: Prozeduren für CHG-Programme
• die in beiden Arten verwendet werden können, siehe: Prozeduren für beide Programm-Arten (WRK und CHG)

Obligatorische und Optionale Parameter

Auf den o.g. Seiten werden die Wx_ - Prozeduren und Funktionen mit ihren Parametern beschrieben.

• Obligatorische Parameter müssen natürlich immer übergeben werden
• Optionale Parameter sollten nicht übergeben werden, wenn sie nicht verwendet werden

List-Anzeigen (oder Work Tables/Programme)

...

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