/
Einrichten von RPGWX-Anwendungen

Toolmaker Produkt-Dokumentation

Einrichten von RPGWX-Anwendungen

Nov 05, 2025

Inhaltsübersicht

 

RPGWX-Anwendungen werden aus dem Directweb-Menü aufgerufen und müssen folglich in Directweb hinterlegt werden.

RPGWX-Programme werden zu Anwendungen zusammengefasst bzw. müssen in einer Anwendung hinterlegt sein.

Pro Anwendung wird im Directweb-Menü ein Menü-Auswahl-Punkt generiert.

Die Programme, die zu einer Anwendung gehören werden, sofern sie direkt, d.h. aus einem Menü aufgerufen werden als Menü-Unterpunkte für die Anwendung angelegt. RPGWX-Programme können auch über Kontext-Menü (aus Worktables) oder durch einen Klick auf einen Button (Work- und Change-Tables) aufgerufen werden.

Einer Anwendung kann eine Bibliotheksliste zugeordnet werden. Bibliothekslisten werden unabhängig von Anwendungen generiert, d.h. die gleiche Bibliothekliste kann mehreren Anwendungen zugeordnet werden. Zusätzlich können Bibliothekslisten auch auf Programm-Ebene zugeordnet werden.

Auf Anwendungsebene wird ebenfalls festgelegt ob eine Anwendung mehrsprachig ist, und wenn ja in welchen Message-Files die Nachrichten für die entsprechende Sprache hinterlegt ist.

Ebenfalls auf Anwendungsebene können Matchcode entweder über Parameter-Listen oder als gesicherte SQL-Abfragen hinterlegt werden. Sowohl die Parameter-Listen als auch die gesicherten SQL-Abfragen werden in den Programmen in Form von Schlüssel-Worten den Ein-/Ausgabe-Feldern zugeordnet werden.

RPGWX-Anwendungen werden über RPGWX → Anwendungen verwaltet.

List-Anzeige Anwendungen

Nach Auswahl des Menü-Punkts Anwendung werden alle aktuell angelegten Anwendungen aufgelistet.


Spalten

  • Anwendung - Maximal 10 Zeichen lange eindeutige Kennung der Anwendung.

  • Folge-Nr. - Reihenfolge in der die Anwendungen in Menü ausgegeben werden.

  • Text - Bezeichnung/Kurzbeschreibung der Anwendung

  • Export - Gibt an, ob die Anwendung exportiert werden darf.

  • Bibliothek - Objekt-Bibliothek der Anwendung

  • Datenbibliothek - Datenbibliothek, sofern eine separate Datenbibliothek angegeben ist

  • Bibliotheksliste - Sofern der Anwendung eine Bibliotheksliste zugeordnet ist, werden die Bibliotheken in der Reihenfolge, wie sie in der Bibliothekliste hinterlegt sind aufgelistet.

Buttons

  • Erstellen - Durch Klicken auf den Button Erstellen kann eine neue Anwendung generiert werden.

  • Resequenzierung

Der Button Resequenzierung ist bei Aufruf des Programms zunächst ausgegraut.

Die Reihenfolge in der die Anwendungen im Menü-Baum angezeigt werden, kann in dieser List-Anzeige durch drag-and-drop verändert werden.

Sobald die Reihenfolge geändert wurde, wird der Button Resequenzierung aktiviert.

Beim anschießenden Klick auf den Button wird die neue Reihenfolge der Anwendungen gespeichert.

Im Menübaum selber ist die neue Reihenfolge aktuell erst nach der nächsten Anmeldung sichtbar.

  • Anwendung importieren - Konfiguration und Stammdaten einer Anwendung importieren

Mit diesem Button können die Daten einer Anwendung importiert werden, die zuvor (z.B. auf einem anderen System) exportiert wurden und im Form einer Datei mit dem Namen WXEXPIMP vorliegen.

Es werden importiert: das Menü der Anwendung, ihre Texte und Überschriften, Parameter und SQL-Abfragen.

Wenn die Anwendung schon existiert, dann werden die bestehenden Daten vor dem Import in eine Schierungsdatei WXEXPIMP gesichert. Dafür muss der Name einen noch nicht existierenden Bibliothek angegeben werden. Der Backup-Vorgang erstellt diese Bibliothek und die Backup-WXEXPIMP in dieser neuen Bibliothek.

