Eigenschaft:

SQL-Schablone


Beschreibung:

Mit diesem Wert wird ein SQL-Kommando definiert, das die gewünschten Daten vom Datenbank-Server holt. Als Kommando ist alles erlaubt, was der zugrundeliegende ODBC-Konnektor unterstützt und / oder erlaubt. Bei entsprechenden Zugriffsrechten sind auch schreibende Zugriffe denkbar.

Die Zeichenkette kann mehrzeilig sein und darf bis zu 2000 Zeichen lang sein.


Die als Resultat des SQL-Kommandos gelieferten Daten werden in Zwischenpuffer kopiert, von wo aus sie für die Zusammenstellung von Schablonen innerhalb von Text-, Barcode- oder Ressourcenfelder verwendet werden können (siehe unten).

Mittels der drei Fluchsymbole '\', '^' und '~' können, neben einigen besondere Variablen, auch bei der Mustererkennung gefundene Texte mit in das SQL-Kommando aufgenommen werden. Die Fluchtsymbole werden innerhalb der Schablone wie folgt verwendet:

\X:Y Der umgedrehte Schrägstrich fordert einen durch eine Feldauswahl ermittelten Text an. Die durch den Doppelpunkt voneinander getrennten Zahlen wählen die Nummer des Feldes (X, im Bereich 1 bis 99) und die Nummer des ermittelten Textes (Y, im Bereich 1 bis 9). So bezieht sich '\3:2' auf das dritte Feld und dort auf den zweiten Text (zweites Klammerpaar). Hat das angesprochene Feld einen Namen, kann statt der Feldnummer (X) auch der Name angegeben werden.
^X:Y Das Circumflex fordert einen durch einen übergeordneten Dokumentprozess ermittelten Text an. Die durch den Doppelpunkt voneinander getrennten Zahlen wählen die Nummer der Bedingung (X, im Bereich 1 bis 99) und die Nummer des ermittelten Textes (Y, im Bereich 1 bis 9). So bezieht sich '^1:2' auf die erste Bedingung (die zum Aufruf des Formatprozesses geführt hat, der jetzt dieses Formular aufruft) und dort auf den zweiten Text (zweites Klammerpaar). Hat die angesprochene Bedingung einen Namen, kann statt der Bedingungsnummer (X) auch der Name angegeben werden.
~X:Y Die Tilde fordert einen durch eine HTTP- oder ODBC-Anfrage ermittelten Text an. Die durch den Doppelpunkt voneinander getrennten Zahlen wählen die Nummer des Anfragefeldes (X, im Bereich 1 bis 99) und die Nummer des ermittelten Textes (Y, im Bereich 1 bis 9). So bezieht sich '\3:2' auf das dritte Feld und dort auf den zweiten Text. Hat das angesprochene Feld einen Namen, kann statt der Feldnummer (X) auch der Name angegeben werden.
\ Der umgedrehte Schrägstrich gefolgt von einem der nachfolgenden Zeichen hat eine spezielle Funktion:
 

\
^
~
c
e
f
j
m
u
p
t
xHH

Erzeugt den umgedrehten Schrägstrich.
Erzeugt das Circumflex.
Erzeugt die Tilde.
Erzeugt die IP-Adresse oder den Namen des Computers, der den Druckauftrag generiert hat.
Erzeugt die Nummer des Etiketts auf dem aktuellen Etikettenbogen.
Erzeugt die Dateibezeichnung des Druckauftrags.
Erzeugt den Namen des Druckauftrags.
Erzeugt den Namen des Druckers, auf dem der Druckauftrag ausgeführt wird.
Erzeugt den Benutzernamen desjenigen, der den Druckauftrag generiert hat.
Erzeugt die aktuelle Seitennummer.
Erzeugt die Anzahl der Seiten im Dokument (Nur wenn vorher ein Dokumentprozess ausgeführt wurde).
Gestattet die Aufnahme eines beliebigen Zeichens in die Schablone durch die Angabe seines Hexadezimalwertes. Es können alle Zeichen von '\x00' bis '\xFF' erzeugt werden. Die Hexadezimalziffern A bis F können wahlweise als Gross- oder Kleinbuchstaben geschrieben werden.

Alle anderen Zeichen stehen innerhalb der Schablone für sich selbst. Es sind beliebige Mischformen aus konstanten und variablen Inhalten darstellbar.


Hinweise: