Text-Tags – Grundlagen und Syntax

Verstehe die exakte Struktur, die Text-Tags benötigen, damit deine Felder korrekt erkannt werden und sich wie erwartet verhalten.

Text-Tags ermöglichen es dir, Formularfelder anzulegen, indem du strukturierte Platzhalter direkt in dein Dokument eingibst. Sie sind schnell und leistungsstark, funktionieren aber nur, wenn die Syntax exakt ist.

Diese Seite erklärt die erforderliche Struktur eines Text-Tags, was jeder Teil bewirkt und welche Regeln befolgt werden müssen, damit Tags korrekt erkannt werden.

Erforderliche Tag-Umschließung (geschweifte Klammern)

Jeder Text-Tag muss in doppelte geschweifte Klammern eingeschlossen werden:

{field-name_es_:signer-role:field-type:directive1:directive2}}

Die geschweiften Klammern sind erforderlich und erfüllen zwei Zwecke:

• Sie teilen Acrobat Sign mit, wo der Text-Tag beginnt und endet.
• Sie definieren die anfängliche Breite und Höhe des generierten Felds.
  • Die Größe (Schriftgrad) der ersten Klammer bestimmt die Feldhöhe. 
    • Ein größerer Schriftgrad bei der ersten Klammer erzeugt höhere Felder.
    • Der Rest des Tags kann einen anderen Schriftgrad haben, muss aber 2 pt oder größer sein.
  • Der Abstand zwischen den Klammern (einschließlich der Klammern selbst) bestimmt die Gesamtbreite des Felds. 
    • Größerer Abstand zwischen den Klammern erzeugt breitere Felder
    • Leerzeichen zählen.

Wenn die geschweiften Klammern fehlen oder fehlerhaft sind, wird der Text als einfacher Text behandelt, es wird kein Feld erstellt und du siehst den Text des Tags auf deinem Formular, nachdem es hochgeladen wurde.

Für eine breiter gefasste Übersicht darüber, wie Text-Tags funktionieren und wann du sie verwendest, siehe Text-Tags-Übersicht.

Die erforderliche Struktur eines Text-Tags

Innerhalb der geschweiften Klammern muss jeder Text-Tag dieser Struktur folgen:

field-name_es_:signer-role:field-type:directive1:directive2

Diese Struktur ist strikt. Das Umordnen von Elementen oder das Weglassen erforderlicher Teile kann zu stillem Versagen oder unbeabsichtigtem Verhalten führen.

Erforderliche Elemente (in der Reihenfolge)

Feldname

Der Feldname identifiziert das Formularfeld in Acrobat Sign.

• Muss innerhalb des Dokuments eindeutig sein.
• Sollte keine Leerzeichen enthalten.
• Wird für Berichte und Datenextraktion verwendet.

_es_-Bezeichner

Der _es_ Bezeichner teilt Acrobat Sign mit, dass der Text einen Text-Tag darstellt.

• _es_ ist erforderlich.
• Ohne ihn wird der Tag als einfacher Text behandelt.

Rollen für Unterzeichnende

Die Unterzeichner-Rolle definiert, zu welchem Empfänger das Feld gehört.

• Schließe immer eine Unterzeichner-Rolle ein.
• Die Unterzeichner-Rolle muss eine Nummer enthalten, um anzugeben, für welchen Empfänger das Feld bestimmt ist. 

Unterstützte Unterzeichner-Rollen

Text-Tags weisen Felder Empfängern mithilfe von positionellen Unterzeichner-Rollen zu.

Das unterstützte Unterzeichner-Rollen-Format ist:

:signerN

Wobei N eine Zahl ist, die bei 1 beginnt und der Position des Empfangenden in der Unterzeichnungsreihenfolge entspricht.

Beispiele:

• :signer1 – erster Empfangender
• :signer2 – zweiter Empfangender
• :signer3 – dritter Empfangender

Text-Tags selbst setzen kein oberes Limit. Eine Unterzeichnerrolle muss einem tatsächlichen Empfangenden in der Vereinbarung entsprechen, damit das Feld zugewiesen werden kann.

Text-Tags unterstützen keine benannten oder semantischen Rollen. Nur positionelle Unterzeichnerrollen werden erkannt.

Die Ausnahme von der Regel ist die :prefill-Rolle:

• :prefill: Felder, die dem Sendenden der Vereinbarung zugewiesen sind und ausgefüllt werden müssen, nachdem die Vereinbarung gesendet wurde, aber bevor der erste Unterzeichner benachrichtigt wird.
  • Es wird keine Zahl verwendet, da diese Position vor dem eigentlichen Unterzeichnungszyklus stattfindet.

Feldtyp

Der Feldtyp bestimmt den Typ des Formularfelds, das erstellt wird.

Häufige Beispiele sind:

• :text
• :signature
• :date
• :checkbox

Nur unterstützte Feldtypen werden erkannt. Nicht unterstützte Feldtypen werden ignoriert.

Die vollständige Liste und feldspezifisches Verhalten findest du unter Unterstützte Feldtypen für Text-Tags.

Direktiven (optional)

Direktiven ändern das Verhalten des Felds.

Beispiele:

• :required
• :tooltip()
• :readOnly
• :calc()
• :format()

Direktiven müssen nach dem Feldtyp erscheinen und der korrekten Syntax folgen.

Für komplexe Direktiven-Interaktionen siehe Erweiterte Verhaltensweisen von Text-Tags.

Beispiel: ein vollständiger, gültiger Text-Tag

{full_name_es_:signer1:text:required:tooltip(Geben Sie die vollständige juristische Bezeichnung)}}

Dieser Tag:

• Verwendet geschweifte Klammern, um die Feldgrenze und -größe zu definieren
• Erstellt ein Textfeld
• Weist sie dem ersten Unterzeichner zu
• Macht es erforderlich
• Zeigt dem Unterzeichner eine QuickInfo an

Für weitere einfache und zusammengesetzte Beispiele siehe Beispiele für Text-Tags.

Wichtige Regeln, die du früh verstehen solltest

Text-Tags sind absichtlich streng. Beachte diese Regeln:

• Tags werden verarbeitet, wenn das Dokument hochgeladen wird.
• Es gibt keine Validierung zur Erstellungszeit.
• Fehler erzeugen keine Warnungen.
• Fehlerhafte Tags werden als normaler Text behandelt.

Wenn etwas nicht funktioniert, nimm zuerst ein Syntaxproblem an und überprüfe Text-Tags-Fehlerbehebung.