Usa riferimenti di campo, valori letterali, operatori e funzioni per generare formule per i campi calcolati in Adobe Acrobat Sign.
Inserisci le formule nella proprietà Formula di un campo configurato con Tipo di valore > Calcolato. Questo riferimento descrive la sintassi delle espressioni disponibile per generare tali formule.
Per configurare il campo stesso, vedi Crea un campo calcolato.
Creare una formula
Una formula può contenere uno o più di questi elementi:
| Elemento | Usalo per | Esempio |
|---|---|---|
| Riferimento di campo | Usa un valore di un altro campo | prezzo * quantità |
| Valore letterale | Includi un numero fisso, un valore di testo o una data | totale * 0,10 |
| Operatore | Esegui operazioni aritmetiche, di confronto o di testo | subtotale + imposte |
| Funzione | Esegui un calcolo predefinito o un'operazione logica | max(valore1, valore2) |
Le formule possono anche fare riferimento ad altri campi calcolati.
Riferimento ai campi per nome
Usa il nome del campo per fare riferimento al suo valore in una formula.
Esempio:
prezzo * quantità
usa i valori dei campi denominati prezzo e quantità.
Se il nome di un campo contiene spazi, racchiudi il nome completo tra parentesi quadre:
[Prezzo unitario] * quantità
Usa nomi di campo significativi e univoci in modo che le formule rimangano comprensibili quando un modulo cambia.
Vedi Proprietà dei campi modulo per i requisiti del nome del campo.
Usa valori letterali
Un letterale è un valore fisso incluso direttamente nella formula.
Esempi:
- Numeri: 10
- Testo: "Approved"
- Date utilizzate dalle funzioni di data supportate
Racchiudi le stringhe di testo tra virgolette singole o doppie.
Esempio:
"Approved"
I valori letterali possono essere combinati con campi, operatori e funzioni.
Operatori supportati
Usa gli operatori per eseguire calcoli, combinare testo o confrontare valori.
| Operatore | Operazione |
|---|---|
| + | Aggiungi |
| - | Sottrai |
| / | Separare |
| * | Multiplo |
| & | Combinare stringhe di testo |
| = | Uguale a |
| != | Diverso da |
| < | Minore di |
| <= | Minore o uguale a |
| > | Maggiore di |
| >= | Maggiore o uguale a |
| % | Restituire il resto dopo la divisione |
| ^ | Elevare un valore a una potenza |
Gli operatori di confronto restituiscono un risultato vero o falso e possono essere utilizzati all'interno di funzioni logiche.
Esempio:
total >= 1000
valuta se il valore di total è almeno 1000.
Funzioni matematiche
| Funzione | Risultato |
|---|---|
| abs(number1) | Restituisce il valore assoluto di un numero. |
| roundUp(number1) | Arrotonda un numero per eccesso. |
| roundDown(number1) | Arrotonda un numero per difetto. |
| round(number1) | Arrotonda un numero all'intero più vicino. |
| min(number1, number2) | Restituisce il minore di due numeri. |
| max(number1, number2) | Restituisce il maggiore di due numeri. |
Esempio
max(Amount1, Amount2)
restituisce il valore maggiore tra i due campi.
Funzioni per le date
| Funzione | Risultato |
|---|---|
| datePart(part, date) | Restituisce una parte specifica di una data come numero intero. |
| dateAdd(part, date, addition) | Aggiunge un numero specifico di parti di data a una data. Usa un valore negativo per sottrarre. |
| dateDiff(part, date1, date2) | Restituisce la differenza tra due date usando la parte di data specificata. |
| daysIn(part, date) | Restituisce il numero di giorni nella parte specificata di una data. |
| date(string) | Converte un valore di testo che rappresenta una data in un valore di data utilizzabile da altre funzioni. |
| now() | Restituisce la data e l'ora in cui viene valutata la formula. |
Valori delle parti di data
Usa questi valori per l'argomento parte nelle funzioni data supportate:
| Valore | Parte di data o ora |
|---|---|
| y | Anno |
| q | Trimestre |
| m | Mese |
| d | Giorno |
| h | Ora |
| n | Minuto |
| s | Secondo |
Esempio
dateAdd("d", StartDate, 30)
aggiunge 30 giorni al Valore del campo StartDate .
Usa un numero negativo per calcolare una data precedente:
dateAdd("d", StartDate, -7)
Funzioni logiche
Usa le funzioni logiche quando un valore calcolato dipende da una o più condizioni.
| Funzione | Risultato |
|---|---|
| if(logical_test, value_if_true, value_if_false) | Restituisce un valore quando il test è vero e un altro quando è falso. |
| and(logical1, logical2, ...) | Restituisce vero solo quando tutte le condizioni specificate sono vere. |
| or(logical1, logical2, ...) | Restituisce vero quando almeno una condizione specificata è vera. |
| not(logical) | Inverte un risultato vero o falso. |
| lookup(sourceField, values, default_value) | Restituisce un valore associato al campo origine o un valore predefinito quando non viene trovata alcuna corrispondenza. |
Usa if per scegliere tra i risultati
Esempio:
if(Total >= 1000, "Approval required", "Approved")
restituisce un valore di testo quando Total è almeno 1000 e un altro quando non lo è.
I risultati vero e falso possono contenere a loro volta espressioni.
Combina test logici (and, or, not)
Usa and quando ogni condizione deve essere vera:
and(Age >= 18, Consent = "Yes")
Usa or quando qualsiasi condizione può essere vera:
or(State = "CA", State = "OR")
Usa not quando hai bisogno dell'opposto di una condizione:
not(Status = "Closed")
Associa un valore a un altro tramite lookup
Usa lookup quando un valore di origine deve restituire un valore corrispondente.
Esempio:
lookup(State, "CA=California,UT=Utah,WA=Washington", "Other")
restituisce il nome dello stato mappato quando trova una corrispondenza e Other quando non la trova.
Ciò è utile quando il valore origine proviene da un set definito di scelte, come un campo Dropdown o pulsante di scelta.
Esempi di formule
Calcola un importo
quantità * [Prezzo unitario]
Moltiplica una quantità per un prezzo unitario.
Aggiungi diversi valori
subtotale + tasse + spedizione
Aggiunge valori da tre campi.
Calcola una percentuale
subtotal * taxRate
Moltiplica un campo per un'aliquota memorizzata in un altro campo.
Restituisci un valore condizionalmente
if(quantità >= 10, [Prezzo unitario] * 0,9, [Prezzo unitario])
restituisce un valore scontato quando la quantità raggiunge la soglia definita.
Calcola una data futura
dateAdd("m", StartDate, 12)
restituisce una data 12 mesi dopo DataInizio.
Combina testo
NomeDestinatario & " - " & Azienda
combina valori dei campi e testo letterale in un unico risultato.
Crea formule più facili da gestire
Usa nomi di campo descrittivi e mantieni i calcoli correlati il più semplici possibile per il modulo.
Quando rivedi una formula, conferma che:
- Ogni campo di riferimento esista.
- I nomi dei campi corrispondono ai nomi utilizzati nella formula.
- I campi contenenti spazi sono racchiusi tra parentesi quadre.
- I letterali di testo sono racchiusi tra virgolette.
- Le funzioni contengono gli argomenti richiesti.
- Il campo calcolato produce il valore previsto per gli input del destinatario atteso.
Per configurare il campo calcolato e formattare i risultati numerici, consulta Crea un campo calcolato.
Semplifica il tuo lavoro con Acrobat Sign
Gestisci e firma documenti online in modo semplice e veloce.
