Vous pouvez remplir de manière dynamique un message de script de validation à l’aide d’une valeur issue d’une source de données. Vous serez ainsi assuré que les utilisateurs saisissent la valeur correcte dans le champ.
Par exemple, vous pouvez afficher un message d’erreur personnalisé lorsque les utilisateurs saisissent des données dans un champ qui ne correspondent pas à ce que le script attend. Par exemple, un script peut être associé à un champ numérique, tel que Quantité, pour indiquer que le nombre spécifié dans ce champ ne peut pas être supérieur à 100. Si l’utilisateur saisit un nombre supérieur à 100, un message d’erreur personnalisé s’affiche.
Les éléments suivants peuvent être définis pour un script de validation pour le schéma auquel vous vous connectez :
<form>
<validationScript dp_scriptMessage="message1"/>
</form>
Les éléments suivants peuvent être définis pour le script de validation pour le fichier de données sur lequel vous pointez :
<form>
<validationScript dp_scriptMessage="DP Script Message - The quantity must be less than or equal to 100."/>
</form>
Lorsque vous fusionnez le fichier de données avec la conception de formulaire et que vous saisissez un nombre supérieur à 100 dans le champ Quantité, un message d’erreur s’affiche.
Autre exemple : vous pourriez afficher des messages d’erreur personnalisés associés à un script dans une autre langue. Les éléments suivants peuvent être définis pour le script de validation pour le fichier de données sur lequel vous pointez :
<form>
<validationScript dp_scriptMessage="Entrez un nombre inférieur ou égal à 100."/>
</form>
Lorsque vous fusionnez le fichier de données avec la conception de formulaire et que vous saisissez un nombre supérieur à 100 dans le champ Quantité, un message d’erreur en français s’affiche.
Remarque :
Pour utiliser un texte non ASCII (tels que les accents) dans votre fichier de données, assurez-vous qu’il est correctement codé et que le codage est correctement identifié dans l’instruction de traitement XML. Par exemple :
<?xml version="1.0" encoding="UTF-8"?>
Avant d’effectuer cette tâche, assurez-vous que les paramètres suivants sont appliqués :
-
Cliquez sur la catégorie Standard de la palette Bibliothèque d’objets, puis faites glisser un objet sur la conception de formulaire.
Par exemple, insérez un objet de champ numérique.
-
(Facultatif) Dans la palette Objet, cliquez sur l’onglet Champ et tapez une légende pour l’objet de la zone Légende.
Par exemple, saisissez
Quantité
.
-
Dans l’éditeur de script, sélectionnez Valider dans la liste Afficher.
-
Dans l’éditeur de script, sélectionnez un langage dans la liste Langage.
Par exemple, sélectionnez JavaScript dans la liste Langage.
-
Saisissez un script pour l’objet.
Par exemple, saisissez ce script pour le champ Quantité :
this.rawValue <= 100
-
Dans la palette Objet, cliquez sur l’onglet Valeur, puis cliquez sur le libellé actif Message de script de validation.
-
Sélectionnez la connexion aux données.
Remarque :
Si vous n’êtes pas connecté à une source de données, Liaison des données par défaut est la seule sélection possible dans la liste Connexion aux données.
-
Cliquez sur le triangle situé à côté de la zone Liaison et sélectionnez une liaison.
Par exemple, sélectionnez validation >@dp_scriptMessage.
La chaîne suivante apparaît dans la zone Liaison :
$record.validation.dp_scriptMessage
Vous pouvez taper cette chaîne dans la zone Eléments au lieu de la sélectionner.
-
Cliquez sur OK.
-
Affichez le message d’erreur à partir du panneau Aperçu PDF.
Par exemple, dans le panneau Aperçu PDF, saisissez une quantité supérieure à 100.