Eigenschaft:
Ressourceschablone
Beschreibung:
Mit diesem Wert wird festgelegt, welche Zeichenkette als Ressourcenname verwendet werden soll. Mit Hilfe von besonderen Steuerzeichen können auch variable Daten, z.B. Texte, die bei der Feldauswahl ermittelt wurden, in die zu druckende Zeichenkette eingebaut werden. Die Zeichenkette darf bis zu 255 Zeichen lang sein.
Mittels der drei Fluchsymbole '\', '^' und '~' können, neben einigen besondere Variablen, auch bei der Mustererkennung gefundene Texte mit in den Ressourcennamen 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:
|
Alle anderen Zeichen stehen innerhalb der Schablone für sich selbst. Es sind beliebige Mischformen aus konstanten und variablen Inhalten darstellbar.
Hinweise:
- Bei der Kodierung länderspezifischer Sonderzeichen ist zu berücksichtigen, dass alle Eingaben und Anzeigen innerhalb des print2forms-Systems im Zeichensatz ISO-8859-1 erfolgen, also insbesondere auch der Ressourcename. Deshalb kann es beim Einfügen von Nutzdaten in den Ressourcenamen notwendig werden, solche Zeichen umzukodieren. Da dies aber nicht vorgesehen ist, müssen länderspezifische Zeichen in solchen Fällen im Ressourcenamen gegebenenfalls von vornherein im Zeichensatz der Nutzdaten kodiert werden.