Brug felthenvisninger, konstanter, operatorer og funktioner til at oprette formler for beregnede felter i Adobe Acrobat Sign.
Skriv formler i egenskaben Formel for et felt, der er konfigureret med Værditype > Beregnet. Denne reference beskriver den udtrykssyntaks, der er tilgængelig til at oprette disse formler.
For at konfigurere selve feltet, se Opret et beregnet felt.
Opret en formel
En formel kan indeholde et eller flere af disse elementer:
| Element | Brug det til | Eksempel |
|---|---|---|
| Felthenvisning | Brug en værdi fra et andet felt | pris * mængde |
| Konstantværdi | Medtag et fast tal, tekstværdi eller dato | total * 0,10 |
| Operator | Udfør aritmetiske, sammenlignings- eller tekstoperationer | subtotal + skat |
| Funktion | Udfør en foruddefineret beregning eller logisk operation | max(værdi1, værdi2) |
Formler kan også henvise til andre beregnede felter.
Henvis til felter efter navn
Brug feltnavnet til at henvise til dets værdi i en formel.
For eksempel:
pris * mængde
bruger værdierne fra felter kaldet pris og mængde.
Hvis et feltnavn indeholder mellemrum, skal du sætte det fulde navn i kantede parenteser:
[Enhedspris] * mængde
Brug meningsfulde, unikke feltnavne, så formler forbliver forståelige, når en formular ændres.
Se Formularfeltegenskaber for krav til feltnavne.
Brug faste værdier
En literal er en fast Værdi, der inkluderes direkte i formlen.
Udvalgte eksempler:
- Tal: 10
- Tekst: "Godkendt"
- Datoer brugt af understøttede datofunktioner
Omslut tekststrenge med enkelte eller dobbelte anførselstegn.
For eksempel:
"Godkendt"
Literale værdier kan kombineres med felter, operatorer og funktioner.
Understøttede operatorer
Brug operatorer til at udføre beregninger, kombinere tekst eller sammenligne værdier.
| Operator | Operation |
|---|---|
| + | Tilføj |
| - | Træk fra |
| / | Inddel |
| * | Multiplicer |
| & | Kombinér tekststrenge |
| = | Lig med |
| != | Ikke lig med |
| < | Mindre end |
| <= | Mindre end eller lig med |
| > | Større end |
| >= | Større end eller lig med |
| % | Returner resten efter division |
| ^ | Opløft en værdi til en potens |
Sammenligningsoperatorer returnerer et sandt eller falsk resultat og kan bruges i logiske funktioner.
For eksempel:
total >= 1000
evaluerer, om værdien af total er mindst 1000.
Matematikfunktioner
| Funktion | Resultat |
|---|---|
| abs(number1) | Returnerer tallets absolutte værdi |
| roundUp(number1) | Runder et tal op. |
| roundDown(number1) | Runder et tal ned. |
| round(number1) | Runder et tal til det nærmeste heltal. |
| min(number1, number2) | Returnerer det mindste af to tal. |
| max(nummer1, nummer2) | Returnerer det største af to tal. |
Eksempel
max(Beløb1, Beløb2)
returnerer den største af de to feltværdier.
Datofunktioner
| Funktion | Resultat |
|---|---|
| datePart(part, date) | Returnerer en angivet del af en dato som et heltal. |
| dateAdd(part, date, addition) | Tilføjer et angivet antal datodele til en dato. Brug en negativ værdi for at trække fra. |
| dateDiff(part, date1, date2) | Returnerer forskellen mellem to datoer ved hjælp af den angivne datodel. |
| daysIn(part, date) | Returnerer antallet af dage i den angivne del af en dato. |
| date(string) | Konverterer en tekstværdi, der repræsenterer en dato, til en datoværdi, som kan bruges af andre funktioner. |
| now() | Returnerer datoen og klokkeslættet, når formlen evalueres. |
Datodelsværdier
Brug disse værdier til argumentet del i understøttede datofunktioner:
| Værdi | Dato- eller tidsdel |
|---|---|
| y | År |
| q | Kvartal |
| m | Måned |
| d | dag |
| h | Time |
| n | Minut |
| s | Sekund |
Eksempel
dateAdd("d", StartDate, 30)
tilføjer 30 dage til værdien af StartDate-feltet.
Brug et negativt tal til at beregne en tidligere dato:
dateAdd("d", StartDate, -7)
Logikfunktioner
Brug logikfunktioner, når en beregnet værdi afhænger af en eller flere betingelser.
| Funktion | Resultat |
|---|---|
| if(logisk_test, værdi_hvis_sand, værdi_hvis_falsk) | Returnerer en værdi, når testen er sand, og en anden, når den er falsk. |
| and(logical1, logical2, ...) | Returnerer sand kun når alle angivne betingelser er sande. |
| or(logical1, logical2, ...) | Returnerer sand når mindst én angivet betingelse er sand. |
| not(logical) | Vender et sandt eller falsk resultat om. |
| lookup(sourceField, values, default_value) | Returnerer en værdi tilknyttet kildefeltet eller en standardværdi når der ikke findes et match. |
Brug if til at vælge mellem resultater
For eksempel:
if(Total >= 1000, "Godkendelse påkrævet", "Godkendt")
returnerer én tekstværdi når Total er mindst 1000 og en anden, når den ikke er det.
De sande og falske resultater kan selv indeholde udtryk.
Kombiner logiske tests (and, or, not)
Brug and når hver betingelse skal være sand:
and(Age >= 18, Consent = "Yes")
Brug or når enhver betingelse kan være sand:
or(State = "CA", State = "OR")
Brug not når du har brug for det modsatte af en betingelse:
not(Status = "Closed")
Tilknyt én værdi til en anden med lookup
Brug lookup når en kildeværdi skal returnere en tilsvarende værdi.
For eksempel:
lookup(State, "CA=California,UT=Utah,WA=Washington", "Other")
returnerer det tilknyttede statenavn når et match eksisterer og Other når det ikke gør.
Dette er nyttigt, når kildeværdien kommer fra et defineret sæt valgmuligheder, såsom et dropdown- eller radioknap-felt.
Eksempler på formler
Beregn et beløb
antal * [Enhedspris]
Ganger et antal med en enhedspris.
Tilføj flere værdier
subtotal + skat + forsendelse
Adderer værdier fra tre felter.
Beregn en procentdel
subtotal * skattesats
Ganger ét felt med en sats, der er gemt i et andet felt.
Returner en værdi betinget
if(antal >= 10, [Enhedspris] * 0,9, [Enhedspris])
returnerer en rabatværdi, når antallet når den definerede tærskel.
Beregn en fremtidig dato
dateAdd("m", StartDate, 12)
returnerer en dato 12 måneder efter StartDato.
Kombinér tekst
ModtagerNavn & " - " & Firma
kombinerer feltværdier og bogstavelig tekst til ét resultat.
Opbyg formler, der er lettere at vedligeholde
Brug beskrivende feltnavne, og hold relaterede beregninger så enkle, som formularen tillader.
Når du gennemgår en formel, så tjek, at:
- Hvert refereret felt eksisterer.
- Feltnavne svarer til de navne, der bruges i formlen.
- Felter, der indeholder mellemrum, er indesluttet i kantede parenteser.
- Tekstkonstanter er indesluttet i anførselstegn.
- Funktioner indeholder de nødvendige argumenter.
- Det beregnede felt giver den ønskede værdi for de forventede modtagerinput.
For at konfigurere det beregnede felt og formatere talresultater, se Opret et beregnet felt.
