/
Aufbereitungsoptionen in RPGWX-Prozeduren

Toolmaker Produkt-Dokumentation

Aufbereitungsoptionen in RPGWX-Prozeduren

Oct 23, 2025

Inhaltsübersicht

 

Um die Anzahl der Parameter so gering wie möglich zu halten, werden Aufbereitungsoptionen in Form von Schlüssel-Worten in einem Text-String übergeben. Sind mehrere Aufbereitungsoptionen erforderlich (z.B. Muss-Feld und Datumsaufbereitung), werden die Schlüssel-Worte hintereinander durch *Blanks getrennt angegeben.

Optionen sind nicht case sensitive, d.h. die folgenden Optionen führen zum gleichen Ergebnis: required, REQUIRED, Required, ReQUired

Viele Prozeduren - insbesondere die zur Ausgabe von Variablen im Browserfenster - haben Optionen zur Aufbereitung. Diese in Form von Schlüssel-Worten in einem Text-String übergeben. Sind mehrere Aufbereitungsoptionen erforderlich (z.B. Muss-Feld und Datumsaufbereitung), werden die Schlüssel-Worte hintereinander durch *Blanks getrennt angegeben.

Beispiele:

Die Prozedur Wx_ChgFld sorgt dafür, dass in einem CHG-Programm ein Feld im Browserfenster erscheint. Die Aufbereitungsoptionen sind ihr letzter (optionaler) Parameter.

