<<

Inhaltsverzeichnis

Suchen

>>

 

Das erste Programm

 

Ebus-J-Programme bestehen aus Indexdateien, Masken, Reports und Makros.

 

Die Indexdateien dienen der Speicherung der Daten. Auch bei großen Datenmengen kann über frei definierbare Schlüssel sehr schnell auf alle Datensätze einer Indexdatei zugegriffen werden. In den Masken und Reports und in den Makros werden die Indexdateien verwendet. Deshalb müssen die Indexdateien eines Programms als erstes erfasst werden.

 

Danach werden die Masken und Reports des Programms erstellt. Masken bestehen im Wesentlichen aus Maskenfeldern (Controls), die die Erfassung und Anzeige von Daten ermöglichen. Bei jedem Maskenfeld kann ein Makro vorher und/oder Makro nachher festgelegt werden. Der Makro vorher wird ausgeführt, wenn das Feld angesprungen wird. Der Makro nachher wird nach der Dateneingabe ausgeführt. Ein Makro ist ein Programmteil, der in der Programmiersprache von Ebus-J geschrieben ist.

 

Mit Hilfe der Reports können komfortabel Drucklisten erzeugt werden.

 

Jeder Makro wird über einen Namen (Makroname) angesprochen. Auf den Masken und Reports werden die Namen der verwendeten Makros angegeben. Die Erfassung der Makros kann auf den Masken und Reports sofort (Tasten F8, F9, F10) oder später über den Menuepunkt Datei/Öffnen/Makro erfolgen.

 

Im Folgenden wird anhand eines kleinen Beispiels erklärt, wie ein Programm in Ebus-J erstellt wird.

 

Es soll ein Programm erzeugt werden, das Bilddateien anzeigt und die angezeigten Bilder in einer Indexdatei protokolliert.

 

Zuerst wird die Beschreibung der Indexdatei PROTOKOLL erfasst. Dazu wird der Menuepunkt Datei/Öffnen/Indexdatei (Alt/I) ausgewählt.

 

Es werden 4 Felder erfasst: USERNAME$, DATUM und UHRZEIT$ protokollieren, von wem und wann das Bild angezeigt wurde. In DATEINAME$ wird der Name der angezeigten Bilddatei  gespeichert.

 

 

 

Der Primärkey muss eindeutig sein, deshalb wird als Primärkey USERNAME$, DATUM und UHRZEIT$ festgelegt.

 

 

Wir definieren einen Sekundärkey, um alle Datensätze unabhängig von USERNAME$ nach Datum und Uhrzeit sortiert anzeigen zu können.

 

 

 

Als nächstes wird das Programm erfasst. Dazu wird der Menuepunkt Datei/Öffnen/Programm (Alt/P) ausgewählt.

 

Als Programmname wird PROG1 angegeben. Anschließend wird eine neue Maske erzeugt durch Klicken auf den Eintrag neue Maske:

 

Als Maskennummer wird 10 angegeben, als Maskenüberschrift wählen wir "Bild anzeigen", die restlichen Felder können leer bleiben.

 

 

Durch Drücken des Buttons "OK" gelangen wir in den Maskeneditor.

 

 

In der Iconleiste werden die Symbole der möglichen Maskenfelder angezeigt. Durch Drücken eines Icons wird die entsprechende Maskenfeldart ausgewählt. Durch Ziehen mit der Maus kann das Maskenfeld erzeugt werden.

 

Texte können auch durch das Tippen von Text erzeugt werden. An der Cursorposition   wird dabei automatisch ein Textfeld erzeugt. Die Cursorposition kann durch einen linken Mausklick oder durch Strg/<←>, Strg/<→>, Strg/<↑>, Strg/<↓>  verschoben werden.

 

Als erstes erzeugen wird ein Textfeld, indem wir den Text "Bilddatei" eintippen.

 

 

Hinter dem Text benötigen wir ein alphanumerisches Maskenfeld für die Eingabe des Dateinamens. Dazu klicken wird das Icon "abc" an und erzeugen dann das Feld durch Ziehen mit der Maus.

 

 

Hinter dem Eingabefeld erzeugen wir einen Button, über den der Dateidialog zur Auswahl eines Datei aufgerufen werden soll. Dazu klicken wir das 2. Icon an und erzeugen den Button wieder durch Ziehen mit der Maus.

 

 

Wir erzeugen zwei weitere numerische Maskenfelde (Icon "123"), die die Position (Zeile und Spalte) festlegen, an der das Bild angezeigt werden soll.

Dahinter wird ein weiterer Button erzeugt, der das Anzeigen des Bildes ausführt.

 

 

