4.6. Nœud de validation

Si vous vouliez en savoir plus sur cette fonctionnalité, un tutoriel elearning est disponible ci-dessous :

Séparer les données avec le nœud validation

../../_images/N_FR_11.png

Le nœud validation est un outil qui deviendra rapidement indispensable pour séparer visuellement les données à problème des autres dans vos flows.

Icône : image119

  • Nombre d’entrées : 1.

  • Nombre de sorties : 1 ou 2.

Définition

Un nœud de validation envoie les enregistrements valides sur sa 1ère sortie et les enregistrements invalides sur sa 2ème sortie, s’il en a une.

Paramétrage

Deux types de validation sont disponibles :

  • La validation par champ (onglet Règles de validation de champs image120). On effectue pour chaque champ sélectionné :

    • Une vérification du type :

      pour toutes les cellules contenant une valeur non reconnue comme valide, l’enregistrement correspondant sera envoyé sur la 2ème sortie du nœud (= enregistrements invalides).

    • Une vérification de la nature :

      pour toutes les cellules contenant une valeur non reconnue comme valide, l’enregistrement correspondant sera envoyé sur la 2ème sortie du nœud (= enregistrements invalides).

    • Une vérification de la présence :

      pour toutes les cellules ne contenant pas de valeur, l’enregistrement correspondant sera envoyé sur la 2ème sortie du nœud (= enregistrements invalides).

    • Une vérification des règles de validation de champ définie dans une fonction de préparation en amont :

      dans le champ spécifié, pour toutes les cellules contenant une valeur non valide au sens de la règle (ex : liste de valeurs admises ou intervalle de validité), l’enregistrement correspondant sera envoyé sur la 2ème sortie du nœud (= enregistrements invalides).

  • La validation par enregistrement (onglet Règles de validation de lignes image121).

    On effectue pour chaque règle cochée une vérification de la validité de l’enregistrement. Tout enregistrement non valide sera envoyé sur la 2ème sortie du nœud (= enregistrements invalides). Les règles de validation d’enregistrements doivent être apposées dans un nœud de préparation en amont.

Exemple visuel

image122

Ici, par exemple, on met en place une validation par champ pour vérifier pour chaque champ :

  • Son type : Ici dans le champ de type date, pour toutes les cellules contenant une valeur non reconnue comme une date valide, l’enregistrement correspondant sera envoyé sur la 2ème sortie du nœud (= enregistrements invalides).

  • Sa nature : Ici dans le champ identifié comme contenant des e-mails, pour toutes les cellules contenant une valeur non reconnue comme un e-mail valide, l’enregistrement correspondant sera envoyé sur la 2ème sortie du nœud (= enregistrements invalides).

  • Sa présence : Ici pour toutes les cellules ne contenant pas de valeur, l’enregistrement correspondant sera envoyé sur la 2ème sortie du nœud (= enregistrements invalides).

Exemples pratiques

Note

Exemple 1 : Validation de champ de base avec vérification de nature

Avant l’opération :

ID

Email

Âge

Date d’inscription

Numéro de téléphone

1

user@example.com

25

2021-05-21

123-456-7890

2

invalid-email

30

2020-11-15

987-654-3210

3

anotheruser@domain.ai

19

2022-01-10

Bonjour

Configuration du nœud :

  • Configuration du filtre de champ :

    • Vérification de la nature pour la colonne « Email » : Doit correspondre au format standard d’une adresse e-mail.

    • Règle de champ pour la colonne « Âge » : Doit être un nombre compris entre 18 et 65.

    • Vérification de la nature pour la colonne « Numéro de téléphone » : Doit correspondre au format valide d’un numéro de téléphone.

    • Vérification que la Date d’inscription n’est pas vide.

Après l’opération :

  • Enregistrements valides (sortie verte) :

ID

Email

Âge

Date d’inscription

Numéro de téléphone

1

user@example.com

25

2021-05-21

123-456-7890

  • Enregistrements invalides (sortie rouge) :

ID

Email

Âge

Date d’inscription

Numéro de téléphone

2

invalid-email

30

2020-11-15

987-654-3210

3

anotheruser@domain.ai

19

2022-01-10

Bonjour

Dans cet exemple, l’enregistrement 2 est invalide à cause d’un format d’e-mail incorrect, et l’enregistrement 3 est invalide car le numéro de téléphone ne correspond pas à la nature attendue d’un format de numéro de téléphone valide.

Note

Exemple 2 : Validation combinée des champs et des enregistrements avec vérifications de type et de nature

Avant l’opération :

ID

Montant

Remise

Prix final

Code pays

1

100

10

90

USA

2

150

20

140

FRA

3

200

15

185

Bonjour

Configuration du nœud :

  • Configuration du filtre de champ :

    • Règle de champ pour la colonne « Montant » : Doit être un nombre positif (vérification de type).

    • Règle de champ pour la colonne « Remise » : Doit être comprise entre 0 et 30 (vérification de type et d’intervalle).

    • Règle de champ pour la colonne « Prix final » : Vérification que c’est une valeur numérique.

    • Vérification de la nature pour la colonne « Code pays » : Doit correspondre à un code ISO-3166-1 alpha3 valide.

  • Configuration du filtre d’enregistrement :

    • Règle sélectionnée : Prix final doit être égal à Montant - Remise (cette règle doit être définie dans un nœud de préparation en amont).

Après l’opération :

  • Enregistrements valides (sortie verte) :

ID

Montant

Remise

Prix final

Code pays

1

100

10

90

USA

  • Enregistrements invalides (sortie rouge) :

ID

Montant

Remise

Prix final

Code pays

2

150

20

140

FRA

3

200

15

185

Bonjour

Dans cet exemple, le deuxième enregistrement est invalide en raison d’un écart entre le « Prix final » et le calcul « Montant - Remise ». Le troisième enregistrement est invalide car « Bonjour » ne correspond pas à un code pays ISO valide.