Benutzerhandbuch Abbrechen

Liquid Mode für mobiles Websigniererlebnis

 

Adobe Acrobat Sign-Handbuch

Neue Funktionen

Erste Schritte

Verwaltung

Senden, Signieren und Verwalten von Vereinbarungen

Erweiterte Vereinbarungsfunktionen und Workflows

Integration in andere Produkte

Acrobat Sign-Entwickler

Support und Fehlerbehebung

Einführung

Das Liquid Mode-Signiererlebnis verbessert die Anzeige Ihrer Dokumente je nach Gerätetyp des Empfängers. Verkleinern und Vergrößern ist nicht mehr erforderlich und Sie können sich voll und ganz auf die Felder konzentrieren, die ausgefüllt werden müssen.

Liquid Mode-konforme Vereinbarungen werden mit zwei Ansichten für den Empfänger generiert:

  1. PDF-Ansicht: Diese enthält alle Formatinformationen, die im hochgeladenen HTML-Dokument vorhanden sind. Die Ansicht entspricht der unterzeichneten Fassung der Vereinbarung, die zum Download zur Verfügung steht – genau wie die PDF-Ansicht, die Adobe Acrobat Sign für alle Vereinbarungen generiert.
  2. Liquid Mode-Ansicht : Diese fließfähige Ansicht formatiert das eingegebene HTML-Dokument um und ist damit optimal für kleine Bildschirmgrößen geeignet. Die Liquid Mode-Ansicht bietet ein stark kuratiertes Erlebnis, das das im ursprünglichen HTML-Dokument angegebene Format außer Kraft setzt.

Über die Benutzeroberfläche kann der Empfänger je nach Präferenz einfach zwischen der Liquid Mode- und der herkömmlichen PDF-Ansicht des Dokuments wechseln und jeweils dieselben rechtsverbindlichen Signaturen erfassen, die Sie erwarten.

 

Liquid Mode-konforme Vereinbarungen werden mit einer einzigen HTML-Datei als Quellinhalt erstellt.

Es gibt einige Einschränkungen für die HTML- und Formularfeldkonstrukte im hochgeladenen HTML-Dokument. Das heißt:

  • Die Vereinbarung muss mit einem einzigen HTML-Dokument (nur einer Datei) erstellt werden.
    • Wenn zum Erstellen der Vereinbarung mehrere Dokumente verwendet werden, wird nur eine PDF-Ansicht generiert.
  • Das HTML-Dokument darf kein JavaScript enthalten. Die Verwendung von <script>-Tags, entweder als Inline-JavaScript oder als Referenz auf externe JavaScript-Dateien oder in Attributen von HTML-Tags, ist nicht zulässig.
    • Wenn JavaScript im HTML-Dokument erkannt wird, erstellt Acrobat Sign nur die PDF-Ansicht.
  • Das HTML-Dokument darf nur unterstützte HTML-Tags im <body> des HTML-Dokuments verwenden, die im Abschnitt Unterstützte HTML-Tags beschrieben sind.
    • Wenn nicht unterstützte HTML-Tags im Textkörper des HTML-Dokuments vorhanden sind, erstellt Acrobat Sign nur die PDF-Ansicht.

Da die Liquid Mode-Ansicht ein sehr kuratiertes Erlebnis bietet, werden CSS-Anweisungen in der HTML-Datei ignoriert (NUR in der Liquid Mode-Ansicht); die Liquid Mode-Ansicht wird nur von den Attributen der unterstützten HTML-Tags beeinflusst. Für die PDF-Ansicht gelten diese Einschränkungen nicht. Um die PDF-Ansicht zu generieren, verwendet Acrobat Sign die gesamte Palette an Attributen, die für die unterstützten Tags verfügbar sind, sowie die im HTML-Dokument angegebenen CSS-Anweisungen.

Um die Formularfelder im HTML-Dokument anzugeben, wird die Schreibweise für Adobe Acrobat Sign-Text-Tags verwendet.

Liquid Mode-Workflow

Hinweis:

Wenn die Liquid Mode-Funktion aktiviert ist, aber die Liquid Mode-Ansicht aus einem beliebigen Grund nicht generiert werden kann, wird die Vereinbarung nur mit der PDF-Ansicht erstellt.

