Adobe Acrobat Sign-Text-Tag-Guide

Text-Tags werden in Acrobat Sign-Formularfelder umgewandelt, wenn das Dokument zum Signieren oder Hochladen gesendet wird. Acrobat Sign-Text-Tags können in beliebigen Dokumenttypen platziert werden. Dazu zählen PDF, Microsoft Word, PowerPoint, Excel und Textdateien (.txt, .rtf).

Beispiel:

Acrobat Sign-Text-Tags bietet einen leistungsstarken Mechanismus für das Einrichten von Dokumentvorlagen, die das Positionieren von Signatur- und Initialenfeldern, das Sammeln von Daten mehrerer Parteien in einer Vereinbarung, das Definieren von Validierungsregeln für gesammelte Daten und das Hinzufügen von qualifizierenden Bedingungen ermöglichen. Sobald ein Dokument mit Text-Tags ordnungsgemäß eingerichtet wurde, kann es beim Senden von Dokumenten für Signaturen als Vorlage verwendet werden. Dadurch wird sichergestellt, dass die für Vereinbarungen gesammelten Daten in der gesamten Organisation einheitlich und gültig sind.

Tag-Text-Kurzanleitung

Tag-Text-Beispiele

In allen folgenden Beispielen wird davon ausgegangen, dass Tags im Dokumentinhalt verwendet werden. Lasse beim Verwenden von Tags als PDF-Formularfeldnamen die öffnenden „{{“ und die schließenden „}}“ weg.

Signatur- und Initialenfelder

Felder vom Typ „Empfängerrolle“

Die Unterzeichner- und Absenderfelder werden verwendet, um die Empfängerrollen für eine Vereinbarung anzugeben.

Feld „Unterzeichner“

Die Rolle „Unterzeichner“ gibt den ersten Empfänger (Unterzeichner oder Genehmiger) an, der nicht der „Absender“ ist. Die Rolle „signer1“ kennzeichnet den ersten Empfänger in allen Fällen. Der als „signer1“ gekennzeichnete Empfänger kann der Absender sein, sofern der Absender die Vereinbarung zunächst signiert oder genehmigt.

Feld „Absender“

Die Rolle „Absender“ kann nur verwendet werden, wenn die Option „Als Erster oder Letzter signieren“ während des Sendevorgangs angegeben wird. Die Rolle „Absender“ gibt immer ein dem „Absender“ zugewiesenes Feld an, unabhängig davon, ob er als Erster oder Letzter signiert.

Feld „Alle“

Das Hyperlink-Feld verfügt über eine spezielle (optionale) Empfängerrolle: Alle.

Wenn diese Rolle vorhanden ist, müssen alle Empfänger mit dem Feld interagieren, bevor sie eine Aktion für die Vereinbarung abschließen können.

Du musst dazu lediglich auf den Hyperlink klicken.

Felder vom Typ „Vorausfüllen“

Textfelder

Schreibgeschützte Felder

Kontrollkästchen

Optionsfelder

Bilder

Feldbestätigung

Bedingungsregeln

Berechnete Felder

Umwandeln von Text-Tags in Formularfelder

Feldlänge und -formatierung

Beim Verwenden von Text-Tags in einem Dokument, das bearbeitet werden kann, überlagert Acrobat Sign ein Rechteck, das sich über den gesamten Bereich des Text-Tags erstreckt (von den beginnenden „{{“ bis zu den endenden „}}“), und wandelt das Text-Tag in das entsprechende Acrobat Sign-Formularfeld um.

Die Länge des Formularfelds kann durch Hinzufügen von Weißraumzeichen am Anfang des Text-Tags direkt nach dem „{{“ oder am Ende des Text-Tags direkt vor dem „}}“ erhöht werden. Die Größe des Formularfelds kann zum Erzielen der gewünschten Länge durch Reduzieren des Schriftgrads des Text-Tags verringert werden.

