Utilisez les références de champ, les valeurs littérales, les opérateurs et les 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 de ces éléments :
| É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 | Effectuer des opérations arithmétiques, de comparaison ou de texte | sous-total + taxe |
| Fonction | Effectuer un calcul prédéfini ou une opération logique | max(valeur1, valeur2) |
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 faire référence à sa valeur dans une formule.
Par exemple :
prix * quantité
utilise les valeurs des champs nommés price et quantity.
Si un nom de 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.
Consultez Propriétés des champs de formulaire pour les exigences relatives aux noms de champ.
Utilisation de valeurs littérales
Un littéral 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 avec 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 |
| & | Combiner des 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 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 vers le haut. |
| roundDown(number1) | Arrondit un nombre vers le bas. |
| 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 celle des deux valeurs de champ qui est la plus grande.
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écifié de parties de date à une date. Utilisez une valeur négative pour soustraire. |
| dateDiff(part, date1, date2) | Renvoie la différence entre deux dates en utilisant la partie de date 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 composantes de date
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.
Utilisez 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 quand le test est vrai et une autre quand il est faux. |
| and(logical1, logical2, ...) | Renvoie vrai seulement quand toutes les conditions spécifiées sont vraies. |
| or(logical1, logical2, ...) | Renvoie vrai quand au moins une condition spécifiée est vraie. |
| not(logical) | Inverse un résultat vrai ou faux. |
| 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, "Approval required", "Approved")
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 and quand chaque condition doit être vraie :
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
Calculer un montant
quantité * [Prix unitaire]
Multiplie une quantité par un prix unitaire.
Additionner plusieurs valeurs
sous-total + taxe + expédition
Additionne les valeurs de trois champs.
Calculer 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 avec réduction lorsque la quantité atteint le seuil défini.
Calculer une date future
dateAdd("m", StartDate, 12)
renvoie une date 12 mois après StartDate.
Combiner du 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
Servez-vous de noms de champ descriptifs et conservez 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 champ correspondent aux noms 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é produit la valeur prévue pour les entrées de destinataire attendues.
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.
