Ajout de champs calculés à un formulaire

Adobe Acrobat Sign permet de mettre à jour dynamiquement les champs d’un document (accord) en fonction des données saisies par le signataire lors de la signature de l’accord. Cette mise à jour dynamique peut être effectuée par le biais de champs calculés. Vous pouvez utiliser des champs calculés pour configurer des règles dans un document (ou un modèle de document) avant de l’envoyer pour signature. Ces règles sont traitées lorsque le signataire interagit avec le document et le met à jour dynamiquement en fonction des champs/valeurs.

Les champs calculés peuvent être définis dans les documents à l’aide des mécanismes suivants :

• Environnement de création de formulaires Acrobat Sign
• Balises de texte d’Acrobat Sign (pour plus d’informations, voir la documentation sur les balises de texte)
• Champs de formulaire PDF Adobe Acrobat (pour plus d’informations, voir le guide de référence sur la création de formulaires dans Acrobat)

Exemples d’utilisation des champs calculés

Des champs calculés peuvent être utilisés dans tous les cas où un document doit être mis à jour de manière dynamique au moment de la signature. Vous trouverez ci-dessous quelques exemples d’utilisation des champs calculés. Ces exemples sont fournis a des fins d’illustration uniquement.

1. Configuration d’un formulaire de commande : les champs calculés peuvent être utilisés pour configurer un formulaire de commande dans lequel le signataire a la possibilité d’effectuer une sélection dans une liste d’articles disponibles et de spécifier une quantité. La sélection d’un article dans la liste met automatiquement à jour le formulaire avec le prix de celui-ci. La quantité sélectionnée par le signataire est également le résultat du coût total de l’article qui est calculé automatiquement. Le formulaire peut également comporter des calculs supplémentaires pour déterminer le montant total des taxes ou calculer une remise en fonction des règles métier.

2. Remplissage automatique de la date d’expiration d’un contrat : pour les accords permettant aux clients de choisir la durée au moment de la signature (6 mois, 12 mois, 24 mois, etc.), un champ calculé peut être utilisé pour renseigner automatiquement la date de fin du contrat en fonction de la sélection effectuée par le client au moment de la signature du contrat.

3. Formulaires d’inscription avec plusieurs choix : un champ calculé peut être utilisé pour configurer des formulaires d’inscription (formulaires d’abonnement, par exemple) dans lesquels la personne apposant sa signature peut effectuer un choix parmi plusieurs options disponibles. Les choix effectués par le signataire peuvent entraîner d’autres aspects dynamiques des formulaires (conditions, durée du contrat, coût total, etc.).

Notions de base sur les champs calculés

Tout champ de formulaire, champ de case à cocher ou champ de case d’option d’un formulaire Acrobat Sign peut être marqué comme étant un champ calculé. Au moment de la signature, le signataire ne peut pas directement saisir une valeur dans un champ désigné comme champ calculé. La valeur du champ est automatiquement calculée en fonction des règles définies dans le formulaire.

Une définition de champ calculé est composée de deux parties : l’expression et le format.

Les champs calculés peuvent être définis à l’aide de balises de texte d’Acrobat Sign, de l’application web Acrobat Sign ou des champs de formulaire PDF. Lors de l’utilisation de balises de texte d’Acrobat Sign ou de champs de formulaire PDF pour définir les champs calculés, l’expression du calcul est définie à l’aide de la directive « calc ». La mise en forme du champ calculé peut être spécifiée à l’aide d’une directive appelée “format”.

Exemple

{{someCalculatedField_es_:signer1:calc(someExpn):format(formatType, someFormat)}}

Cet exemple montre des balises de texte étant utilisées pour définir un champ dans un document appelé « someCalculatedField ». Ce champ est affecté au destinataire identifié comme signer1. La valeur de ce champ est calculée en fonction de la formule spécifiée dans « someExpn ». Le type de la valeur obtenue est spécifié par le paramètre « formatType » et mis en forme selon le format défini en tant que « someFormat ».

L’environnement de création de l’application web Acrobat Sign propose un créateur d’expressions entièrement fonctionnel pour définir les formules des champs calculés. Pour plus d’informations sur la création d’expressions, voir Utilisation du créateur d’expressions pour spécifier des champs calculés.

Expressions de champ calculé

L’expression définit la formule/règle pour déterminer la valeur du champ calculé. Une expression peut être composée de l’un ou de plusieurs des éléments suivants :

Opérateurs pris en charge

Les opérateurs suivants sont pris en charge dans les champs calculés.

Fonctions prises en charge

Les fonctions suivantes sont prises en charge lors de la spécification des expressions dans un champ calculé.

Valeurs acceptées pour les parties de date

Les valeurs suivantes peuvent être utilisées dans les fonctions liées aux dates lorsque la partie de la date sur laquelle la fonction doit opérer est spécifiée.

Mise en forme des champs calculés

En plus de spécifier l’expression d’un champ calculé, vous pouvez également mettre en forme la valeur de sortie. La sortie peut être au format texte (par défaut) ou mise en forme en tant que nombre ou date.

Lorsqu’elle est utilisée avec des balises de texte, la directive de format accepte deux arguments : FormatType et Format.

Mise en forme des champs calculés en tant que nombres

Les caractères suivants peuvent être utilisés pour spécifier la mise en forme d’une sortie en tant que nombre.

