Lancer une tâche depuis le menu d'une application
Une entrée de menu de type job place une tâche Nomaflow dans le menu d'une application, à l'intention des utilisateurs qui n'administrent pas Nomaflow : la personne qui charge le fichier des ventes du mois, le responsable sécurité qui collecte les données de sécurité avant une revue. L'entrée ouvre la page propre à la tâche — les fichiers attendus, ses paramètres, Lancer, le journal suivi en direct et les exécutions précédentes. Rien d'autre de Nomaflow n'apparaît.
Vue d'ensemble
La page de la tâche
| Partie | Contenu |
|---|---|
| Titre et description | Le libellé de l'entrée de menu, puis la description de la tâche. |
| Paramètres | Les paramètres utilisateur déclarés par la tâche : une liste déroulante quand les valeurs sont fixées, une zone de saisie sinon, chacun prérempli de sa valeur par défaut. Un paramètre obligatoire porte * ; une liste facultative propose (tous). |
| Fichiers | Un sélecteur par étape file_load qui attend un fichier — Fichier pour l'étape « load », avec la feuille quand l'étape en nomme une. Formats acceptés : .xlsx, .xlsm, .csv, .txt, .tsv. Une étape dotée de son propre chemin ou d'un dossier surveillé ne demande rien : elle lit son fichier. |
| Lancer | Envoie les fichiers et démarre l'exécution. Choisissez d'abord le ou les fichiers. ou « Société » est obligatoire. quand un élément manque. Une seule exécution à la fois : tant qu'une exécution est en cours, le bouton reste en attente. |
| Journal | L'état de l'exécution et son journal, rafraîchi toutes les 2 secondes tant que l'exécution est en attente ou en cours, l'erreur en rouge. Fichiers de l'exécution propose les fichiers produits — les lignes rejetées d'un chargement. |
| Exécutions précédentes | Les 20 dernières exécutions : début, état, durée, auteur (ou déclencheur, pour une exécution planifiée), lignes traitées et début de l'erreur. Un clic sur une exécution affiche son journal. |
L'exécution est une exécution Nomaflow ordinaire : les exploitants la retrouvent dans l'historique des exécutions, et ses notifications et alertes s'appliquent.
Placer une tâche dans un menu
Dans Paramètres → Menus, ajouter une entrée de type Job (run it, follow its log) et choisir la tâche dans Target : la liste présente chaque tâche avec la première ligne de sa description. Aucun connecteur n'est renseigné. Voir Types d'entrées de menu.
Qui peut la lancer
L'entrée et sa page demandent la permission job:<id> — dans Paramètres → Access → Roles, bloc Beyond the menus, type de règle Tâche, puis la tâche. Un refus (!job:<id>) masque l'entrée même quand le menu l'afficherait. Les superutilisateurs voient toutes les tâches.
Chaque titulaire de la permission voit toutes les exécutions de la tâche — la liste des exécutions précédentes, leurs journaux et leurs fichiers —, pas seulement les siennes.
Paramètres utilisateur
Une tâche déclare dans jobs.toml ce qu'un utilisateur peut régler en la lançant depuis sa page. Toute autre valeur est refusée ; les autres réglages de l'exploitant restent hors de portée.
[[jobs.user_params]]
name = "models"
label = "Explorer model (blank = every model)"
l = { fr = "Modèle Explorateur (vide = tous les modèles)" }
step = "refresh"
choices_from = "explorer_models:nomajde"
| Clé | Rôle |
|---|---|
name | L'argument de l'étape qui reçoit la valeur. |
label, l | Le libellé affiché, par langue. Par défaut : le nom. |
step | L'étape qui reçoit la valeur. |
default | La valeur préremplie. |
required | true : la tâche ne démarre pas sans valeur. |
choices | Une liste fixe de valeurs : la page affiche une liste déroulante et refuse toute autre valeur. |
choices_from | explorer_models:<app> — les modèles de l'explorateur de données d'une application. |
Une valeur vide signifie non renseigné : la valeur par défaut de l'étape s'applique.
Ce que livrent les applications
| Application | Dossier | Tâches |
|---|---|---|
| Nomasx-1 | Tâches | Collecter la sécurité, Collecter les licences — voir Tâches de Nomasx-1. |
| Nomajde | Tâches | Refusionner la sécurité (paquet de changements), Refusionner la sécurité (tous les rôles), Rafraîchir le dictionnaire (modèles Explorateur) — voir Tâches de Nomajde. |
| Démo des ventes | Import | Fichier articles, Fichier sociétés, Fichier ventes (un mois), Recalculer les périodes, Charger les fichiers d'exemple — voir La démo des ventes. |