Débogage des calculs et des scripts

Designer propose différentes fonctions et stratégies pour le débogage des calculs et des scripts, en fonction du langage de script choisi.

Pour le débogage des scripts utilisant le langage JavaScript, vous pouvez utiliser les méthodes alert ou messageBox pour fournir des commentaires de débogage. L’inconvénient de cette méthode tient au fait que vous devez fermer de nombreuses zones de message. L’autre inconvénient est que l’affichage d’une zone de message peut entraîner des différences de comportement du formulaire, notamment si vous tentez de déboguer un script qui définit la cible d’action sur un objet de votre formulaire. Il est préférable d’utiliser console.printIn pour générer le texte dans la console JavaScript depuis Acrobat afin de déboguer un formulaire.

Messages d’avertissement et de validation de la palette Rapport dans Designer

La palette Rapport envoie des messages d’avertissement et de validation qui vous aident à déboguer un formulaire à mesure que vous le concevez. L’onglet Avertissement répertorie les erreurs ou les messages généré(e)s par Designer à mesure que vous créez un formulaire. L’onglet Journal affiche les erreurs et les messages suivants :

  • Messages de validation

  • Erreurs d’exécution de script JavaScript ou FormCalc

  • Erreurs de rendu du formulaire au moment de sa conception générées lorsque vous importez ou enregistrez un formulaire ou lorsque vous le prévisualisez dans l’onglet Aperçu PDF.

Pour plus d’informations sur l’utilisation de la palette Rapport, voir Utilisation de l’espace de travail pour le débogage des calculs et des scripts .

Affichage d’informations de débogage à l’aide de la méthode messageBox

La méthode messageBox du modèle d’objet de formulaire XML permet d’extraire des informations d’un formulaire interactif dans une boîte de dialogue au moment de l’exécution. Vous pouvez utiliser la méthode messageBox du modèle d’objet de formulaire XML pour afficher les messages ou les valeurs de champs au moment de l’exécution. Une fois lancée, la méthode messageBox se charge d’afficher une valeur de chaîne dans une nouvelle boîte de dialogue de l’application client. Il peut s’agit, en l’occurrence, d’un message de texte que vous rédigez à des fins de débogage ou de la valeur de chaîne de champs ou d’expressions.

Prenons un scénario dans lequel une simple conception de formulaire contient un seul champ numérique (NumericField1) et un bouton (Button1). Dans ce cas, le calcul FormCalc et le script JavaScript génèrent chacun un message présentant du texte et la valeur actuellement affichée dans le champ numérique. En ajoutant le calcul ou le script à l’événement click de l’objet de bouton, il est possible de présenter de façon interactive la valeur du champ numérique dans une nouvelle boîte de dialogue en cliquant sur le bouton.

FormCalc

    xfa.host.messageBox(Concat("The value of NumericField1 is: ", 
        NumericField1), "Debugging", 3)

JavaScript

    xfa.host.messageBox("The value of NumericField1 is: " + 
        NumericField1.rawValue, "Debugging", 3);
Important : la méthode messageBox renvoie un nombre entier représentant le bouton que la personne remplissant le formulaire sélectionne dans la boîte de dialogue du message. Si vous associez la méthode messageBox à l’événement calculate d’un objet de champ et que la méthode messagebox est la dernière ligne du script, le champ affiche la valeur renvoyée par la méthode messageBox au moment de l’exécution.

Pour plus d’informations sur messageBox , voir messageBox

Extraire des informations dans un champ de texte

Vous pouvez extraire des informations (ex.: valeurs de champs ou messages) dans un champ de texte sur votre conception de formulaire. Par exemple, vous pouvez ajouter de nouveaux messages ou de nouvelles valeurs à la valeur d’un champ de texte afin de créer un journal que vous pourrez consulter régulièrement.