> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alyzai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Utiliser les nœuds et variables

> Relier les étapes d’un workflow et transmettre les bonnes données d’un nœud au suivant.

> [!NOTE]
>
> Tutoriel · 10 min

## Résultat attendu

Le workflow possède un chemin lisible de l’entrée au résultat, et chaque nœud utilise des variables
provenant d’une étape antérieure. Vous pourrez expliquer l’origine de chaque valeur sans ouvrir
toutes les étapes au hasard.

## Avant de commencer

* Créez le déclencheur et au moins deux nœuds dans un brouillon.
* Repérez les champs produits par la première étape.
* Utilisez une entrée de test dont vous connaissez les valeurs.
* N’insérez pas de secret en texte libre dans un nœud ou un champ de journalisation.

## Construire le flux

**1. Ajoutez une première action**

Depuis la palette **+**, choisissez un nœud correspondant à une seule responsabilité : lire
une source, transformer une valeur, décider ou agir. Donnez-lui un nom qui décrit son résultat.

**2. Reliez les ports**

Faites glisser une connexion du port de sortie vers le port d’entrée du nœud suivant. Vérifiez
le sens de l’arête et l’absence de nœud isolé.

<video autoPlay muted loop playsInline controls alt="Démonstration de l’ajout et de la connexion d’un nœud d’automatisation" aria-label="Démonstration de l’ajout et de la connexion d’un nœud d’automatisation" poster="/images/product/automatisations/editeur.png">
  <source src="https://mintcdn.com/alyzai/St7evzCbpXJOLQ-i/videos/relier-un-noeud.mp4?fit=max&auto=format&n=St7evzCbpXJOLQ-i&q=85&s=9b44d34127331786c409d701f79aa225" type="video/mp4" />

  Votre navigateur ne peut pas lire la démonstration. Utilisez l’image du canvas ci-dessous.
</video>

La démonstration montre le geste nécessaire pour relier la sortie d’un nœud à l’entrée du suivant.

**3. Inspectez la sortie disponible**

Ouvrez la sortie de l’étape précédente et repérez le nom, le type et la structure du champ
nécessaire. Ne supposez pas qu’une valeur affichée comme un nombre ou une date possède déjà le
bon type.

**4. Réutilisez le champ précis**

Dans l’inspecteur du nœud suivant, insérez la variable correspondant à cette sortie. Donnez la
priorité à un champ explicite plutôt qu’à l’objet complet ; le mappage sera plus lisible et
moins sensible aux changements non liés.

![Canvas d’une automatisation Alyzai avec plusieurs nœuds reliés](https://mintcdn.com/alyzai/St7evzCbpXJOLQ-i/images/product/automatisations/editeur.png?fit=max\&auto=format\&n=St7evzCbpXJOLQ-i\&q=85\&s=bc272372164b4e7e6a7926e69e4a38e8)

Le canvas rend visibles les nœuds, leurs connexions et le chemin suivi par les variables.

**5. Ajoutez les branches nécessaires**

Utilisez une condition uniquement lorsque le processus doit réellement suivre des chemins
différents. Nommez chaque branche par son résultat attendu et prévoyez le cas où aucune
condition métier n’est satisfaite.

## Règles de lisibilité

* Un nœud réalise une action principale.
* Son nom décrit un verbe et un objet : « Valider le format », « Créer la tâche ».
* Une variable n’est utilisée qu’après sa production.
* Les données sensibles ne sont pas recopiées dans les champs de journalisation.

> [!WARNING]
>
> Renommer ou supprimer la sortie d’un nœud peut casser les étapes qui la réutilisent. Vérifiez
> les références avant de déployer une nouvelle version.

## Vérification finale

* Chaque arête relie une sortie à l’entrée prévue.
* Les variables utilisées existent sur tous les chemins qui atteignent le nœud.
* Les types et formats attendus sont compatibles.
* Une valeur absente suit une branche ou une erreur contrôlée.
* Aucun secret n’est recopié dans un champ visible ou journalisé.
* Le canvas permet d’expliquer le parcours de la donnée sans ambiguïté.

## En cas de problème

| Symptôme | Contrôle recommandé |
| - | - |
| Une variable n’est pas proposée | Vérifiez la connexion, le chemin d’exécution et la sortie du nœud précédent. |
| La valeur est vide pendant le test | Inspectez l’entrée, le nom du champ et la branche réellement suivie. |
| Un nœud reçoit un objet au lieu d’un champ | Mappez explicitement la propriété nécessaire. |
| Une condition n’emprunte aucune branche | Ajoutez un cas par défaut ou corrigez les types comparés. |
| Une modification casse plusieurs étapes | Recherchez toutes les références à la sortie avant de renommer ou supprimer. |

## Étape suivante

> [card] [Tester et déployer](https://docs.alyzai.com/fr/automatisations/tester-et-deployer.md)
>
> Exécuter un scénario contrôlé avant de rendre la version active.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.