Skip to content

Global Template

Global Template

The global template is a reserved system template that contains the Oracle database connection, path definitions, SCP settings, and Ghostscript configuration. It must never be deleted from the configuration.

Database connection

Property Description Example
URL Oracle JDBC thin URL jdbc:oracle:thin:@myhost:1521:ORCL
DBUser Oracle schema/user CRPDTA
DBPassword Base64-encoded password (use decodePasswd()) TXlTZWNyZXRQYXNzd29yZA==
schema Oracle schema prefix used in all SQL queries CRPDTA
tableLog Main invoice log table F564230

Password encoding

The DBPassword value must be Base64-encoded using java -jar nomaubl.jar -password <yourpassword>. The application calls decodePasswd() internally. Do not store the plain-text password here.

Path configuration

NomaUBL uses two path variables that are substituted at runtime throughout all template property values:

Variable Property Description
%APP_HOME% appHome Root directory of the application deployment
%PROCESS_HOME% processHome Root directory for input/output/temp files

Example:

"appHome": "/opt/nomaubl",
"processHome": "/opt/nomaubl/process"

Processing directories

Property Description Example
dirInput Where JDE XML spool files are read from %PROCESS_HOME%/input
dirOutput Where generated PDF/UBL files are written %PROCESS_HOME%/output
tempOutput Temporary working directory %PROCESS_HOME%/temp
burstOutput Output directory for BURST mode %PROCESS_HOME%/burst
singleOutput Output directory for SINGLE mode %PROCESS_HOME%/single

Oracle XDO configuration

Property Description Example
xdoConfig Path to the Oracle XDO configuration file (xdo.cfg) %APP_HOME%/config/xdo.cfg
rtfTemplate Path to the RTF template directory %APP_HOME%/templates

Ghostscript (optional)

Used for PDF post-processing (merging, compression).

Property Description Example
runGS Y to enable Ghostscript, N to skip Y
cmdGS Full command path to the gs binary /usr/bin/gs

Parallelism

Property Description Example
numProc Number of parallel threads for batch processing 4

XSLT transform

Property Description Example
transformYN Y to apply an XSLT pre-transform to the JDE XML before processing Y
transform Path to the pre-transform XSLT stylesheet %APP_HOME%/xsl/pretransform.xsl

Routing and copy

Property Description Example
routage Routing configuration (used to dispatch output files)
copy Copy rule for output distribution

SCP / SFTP download

These settings enable downloading XML files directly from the JDE server via SFTP (used by the Download XML from Server feature in the web interface).

Property Description Example
scpHost SFTP server hostname jde-server.company.com
scpUser SFTP username jdeadmin
scpPassword SFTP password
scpPort SFTP port 22
scpRemotePath Remote base path for XML files /jde/output

Locale and developer mode

Property Description Example
setLocale Force a specific Java locale fr_FR
devMode Enable developer mode (extra logging) N
devXSL Path to an alternative XSLT for development
updateDB Y to write to Oracle tables, N to skip DB writes (useful for testing) Y