Benutzerhandbuch Abbrechen

Adobe Acrobat Sign-Text-Tag-Guide

Suchen

Zuletzt aktualisiert am 3. Oktober 2022 | Gilt auch für Adobe Acrobat Sign

Adobe Acrobat Sign-Integrationen
Neue Funktionen
Produktversionen und Lebenszyklus
Acrobat Sign für Salesforce
Acrobat Sign für Microsoft
1. Acrobat Sign für Microsoft 365
  1. Installationshandbuch
2. Acrobat Sign für Outlook
  1. Benutzerhandbuch
3. Acrobat Sign für Word/PowerPoint
  1. Benutzerhandbuch
4. Acrobat Sign für Teams
5. Acrobat Sign für Microsoft PowerApps und Power Automate
  1. Benutzerhandbuch
  2. Versionshinweise
6. Acrobat Sign Connector für Microsoft Search
  1. Benutzerhandbuch
  2. Versionshinweise
7. Acrobat Sign für Microsoft Dynamics
8. Acrobat Sign für Microsoft SharePoint
Acrobat Sign für ServiceNow
Acrobat Sign für HR ServiceNow
1. Installationshandbuch
Acrobat Sign für SAP SuccessFactors
Acrobat Sign für Workday
Acrobat Sign für NetSuite
1. Installationshandbuch
2. Versionshinweise
Acrobat Sign für SugarCRM
Acrobat Sign für VeevaVault
Acrobat Sign für Coupa BSM Suite
1. Installationshandbuch
Acrobat Sign-Entwicklerdokumentation

Übersicht

Bei Adobe Acrobat Sign-Text-Tags handelt es sich um speziell formatierten Text, der an einer beliebigen Stelle im Inhalt Ihres Dokuments platziert werden kann und die Position, Größe und den Typ der Kontrollkästchen angibt, beispielsweise Signatur- und Initialfelder, Kontrollkästchen, Optionsfelder und Formularfelder sowie erweiterte optionale Feldverarbeitungsregeln. Text-Tags können auch beim Erstellen von PDFs mit Formularfeldern verwendet werden. Weitere Informationen finden Sie im Referenzhandbuch zum Erstellen von Formularen in Acrobat.

Text-Tag-Tutorial — Klicken Sie hier, um das Tutorial anzuzeigen

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:

{{Sig_es_:signer1:signature}}	Ein Signaturfeld, das dem als signer1 gekennzeichneten Empfänger zugewiesen ist.
{{Cmpy_es_:signer2:company}}	Ein Feld für den Unternehmensnamen des als signer2 gekennzeichneten Empfängers.
{{address_es_:signer1}}	Ein Feld des als signer1 gekennzeichneten Empfängers zum Eingeben seiner Adresse.
*{{city_es_:signer1}}**	Ein Pflichtfeld des als signer1 gekennzeichneten Empfängers zum Eingeben seines Orts.
{{!price}}	Ein schreibgeschütztes Feld. Empfänger können den Wert dieses Felds nicht ändern.

Acrobat Sign-Text-Tags bietet einen leistungsstarken Mechanismus für das Einrichten von Dokumentvorlagen, die das Positionieren von Signatur- und Initialfeldern, 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.

Hinweis:

Wenn vorhanden, wird auf spezifische Funktionen der Unternehmens- und/oder Enterprise-Dienstebenen hingewiesen.

Tag-Text-Kurzanleitung

Tag-Text-Beispiele

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

Signatur- und Initialenfelder

{{Sig_es_:signer1:signature}}	Ein Signaturfeld, das dem als signer1 gekennzeichneten Empfänger zugewiesen ist.
{{Int_es_:signer1:initials}}	Ein Initialenfeld, das dem als signer1 gekennzeichneten Empfänger zugewiesen ist.
{{SigB_es_:signer1:signatureblock}}	Ein Signaturblock, der dem als signer1 gekennzeichneten Empfänger zugewiesen ist.
{{OSig_es_:signer1:optsignature}}	Ein optionales Signaturfeld, das dem als signer1 gekennzeichneten Empfänger zugewiesen ist.
{{OInt_es_:signer1:optinitials}}	Ein optionales Initialenfeld, das dem als signer1 gekennzeichneten Empfänger zugewiesen ist.
{{SigStamp_es_:signer1:stampimage(25)}}	Ein Stempelfeld, das als Signaturmöglichkeit verwendet werden kann. Stempel sind nur dann erforderlich, wenn keine anderen Signaturfelder für den Unterzeichner vorhanden sind.

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.

{{Cmpy_es_:signer1:company}}	Ein Feld des als signer1 gekennzeichneten Empfängers zum Eingeben seines Unternehmensnamens.
{{N_es_:signer2:fullname}}	Ein schreibgeschütztes Feld des als signer2 gekennzeichneten Empfängers zum Eingeben seines vollständigen Namens.
{{Dte_es_:signer1:date}}	Ein schreibgeschütztes Feld, das das Datum der Signatur enthält.
{{Em_es_:signer1:email}}	Ein schreibgeschütztes Feld, das die E-Mail-Adresse des Unterzeichners enthält.

Hinweis:

Anstelle die Rollen „Absender“ und „Unterzeichner“ zu verwenden, besteht ein weiterer Ansatz darin, nur Rollen wie „signer1“, „signer2“, „signer3“ usw. zu verwenden. Stellen Sie sicher, dass diese Teilnehmer beim Senden des Dokuments in der richtigen Reihenfolge hinzugefügt werden.

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.

{{*Ttl_es_:sender:title}}

Ein Pflichtfeld, in das der Absender seinen Titel eingeben muss.

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.

Sie müssen dazu lediglich auf den Hyperlink klicken.

