La page des Tâches
La page Tâches présente chaque tâche de jobs.toml, une ligne par tâche, groupées par application, avec sa dernière exécution, sa planification et ses actions. Elle est réservée aux superutilisateurs.
Vue d'ensemble
Recherche et filtres
| Élément | Usage |
|---|---|
| Rechercher | Trouve une tâche par son identifiant, sa description ou une étiquette. |
| Toutes les applications, Tout statut, Toute étiquette | Restreignent la liste. Statut : Activées, Désactivées, Planifiées (activées avec une prochaine exécution), En cours, Dernière exécution en échec. |
| Effacer | Remet à zéro la recherche et les filtres. |
| N sur M tâches | Le nombre de tâches retenues par les filtres. |
| + Nouvelle tâche | Ouvre l'éditeur de tâche — voir Créer une tâche. |
La recherche et les filtres sont conservés par le navigateur d'une visite à l'autre. Deux panneaux repliés regroupent les règles communes à toutes les tâches : Rétention de l'historique (Administration) et Planifications manquées (Planifications).
Groupes
- Tâches principales vient en tête : les tâches portant l'étiquette
main, celles que les exploitants lancent le plus souvent — la collecte d'une application, une synchronisation de nuit. - Viennent ensuite un groupe par application, par ordre alphabétique : une tâche appartient à l'application que nomment ses étiquettes ou son identifiant (
nomasx1-collect-all→ Nomasx-1) ; les autres vont dans Framework, en dernier.
Un clic sur le titre d'un groupe le replie ou le déplie.
Une ligne de tâche
| Élément | Signification |
|---|---|
| Identifiant, description | Un clic sur l'identifiant ouvre l'éditeur de la tâche. |
| Dernière exécution | L'état de la dernière exécution ; un clic en ouvre le détail. |
| Planification | Le cron, ou Manuelle, avec la prochaine exécution. |
| activée / désactivée | Un clic active ou désactive aussitôt la planification propre de la tâche, sans recharger la configuration. Exécuter fonctionne dans les deux cas, et les planifications des préréglages ne sont pas concernées. |
Les icônes en fin de ligne :
| Icône | Effet |
|---|---|
| Exécuter | Lance la tâche. Quand il y a quelque chose à choisir — paramètres, arguments d'étape, plusieurs étapes, une étape file_load —, la fenêtre Exécuter avec des paramètres s'ouvre d'abord. Pendant l'exécution, l'icône devient Annuler. |
| Modifier | Ouvre l'éditeur de la tâche. |
| Cloner | Demande un nouvel identifiant et crée une copie désactivée, sans aucune planification : ni la sienne, ni celles des préréglages. |
| Exporter | Télécharge un ZIP contenant l'entrée jobs.toml de la tâche et un MANIFEST.md. Les connecteurs et requêtes utilisés ne sont pas inclus. |
| Supprimer | Retire la tâche de jobs.toml après confirmation. Son historique d'exécutions est conservé. |
Exécuter avec des paramètres
La fenêtre ne vaut que pour cette exécution — jobs.toml n'est pas modifié.
| Partie | Contenu |
|---|---|
| Préréglage | Choisir un préréglage enregistré puis Appliquer : la fenêtre revient d'abord aux valeurs enregistrées de la tâche, puis applique le préréglage — comme le fait l'ordonnanceur. (choisir un préréglage…) ramène aux valeurs enregistrées. Enregistrer comme préréglage… enregistre l'état courant de la fenêtre sous un nom, dans jobs.toml. |
| Paramètres partagés (toutes les étapes) | Les paramètres partagés de la tâche, modifiables pour cette exécution. Un paramètre proposé aux utilisateurs s'affiche en liste déroulante — ses choix peuvent venir d'une requête, comme les applications de Nomasx-1 —, ou en cases à cocher précédées de Tout quand plusieurs valeurs sont permises. |
| Étapes | Une ligne par étape avec une case pour la sauter (Toutes / Aucune) ; Modifier les paramètres ouvre les arguments d'une étape. Une étape file_load reçoit un sélecteur de fichier — voir Étapes. |
| Niveau de journal | WARNING — avertissements et erreurs seulement, INFO — nombres de lignes et jalons, DEBUG — le SQL complet de chaque requête. |
| Exécuter | Envoie les fichiers choisis, puis démarre l'exécution. |
Plusieurs valeurs, plusieurs exécutions. Une tâche prévue pour s'exécuter par valeur — par application, par société — s'exécute une fois pour chaque valeur cochée, l'une après l'autre, chacune avec une seule valeur ; une valeur en échec n'empêche pas les suivantes. Tout reprend toutes les valeurs proposées. Dans les exécutions, chaque exécution indique la valeur traitée.
Usages courants : relancer seulement l'étape en échec, recharger un mois, exécuter en DEBUG pour voir le SQL, lancer un préréglage à la main, collecter trois applications d'un coup.
Annuler
Annuler demande l'arrêt de l'exécution. Les étapes SQL, HTTP, de chargement de fichier et les fonctions Python async s'arrêtent aussitôt ; l'exécution se termine CANCELED. Une fonction Python synchrone ne peut pas être interrompue : l'exécution est marquée annulée et la fonction se termine d'elle-même — voir Dépannage.