Jetzt müssen noch die Attribute der Maskenfelder geändert werden. Mit Hilfe der Tab-Taste <®|> wird das erste bzw. das nächste Feld markiert. Durch Drücken von <RETURN> oder durch einen Doppelklick auf das Maskenfeld werden die Attribute des Maskenfeldes angezeigt. Wird ändern zunächst das Feld "abc". Als Feldname ist DUMMY_ALPHAFIELD$ eingetragen. Wir ändern das in DATEINAME$. In den Makros, die wir später erfassen, enthält die Variable DATEINAME$ den Inhalt des Maskenfeldes. Außerdem ändern wird Anzahl Eingabezeichen auf 128, damit auch längere Dateinamen in dem Maskenfeld Platz haben.

 

 

Durch Drücken des Buttons "F12 = Speichern" werden die Attribute gespeichert. Es erscheint noch die Meldung, dass der Formatstring angepasst wird, da die Anzahl der Eingabezeichen geändert haben.

 

 

Bei dem ersten Button tragen wir als Text "Durchsuchen" ein.

 

 

Durch Drücken des Buttons "weitere Feldattribute" kann ein Standardbild für den Button ausgewählt werden.

 

 

Bei den beiden numerischen Feldern hinter Zeile und Spalte ersetzen wird den Feldnamen DUMMY_NUMFIELD durch ZEILE bzw. SPALTE und Anzahl Eingabezeichen setzen wir auf 2.

 

 

Bei dem zweiten Button tragen wir als Text "Bild laden" ein.

 

 

Die Maske sieht dann folgendermaßen aus:

 

 

Die Maske ist jetzt erfasst. Allerdings fehlt noch die Verarbeitung, wenn einer der beiden Buttons gedrückt wird.

 

Durch einen Doppelklick auf den Button "Durchsuchen" wird wieder die Attributmaske angezeigt. Bei Makro nachher tragen wir ein: PROG1.DURCHSUCHEN.

Der Makro PROG1.DURCHSUCHEN wird ausgeführt wenn der Button "Durchsuchen" gedrückt wird.

 

 

Den Makro PROG1.DURCHSUCHEN können wir sofort erfassen, indem wir die Taste F9 drücken. Es öffnet sich das Editorfenster, in dem der Makro erstellt werden kann.

 

 

Wir wollen den Dateidialog zur Auswahl einer Bilddatei aufrufen. Das erledigt der Befehl FILEDIALOG. Mit F4 können alle Befehle und Variablen der Programmiersprache von Ebus-J angezeigt werden. Durch Tippen der Anfangsbuchstaben wird in dem Auswahlfenster automatisch auf den entsprechenden Befehl positioniert.

 

 

Durch <RETURN> oder einen Mausklick wird der Befehl ausgewählt. Es erscheint ein Fenster, in dem die Parameter des Befehls angegeben werden können. Parameter in eckigen Klammern [ ] sind optional.

 

 

Überschrift legt die Überschrift des Dateidialogs fest.

Filter legt fest, welche Dateien ausgewählt werden können. Wir lassen nur gif-, png- und jpg-Dateien zu.

Bei Default-Verzeichnis, Default-Dateiname und Default-Erweiterung wird der Leerstring angegeben.

Mit Shift/F10 kann die vollständige Beschreibung des Befehls FILEDIALOG angezeigt werden.

Durch Drücken des Buttons "OK" wird der Befehl in das Editorfenster übernommen.

 

 

Nach der Beendigung des Dateidialogs enthält die Variable EBUS_DATA den Status und die Variable EBUS_DATA$ den ausgewählten Dateinamen.

Nur wenn EBUS_DATA = 1 ist, wurde ein Dateiname ausgewählt. In diesem Fall müssen wir unserer Maskenfeldvariablen DATEINAME$ den ausgewählten Dateinamen zuweisen und den neuen Inhalt des Maskenfeldes mit der Anweisung DISPLAY anzeigen.

 

 

Damit ist der Makro bereits erfasst und kann mit F12 gespeichert werden. Wir befinden uns wieder auf der Attributmaske des Buttons und speichern die Attribute ebenfalls mit F12.

 

Als nächstes erstellen wird den Makro zur Anzeige des Bildes. Dazu klicken wir doppelt auf den Button "Bild anzeigen". Bei Makro nachher tragen wir PROG1.BILD.ANZEIGEN ein und rufen mit F9 wieder den Editor auf.

 

Als erstes müssen wir prüfen, ob ein Dateiname angegeben wurde:

 

IF ISSPACE(DATEINAME$)

THEN ERRORMES = "Dateiname fehlt."

     GOTO #10.#DATEINAME$

ENDIF

 

Die Anweisung ERRORMES zeigt die Fehlermeldung in einem Fenster an. GOTO #10.#DATEINAME$ verlässt den Makro und springt zum Feld DATEINAME$.

 