Kontext-Menü

  • Ändern - Änderung der erfassten Anwendungsdaten

  • Löschen - Löschen einer kompletten Anwendung, incl. aller abhängigen Datensätze, IFS Templates und anwendungsindividueller Icons

In der Anwendung registrierte Programme werden nicht gelöscht, sondern lediglich die Einträge aus den RPGWX-Tabellen.

  • Eigenschaften - Anzeigen der Anwendungsdaten

  • Standard-Button/Items – Work - Listet die hinterlegten Standard-Buttons und Kontext-Menü-Items auf - kann nur in der Anwendung RPGWX geändert werden

Die Standard-Buttons und Kontext-Menü-Items werden automatisch in RPGWX integriert, wenn weder ein Button noch ein Kontext-Menü definiert wurde.

  • Standard-Buttons - Listet die Standard-Buttons und Modi auf und zeigt an ob und in welcher Umgebung der Button als Default-Button hinterlegt wurde - kann nur in der Anwendung RPGWX geändert werden

  • Anwendung kopieren - Kopieren einer kompletten Anwendung, mit aller abhängigen Datensätzen, IFS Templates und anwendungsindividuellen Icons.

  • Anwendung umbenennen - Umbenennen der bestehenden Anwendung

  • Menü - Auflistung und Wartung der Benutzer-Menü-Punkte für die Anwendung

  • Sprachen - Auflistung und Zuordnung der Sprachen bei mehrsprachiger Verarbeitung

  • Parameter - Auflistung und Wartung der anwendungsspezifischen Parameter-Listen / Comboboxen.

Die Einbindung der anwendungsspezifischen Comboboxen erfolgt über Option CTL(Parametergruppe)

  • Parameter übernehmen - Einzelne oder alle anwendungsspezifische Parameter-Listen/Comboboxen kopieren.

Parameter-Listen/Combo können sowohl von der RPGWX-Anwendung als auch von jeder beliebigen anderen Anwendung kopiert werden.

Werden Parameter-Listen/Combo-Boxen in den Programmen verwendet, wird zunächst geprüft, ob die entsprechende Parameter-Liste in der aktuellen Anwendung angelegt ist. Sofern die Parameter-Liste/Combo-Box nicht in der aktuellen Anwendung vorhanden ist, wird geprüft, ob sie in der RPGWX-Anwendung angelegt ist. Sofern sie in der RPGWX-Anwendung gefunden wird, wird diese Parameter-Liste/Combo-Box verwendet.

  • SQL Abfrage - Auflistung und Wartung der anwendungsindividuellen SQL-Abfragen (z.B. für Matchcode-Auswahl)

Die Einbindung der SQL-Abfragen in Programme erfolgt über Option ExecSQL(SQL-Abfrage)

  • .SQL Abfragen übernehmen - Einzelne oder alle anwendungsspezifischen SQL-Abfragen kopieren.

SQL-Abfragen können sowohl von der RPGWX-Anwendung als auch jeder beliebigen anderen Anwendung kopiert werden.

Werden in den Programmen gesicherte SQL-Abfragen verwendet so wird immer zuerst geprüft, ob diese SQL-Abfrage in der aktuellen Anwendung vorhanden ist. Kann sie in der aktuellen Anwendung nicht gefunden werden, wird geprüft, ob die Abfrage in der RPGWX-Anwendung hinterlegt wurde. Sofern die Abfrage in der RPGWX-Umgebung gefunden wurde, wird diese verwendet

  • Export - Über diese Funktion können kundenindividuelle Anwendungen exportiert werden, um z.B. im Toolmaker App-Store hinterlegt zu werden, oder um an Kunden ausliefert zu werden.

Die Funktion befindet sich aktuell noch in der Entwicklung und ist deshalb noch nicht im Kontext-Menü der Anwendung bzw. in RPGWX integriert.

Wartung der Anwendungsdaten

Sofern eine Anwendung neu erstellt werden soll erfolgt der Aufruf aus der Worktable Anwendung (6.1 Anwendung) durch Klick auf den Button Erfassen.

Der Aufruf zum Änderung oder Anzeigen der Kopf-Daten für die Anwendung erfolgt ebenfalls aus der Worktable Anwendung (6.1 Anwendung) über Kontext-Menü (Ändern / Eigenschaften=Anzeigen).

Neue Anwendung erstellen

Nach Klick auf den Button Erfassen aus der Worktable-Anzeige Anwendung wird die folgenden Eingabemaske geöffnet.


Eingabe-Felder

  • Anwendung - Eindeutiger maximal 10 Zeichen langer Name 

