Sie verwenden eine veraltete Dokumentation Zur aktuellen Version wechseln

# Stammdaten formeln makroeditor makroaufbau

Makroeditor - Aufbau

zurück Übersicht Makroverwaltung , Makroeditor Quelltext

Makros sind Texte im ASCII-Format und können mit einem einfachen Texteditor bearbeitet werden. Ein Makro kann mehrere Funktionen enthalten. Diese Funktionen können von außerhalb des Makros aufgerufen werden, sowie von Funktionen innerhalb des Makros.e

Richtlinien:

- Jede Funktion beginnt mit [Funktionsname]. Es dürfen keine weiteren Zeichen vor [ und nach ] in dieser Zeile stehen. Der Funktionsname darf Leerzeichen enthalten. (Bsp:[Funktion 1]) Eine Funktion endet beim Beginn der nächsten bzw. mit dem Ende des Textes.Jede Zeile kann höchstens einen Befehl aufnehmen.Eine Anweisung kann beliebig viele Fortsetzungszeilen haben. Die Fortsetzungszeilen müssen unmittelbar auf die fortzusetzende Zeile folgen. Das erste lesbare Zeichen einer F-Zeile muss ein Doppelpunkt sein, Blanks und Tabs können vor dem Doppelpunkt stehen. Der Interpreter fügt dann diese Zeile ab dem Zeichen, das dem Doppelpunkt folgt, mit einem Zeilenumbruch an die vorhergehende Zeile an.Auf diese Weise können große Anweisungen mehrzeilig erfasst werden, bzw. können Textkonstanten auch mit Zeilenumbrüchen erfasst werden.Sprungmarken müssen am Zeilenanfang stehen und sind durch Doppelpunkt abzuschließen. Einer Sprungmarke kann eine Anweisung folgen. Hinweise:

- Sal- oder Vis-Funktionen, die 0 als Rückgabewert liefern, sollten immer zusammen mit einer Set- oder einer Bedingung-Anweisung verwendet werden, da sonst im Falle 0 als Rückgabewert die Fehlerbehandlung ausgelöst wird. Sonderfunktion Definitionen Die Funktion [Definitionen] ist nicht aufrufbar und hat eine besondere Bedeutung. Es handelt sich dabei um eine Funktion, mit der Ersetzungszeichenfolgen für den Makroquelltext hinterlegt werden können. Man könnte es auch als Preprozessor-Anweisungen verstehen. Die Syntax lautet: Ersetzungs-ZF: EchterName

Nach dem Laden der Makrodatei in den HS werden die Ersetzungen laut den Definitionen in einem Pass durchgeführt.

Damit kann man kryptische Variablenamen oder auch Ausdrücke definieren, um Sie in Funktionen zu verwenden und den Makro dadurch leserlicher zu gestalten.

Bsp. 1:Intern wird $Meldung durch SalMessageBox ersetzt.

[Funktion 1]

$Meldung("Hallo Welt", "", 0)

[Definitionen]

$Meldung:SalMessageBox

Bsp. 2:Intern wird $Sql-Ok durch (gnSqlError = 0) und $Meldung durch SalMessageBox ersetzt.

[Funktion 1]

Bedingung( $Sql-Ok "$Meldung(' Sql-Anweisung war in Ordnung', '', 0)",

:"$Meldung('Sql-Anweisung ging schief', '', 0) ")

[Definitionen]

$Meldung:SalMessageBox

$Sql-Ok:(gnSqlError = 0)

Wichtig: Es ist darauf zu achten, dass eine Ersetzungszeichenfolge nicht in einer anderen Ersetzungszeichenfolge vorkommt. Es könnten sonst fehlerhafte Ersetzungen auftreten.

Bsp.:

$Sql:"Select count(*) from dual;"

$Sql-Ok:(gnSqlError = 0)

In diesem Falle würden alle $Sql und ebenfalls alle $Sql-Ok – Zeichenfolgen durch "Select count(*) from dual;" ersetzt.

Am Besten ist die Syntax $Name$ geeignet. Bei dieser Notation sollte es kaum zu Ersetzungsfehlern kommen.