In der Bestätigungs-E-Mail an den Absender werden die Gründe aufgeführt, aus denen die Liquid Mode-Ansicht nicht generiert werden konnte.

Der Liquid Mode wird derzeit auf Mobiltelefonen unterstützt, wobei die Unterstützung zusätzlicher Geräte in Entwicklung ist.


Aktivieren/Senden von Liquid Mode-konformen Vereinbarungen

  1. Stellen Sie sicher, dass der Liquid Mode im Menü „Acrobat Sign-Admin“ aktiviert ist:

    • Navigieren Sie zu  Sendeeinstellungen > Liquid Mode.
      • Die Einstellung kann auf Konto- oder Gruppenebene geändert werden.
    Navigieren Sie zu den Liquid Mode-Optionen.

  2. Senden einer einzelnen HTML-Datei mit einer der folgenden Methoden:

    HTML-Dokument senden


Unterstützte HTML-Tags

Um eine Vereinbarung mit der Liquid Mode-Ansicht erfolgreich zu erstellen, darf das HTML-Dokument keine JavaScript-Konstrukte enthalten.

Nur die folgenden Tags dürfen im Textkörper des HTML-Dokuments verwendet werden:

Kategorie

HTML-Tags

Attribute, die sich auf die Liquid Mode-Ansicht auswirken

Einschränkungen

Überschriften

<h1>, <h2>, <h3>, <h4>, <h5>, <h6>

KEINE

 

Inhalt

<div>

align

 

Zeilenumbruch

<br>

KEINE

 

Horizontale Linie

<hr>

KEINE

 

Absatz

<p>

align

 

Bilder

<img>

src, alt, Höhe, Breite

Siehe Abschnitt „Bildunterstützung

Inline-Text

<b>, <i>, <u>, <s>, <strong>, <em>, <span>, <sub>, <sup>

KEINE

 

Geordnete Liste

<ol>, <li>

value, type, reversed, start

 

Ungeordnete Liste

<ul>, <li>

value, reversed, start

 

Hyperlink

<a>

href

Das URL-Protokoll ist auf http, https und mailto beschränkt

Tabelle

<table>, <thead>, <tbody>, <tfoot>, <th>, <tr>, <td>, <caption>, <col>, <colgroup>

KEINE

1. Verschachtelte Tabellen werden NICHT unterstützt.

2. Formularfelder innerhalb von Tabellen werden NICHT unterstützt.

Formularfeldbeschriftung

<label>

nach

Siehe Abschnitt Formularfeldbeschriftungen.

Formularfeldgruppierung

<fieldset>, <legend>

KEINE

Siehe Abschnitt Beschriftung von Feldgruppen.

Bilder

<img>

src, alt, Höhe, Breite

Die Größe des Bildes und der gesamten HTML-Datei sollte weniger als 400 KB betragen. Die folgenden Formate werden unterstützt JPEG, PNG, GIF, BMP und TIFF. Die Bildquelle muss eine HTTPs-URL sein.


Formularfeldspezifikation

Formularfelder müssen im HTML-Dokument mit der Schreibweise für Adobe Acrobat Sign-Text-Tags angegeben werden.

In der folgenden Tabelle sind Beispiele für Formularfelder mit Acrobat Sign-Text-Tags aufgeführt:

Feld

Sign-Text-Tags

Signaturfelder (Signatur, Initialen, Signaturblock, Stempel)

{{Sig_es_:signer1:signature}}



{{Int_es_:signer1:initials}}



{{SigB_es_:signer1:signatureblock}}



{{OSig_es_:signer1:optsignature}}



{{OInt_es_:signer1:optinitials}}



{{SigStamp_es_:signer1:stampimage(25)}}

Unterzeichnerfelder

{{Cmpy_es_:signer1:company}}



{{N_es_:signer2:fullname}}



{{Dte_es_:signer1:date}}



{{Em_es_:signer1:email}}

Absenderfelder

{{*Ttl_es_:sender:title}}

Teilnahmestempel und Transaktions-ID

{{userstamp_es_:signer1:stamp:repeat}}

{{transstamp1_es_:transactionid:repeat}}

Schreibgeschütztes Feld

{{!price}}

{{price_es_:readonly}}

