Tâches planifiées
La page Tâches planifiées liste toutes les tâches que le serveur exécute selon un calendrier, dans un seul tableau : les interrogations de la PA, le cycle e-reporting, la récupération des factures reçues, les lots de documents, les rapports quotidiens, les reprises automatiques, les contrôles du cycle de vie et la purge de rétention. Pour chacune, elle affiche le déclencheur, l'état, la dernière exécution avec sa durée et son résultat, et la prochaine exécution ; depuis la même ligne, une tâche se lance immédiatement, se suspend ou s'ouvre dans son éditeur.
Accès : Synchronisation → Tâches planifiées. La carte Planificateur du Tableau de bord IT renvoie vers cette page.
Vue d'ensemble
Les résultats d'exécution s'affichent tels que le serveur les écrit, en anglais.
Les tâches
| Type | Tâches | Déclencheur réglé dans |
|---|---|---|
| Interrogation | Import PA (suivi des dépôts) (factures en attente, statut 9906), Récupération des statuts PA (événements du cycle de vie), Cycle e-reporting (production et dépôt des flux échus), Factures reçues (factures fournisseur reçues sur la plateforme). | L'éditeur de la tâche : intervalle en minutes, plus la fenêtre silencieuse pour les deux interrogations de la PA. |
| Lot | Lots de documents : depuis la file d'impression JDE (BIP), depuis le répertoire d'entrée ou depuis les dossiers surveillés. | L'éditeur de la tâche : intervalle ou heure quotidienne, et les paramètres de lot ci-dessous. |
| Rapport | Rapports quotidiens — e-mail des erreurs ou des factures archivées. | Le formulaire du rapport. |
| Reprise auto | Reprises automatiques — renvoi quotidien des factures en statut d'erreur. | Le formulaire de reprise. |
| Contrôle cycle de vie | Contrôles du cycle de vie — contrôle quotidien d'intégrité et d'ordre des statuts. | Le formulaire du contrôle. |
| Système | Purge de rétention — le nettoyage quotidien des tables (voir Purge de rétention). | L'éditeur de la tâche ; durée de conservation par table. |
Les tâches désactivées figurent aussi dans la liste, à l'état Inactif, pour être activées depuis la page.
Colonnes
| Colonne | Description |
|---|---|
| Type | Interrogation, Lot, Rapport, Reprise auto, Contrôle cycle de vie, Système. |
| Tâche | Nom de la tâche ; un clic ouvre son éditeur. |
| Déclencheur | toutes les 5 min, chaque jour à 04:00, chaque jour · conserve 90 jours. |
| État | Actif, Inactif, Suspendu, En cours. |
| Dernière exécution | Début de la dernière exécution, avec Durée et Résultat (le résumé d'une ligne de l'exécution). Conservée d'un redémarrage du serveur à l'autre. |
| Prochaine exécution | Moment du prochain déclenchement planifié. |
| Actions | Lancer maintenant, Suspendre / Reprendre, Historique des exécutions. |
La barre d'outils filtre par type, rafraîchit le tableau (Actualiser, Actualisation auto), crée une tâche (Nouvelle tâche) et exporte la grille. Sa ligne de synthèse compte les tâches actives et rappelle la fenêtre silencieuse, mise en évidence quand elle est en cours.
Actions
- Lancer maintenant — exécute la tâche immédiatement, hors calendrier, après confirmation. La suspension et la fenêtre silencieuse sont ignorées pour cette exécution ; une tâche déjà en cours n'est pas relancée. L'exécution est enregistrée comme une exécution planifiée.
- Suspendre / Reprendre — disponible sur toutes les tâches. Une tâche suspendue garde son calendrier mais ses déclenchements sont ignorés jusqu'à la reprise ou au redémarrage du serveur : une suspension ne peut donc pas être oubliée indéfiniment. Lancer maintenant ne tient pas compte de la suspension.
- Historique des exécutions — ouvre les dernières exécutions de la tâche : quand, événement (début, fin, erreur), durée, résultat et identifiant d'exécution. Chaque exécution d'une tâche planifiée — déclenchée par le calendrier, par Lancer maintenant ou par la commande correspondante en ligne de commande — écrit une ligne de début et une ligne de fin ou d'erreur dans le journal des traitements. L'identifiant d'exécution figure aussi dans les lignes du journal serveur de cette exécution, ce qui permet de rapprocher les deux dans le Journal serveur. Les exécutions en échec apparaissent dans Diagnostic → Anomalies.
L'éditeur
Un clic sur le nom de la tâche ouvre son éditeur dans une fenêtre. Enregistrer et appliquer enregistre les réglages et recharge immédiatement la planification — une heure ou un intervalle modifié n'attend plus le redémarrage du serveur ; les suspensions survivent au rechargement. Les éditeurs des rapports, des reprises et des contrôles proposent aussi l'envoi d'un test et la suppression.
Interrogations
| Tâche | Champs |
|---|---|
| Import PA (suivi des dépôts) | Import poll interval (min) — minutes entre deux interrogations du statut d'import des factures en attente (statut 9906) ; 0 = désactivé. Quiet window from / to (HH:mm) — voir ci-dessous. |
| Récupération des statuts PA | Status retrieval interval (min) — minutes entre deux récupérations des statuts du cycle de vie auprès de la PA ; 0 = désactivé. Quiet window from / to (HH:mm). |
| Cycle e-reporting | E-reporting cycle interval (min) — minutes entre deux cycles e-reporting (production et dépôt des flux échus) ; 0 = désactivé. |
| Factures reçues | Received invoices interval (min) — minutes entre deux récupérations des factures fournisseur reçues sur la plateforme ; 0 = désactivé. |
La fenêtre silencieuse est une plage horaire quotidienne pendant laquelle le suivi des imports et la récupération des statuts sautent leurs exécutions — à placer sur une campagne d'envoi pour que les interrogations par facture ne s'accumulent pas pendant que la PA intègre le lot. Elle peut franchir minuit ; laisser les deux bornes vides pour la désactiver. Les deux mêmes champs figurent dans Job defaults.
Lots de documents
| Champ | Description |
|---|---|
| Label | Nom affiché dans la liste (par ex. BIP invoices). |
| Interval (min) | Minutes entre deux exécutions. 0 = désactivé, sauf si une heure quotidienne est renseignée. |
| Daily at (HH:mm) | Déclenche une fois par jour à cette heure locale au lieu de l'intervalle. Vide = l'intervalle s'applique. |
| Champ | Valeurs | Description |
|---|---|---|
| Process type | xml / ubl | xml = chaîne complète (transformation + traitement) ; ubl = traitement UBL direct (l'entrée est déjà UBL). |
Template (si Process type = xml) | depuis liste | Document à appliquer. Liste des modèles de type document. |
Mode (si Process type = xml) | AUTO / SINGLE / BURST / UBL | Mode de traitement — AUTO laisse NomaUBL décider ; SINGLE et BURST forcent la stratégie de sortie correspondante ; UBL produit uniquement de l'UBL. |
| Source | bip / directory / watch-folders | Où récupérer les documents : bip = file d'impression JDE (spécifique JDE) ; directory = parcourt l'Input Directory des paramètres globaux ; watch-folders = lance la récupération des dossiers surveillés — la tâche cible alors un répertoire configuré (choisi dans une liste) ou tous. |
Extract mode (si Source = bip) | input / output / both | Quels artéfacts BIP récupérer : input = XML source uniquement ; output = fichiers de sortie générés uniquement ; both = les deux. |
Language filter (si Source = bip) | texte | Filtre BIP optionnel par langue (par ex. FR). Vide = toutes les langues. |
| Replace existing | Y / N | À Y, ré-importe les documents déjà présents dans NomaUBL (écrase) ; à N, ignore les doublons. |
Skip PA send (si Process type = xml) | Y / N | À Y, la tâche n'envoie jamais à la Plateforme Agréée — il produit uniquement UBL/PDF en local. |
Validate only (si Process type = ubl) | Y / N | À Y, valide l'UBL sans l'envoyer à la PA. |
Send to PA (si Process type = ubl) | (use settings) / Y / N | Surcharge la décision « envoi à la PA » du type de document : vide = défaut ; Y = force l'envoi ; N = force l'omission. |
Les libellés de l'éditeur restent en anglais, comme dans l'application.
Rapports, reprises, contrôles
L'éditeur présente le formulaire complet de chaque type, inchangé : voir Rapport quotidien, Reprise automatique et Contrôles du cycle de vie.
Purge de rétention
La purge de rétention quotidienne borne les tables que rien d'autre ne limite. Elle s'exécute toutes les 24 heures, la première fois cinq minutes après le démarrage du serveur.
| Champ | Défaut | Table |
|---|---|---|
| Processing log (days) | 0 | Lignes START / END / erreur par fichier du journal d'exécution (F564237). Valeur conseillée 180. |
| Step timings (days) | 0 | Lignes de chronométrage par étape écrites par debugProfile (F564237). Valeur conseillée 30. |
| Job runs (days) | 0 | Lignes d'exécution des tâches planifiées (F564237). Valeur conseillée 90. |
| Validation errors of finished invoices (days) | 0 | Erreurs (F564236) des factures en statut terminal. Valeur conseillée 365. |
| Notifications (days) | 90 | Notifications de la boîte de réception (F564253). Vide = 90 jours ; 0 = conservation illimitée. |
Vide ou 0 conserve une table sans limite. La purge est donc désactivée par défaut, sauf pour les notifications, qui gardent leurs 90 jours : une mise à jour ne supprime rien d'elle-même. Compter seulement indique ce que chaque table perdrait avec les durées enregistrées sur le serveur — enregistrer d'abord, puis compter. Les mêmes valeurs figurent dans Job defaults → Retention ; la ligne de commande propose java -jar nomaubl.jar -purge <configFile> [--dry-run].
Nouvelle tâche
Nouvelle tâche ouvre une fenêtre pour choisir le type et le nom :
| Type | Crée |
|---|---|
| Lot | Un traitement de documents depuis BIP, un répertoire ou les dossiers surveillés. La tâche reste inactive tant que son déclencheur n'est pas défini. |
| Rapport | Un e-mail quotidien des erreurs ou des factures archivées. |
| Reprise auto | Un renvoi quotidien des factures en statut d'erreur. |
| Contrôle cycle de vie | Un contrôle quotidien d'intégrité et d'ordre des statuts. |
Le nom d'un rapport, d'une reprise ou d'un contrôle se compose de lettres, de chiffres, de tirets et de soulignés : c'est le nom de son fichier de configuration. Créer ouvre la nouvelle tâche dans son éditeur.
Accès
Accorder Tâches planifiées dans le groupe Synchronisation de la page Rôles. Lancer maintenant, Suspendre et Enregistrer et appliquer demandent l'action integration-run. Les anciens droits des pages Rapport quotidien, Reprise auto et Contrôles du cycle de vie sont ignorés.
Conseils & bonnes pratiques
- Lire la colonne État avant une campagne. Suspendre la récupération des statuts ou poser une fenêtre silencieuse, envoyer, puis reprendre.
- Tester un nouveau lot avec Lancer maintenant avant de lui donner un déclencheur.
- Ouvrir l'historique d'une tâche en échec avant son éditeur : le résultat de chaque exécution nomme souvent la cause.
- Activer la rétention progressivement — partir des durées conseillées, Compter seulement, puis enregistrer.