Verwende Feldverweise, Literale, Operatoren und Funktionen, um Formeln für berechnete Felder in Adobe Acrobat Sign zu erstellen.
Gib Formeln in die Formel-Eigenschaft eines Felds ein, das mit Werttyp > Berechnet konfiguriert ist.Diese Referenz beschreibt die Ausdruckssyntax, die zum Erstellen dieser Formeln verfügbar ist.
Informationen zur Konfiguration des Felds selbst findest du unter Berechnetes Feld anlegen.
Formel erstellen
Eine Formel kann eines oder mehrere dieser Elemente enthalten:
| Element | Verwende es für | Beispiel |
|---|---|---|
| Feldverweis | Verwende einen Wert aus einem anderen Feld | Preis * Menge |
| Literal | Schließe eine feste Zahl, einen Textwert oder ein Datum ein | Gesamt * 0,10 |
| Operator | Führe arithmetische, Vergleichs- oder Textoperationen durch | Untersumme + St. |
| Funktion | Führe eine vordefinierte Berechnung oder logische Operation durch | max(value1, value2) |
Formeln können auch auf andere berechnete Felder verweisen.
Felder über ihren Namen referenzieren
Verwende den Feldnamen, um seinen Wert in einer Formel zu verwenden.
Beispiel:
Preis * Menge
verwendet die Werte von Feldern namens 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 verständlich bleiben, wenn sich ein Formular ändert.
Siehe Formularfeldeigenschaften für Feldnamen-Anforderungen.
Verwende Literalwerte
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
Schließe Textstrings in einfache oder doppelte Anführungszeichen ein.
Beispiel:
„Genehmigt“
Literalwerte können mit Feldern, Operatoren und Funktionen kombiniert werden.
Unterstützte Operatoren
Verwende Operatoren, um Berechnungen durchzuführen, Text zu kombinieren oder Werte zu vergleichen.
| Operator | Vorgang |
|---|---|
| + | Hinzufügen |
| - | Subtrahieren |
| / | Trennen |
| * | Multiply |
| & | Textzeichenfolgen 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 wahres oder falsches Ergebnis zurück und können innerhalb logischer 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 zur nächsten Ganzzahl. |
| min(number1, number2) | Die kleinere von zwei Zahlen zurückgeben. |
| max(number1, number2) | Die größere von zwei Zahlen zurückgeben. |
Beispiel
max(Betrag1, Betrag2)
gibt zurück, welcher der beiden Feldwerte größer ist.
Datumsfunktionen
| Funktion | Ergebnis |
|---|---|
| datePart(part, date) | Gibt einen bestimmten Teil eines Datums als Ganzzahl zurück. |
| dateAdd(part, date, addition) | Fügt eine bestimmte Anzahl von Datumsteilen zu einem Datum hinzu. Verwende einen negativen Wert zum Subtrahieren. |
| dateDiff(part, date1, date2) | Gibt die Differenz zwischen zwei Datumsangaben unter Verwendung des angegebenen Datumsbestandteils 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 part-Argument in unterstützten Datumsfunktionen:
| Wert | Datum oder Uhrzeitteil |
|---|---|
| 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 Felds 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 wahr ist. |
| not(logical) | Kehrt ein wahres oder falsches Ergebnis 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 wahren und falschen Ergebnisse 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 etwa einem Dropdown- oder Optionsfeld.
Formelbeispiele
Einen Betrag berechnen
quantity * [Unit price]
Multipliziert eine Anzahl mit einem Stückpreis.
Mehrere Werte addieren
subtotal + tax + shipping
Addiert Werte aus drei Feldern.
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.
Zukünftiges Datum berechnen
dateAdd("m", StartDate, 12)
gibt ein Datum 12 Monate nach StartDate zurück.
Text kombinieren
RecipientName & " - " & Company
kombiniert Feldwerte und Literaltext 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 existiert.
- Die Feldnamen stimmen mit den in der Formel verwendeten Namen überein.
- Felder, die Leerzeichen enthalten, werden in eckige Klammern eingeschlossen.
- 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.
Für die Konfiguration des berechneten Feldes und die Formatierung von Zahlenergebnissen siehe Berechnetes Feld erstellen.
Optimieren von Workflows mit Acrobat Sign
Verwalte und signiere Dokumente schnell und einfach online.