Wx_ChgFld('ADRID : %Addr(ADRID) : 'FAD0000' : 'Output');

→ Das Feld ADRID erscheint, ist aber nicht eingabefähig

Wx_ChgFld('PLZ' : %Addr(PLZ) : 'FAD0200' : 'Required NoNewLine');

→ Das Feld PLZ ist ein Muss-Feld und das nächste Feld wird in derselben Zeile erscheinen

Optionen sind nicht case sensitive, d.h. die folgenden Optionen führen zum gleichen Ergebnis: required, REQUIRED, Required, ReQUired

Steuerungsoptionen für HTML-Dokumente

Beim Öffnen der HTML-Dokumente können diverse Schlüssel-Worte für die Anzeige und Aufbereitung des Dokuments festgelegt werden.

Die Übergabe der Optionen erfolgt über Schlüssel-Worte beim Öffnen der HTML-Dokumente, d.h. beim Aufruf der Funktionen Wx_OpnHTMLWrk und WX_OpnHTMLChg.

HelpDoc - Hinterlegen einer allgemeinen Hilfe für Detail- und List-Anzeigen

In den Optionen der Prozeduren Wx_OpnHTMLWrk() und Wx_OpnHTMLChg() können Hilfen für die gesamte HTML-Seite hinterlegt werden.

Wenn die Seite mit der Funktion Wx_ChgNavTab() in Reiter aufgeteilt wurde, dann gibt es nur ein HelpDoc für alle Reiter der Seite.

Das Schlüssel-Wort selber kann mit bis zu 4 Parametern, die durch Kommata getrennt werden, angegeben werden.

Die Option helpDoc kann verweisen auf:

  • Eine PDF-Datei, ggf. mit Seitennummer

  • Eine URL

Syntax

Wx_OpnHTMLWrk('xxxx': 'xxxxxx': '': 'helpDoc(<prompt>, <helpsource> [ , <anchor>, <icon> ] )');


Parameter

prompt  - Text der angezeigt wird

Text kann wahlweise direkt oder als Message-Id, die in den Anwendungs-Message-Files hinterlegt sein muss angegeben werden.

helpsource - Name eines PDF-Dokumentes oder Link zum Hilftext

Gütlige Werte:

  • Name eines PDF-Dokuments

    • dieses muss im IFS der IBM i im Anwendungs-Verzeichnis für Hilfe-Dokumente /www/dirweb/htdocs/HelpDocs/<anwendung> hinterlegt sein.

    • Für mehrsprachige Bedienerhilfe müssen unterschiedliche PDF-Dokument in der gleichen Message-Id in den Sprachen-Message-Files hinterlegt werden.

  • URL zu einem Hilfetext

    • direkt (http://....)

    • Verweis auf eine MSGD, in der die URL hinterlegt ist

anchor - Anker im PDF-Dokument

Optional, nur bei PDF-Dokumenten

Gültige Werte:

  • "#page=x": x=Seitenzahl im PDF-Dokument

  • "*NONE": Keine Seitenzahl - nur erforderlich, wenn der nächste Parameter (icon) verwendet werden soll

Sofern keine Seiten-Zahl benötigt wird, jedoch im 4. Parameter ein spezielles Icon hinterlegt werden soll, kann der 3. Parameter mit dem Default-Wert *NONE angegeben werden.

icon  - Individuelles Icon

Optional

Sofern ein individuelles Icon verwendet werden soll, wird dieses ohne Pfad im 4. Parameter angegeben.

Das Icon muss im Anwendungs-Pfad für Icons /www/dirweb/htdocs/HelpDocs/<anwendung> hinterlegt sein.

Wird kein Icon angegeben wird ein Default-Icon verwendet.

Beispiele

Wx_OpnHTMLWrk('Überschrift Programm': 'EXCHGCOMP': '': 'helpDoc(BedienerHilfe, WOPiXX.PDF)');

Wx_OpnHTMLWrk('Überschrift Programm': 'EXCHGCOMP': '': 'helpDoc(BedienerHilfe, WOPiXX.PDF, #page=8)');

Wx_OpnHTMLWrk('Überschrift Programm': 'EXCHGCOMP': '': 'helpDoc(MSG4711, MSG4712, *NONE, MyIcon.png)');

Wx_OpnHTMLWrk('TIT0012' : 'EXCHGCOM' : '' : 'helpDoc(HLP0002, HLP0001, *NONE, Phone-52.png) ');

Steuerungsoptionen nur für Work-Tables

Die folgenden Steuerungsoptionen gelten nur für Worktables

NoList - Beim ersten Aufruf nur die Filter anzeigen

Wird das Schlüssel-Wort NoList übergeben, werden beim ersten Aufruf nur die Filter angezeigt, die Liste enthält noch keine Sätze.

Diese Auswahl ist insbesondere dann sinnvoll, wenn große Dateien durchsucht werden sollen und vorab die Möglichkeit einer Vorauswahl bereitgestellt werden soll.

EmptyList -Beim ersten Aufruf eine leere Liste und die Anzahl der Datensätze anzeigen

Wird das Schlüssel-Wort EmptyList angegeben, werden die Filter und eine leere Liste angezeigt. Das SQL-Statement, das die Liste aufbaut wird ausgeführt. Die Anzahl der Datensätze wird angezeigt.

Bei großen Tabellen bzw. bei komplexen SQL-Statements sollte NoList der Angabe von EmptyList vorgezogen werden.

DoubleClick -Default-Programm für den Doppelklick

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. Weiterhin ist es möglich beim Doppeklick, bevor das Folge-Programm im Änderungs-Modus geöffnet wird ein Bestätigungs-Fenster auszugeben.

Bei dem Schlüssel-Wort können ein oder zwei Parameter angegeben werden. Sofern beide Paramter angegeben werden, müssen sie durch ein Komma getrennt werden.

Das Schlüssel-Wort DoubleClick, sowie die einzelnen Parameter können in jeder beliebigen Groß-/Klein-Schreibung angegeben werden.

Syntax

Wx_OpnHTMLWrk('xxxx': 'xxxxxx': '': 'Doubleclick(<mode>, [ <confirm [ (<confirmmsg>) ] > ] ');

Parameter

modus -  Modus

Gültige Werte

*DSP/*DISPLAY = Anzeige Modus
*CHG/*CHANGE = Änderungs-Modus
*NONE = Keine Aktion bei Doppel-Klick

confirm - Bestätigung erforderlich

Optional, nur für Änderungs- und Anzeige-Modus

Gültige Werte

Confirm:  mit Standard-Bestätigungstext

confirm(<confirmmsg>)
   confirmmsg - Inhalt der Bestätigungsaufforderung
    - Bestätigungstext in Klammern
    - MSGID - Message-Id für Bestätigungstext in Klammern

Beispiele

Wx_OpnHTMLWrk('TIT0012': 'EXCHGCOMP': '': 'DoubleClick(*NONE)');

Wx_OpnHTMLWrk('TIT0012': 'EXCHGCOMP': '': 'DOUBLECICK(*DSP)');

Wx_OpnHTMLWrk('TIT0012': 'EXCHGCOMP': '': 'DoubleClick(*Change, confirm)');

Wx_OpnHTMLWrk('TIT0012': 'EXCHGCOMP': '': 'DoubleClick(*Chg, CONFIRM(Achtung: Änderungsmodus))');

Wx_OpnHTMLWrk('TIT0012': 'EXCHGCOMP': '': 'DoubleClick(*Chg, confirm(BST0007))');

Group - Gruppierung

Durch die Angabe des Schlüssel-Wortes Group bei Aufruf der Funktion WX_OpnHTMLWrk wird am Ende des Kontext-Menüs ein zusätzlicher Kontext-Menü-Punkt „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.

Vergleichsoperatoren für Filter-Felder

Die folgenden Funktionen werden zur Deklaration von Filter-Feldern verwendet:

  • WX_GenFlt() – Generischer Filter

  • Wx_FltFile() – Datei für Filter definieren

  • Wx_FltFld() – Such(Filter-)Feld definieren

  • Wx_FltFileFld() – Filterfile und 1.Feld definieren

  • Wx_BegEnhFlt() – Beginn erweiterter Filter

Bei diesen Funktionen können verschiedene Vergleichsoperatoren für die Filterung angegeben werden. Siehe: Vergleichsoperationen für Filter-Felder.

Aufbereitungsoptionen für Filter-Felder

Die folgenden Funktionen werden zur Deklaration von Filter-Feldern verwendet:

  • WX_GenFlt() – Generischer Filter

  • Wx_FltFile() – Datei für Filter definieren

  • Wx_FltFld() – Such(Filter-)Feld definieren

  • Wx_FltFileFld() – Filterfile und 1.Feld definieren

  • Wx_BegEnhFlt() – Beginn erweiterter Filter

Für das gleiche Filterfeld können mehrere unterschiedliche Optionen angegeben werden. Die einzelnen Optionen werden durch Blanks getrennt in dem Parameter Option als Text übergeben. Die Schlüsselworte können in jeder beliebigen Groß/Kleinschreibung angegeben werden.

Die Aufbereitungsoptionen, die hier beschrieben werden, sind auch für Felder in Detail-Anzeigen verwendbar.

 

CTL(xxx)  Aufbereitung und Anzeige von Werten aus der Parameter-Control-Table

 

Durch die Angabe des Schlüsselwortes CTL(xxx) kann auf die Liste der erlaubten Werte für ein Feld aus einer Parameter Control Table geholt werden.

Parameter Control Tables werden in RPGWX für jede Anwendung individuell eingerichtet und verwaltet. HIer als Beispiel eine Parameter Control Table für Anreden:

Parameter-Tabelle "ADTYPE" mit 4 Einträgen

Zur Laufzeit werden kann der Benutzer einen Wert aus den Werten der Parameter-Tabelle auswählen.

Wenn das Feld kein Pflichtfeld ist, dann fügt RPGWX der Liste eine weitere Auswahl hinzu: "Keine Auswahl" hinzu:

Code im CHG-Programm - kein Pflichtfeld:

Wx_ChgFld('ADTYPE' : %Addr(ADTYPE) : 'FAD0100' : 'CTL(ADTYPE)' );

 

Wenn es ein Pflichtfeld ist, dann werden nur definierten Auswahlen angzeiegt:

 

 

Code im CHG-Programm - kein Pflichtfeld:

Wx_ChgFld('ADTYPE' : %Addr(ADTYPE) : 'FAD0100' : 'CTL(ADTYPE) required' );

 

 

Wenn im Parameter weniger als 4 Auswahlmöglichkeiten (inklusive von "Keine Auswahl"), dann werden die Auswahlen in Form von Radiobuttons dargestellt:

Parameter-Tabelle "ADTYPE" mit nur 3 Einträgen

ExecSQL(<name>) oder ExecSQL(<name>, NoList) - Aufbereitung und Anzeige von Werten aus einer SQL-Abfrage

Durch Angabe des Schlüsselwortes ExecSQL kann die Liste der erlaubten Werte aus einer vom Programmierer hinterlegten SQL-Abfrage geholt werden.

Die von der Abfrage gelieferten Werte können als Combobox oder in einem Fenster aufbereitet, angezeigt und ausgewählt werden.

Die Angabe des 2. Parameters NoList bewirkt, dass zunächst nur die Filter-Felder angezeigt werden, so dass eine Vorauswahl getroffen werden kann.

EnhFlt - Erweiterter Filter

Das Feld kann durch Klicken auf die Pfeil auf/ab Buttons ein- und ausgeblendet werden.

Anstatt das Schlüssel-Wort bei jedem erweiterten Filterfeld anzugeben kann auch die Funktion Wx_BegEnhFlt() – Beginn erweiterter Filter vor dem ersten erweiterten Filter-Feld aufgerufen werden.

Center - Spalten-Inhalt zentrieren

Left - Spalten-Inhalt linksbündig ausrichten

Right -  Spalten-Inhalt rechtsbündig ausrichten

Uppercase -  Eingabe wird in Großbuchstaben übersetzt

Lowercase -  Eingabe wird in Kleinbuchstaben übersetzt

NewLine - Nächstes Feld in nächste Zeile (Default-Wert)

NoNewLine - Nächstes Filter-Feld in der gleichen Zeile

Checkbox oder Logical - Schalter (0/1)

  • 1 - Häkchen (eingabefähiges Feld)

  • 0 - Leeres (eingabefähiges Feld)

DateNum  - Numerisches Datum im Format JJJJMMTT

  • Aufbereitung eines 8-stelligen numerischen Feldes als Datum:

Beispiel 1: Feldinhalt ist 20250228. Benutzerprofil Aufbereitung Datumsformat Tag-Monat-Jahr
Code: Wx_WrkFld('FTYYMD' : 'FTYYMD DATENUM ' : 'DATENUM');

Beispiel 2: Feldinhalt ist 20250228. Keine Aufbereitung des Datums
Code: Wx_WrkFld('FTYYMD' : 'FTYYMD YYYYMMSS ');

TimestampNum  - Numerische Zeitmarken im Format JJJJMMTTHHMMSS

  • Aufbereitung als Zeitmarke

TimeNum - Numerische Zeit im Format HHMMSS

  • Aufbereitung als Zeit

HHMMNum - Numerische Zeit im Format HHMM

  • Aufbereitung als Zeit

Für Echte Datums- und Zeit-Felder müssen keine Aufbereitungsoptionen definiert werden.

Required - Bei dem Filter-Feld handelt es sich um ein Muss-Feld

NotRequired  - Bei dem Filter-Feld handelt es sich um ein Kann-Feld

SelectList -  Combobox mit gültigen Werten

Hierfür gibt es verschiedene Syntaktiken:

  • SelectList oder SelectList()

    • Bildet Combobox mit allen unterschiedlichen Feldwerten in dem definierten Feld in den definierten Dateien/Tabellen/Views.

    • z.B. für Auswahl Stati / Auswahl Länder

  • SelectList(<feldname>) oder SelectList(Field=<feldname>) oder SelectList(Field='<feldname>')

    • Bildet Combobox mit allen unterschiedlichen Feldwerten in dem Feld <feldname> in den definierten Dateien/Tabellen/Views

  • SelectList(File=<dateiname>, <feldname>) oder SelectList(File=<dateiname>, Field=<feldname>) oder SelectList(File='<dateiname>', <feldname>) oder SelectList(File='<dateiname>', Field=<feldname>)

    • Bildet eine Combobox mit allen Unterschiedlichen Feldwerten in der angegebenen Datei/Tabelle/View mit dem angegebenen Feld.

Die angegebene Datei/Tabelle/View, sowie das angegebene Feld müssen nicht zwangsläufig definiert sein.

SQLList - Combobox basierend auf einem SQL-Select-Statement

  • SQLList(<sqlstatement>;)

    • Wichtig: Das SQL-Select-Statement mit einem Semikolon (;) abgeschlossen werden.

    • Bildet eine Combobox basierend auf dem Ergebnis, das das SQL-SELECT-Statement zurückliefert.

    • Wird in dem SELECT-Statement nur eine einzige Spalte definiert, wird nur diese angezeigt und die entsprechenden Werte zurückgegeben:

SQLList(Select Distinct PLZ from AdresseX;)

→ Rückgabe: PLZ


Werden in dem SELECT-Statement mehrere Spalten ausgewählt, so werden die Spalten-Werte aus der 2. Spalte angezeigt. Bei Auswahl wird der Wert der 1. Spalte zurückgegeben.

SQLList(Select Distinct PLZ, PLZ concat ' ' concat ORT From AdresseX;)

→ Anzeige: z.B. 86916 Kaufering
→ Rückgabe: 86916

 

DependList - Abhängige Combobox mit gültigen Werten

Basierend auf dem eingegebenen Wert in einem anderen Feld werden nur die abhängigen Auswahlkriterien angezeigt.

Das Feld von dem die Werte in der Combobox abhängen, muss vor dem abhängigen Feld definiert werden.

Beispiel: Abh. vom Land enthält die Combobox nur die Orte, die in dem entsprechenden Land liegen.

  • DependList(<feldname>)

    • Bildet die Werte in der Combobox abhängig von dem erfassten Wert in <feldname>.

  • DependList(File=<dateiname>, <feldname>, KeyA=KeyB)

    • Bildet die Combobox aus der Tabelle <dateiname> und der Spalte <feldname> (in Tabelle <dateiname>). Die Tabelle <dateiname> wird über den Schlüssel KeyB mit dem Feld KeyA (das zuvor definiert wurde) mit der definierten Tabelle, in der KeyA hinterlegt ist verknüpft.

    • Sofern mehrere Schlüssel-Felder erforderlich sind, müssen diese anschließend durch ein logisches AND getrennt angegeben werden.

    • → KeyA1=KeyB1 and KeyA2=KeyB2 etc.)

Beispiel: Das Land (Spalte ELAND) wird erfasst. Die Orte (Spalte XORT) die ausgewählt werden dürfen sind in Datei ADRESSEX hinterlegt.

DependList(File=AdresseX, XORT, ELAND=XLand)

ValuesList - Combobox aus den vorgegebenen Werten, Beispiele:

  • ValuesList(Offen, Bestätigt, Erledigt)

  • ValuesList(2, 4, 8, 16, 32)

ListNumRange -  Combobox mit allen numerischen Werten in dem angegebenen Bereich

  • ListNumRange(100, 150)

    • Bildet eine Combobox mit allen ganzzahligen Werten zwischen 100 und 150

  • ListNumRange(100, 150, 10)

    • Bildet eine Combobox mit den Werten 100, 110, 120, 130, 140, 150,

ListMonth  - Combobox mit den Werten 1-12 für den Monat

ListMonthName - Combobox mit sprachenabhängigen Monatsnamen, sortiert nach dem numerischem Monat (Januar=1, Dezember=12).

  • Rückgabe-Wert: sprachenabhängiger Monatsname

ListMonthNameNum - Combobox mit sprachenabhängigen Monatszahlen (1=Januar, 12=Dezember)

  • Rückgabe: Wertnumerischer Monat (Januar=1 / Dezember=12)

ListDay - Combobox mit den Werten 1-31 für den Tag im Monat

  • Aktuell keine abhängige Combobox

ListDayName - Combobox mit sprachenabhängigen Wochentagsnamen, sortiert nach dem numerischem Wochentag (Montag=1, Sonntag=7).

  • Rückgabe: Wertsprachenabhängiger Wochentagsname

ListDayNameNum - Combobox mit sprachenabhängigen Wochentagssnamen, sortiert nach dem numerischen Wochentag (Montag=1, Sonntag =7)

  • Rückgabe: Wertnumerischer Wochentag (Montag=1 / Sonntag=7)

ListHour  - Combobox mit den Werten 0-24 für die Stunden

 

ListMinSec - Bildet eine Combobox mit den Werten 0-59 für Minuten und Sekunden

 

AutoComplete - AutoComplete Combobox

  • AutoComplete oder Autocomplete()

    • Bildet eine AutoComplete Combobox basierend auf den aktuellen Werten in dem definierten Feld aus den definierten Tabellen

  • Autocomplete(File=<dateiname>, <feldname>)

    • Bildet eine AutoComplete Combobox basierend auf den Werten in der Spalte MyFld aus der Tabelle MyFile.

DependAuto - Abhängige Autocomplete Combobox

  • DependAuto(MyFld)

    • Bildet die Werte in der AutoComplete Combobox abhängig von dem erfassten Wert in Spalte MyFld.

AutoDepend(File=<dateiname>, <feldname>, KeyA=KeyB)

  • Bildet die AutoComplete Combobox aus der Tabelle MyFile und der Spalte MyFld (in Tabelle MyFile). Die Tabelle MyFile wird über den Schlüssel KeyB mit dem Feld KeyA (das zuvor definiert wurde) mit der definierten Tabelle, in der KeyA hinterlegt ist verknüpft.

Sofern mehrere Schlüssel-Felder erforderlich sind, müssen diese anschließend durch ein logisches AND getrennt angegeben werden.

--> KeyA1=KeyB1 and KeyA2=KeyB2 etc.)

Beispiel: Das Land (Spalte ELAND) wird erfasst. Die Orte (Spalte XORT) die ausgewählt werden dürfen sind in Datei ADRESSEX hinterlegt.
AutoDepend(File=AdresseX, XORT, ELAND=XLand)

Aufbereitungsoptionen für Spalten

Für eine Spalte (Prozedur Wx_WrkFld() ) können mehrere unterschiedliche Aufbereitungs-Optionen angegeben werden. Die einzelnen Optionen werden durch Blanks getrennt in dem Parameter Option als Text übergeben.

Die Schlüsselworte können in jeder beliebigen Form der Groß/Kleinschreibung angegeben werden.

Bei der Definition von Spalten in Work Tables können die folgenden Aufbereitungsoptionen angegeben werden.

NoSort - Sortieren nicht zulässig

Per Default können List-Anzeigen nach allen definierten Spalten sortiert werden. Sofern für einzelne Spalten eine Sortierung nicht zulässig ist, kann das Schlüssel-Wort NoSort angegeben werden.

Center -  Spalten-Inhalt zentrieren

Left  - Spalten-Inhalt linksbündig ausrichten

Right  - Spalten-Inhalt rechtsbündig ausrichten

Hidden  - Spalte wird nicht angezeigt

Logical  - Schalter (0/1)

  • 1 - Anzeige als Häkchen

  • 0 - Leere Spalte

DateNum - Numerisches Datum im Format JJJJMMTT

  • Aufbereitung eines 8-stelligen numerischen Feldes als Datum

Beispiel für das Feld mit Option DateNum: 

TimestampNum - Numerische Zeitmarken im Format JJJJMMTTHHMMSS

  • Aufbereitung als Zeitmarke

TimeNum - Numerische Zeit im Format HHMMSS

  • Aufbereitung als Zeit

HHMMNum - Numerische Zeit im Format HHMM

  • Aufbereitung als Zeit

Für Echte Datums- und Zeit-Felder müssen keine Aufbereitungsoptionen definiert werden.

FMT() - Aufbereitung von Dezimalfeldern

RPGWX bereitet numerische Felder (mit und ohne Dezimalstellen) im Standard so auf, wie es in den IBM i > Systemwerten > Typ *EDT eingetragen ist. Das betrifft folgende Feldtypen:

  • SQL-Datentyp DECIMAL

  • DDS-Datentyp P (Packed decimal)

  • DDS-Datentyp S (Zoned decimal)

Beispiel mit QDECFMT=B(blank): 1,000.52

Beispiel mit QDECFMT=J: 1.000,52

Mit FMT() werden die Gruppenzeichen entfernt (Tausenderpunkt): 1000,52

Mit FMT(*NONE) wird keine Aufbereitung vorgenommen, egal was in QDECFMT steht: 100052

Zusammenfassung:

  • SQL-Datentyp INTEGER wird per Default NICHT mit Dezimalkomma und Tausenderpunkt aufbereitet: 123456789
    Wenn Tausenderpunkt gewünscht wird, muss fmt(*DEC) angegeben werden.

  • DDS-Daten vom Typ P oder S erhalten per Default einen Dezimalkomma und Tausenderpunkt.
    Wenn Tausender-Trennzeichen NICHT gewünscht sind, muss fmt() angegeben werden.
    Wenn weder Tausender-Trennzeichen noch Dezimalkomma gewünscht sind, muss fmt(*none) angegeben werden.

CTL(xxx) - Aufbereitung und Anzeige von Werten aus der Parameter-Control-Table

Durch die Angabe des Schlüsselwortes CTL(xxx) kann auf die Liste der erlaubten Werte für ein Feld aus einer Parameter Control Table geholt werden.

Parameter Control Tables werden in WOPiXX für jede Anwendung individuell eingerichtet und verwaltet.

KEEPFORMAT - Die ursprüngliche Formatierung von Textfeldern wird beibehalten

Standardmäßig werden Textfelder ohne Mehrfach-Blanks angezeigt. In den meisten Fällen ist das optisch gewünscht.

Wenn der Inhalt eines Charakterfeldes in der Originalform, z.B. mit führenden Blanks oder mehreren Blanks im Text, angezeigt werden soll, kann man als Option KEEPFORMAT verwenden.

Beispiel für ein Textfeld mit KEEPFORMAT:

C MOVE 'AS400' LCLCLS

Beispiel für ein Textfeld in Standard-Formatierung: (komprimiert alle Leerstellen zu einer) 

C MOVE 'AS400' LCLCLS

Filter(xxx) - Definition von Inline-Filter. Die folgenden Optionen (xxx) sind zulässig:

  • Text_Filter

  • Select_Filter

  • Combo_Filter

  • Text_Search

  • Numeric_Filter

BgColor(Farbe) - Hintergrundfarbe

Mit Hilfe des Schlüssel-Wortes BgColor (oder auch BgColour) kann die Hintergrund-Farbei bei einer Spalte festgelegt bzw. geändert werden.

  • Bgcolor(red) Angabe der Farbe z.B. red, blue, white

  • Bgcolor(#FFF5B7) Angabe der Farbe als Hex-Wert

Beispiel

führt zu dieser Darstellung:

FontColor -  Schriftfarbe

Über das Schlüssel-Wort FontColor(Farbe) (oder auch fontcolour() fntcolor(), fntcolour()) kann die Text-Farbe von Buttons vorgegeben werden. Die Angabe der Farbe erfolgt wie in HTML, also z.B. Farbe in englisch fontcolor(red). Alternativ kann anstatt der Farbe auch ein Hex-Wert angegeben werden, z.B. FontColor(#FFF5B7)

Exit() - Externe Funktionen für die Aufbereitung

Mit exit() kann man ein eigenen Code für die Steuerung der Darstellung hinterlegen.

Syntax

Wx_WrkFld('fldname' : 'feldbezeichnung' : 'Exit( <proc_name>, <srvpgm_name>, <srvpgm_lib>, <fieldfunction>)');

Parameter

proc_name - Name der Prozedur im Exit-Programm

srvpgm_name - Name des Serviceprogrammes

Optionaler Parameter - wenn er ausgelassen wird, dann wird das Serviceprogramm DWEXTFNC verwendet

srvpgm_lib - Bibliothek des Servicprogrammes

Optionaler Parameter - wenn er ausgelassen wird, dann wird das Serviceprogramm *LIBL verwendet

fieldfunction - Name der aufzurufenden Feldfunktion

Optionaler Parameter - wenn er ausgelassen wird, dann wird keine Feldfunktion aufgerufen

Beispiele

  • Exit(geticncmb)  -  Es wird die Prozedur geticncmb aus dem Serviceprogram DWEXTFNC in *LIBL aufgerufen

  • Exit(SC, EXITPGM1) -  Es wird die Funktion SC aus dem Serviceprogram EXITPGM1 in *LIBL aufgerufen

  • Exit(SC, EXITPGM1, QGPL) -  Es wird die Funktion SC aus dem Serviceprogram EXITPGM1 in QGPL aufgerufen

Beispielprogramm für ein Exit-Programm

Ein Beispielprogramm ist auf der Seite Beispiel-Programme im Abschnitt "Exit-Programm für die Darstellungs-Steuerung in Spalten in Wrk-Programmen" dargestellt.

Image  -Inhalt als Bild anzeigen

Handelt es sich bei dem Spalten-Inhalt um einen Link (IFS-Datei-Name), so wird die IFS-Datei (z.B. Bild oder Icon) an dieser Stelle angezeigt

Sofern nur das Schlüssel-Wort Image angegeben wird, wird das Bild in Icon-Größe ausgegeben.