Använd fältreferenser, litteraler, operatorer och funktioner för att bygga formler för beräknade fält i Adobe Acrobat Sign.
Ange formler i egenskapen Formel för ett fält som konfigurerats med Värdetyp > Beräknad. Denna referens beskriver uttryckssyntaxen som är tillgänglig för att bygga dessa formler.
För att konfigurera själva fältet, se Skapa ett beräknat fält.
Bygg en formel
En formel kan innehålla ett eller flera av dessa element:
| Element | Använd det för | Exempel |
|---|---|---|
| Fältreferens | Använd ett värde från ett annat fält | pris * antal |
| Literal | Inkludera ett fast nummer, textvärde eller datum | total * 0,10 |
| Operator | Utför aritmetiska, jämförelse- eller textoperationer | delsumma + moms |
| Funktion | Utför en fördefinierad beräkning eller logisk operation | max(värde1, värde2) |
Formler kan också referera till andra beräknade fält.
Referensfält efter namn
Använd fältnamnet för att referera till dess värde i en formel.
Till exempel:
pris * antal
använder värdena från fält som heter price och quantity.
Om ett fältnamn innehåller mellanslag, omslut hela namnet med hakparenteser:
[Enhetspris] * antal
Använd meningsfulla, unika fältnamn så att formler förblir förståeliga när ett formulär ändras.
Se Formulärfältsegenskaper för krav på fältnamn.
Använd litterala värden
En literal är ett fast värde som inkluderas direkt i formeln.
Exempel omfattar:
- Tal: 10
- Text: "Godkänt"
- Datum som används av datumfunktioner som stöds
Sätt textsträngar inom enkla eller dubbla citattecken.
Till exempel:
"Godkänt"
Litterala värden kan kombineras med fält, operatorer och funktioner.
Operatorer som stöds
Använd operatorer för att utföra beräkningar, kombinera text eller jämföra värden.
| Operator | Operation |
|---|---|
| + | Lägg till |
| - | Subtrahera |
| / | Avdela |
| * | Multiplicera |
| & | Kombinera textsträngar |
| = | Lika med |
| != | Inte lika med |
| < | Mindre än |
| <= | Mindre än eller lika med |
| > | Större än |
| >= | Större än eller lika med |
| % | Returnera resten efter division |
| ^ | Upphöj ett värde till en potens |
Jämförelseoperatorer returnerar ett sant eller falskt resultat och kan användas inom logiska funktioner.
Till exempel:
total >= 1000
utvärderar om värdet för total är minst 1000.
Matematikfunktioner
| Funktion | Resultat |
|---|---|
| abs(number1) | Returnerar det absoluta värdet för ett tal. |
| roundUp(number1) | Avrundar ett tal uppåt. |
| roundDown(number1) | Avrundar ett tal nedåt. |
| round(number1) | Avrundar ett tal till närmaste heltal. |
| min(number1, number2) | Returnerar det mindre av två tal. |
| max(number1, number2) | Returnerar det större av två tal. |
Exempel
max(Amount1, Amount2)
returnerar det av de två fältvärdena som är större.
Datumfunktioner
| Funktion | Resultat |
|---|---|
| datePart(part, date) | Returnerar en specificerad del av ett datum som heltal. |
| dateAdd(part, date, addition) | Lägger till ett specificerat antal datumdelar till ett datum. Använd ett negativt värde för att subtrahera. |
| dateDiff(part, date1, date2) | Returnerar skillnaden mellan två datum med hjälp av den specificerade datumdelen. |
| daysIn(part, date) | Returnerar antalet dagar i den specificerade delen av ett datum. |
| date(string) | Konverterar ett textvärde som representerar ett datum till ett datumvärde som kan användas av andra funktioner. |
| now() | Returnerar datum och tid när formeln utvärderas. |
Datumdelsvärden
Använd dessa värden för part-argumentet i datumfunktioner som stöds:
| Värde | Datum- eller tidsdel |
|---|---|
| y | År |
| q | Kvartal |
| m | Månad |
| d | Dag |
| h | Timme |
| n | Minut |
| s | Sekund |
Exempel
dateAdd("d", StartDate, 30)
lägger till 30 dagar till värdet i fältet StartDate .
Använd ett negativt tal för att beräkna ett tidigare datum:
dateAdd("d", StartDate, -7)
Logikfunktioner
Använd logikfunktioner när ett beräknat värde beror på ett eller flera villkor.
| Funktion | Resultat |
|---|---|
| if(logiskt_test, värde_om_sant, värde_om_falskt) | Returnerar ett värde när testet är sant och ett annat när det är falskt. |
| and(logiskt1, logiskt2, ...) | Returnerar sant endast när alla angivna villkor är sanna. |
| or(logical1, logical2, ...) | Returnerar sant när minst ett angivet villkor är sant. |
| not(logical) | Vänder ett sant eller falskt resultat. |
| lookup(sourceField, values, default_value) | Returnerar ett värde som är associerat med källfältet eller ett standardvärde när ingen matchning hittas. |
Använd if för att välja mellan resultat
Till exempel:
if(Total >= 1000, "Godkännande krävs", "Godkänt")
returnerar ett textvärde när Total är minst 1000 och ett annat när det inte är det.
De sanna och falska resultaten kan själva innehålla uttryck.
Kombinera logiska test (and, or, not)
Använd and när varje villkor måste vara sant:
and(Age >= 18, Consent = "Yes")
Använd or när vilket villkor som helst kan vara sant:
or(State = "CA", State = "OR")
Använd not när du behöver motsatsen till ett villkor:
not(Status = "Closed")
Mappa ett värde till ett annat med lookup
Använd lookup när ett källvärde ska returnera ett motsvarande värde.
Till exempel:
lookup(State, "CA=California,UT=Utah,WA=Washington", "Other")
returnerar det mappade delstatsnamnet när en matchning finns och Other när det inte finns.
Detta är användbart när källvärdet kommer från en definierad uppsättning val, såsom en rullgardinsmeny eller radioknapp.
Formelexempel
Beräkna ett belopp
kvantitet * [Enhetspris]
Multiplicerar en kvantitet med ett enhetspris.
Lägg till flera värden
delsumma + moms + frakt
Lägger till värden från tre fält.
Beräkna en procentsats
delsumma * momssats
Multiplicerar ett fält med en sats som är lagrad i ett annat fält.
Returnera ett värde beroende på villkor
if(kvantitet >= 10, [Enhetspris] * 0,9, [Enhetspris])
returnerar ett rabatterat värde när kvantiteten når det definierade tröskelvärdet.
Beräkna ett framtida datum
dateAdd("m", StartDate, 12)
returnerar ett datum 12 månader efter StartDate.
Kombinera text
RecipientName & " - " & Company
kombinerar fältvärden och litteraltext till ett resultat.
Bygg formler som är lättare att underhålla
Använd beskrivande fältnamn och håll relaterade beräkningar så enkla som formuläret tillåter.
När du granskar en formel, bekräfta att:
- Alla refererade fält finns.
- Fältnamn matchar namnen som används i formeln.
- Fält som innehåller mellanslag omges av hakparenteser.
- Textlitteraler omges av citattecken.
- Funktioner innehåller de nödvändiga argumenten.
- Det beräknade fältet ger det avsedda värdet för de förväntade mottagarindata.
Information om hur du konfigurerar det beräknade fältet och formaterar nummerresultat finns i Skapa ett beräknat fält.
Effektivisera ditt arbete med Acrobat Sign
Hantera och signera dokument online snabbt och enkelt.