Mise en forme des champs calculés sous forme de date

Les caractères suivants peuvent être utilisés pour spécifier la mise en forme d’une sortie en tant que date.

Exemples de mise en forme

Les exemples suivants montrent comment mettre en forme les champs calculés de date et de nombre.

• Champ calculé mis en forme en tant que date :

{{myField_es_:calc(otherDateField + 3):format(date, "mmm dd, yyyy")}}

La sortie sera « May 22, 2016 ».

• Champ calculé mis en forme en tant que nombre.

{{myTax_es_:calc(total * taxrate):format(number, "$,.00") }}

La sortie sera « $1,987,65 ».

À l’aide du créateur d’expressions pour spécifier les champs calculés

Les champs calculés peuvent être spécifiés dans l’environnement de création d’Acrobat Sign. La procédure ci-dessous vous guide tout au long des étapes nécessaires pour définir un champ calculé lorsque vous vous trouvez dans l’environnement de création.

1. Effectuez un glisser-déposer d’un champ dans le document. Double-cliquez sur le champ que vous venez d’ajouter pour afficher la boîte de dialogue des propriétés de champ. Attribuez au champ un nom adéquat. Changez l’attribut Type de valeur à l’aide de la liste déroulante en type Valeur calculée. Cela signifie que la valeur du champ est déterminée en fonction d’un calcul au moment de la signature.

2. Saisissez l’expression de calcul dans le champ de texte appelé Formule ou cliquez sur le bouton de fonction ( fx ) pour ouvrir le créateur d’expressions.

3. Utilisez le créateur d’expressions pour définir l’expression du champ calculé (voir la figure ci-dessous). La zone d’expression dans la partie supérieure affiche la formule qui sera utilisée pour calculer la valeur du champ. Vous pouvez saisir la formule dans la zone d’expression ou utiliser l’environnement de création pour créer la formule. Le créateur d’expressions fournit la liste de toutes les fonctions disponibles, la liste des champs de formulaire existants dans le document, ainsi que la liste des opérateurs pris en charge pour vous aider à créer des expressions. Vous pouvez ajouter un champ ou une fonction à une formule en double-cliquant sur l’élément dans la zone de liste du créateur d’expressions. Vous pouvez également ajouter des opérateurs à l’expression en cliquant sur un opérateur spécifique dans la liste des opérateurs.

4. Une fois que vous avez terminé de définir l’expression, vous pouvez vérifier sa syntaxe en cliquant sur le bouton Vérifier la syntaxe et enregistrer les modifications.

5. Définissez le type des champs calculés à l’aide de la liste déroulante Afficher comme.

6. Si la valeur Afficher comme est Date ou Nombre, définissez la valeur du champ Format date/numérique à l’aide de la liste déroulante. Vous pouvez également sélectionner une mise en forme personnalisée pour le champ.

Champs calculés avec un format de devise

Le format de devise d’un champ calculé insère un symbole de devise avant la valeur calculée. (Le calcul est par ailleurs un calcul mathématique simple, tel que dicté par la formule.)

Le symbole inséré est basé sur les règles ci-dessous :     

• Si les champs source contiennent une validation de devise pour les États-Unis, le symbole affiché est le dollar américain : $
• Si les champs source contiennent une validation de devise pour le Royaume-Uni, le symbole affiché est la livre sterling : £

Pour que le formatage de devise fonctionne, le champ calculé doit être configuré comme suit :

• Valeur Afficher comme définie sur Nombre
  
• Valeur Format numérique définie sur Devise
  

Une validation de nombre ou de devise peut être appliquée aux champs source utilisés dans le calcul :

Exemples de champs calculés

• {{shipState_es_:signer1:calc([billingState]):showif(sameAs=unchecked)}}
  • Champ dans le document affecté au premier signataire qui est affiché uniquement lorsqu’un autre champ (case à cocher) « sameAs » est décoché. La valeur du champ est automatiquement renseignée avec la valeur du champ « billingState » que le signataire a saisi dans document.
• {{total_es_:signer1:calc(q1*pr1):format(Number,”$,0.00”):align(right)}}
  • Champ dans le document affecté au premier signataire. Sa valeur est automatiquement calculée comme le produit des valeurs des champs « q1 » et « pr1 ». La valeur obtenue est mise en forme comme une devise et affichée avec le symbole du dollar ($) devant la valeur obtenue avec deux chiffres après le point. La valeur obtenue est aussi alignée à droite dans le champ.
• price_es_:signer1:calc(if(pn1=”W1”,9.99,if(pn1=”W2”,5.99,if(pn1=”W3”,24.99,0))))}
  • Un champ dans document appelé « price » qui est calculé en fonction de la valeur sélectionnée par le signataire dans d’autres champs « pn1 » du document. Dans cet exemple, si le champ « pn1 » est égal à W1, la valeur affichée dans le champ « price » est 9.99. Si le champ « pn1 » est égal à W2, la valeur affichée dans le champ « price » est 5.99, etc. Si aucune des valeurs ne correspond à la valeur du champ « pn1 », la valeur affichées dans « price » est 0. Grâce à ce mécanisme, les champs calculés peuvent être utilisés pour renseigner automatiquement le prix d’un article en fonction de la sélection effectuée par un signataire pendant la signature.