Der Name sollte aus den Großbuchstaben A-Z und/oder den Ziffern von 0-9 bestehen. Sonderzeichen sollten vermieden werden.

Anmerkung: Die eindeutige Kennung der Anwendung kann im Änderungsmodus nicht geändert werden. Eine Änderung der eindeutigen Kennung ist nur durch das Kopieren der Anwendung auf den neuen Anwendungs-Namen und dem anschließenden Löschen der ursprünglichen Anwendung möglich.

  • Sequenz -  Gibt die Position die die Anwendung im Menübaum einnehmen soll an

Wird keine Folgen-Nr. eingegeben, so wird die Anwendung wird dann ans Ende des Menübaums positioniert.

Durch Klick auf den Button (nach dem Auswahl-Feld) wird die SQL-Abfrage DWAPPSEQ geöffnet, in der die freien sowie durch Anwendungen belegte Folgen-Nr. angezeigt werden. Durch Klicken auf eine nicht belegte Folge-Nr. kann diese übernommen werden.

Anmerkung: Die Anwendung kann auch nach der Erstellung in dem List-Programm, in dem alle Anwendungen aufgelistet sind, durch drag und drop an die gewünschte Stelle positioniert werden.

  • Beschreibung - Beschreibung der Anwendung

Wird die Beschreibung der Anwendung nicht angegeben, wird diese aus dem nächsten Feld ermitelt, Text-Id für Menübaum.

  • Text-ID für Menübaum - Anstatt der Beschreibung kann eine Text-Id hinterlegt werden.

Der Nachrichten-Text wird ermittelt und ebenfalls in die Beschreibung übernommen.

Dieses ist besonders sinnvoll für mehrsprachige Anwendungen, da die in den Text-IDs hinterlegen Nachrichten leicht übersetzt werden können.

  • Anwendungs-Bibliothek - Für jede Anwendung ist eine Objekt-Bibliothek erforderlich.

Die Objekt-Bibliothek kann nach Erstellung der Anwendung nicht mehr verändert werden.

Die für die Anwendung erforderliche Nachrichten-Datei sollte in dieser Bibliothek vorhanden sein.

Alle zu der Anwendung gehörenden RPGWX-Programme sollten in dieser Bibliothek hinterlegt werden.

  • Daten-Bibliothek 

Die Angabe einer zweiten Bibliothek ist nicht zwingend erforderlich.

  • Bibliotheksliste

Jeder Anwendung kann eine Bibliotheksliste zugeordnet werden. In dieser Bibliotheksliste sollten alle für die Anwendung erforderlichen Bibliotheken in der gewünschten Reihenfolge hinterlegt sein.

Zusätzlich kann auch jedem RPGWX-Programm eine eigene Bibliotheksliste zugeordnet werden.

Sofern außer QTEMP, QGPL und den RPGWX und Dirweb-Bibliotheken nur maximal zwei weitere Bibliotheken (Objekt- und Datenbibliothek) erforderlich sind, kann ohne Bibliotheksliste gearbeitet werden.

  • Von RPGWX kopieren - SQL-Abfragen und/oder Parameter

Die von RPGWX zur Verfügung gestellten SQL-Abfragen und Combo-Boxen können in jeder Anwendung verwendet werden.

Bei einer Update-Installation werden die RPGWX-Daten ggf. ausgetauscht, die kopierten Daten bleiben dagegen unangetastet.

  • Export erlaubt - Gibt an ob die Anwendung exportiert (und auf anderen Systemen installiert) werden kann, oder ob es sich um eine lokale Anwendung handelt.

Buttons

  • Speichern Beim Speichern wird, sofern keine Eingabefehler gefunden wurden eine neue Anwendung erzeugt. Neben den Kopf-Daten werden noch die folgenden Objekte und Verzeichnisse generiert

  • Sofern die angegebene Message File nicht in der Objekt-Bibliothek vorhanden ist, wird sie angelegt, sofern dies erwünscht ist.

  • Sofern Beschreibung und Message-Id angegeben wurden, kann die Nachricht in der Anwendungs-Message-File angelegt werden.

  • Hauptmenü-Punkt für die Anwendung

