Makro-Funktion ExecSQLScalar
Einzelnen Datenwert aus einer Tabelle abfragen.
Syntax
{ExecSQLScalar:Connection,TableName,ResultFieldName,Default,SqlWhere}
Parameter
Connection gibt die Datenverbindung an. Verwenden Sie "DocDB" für das Dokumentarchiv, "CRMDB" für die Kontakt- oder "ApplDB" für die Anwendungsdatenbank.
TableName: Name der Datenbanktabelle
ResultFieldName: Name des Datenbankfeldes, welches als Ergebnis zurückgegeben wird.
Default: Vorgabewert, welcher bei einem auftretendem Fehler oder bei einem leeren Abfrageergebnis zurückgegeben wird. Darf kein Komma enthalten.
SqlWhere: Filter-Teil der SQL-Anweisung.
Rückgabewert
Wert der mit ResultFieldName angegebenen Spalte der ersten gefundenen Zeile.
Beschreibung
Die Funktion ExecSQLScalar fragt mit Hilfe einer SQL-Anweisung einen einzelnen Datenwert aus der angegebenen Datenbank-Tabelle ab. Aus Sicherheitsgründen kann nur der Filter für die SQL-Anweisung angegeben werden, "SELECT ResultFieldName FROM TableName WHERE " ist fest kodiert.
Beispiel:
Bezeichnung (Matchcode) des Kontakts, der mit dem aktuellen Dokument verknüpft ist:
{ExecSQLScalar:crmdb,contact,matchcode,Sonstiger Kontakt,contactguid={doc:contactguid,sqlescapeguid}}
Nummer des ersten Lieferscheins im Buchungsjahr 2023:
{ExecSQLScalar:docdb,document,docno,,project='2023' AND category='Lieferschein' ORDER BY receiptdate}
Siehe auch