Comment traiter un CSV ou Excel et reprendre le lot à mi-parcours ?

Que faut-il corriger dans le tableur avant le traitement ?

• Utilisez des en-têtes clairs et uniques ainsi qu’une clé métier non vide et unique pour le lot.
• Conservez les colonnes d’identifiants au format Texte. Le format Excel n’est pas appliqué : une cellule numérique affichée 07001 peut être lue 7001, et 15 % comme 0,15.
• Exportez uniquement les lignes à traiter. Les lignes masquées ou filtrées du XLSX sont tout de même lues.
• Enregistrez les résultats calculés dans Excel. Les erreurs de formule ou les formules sans résultat enregistré sont traitées comme vides lorsqu’elles sont référencées.
• Ne placez pas d’identifiants secrets dans les fichiers d’entrée. Déclarez plutôt des paramètres secrets issus de l’environnement.

Ritoko accepte les CSV séparés par des virgules ou des points-virgules en UTF-8 ou Windows-1252, ainsi que les fichiers .xlsx avec choix de feuille. Ce n’est pas un lecteur universel de tous les tableurs. Voir la référence des fichiers d’entrée.

Comment définir l’opération de chaque ligne ?

Déclarez le chemin d’entrée, la clé, le périmètre de destination et les colonnes obligatoires. Marquez l’écriture irréversible comme commit, puis ajoutez un contrôle prouvant le résultat de cette ligne. Utilisez readOnly: true pour un lot qui ne fait que lire ou télécharger.

L’entrée entière est validée avant le traitement : en-têtes mal formés, clés en double ou vides, et valeurs référencées manquantes sont rejetés. Cela détecte des problèmes d’entrée, mais ne prouve pas que chaque valeur convient au système métier distant. Commencez par un petit lot représentatif et autorisé.

Dois-je modifier le tableur pour supprimer les lignes déjà traitées ?

Il n’est pas nécessaire de supprimer les lignes terminées pour reprendre un lot existant. Le journal enregistre ses lignes et la définition du workflow. Reprenez-le par son identifiant avec run_resume ou la commande ritoko resume en exécution directe ; utilisez host_next pour une exécution hôte.

Modifier le fichier d’origine ne change pas ce lot enregistré. Après avoir examiné les résultats précédents, placez les données corrigées ou nouvelles dans un nouveau lot volontairement lancé. Les éléments confirmés le restent ; les échecs sûrs peuvent être réessayés ; les éléments en revue nécessitent la vérification de la destination. Un nouveau fichier contenant les mêmes clés terminées ne signifie pas automatiquement une nouvelle opération métier.

Quel rapport indique que le lot est réellement terminé ?

Utilisez run_report ou la commande ritoko report pour examiner l’état de chaque élément, les causes, les messages et les preuves ou fichiers disponibles. done signifie que les contrôles du workflow ont réussi ; skipped signifie que l’élément était déjà confirmé selon les règles d’identité du journal. Un résultat partiel contient encore des échecs ou des éléments en revue.

Un lot est terminé uniquement lorsque ses éléments sont confirmés ou ignorés et que ses contrôles finaux réussissent. Un résultat partiel, un arrêt ou une pause de réparation renvoie le code de sortie CLI 2. Gardez le journal avec l’installation : c’est la trace de reprise, pas un cache jetable. Les rapports actuels sont au format JSON ; ne supposez pas qu’un rapport d’audit HTML ou CSV existe.