Skip to main content

Global

The Global editor holds settings that apply to the whole NomaUBL application — file system layout, processing helpers, email server, AI assistant, license / authentication, and the background scheduler that drives polling and batch document jobs.

Settings here are largely source-agnostic and apply whether documents come from JD Edwards, SAP, NetSuite or a custom ERP. A few BIP-specific knobs are explicitly called out where they appear.

The editor has six tabs:

  1. Directories — application home, file paths, batch state.
  2. Processing — XSL config path, Ghostscript command, processing options.
  3. Email / SMTP — outbound mail server.
  4. AI — Anthropic API key for the in-app AI Assistant.
  5. Authentication — license key + user authentication / session timeout.
  6. Scheduling — automatic PA polling intervals and recurring batch jobs.

At a glance​

DirectoriesProcessingEmailAIAuthenticationSchedulingHome DirectoriesAPP HOME/opt/nomaublPROCESS HOME%APP_HOME%/processFile PathsDIR INPUT / DIR OUTPUT / DIR ARCHIVE / DIR ERROR%PROCESS_HOME%/in/%TEMPLATE%%PROCESS_HOME%/out/%TEMPLATE%%PROCESS_HOME%/archive%PROCESS_HOME%/errorProcessing tab — previewUPDATE DBY ▾debugProfile (2026.05.9)N ▾writes per-step timing rows to F564237Scheduling tab — previewFETCH IMPORT INTERVAL (min)15FETCH STATUS INTERVAL (min)5read by BackgroundScheduler — set here, used everywhereSix-tab editorplatform-wide settings%PLACEHOLDER% paths%APP_HOME% / %TEMPLATE% / etc.debugProfile · 2026.05.9per-step timing in F564237Scheduling intervalsBackgroundScheduler reads from here

Tab 1 — Directories​

Home Directories​

FieldDescription
Application HomeRoot install directory of NomaUBL (e.g. /app/nomaubl). Resolved by the %APP_HOME% placeholder used in document template paths.
EnvironmentShort environment name (e.g. demo, PD). Resolves the %ENV% placeholder used in document template paths (rtf, xsl, ublXslt) so the same template can target multiple environments.
Process HomeWorking directory used by NomaUBL during processing (e.g. /app/nomaubl/process).

File Paths​

FieldDescription
Input DirectoryWhere new documents to process are dropped (XML spools, attachments…).
Process DirectoryWhere in-flight files live during processing.
Temp DirectoryScratch space for temporary artefacts.
Single Output DirOutput directory for documents processed in single mode.
Bursting DirectoryOutput directory for documents produced by bursting mode (one file per invoice).

Batch Processing​

FieldDescription
Last BIP Job NumberHigh-water mark of the last JDE BIP job number consumed. Used by the BIP source to skip already-processed jobs. (BIP / JDE-specific.)

Tab 2 — Processing​

XSL Paths​

FieldDescription
XDO ConfigPath to the BI Publisher xdo.cfg configuration file used during PDF generation.

Ghostscript​

FieldDescription
GS CommandFull Ghostscript command line used for PDF post-processing (e.g. gs -dBATCH ...). Multi-line values are accepted.

Options​

FieldValuesDescription
Update DBY / NWhen Y, processing runs persist their results to the database. Set to N only for dry runs / debugging.
debugProfile (2026.05.9)Y / NWhen Y, every processing run writes per-step timing rows to F564237 covering each pipeline stage: header parsing, lines parsing, validation, UBL emit, PA send. The rows surface on the Tech Dashboard — the Live process events tail flags them with their step name, and the Template processing time widget breaks the average down by stage. Leave at N in production; flip to Y for the duration of a batch run when triaging a slow pipeline. Disable once the slow stage is identified — the extra rows inflate F564237 quickly under load.

Tab 3 — Email / SMTP​

Configures the outbound mail server NomaUBL uses to send notifications and document deliveries by email.

SMTP Server​

