Programmaktionen mit Skripten steuern

Programme ausführen

Sie können mit Hilfe des Skript-Befehls ***STARTE über ein Skript ein externes Programm starten. Hierfür geben Sie hinter ***STARTE zuerst den vollständigen Programmnamen und darauf, getrennt durch ein Leerzeichen, die Parameter an. Wenn der Programmname Leerzeichen enthält, so müssen Sie den gesamten Programmnamen in Gänsefüßchen setzen:


***starte "[Programmverz]\datev\damo32.exe" [Programmverz]\datev\damo32.ini

Dasselbe gilt für einen einzelnen Parameter.

Wenn Sie ein Kommandozeilenprogramm ausführen möchten, dann verwenden Sie ***STARTEK statt ***STARTE. (Wirklich entscheidend ist der Unterschied aber nur, wenn Sie unter OS/2 ein Win32-Kommandozeilenprogramm ausführen möchten.)

Sie können den Programmnamen entweder vollständig vom Laufwerksbuchstaben angeben oder vom TEXTBUCH-Firmenverzeichnis, also vom Verzeichnis aus, in dem Ihr Kontenplan und die Jahres-Verzeichnisse stehen. Sinnvoll ist die Verwendung der Variablen [Programmverz] und [Firmenverz], um jede Verwechslung auszuschließen.

Werden Batchdateien (Dateiendung CMD) ausgeführt, so wird automatisch der Kommandozeilenprozessor aufgerufen.

Editoren starten

Mit drei verschiedenen Befehlen lassen sich skriptgesteuert TEXTBUCH Editorfenster aufrufen:


***EINGABEEDITOR Kontplan.txt ***EINGABEEDITOR [JR]\AB.TXT ***AUSGABEEDITOR Allekont.txt ***ANSIEDITOR [AUSGABEVERZ]\datevformat\info.txt

"***EingabeEditor" wird verwendet, wenn Eingabe-Textdateien wie der Kontenplan oder die Anfangsbestände aufgerufen werden sollen. Der Dateiname wird ausgehend vom Firmenverzeichnis angegeben, wobei die allgemeine Variable [JR] für das zweistellige angemeldete Buchungsjahr steht. Entsprechend der Dateinamen ruft TEXTBUCH den Editor in den entsprechenden Modi für Kontenplan, Buchungssätze usw. auf.

"***AusgabeEditor" geht bzgl. des Dateinamens vom Ausgabeverzeichnis aus und startet den Editor im Ausgabedatei-Modus ohne farbliche Hervorhebungen.

"***AusgabeEditor" ohne Dateinamen dahinter beendet das Schreiben der aktuell im Skript zu schreibenden Datei und öffnet die soeben geschriebene Datei im Editor. Um das Skript fortzusetzen, müssen Sie zuerst mit ***DATEI wieder eine neue Datei zum Schreiben anmelden.

"***AnsiEditor" entspricht "***AusgabeEditor", jedoch liest der Editor grundsätzlich Dateien im ANSI (Windows-) Zeichensatz. Dies ist für die OS/2-Version von TEXTBUCH relevant, wenn eine von einem Windows-Programm erzeugte Textdatei im Editor angezeigt werden soll.

Alternativ zum textbuch-internen Editor können Sie auch Dateien und Verzeichnisse über das Betriebssytem öffnen lassen:


***öffne Allekont.txt

führt die Standard-Öffnen Verknüpfung des Betriebssystems aus und startet den im Betriebssystem mit der Dateiendung *.TXT verknüpften Editor.

Dieser Befehl ist auch in der Lage, Verzeichnisse als Ordner der Betriebssystem-Oberfläche zu öffnen:


***öffne [AUSGABEVERZ]\datevformat

Öffnet den Ordner bzw. das Verzeichnis Datevexport, das sich im Ausgabeverzeichnis befindet.

Ausgabedateien löschen


***lösche Allekont.txt

löscht die Datei Allekont.txt. Dieser Befehl bezieht sich auf das Ausgabeverzeichnis. Sie können aber auch eine beliebige Datei löschen, indem Sie den vollen Dateinamen, beginnend mit dem Laufwerksbuchstaben, angeben. Jokerzeichen werden nicht unterstützt. Wenn die Datei erfolgreich gelöscht wurde, erscheint ein entsprechender Hinweis im blauen Meldungsfenster, während ein Fehlschlag (d.h. in der Regel, dass die Datei gar nicht vorhanden ist) gar nicht angezeigt wird, auch nicht als Fehlermeldung.

Abwarten

Mit ***WARTE gefolgt von einer Dezimalzahl pausiert die Skript-Verarbeitung z.B. für 1,5 Sekunden:


***WARTE 1,5

Vor dem Aufrufen von Editoren ist der Befehl "***WARTE" nicht erforderlich, weil sich die Ausgabedatei-Editoren ohnehin von selbst aktualisieren. Die Editoren laufen nicht im Verarbeitungsthread, sondern im TEXTBUCH Hauptthread.

Sonstige nützliche Kommandos im Rahmen von Programmaktionen

Wenn Sie externe Dateien ausführen lassen und nicht wie sonst bei Skripten üblich Ausgabe-Textdateien neu erzeugen, so ist es sinnvoll, die Standard-Datenausgabe in das blaue TEXTBUCH Meldungsfenster umzuleiten:


***Datei BLAU Hallo hallo hallo!

gibt "Hallo hallo hallo!" im Textbuch Meldungsfenster mit der blauen Schrift aus, statt den Text in eine Ausgabedatei zu schreiben. ***Datei ROT scheibt den Text in das Fehlerfenster mit der roten Schrift.

Sie können bei der Angabe von Dateinamen die folgenden allgemeinen Variablen nutzen:


[FIRMENVERZ] Firmen-Verzeichnis (= Ort, wo sich KONTPLAN.TXT befindet) [PROGRAMMVERZ] Programmverzeichnis (= Ort, wo sich das Textbuch Programm befindet) [AUSGABEVERZ] Verzeichnis, in das die Ausgabedateien geschrieben werden

gibt jeweils den vollen Verzeichnisnamen an, ohne Backslash am Ende.