Texteingabe

{{address_es_:signer1}}

{{*city_es_:signer1}}

Kontrollkästchen

{{CB1_es_:checkbox(checked)}}

Optionsschalter

{{(Red)Color_es_:signer1:label(“Red”)}}

{{(Blue)Color_es_:signer1:label(“Blue”)}}

{{(Green)Color_es_:signer1:label(“Green”)}}

Bild

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

Dropdown

{{Color_es_:signer1:dropdown(options="Red,Green,B lue”, values=”R,G,B”)}}


Hyperlink

{{companywebsite_es_:link(http://www.adobe.com):label(Adobe)}}


Dateianhang

{{*DriversLicense_es_:signer1:attachment}}

QuickInfo

{{Car_color_es:signer1:tooltip('Farbe auswählen')}}

Digitale Signatur

{{digsig1_es_:signer1:digitalsignature}}

Feldbestätigung

{{*Mobile_es_:signer1:phone}}

{{d_es_:signer1:num(>0,<60)}}

Bedingungsregeln

z. B. {{field_es_:showif(price>60)}}

Berechnete Felder

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

Hinweis:

Alle Acrobat Sign-Formularfeldkonstrukte werden unterstützt, mit Ausnahme der folgenden:

Kategorie

Nicht unterstützte Konstrukte

Ausnahmen

Formularfeld für digitale Signatur

:digitalsignature wird nicht unterstützt



Workflows für die Vorausfüllung

Die Direktive :prefill wird nicht unterstützt.



Hyperlink-Formularfeld

Die Direktive :page(N) wird nicht unterstützt.

:link mit anderen Protokollen als http, https and mailto.

Die Direktiven :signer1 und :everyone werden unterstützt.

Unbenannte Formularfelder

Unbenannte Formularfelder werden nicht unterstützt.

Unbenannte Kontrollkästchen werden unterstützt.

Umbenannte Formularfelder

Mehrere Formularfelder mit demselben Namen, aber unterschiedlichen Direktiven werden nicht unterstützt.




Formularfeldbeschriftungen

Jedem Formularfeld sollte eine Beschriftung zugeordnet sein. Obwohl die Beschriftungen nicht für jedes Formularfeld vorgeschrieben sind, wird dringend empfohlen, Formularfelder mit Beschriftungen zu versehen.

Insbesondere im Liquid Mode gilt:

  • Eine Beschriftung dient zur Verbesserung der visuellen Darstellung des Felds.
  • Eine Beschriftung, die einem Feld zugeordnet ist, unterstützt die Barrierefreiheitsfunktion. Wenn der Fokus auf ein Feld gesetzt wird, kann ein Bildschirmleser dem Benutzer anhand der Beschriftung mitteilen, um welches Feld es sich handelt.
  • Sie können auf eine Beschriftung klicken, um den Fokus auf ein Feld zu setzen. Wenn Sie bei einem Optionsfeld oder einem Kontrollkästchen auf die Beschriftung klicken, wird der Wert umgeschaltet.

Formularfelder können mit dem HTML-Tag <label> auf eine der folgenden Weisen an Beschriftungen gebunden werden:

  1. Acrobat Sign-Formularfeld in einem <label>-Tag
    • <label>-Signatur: {{sig_es_:signer1:signature}}</label>
  2. Das Attribut „for“ des <label>-Tags kann sich auf den Namen des Formularfelds beziehen, um ihn an ein Formularfeld zu binden.
    • {{sig_es_:signer1:signature}} … <label for=”sig”>Signatur: </label>

Beschriftungen, die nicht mithilfe der oben genannten Regeln an Formularfelder gebunden werden können, werden als ungebundener Beschriftungstext wiedergegeben.

Darüber hinaus unterstützen Acrobat Sign-Text-Tags die Direktive :label für die folgenden Formularfeldtypen:

  • Dateianlagen
  • Hyperlinks
  • Kontrollkästchen
  • Optionsfelder

Die Acrobat Sign Text-Tag-Direktive :label und <label> können auf folgende Weise kombiniert werden:

Formularfeldtyp

Rolle der :label-Direktive

Rolle des HTML-Tags <label>

Dateianlagen,

Hyperlinks

Gibt die Beschriftung an, die im Feld „Formularfeld“ angezeigt wird.

Das <label>-Tag gibt die Beschriftung oder Überschrift des Formularfelds an.

Kontrollkästchen,

Optionsfeld

Gibt die Beschriftung oder Überschrift des Formularfelds an.

Wenn die Acrobat Sign-Text-Tag-Direktive :label fehlt, tritt <label> für das Formularfeld an ihre Stelle.

Wenn sowohl :label als auch <label> vorhanden sind, kann die Liquid Mode-Ansicht nicht erstellt werden.

Beispiele:

  • {{CB_es_:checkbox: signer1:label("I agree.")}}} <label for=” CB”> Yes</label>
  • {{(Red_v)Color_es_:signer1::label(“Red Color”)} <label for=”(Red_v)Color”>Red</label>
Hinweis:

Beschriftungen für Kontrollkästchen können auf folgende Weise angegeben werden:

  • {{CB_es_:checkbox: signer1:label("I agree.")}}
  • <label> {{CB_es_:checkbox:signer1}} Ich stimme zu.</label>
  • {{CB_es_:checkbox:signer1}} <label for="CB"> Ich stimme zu.</label>

Beschriftungen für Optionsfelder können auf folgende Weise angegeben werden:

  • {{(Red_v)Color_es_:signer1:label(“Red”)}}
  • <label> {{(Red_v)Color_es_:signer1}} Red </label>
  • {{(Red_v)Color_es_:signer1}} <label for=”(Red_v)Color”>Red</label>
Vorsicht:

In der Regel bezieht sich in HTML das Attribut „for“ auf einen Feld-ID-Wert.  Der Liquid Mode verwendet das Attribut „for“, um auf Feldnamen zu verweisen.  Dies kann zu Mehrdeutigkeiten bei geklonten Formularfeldern führen, wenn mehrere Instanzen von Formularfeldern mit genau derselben Acrobat Sign-Text-Tag-Direktive vorhanden sind.  In diesem Fall ist die Verwendung des Attributs „for“ zu vermeiden. Die Zuordnung von Beschriftungen erfolgt, indem das Text-Tag in ein <label>-Element eingeschlossen wird.

Die folgende Verwendung erstellt beispielsweise geklonte Formularfelder mit unterschiedlichen Beschriftungen für jede der beiden Instanzen in der mobilen Ansicht „Umfließen“:

  • <label> Offizielle Person {{name_of_official_es_:signer1}} </label>
  • <label> Name {{name_of_official_es_:signer1}} </label>

Wenn in einem geklonten Formularfeld eine Beschriftung mit einem „for“-Attribut angegeben wird, sind die Referenzen mehrdeutig und können nicht aufgelöst werden.  In diesem Fall wird keine Liquid Mode-Ansicht erstellt.

 Beispielsweise wird bei der folgenden Verwendung nur eine PDF-Ansicht erstellt:

  • <label for="name_of_official> Offizielle Person </label> {{name_of_official_es_:signer1}}
  • <label for="name_of_official> Name</label> {{name_of_official_es_:signer1}}


Beschriftung von Feldgruppen

Beschriftungen sind einem einzelnen Formularfeld zugeordnet. Wenn eine Beschriftung/ein Titel einer Gruppe von Feldern (insbesondere einer Gruppe von Optionsfeldern) zugeordnet werden soll, empfehlen wir die Verwendung von fieldset- und legend-Elementen.  Das fieldset-Element wird zur Gruppierung der Elemente verwendet und das legend-Element wird verwendet, um einen Titel/eine Beschriftung für die Gruppe anzugeben.  Ähnlich wie bei der Beschriftung ergeben sich folgende Vorteile im Liquid Mode:

  • Eine bessere visuelle Darstellung eines mit der Feldgruppe verknüpften Titels/Überschrift
  • Ein gutes Barrierefreiheitserlebnis.  Bildschirmleser können die Feldgruppe anhand des legend-Inhalts korrekt wiedergeben.

Beispiel:

<fieldset>

        <legend>Bevorzugte primäre Farbe auswählen</legend>

        {{(Red)Color_es_:signer1:label("Red")}}<br/>

        {{(Blue)Color_es_:signer1:label("Blue")}}<br/>

        {{(Green)Color_es_:signer1:label("Green")}}<br/>

</fieldset>

Hinweis:

In der Regel wünschen sich Autoren bei den meisten Dokumenten nicht die Standardwiedergabe des fieldset-Tags. 

Der Begrenzungsrahmen kann mit diesem CSS entfernt werden:

    fieldset {

        border: none;

        margin: 0;

        padding: 0;

    }

Bildunterstützung

Bilder werden mit den folgenden Einschränkungen unterstützt:

  • Nur das Element <img> wird unterstützt
  • Die Quelle eines <img> kann als eingebettete Daten („Data:Schema“) oder als Web-URL („https:Schema“) bereitgestellt werden.
  • Die folgenden Formate werden unterstützt:JPEGPNGGIFBMP und TIFF
    • Bei animierten GIFs wird der erste Frame als statisches Bild verwendet
  • Die Größe eines von einer Web-URL abgerufenen Bildes ist auf 5 MB begrenzt


Nicht unterstützte Acrobat Sign-Workflows

Der Liquid Mode unterstützt nicht die folgenden Acrobat Sign-Workflows:

  • Vereinbarungen, die aus mehreren Dokumenten erstellt wurden
  • Vereinbarungen, die aus anderen Dokumenten als HTML-Dokumenten erstellt wurden
  • Vereinbarungen, die aus Bibliotheksvorlagen erstellt wurden
  • Vereinbarungen, die im Status ENTWURF oder AUTHORING erstellt wurden
  • Workflows für digitale Signaturen
  • Workflows für schriftliche Signaturen
  • Workflows für die Änderung von in Bearbeitung befindlichen Dokumenten
  • Workflows aus Gruppen, bei denen das Kontrollkästchen „Vorschau“ standardmäßig aktiviert ist
  • Vereinbarungen, für die „Gründe für die Signatur“ aktiviert ist
  • Vereinbarungen, die so konfiguriert sind, dass der Unterzeichner jedes Mal zur Authentifizierung aufgefordert wird, wenn er auf ein Signaturfeld klickt

Wenn versucht wird, im Rahmen der oben genannten Workflows eine Liquid Mode-Ansicht zu erstellen, wird nur eine Vereinbarung mit der PDF-Ansicht erstellt.  In der Bestätigungs-E-Mail an den Absender sind die Gründe aufgeführt, warum die Liquid Mode-Ansicht nicht generiert werden konnte.


Benachrichtigung bei Liquid Mode-Fehler

Wenn der Absender versucht hat, eine Vereinbarung mit einer Liquid Mode-Ansicht zu erstellen, Acrobat Sign diese jedoch nicht generieren konnte, wird der Absender in der Bestätigungs-E-Mail der Vereinbarung darüber benachrichtigt, welche konkreten Probleme dazu geführt haben, dass die Liquid Mode-Ansicht nicht erstellt werden konnte. Der Absender kann die gemeldeten Probleme beheben und anschließend versuchen, die Vereinbarung mit einer Liquid Mode-Ansicht zu erstellen.

Die gemeldeten Probleme lassen sich in die folgenden Kategorien unterteilen:

  • Nicht unterstützte HTML-Konstrukte
  • Nicht unterstützte Acrobat Sign-Text-Tags
  • Nicht unterstützte Acrobat Sign-Workflows
  • Interner Liquid Mode-Fehler

Interne Liquid Mode-Fehler treten auf, wenn der Server bei dem Versuch, die Liquid Mode-Ansicht zu erstellen, unerwartete Fehlerbedingungen feststellt.

Für die anderen Fehlerkategorien finden Sie Einzelheiten zu den gemeldeten Problemen in den folgenden Unterabschnitten:


HTML-Beispieldokument: Anforderung einer Kreditauskunft

Bei Formularen mit den folgenden Eigenschaften ist die Erstellung des Liquid Mode hauptsächlich angezeigt:

  • Dokumente mit großen Textblöcken, die ein hohes Maß an Verkleinerung und Vergrößerung erfordern
  • Formulare, bei denen sich die Felder nicht überschneiden und der Fluss der Felder im Liquid Mode zulässig ist


Bekannte Probleme und FAQ

Schneller und einfacher Hilfe erhalten

Neuer Benutzer?