Zum Anzeigen des Bildes verwenden wir die Funktion LOAD_PICTURE. Da Funktionen einen Ergebniswert liefert, dürfen sie nur auf der rechten Seite einer Zuweisung vorkommen. Wir schreiben deshalb im Editor

 

ERGEBNIS% =

 

und drücken dann F4 für die Anzeige der Befehle. Durch Eingabe der Anfangsbuchstaben LO wird automatisch auf LOAD_PICTURE positioniert. Wir wählen den Befehl mit <RETURN> aus und geben folgende Parameter an:

 

 

Bei Zeile und Spalte geben wir ZEILE und SPALTE an. Diese Variablen enthalten die Werte, die auf der Maske in den Feldern Zeile und Spalte eingetragen wurden.

Modus = 0 bedeutet, dass das Bild in der Originalgröße angezeigt wird. Die Parameter Höhe in Zeilen und Breite in Spalten haben dann keine Bedeutung.

Löschen = 1 bewirkt, dass ein eventuell vorher angezeigtes Bild zuerst gelöscht wird, bevor das neue Bild angezeigt wird.

Bei Bildname geben wird DATEINAME$ an. DATEINAME$ enthält den Bildnamen, der auf der Maske eingegeben wurde.

 

Wird drücken "OK" und befinden uns wieder im Editor. Jetzt müssen wir prüfen, ob LOAD_PICTURE einen Fehler gemeldet hat.

 

IF ERGEBNIS% <> 0

THEN ERRORMES = "Fehler " + STR$(ERGEBNIS%)

     QUIT

ENDIF

 

ERGEBNIS% ist <> 0, wenn ein Fehler aufgetreten ist. In diesem Fall wird der Fehler gemeldet und der Makro mit QUIT verlassen.

 

Schließlich soll das erfolgreiche Anzeigen des Bildes in der Indexdatei PROTOKOLL protokolliert werden.

 

PROTOKOLL.USERNAME$ = GET_USERNAME$

PROTOKOLL.DATUM = NUMDATE(DATEG8$)

PROTOKOLL.UHRZEIT$ = TIME$

PROTOKOLL.DATEINAME$ = DATEINAME$

 

WRITE PROTOKOLL ON ERROR ERRORMES = "Fehler" + STR$(OK) + STR$(OK2) + ": " + ERRORTEXT$

                END

 

GET_USERNAME$ liefert den Usernamen.

NUMDATE wandelt das alphanumerische Datum DATEG8$ in einen numerischen Wert um.

TIME$ enthält die aktuelle Uhrzeit im Format HH:MM:SS.

WRITE schreibt den Datensatz in die Indexdatei.

 

Die Indexdateifelder PROTOKOLL.USERNAME$,... können mit F2 im Editor eingefügt werden.

 

Jedesmal wenn im Editor der Name einer Funktion (z.B. NUMDATE) oder einer Anweisung eingegeben wird, wird die Syntaxautomatik gestartet. Es erscheint dann wieder das Fenster zur Eingabe der Parameter. Die Syntaxautomatik kann ausgeschaltet werden mit F12 im Menuepunkt Datei/Öffnen/Makro.

 

Der Makro ist nun vollständig erfasst:

 

 

Mit F12 wird der Makro gespeichert und durch erneutes F12 werden auch die Attribute des Buttons gespeichert.

 

Unter dem Button "Bild laden" fügen wir noch einen weiteren Button ein, der die Protokolldatei anzeigen soll. Als Makro nachher tragen wir bei den Attributen PROG1.PROTOKOLL.DATEI ein und starten mit F9 wieder den Editor.

 

Die Funktion SELECT zeigt die Datensätze einer Indexdatei an.

Vorher muss mit der Anweisung WINDOWPOS noch angegeben werden, wo das SELECT-Fenster positioniert werden soll.

WINDOWPOS(0,0) bewirkt, dass das SELECT-Fenster zentriert im Mainwindow angezeigt wird.

 

 

Der vollständige Makro sieht dann folgendermaßen aus:

 

 

Die Anweisung INITIALIZE bewirkt, dass alle Felder der Indexdatei mit 0 bzw. Blanks initialisiert werden. Dadurch beginnt die Anzeige der Datensätze am Anfang der Indexdatei.

 

Durch Drücken des Buttons "Speichern" wird die gesamte Maske gespeichert:

 

 

Das Programm kann jetzt generiert und gestartet werden. Dazu wird der Menuepunkt Generator (Alt/G) aufgerufen.

 

 

Wenn die Checkboxen Compilierung nach Generierung starten und Programm nach Compilierung starten gesetzt sind, wird nach der Generierung automatisch die Compilierung und danach das fertige Programm gestartet. Voraussetzung ist, dass das JDK 1.5.0 oder höher ordnungsgemäß installiert ist.

 

Der Generierungslauf wird gestartet mit F8 oder durch <RETURN>.