Verwende Feldreferenzen, Literale, Operatoren und Funktionen, um Formeln für berechnete Felder in Adobe Acrobat Sign zu erstellen.
Gib Formeln in die Eigenschaft Formel eines Felds ein, das mit Werttyp > Berechnet konfiguriert ist. Diese Referenz beschreibt die Ausdruckssyntax, die zum Erstellen dieser Formeln verfügbar ist.
Informationen zum Konfigurieren des Felds selbst findest du unter Ein berechnetes Feld erstellen.
Eine Formel erstellen
Eine Formel kann eines oder mehrere der folgenden Elemente enthalten:
| Element | Verwendungszweck | Beispiel |
|---|---|---|
| Feldreferenz | Einen Wert aus einem anderen Feld verwenden | Preis * Menge |
| Literal | Eine feste Zahl, einen Textwert oder ein Datum einfügen | Gesamt * 0,10 |
| Operator | Arithmetische Operationen, Vergleiche oder Textoperationen durchführen | Untersumme + St. |
| Funktion | Eine vordefinierte Berechnung oder logische Operation durchführen | max(value1, value2) |
Formeln können auch auf andere berechnete Felder verweisen.
Felder nach Namen referenzieren
Verwende den Feldnamen, um in einer Formel auf dessen Wert zu verweisen.
Beispiel:
Preis * Menge
verwendet die Werte der Felder mit den Namen price und quantity.
Wenn ein Feldname Leerzeichen enthält, setze den vollständigen Namen in eckige Klammern:
[Preis pro Einheit] * Menge
Verwende aussagekräftige, eindeutige Feldnamen, damit Formeln auch bei Änderungen am Formular verständlich bleiben.
Informationen zu den Anforderungen für Feldnamen findest du in den Formularfeldeigenschaften.
Literale Werte verwenden
Ein Literal ist ein fester Wert, der direkt in die Formel eingefügt wird.
Beispiele:
- Zahlen: 10
- Text: „Genehmigt“
- Datumsangaben, die von unterstützten Datumsfunktionen verwendet werden
Setze Textstrings in einfache oder doppelte Anführungszeichen.
Beispiel:
„Genehmigt“
Du kannst literale Werte mit Feldern, Operatoren und Funktionen kombinieren.
Unterstützte Operatoren
Verwende Operatoren, um Berechnungen durchzuführen, Text zu kombinieren oder Werte zu vergleichen.
| Operator | Vorgang |
|---|---|
| + | Hinzufügen |
| - | Subtrahieren |
| / | Trennen |
| * | Multiplizieren |
| & | Textstrings kombinieren |
| = | Gleich |
| != | Ist ungleich |
| < | Weniger als |
| <= | Kleiner oder gleich |
| > | Größer als |
| >= | Größer oder gleich |
| % | Gibt den Rest nach der Division zurück |
| ^ | Einen Wert potenzieren |
Vergleichsoperatoren geben ein Ergebnis von wahr oder falsch zurück und können innerhalb von logischen Funktionen verwendet werden.
Beispiel:
Gesamt >= 1000
Bewertet, ob der Wert von Gesamt mindestens 1000 beträgt.
Mathematische Funktionen
| Funktion | Ergebnis |
|---|---|
| abs(number1) | Gibt den Absolutwert einer Zahl zurück. |
| roundUp(number1) | Rundet eine Zahl auf. |
| roundDown(number1) | Rundet eine Zahl ab. |
| round(number1) | Rundet eine Zahl auf die nächsthöhere Ganzzahl auf. |
| min(number1, number2) | Die kleinere von zwei Zahlen zurückgeben. |
| max(number1, number2) | Die größere von zwei Zahlen zurückgeben. |
Beispiel
max(Amount1, Amount2)
gibt den größeren der beiden Feldwerte zurück.
Datumsfunktionen
| Funktion | Ergebnis |
|---|---|
| datePart(part, date) | Gibt einen angegebenen Teil eines Datums als Ganzzahl zurück. |
| dateAdd(part, date, addition) | Fügt einem Datum eine bestimmte Anzahl von Datumsteilen hinzu. Verwende einen negativen Wert, um zu subtrahieren. |
| dateDiff(part, date1, date2) | Gibt die Differenz zwischen zwei Datumsangaben im angegebenen Datumsteil zurück. |
| daysIn(part, date) | Gibt die Anzahl der Tage im angegebenen Teil eines Datums zurück. |
| date(string) | Konvertiert einen Textwert, der ein Datum darstellt, in einen Datumswert, der von anderen Funktionen verwendet werden kann. |
| now() | Gibt das Datum und die Uhrzeit zurück, zu der die Formel ausgewertet wurde. |
Datumsteil-Werte
Verwende diese Werte für das Argument „part“ in unterstützten Datumsfunktionen:
| Wert | Datums- oder Zeitkomponente |
|---|---|
| y | Jahr |
| q | Quartal |
| m | Monat |
| d | Tag |
| h | Stunde |
| n | Minute |
| s | Sekunde |
Beispiel
dateAdd("d", StartDate, 30)
fügt 30 Tage zum Wert des StartDate Feldes hinzu.
Verwende eine negative Zahl, um ein früheres Datum zu berechnen:
dateAdd("d", StartDate, -7)
Logikfunktionen
Verwende Logikfunktionen, wenn ein berechneter Wert von einer oder mehreren Bedingungen abhängt.
| Funktion | Ergebnis |
|---|---|
| if(logical_test, value_if_true, value_if_false) | Gibt einen Wert zurück, wenn der Test wahr ist, und einen anderen, wenn er falsch ist. |
| and(logical1, logical2, ...) | Gibt nur „wahr“ zurück, wenn alle angegebenen Bedingungen wahr sind. |
| or(logical1, logical2, ...) | Gibt „wahr“ zurück, wenn mindestens eine der angegebenen Bedingungen erfüllt ist. |
| not(logical) | Kehrt ein Ergebnis mit dem Wert „wahr“ oder „falsch“ um. |
| lookup(sourceField, values, default_value) | Gibt einen Wert zurück, der dem Quellfeld zugeordnet ist, oder einen Standardwert, wenn keine Übereinstimmung gefunden wird. |
Verwende if, um zwischen Ergebnissen zu wählen
Beispiel:
if(Total >= 1000, "Approval required", "Approved")
gibt einen Textwert zurück, wenn Total mindestens 1000 beträgt, und einen anderen Textwert, wenn nicht.
Die Ergebnisse für wahr und falsch können selbst Ausdrücke enthalten.
Logische Tests kombinieren (and, or, not)
Verwende and, wenn alle Bedingungen wahr sein müssen:
and(Age >= 18, Consent = "Yes")
Verwende or, wenn eine der Bedingungen wahr sein soll:
or(State = "CA", State = "OR")
Verwende not, wenn du das Gegenteil einer Bedingung benötigst:
not(Status = "Closed")
Einem Wert einen anderen mit lookup zuordnen
Verwende lookup, wenn ein Quellwert einen entsprechenden Wert zurückgeben soll.
Beispiel:
lookup(State, "CA=California,UT=Utah,WA=Washington", "Other")
gibt den zugeordneten Staatennamen zurück, wenn eine Übereinstimmung vorhanden ist, und Other, wenn keine vorhanden ist.
Das ist nützlich, wenn der Quellwert aus einer definierten Auswahl von Optionen stammt, wie zum Beispiel einem Dropdown- oder Optionsfeld.
Formelbeispiele
Einen Betrag berechnen
quantity * [Preis pro Einheit]
Multipliziert eine Anzahl mit einem Einzelpreis.
Mehrere Werte addieren
Zwischensumme + Steuer + Versand
Addiert Werte aus drei Feldern.
Einen Prozentsatz berechnen
subtotal * taxRate
Multipliziert ein Feld mit einem Satz, der in einem anderen Feld gespeichert ist.
Einen Wert bedingt zurückgeben
if(quantity >= 10, [Unit price] * 0.9, [Unit price])
gibt einen rabattierten Wert zurück, wenn die Anzahl den definierten Schwellenwert erreicht.
Ein zukünftiges Datum berechnen
dateAdd("m", StartDate, 12)
gibt ein Datum zurück, das 12 Monate nach StartDate liegt.
Text kombinieren
RecipientName & " - " & Company
Kombiniert Feldwerte und literalen Text zu einem Ergebnis.
Formeln erstellen, die einfacher zu verwalten sind
Verwende aussagekräftige Feldnamen und halte verwandte Berechnungen so einfach, wie das Formular es zulässt.
Bestätige beim Prüfen einer Formel, dass:
- Jedes referenzierte Feld ist vorhanden.
- Die Feldnamen stimmen mit den in der Formel verwendeten Namen überein.
- Felder, die Leerzeichen enthalten, werden in eckige Klammern gesetzt.
- Textliterale sind in Anführungszeichen eingeschlossen.
- Funktionen enthalten die erforderlichen Argumente.
- Das berechnete Feld erzeugt den gewünschten Wert für die erwarteten Empfängereingaben.
Informationen zum Konfigurieren des berechneten Felds und zum Formatieren von Zahlenergebnissen findest du unter Ein berechnetes Feld erstellen.
Optimieren von Workflows mit Acrobat Sign
Verwalte und signiere Dokumente schnell und einfach online.
