Créer des processus

Utiliser des variables

Déclarer des variables, les insérer dans les étapes et récupérer les résultats.

Une variable transporte une valeur d'une étape à l'autre : un paramètre de lancement, une ligne de tableau, une réponse d'API, une décision.

Déclarer une variable de lancement

Déclarez dans l'objet variables du package les valeurs que l'opérateur pourra modifier au lancement, avec leur valeur par défaut :

"variables": {
  "url_portail": "http://demo-portal",
  "seuil": "1000"
}

ZOKAS Agent affiche ces variables dans le formulaire de lancement. L'API les reçoit dans variables (voir API de l'Orchestrator).

Insérer une variable

Écrivez {{nom}} dans n'importe quelle propriété texte. Pour un champ d'objet, utilisez le point : {{facture.montant}}, {{reponse.json.id}}, {{document.numero}}.

Récupérer un résultat

Les étapes qui produisent une donnée l'enregistrent dans la variable indiquée par into, ou dans une variable par défaut (reponse pour http.call, decision pour human.approve…). La forme de chaque résultat est décrite dans Objets de résultat.

Variables réservées

• index : rang de l'élément courant dans une boucle, à partir de 1.
• les noms commençant par __ sont réservés à l'Orchestrator (reprise, captures) : ne les utilisez pas.

Données sensibles

Ne mettez jamais un mot de passe, un jeton ou un IBAN dans variables. Utilisez le Coffre avec ui.type_secret, ou la propriété credential de http.call et cmd.run. Les variables dont le nom évoque un secret (password, token, iban…) sont masquées dans les journaux.

Mis à jour le 28 octobre 2026