L'éditeur Global rassemble les paramètres qui s'appliquent à l'ensemble de l'application NomaUBL — arborescence de fichiers, utilitaires de traitement, serveur SMTP, assistant IA, licence / authentification, ainsi que l'ordonnanceur en arrière-plan qui pilote le polling et les jobs batch.
Ces paramètres sont en grande majorité indépendants de la source et s'appliquent quels que soient les documents : JD Edwards, SAP, NetSuite ou ERP personnalisé. Quelques options spécifiques à BIP sont signalées explicitement.
L'éditeur comporte six onglets :
Directories — racine d'application, chemins de fichiers, état batch.
Processing — chemin de configuration XSL, commande Ghostscript, options de traitement.
Email / SMTP — serveur d'e-mails sortants.
AI — clé d'API Anthropic pour l'Assistant IA intégré.
Authentication — clé de licence + authentification utilisateur / délai de session.
Scheduling — intervalles de polling automatique de la PA et jobs batch récurrents.
Répertoire racine d'installation de NomaUBL (par ex. /app/nomaubl). Résolu par le placeholder %APP_HOME% utilisé dans les chemins de modèles de documents.
Environment
Nom court d'environnement (par ex. demo, PD). Résout le placeholder %ENV% dans les chemins des modèles de documents (rtf, xsl, ublXslt), permettant à un même modèle de cibler plusieurs environnements.
Process Home
Répertoire de travail utilisé par NomaUBL pendant le traitement (par ex. /app/nomaubl/process).
Répertoire de dépôt des nouveaux documents à traiter (spools XML, pièces jointes…).
Process Directory
Répertoire contenant les fichiers en cours de traitement.
Temp Directory
Répertoire temporaire utilisé pour les artéfacts intermédiaires.
Single Output Dir
Répertoire de sortie des documents traités en mode single.
Bursting Directory
Répertoire de sortie des documents produits en mode bursting (un fichier par facture).
Errors Directory
Répertoire où un fichier en échec de traitement est déplacé. Lors d'un traitement de dossier, mettre le fichier fautif de côté empêche un balayage répété de réessayer indéfiniment le même fichier. Laissé vide, le fichier reste en place (comportement précédent).
Un repère haut par hôte d'exécution JDE (RJRPDEXHST). Le repère suit chaque hôte par date de fin du job, et non par numéro — un numéro est attribué à la soumission, si bien qu'un job long qui se termine après un job plus récent au numéro supérieur pourrait sinon passer sous le repère et n'être jamais récupéré. La date de fin s'affiche à côté du numéro de job pour chaque hôte, et reste modifiable. Ajoutez chaque hôte avec son numéro de départ (le premier lot après mise à niveau renseigne la date automatiquement), ou cliquez Retrieve last job # per host pour les amorcer tous depuis le maximum courant ; ils avancent ensuite après chaque job, un lot interrompu reprenant exactement où il s'était arrêté. Seuls les hôtes listés sont scannés.(BIP / spécifique JDE.)
Fenêtre BIP (jours)
Limite l'analyse BIP dans le temps. À 0, aucune limite : tous les jobs postérieurs au dernier numéro traité sont repris. À N > 0, seuls ceux modifiés au cours des N derniers jours le sont. Pratique à la première installation ou après une longue interruption : on évite ainsi de parcourir des années d'historique. L'analyse lancée à la main, le lot planifié et la commande nomaubl -fetch-all en tiennent compte. (Spécifique BIP / JDE.)
À Y, les exécutions de traitement enregistrent leurs résultats en base de données. À positionner à N uniquement pour des exécutions à blanc (dry-run) ou des phases de débogage.
Max threads
(vide = tous les cœurs)
Limite le nombre de factures traitées simultanément. Un modèle à source XML peut traiter tout son dossier d'entrée en une seule passe parallèle — bien plus rapide sur un dossier de milliers de fichiers mono-facture, et de la même façon pour un balayage planifié, une exécution à la demande et le traitement par lot en ligne de commande. Chaque fichier reste une unité à part entière (nom, archive source et traçabilité conservés) et l'échec d'un fichier n'arrête pas les autres. Renseignez une valeur pour garder des ressources aux autres services d'un serveur partagé ; laissez vide pour utiliser tous les cœurs disponibles. Les modèles UBL et le traitement par travail (BIP) ne sont pas concernés.
debugProfile
Y / N
À Y, chaque exécution écrit des lignes de chronométrage par étape dans F564237 pour chaque phase du pipeline : analyse d'en-tête, analyse des lignes, validation, émission UBL, envoi PA. Les lignes apparaissent sur le Tableau de bord IT — le flux Traitements en cours · direct les marque avec le nom de l'étape, et le widget Temps par modèle décompose la moyenne par étape. À laisser à N en production ; à passer à Y le temps d'un lot pour analyser un pipeline lent. À désactiver dès que l'étape lente est identifiée — les lignes additionnelles gonflent rapidement F564237 sous charge.
Chemin du logo de la société, dessiné en haut du bloc fournisseur quand un modèle PDF a Afficher le logo activé (voir Modèles PDF). Accepte les variables de chemin %APP_HOME%, %ENV%, %PROCESS_HOME%, %KCO%, %DOC%, %DCT% et tout jeton {{…}} du catalogue de facture — par ex. %APP_HOME%/logos/{{kco}}.png, pour que chaque société pointe vers son propre logo. Un bouton { } ouvre une liste de jetons filtrable. PNG, JPG et GIF sont pris en charge.
Logo offset X (pt)
Décalage horizontal du logo, en points, pour absorber une marge interne au fichier source. Défaut 0.
Clé de licence NomaUBL complète. Sans clé valide, les menus Navigation, Synchronisation et UBL sont désactivés — seule la Configuration reste accessible.
Y / N — active la connexion utilisateur par mot de passe. À N, NomaUBL s'exécute sans contrôle d'authentification préalable (typiquement en environnement de développement ou en installation interne derrière un VPN d'entreprise).
Auth Mode
internal / oidc / both — pilote l'écran de connexion. internal(défaut) conserve le formulaire local nom d'utilisateur + mot de passe. oidc bascule sur un bouton de connexion unique (SSO). both affiche le bouton SSO au-dessus du formulaire local, ce qui laisse une porte de secours pour un administrateur disposant d'un compte en base si le fournisseur d'identité est indisponible. À coupler avec le template OIDC pour configurer le SSO côté NomaUBL.
Session Timeout (minutes)
Durée de validité d'une session utilisateur authentifiée, exprimée en minutes. Valeur par défaut 480 (8 heures).
Réinitialisation de mot de passe en self-service
Quand Auth Mode = internal (ou both), l'écran de connexion expose un lien Mot de passe oublié ?. L'utilisateur saisit son identifiant et son e-mail ; en cas de correspondance avec un compte actif, un lien à usage unique valable 60 minutes est envoyé à l'e-mail enregistré. Le lien ouvre une page dédiée pour choisir un nouveau mot de passe.
Requiert un SMTP configuré dans Onglet 3 — Email / SMTP. Les tokens sont persistés dans F564255 (voir Tables de base de données) et sont invalidés dès qu'ils ont été utilisés.
Tâches d'arrière-plan exécutées par NomaUBL en mode serveur. Les modifications apportées dans cet onglet ne sont prises en compte qu'après redémarrage du serveur.
Minutes entre deux interrogations automatiques du statut d'import pour les factures en attente (statut 9906). 0 = désactivé.
Status retrieval interval (min)
Minutes entre deux récupérations automatiques des statuts de cycle de vie depuis la PA. 0 = désactivé.
Received fetch interval (min)
Minutes entre deux passes PA entrante automatiques — même flux que le mode Sync → Fetch Input → PA entrante (factures fournisseur) et la commande CLI -fetch-received. 0 = désactivé. Le curseur de la date d'émission la plus récente traitée est enregistré dans lastFetchReceivedAt, chaque passe ne récupérant ainsi que les factures arrivées depuis la précédente.
Valeurs par défaut de tout envoi groupé vers la PA — Tout envoyer (factures en attente) et Tout renvoyer du Tableau de bord IT, le renvoi groupé de la liste des factures et la commande -send-waiting. Chaque routine de reprise nocturne Auto-Retry peut les surcharger sur sa propre ligne.
Champ
Description
Parallel workers
(défaut 4) Nombre de factures envoyées à la PA en même temps. Mettre 1 pour l'ancien comportement séquentiel.
Delay per worker (ms)
(défaut 100) Pause qu'observe chaque travailleur entre deux appels, pour rester dans l'enveloppe de débit de la PA.
Liste de jobs batch récurrents. Chaque job s'exécute indépendamment selon son propre intervalle et détecte les nouveaux documents à traiter. Utilisez + Ajouter un job batch pour en créer un, et le bouton × pour en supprimer un.
Renseigner Environment. Le placeholder %ENV% dans les modèles de documents permet de propager une même configuration de demo à PD sans modifier chaque chemin.
Redémarrer le serveur après modification du scheduler. Tous les intervalles de l'onglet 6 (ainsi que les jobs batch) sont lus une seule fois au démarrage ; les modifier dans l'interface ne fait qu'enregistrer la valeur — un redémarrage est requis pour leur prise en compte.
La licence conditionne l'exécution. Si les menus Navigation / Synchronisation / UBL deviennent inaccessibles, vérifier en priorité la validité de la clé de licence.
Choisir Source bip uniquement quand la source est JD Edwards. Pour les autres ERP (SAP, NetSuite, personnalisé), utiliser directory et déposer les sorties XML correspondantes dans l'Input Directory.
Utiliser validateOnly pour lancer un dry-run UBL. À combiner avec Skip PA send (ou son équivalent UBL) pendant une migration de modèles, pour valider la chaîne de traitement sans interaction avec la PA.