Berechnete Felder zu einem Formular hinzufügen

Adobe Acrobat Sign bietet die Fähigkeit, die Felder in einem Dokument (Vereinbarung) auf Grundlage der durch den Unterzeichner beim Signieren der Vereinbarung eingegebenen Daten dynamisch zu aktualisieren. Dies kann mithilfe von Berechnete Felder vorgenommen werden. Du kannst berechnete Felder verwenden, um Regeln in einem Dokument (oder eine Dokumentvorlage) einzurichten, bevor du es zur Signatur sendest. Diese Regeln werden verarbeitet, wenn der Unterzeichner mit dem Dokument interagiert und das Dokument anhand der Felder/Werte dynamisch aktualisiert.

Berechnete Felder können in Dokumenten mithilfe der folgenden Mechanismen definiert werden:

• Acrobat Sign-Formular-Authoring-Umgebung
• Acrobat Sign-Text-Tags (weitere Informationen findest du in der Text-Tag-Dokumentation)
• Adobe Acrobat PDF-Formularfelder (weitere Details findest du unter Erstellen von Formularen im Acrobat-Referenzhandbuch)

Anwendungsfälle für berechnete Felder

Berechnete Felder können in Szenarien verwendet werden, wo das Dokument dynamisch während der Signatur aktualisiert werden muss. Im Folgenden findest du einige beispielhafte Anwendungsfälle, in denen berechnete Felder verwendet werden können. Diese Anwendungsfälle dienen nur zur Veranschaulichung.

1. Einrichten eines Bestellformulars: Berechnete Felder können verwendet werden, um ein Bestellformular einzurichten, in dem der Unterzeichner aus der Liste der verfügbaren Artikel auswählen und eine Menge angeben kann. Durch die Auswahl eines Artikels aus der Liste wird das Formular automatisch mit dem Preis des ausgewählten Artikels aktualisiert. Die vom Unterzeichner ausgewählte Menge führt zudem dazu, dass die Gesamtkosten des Artikels automatisch berechnet werden. Das Formular kann zudem zusätzliche Berechnungen für das Bestimmen des Gesamtsteuersatzes in der Bestellung oder für das Berechnen eines Mengenrabatts auf Grundlage von Geschäftsregeln für das Anbieten von Kundenrabatten aufweisen.

2. Automatisches Auffüllen des Ablaufdatums der Vertragslaufzeit: Für Vereinbarungen, die Kunden die Auswahl der Vertragslaufzeit des Vertrags zum Zeitpunkt der Signatur (6 Monate, 12 Monate, 24 Monate usw.) ermöglichen, kann ein berechnetes Feld verwendet werden, um das Enddatum des Vertrags anhand der vom Kunden zum Zeitpunkt der Vertragsunterzeichnung getroffenen Auswahl automatisch aufzufüllen.

3. Beitrittsformulare mit mehreren Auswahlmöglichkeiten: Ein berechnetes Feld kann verwendet werden, um Beitrittsformulare (wie Mitgliedschaftsformulare) auszuwählen, in denen eine das Formular signierende Person aus einem Satz an verfügbaren Optionen auswählen kann. Die vom Unterzeichner getroffenen Auswahlen können andere dynamische Aspekte von Formularen steuern, beispielsweise die Bedingungen, denen der Unterzeichner zustimmt, die Vertragsdauer und auch die Gesamtkosten.

Grundlagen zu berechneten Feldern

Jedes Formularfeld, Kontrollkästchenfeld oder Optionsfeld in Acrobat Sign-Formular kann als ein berechnetes Feld markiert werden. Während der Signatur kann der Unterzeichner keinen Wert direkt in ein Feld eingeben, das als ein berechnetes Feld vorgesehen ist. Der Wert des Felds wird automatisch anhand der im Formular definierten Regeln berechnet.

Die Definition eines berechneten Felds besteht aus zwei Teilen: dem Ausdruck und dem Format.

Berechnete Felder können mithilfe von Acrobat Sign-Text-Tags, mithilfe der Acrobat Sign-Webanwendung oder mithilfe von PDF-Formularfeldern definiert werden. Bei Verwendung von Acrobat Sign-Text-Tags oder von PDF-Formularfeldern zum Definieren berechneter Felder wird der Ausdruck für die Berechnung mithilfe der Direktive calc definiert. Die Formatierung des berechneten Felds kann mithilfe der Direktive format angegeben werden.