FieldDescription
HostSMTP host (e.g. smtp.example.com).
PortSMTP port (typically 587 for STARTTLS, 465 for implicit SSL, 25 plain).
TLS (STARTTLS)Y / N — upgrade the connection to TLS via STARTTLS.
SSLY / N — open the connection in implicit SSL mode (rare in modern SMTP, mutually exclusive with STARTTLS).

SMTP Credentials​

FieldDescription
UsernameSMTP authentication user.
PasswordSMTP authentication password.

Sender​

FieldDescription
From addressDefault From: address on outbound mail (e.g. facturation@example.com).

Tab 4 — AI​

Anthropic AI​

FieldDescription
API KeyAnthropic API key used by NomaUBL's in-app AI Assistant panel. Without a valid key, the AI Assistant is disabled.

Tab 5 — Authentication​

License​

FieldDescription
License KeyFull NomaUBL license key. Without a valid key, the Navigation, Synchronisation and UBL menus are disabled — only Configuration remains accessible.

Authentication​

FieldDescription
Enable AuthenticationY / N — turn on password-based user login. When N, NomaUBL runs without a login wall (typically dev / on-prem behind a corporate VPN).
Session Timeout (minutes)How long an authenticated user session remains valid. Default 480 (8 hours).

Tab 6 — Scheduling​

Background tasks executed by NomaUBL when running in serve mode. Changes on this tab take effect after a server restart.

Import & Status Polling​

FieldDescription
Import poll interval (min)Minutes between automatic import-status polls for pending invoices (status 9906). 0 = disabled.
Status retrieval interval (min)Minutes between automatic lifecycle-status retrievals from the PA. 0 = disabled.

Batch Document Processing​

A list of recurring batch jobs. Each job runs independently on its own interval and scans for new documents to process. Use + Add batch job to create one and the × button to delete one.

Per-job header fields​

FieldDescription
LabelHuman-readable name displayed in the job list (e.g. BIP invoices).
Interval (min)Minutes between two runs. 0 = disabled (job exists but is not scheduled).

Per-job parameters​

The remaining fields configure how the job picks up and processes documents:

FieldValuesDescription
Process typexml / ublxml = full pipeline (transform + process); ubl = direct UBL processing (input is already UBL).
Template (when Process type = xml)from listDocument template to apply. Lists templates of type document.
Mode (when Process type = xml)AUTO / SINGLE / BURST / UBLProcessing mode — AUTO lets NomaUBL decide; SINGLE and BURST force the corresponding output strategy; UBL produces UBL only.
Sourcebip / directoryWhere to fetch documents from: bip = JDE Print Queue (JDE-specific); directory = scan the Input Directory configured in Tab 1.
Extract mode (when Source = bip)input / output / bothWhich BIP artefacts to pull: input = source XML only; output = generated output files only; both = both.
Language filter (when Source = bip)textOptional BIP language filter (e.g. FR). Empty = all languages.
Replace existingY / NWhen Y, re-import documents that already exist in NomaUBL (overwrite); when N, skip duplicates.
Skip PA send (when Process type = xml)Y / NWhen Y, the job never sends to the Plateforme Agréée — it only produces UBL/PDF locally.
Validate only (when Process type = ubl)Y / NWhen Y, validate the UBL without sending it to the PA.
Send to PA (when Process type = ubl)(use settings) / Y / NOverride the per-document-type "send to PA" decision: empty = use default; Y = force send; N = force skip.

Tips & best practices​

  • Set Environment. The %ENV% placeholder in document templates is what lets one configuration roll forward from demo to PD without editing every path.
  • Restart after changing scheduler values. All intervals on Tab 6 (and the batch jobs) are read once at startup; updating them in the UI only persists the value — you still need to restart.
  • License gates the runtime. If you suddenly see Navigation / Sync / UBL menus disappear, double-check the License Key first.
  • Pick bip Source only when you actually have JDE. For other ERPs (SAP, NetSuite, custom), use directory and drop their XML output into the Input Directory.
  • Use validateOnly to dry-run UBL. Pair it with Skip PA send (or its UBL equivalent) when migrating templates so you exercise the pipeline without touching the PA.