Démarrage rapide
Ce pas à pas construit votre première tâche Nomaflow — un simple rafraîchissement nocturne de base de données — en une dizaine de minutes. À la fin, vous disposerez d'une tâche qui se déclenche selon une planification, exécute une étape sur un connecteur, enregistre son historique d'exécutions et diffuse ses logs en direct. Tout se passe dans la page Nomaflow ; aucune édition TOML n'est requise.
L'exemple utilise une étape SQL parce que toute installation possède un connecteur permettant de la tester. Le même flux s'applique aux étapes Python, HTTP et LDAP Sync — seuls les champs du formulaire diffèrent.
Avant de commencer
Vérifiez que vous disposez de :
| Prérequis | Comment vérifier |
|---|---|
| Le framework est en cours d'exécution. | Ouvrez l'application — vous parvenez à vous connecter. |
| Vous avez un connecteur cible utilisable. | Ouvrez Paramètres → Connecteurs — au moins un connecteur doit être listé. Le pool default du framework convient toujours. |
Votre rôle dispose de la permission job:* (ou de superuser). | Si le lien Nomaflow est visible dans le menu, vous êtes prêt. |
Si l'un de ces points manque, le guide de démarrage du framework couvre le chemin d'installation et Authentification → Rôles et permissions couvre le câblage des rôles.
Étape 1 — Ouvrir la page Tâches
Cliquez sur Nomaflow dans la navigation principale. La page qui s'ouvre est le Catalogue des tâches — chaque tâche déclarée, avec l'état de sa dernière exécution, le prochain déclenchement planifié et une série d'actions.
La barre d'outils supérieure réunit les trois actions que vous utiliserez le plus souvent : Nouvelle tâche (ouvre le constructeur de tâches), Vue calendrier (un calendrier des prochains déclenchements) et Recharger (rafraîchit le catalogue).
Étape 2 — Créer une tâche
Cliquez sur ＋ Nouvelle tâche. L'éditeur de tâche s'ouvre avec trois sections : Identité, Planification et Étapes.
| Champ | Valeur à saisir |
|---|---|
| Id | my-first-job (compatible URL — lettres, chiffres, traits d'union, soulignés). |
| Description | « Ma première tâche Nomaflow — rafraîchit une vue de reporting. » |
| Tags | tutorial (optionnel — sert à grouper les tâches). |
| Activée | Laissée à on. |
Enregistrez le bloc d'identité avant d'ajouter des étapes. La tâche figure désormais dans le catalogue, mais ne fait encore rien.
Étape 3 — Ajouter une étape SQL
Dans l'éditeur, cliquez sur ＋ Ajouter une étape et sélectionnez SQL Query dans le menu de type.
| Champ | Valeur à saisir |
|---|---|
| Nom | refresh-totals (utilisé comme libellé dans l'historique des exécutions). |
| Type | sql_query. |
| Connecteur | Choisissez un connecteur accessible en écriture — le default du framework convient pour un test de bon fonctionnement. |
| Requête | Une instruction courte sur votre cible — pour le pool default du framework, SELECT now() suffit à valider le câblage. |
Enregistrez l'étape. L'éditeur revient à la liste des étapes, qui en compte désormais une.
Un SELECT now() fait office de test, mais une tâche qui exécute une requête utile (un REFRESH MATERIALIZED VIEW, une mise à jour quotidienne d'un compteur, un petit INSERT … SELECT) produit une ligne de résultat exploitable dans l'historique.
Étape 4 — Définir une planification
De retour dans la section Planification de l'éditeur, le champ attend une expression cron à 5 champs (avec un 6ᵉ champ optionnel pour les secondes).
| Objectif | Cron |
|---|---|
| Toutes les minutes (idéal pour un test rapide). | * * * * * |
| Tous les jours à 02 h 00. | 0 2 * * * |
| Tous les lundis à 09 h 30. | 30 9 * * 1 |
| Toutes les heures à la minute :15. | 15 * * * * |
| Manuel uniquement (sans planification). | laissez le champ vide |
Pour un premier test, saisissez * * * * * et choisissez un fuseau horaire (par exemple Europe/Paris). Le champ affiche un aperçu en direct des trois prochains déclenchements, ce qui permet de vérifier l'expression avant d'enregistrer.
Enregistrez la tâche. En moins d'une minute, la première exécution apparaît dans l'historique.
Étape 5 — Observer l'exécution
De retour sur la page Tâches, la carte de my-first-job affiche maintenant :
- Un badge EN COURS (pastille verte) tant que l'exécution est en cours.
- Un badge RÉUSSI ou ÉCHEC une fois l'exécution terminée.
- L'horodatage de dernière exécution, mis à jour chaque minute.
Cliquez sur le badge — il ouvre la page Détail d'exécution correspondante, qui affiche la chronologie des étapes, les entrées/sorties de chaque étape et le flux de logs en direct.
Le journal est diffusé en direct par Socket.IO pendant que l'exécution est en cours — fermez le navigateur, l'exécution se poursuit ; rouvrez la page, le flux de logs reprend là où vous l'aviez laissé.
Étape 6 — Passer en mode manuel uniquement
Une tâche qui se déclenche chaque minute remplira vite l'historique. Une fois le câblage vérifié :
- Ouvrez l'éditeur de tâche.
- Videz le champ Planification.
- Enregistrez.
La tâche reste dans le catalogue et reste déclenchable via ▶ depuis la page Tâches, mais ne se déclenche plus d'elle-même. C'est aussi le bon mode pour les tâches à la demande — reconstructions, rapports, scripts ponctuels qu'un opérateur lance manuellement.
Alternativement, utilisez la bascule d'activation sur la carte de la tâche pour désactiver la planification sans la perdre.
Étape 7 — Tenter une exécution manuelle
Cliquez sur ▶ Lancer maintenant sur la carte de votre tâche. Trois cas de figure sont possibles :
| Ce que vous voyez | Quand |
|---|---|
| La tâche démarre immédiatement. | La tâche n'a aucun paramètre et une seule étape — il n'y a rien que l'opérateur puisse utilement configurer. |
| Une fenêtre Exécuter avec paramètres s'ouvre. | La tâche a des paramètres partagés, une étape Python avec op_kwargs ou plusieurs étapes. |
| Le bouton est désactivé avec un indicateur d'attente. | Une exécution précédente est encore en cours. |
La fenêtre Exécuter avec paramètres est un élément puissant de l'interface — elle permet à l'opérateur de surcharger pour un déclenchement précis ce qui sinon nécessiterait une modification de la tâche. Le pas à pas complet est dans Tâches → Catalogue.
Ce que vous venez de construire
| Comportement | D'où il vient |
|---|---|
| La tâche se déclenche selon une planification. | L'expression cron de la section Planification. |
| Le framework la prend en compte sans redémarrage. | L'enregistrement dans l'éditeur de tâche appelle automatiquement POST /admin/reload. |
| L'exécution arrive dans l'historique. | Chaque déclenchement crée une ligne run, chaque étape une ligne step_run. |
| Vous pouvez relancer depuis l'interface. | ▶ Lancer maintenant passe par le même moteur d'étapes que le déclenchement cron. |
| Les logs sont diffusés en direct. | Le runner publie sur un canal Socket.IO auquel s'abonne la page Détail d'exécution. |
Vous n'avez écrit aucun TOML, ouvert aucun terminal ni redémarré aucun service. La boucle complète — définir, planifier, exécuter, observer — réside dans l'interface Paramètres.
Pour aller plus loin
| Vous voulez… | À lire |
|---|---|
| Construire le modèle mental — qu'est-ce qu'une tâche, une exécution, une étape, une planification ? | Concepts. |
| Maîtriser le catalogue et la fenêtre d'exécution avec paramètres. | Tâches → Catalogue. |
| Parcourir l'éditeur complet de tâches, champ par champ. | Tâches → Créer une tâche. |
| Choisir le bon type d'étape. | Étapes. |
| Voir trois schémas de bout en bout. | Recettes de workflows. |
| Configurer les alertes Slack / e-mail / webhook en cas d'échec. | Notifications. |