Die Dollar-Zeichen sind nicht erforderlich. Sie können auch weggelassen werden. Es ist dann allerdings darauf zu achten, dass die richtigen Zeichenfolgen im Quelltext ersetzt werden.

Variable

Es ist möglich in den Definitionen auch frei verwendbare Variable zu definieren. Dazu sind im Makro “Definitionen” die Marken DefNumber, DefString und DefDate zu verwenden. Diese Marken werden vom Makrointerpreter erkannt und gesondert behandelt.

Bsp.:

[Definitionen]

DefNumber:$Zahl1, $Zahl2

[Funktion 1]

Set $Zahl1 = $Zahl2 * 2

Variablennamen müssen immer mit einem $-Zeichen beginnen, sonst wird eine Fehlermeldung generiert.

Befehle

Im folgenden sind die gebräuchlichsten Befehle beschrieben.

AusführenMakro( Funktionsname)Startet die Funktion mit dem übergebenen Namen. Der Parameter kann eine String-Variable oder eine String-Konstante sein. Damit kann man auch Unterfunktionen aufrufen. Die Verschachtelungstiefe ist nicht beschränkt.

Funktionsname | String
--- | ---

Bedingung (Bedingung, True-Part, False-Part)Mit diesem Befehl ist die IF – Anweisung implementiert.

Bedingung | Boolean | beliebiger boolscher Ausdruck
--- | --- | ---
True-Part | String | ein beliebiger Befehl
False-Part | String | ein beliebiger Befehl

Bsp: Bedingung( sHHJahr = “2000”, “GeheZu( ‚Marke1‘)”, “AusführenMakro(‚Fehler‘)”)

BeiFehler (Marke)De- bzw. aktiviert die Fehlerbehandlung in der akt. Funktion. Falls ein Fehler in der Makroabarbeitung auftritt, verzweigt der Interpreter zu dieser Marke. Eine leere Marke (Parameter = “”) deaktiviert die Fehlerbehandlung.

Marke | String | Sprungmarke in aktueller Funktion
--- | --- | ---

FehlerAuslösen (Text)Zum expliziten Auslösen der Fehlerbehandlungsroutine in einer Funktion. Dieser Befehl setzt die interne Fehlertextvariable auf den Parameter Text und liefert FALSE als Ergebnis. Der Fehlertext wird bei jedem Aufruf des Befehls gesetzt.

Ein Fehler wird nicht ausgelöst, wenn der Befehl FehlerAuslösen (Text) in einer Set-Anweisung oder in der Bedingung beim Befehl Bedingung (...) verwendet wird.

Text | String | Fehlertext, siehe fnLastMakroError
--- | --- | ---

Eingabe (Titel, Prompt, Default)Mit diesem Befehl können Benutzereingaben mit Hilfe einer vordefinierten Dialogbox realisiert werden. Die Eingaben sind auf Zeichenfolgen beschränkt.

Titel | String | Fenstertitel der Dialogbox
--- | --- | ---
Prompt | String | Text vor dem Eingabefeld
Default | String | Standardwert des Eingabefeldes
Rückgabe | String | Eingegebener Text. Wenn leer, wurde eine leere ZF eingegeben
|  | oder Abbruch gedrückt.

EndeMakro () Beendet die aktuelle Funktion sofort und kehrt zur rufenden Funktion zurück.

fnGetD (Variable, Wert)Ermittelt den Inhalt einer Date/Time-Variablen, die in der Funktion Definitionen angelegt wurde (DefDate)

Variable | String | Name der Variablen im Makro (Bsp.: $Datum_Soll)
--- | --- | ---
Wert | Receive Date | Programmvariable, die den Wert aufnimmt.

fnGetN( Variable, Wert)Ermittelt den Inhalt einer Number-Variablen, die in der Funktion Definitionen angelegt wurde (DefNumber)

Variable | String | Name der Variablen im Makro (Bsp.: $SummeGesamt)
--- | --- | ---
Wert | Receive Number | Programmvariable, die den Wert aufnimmt.

fnGetS( Variable, Wert)Ermittelt den Inhalt einer String-Variablen, die in der Funktion Definitionen angelegt wurde (DefString)