Beispiel

{{einberechnetesFeld_es_:signer1:calc(einAusdruck):format(formatType, einFormat)}}

In diesem Beispiel werden die zum Definieren eines Felds in einem Dokument namens „einberechnetesFeld“ verwendeten Text-Tags gezeigt. Dieses Feld ist dem als „signer1“ gekennzeichneten Empfänger zugewiesen. Der Wert dieses Felds wird anhand der in „einAusdruck“ angegebenen Formel berechnet. Der Typ des Ergebniswerts wird durch den Parameter „formatType“ angegeben und anhand des als „einFormat“ formatierten Formats definiert.

Die Authoring-Umgebung der Acrobat Sign-Webanwendung verfügt über einen vollständig funktionalen Ausdrucksgenerator zum Definieren von Formeln für berechnete Felder. Weitere Informationen zum Erstellen von Ausdrücken findest du unter Den Ausdrucksgenerator zum Angeben von berechneten Feldern verwenden.

Ausdrücke für das berechnete Feld

Der Ausdruck definiert die Formel/Regel für das Bestimmen des Werts des berechneten Felds. Ein Ausdruck kann aus mindestens einem der folgenden Elemente bestehen:

Unterstützte Operatoren

Die folgenden Operatoren werden in berechneten Feldern unterstützt.

Unterstützte Funktionen

Die folgenden Funktionen werden unterstützt, wenn Ausdrücke in einem berechneten Feld angegeben werden.

Akzeptierte Werte für Teile der Datumsangaben

Die folgenden Werte können in datumsbezogenen Funktionen verwendet werden, wenn der Teil des Datums angegeben wird, an dem die Funktion ausgeführt werden sollte.

Formatierung für berechnete Felder

Zusätzlich zur Angabe des Ausdrucks für ein berechnetes Feld kann der Ausgabewert ebenfalls formatiert werden. Die Ausgabe kann als Text (Standard) oder als eine Zahl oder ein Datum formatiert werden.

Bei der Verwendung mit Text-Tags übernimmt die Format-Direktive zwei Argumente: „FormatType“ und „Format“.

Berechnete Felder als Zahlen formatieren

Die folgenden Zeichen können verwendet werden, um die Formatierung einer Ausgabe in Form einer Zahl anzugeben.

Berechnete Felder als Datumsangaben formatieren

Die folgenden Zeichen können verwendet werden, um die Formatierung einer Ausgabe in Form eines Datums anzugeben.

Formatierungsbeispiele

In den folgenden Beispielen wird gezeigt, wie berechnete Datums- und Zahlenfelder formatiert werden.

• Ein als Datum formatiertes berechnetes Feld:

{{myField_es_:calc(otherDateField + 3):format(date, "mmm dd, yyyy")}}

Die Ausgabe sieht in etwa so aus: „Mai 22, 2016“.

• Ein als Zahl formatiertes berechnetes Feld.

{{myTax_es_:calc(total * taxrate):format(number, "$,.00") }}

Die Ausgabe sieht in etwa so aus: „1.987,65 $“.

Den Ausdrucksgenerator zum Angeben von berechneten Feldern verwenden

Berechnete Felder können über die Acrobat Sign-Authoring-Umgebung angegeben werden. Die nachfolgenden Schritte führst du durch das Definieren eines berechneten Felds, sobald du dich in der Authoring-Umgebung befindest.

1. Ziehe ein Feld und lege es im Dokument ab. Doppelklicke auf das Feld, das du gerade hinzugefügt hast, um das Dialogfeld mit den Feldeigenschaften anzuzeigen. Benenne das Feld entsprechend. Ändere das Attribut Werttyp mithilfe der Dropdownliste so, dass es vom Typ Berechneter Wert ist. Dies gibt an, dass der Feldwert anhand einer Berechnung zum Zeitpunkt der Signatur bestimmt wird.

2. Gib den Berechnungsausdruck im Textfeld Formel ein oder klicke auf die Funktionsschaltfläche ( fx ), um den Ausdrucksgenerator anzuzeigen.

