Diese Funktion fügt in eine Zeichenfolge, die ein gültiges JSON-Dokument darstellt, eine neue Eigenschaft ein und liefert die erweiterte JSON-Zeichenfolge zurück.

Wenn die Eingabezeichenfolge leer ist, wird ein neues JSON-Dokument erstellt. Durch mehrfachen Aufruf dieser Makrofunktion kann sukzessive ein vollständiges JSON-Dokument innerhalb eines Feldes aufgebaut werden.

Rückgabetyp: Text

Diese Funktion fügt in eine Zeichenfolge, die ein gültiges XML-Dokument darstellt, ein neues Element ein und liefert die erweiterte XML-Zeichenfolge zurück.

Wenn die Eingabezeichenfolge leer ist, wird ein neues XML-Dokument inklusive des Deklarationselements erstellt. Durch mehrfachen Aufruf dieser Makrofunktion kann sukzessive ein vollständiges XML-Dokument innerhalb eines Feldes aufgebaut werden.

Rückgabetyp: Text

Diese Funktion führt eine Abfrage gegen einen externen Webservice aus und liefert den HTTP-Body-Inhalt aus dessen Antwort zurück.

Rückgabetyp: Text

Diese Funktion führt eine Pflichtwertprüfung für ein Feld durch, d.h. die Funktion wirft einen Fehler, wenn der betreffende Feldwert leer ist.

Als leer gelten anhängig vom Datentyp solche Werte, die beim Feldmakro IsEmpty() beschrieben sind. Abweichend vom Standardverhalten wird kein Rückgabewert generiert. Der vorhandene Feldwert wird beibehalten.

Diese Funktion liefert den dekodierten Wert einer Base64-kodierten Zeichenfolge zurück.

Rückgabetyp: Text

Diese Funktion liefert den Base64-kodierten Wert einer Zeichenfolge, des Inhalts einer Dateianlage oder des Inhalts einer externen Datei zurück.

Rückgabetyp: Text

Diese Funktion führt einen Datenbankbefehl aus, der keine SELECT-Abfrage darstellt (siehe QueryDbField()).

Ein solcher Datenbankbefehl kann z. B. ein INSERT- oder UPDATE-Kommando sein. Der Rückgabewert ist die Anzahl betroffener Datensätze, bei einem erfolgreichen INSERT-Kommando z. B. 1.

Rückgabetyp: Number

Diese Funktion prüft, ob eine externe Datei im Dateisystem existiert.

Rückgabetyp: Bool

Diese Funktion liefert einen mit jedem Aufruf automatisch inkrementierten Ganzzahlwert zurück.

Zur Speicherung der aktuellen Zählerwerte wird dieselbe interne Datenbanktabelle genutzt wie für die Dokumentmakrofunktionen bzw. Feldmakrofunktionen WriteToCustomStore() und ReadFromCustomStore().

Rückgabetyp: Number

Diese Funktion liest die Namen von externen Dateien im Dateisystem ein, die einem gegebenen Namensmuster entsprechen.

Rückgabetyp: Array von Textwerten

Diese Funktion liefert den MD5-Hash-Wert einer Zeichenfolge, des Inhalts einer Dateianlage oder des Inhalts einer externen Datei zurück.

Rückgabetyp: Text

Diese Funktion liefert den Wert NULL zurück.

Standardmäßig unterstützt der Makrointerpreter den Wert NULL nicht direkt. Stattdessen werden leere Werte in Abhängigkeit vom Datentyp verwendet, z. B. ein leerer String "" für einen leeren Textwert. In Ausnahmefällen können jedoch NULL-Werte auftreten, z. B. als Ergebnis einer externen Datenbankabfrage.

Die Funktion GetNull() dient der testweisen Erzeugung von NULL-Werten und ist nicht für die Nutzung in einer produktiven Konfiguration bestimmt. Durch die testweise Erzeugung von NULL-Werten kann das Verhalten von Makrofunktionen überprüft werden, wenn solche Werte übergeben werden.

Diese Funktion liefert eine neu erstellte UUID (Universally Unique Identifier) mit einer Länge von 36 Zeichen (32 Stellen plus Trennzeichen) zurück.

Rückgabetyp: Text

Diese Funktion prüft, ob ein Wert "leer" ist.

Rückgabetyp: Bool

Diese Funktion prüft, ob ein Wert NULL ist.

Standardmäßig ist der interne Makrointerpreter nicht für den Umgang mit NULL-Werten ausgelegt. Der Makrointerpreter verwendet stattdessen leere Werte abhängig vom Datentyp (siehe IsEmpty()). Für den Sonderfall, dass Werte aus einer externen Datenbank gelesen und NULL-Werte dabei nicht in den typgerechten leeren Werten gewandelt werden, sondern als NULL-Werte erhalten bleiben sollen, ist eine entsprechende Prüffunktion verfügbar. Die Funktion IsEmpty() erkennt auch NULL-Werte, unterscheidet aber nicht zwischen diesen Werten und den regulären Leerwerten.

Eine explizite Prüfung auf NULL-Werte ist sinnvoll, wenn diese Werte als Ergebnis einer Datenbankabfrage vorkommen können. Bei der Weiterverarbeitung kann eine Fallunterscheidung erforderlich sein, denn die Makrofunktionen sind abhängig von ihrer konkreten Implementierung nicht auf die Verarbeitung von NULL-Werten ausgelegt.

Rückgabetyp: Bool

Diese Funktion liest aus einer Nachschlageliste den zu einem gegebenen Schlüssel gehörigen Wert aus oder einen leeren Textwert, wenn der Schlüssel nicht gefunden wird.

Die Inhalte einer solchen Liste werden in der Eigenschaft Lookup[] der Szenariokonfiguration definiert (siehe Generelles).

Rückgabetyp: Text

Diese Funktion liest aus einer Nachschlageliste einen oder alle Werte aus, deren Schlüssel einem gegebenen Muster entsprechen. Der Rückgabewert ist vom Typ Text oder Array abhängig davon, ob einer oder mehrere Werte gelesen werden. Wenn kein Wert gefunden wird, enthält der Rückgabewert einen leeren String oder ein leeres Array.

Diese Funktion führt eine SELECT-Anfrage an eine externe Datenquelle durch und liefert das erste Feld des ersten gefundenen Datensatzes zurück.

Der Rückgabetyp variiert.

Diese Funktion liest einen zuvor über die Dokumentmakrofunktion WriteToCustomStore() persistierten Wert wieder aus der Datenbank aus.

Der Rückgabetyp variiert.