Dieser Menü-Punkt kann nicht gelöscht werden.

  • Standard-Sprache

  • Der IFS-Pfad für die Templates wird erstellt und die Default-Templates in dieses Verzeichnis kopiert

  • Der IFS-Pfand für die Icons wird erstellt.

  • Sofern die Übernahme von Icons, SQL-Abfragen und/oder Comboboxen aus directweb/RPGWX erwünscht waren, werden diese Informationen in die Anwendung übernommen.

 

  • Abbrechen Die Erfassung der Daten wird abgebrochen

 

  • Bibliotheksliste

Eine vorhandene Bibliotheksliste kann über einen Matchcode ausgewählt werden. Sofern die Bibliotheksliste noch nicht erfasst wurde, kann durch Klick auf den Button Bibliotheksliste in das Bibliothekslisten-Wartungs-Programm verzweigt werden und die notwendige Bibliotheksliste angelegt werden.

Anwendung anzeigen/ändern

Über Kontext-Menü-Auswahl in Wartung Anwendungsdaten können die Anwendungskopf-Daten angezeigt (Eigenschaften) oder geändert werden (ändern)


Abbildung 66: Anzeigen/Änderung Anwendung


Eine Änderung des eindeutigen Namens der Anwendung ist über die Kontext-Menü-Auswahl Ändern nicht möglich. Sollte die Anwendung und damit auch alle abhängigen Informationen umbenannt werden, muss dies über Kontext-Menü-Auswahl Anwendung kopieren erfolgen. Die ursprüngliche Anwendung kann im Anschluss gelöscht werden.
Die Objekt-Bibliothek wird einmalig festgelegt und kann im Anschluss nicht mehr geändert werden.
Die übrigen Informationen, die erfasst werden konnten, können auch geändert werden.
Sofern Icons, SQL-Abfragen oder Comboboxen/Parameter von dirweb übertragen werden sollen, werden nur die fehlenden Informationen übernommen. Es werden jedoch keine vorhandene Icons, SQL-Abfragen oder Comboboxen/Parameter überschrieben oder gelöscht.
Die ermittelten Pfade für die HTML-Templates und die Icons werden angezeigt, können aber weiterhin nicht geändert werden.

Anwendung löschen

Das Löschen einer Anwendung erfolgt über Kontext-Menü-Auswahl. Das Löschen muss bestätigt oder abgebrochen werden.


Abbildung 67: Löschen Anwendung


Wurde das Löschen bestätigt werden alle zur Anwendung gehörenden in RPGWX gespeicherten Informationen, d.h. Daten in abhängigen Tabellen sowie IFS-Verzeichnisse und Dokumente mit anwendungsspezifischen Informationen entfernt.
Informationen, die ohne Anwendungs-Kürzel in RPGWX gespeichert wurden (z.B. Bibliothekslisten) werden nicht entfernt.
Individuelle Bibliotheken, Objekte, IFS-Verzeichnisse und –Dateien, die sich nicht unterhalb der RPGWX-Pfade befinden bleiben unangetastet.
Anmerkung: Die Anwendung DIRWEB darf nicht gelöscht werden.

Standard Buttons/Items für List-Anzeigen - nur in der App-RPGWX änderbar

Sofern in Work-Programmen weder Buttons noch Kontext-Menü-Items definiert wurden, werden einige Default-Standard-Buttons und Kontext-Menü-Items automatisch integriert.

Die Standard-Buttons- und Kontext-Menü-Items sollten nur von Toolmaker festgelegt werden.

Über den Menü-Punkt Standard Buttons/Item – Work können die vordefinierten Buttons- und Kontext-Menü-Items angezeigt werden. Weiterhin ist sichtbar, welche der vordefinierten Buttons- und Kontext-Menü-Items automatisch (als Default) integriert werden.

Die Anzeige kann nur bei der Anwendung DIRWEB ausgewählt und angezeigt werden.


Spalten

  • Aktion - Die Aktion entspricht den Modi.

Bei Aufruf der Funktionen Wx_WrkBtn() und Wx_CtxMnuItm() kann für die Standard-Buttons und Kontext-Menü-Items diese Aktion als 1. Parameter übergeben werden.

Zur Definition von Default-Buttons und Default-Kontext-Menü-Items wurden auch spezielle Funktionen, definiert, die die Angabe der Aktion überflüssig machen:

*ADD Button Erfassen/Hinzufügen ( Wx_WrkAdd() )

*EDTLIST Button Änderung Sichern für wartbare List-Anzeigen. - Der Button wird aktiviert, sobald eine Änderung in der List-Anzeige erfolgt ist. ( Wx_WrkEdtList() )

