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ö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.Dabei muss der oder die Programmierer:in lediglich über RPGWX die anzuzeigenden Dateien, Felder oder Spalten definieren. 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)

Listanzeigen können mit Subfiles in der Green-Screen-Programmierung verglichen werden. Über AJAX-Technologien sind automatisch (ohne zusätzliche Programmierung) Funktionen, wie Vertauschen der einzelnen Spalten, beliebige Festlegung der Spaltenbreite, auf- und absteigende Sortierung nach einzelnen Spalten oder Nachladen von Datensätzen integriert.

Für Listanzeigen können diverse Filter definiert werden, durch die zur Laufzeit nur die gewünschten Informationen aus den Tabellen selektiert werden.

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

Detail-Anzeige (oder Change Tables/Programme)

Detail-Anzeigen entsprechen den Detail-Anzeigen in der Green-Screen-Programmierung.

Der Programmierer definiert die Dateien/Tabellen oder Views, sowie die anzuzeigenden/zu erfassenden Felder/Spalten. Es ist möglich diverse Reiter anzulegen unter denen die Felder/Spalten gruppiert werden. Aufbereitungsoptionen der einzelnen Felder/Spalten werden über Schlüssel-Worte gehandelt.

Das Einlesen der Daten, die Prüfungen sowie das Fortschreiben der Daten obliegt weiterhin dem Programmierer.

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.