Die Formularfeldformatierung (Schriftgrad, -typ, -farbe usw.) wird anhand des Formats des ersten „{“ bestimmt. Zum Gewährleisten der richtigen Verarbeitung von Text-Tags durch Acrobat Sign sollten die Tag-Definitionen in gängigen Schriftarten im Dokument (Helvetica, Times, Arial, Verdana oder Courier) angegeben werden. Wenn eine bestimmte Feldgröße und/oder -schriftart mithilfe von Direktiven erzwungen werden soll, lies die Informationen im Abschnitt Steuern der Feldgröße mithilfe von Direktiven.

Bei Text-Tag-Definitionen wird die Groß-/Kleinschreibung beachtet, wobei sie in Kleinbuchstaben angegeben werden müssen. 

In der folgenden Abbildung werden Text-Tags gezeigt, die in einem Microsoft Word-Dokument platziert sind.

Der gesamte Bereich des Text-Tags von der öffnenden geschweiften Klammer bis zur schließenden geschweiften Klammer muss in eine einzelne Zeile passen. Wenn sich ein Text-Tag auf mehrere Zeilen erstreckt, entweder im Quelldokument oder in der verarbeiteten PDF, wird das Formularfeld von Acrobat Sign nicht richtig erkannt, wodurch der zugrunde liegende Text dem Unterzeichner beim Signieren des Dokuments möglicherweise angezeigt wird.

Bei Verwendung in PDF-Formularen sollten die geschweiften Klammern nicht im Namen der PDF-Formularfelder verwendet werden. Zudem wird die Größe des Felds anhand der Größe des PDF-Formularfelds bestimmt und die Formatierung der in das Feld eingegebenen Daten wird anhand der PDF-Formularfeldeigenschaften bestimmt.

Ein einzelnes Dokument kann PDF-Formularfelder und Felder aufweisen, die mit Text-Tags definiert sind.

Interagieren mit Formularfeldern während der Signatur

Die obigen Text-Tags werden während der Signatur in die folgenden ausfüllbaren Felder umgewandelt:

Formularfelder im signierten Dokument

Nachdem die Daten im signierten Dokument zusammengeführt wurden, würde Folgendes in der signierten PDF angezeigt werden:

Lange Text-Tags

Bei Verwendung in Dokumenten, die bearbeitet werden können, werden viele Direktiven aufweisende Text-Tags möglicherweise sehr lang, wodurch es schwierig wird, kleine Felder für das Dokument anzugeben. Acrobat Sign stellt einen einfachen Mechanismus bereit, mit dem du kürzere Tags im Dokument angeben kannst.

Wenn du beispielsweise über ein Pflichtfeld zur Eingabe der Telefonnummer verfügen musst, das dem Absender zugewiesen ist, kannst du, anstatt das gesamte Tag

{{*Mobile_es_:signer1:phone}} zu setzen, ein kürzeres Tag {{$mob            }} an der entsprechenden Position im Dokument mit Leerzeichen verwenden, um die Feldgröße anzupassen. Die vollständige Definition des Text-Tags

{{#mob=*Mobile_es_:signer1:phone}} kann an einer anderen Position im Dokument platziert werden. Weitere Informationen zur Text-Tag-Kürzung findest du unter Kürzen von Text-Tags.

Text-Tags im Detail

Text-Tag-Syntax

Ein Acrobat Sign-Text-Tag wird wie folgt definiert:

Wobei die Komponenten wie folgt definiert sind:

• Erforderlich: ein erforderliches Flag, das angibt, ob ein bestimmtes Feld erforderlich ist und durch den Unterzeichner während der Signatur ausgefüllt werden muss. Wenn das Flag nicht vorhanden ist, ist das Formularfeld optional und der Unterzeichner kann (muss aber nicht) einen Wert während der Signatur eingeben.
• Schreibgeschützt: ein optionales Flag, das angibt, dass das entsprechende Feld schreibgeschützt ist. Durch die Markierung eines Felds als „schreibgeschützt“ wird sichergestellt, dass die Daten im Feld während der Signatur nicht geändert werden können. Daten können mithilfe von Acrobat Sign-APIs oder per Massenversand via CSV in schreibgeschützte Felder zusammengeführt werden, bevor das Dokument zur Signatur gesendet wird.
• Feldname: ein eindeutiger Name zum Ermitteln dieses spezifischen Felds im Dokument. Der Feldname wird verwendet, um die Werte zu bestimmen, die während der Signatur angegeben werden, wenn die Daten vom Dienst exportiert werden.

• EchoSign-ID: eine spezifische Textzeichenfolge „_es_“, die nach dem Feldnamen im Text-Tag eingeschlossen werden muss, um die Acrobat Sign-spezifischen Funktionen zu aktivieren. Wenn der Acrobat Sign-Bezeichner nicht hinter dem Feldnamen eingeschlossen wird, wird ein Formularfeld zum Dokument ohne Direktiven hinzugefügt.
• Direktive: eine Liste einer oder mehrerer Definitionen, die mit einem Doppelpunkt („:“) beginnen und die Rolle, den Feldtyp und zusätzliche Feldverarbeitungsregeln angeben, die den im Feld zulässigen Eingabetyp definieren. Direktiven können in einer beliebigen Reihenfolge definiert werden.
  • Rolle: der Teilnehmer, mit dem dieses Feld verknüpft ist (z. B. Absender, Unterzeichner).
  • Feldtyp: der Acrobat Sign-Formularfeldtyp (z. B. Signatur-, Initialen-, Textfeld oder Kontrollkästchen)
  • Regeln: erweiterte Verarbeitungsregeln wie die Datenvalidierung, die Logik zum Anzeigen/Ausblenden von Feldern auf Basis von Bedingungen usw.

Steuern von Feldinteraktionen beim Signaturvorgang

Formularfelder in einem Dokument können während des Signaturworkflows zu einem spezifischen Unterzeichner zugewiesen werden. Acrobat Sign stellt sicher, dass ein Unterzeichner während der Signatur nur mit den Feldern interagieren kann, die ihm zugewiesen wurden. Formularfelder können zu einem spezifischen Unterzeichner zugewiesen werden, indem dem Text-Tag eine spezifische Direktive hinzugefügt wird.

Zuweisen eines Formularfelds zu spezifischen Unterzeichnern

Acrobat Sign unterstützt die folgenden Direktiven für das Zuweisen eines Formularfelds zu spezifischen Unterzeichnern.

Absender füllt Daten vorab aus

Manchmal muss der Absender die Vereinbarung nicht signieren, jedoch die Daten eingeben, bevor die Vereinbarung zur Signatur gesendet wird. Dazu muss eine Direktive vom Typ „vorausfüllen“ zu den relevanten Formularfeldern in der Vereinbarung hinzugefügt werden. Mit Acrobat Sign kann der Absender diese Felder ausfüllen, bevor die Vereinbarung zur Signatur gesendet wird.

Nicht zugewiesene Felder

Felder, die keine Rolle enthalten (oder bei denen ein Wort in der Rollen-Direktive falsch geschrieben ist) können von allen Empfängern in der Liste ausgefüllt werden. Nachdem das Feld ausgefüllt wurde, wird es gesperrt, um zu verhindern, dass nachfolgende Unterzeichner seinen Wert ändern. 

Grundlegende Acrobat Sign-Feldtypen

Mit spezifischen Direktiven in Text-Tags kann eine Vielzahl an Feldtypen in einem Dokument erstellt werden. Acrobat Sign interpretiert die Tags und wandelt sie während der Signatur in die entsprechenden Formularfelder um. Alle Feldtypen, die durch die Acrobat Sign-Webanwendung zu einem Dokument hinzugefügt werden können, können auch durch Text-Tags angegeben werden.

Signatur- und Initialenfelder

Du kannst Acrobat Sign-Signatur- oder -Initialfelder an bestimmten Positionen im Dokument platzieren, indem du eine Direktive hinzufügst, um den Signaturfeldtyp festzulegen. Signatur- und Initialenfelder sind standardmäßig obligatorisch.

Für einige Dokumente ist es jedoch erforderlich, dass der Unterzeichner an bestimmten zusätzlichen Positionen im Dokument optional seine Initialen angibt oder Signaturen vornimmt. Optionale Signatur- oder Initialenfelder können ebenfalls in einem Dokument mit Text-Tags definiert werden.

Spezielle ACROBAT Sign-Felder

Acrobat Sign verfügt über spezielle Felder, die im Dokument positioniert werden können, um Informationen vom dem Unterzeichner zu sammeln, beispielsweise die Stellenbezeichnung des Unterzeichners oder den Unternehmensnamen. Wenn die Informationen für diese Felder bereits verfügbar sind, füllt Acrobat Sign diese Felder automatisch aus, bevor sie dem Unterzeichner während der Signatur angezeigt werden.

Spezielle schreibgeschützte Felder

Darüber hinaus unterstützt Acrobat Sign zudem das Erfassen des Signaturdatums, der E-Mail-Adresse und des Namens des Unterzeichners in der Vereinbarung. Diese Felder werden automatisch von Acrobat Sign aufgefüllt und können beim Signieren der Vereinbarung nicht vom Unterzeichner geändert werden.

Signaturblock

Wenn sich kein Signaturfeld im Dokument für einen spezifischen Unterzeichner befindet, platziert Acrobat Sign unten im Dokument automatisch einen Signaturblock für den jeweiligen Unterzeichner. Ein Signaturblock enthält standardmäßig Signatur- und E-Mail-Adressenfelder. Wenn dein Konto- oder Gruppenadministrator jedoch die Einstellung Unterzeichner müssen beim e-Signieren ihre Stellenbezeichnung angeben oder Unterzeichner müssen beim e-Signieren ihren Firmennamen angeben oder beide aktiviert hat (unter „Signaturvorgaben“), werden die Titel- bzw. Unternehmensfelder im Signaturblock verwendet. In der folgenden Grafik wird ein Signaturblock gezeigt, der alle vier Felder enthält.

Mithilfe der Direktive „signatureblock“ kannst du den gesamten Acrobat Sign-Signaturblock in deinem Dokument platzieren.

Textfelder

Alle in einem Dokument definierten Felder, die keine zusätzlichen Feldtyp-Definitionsdirektiven aufweisen, werden als ausfüllbare Textfelder in einem Dokument behandelt.

Definieren von Pflicht-/optionalen Feldern

Für die meisten Felder kannst du angeben, ob sie erforderlich oder optional sind. Acrobat Sign gewährleistet, dass ein Unterzeichner eine Vereinbarung erst dann signieren kann, nachdem alle obligatorischen Felder ausgefüllt wurden.

Standardmäßig sind alle Felder mit Ausnahme der folgenden optional:

• Signatur- und Initialenfelder sind standardmäßig obligatorisch, sofern du diese Felder nicht mithilfe der Text-Tags „optsignature“ oder „optinitials“ definiert hast. Weitere Informationen zu diesen Text-Tags findest du unter Signatur- und Initialenfelder.
• Die Felder „Titel“ und „Unternehmen“ sind obligatorisch, sofern sie entsprechend deinen Kontoeinstellungen Teil des Signaturblocks sein müssen. Informationen zu spezifischen Kontoeinstellungen findest du unter Signaturblock.

Ein Pflichtfeld ist mit einem Sternchenpräfix (*) neben dem Namen markiert oder indem im Text-Tag die erforderliche Direktive hinzugefügt wird.

Beispiel:

Pflichtfelder werden durch das rote Sternchen auf der linken Seite des Felds gekennzeichnet.

Bearbeitbare/Schreibgeschützte Felder

Standardmäßig können alle nicht schreibgeschützten Felder bearbeitet werden. Zu den Ausnahmen zählen spezielle Unterzeichnerfelder (E-Mail-Adresse, Unterzeichnername und Signaturdatum), die standardmäßig schreibgeschützt sind. Weitere Informationen findest du unter Spezielle schreibgeschützte Felder.

Schreibgeschützte Felder sind hilfreich beim automatischen Zusammenführen von Daten in ein Dokument mithilfe der Acrobat Sign-API oder der Massenversand-Datenzusammenführungsfunktion. Mit schreibgeschützten Feldern wird sichergestellt, dass der Unterzeichner die zusammengeführten Daten beim Signieren nicht ändern kann.

Durch das Hinzufügen eines Ausrufezeichenpräfixes (!) zum Feldnamen oder mithilfe der Direktive für den Schreibschutz wird es als ein schreibgeschütztes Feld markiert.

Beispiel:

Erweiterte Dokumentverarbeitung mit Text-Tags

Zusätzliche Feldtypen

Du kannst die folgenden Feldtypen mit ihren eindeutigen Text-Tags erstellen:

• Kontrollkästchen
• Optionsfelder
• Mehrzeilige Textfelder
• Dropdownlisten
• Unterstützende Dokumente (Anlage)
• Hyperlinks
• Teilnehmerstempel und Transaktions-IDs

Kontrollkästchen

Du kannst ein Kontrollkästchen mithilfe von Text-Tags erstellen, indem du das Tag „Checkbox“ in deinem Dokument platzierst oder die Direktive „checkbox“ verwendest.

Optionsfelder

Text-Tags können auch verwendet werden, um Optionsfelder zu definieren und in einem Dokument zu positionieren. Optionsfelder müssen über mindestens zwei Optionen (Auswahlmöglichkeiten) in einer Optionsfeldgruppe verfügen. Hierbei handelt es sich um eine Gruppe, die durch denselben Feldnamen im Dokument bestimmt wird. Jede Option (Auswahlmöglichkeit) des Optionsfelds muss einen unterschiedlichen Auswahlwert aufweisen. Optionsfelder können mithilfe der folgenden Syntax definiert werden.

Angeben des Optionsfeldstils

Acrobat Sign unterstützt das Erstellen von unterschiedlichen Optionsfeldstilen. Der angegebene Optionsfeldstil wird in der PDF angezeigt. Während der Signatur werden die Optionsfeldoptionen jedoch immer als Kreise dargestellt.

(Inline-)Bildfelder

Bildfelder werden verwendet, um eine Bilddatei – wie ein Foto oder ein gescanntes Dokument (z. B. einen Führerschein) – zu erfassen. Diese Bilder können aus dem signierten Dokument extrahiert werden.  Die Anweisung :inlineimage macht das Hinzufügen eines zusätzlichen Parameters erforderlich, der die Höhe des Feldes definiert. Die Feldhöhe wird aus der Schriftgröße des Tags abgeleitet und in Zeilen dieses Schriftartwertes gemessen.

Mehrzeilige Textfelder

Text-Tags können zum Definieren von Textfeldern verwendet werden, die sich auf mehrere Zeilen erstrecken können. Diese Felder können in Dokumenten verwendet werden, um während der Signatur mehrere Datenzeilen zu erfassen.

Dropdownlisten

Text-Tags können auch verwendet werden, um Dropdownlisten zu definieren und in einem Dokument zu positionieren. Dropdownlisten können mehrere Optionen enthalten. Beim Signieren des Dokuments kann der Benutzer eine dieser Optionen auswählen. Eine Dropdownlistendefinition besteht aus zwei Komponenten: einem eindeutigen Satz an Optionen, aus denen der Empfänger eine Auswahl treffen kann, und optional einem Satz an Werten, die zurückgegeben werden, wenn die Daten von der Vereinbarung exportiert werden.

Dropdownlisten müssen eindeutig sein, auch wenn Dropdownwerte nicht eindeutig sein müssen (d. h. mehrere Dropdownoptionen können über denselben davon exportierten Wert verfügen). Dropdownwerte sind optional. Wenn keine Dropdownwerte definiert sind, werden die Dropdownoptionen zurückgegeben, wenn die Daten aus der Vereinbarung exportiert werden.

Wenn Dropdownwerte definiert sind, muss die Anzahl der definierten Werte mit der Anzahl der Optionen übereinstimmen. Wenn die Anzahl der angegebenen Optionen und Werte nicht übereinstimmen, führt dies zu einem Fehler und das Feld wird nicht als eine Dropdownliste behandelt.

Beim Definieren einer Standardauswahl für eine Dropdownliste oder beim Definieren von Bedingungen für ein anderes Feld anhand der Auswahl einer der Optionen aus der Dropdownliste durch den Empfänger müssen die Exportwerte (nicht die Optionen) verwendet werden. Verwende die Dropdownoptionen, wenn keine Exportwerte definiert sind.

Bei Bedarf können der Dropdownfelderdefinition zusätzliche Direktiven hinzugefügt werden, beispielsweise indem die Dropdownliste als obligatorisch festgelegt, eine bedingte Logik auf Dropdownlisten angewendet oder angegeben wird, dass die vom Empfänger ausgewählte Option in der PDF maskiert werden sollte.

Ergänzende Dokumente (Dateianlagen)

Acrobat Sign kann verwendet werden, um während der Signatur ergänzende Dokumente von Unterzeichnern einzuholen. Während der Signatur wandelt Acrobat Sign das Text-Tag in ein Feld um, das vom Unterzeichner ausgewählt werden kann, um eine Datei zum Hochladen auszuwählen. Das bzw. die hochgeladene(n) Dokument(e) wird bzw. werden als Bestandteil des signierten Dokuments eingeschlossen, in die PDF umgewandelt und am Ende der signierten Vereinbarung nach dem Signaturvorgang angehängt. Formularfelder für das Sammeln von Dateien vom Unterzeichner werden mithilfe der Direktive „attachment“ definiert.

Definieren eines Dateianlagefelds:

Während der Signatur angezeigtes Feld „Dateianhang“:

Hyperlinks

Acrobat Sign kann verwendet werden, um Hyperlinks in Dokumenten anzugeben. Auf Hyperlinks kann während der Signatur geklickt werden und sie führen den Empfänger zu einer Position im Dokument oder zu einer externen URL. Beschriftungen können auch für Hyperlinks angegeben werden, sodass das Dokument die Textbeschriftung anstelle der direkten URL anzeigt.

In der Regel werden Hyperlink-Felder verwendet, damit sich die Empfänger aus beliebigen Gründen zu einer anderen Seite durchklicken können. Bei Verwendung als optionaler Link muss keine Empfängerrolle definiert werden. Das Feld verbleibt als aktiver Link, auf den jeder Empfänger klicken kann.

Hyperlink-Felder können auch als Erforderlich definiert werden. Wenn das Feld als „Erforderlich“ konfiguriert ist, muss über die Empfängerrolle definiert werden, welche Empfänger auf den Link klicken müssen. 

• Der angegebene Empfänger darf die jeweilige Aktion erst nach dem Klicken auf den Link abschließen.
• Der Link bleibt für alle anderen Empfänger aktiv (aber nicht erforderlich).

Darüber hinaus verfügt das Hyperlink-Feld über eine eindeutige Empfängerrolle: Alle. Wenn die Rolle Alle in Kombination mit dem Kennzeichen Erforderlich verwendet wird, müssen alle Empfänger auf das Hyperlink-Feld klicken, um die jeweilige Aktion durchzuführen.  

Teilnehmerstempel und Transaktions-IDs (nur für Business- und Enterprise-Dienstebenen)

Teilnehmerstempel und Transaktions-IDs können den signierten PDFs für die Unterzeichner hinzugefügt werden. Der Stempel des entsprechenden Teilnehmers wird angezeigt, nachdem diese Person das Dokument signiert oder genehmigt hat. Der Teilnehmerstempel enthält den Namen des Teilnehmers, die Uhrzeit der Signatur/Genehmigung sowie die E-Mail-Adresse. Die Transaktions-IDs und Stempel werden in der endgültigen signierten PDF angezeigt.

Digitale Signaturen (nur für Enterprise-Dienstebenen)

Digitale Signaturen: Acrobat Sign unterstützt bis zu 10 digitale Signaturfelder pro Empfängerin bzw. Empfänger. Jedes Feld muss einen eindeutigen Namen haben, wenn mehrere Signaturfelder für eine Empfängerin bzw. einen Empfänger erstellt werden. Wenn der Name eines Text-Tags für die digitale Signatur kopiert wird, benennt Acrobat Sign die Felder automatisch um, indem der Zusatz „n“ hinzugefügt wird. „n“ steht dabei für eine Zahl ab 1, die für jeden gefundenen doppelten Feldnamen schrittweise erhöht wird. Beispiel: {{digsig1_es_:signer1:digitalsignature}} wird zu {{digsig1-1_es_:signer1:digitalsignature}} und {{digsig1-2_es_:signer1:digitalsignature}} usw.

Stempelsignaturen

Felder vom Typ „Stempel“ erfüllen einen doppelten Zweck – sie sind Ersatz für ein Signaturfeld (für Unternehmen, die es vorziehen, mit ihrem Firmensiegel zu signieren) oder dienen zur Unterstützung einer herkömmlichen Signatur (wie ein Hanko-Stempel). Wie Felder vom Typ „Digitale Signatur“ kann auch nur ein Stempelfeld pro Empfänger definiert werden. Stempelfelder sind standardmäßig optional, es sei denn, sie sind als erforderlich ausgewiesen oder es werden keine anderen Signaturfelder für den Unterzeichner platziert.

Für Stempelfelder ist es erforderlich, dass der Anweisung :stampimage ein weiterer Parameter hinzugefügt wird, der die Höhe des Feldes angibt. Die Feldhöhe wird in der Anzahl der Zeilen gemessen, basierend auf der Größe des Text-Tags.

Festlegen des Standardwerts

Acrobat Sign unterstützt das Angeben von Standardwerten für ein Feld mithilfe von Text-Tags. Der angegebene Standardwert wird den Teilnehmern während der Signatur angezeigt.

Wenn der Standardwert ein einfaches Anführungszeichen oder einen Apostroph aufweist, muss der Standardwert in doppelte Anführungszeichen gesetzt werden. Zum Beispiel: {{location_es_:signer1:default("Signer's Business")}}. Wenn doppelte Anführungszeichen im Standardwert erforderlich sind, muss der Standardwert in einfache Anführungszeichen gesetzt werden.

Angeben der QuickInfo

Mit Text-Tags können auch QuickInfos für Acrobat Sign-Formularfelder angegeben werden. QuickInfos können bis zu 4096 Zeichen enthalten und werden den Empfangenden während des Signierens angezeigt.

Steuern der Feldgröße mithilfe von Direktiven

Mithilfe der Abmessungen-Direktive kannst du die Höhe und Breite eines Felds steuern und die Eingabe in den öffnenden geschweiften Klammern außer Kraft setzen. 

Dies ist nützlich, wenn deine Dokumente von einem System erzeugt werden, das die Änderung der Schriftgröße nicht zulässt.

Das Format dieser Direktive ist :dimension(width=XXnn, height=YYmm).

Dabei stehen XX und YY für die numerischen Messwerte und nn und mm sind die Inkrementtypen der Maßeinheit.

• Numerische Werte sind Dezimalwerte, die bis zu fünf bedeutende Ziffern nach dem Dezimaltrennzeichen zulassen.
• Die Inkrementtypen umfassen die folgenden Werte:
  • pt: – Punkte (jeder Punkt entspricht 1/72 Zoll); Punkte sind der Standardwert, wenn kein anderer Inkrementtyp angegeben wird.
  • in: – Zoll
  • cm – Zentimeter
  • mm – Millimeter

Auswählen einer Schriftdarstellung

Text-Tags können verwendet werden, um die Schriftdarstellung des Felds zu ändern, sodass die im Text-Tag für Schriftnamen, -farbe und -größe verwendete Schriftdarstellung überschrieben wird. Um einen Schriftnamen anzugeben, verwendest du den Namen einer Schriftart im vorhandenen Dokument oder einen der folgenden Namen: Lato, Roboto, Slabo 13px, Source Serif Pro, Source Sans Pro und Source Code Pro. Verwende zum Angeben der Farbe den RGB-Hexadezimalwert oder einen der folgenden gültigen Farbwerte: weiß, hellgrau, grau, dunkelgrau, schwarz, rot, pink, orange, gelb, grün, magenta, zyan oder blau. Standardmäßig entsprechen Schriftname und -größe dem Schriftnamen und der -größe der ersten Klammer „{“ am Beginn des Text-Tags.

Festlegen von Feldausrichtung

Text-Tags können verwendet werden, um die in die Formularfelder eingegebenen Werte auszurichten. Standardmäßig sind die Werte in den Formularfeldern linksbündig. Mithilfe von Direktiven zu den Text-Tags können die Text-Tags jedoch so ausgerichtet werden, dass sie sich mittig oder rechts befinden.

Festlegen von sich wiederholenden Feldern

Text-Tags können verwendet werden, um dieselben Felder auf jeder Seite im Dokument zu wiederholen, ohne das Text-Tag auf jede Seite kopieren zu müssen. Dies ist beispielsweise insbesondere für Signaturfelder oder Teilnehmerstempel bei längeren Dokumenten hilfreich.

Festlegen von Datenvalidierungsregeln

Acrobat Sign unterstützt eine Vielzahl an Feldvalidierungstypen, die durch zusätzliche Text-Tag-Direktiven angegeben sind. Die angegebenen Datenvalidierungsregeln werden angewendet, wenn der Unterzeichner während der Signatur Daten eingibt. Acrobat Sign gestattet es dem Empfänger nicht, den Signaturvorgang abzuschließen, wenn die eingegebenen Daten nicht mit der angegebenen Validierungsregel übereinstimmen.

Beispiel:

Einige Feldvalidierungstypen weisen ggf. zusätzliche Parameter auf, die die zulässigen Werte im Feld eingrenzen.

Unterstützte Feldvalidierungsregeln

Ein einzelnes Feld kann nur eine Direktive für die Validierung enthalten. Wenn mehrere Validierungsregeln in einem einzelnen Text-Tag angegeben sind, wird nur die erste Validierungsregel angewendet. Alle nachfolgenden Validierungsregeln werden ignoriert.

Maskieren von sensiblen Daten

Acrobat Sign unterstützt das Maskieren von sensiblen Daten, die während der Signatur erfasst werden, indem dem Text-Tag eine spezifische Direktive hinzugefügt wird. Während der Signatur werden die durch den Unterzeichner in ein solches Feld eingegebenen Daten in Sternchen (*) oder in ein benutzerdefiniertes Maskierungszeichen umgewandelt, sobald der Unterzeichner das Feld verlässt. Die vom Unterzeichner eingegebenen Daten werden zudem weder den nachfolgenden Unterzeichnern angezeigt noch in der fertigen PDF eingeschlossen. Die vom Unterzeichner eingegebenen Daten können über Acrobat Sign oder über die Acrobat Sign-API exportiert werden.

Text-Tag-Definition:

Während der Signatur:

In der endgültigen PDF:

Angeben von Bedingungsregeln für Felder

Acrobat Sign unterstützt das Anwenden von Bedingungsregeln auf Felder in einem Dokument. Bedingungsregeln können verwendet werden, um zu definieren, wann ein bestimmtes Feld in einem Dokument dem Unterzeichner während der Signatur angezeigt oder ausgeblendet wird.

Die auf ein bestimmtes Feld angewendeten Bedingungen basieren auf den Werten von mindestens einem anderen Feld im Dokument. Auf ein bestimmtes Feld angewendete Bedingungsregeln können auch angeben, dass ein bestimmtes Feld angezeigt oder ausgeblendet wird, wenn eine oder alle für ein bestimmtes Feld definierten Bedingungen erfüllt sind.

Eine Bedingung wird wie folgt definiert: Feldname, Operator, Wert, wobei der Feldname der Name des Formularfelds im Dokument ist, auf dem die Bedingung basiert. Die unterstützten Operatoren und gültigen Werte für die verschiedenen unterstützten Formularfelder werden in den folgenden Tabellen gezeigt.

Bedingte Feldoperatoren

Mehrere Bedingungen für ein einzelnes Feld können mithilfe eines Kommas getrennt werden. Beispiel:

{{notRed_es_:showifall(checkbox=checked,Color!=Red)}} definiert ein Feld namens „notRed“, das dem Unterzeichner angezeigt wird, wenn beide Bedingungen erfüllt sind.

Bedingter Feldwert für unterstützte Text-Tag-Felder

Bedingungen können zu jedem Feld zugewiesen werden, einschließlich Pflichtfeldern wie Initialen, Signaturen und Signaturblöcke. Wenn eine Bedingung für ein Pflichtfeld definiert ist, wird es nur dann als Pflichtfeld behandelt, wenn die Bedingung das Feld während der Signatur für den Unterzeichner sichtbar macht. Wenn ein Signaturfeld eine Bedingung aufweist, die es ausblendet, ist es demnach für den Unterzeichner nicht sichtbar. Demzufolge muss der Unterzeichner in diesem bestimmten Feld keine Signatur vornehmen. Der Pflichtfeldzähler am Ende der Signaturseite wird anhand der definierten Bedingungen dynamisch aktualisiert, um die Anzahl der Felder genau widerzuspiegeln, die der Unterzeichner ausfüllen muss, bevor er die Signatur des Dokuments abschließen kann.

Jeder Unterzeichner muss über ein Signaturfeld verfügen, dem keine Bedingung zugewiesen ist. Daher wird, sofern alle Signaturfelder für einen bestimmten Unterzeichner eine Bedingung aufweisen, am Ende des Dokuments ein neuer Signaturblock für diesen Unterzeichner hinzugefügt.

Angeben von Berechnungsformeln für Felder

Acrobat Sign unterstützt das dynamische Auffüllen von Feldwerten in ein Dokument während der Signatur anhand von anderen Feldwerten/Auswahlen, die vom Kunden während der Signatur getroffen wurden. Diese Feldtypen werden als berechnete Felder bezeichnet.

Berechnungsformeln können ähnlich wie andere Felder für das Dokument mithilfe von Text-Tags oder über die Drag & Drop-Authoring-Umgebung von Acrobat Sign definiert werden. Eine Berechnungsformel kann ein oder mehrere vorhandene Felder im Dokument referenzieren und auch auf einem anderen berechneten Feld im Dokument basieren. Berechnungen können auf numerische Felder, Datumsfelder und Textfelder angewendet werden.

Zusätzlich zum Berechnen des Werts eines Felds im Dokument können berechnete Felder zudem Formatierungsinformationen enthalten, um die Ausgabe des berechneten Werts im Dokument entsprechend darzustellen. Zusätzliche Regeln wie Bedingungsregeln, Feldmaskierung usw. können ebenfalls über Text-Tags auf berechnete Felder angewendet werden.

Beispiel: Ein berechnetes Feld kann verwendet werden, um die Gesamtsteuer für eine Bestellung dynamisch zu berechnen.

{{Tax_es_:signer1:calc([subtotal] * [taxrate]):format(number, "$,.00")}}

Die Steuerberechnung basiert auf den Gesamtkosten der durch den Kunden bestellten Artikel und dem Steuersatz für den Wohnsitz des Unterzeichners. Der resultierende berechnete Steuerwert wird mit einem Dollarsymbol ($) vor dem Wert formatiert und enthält zwei Dezimalstellen im resultierenden Wert. Wenn die Zwischensumme beispielsweise 1.250 ist und der Steuersatz 6,25 % beträgt, lautet der resultierende berechnete Wert, der im Feld „Steuer“ im Dokument angezeigt wird, 1.328,13 $.

Weitere Informationen zu berechneten Feldern und zu ihrer Verwendung in deinen Dokumenten findest du im Referenzhandbuch zu den berechneten Feldern.

Kürzen von Text-Tags

Text-Tags bieten einen sehr leistungsfähigen Mechanismus für das Definieren unterschiedlicher Feldtypen in einem Dokument, das Zuweisen dieser Felder zu spezifischen Unterzeichnern, das Angeben von Validierungsregeln für die Felder bzw. das Anwenden von Bedingungsregeln auf diese Felder. Wenn alle die genannten Punkte auf ein einzelnes Formularfeld angewendet werden, kann die Felddefinition sehr lang werden und dazu führen, dass die Dokumentstruktur infolge der Felddefinition geändert werden muss. Da jede Felddefinition auf eine Zeile passen muss, kann die Verwendung mehrerer komplexer Direktiven das Dokumentlayout des Weiteren sehr schwierig gestalten. Zum Gewährleisten der Konsistenz der Struktur des Dokuments unterstützt Acrobat Sign einen Mechanismus für das Definieren gekürzter Text-Tags im Dokument. Ein gekürztes Text-Tag besteht aus zwei Teilen:

• Bezugstag: eine gekürzte Tag-Definition, die an der entsprechenden Position im Dokument platziert ist. Das Bezugstag steuert die Größe und Position des tatsächlichen Formularfelds im Dokument. Ein Bezugstag weist die folgende Syntax auf: {{$shortened_name}}. Zum Beispiel definiert {{$r}} ein Bezugstag, wobei „r“ der Kurzname des Tags ist. Die Größe des Felds kann mit Leerzeichen direkt nach der letzten geöffneten geschweiften Klammer oder direkt vor der ersten geschlossenen geschweiften Klammer angepasst werden.
• Definitions-Tag: bezieht sich auf die vollständige Definition für ein spezifisches Tag und kann an einer beliebigen Stelle im Dokument definiert werden. Die Größe und Position des Definitions-Tags bestimmen nicht die Größe und Position des tatsächlichen Formularfelds im Dokument. Ein Definitions-Tag weist die folgende Syntax auf:

{{#shortened_name=Standard Tag Syntax}}. Zum Beispiel definiert {{#r=[]ReceiveCommunication_es_:signer1}} eine vollständige Tag-Definition für das Bezugs-Tag „r“. In diesem Beispiel definiert das Tag ein Kontrollkästchen, das dem als „signer1“ gekennzeichneten Empfänger zugewiesen ist.

Zum Beispiel zeigt die folgende Abbildung zwei in einem Dokument platzierte Bezugs-Tags.

Die vollständige Definition der zwei Bezugs-Tags ist an anderer Stelle im Dokument definiert, wie dies in der folgenden Abbildung gezeigt wird.

Die vollständige Definition für die Text-Tags ist sehr lang. Ohne die Fähigkeit, gekürzte Tags an der entsprechenden Position im Dokument zu definieren, ist es nicht möglich, die Struktur des ursprünglichen Dokuments aufrechtzuerhalten.

Löschen von Seiten aus der Ausgabe

Durch das Trennen von Formularfeldpositionen von der Definition des Felds ist es möglich, dass alle Definitionen für Tags in einem Dokument am Ende des Dokuments oder auf einer komplett separaten Seite im Dokument platziert werden. Wenn das Dokument über Acrobat Sign gesendet wird, werden alle Text-Tags verarbeitet und ein weißes Feld wird oben auf der Text-Tag-Definition platziert, damit der Text für den Unterzeichner nicht mehr sichtbar ist. Dies kann nach der Verarbeitung durch Acrobat Sign zu vollständig leeren Seiten im Dokument führen, d. h. zu Seiten, die nur Text-Tags enthalten. Zum Verhindern von zusätzlichen unerwünschten leeren Seiten im Dokument unterstützt Acrobat Sign eine spezielle Text-Tag-Definition zum Entfernen einer bestimmten Seite vom verarbeiteten Ausgabedokument, das durch Acrobat Sign generiert wurde, bevor das Dokument zur Signatur gesendet wird.

Erweiterte Beispiele zu Text-Tags

Im Folgenden findest du einige Beispiele von Text-Tags mit Beschreibungen für jedes Tag.

Kontrollkästchen

Optionsfelder

Dropdownliste

Feldbestätigung

Kürzen von Text-Tags

Die Text-Tag-Kürzung kann auch als Funktionen verwendet werden und nicht nur als Ersatz eines gesamten Felds.

Im Folgenden wird beispielsweise das folgende Tag verwendet:

{{field1_es_:signer1:showif(fieldA=‘Yes)}}

Dieses obige Tag kann auch wie folgt gekürzt werden:

{{field_es_:$A:$B}}

#A=signer

#B=showif(fieldA=‘Yes’)

Die Text-Tag-Kürzung kann sich auch wie Methoden für Berechnungen verhalten. Im Folgenden wird beispielsweise das folgende Tag verwendet:

{{field1_es_:calc(a * b / c)}}

Dieses obige Tag kann auch wie folgt gekürzt werden:

Field1_es_:$1(a,b,c)

#1(option1, option2, option3) = calc([option1] * [option2] / [option3])

Bedingungsregeln

Berechnete Felder

Weitere Informationen zu berechneten Feldern findest du im Referenzhandbuch zu berechneten Feldern.