*RESEQ Der Button wird aktiviert, sobald Einträge in List-Anzeigen über Drag und Drop verschoben wurden. ( Wx_WrkReseq() )

*CHANGE Kontext-Menü-Item Ändern ( Wx_CtxMnuItmChange() )

*COPY Kontext-Menü-Item Kopieren ( Wx_CtxMnuItmCopy() )

*DELETE Kontext-Menü-Item Löschen ( Wx_CtxMnuItmDelete() )

*PROPERTY Kontext-Menü-Item Eigenschaften/Anzeigen ( Wx_CtxMnuItmProperty() )

Die Aktionen können im Folge-Programm als übergebene Modi abgeprüft werden.

Die Aktion kann bei Aufruf der Funktion Wx_isMode() als 1. Parameter übergeben werden.

Zur Prüfung der Standard-/Default-Modi wurden ebenfalls Funktionen angelegt, die die Angabe der Aktion als Parameter überflüssig machen:

Standard Buttons - nur in der App-RPGWX änderbar

Sowohl in den List- als auch in den Change-Programmen werden eine Reihe von Standard-Buttons oder Funktionen integriert. Über die Auswahl Standard-Buttons wird ersichtlich welche Standard-Buttons in Change und Work-Programmen definiert werden können und welche automatisch integriert werden.

Die Standard-Buttons, sowie die Default-Einstellungen sollten nur von Toolmaker festgelegt werden.

Der Aufruf und die Anzeige sind bei Anwendung DIRWEB erlaubt.


Abbildung 69: Standard / Default – Buttons

Spalten

  • Button - Gibt die Aktion/Modus für den Button an

  • Default im Änderungs-Modus

Kennzeichnet die Default-Buttons in Change-Programmen im Änderungsmodus.

Im Änderungsmodus werden automatisch die Buttons Sichern/Save und Abbrechen/Cancel integriert.

Refresh wird als Icon in der Header-Zeile hinterlegt

  • Default im Anzeige-Modus - Kennzeichnet die Default-Buttons in Change-Programmen im Anzeigemodus.

Im Anzeigemodus werden automatisch die Buttons Ändern (Wechsel in Änderungsmodus) und Weiter/Continue integriert.

Refresh wird als Icon in der Header-Zeile hinterlegt

  • Default in Work-Tables - Kennzeichnet die Default-Buttons in Worktables

In Worktables wird nur der Hinzufügen/Add-Button automatisch integriert.

  • Default im Editier-Modus - Kennzeichnet die Default-Buttons im Editier-Modus in WorkTables integriert werden.

In WorkTables wird im Editier-Modus der Hinzufügen/Add-Button und der EdtList-Button automatisch integriert.

  • Aktiv/Inaktiv - Gibt an, ob die Buttons (bzw. Einstellungen) Aktiv oder Inaktiv sind.

Anwendung kopieren

Über den Kontext-Menü-Punkt Anwendung kopieren in Wartung Anwendung, kann eine Anwendung dupliziert werden.


Abbildung 70: Anwendung kopieren

Eingabe-Felder

  • Von Anwendung

Die zu kopierende Anwendung muss angegeben werden.
Durch Klick auf den Button wird die SQL-Abfrage DWAPP aufgerufen und alle Anwendungen angezeigt. Die gewünschte Anwendung kann ausgewählt und übernommen werden.

  • Nach Anwendung

Der Name der neuen Anwendung muss angegeben werden.
Sofern die neue Anwendung bereits existiert, wird ein Fehler ausgegeben. Sofern eine bereits vorhandene Anwendung ersetzt werden soll, muss Ersetzen Ja/Nein angegeben werden.

  • Ersetzten Ja/Nein

Gibt an ob eine eventuell vorhandene Anwendung ersetzt werden darf.

Buttons

  • Speichern Beim Speichern wird eine neue Anwendung erzeugt. Neben den Kopf-Daten werden noch die folgenden Informationen für die neue Anwendung übernommen.

  • Hauptmenü-Punkt, sowie alle Unter-Menü-Punkte für die Anwendung

  • Sprachen

  • SQL-Abfragen

  • Comboboxen/Parameter

  • Der HTML-Templates, IFS-Dokumente und Icons werden in die neu erstellten anwendungsindividuellen Verzeichnisse kopiert.


Sofern die neue Anwendung bereits existiert und ersetzt werden darf, werden alle vorhandenen zur neuen Anwendung gehörenden Informationen (abhängige Datensätze und IFS-Verzeichnisse und -Dokumente) zunächst gelöscht.

  • Abbrechen