Variable | String | Name der Variablen im Makro (Bsp.: $Buchungstext)
--- | --- | ---
Wert | Receive String | Programmvariable, die den Wert aufnimmt.

fnSetD (Variable, Wert)Setzt den Inhalt einer Date/Time-Variablen, die in der Funktion Definitionen angelegt wurde (DefDate)

Variable | String | Name der Variablen im Makro (Bsp.: $Datum_Soll)
--- | --- | ---
Wert | Date | Wert der gesetzt werden soll.

fnSetN (Variable, Wert)Setzt den Inhalt einer Number-Variablen, die in der Funktion Definitionen angelegt wurde (DefNumber)

Variable | String | Name der Variablen im Makro (Bsp.: $SummeGesamt)
--- | --- | ---
Wert | Number | Wert der gesetzt werden soll.

fnSetS (Variable, Wert)Setzt den Inhalt einer String-Variablen, die im Makro Definitionen angelegt wurde (DefString)

Variable | String | Name der Variablen im Makro (Bsp.: $Buchungstext)
--- | --- | ---
Wert | String | Wert der gesetzt werden soll.

fnLastMakroError (Text)Liefert bzw. setzt den Inhalt der Variable für die letzte Fehlermeldung.

Text | String | Wenn leer, wird die letzte Fehlermeldung zurück geliefert.
--- | --- | ---
|  | Wenn nicht leer, wird die letzte Fehlermeldung gesetzt.
Rückgabe | String | Nur wenn Parameter Text leer ist.

fnStopMakro() Stoppt die Makrobearbeitung und kehrt zum allerersten Aufruf von AusführenMakro zurück, egal in welcher Ebene fnStopMakro() gerufen wurde. Dieser Befehl kann von anwendungsspezifischen Funktionen verwendet werden, um z.B. bei einem schweren Fehler die Makros abzubrechen.

Fortsetzen () Wird in der Fehlerbehandlungsroutine der Funktion verwendet, um bei der Anweisung fortzusetzen, die der fehlerauslösenden Anweisung folgt.

FortsetzenBei (Marke)Wird in der Fehlerbehandlungsroutine der Funktion verwendet, um bei einer definierten Anweisung fortzusetzen.

Marke | String | Marke im Makro
--- | --- | ---

GeheZu (Marke)Einfacher Sprungbefehl, um zu einer bestimmten Marke in der akt. Funktion zu verzweigen.

Marke | String | Marke in Funktion
--- | --- | ---

Wiederholen ()

Wird in der Fehlerbehandlungsroutine der Funktion verwendet, um bei der Anweisung fortzusetzen, die den Fehler ausgelöst hat.

Fehlerbehandlung

Tritt während des Ablaufs einer Funktion ein Fehler auf, verzweigt der Makrointerpreter zur Fehlerbehandlungsroutine in der akt. Funktion. Ist keine Fehlerbehandlung in der akt. Funktion aktiv, durchsucht der Interpreter alle rufenden Funktionen nach Fehlerbehandlungsroutinen und verzweigt dann zur ersten Routine, die er findet. Ist überhaupt keine Fehlerbehandlung implementiert, wird die Makroabarbeitung sofort abgebrochen und zum allerersten Aufruf von “AusführenMakro” zurückgekehrt.

Bsp.

Funktion 1 (ohne Fehlerbeh.) |  |  |
--- | --- | --- | ---
| ruft Funktion 2 (mit Fehlerbeh.) |  |
|  | ruft Funktion 3 (ohne Fehlerbeh.) |
|  |  | ruft Funktion 4 (ohne Fehlerbeh.)

In Funktion 4 tritt ein Fehler auf. Der Interpreter stellt fest, dass die Fehlerbeh. in Funktion 4 und 3 nicht aktiv ist und verzweigt schließlich in die Funktion 2 zur Fehlerbeh.-Routine. Die fehlerauslösende Anweisung ist in diesem Fall die Anweisung “AusführenMakro( “Funktion 3”) und die Befehle “Fortsetzen”, “FortsetzenBei” und “Wiederholen” beziehen sich auf diese Anweisung.

28. August 2025
12. Juni 2025