Gebruik veldverwijzingen, letterlijke waarden, operatoren en functies om formules samen te stellen voor berekende velden in Adobe Acrobat Sign.
Voer formules in bij de eigenschap Formule van een veld dat is geconfigureerd met Waardetype > Berekend. Deze verwijzing beschrijft de expressiesyntaxis die beschikbaar is voor het samenstellen van die formules.
Zie Berekend veld maken om het veld zelf te configureren.
Formule samenstellen
Een formule kan een of meer van deze elementen bevatten:
| Element | Gebruik het voor | Voorbeeld |
|---|---|---|
| Veldverwijzing | Gebruik een waarde van een ander veld | prijs * hoeveelheid |
| Letterlijke waarde | Voeg een vast getal, tekstwaarde of datum toe | totaal * 0.10 |
| Operator | Voer rekenkundige, vergelijkings- of tekstbewerkingen uit | subtotaal + belasting |
| Functie | Voer een vooraf gedefinieerde berekening of logische bewerking uit | max(value1, value2) |
Formules kunnen ook verwijzen naar andere berekende velden.
Verwijs naar velden op naam
Gebruik de veldnaam om naar de waarde ervan te verwijzen in een formule.
Bijvoorbeeld:
price * quantity
gebruikt de waarden van velden met de naam price en quantity.
Als een veldnaam spaties bevat, plaats dan de volledige naam tussen vierkante haakjes:
[Eenheidsprijs] * hoeveelheid
Gebruik betekenisvolle, unieke veldnamen zodat formules begrijpelijk blijven wanneer een formulier wijzigt.
Zie Eigenschappen van formuliervelden voor vereisten voor veldnamen.
Gebruik letterlijke waarden
Een letterlijke waarde is een vaste waarde die direct in de formule wordt opgenomen.
Voorbeelden zijn:
- Getallen: 10
- Tekst: "Approved"
- Datums die worden gebruikt door ondersteunde datumfuncties
Plaats tekstreeksen tussen enkele of dubbele aanhalingstekens.
Bijvoorbeeld:
"Approved"
Letterlijke waarden kunnen worden gecombineerd met velden, operators en functies.
Ondersteunde operators
Gebruik operators om berekeningen uit te voeren, tekst te combineren of waarden te vergelijken.
| Operator | Bewerking |
|---|---|
| + | Toevoegen |
| - | Verwijderen |
| / | Scheiden |
| * | Vermenigvuldigen |
| & | Tekstreeksen combineren |
| = | Gelijk aan |
| != | Niet gelijk aan |
| < | Kleiner dan |
| <= | Kleiner dan of gelijk aan |
| > | Groter dan |
| >= | Groter dan of gelijk aan |
| % | Geef de rest terug na deling |
| ^ | Verhef een waarde tot een macht |
Vergelijkingsoperators geven een true- of false-resultaat terug en kunnen worden gebruikt binnen logische functies.
Bijvoorbeeld:
total >= 1000
evalueert of de waarde van total minimaal 1000 is.
Wiskundige functies
| Functie | Resultaat |
|---|---|
| abs(number1) | Retourneert de absolute waarde van een getal. |
| roundUp(number1) | Rondt een getal naar boven af. |
| roundDown(number1) | Rondt een getal naar beneden af. |
| round(number1) | Rondt een getal af naar het dichtstbijzijnde gehele getal. |
| min(number1, number2) | Retourneert het kleinste van twee getallen. |
| max(getal1, getal2) | Retourneert het grootste van twee getallen. |
Voorbeeld
max(Bedrag1, Bedrag2)
retourneert welke van de twee veldwaarden groter is.
Datumfuncties
| Functie | Resultaat |
|---|---|
| datePart(part, date) | Retourneert een opgegeven deel van een datum als geheel getal. |
| dateAdd(part, date, addition) | Voegt een opgegeven aantal datumonderdelen toe aan een datum. Gebruik een negatieve waarde om af te trekken. |
| dateDiff(part, date1, date2) | Retourneert het verschil tussen twee datums met het gespecificeerde datumdeel. |
| daysIn(part, date) | Retourneert het aantal dagen in het gespecificeerde deel van een datum. |
| date(string) | Converteert een tekstwaarde die een datum weergeeft naar een datumwaarde die door andere functies kan worden gebruikt. |
| now() | Retourneert de datum en tijd waarop de formule wordt geëvalueerd. |
Waarden voor datumdelen
Gebruik deze waarden voor het deel-argument in ondersteunde datumfuncties:
| Waarde | Datum- of tijddeel |
|---|---|
| y | Jaar |
| q | Kwartaal |
| m | Maand |
| d | dag |
| h | Uur |
| n | Minuut |
| s | Seconde |
Voorbeeld
dateAdd("d", StartDate, 30)
voegt 30 dagen toe aan de waarde van het StartDate veld.
Gebruik een negatief getal om een eerdere datum te berekenen:
dateAdd("d", StartDate, -7)
Logische functies
Gebruik logische functies wanneer een berekende waarde afhangt van een of meer voorwaarden.
| Functie | Resultaat |
|---|---|
| if(logical_test, value_if_true, value_if_false) | Retourneert een waarde wanneer de test waar is en een andere wanneer deze onwaar is. |
| and(logical1, logical2, ...) | Retourneert alleen true wanneer alle opgegeven voorwaarden waar zijn. |
| or(logical1, logical2, ...) | Retourneert true wanneer ten minste één opgegeven voorwaarde waar is. |
| not(logical) | Keert een waar of onwaar resultaat om. |
| lookup(sourceField, values, default_value) | Retourneert een waarde die is gekoppeld aan het bronveld of een standaardwaarde wanneer er geen overeenkomst wordt gevonden. |
Gebruik if om te kiezen tussen resultaten
Bijvoorbeeld:
if(Total >= 1000, "Goedkeuring vereist", "Goedgekeurd")
retourneert een tekstwaarde wanneer Totaal minstens 1000 is en een andere wanneer dat niet het geval is.
De waar- en onwaarresultaten kunnen zelf expressies bevatten.
Logische tests combineren (and, or, not)
Gebruik and wanneer elke voorwaarde waar moet zijn:
and(Leeftijd >= 18, Toestemming = "Ja")
Gebruik of wanneer een van de voorwaarden waar kan zijn:
or(State = "CA", State = "OR")
Gebruik not wanneer je het tegenovergestelde van een voorwaarde nodig hebt:
not(Status = "Gesloten")
Een waarde aan een andere koppelen met lookup
Gebruik lookup wanneer een bronwaarde een overeenkomstige waarde moet retourneren.
Bijvoorbeeld:
lookup(State, "CA=California,UT=Utah,WA=Washington", "Other")
retourneert de toegewezen staatsnaam wanneer er een overeenkomst bestaat en Overig wanneer dit niet zo is.
Dit is handig wanneer de bronwaarde afkomstig is uit een gedefinieerde set keuzes, zoals een vervolgkeuzemenu of keuzerondje veld.
Voorbeelden van formules
Bedrag berekenen
hoeveelheid * [Eenheidsprijs]
Vermenigvuldigt een hoeveelheid met een eenheidsprijs.
Verschillende waarden optellen
subtotaal + belasting + verzending
Telt waarden uit drie velden op.
Een percentage berekenen
subtotaal * belastingtarief
Vermenigvuldigt één veld met een tarief dat in een ander veld is opgeslagen.
Voorwaardelijk een waarde retourneren
if(hoeveelheid >= 10, [Eenheidsprijs] * 0,9, [Eenheidsprijs])
retourneert een kortingswaarde wanneer de hoeveelheid de gedefinieerde drempel bereikt.
Bereken een toekomstige datum
dateAdd("m", StartDate, 12)
retourneert een datum 12 maanden na StartDatum.
Tekst combineren
OntvangersNaam & " - " & Bedrijf
combineert veldwaarden en letterlijke tekst in één resultaat.
Formules samenstellen die eenvoudiger te onderhouden zijn
Gebruik beschrijvende veldnamen en houd gerelateerde berekeningen zo eenvoudig als het formulier toestaat.
Controleer bij het controleren van een formule dat:
- Elk veld waarnaar wordt verwezen bestaat.
- Veldnamen komen overeen met de namen die in de formule worden gebruikt.
- Velden met spaties staan tussen vierkante haken.
- Tekstliteralen staan tussen aanhalingstekens.
- Functies bevatten de vereiste argumenten.
- Het berekende veld produceert de beoogde waarde voor de verwachte invoer van ontvangers.
Voor het configureren van het berekende veld en het formatteren van getalresultaten, zie Een berekend veld maken.
Je werk stroomlijnen met Acrobat Sign
Beheer en onderteken documenten snel en eenvoudig online.