Die Erfassung der Daten wird abgebrochen

Anwendung umbenennen

Über den Kontext-Menü-Punkt Anwendung kopieren in Wartung Anwendung, kann eine Anwendung dupliziert werden.

Eingabe-Felder

  • Von Anwendung

Die Anwendung, die umbenannt werden soll muss angegeben werden.
Durch Klick auf den Button wird die SQL-Abfrage DWAPP aufgerufen und alle Anwendungen angezeigt. Die gewünschte Anwendung kann ausgewählt und übernommen werden.

  • Nach Anwendung

Der neue Name der Anwendung muss angegeben werden.
Sofern eine Anwendung mit dem neuen Namen bereits existiert, wird ein Fehler ausgegeben. Um eine bereits vorhandene Anwendung ersetzten zu können, Ersetzen Ja/Nein angegeben werden.

  • Ersetzten Ja/Nein

Gibt an ob eine eventuell vorhandene Anwendung überschrieben werden darf.

Buttons

  • Speichern Beim Speichern wird die vorhandene Anwendung, sowie alle abhängigen Datensätze und anwendungsspezifischen IFS-Verzeichnisse und Dokumente.


Sofern die neue Anwendung bereits existiert und ersetzt werden darf, werden alle vorhandenen zur neuen Anwendung gehörenden Informationen (abhängige Datensätze und IFS-Verzeichnisse und -Dokumente) zunächst gelöscht.

  • Abbrechen Die Erfassung der Daten wird abgebrochen

Anmerkung: Die Anwendungen DIRWEB und IBM_I können nicht umbenannt werden.

Anwendungsmenü

Der Haupt-Menü-Punkt, unter dem alle zur Anwendung gehörenden Menü-Punkte bzw. Programm-Aufrufe angesiedelt werden sollten, wird bereits beim Erstellen der Anwendung automatisch erzeugt.
Anwendungsspezifische Unter-Menü-Verzeichnisse und Menü-Punkte für Programm-Aufrufe können über den Kontext-Menü-Punkt Menü in Wartung Anwendungen aufgelistet und bearbeitet werden.


Abbildung 71: Aufruf List-Anzeige Anwendungsmenü

List-Anzeige Anwendungsmenü

Der Aufruf der List-Anzeige Anwendungsmenü erfolgt über Kontext-Menü-Auswahl Menü in der List-Anzeige der Anwendungsdaten


Abbildung 72: List-Anzeige Anwendungsmenü

Spalten

  • Menü-Struktur

Zeigt die Menü-Struktur und die Position der Menü-Punkte innerhalb der Struktur an.
Anmerkung: Unter Release V5R4 werden nur die Menü-Punkte aufgelistet. Die Darstellung der Menü-Struktur (Rekursion in Verbindung mit Mehrsprachigkeit) ist unter Release V5R4 noch nicht möglich.

  • Übergeordneter Menü-Punkt

Folge-Nr. des übergeordneten Menü-Punkts innerhalb des Anwendungsmenüs.
Die Folgen-Nr. des aktuellen und des übergeordneten Menü-Punkts sind insbesondere unter Release V5R4 wichtig, da die Anzeige der Menü-Struktur noch nicht unterstützt wird.

  • Beschreibung des übergeordneten Menü-Punkts

Bezeichnung/Beschreibung des übergeordneten Menü-Punkts innerhalb des Anwendungsmenüs.

  • Folge-Nr. Folge-Nr. des aktuellen Menü-Punkts

 

  • Programm

Programm, das bei Auswahl des Menü-Punkts ausgeführt wird.
Die Angabe eines Programms ist nicht zwingend erforderlich.
Menü-Unterpunkte können sowohl unter Menü-Punkten mit als auch ohne Programm-Definition angesiedelt werden.

  • Export erlaubt

Werden (Test-)Programme in dem Menü hinterlegt, für die kein Export erlaubt ist, so werden diese Menü-Punkte beim Exportieren der Anwendung nicht mitgesichert. Folglich können solche Menü-Punkte auf anderen Systemen auch nicht installiert werden.

  • Benutzer-Klasse

Zur Ausführung berechtigte Benutzer-Klasse (Benutzer, Systembediener, Administrator oder Gruppen-Profil)

  • Session

Buttons

  • Erstellen Erfassen von neuen Menü-Punkten