Felder vom Typ „Vorausfüllen“

{{price_es_:prefill}}

Ein Feld, das der Absender vor dem Senden des Dokuments ausfüllt.

Textfelder

{{address_es_:signer1}}	Ein optionales Feld des als signer1 gekennzeichneten Empfängers zum Eingeben seiner Adresse.
*{{city_es_:signer1}}**	Ein Pflichtfeld des als signer1 gekennzeichneten Empfängers zum Eingeben seines Orts.

Schreibgeschützte Felder

{{!price}}

Ein schreibgeschütztes Feld. Unterzeichner können seinen Wert nicht ändern.

Kontrollkästchen

{{[]}}	Ein Kontrollkästchen.
{{[x]}}	Ein standardmäßig aktiviertes Kontrollkästchen.

Optionsfelder

{{(Red)Color}}

Ein Optionsfeld, das bei Auswahl den Wert „Red“ aufweist.

Bilder

{{Image1_es_:signer1:inlineimage(4)}}

Ein Inline-Bildfeld mit einer Höhe von 4 Zeilen

Feldbestätigung

*{{Mobile_es_:signer1:phone}}**	Ein Pflichtfeld zur Eingabe der Telefonnummer, das das US-Telefonnummernformat zulässt.
{{d_es_:signer1:num(>0,<60)}}	Ein optionales Nummernfeld, das Werte zwischen 0 und 60 zulässt.

Bedingungsregeln

{{field_es_:showif(price>60)}}

Ein Feld, das angezeigt wird, wenn der „Preis“ einen Wert größer als 60 aufweist.

Berechnete Felder

{{TV_es_:calc([SubTotal]+[Tax])}}

Ein Feld, dessen Wert automatisch als Summe der Felder „SubTotal“ und „Tax“ berechnet wird.

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, lesen Sie 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 Sie kürzere Tags im Dokument angeben können.

Wenn Sie beispielsweise über ein Pflichtfeld zur Eingabe der Telefonnummer verfügen müssen, das dem Absender zugewiesen ist, können Sie, 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 finden Sie 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.

Hinweis:

Wenn ein Dokument mehr als ein Text-Tag mit demselben Namen, aber unterschiedlichen Direktiven aufweist oder wenn sich diese Direktive unter den Text-Tags desselben Namens in einer anderen Reihenfolge befinden, fügt Acrobat Sign automatisch „efield“ + eindeutige Zahl + „_“ am Anfang des Namens hinzu. Wenn beispielsweise zwei Felder namens „Address“ im Dokument angezeigt werden, ändert Acrobat Sign den Namen eines der Felder in „efield2_Address“.
Wenn zwei Text-Tags mit demselben Feldnamen und denselben Direktiven und identischer Reihenfolge der Direktiven in einem Dokument vorhanden sind, werden diese Felder als geklonte Felder behandelt. In ein Feld eingegebene Daten werden automatisch zur anderen Feldposition im Dokument geklont.

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.

{{Field2_es_:signer1}}

Ein Feld in der Vereinbarung, das dem ersten zugewiesen wird, der nicht der Absender der Vereinbarung ist.

{{Field3_es_:signer1}}

{{Field4_es_:signer2}}

Wenn für eine Vereinbarung mehr als ein Unterzeichner erforderlich ist und jeder Unterzeichner während der Signatur Daten angeben muss, können die Felder in der Vereinbarung mithilfe der Direktive „signer<x>“ zu spezifischen Unterzeichnern zugewiesen werden, wobei „<x>“ die Reihenfolge darstellt, in der die Unterzeichner die Vereinbarung signieren. Mit der Direktive „signer1“ markierte Felder sind dem ersten Unterzeichner zugewiesen. Mit der Direktive „signer2“ markierte Felder sind dem zweiten Unterzeichner zugewiesen usw. Acrobat Sign stellt sicher, dass ein Unterzeichner nur mit den Feldern interagieren kann, die ihm zugewiesen sind.

Wenn der Absender der Vereinbarung während der Signatur als Erstes signiert, werden dem Absender als „signer1“ markierte Felder zusätzlich zum als „Absender“ markierten Feld angezeigt.

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.

{{Field5_es_:prefill}}

Ein Feld in der Vereinbarung, das vom Absender ausgefüllt werden muss, bevor die Vereinbarung zur Signatur gesendet wird.

Hinweis:

„Vorausfüllen“ ist standardmäßig für Dokumente aktiviert, die in Ihre Acrobat Sign-Dokumentenbibliothek hochgeladen sind. „Vorausfüllen“ kann auch durch Aktivieren der Option „Vorschau und Signatur hinzufügen“ beim Senden von Dokumenten aktiviert werden. Wenden Sie sich an den Adobe-Support, um „Vorausfüllen“ für alle über die Seite „Senden“ gesendeten Vereinbarungen zu aktivieren, und zwar unabhängig davon, ob die Option „Vorschau“ aktiviert ist.

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.

{{Address}}	Ein Feld in einer Vereinbarung, das von einem Unterzeichner ausgefüllt werden kann.
{{zip_es_:zip4}}	Ein Feld in einer Vereinbarung für einen Unterzeichner zum Eingeben in einer Postleitzahl mit Validierung.

Hinweis:

Wenn ein nicht zugewiesenes Feld als „Erforderlich“ gekennzeichnet ist, muss der erste Empfänger den Wert eingeben.

Unter Kontoeinstellungen > Sendeeinstellungen gibt es eine Option zum Ändern der Kombination aus nicht zugewiesenen und erforderlichen Feldern. Damit kann festgelegt werden, dass das Feld nur für den letzten Empfänger erforderlich ist.

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.