Programme (Menuepunkt
Datei/Öffnen/Programm)
Hyperlinks:
Eine
Programmbeschreibung enthält die Daten zur Generierung eines Programms.
Sie wird im aktuellen Arbeitsverzeichnis
in der Datei <Programmname>.pgj gespeichert.
Allgemeiner Aufbau
eines Ebus-Programms
Im
Ebus-Programm können beim Programmstart zwei Initialisierungsmakros ausgeführt werden. Der erste wird
vor dem Öffnen der Indexdateien und der zweite nach dem Öffnen der Indexdateien
ausgeführt. Danach erscheint normalerweise die erste Maske auf dem Bildschirm.
Wird
ein Feld einer Maske angesprungen, so wird – falls vorhanden – zuerst der
zugehörige Makro vorher ausgeführt. Dann erfolgt die Dateneingabe durch den
Anwender. Nach der Eingabe wird – falls vorhanden – der Makro nachher ausgeführt. Danach wird gemäß der definierten
Feldreihenfolge das nächste Maskenfeld angesprungen.
Ein
Maskenfeld kann mit einer Indexdatei-Variablen oder einer Hilfsvariablen verknüpft werden. Dadurch werden Bildschirmeingaben
unmittelbar den verknüpften Variablen zugewiesen.
Für
die Programmsteuerung stehen in der Programmiersprache Befehle zur
Verfügung, mit denen Unter- oder Folgeprogramme aufgerufen, beliebige Masken
und Maskenfelder angesprungen oder das laufende Programm beendet werden kann.
Erstellung eines Programms im Ebus-J
Zuerst
müssen die Indexdateibeschreibungen für die im Programm verwendeten
Indexdateien erfasst werden (siehe Indexdateien).
Danach
werden die Masken und Reports des Programms erstellt.
Die
im Programm aufgerufenen Makros werden mit dem Makroeditor erfasst.
Im
Menuepunkt Generator wird aus der Programmbeschreibung der Java-Quellcode erzeugt und
zu einem ablauffähigen Programm kompiliert.
Das
ausführbare Programm hat den Namen <Programmname>.jar und kann über die
Kommandoprozedur run_<Programmname>.bat (Windows) bzw. run_<Programmname>.sh
(Linux/Unix) gestartet werden.
Das
erzeugte Programm ist vom Ebus-J vollkommen unabhängig.

Programmname: Der Programmname darf nur
Buchstaben, Ziffern und den Unterstrich _ enthalten. Existiert das Programm bereits,
so wird nach der Eingabe des Programmnamens sofort zur Listbox Masken
gesprungen. Dort kann durch RETURN, einen Doppelklick oder durch Drücken des
Buttons 'Maske bearbeiten' sofort der Maskeneditor aufgerufen
werden.
Folgende
Funktionstasten (Icons) stehen zur Verfügung:
F2: Auswahl Programme: Es kann
aus allen vorhandenen Programmen im aktuellen Arbeitsverzeichnis ausgewählt
werden.
F3: Blättern vorwärts: nächstes
Programm
F4: Blättern rückwärts:
vorheriges Programm
F5: Löschen Programm: Das im
Eingabefeld Programmname angegebene Programm wird gelöscht.
F7: Auswahl Programme
(Historie): Es kann aus den zuletzt benutzten Programmen ein Programm
ausgewählt werden.
F8: Kopieren Programm: Es können einzelne Masken
oder Reports oder ein gesamtes Programm kopiert werden.
F9: Drucken Programm: Es können einzelne Masken
oder Reports oder ein gesamtes Programm gedruckt werden.
Kurzbeschreibung:
Die
Kurzbeschreibung wird in den Dialogen zur Auswahl eines Programms hinter dem
Programmnamen angezeigt.
ausführliche
Beschreibung: Die ausführliche Beschreibung hat nur informatorischen Charakter, sie
hat keinen Einfluss auf das Programm.
Makro
vor Index-Open: Dieser Makro ist der erste Makro, der nach dem Start des Programms
ausgeführt wird. Die im Programm verwendeten Indexdateien werden erst nach der
Ausführung dieses Makros geöffnet. In diesem Makro können die Pfade (Anweisung PATH), der Openmodus (Anweisung OPENMODE) und die Namen der Indexdateien
(Anweisung NEWNAME) gesetzt bzw. geändert
werden.
Makro
nach Index-Open: Dieser Makro wird nach dem Öffnen der im Programm verwendeten
Indexdateien ausgeführt. Wenn in diesem Makro kein Sprung zu einer Maske
erfolgt (Anweisung GOTO #), so wird nach der
Ausführung dieses Makros die erste Maske des Programms (das ist die Maske mit
der niedrigsten Nummer) angesprungen.
Masken:
Wird
eine neue Maske angelegt, so müssen zuerst die
Maskeneigenschaften und danach das Maskenlayout erfasst werden.
Wird
eine existierende Maske angeklickt oder mit RETURN ausgewählt, so wird der
Editor zum Bearbeiten des Maskenlayouts aufgerufen.
Button
'Maskeneigenschaften': Der Dialog zum Erfassen der Maskeneigenschaften
wird gestartet.
Button
'Maskenlayout bearbeiten: Der Editor zum Bearbeiten des Maskenlayouts wird gestartet.
Button
'Maske löschen: Die aktuell ausgewählte Maske wird nach einer Sicherheitsabfrage
gelöscht.
Reports:
Durch
Doppelklick auf einen Eintrag in der Listbox oder durch Drücken des Buttons 'Report
bearbeiten' wird der Editor zum Bearbeiten des ausgewählten Reports
gestartet. Durch Auswahl des Eintrags neuer Report kann ein neuer Report
erfasst werden.
Button
'Reporteigenschaften': Der Dialog zum Erfassen der Reporteigenschaften
wird gestartet.
Button
'Reportlayout bearbeiten: Der Editor zum Bearbeiten des Reportlayouts wird gestartet.
Button
'Report löschen: Der aktuelle ausgewählte Report wird nach einer Sicherheitsabfrage
gelöscht.
Button
'Prüfen':
Alle Masken und Reports des Programms werden überprüft. Fehlerhafte oder
fehlende Feldattribute werden gemeldet und können sofort korrigiert werden.
Button
'Speichern': Die Daten werden gespeichert und es wird zum Feld Programmname
zurückgesprungen.
Button
'Abbrechen': Es wird zum Feld Programmname zurückgesprungen. Wurden
Daten geändert, so erfolgt eine Abfrage, ob die Änderungen gespeichert werden
sollen.