Kontext-Menü

  • Ändern Detail-Informationen für den Menü-Punkt ändern, z.B. Text/Message-Id ändern, zum Export freigeben, an neue Position innerhalb des Menü-Baums der Anwendung verschieben etc.

 

  • Eigenschaften

Detail-Informationen für Menü-Punkt anzeigen

  • Untermenü-Punkt erstellen

Die Erfassungsmaske für Untermenü-Punkte wird geöffnet. Die Position des Menü-Punktes wird basierend auf der Position des Menü-Punktes auf dem der Kontext-Menü-Punkt ausgewählt wurde ermittelt und vordefiniert.

  • Menü-Punkt löschen

Menü-Punkt löschen
Wird ein Kontext-Menü-Punkt gelöscht so werden ebenfalls alle untergeordneten Menü-Punkte gelöscht.
Das Löschen von Kontext-Menü-Punkten muss über die folgende Meldung explizit bestätigt werden.


Abbildung 73: Löschen von Kontext-Menü-Punkten bestätigen
Anmerkung:Wird der Haupt-Menü-Punkt einer Anwendung ausgewählt, so werden nur die untergeordneten Menü-Punkte gelöscht. Der Haupt-Menü-Punkt, der auch automatisch angelegt wird, kann nicht manuell gelöscht werden.
Wird die komplette Anwendung gelöscht wird, wird auch der Haupt-Menü-Punkt entfernt.

Anwendungsmenü bearbeiten

Die Bearbeitung des Anwendungsmenüs, d.h. Erstellen, Ändern und Löschen von Anwendungsmenü-Punkten erfolgt durch Klicken auf entsprechende Buttons oder Kontext-Menü-Punkte in der List-Anzeige Anwendungen (6.1.1 List-Anzeige Anwendungen)

Anwendungsmenü-Punkt erstellen

Ein Anwendungsmenü-Punkt kann aus dem List-Programm Menü auf zwei Arten erfolgen:

  • Button Erfassen

  • Kontext-Menü-Auswahl Unter-Menü-Punkt erstellen

Erfolgt die Auswahl über den Button Erfassen, kann sowohl der übergeordnete Menü-Punkt als auch der Menü-Punkt, nachdem der neue Menü-Punkt eingeordnet werden soll ausgewählt werden.
Sofern die Auswahl über das Kontext-Menü erfolgt wird der übergeordnete Menü-Punkt aufgrund der Position des Auswahl-Punktes ermittelt und kann nicht geändert werden.
Das folgende Beispiel zeigt die Erfassungsmasken für beide Auswahl-Optionen.


Abbildung 74: Anwendungs-Menü-Punkt erstellen


Die Anwendung für die der Menü-Punkt angelegt werden soll wird ermittelt und im Header angezeigt.

Eingabe-Felder

  • In (Unter-)Menü

Die Position des neuen Menü-Punktes muss angegeben werden. Zunächst muss der Menü-Punkt, unterhalb dem der neue Menü-Punkt eingeordnet werden soll.
Die Auswahl des Kontext-Menü-Punktes kann über die folgende Combo-Box erfolgen, in der alle Kontext-Menü-Punkte der Anwendung aufgelistet sind.


Abbildung 75: Combo-Box Auswahl übergeordnete Menü-Punkte

  • Nach Auswahl

Sofern sich unterhalb des ausgewählten übergeordneten Menü-Punkt mehrere Menü-Punkte auf der gleichen Ebene befinden, muss angegeben werden nach welchem der gleichberechtigten Menü-Punkte der neue Menü-Punkt eingeordnet werden soll.
Die Auswahl erfolgt über eine Combo-Box analog der Auswahl des übergeordneten Menü-Punkts.

  • Beschreibung

Für den anzulegenden Menü-Punkt kann entweder eine Beschreibung oder eine Message-Id angegeben werden.

  • Message-Id für Text

Wird eine Message-Id angegeben, so wird der Text des Menü-Punktes über diese Message-Id aus der Message-File, in der Objekt-Bibliothek ermittelt.

  • Message-Id für Tipp

Zusätzlich kann eine Message-Id, über die ein Tipp-Text ermittelt wird angegeben werden.

  • Programm

Es können Unter-Menü-Punkte, die nur besseren Strukturierung der Menü-Punkte verwendet werden angelegt werden.
In diesem Fall wird Programm nicht ausgewählt.

  • Programm-Name

