Aller au contenu principal

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​

▶ Charger un mois de ventesCharge un mois de lignes de facture ; une période clôturée est refusée.Société ∗(tous) ▾Fichier pour l'étape « load » · feuille « Sales »sales_2026-03.xlsxLancerJournalEn cours10:02:11 load: 4 812 read · 4 806 inserted · 6 rejected10:02:12 load: partitions replaced 2026-03 / 00001, 0000210:02:13 customers: 3 rows10:02:13 periods: 14 rowsFichiers de l'exécution⇩ load-rejects.csvExécutions précédentesDÉBUTDURÉEPARil y a 2 hRéussie18 sj.martin4 806 ligne(s)hierEn échec2 sa.dupontpériode 2026-02 clôturéeParamètres utilisateurdéclarés par la tâcheUn fichier par étapeétapes sans chemin seulementLancerune exécution à la foisJournal en directrafraîchi toutes les 2 sFichiers de l'exécutionlignes rejetées à téléchargerHistoriqueun clic affiche son journal

La page de la tâche​

PartieContenu
Titre et descriptionLe libellé de l'entrée de menu, puis la description de la tâche.
ParamètresLes 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). Un paramètre qui accepte plusieurs valeurs s'affiche en cases à cocher précédées de Tout.
FichiersUn 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.
LancerEnvoie 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.
JournalL'é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.
Fichier chargéSous le journal, le fichier envoyé pour l'exécution sélectionnée, à télécharger à nouveau.
Exécutions précédentesLes 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.


Dans Liberty Next → Construire → 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.


Un préréglage dans le menu​

Une entrée peut fixer l'un des préréglages de la tâche avec params = { preset = "Licences" } : la page lance alors la tâche avec les paramètres et les étapes actives de ce préréglage. Une même tâche donne ainsi plusieurs entrées de menu — Collecter la sécurité et la SoD, Collecter les licences —, chacune sur un préréglage. Le libellé de l'entrée de menu donne son titre à la page.


Qui peut la lancer​

L'entrée et sa page demandent la permission job:<id> — dans Liberty Next → Administrer → Accès → Roles, bloc Au-delà des 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.toml
[[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
nameL'argument de l'étape qui reçoit la valeur.
label, lLe libellé affiché, par langue. Par défaut : le nom.
stepL'étape qui reçoit la valeur. Sans elle, la valeur va à toutes les étapes de la tâche.
defaultLa valeur préremplie.
requiredtrue : la tâche ne démarre pas sans valeur.
choicesUne liste fixe de valeurs : la page affiche une liste déroulante et refuse toute autre valeur.
choices_fromexplorer_models:<app> — les modèles de l'explorateur de données d'une application ; ou query:<connecteur>/<requête>:<colonne valeur>:<colonne libellé> — les lignes d'une requête de lecture, comme les applications de Nomasx-1.
multipletrue : plusieurs valeurs peuvent être cochées, avec Tout.

Une valeur vide signifie non renseigné : la valeur par défaut de l'étape s'applique. Les mêmes paramètres apparaissent dans la fenêtre Exécuter avec des paramètres des exploitants.

Une exécution par valeur. Une tâche qui déclare for_each = "<paramètre>" s'exécute une fois pour chaque valeur cochée — l'une après l'autre, chacune avec une seule valeur — ; Tout reprend toutes les valeurs que propose le paramètre. Une tâche planifiée avec la valeur all traite toutes les valeurs à chaque déclenchement : toutes les applications de Nomasx-1, par exemple.


Ce que livrent les applications​

ApplicationDossierTâches
Nomasx-1TâchesCollecter la sécurité et la SoD, Collecter les licences, Rapport d'audit des licences, Rapport sécurité et SoD — voir Tâches de Nomasx-1.
NomajdeTâchesRefusionner 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 ventesImportFichier articles, Fichier sociétés, Fichier ventes (un mois), Recalculer les périodes, Charger les fichiers d'exemple — voir La démo des ventes.