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
| Appel | Déclencheur | Délai | Service DQE |
|---|---|---|---|
| Suggestions | Le client saisit dans la ligne d'adresse (au moins 2 caractères) | 600 ms après la dernière frappe | SINGLEV |
| Validation | Soumission du formulaire, si la validation est encore requise pour l'adresse | Immédiat | RNVP |
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.
| Mode | Comportement |
|---|---|
validate_always | Validation à chaque soumission. |
validate_on_manual_input | Validation uniquement si aucune suggestion n'a été sélectionnée. |
validate_on_manual_change | Aprè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énement | Comportement |
|---|---|
| Le client quitte le champ après l'avoir modifié | Appel immédiat, si la valeur n'est pas vide. |
| Le client saisit du texte | Appel 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
invaliddésactive le bouton de soumission et affiche un message. - Une réponse
warnouvalidne 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
- Ouvrez les outils de développement du navigateur, onglet Réseau, et filtrez sur
DQE-. - Modifiez un champ email, puis quittez le champ : un appel
DQE-ValidateEmaildoit être envoyé. - Saisissez sans quitter le champ : aucun appel n'est envoyé avant la première sortie du champ.
Associé à