Toolmaker Produkt-Dokumentation
Anwendungen
Inhaltsübersicht
Für die Anwendungen unter RPGWX sind Systemeinstellungen erforderlich. Diese sind nachfolgend beschrieben.
Anwendung Kontextmenü
Zur Administration der Anwendungen gibt es folgendes Kontextmenü:
0286 – Anwendung Kontextmenü
Anwendung erstellen
Nachfolgend wird beschrieben, mit welchen Merkmalen eine Anwendung zu erstellen ist.
0295 – Anwendung Kontextmenü
Anwendung
Name der Anwendung, die erstellt werden soll (max. 10 Zeichen).
Folge-Nr.
Eingabe einer Folgenummer.
Beschreibung
Eingabe einer Beschreibung für die zu erstellende Anwendung (max. 50 Zeichen).
Message-ID für Text
Eingabe der Message-ID für den Text.
Aktiviert
Bei Aktivierung ist der Eintrag aktiv und kann verwendet werden.
Nachrichten Datei
Name der Nachrichtendatei, die verwendet werden soll.
Bibliothek
Name der Bibliothek, in der sich die Nachrichtendatei befindet..
Daten-Bibliothek
Name der Bibliothek, in der sich die Datendatei befindet.
HTML Vorlagen
Eintrag des IFS-Pfades, in dem sich die HTML Vorlagen befinden.
Pfad für Symbole
Eintrag des IFS-Pfades, in dem sich die Symbole befinden.
http-Pfad-Erweiterung
Eintrag der http Pfad Erweiterung. Erfolgt hier ein Eintrag, so kann dieser bei der Pfadeintragung unterlassen werden.
Menü
Hier wird der Menübaum für eine Anwendung definiert.
0296 - Beispiel einer Menübaumdefinition:
Menü erstellen
Ein Menü ist mit nachstehenden Parametern zu definieren.
0297 – RPGWX Menü erstellen
Anwendung
Name der Anwendung, für die die Menüdefinition definiert werden soll.
Folge-Nr.
Eingabe einer Folgenummer im Menü. Mit dieser wird die Reihenfolge der Menüpunkte festgelegt.
Symbol
Hier kann ein Symbol für die Darstellung des Menüpunktes ausgewählt werden.
0298 – RPGWX Menü erstellen – Darstellung Menüpunkt
Beschreibung
Eingabe eines beschreibenden Textes für den Menüpunkt. Maximale Länge: 50 Zeichen.
Message-ID für Text
Anstatt der Beschreibung bzw. zur Unterstützung der Mehrsprachigkeit kann eine gültige Message-ID aus der Messsagefile DIRWEB (Bibliothek DIRWEB) eingetragen werden. Werden sowohl Beschreibung als auch Message-ID angegeben, hat die Message-ID Priorität.
Programm
Bei Aktivierung wird gekennzeichnet, dass es sich beim nächsten Parameter um ein Programm handelt, das zur Laufzeit ausgeführt wird. Ist das Feld inaktiv, so wird ein Menüpunkt angelegt.
Programm
Eingabe des auszuführenden Programmes für diesen Menüpunkt.
Session hinzufügen
Bei Aktivierung ist der Menüpunkt im Menü sichtbar.
Security Level
Hier kann der Security Level (Sicherheitsstufe der IBM i) für den Menüpunkt angegeben werden.
Gültige Werte sind:
- Benutzer
- Systembediener
- Administrator
- Gruppenprofil
Message-ID für Tipp
Eingabe einer gültigen Message-ID des Tooltipptextes.
Sprachen
Hier werden die unterstützten Sprachen definiert.
Programme
Hier werden die benötigten CGI-Programme hinterlegt.
Pfade
Hier werden die benötigten Pfade festgelegt.
Parameter
Hier werden die benötigten Parameter, die für die Comboboxen bzw. Radiobuttons benötigt werden, definiert. Nachfolgend eine Beispielnutzung bei Security Level:
0299 – Menü – Beispielnutzung Parameter
0300 - Menü - Parameterdefinition für entsprechenden Parameter
Abfragen
Hier werden die SQL Abfragen festgelegt, die für die Feldauswahl benötigt werden.
0302 – SQL Abfragen verwalten
Das folgende Beispiel zeigt wie die SQL-Abfrage APPPGM verwendet wird.
0301 - SQL Abfragen Verwendung
Export einer Anwendung
Um eine RPGWX-App auf ein anderes System zu transportieren muss sie zunächst exportiert werden. Dabei erzeugt RPGWX in der Objektbibliothek der Anwendung eine Datei mit dem Namen WXEXPIMP ("Transfer-Tabelle"). Diese Datei dient auf dem Zielsystem zum Import der Anwendung. Sie enthält alle Definitionen der Anwendung
- Menüs
- Parameterdefinitionen
- Bibliothekslisten-Definition
- IFS-Dateien
- SQL-Abfragen
Sie dient dem Import der Anwendung auf dem Zielsystem.
Export Version: $QSTBHA - Bitte ergänzen!
Transfer-Tabelle ersetzen: Wird angezeigt, wenn in der Objektbibliothek bereits eine Datei mit dem Namen WXEXPIMP existiert.
- aktiv: die bestehende Transfer-Tabelle WXEXPIMP wird durch eine neue Version ersetzt
- nicht aktiv: die WXEXPIMP wird nicht ersetzt.
- Wenn "Alle Bibl. aus Bibl.Listen sichern" aktiv ist, dann werden diese Bibliotheken in eigene SAVF gesichert.
- Wenn auch das nicht der Fall ist, dann passiert beim Export nichts $QSTBHA - stimmt das?
Ziel-Release: wählen Sie die IBM i - Version aus, unter der die Objekte rückspeicherbar sein sollen.
Alle Bibl. aus Bibl.Listen sichern: die Bibliotheken, die in der Bibliotheksliste angegeben sind, werden auch gesichert. Die Sicherung erfolgt in eigene SAVF in der Objektbibliothek.
- Nicht gesichert werden dabei: QGPL, QTEMP, WOPIX, DIRWEB
- Wenn es eine separate Bibliothek mit Quellen gibt, dann wird diese nur gesichert, wenn sie Teil der Bibliotheksliste ist.
Nach dem Export kann die Objektbibliothek in eine Sicherungsdatei (SAVF) gesichert und auf das Zielsystem übertragen werden.
- Wenn beim Export "Alle Bibl. aus Bibl.Listen sichern" aktiviert war, dann wurden in der Objektbibliothek der Anwendung nicht nur eine WXEXPIMP erstellt, sondern zusätzlich noch eine SAVF pro Bibliothek mit deren Inhalt. Diese werden durch das Sichern und Übertragen der Objektbibliothek automatisch mit übertragen
Import einer Anwendung
Um eine exportierte Anwendung auf einem System verwenden zu können, muss sie import wierden. Hierzu gehen Sie wie folgt vor:
- Zurückspeichern der Objektbibliothek aus der Sicherungsdatei
- Wenn beim Export alle Bibliotheken der Bibliotheksliste gesichert wurden
- dann diese aus ihren jeweiligen SAVF in der Objektbibliothek zurückspeichen
- RPGWX im Browser aufrufen und im Menü RPGWX den Punkt aufrufen: RPGWX-Anwendungen importieren
Es werden alle Anwendungen aufgelistet, für die eine WXEXPIMP gefunden wurde (im gesamten System).
4. Rechtsklick und Import auf die zu importierende Anwendung
5. Die Berechtigungen für die importierte Anwendung definieren.