Sofern dem Menü-Punkt ein Programm zugeordnet werden soll, muss zunächst Programm ausgewählt und dann das gewünschte Programm angegeben werden.
Das ausgewählte Programm sollte sich in der Objekt-Bibliothek der Anwendung befinden.
Durch Klick auf den Button wird die SQL-Abfrage DWLISTPGM aufgerufen.
Achtung: Der erste Aufruf des Match-Codes/SQL-Abfrage kann etwas länger u.U. sogar ein paar Minuten dauern.

  • Berechtigung

Gibt die Berechtigungsgruppe an, die mit dem Menü-Punkt arbeiten können

  • Benutzer:Minimale Rechte

  • Systembediener:Kann alle Menü-Punkte, die mit der System-

Bediener-Berechtigung angelegt wurden.
Des Weiteren kann er alle mit der Benutzer-Berechtigung angelegten Menü-Punkte aufrufen

  • Administrator:Hat alle Rechte und kann alle Menü-Punkte aufrufen

  • Gruppen-MenüSofern das Gruppen-Menü, dem der Benutzer

Zugeordnet ist berechtigt ist, kann der Benutzer den Menü-Punkt aufrufen

  • Symbol

Zusätzlich zur Anzeige im Menü-Baum kann ein Icon ausgewählt werden.

  • Das Symbol sollte als .PNG-Datei vorliegen

  • Sie muss im IFS der IBM i im Verzeichnis /www/dirweb/htdocs/icons/dhtmlx/icons gespeichert sein.

  • Export erlaubt

Gibt an, ob der Menü-Punkt exportiert werden darf

Buttons

  • Speichern Beim Speichern werden die erfassten Informationen geprüft und gespeichert, dabei werden die einzelnen Menü-Punkte für die Anwendung resequenziert.

 

  • Abbrechen Die Erfassung der Daten wird abgebrochen



Anwendungsmenü-Punkt anzeigen/ändern

Über Kontext-Menü-Auswahl in List-Anzeige Anwendungsmenü (6.1.1 List-Anzeige Anwendungen) können die erfassten Anwendungsmenü-Punkte angezeigt (Eigenschaften) oder bearbeitet werden (Ändern)


Abbildung 76: Anzeigen/Ändern Anwendungsmenü-Punkt


Ein Anwendungsmenü-Punkt kann keiner anderen Anwendung zugeordnet werden, d.h. die Anwendung kann nicht geändert werden. Sofern ein Anwendungsmenü-Punkt einer anderen Anwendung zugeordnet werden muss, muss er in der alten Anwendung gelöscht und für die andere Anwendung neu erfasst werden.
Innerhalb der Anwendung können die Anwendungsmenü-Punkte neu angeordnet oder in andere Sub-Menüs verschoben werden.
Die übrigen Informationen, die erfasst werden konnten, können auch geändert werden.

Anwendungsmenü-Punkt löschen

Das Löschen eines Anwendungsmenü-Punktes erfolgt über Kontext-Menü-Auswahl in List-Anzeige Anwendungsmenü.
Beim Löschen eines Kontext-Menü-Punktes, werden alle untergeordneten Menü-Punkte ebenfalls gelöscht.
Wurde der Haupt-Menü-Punkt zum Löschen ausgewählt, werden untergeordneten Menü-Punkte gelöscht. Der Haupt-Menü-Punkt, der automatisch angelegt wird, wird nicht gelöscht. Das manuelle Löschen des Haupt-Menü-Punkts der Anwendung ist nicht möglich. Beim Löschen der Anwendung wird auch der Haupt-Menü-Punkt der Anwendung gelöscht.
Das Löschen muss explizit bestätigt oder abgebrochen werden.


Abbildung 77: Anwendungsmenü-Punkt löschen


Wurde das Löschen bestätigt wird der ausgewählte Menü-Punkt, sowie alle untergeordneten Menü-Punkte gelöscht.

Sprachen

Die Informationen für die Standard-Sprache (Sprache und Message-File) werden bereits beim Erstellen der Anwendung automatisch erzeugt.
Sofern nicht mit mehrsprachigen Anwendungen gearbeitet wird, ist keine weitere Bearbeitung erforderlich.
Für mehrsprachige Anwendungen können weitere Sprachen erfasst bzw. die entsprechenden Message-Files zugeordnet werden.Der Aufruf der List-Anzeige für Sprachen erfolgt über den Kontext-Menü-Punkt Sprachen in Wartung Anwendungen.Abbildung 78: Aufruf List-Anzeige Sprachen