Servez-vous des références de champs, des valeurs littérales, des opérateurs et des fonctions pour créer des formules pour les champs calculés dans Adobe Acrobat Sign.
Saisissez les formules dans la propriété Formule d’un champ configuré avec Type de valeur > Calculé. Cette référence décrit la syntaxe d’expression disponible pour créer ces formules.
Pour configurer le champ même, consultez Création d’un champ calculé.
Création d’une formule
Une formule peut contenir un ou plusieurs des éléments suivants :
| Élément | À utiliser pour | Exemple |
|---|---|---|
| Référence de champ | Utiliser une valeur d’un autre champ | prix * quantité |
| Littéral | Inclure un nombre fixe, une valeur de texte ou une date | total * 0.10 |
| Opérateur | Exécution d’opérations arithmétiques, de comparaison ou de texte | sous-total + taxes |
| Fonction | Exécution d’un calcul prédéfini ou d’une opération logique | max(value1, value2) |
Les formules peuvent également faire référence à d’autres champs calculés.
Référencement des champs par leur nom
Utilisez le nom du champ pour référencer sa valeur dans une formule.
Par exemple :
prix * quantité
utilise les valeurs des champs nommés price et quantity.
Si le nom d’un champ contient des espaces, placez le nom complet entre crochets :
[Prix unitaire] * quantité
Utilisez des noms de champ significatifs et uniques pour que les formules restent compréhensibles lorsqu’un formulaire change.
Reportez-vous à la section Propriétés des champs de formulaire pour connaître les exigences relatives aux noms de champs.
Utilisation de valeurs littérales
Une valeur littérale est une valeur fixe incluse directement dans la formule.
Les exemples incluent :
- Chiffres : 10
- Texte : « Approuvé »
- Dates utilisées par les fonctions de date prises en charge
Placez les chaînes de texte entre guillemets simples ou doubles.
Par exemple :
« Approuvés »
Les valeurs littérales peuvent être combinées à des champs, des opérateurs et des fonctions.
Opérateurs pris en charge
Utilisez des opérateurs pour effectuer des calculs, combiner du texte ou comparer des valeurs.
| Opérateur | Opération |
|---|---|
| + | Ajouter |
| - | Soustraire |
| / | Diviser |
| * | Produit |
| & | Combinaison de chaînes de texte |
| = | Égal à |
| != | N’est pas égal à |
| < | Inférieur à |
| <= | Inférieur ou égal à |
| > | Supérieur à |
| >= | Supérieur ou égal à |
| % | Renvoyer le reste après une division |
| ^ | Élever une valeur à une puissance |
Les opérateurs de comparaison renvoient un résultat vrai ou faux et peuvent être utilisés dans des fonctions logiques.
Par exemple :
total >= 1000
évalue si la valeur du total est d’au moins 1 000.
Fonctions mathématiques
| Fonction | Résultat |
|---|---|
| abs(number1) | Renvoie la valeur absolue d’un nombre. |
| roundUp(number1) | Arrondit un nombre à la hausse. |
| roundDown(number1) | Arrondit un nombre à la baisse. |
| round(number1) | Arrondit un nombre à l’entier le plus proche. |
| min(number1,number2) | Renvoie le plus petit des deux nombres. |
| max(number1, number2) | Renvoie le plus grand des deux nombres. |
Exemple
max(Amount1, Amount2)
renvoie la plus grande des deux valeurs de champ.
Fonctions de date
| Fonction | Résultat |
|---|---|
| datePart(part, date) | Renvoie une portion spécifiée d’une date sous forme d’entier. |
| dateAdd(part, date, addition) | Ajoute un nombre spécifique d’unités de temps à une date. Utilisez une valeur négative pour soustraire. |
| dateDiff(part, date1, date2) | Renvoie la différence entre deux dates, exprimée dans l’unité de temps spécifiée. |
| daysIn(part, date) | Renvoie le nombre de jours dans la partie spécifiée d’une date. |
| date(string) | Convertit une valeur texte représentant une date en valeur de date qui peut être utilisée par d’autres fonctions. |
| now() | Renvoie la date et l’heure d’évaluation de la formule. |
Valeurs de l’unité de temps
Utilisez ces valeurs pour l’argument part dans les fonctions de date prises en charge :
| Valeur | Partie de date ou d’heure |
|---|---|
| y | Année |
| q | Trimestre |
| m | Mois |
| d | jours |
| h | Heure |
| n | Minute |
| s | Seconde |
Exemple
dateAdd("d", StartDate, 30)
ajoute 30 jours à la valeur du champ StartDate .
Servez-vous d’un nombre négatif pour calculer une date antérieure :
dateAdd("d", StartDate, -7)
Fonctions logiques
Utilisez les fonctions logiques quand une valeur calculée dépend d’une ou plusieurs conditions.
| Fonction | Résultat |
|---|---|
| if(logical_test, value_if_true, value_if_false) | Renvoie une valeur lorsque le test est vrai et une autre lorsqu’il est faux. |
| and(logical1, logical2, ...) | Renvoie la valeur true uniquement lorsque toutes les conditions spécifiées sont remplies. |
| or(logical1, logical2, ...) | Renvoie la valeur true lorsqu’au moins une condition spécifiée est remplie. |
| not(logical) | Inverse un résultat true ou false. |
| lookup(sourceField, values, default_value) | Renvoie une valeur associée au champ source ou une valeur par défaut quand aucune correspondance n’est trouvée. |
Utilisation de if pour choisir entre les résultats
Par exemple :
if(Total >= 1000, "Approbation requise", "Approuvé")
renvoie une valeur texte quand Total est d’au moins 1000 et une autre quand ce n’est pas le cas.
Les résultats vrai et faux peuvent eux-mêmes contenir des expressions.
Combinaison de tests logiques (and, or, not)
Utilisez et lorsque chaque condition doit être true :
and(Age >= 18, Consent = "Yes")
Utilisez ou lorsque n’importe quelle condition peut être vraie :
or(State = "CA", State = "OR")
Utilisez not lorsque vous avez besoin de l’opposé d’une condition :
not(Status = "Closed")
Mappage d’une valeur sur une autre avec lookup
Utilisez lookup lorsqu’une valeur source doit renvoyer une valeur correspondante.
Par exemple :
lookup(State, "CA=California,UT=Utah,WA=Washington", "Other")
renvoie le nom d’état mappé lorsqu’une correspondance existe et Autre dans le cas contraire.
Cela est utile lorsque la valeur source provient d’un ensemble défini de choix, comme un champ Liste déroulante ou Case d’option.
Exemples de formules
Calcul d’un montant
quantité * [Prix unitaire]
Multiplie une quantité par un prix unitaire.
Addition de plusieurs valeurs
sous-total + taxes + frais d’expédition
Ajoute les valeurs de trois champs.
Calcul d’un pourcentage
sous-total * Tauxtaxe
Multiplie un champ par un taux stocké dans un autre champ.
Renvoyer une valeur de manière conditionnelle
if(quantité >= 10, [Prix unitaire] * 0.9, [Prix unitaire])
renvoie une valeur réduite lorsque la quantité atteint le seuil défini.
Calcul d’une date future
dateAdd("m", StartDate, 12)
renvoie une date 12 mois après StartDate.
Combinaison de texte
RecipientName & " - " & Company
combine les valeurs de champ et le texte littéral en un seul résultat.
Création de formules plus faciles à maintenir
Utilisez des noms de champs explicites et gardez les calculs associés aussi simples que le formulaire le permet.
Lors de la révision d’une formule, vérifiez que :
- Chaque champ référencé existe.
- Les noms de champs correspondent à ceux utilisés dans la formule.
- Les champs contenant des espaces sont placés entre crochets.
- Les littéraux de texte sont placés entre guillemets.
- Les fonctions contiennent les arguments requis.
- Le champ calculé génère la valeur attendue en fonction des saisies prévues du destinataire.
Pour configurer le champ calculé et formater les résultats de nombre, voir Création d’un champ calculé.
Simplifiez votre travail avec Acrobat Sign
Gérez et signez des documents en ligne rapidement et facilement.
