Aller au contenu principal

Global

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 :

  1. Directories — racine d'application, chemins de fichiers, état batch.
  2. Processing — chemin de configuration XSL, commande Ghostscript, options de traitement.
  3. Email / SMTP — serveur d'e-mails sortants.
  4. AI — clé d'API Anthropic pour l'Assistant IA intégré.
  5. Authentication — clé de licence + authentification utilisateur / délai de session.
  6. Scheduling — intervalles de polling automatique de la PA et jobs batch récurrents.

Vue d'ensemble​

DirectoriesProcessingEmailAIAuthenticationSchedulingRépertoires de baseAPP HOME/opt/nomaublPROCESS HOME%APP_HOME%/processChemins fichiersDIR INPUT / DIR OUTPUT / DIR ARCHIVE / DIR ERROR%PROCESS_HOME%/in/%TEMPLATE%%PROCESS_HOME%/out/%TEMPLATE%%PROCESS_HOME%/archive%PROCESS_HOME%/errorOnglet Processing — aperçuUPDATE DBY ▾debugProfile (2026.05.9)N ▾écrit le chrono par étape dans F564237Onglet Scheduling — aperçuFETCH IMPORT INTERVAL (min)15FETCH STATUS INTERVAL (min)5lu par BackgroundScheduler — réglé ici, utilisé partoutÉditeur à six ongletsparamètres globaux à la plateformeChemins avec %PLACEHOLDER%%APP_HOME% / %TEMPLATE% / etc.debugProfile · 2026.05.9chrono par étape dans F564237Intervalles de planificationle scheduler les lit ici

Onglet 1 — Directories​

Home Directories​

ChampDescription
Application HomeRé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.
EnvironmentNom 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 HomeRépertoire de travail utilisé par NomaUBL pendant le traitement (par ex. /app/nomaubl/process).

File Paths​

ChampDescription
Input DirectoryRépertoire de dépôt des nouveaux documents à traiter (spools XML, pièces jointes…).
Process DirectoryRépertoire contenant les fichiers en cours de traitement.
Temp DirectoryRépertoire temporaire utilisé pour les artéfacts intermédiaires.
Single Output DirRépertoire de sortie des documents traités en mode single.
Bursting DirectoryRépertoire de sortie des documents produits en mode bursting (un fichier par facture).

Batch Processing​

ChampDescription
Last BIP Job NumberBorne supérieure du dernier job BIP JDE consommé. Utilisée par la source BIP pour ignorer les jobs déjà traité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.)

Onglet 2 — Processing​

XSL Paths​

ChampDescription
XDO ConfigChemin vers le fichier de configuration xdo.cfg de BI Publisher utilisé pour la génération PDF.

Ghostscript​

ChampDescription
GS CommandLigne de commande complète Ghostscript utilisée pour le post-traitement PDF (par ex. gs -dBATCH ...). Les valeurs multi-lignes sont acceptées.

Options​

ChampValeursDescription
Update DBY / NÀ 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.
debugProfile (2026.05.9)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.

PDF​

ChampDescription
Logo pathChemin 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.

Onglet 3 — Email / SMTP​

Configure le serveur SMTP sortant utilisé par NomaUBL pour l'envoi des notifications et des documents par e-mail.

SMTP Server​

ChampDescription
HostHôte SMTP (par ex. smtp.example.com).
PortPort SMTP (typiquement 587 pour STARTTLS, 465 pour SSL implicite, 25 en clair).
TLS (STARTTLS)Y / N — négocie l'élévation de la connexion en TLS via la commande STARTTLS.
SSLY / N — établit la connexion en SSL implicite (rare en SMTP moderne, incompatible avec STARTTLS).

SMTP Credentials​

ChampDescription
UsernameIdentifiant d'authentification SMTP.
PasswordMot de passe associé à l'identifiant SMTP.

Sender​

ChampDescription
From addressAdresse From: par défaut appliquée aux e-mails sortants (par ex. facturation@example.com).

Onglet 4 — AI​

Anthropic AI​

ChampDescription
API KeyClé d'API Anthropic utilisée par l'Assistant IA intégré à NomaUBL. Sans clé valide, l'Assistant IA est désactivé.

Onglet 5 — Authentication​

License​

ChampDescription
License KeyClé de licence NomaUBL complète. Sans clé valide, les menus Navigation, Synchronisation et UBL sont désactivés — seule la Configuration reste accessible.

Authentication​

ChampDescription
Enable AuthenticationY / 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 Modeinternal / 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.

Onglet 6 — Scheduling​

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.

Import & Status Polling​

ChampDescription
Import poll interval (min)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.

Batch Document Processing​

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.

Champs d'en-tête par job​

ChampDescription
LabelNom lisible affiché dans la liste des jobs (par ex. BIP invoices).
Interval (min)Minutes entre deux exécutions. 0 = désactivé (le job existe mais n'est pas planifié).

Paramètres par job​

Les champs suivants définissent la stratégie de récupération et de traitement appliquée par le job :

ChampValeursDescription
Process typexml / ublxml = chaîne complète (transformation + traitement) ; ubl = traitement UBL direct (l'entrée est déjà UBL).
Template (si Process type = xml)depuis listeModèle de document à appliquer. Liste des modèles de type document.
Mode (si Process type = xml)AUTO / SINGLE / BURST / UBLMode de traitement — AUTO laisse NomaUBL décider ; SINGLE et BURST forcent la stratégie de sortie correspondante ; UBL produit uniquement de l'UBL.
Sourcebip / directoryOù récupérer les documents : bip = file d'impression JDE (spécifique JDE) ; directory = balaye l'Input Directory configuré à l'onglet 1.
Extract mode (si Source = bip)input / output / bothQuels 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)texteFiltre BIP optionnel par langue (par ex. FR). Vide = toutes les langues.
Replace existingY / 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, le job 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 / NSurcharge la décision « envoi à la PA » du type de document : vide = défaut ; Y = force l'envoi ; N = force l'omission.

Conseils & bonnes pratiques​

  • 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.