3. Verwende den Ausdrucksgenerator zum Definieren des Ausdrucks für das berechnete Feld (siehe folgende Abbildung). Der oben gezeigte Ausdrucksbereich zeigt die Formel, die verwendet wird, um den Wert des Felds zu berechnen. Du kannst die Formel in den Ausdrucksbereich eingeben oder die Authoring-Umgebung verwenden, um die Formel zu erstellen. Der Ausdrucksgenerator bietet eine Liste sämtlicher verfügbarer Funktionen, eine Liste der vorhandenen Formularfelder im Dokument und eine Liste der unterstützten Operatoren für die Unterstützung bei der Erstellung von Ausdrücken. Du kannst einer Formel ein Feld oder eine Funktion hinzufügen, indem du im Listenbereich des Ausdrucksgenerators doppelt auf das Element klickst. Du kannst dem Ausdruck auch Operatoren hinzufügen, indem du in der Operatorenliste auf den entsprechenden Operator klickst.

4. Nachdem du das Definieren des Ausdrucks abgeschlossen hast, kannst du die Syntax des Ausdrucks überprüfen, indem du auf die Schaltfläche Syntax prüfen klickst und dann die Änderungen speicherst.

5. Lege den Typ der berechneten Felder mithilfe der Dropdownliste Anzeigen als fest.

6. Wenn dein Wert Anzeigen als dem Wert „Datum“ oder „Zahl“ entspricht, lege den Feldwert Datums-/Zahlenformat mithilfe der Dropdownliste fest. Du kannst auch die benutzerdefinierte Formatierung auswählen, um eine benutzerdefinierte Formatierung für das Feld zu definieren.

Berechnete Felder mit dem Format Währung

Das Format Währung für ein berechnetes Feld fügt ein Währungssymbol vor dem berechneten Wert ein. (Die Berechnung wird ansonsten durch einfache Mathematik anhand einer Formel vorgenommen.)

Welches Symbol eingefügt wird, basiert auf den folgenden Regeln:

• Wenn die Quellfelder eine Validierung der Währung für die USA (US) enthalten, ist das angezeigte Symbol der US-Dollar: $.
• Wenn die Quellfelder eine Validierung der Währung für Großbritannien (UK) enthalten, ist das angezeigte Symbol das Pfund Sterling: $.

Damit die Formatierung als Währung funktioniert, muss das berechnete Feld folgendermaßen konfiguriert werden:

• Der Wert Anzeigen als muss auf Zahl
  gesetzt werden.
• Der Wert Zahlenformat muss auf Währung
  gesetzt werden.

Die Quellfelder, die in der Berechnung verwendet werden, können entweder anhand der Zahl oder anhand der Währung validiert werden:

Beispiele zu berechneten Feldern

• {{shipState_es_:signer1:calc([billingState]):showif(sameAs=unchecked)}}
  • Ein Feld im Dokument, das dem ersten Unterzeichner zugewiesen ist, das nur angezeigt wird, wenn ein anderes Feld (ein Kontrollkästchen) namens „sameAs“ deaktiviert ist. Der Wert des Felds wird automatisch mit dem Wert des Felds „billingState“ aufgefüllt, den der Unterzeichner im Dokument eingegeben hat.
• {{total_es_:signer1:calc(q1*pr1):format(Number,”$,0.00”):align(right)}}
  • Ein Feld im Dokument, das dem ersten Unterzeichner zugewiesen ist. Sein Wert wird automatisch als das Produkt der Werte in den Feldern „q1“ und „pr1“ berechnet. Der resultierende Wert wird als Währung formatiert und mit einem Dollarsymbol ($) vor dem Ergebniswert angezeigt und enthält zwei Dezimalstellen. Der Ergebniswert ist zudem rechtsbündig im Feld ausgerichtet.
• price_es_:signer1:calc(if(pn1=”W1”,9.99,if(pn1=”W2”,5.99,if(pn1=”W3”,24.99,0))))}
  • Ein Feld im Dokument namens „price“, das anhand des durch den Unterzeichner in anderen Feldern vom Typ „pn1“ im Dokument ausgewählten Werts berechnet wird. In diesem Beispiel lautet, sofern das Feld „pn1“ dem Wert „W1“ entspricht, der im Feld „price“ angezeigte Wert 9,99; sofern das Feld „pn1“ dem Wert „W2“ entspricht, lautet der im Feld „price“ angezeigte Wert 5,99 usw. Wenn keiner der Werte dem Wert des Felds „pn1“ entspricht, lautet der in „price“ angezeigte Wert 0. Mit diesem Mechanismus können berechnete Felder verwendet werden, um den Preis eines Artikels anhand der Auswahl des Unterzeichners während der Signatur automatisch aufzufüllen.