Aller au contenu

Files de travail · Étape

Ajouter à une file `queue.add`

Ajoute un élément à une file de travail ; une référence déjà présente est ignorée.

Type: queue.add
Famille: Files de travail
Exécuté par: Orchestrator
Quand l’utiliser: Découper un volume (lecture d'un portail, d'un dossier) en éléments traités ensuite en parallèle.

Synopsis

{
  "id": "file",
  "type": "queue.add",
  "label": "Mettre en file",
  "props": {
    "queue": "Factures à saisir",
    "reference": "{{ligne.numero}}",
    "data": "{{ligne}}",
    "priority": "0"
  }
}

Propriétés

Toutes les valeurs s’écrivent en chaînes JSON et acceptent l’interpolation {{variable}}. Voir Objet Étape.

Propriété	Type	Requis	Défaut	Description
`queue`	texte	oui	—	Nom de la file (ZOKAS Agent › Files de travail). Ex. `Factures à saisir`
`reference`	texte	non	—	Référence unique (anti-doublon). Ex. `{{ligne.numero}}`
`data`	json	non	—	Données de l'élément (objet JSON ou variable). Ex. `{{ligne}}`
`priority`	nombre	non	`0`	Priorité (plus grand = plus tôt).
`into`	variable	non	—	Variable qui reçoit l'identifiant de l'élément.

Résultat

Variable: (into, facultatif) — modifiable par into
Nature: texte
Contenu: Identifiant de l'élément créé (vide si doublon).

Voir aussi

Source : orchestrator/zokas_orch/runtime.py — PackageRunner._queue ; orchestrator/zokas_orch/work.py

Mis à jour le 28 octobre 2026