La validation ne se déclenche pas, ou trop souvent (email, téléphone, adresse)

Support DQE
Support DQE
  • Mise à jour

Symptôme : une validation ne se déclenche pas, se déclenche trop souvent, ou un champ n'est pas revalidé après une erreur. Vous voulez savoir quand chaque appel est envoyé.

Versions concernées : 1.0.0.

Adresse : deux appels distincts

AppelDéclencheurDélaiService DQE
SuggestionsLe client saisit dans la ligne d'adresse (au moins 2 caractères)600 ms après la dernière frappeSINGLEV
ValidationSoumission du formulaire, si la validation est encore requise pour l'adresseImmédiatRNVP

La validation est de nouveau requise à chaque modification d'un champ d'adresse, et n'est plus requise une fois qu'une suggestion est sélectionnée, selon le mode de validation.

Modes de validation

Le mode est défini par la préférence de site Business Manager dqeAddressValidationMode. Si la préférence est absente, la valeur par défaut est validate_on_manual_change.

ModeComportement
validate_alwaysValidation à chaque soumission.
validate_on_manual_inputValidation uniquement si aucune suggestion n'a été sélectionnée.
validate_on_manual_changeAprès la sélection d'une suggestion, aucune validation tant que le client ne modifie pas de nouveau un champ.

Si un client ne voit pas de validation à la soumission, vérifiez d'abord le mode configuré et si une suggestion a été sélectionnée.

Email et téléphone

ÉvénementComportement
Le client quitte le champ après l'avoir modifiéAppel immédiat, si la valeur n'est pas vide.
Le client saisit du texteAppel 2 secondes après la dernière frappe, uniquement si le champ a déjà été modifié une fois sur la page.

Aucun appel n'est envoyé :

  • si la valeur est identique à la dernière valeur validée ;
  • si un appel précédent est encore en cours ;
  • si la valeur est vide ;
  • au premier passage, si la valeur ne correspond pas au format attendu du champ.

Le champ téléphone ignore les espaces lors de la comparaison des valeurs. Si DQE renvoie un numéro formaté, ce numéro devient la valeur de référence.

Blocage du formulaire

  • Une réponse invalid désactive le bouton de soumission et affiche un message.
  • Une réponse warn ou valid ne bloque pas le formulaire.
  • Une réponse en erreur ne bloque pas le formulaire côté navigateur (voir l'article sur le comportement du cartridge lorsque l'API DQE ne répond pas).

Bon à savoir

  • La dernière valeur envoyée est mémorisée même quand DQE a renvoyé une erreur : le même email ou le même numéro n'est pas revalidé tant que la valeur ne change pas.
  • Si la validation d'un champ ne réagit plus après un problème réseau, rechargez la page. Si le problème persiste, contactez le support DQE.

Vérification

  1. Ouvrez les outils de développement du navigateur, onglet Réseau, et filtrez sur DQE-.
  2. Modifiez un champ email, puis quittez le champ : un appel DQE-ValidateEmail doit être envoyé.
  3. Saisissez sans quitter le champ : aucun appel n'est envoyé avant la première sortie du champ.

Associé à

Cet article vous a-t-il été utile ?

Utilisateurs qui ont trouvé cela utile : 0 sur 0