Aller au contenu

Fichiers · Étape

Lister un dossier `file.list`

Liste les fichiers d'un dossier du poste du robot, avec un filtre facultatif.

Type: file.list
Famille: Fichiers
Exécuté par: Robot
Quand l’utiliser: Traiter tous les PDF d'un dossier, repérer les nouveaux fichiers.

Synopsis

{
  "id": "liste",
  "type": "file.list",
  "label": "Lister les factures",
  "props": {
    "path": "~/Documents/Factures",
    "pattern": "*.pdf",
    "into": "fichiers"
  }
}

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
`path`	chemin	oui	—	Dossier (~ = dossier personnel). Ex. `~/Documents/Factures`
`pattern`	texte	non	`*`	Filtre de noms (jokers * et ?). Ex. `*.pdf`
`into`	variable	non	`resultat`	Variable liste. Ex. `fichiers`

Résultat

Variable: resultat — modifiable par into
Nature: liste d'objets
Contenu: Un objet par fichier. Voir l’objet Fichier.

Remarques

Les chemins sont limités aux dossiers autorisés au robot (ZOKAS_ROBOT_FILE_ROOTS).

Erreurs fréquentes

Message	Cause	Solution
`chemin hors des dossiers autorisés`	Le dossier n'est pas sous ZOKAS_ROBOT_FILE_ROOTS.	Ajoutez la racine au réglage du robot.

Voir aussi

Source : orchestrator/zokas_orch/runtime.py — ROBOT_STEPS (fs_list) ; robot/zokas_robot/files.py — listing

Mis à jour le 28 octobre 2026