Processing XML from files

Documentation home

See also:          Batch XML documents

Two programs are supplied with the Ebase Batch system that can be used to read XML files from a specified directory and pass these to the Ebase Batch Server for processing. These programs are:

• ProcessBatchXMLFiles - this program can be used to read batch input request XML documents files.  Each file must contain a single XML document.
• ProcessACXML - this is similar to the above program except that it processes XML documents in the format created by the Kofax Ascent Capture XML Release script and converts these to the format required by the Ebase Batch Server. This program is intended for use solely in conjunction with the Kofax Ascent Capture scanning system.

Both of these programs work as follows: once started, they wake up periodically and scan the specified input directory for files of type .xml. Any such files are then sent to the Ebase Batch Server and are also transferred to the output directory. Execution continues indefinitely, even if the Ebase Server is shut down. Each program has a properties file with the following parameters:

inDirectory

outDirectory

UFSBatchServerURL

runImmediately

sleepTime

where:

inDirectory and outDirectory specify the input and output directories for XML files respectively. These names should contain forward slashes, not backslashes, and the name should not end with a forward slash.

UFSBatchServerURL is the URL of the Ebase Batch Server servlet

runImmediately is used only by ProcessACXML and specifies whether batches received from the Kofax scanning system should be executed immediately by Ebase or should merely be stored in the database for execution at a later time. These correspond to commands createAndRunAsyn and create respectively.  Permitted values are true or false, where false is the default.

sleepTime is the number of seconds the program waits between successive passes.

Program execution

Both programs are supplied in directory:

.../ufs/External/processXML

This directory contains all resources the programs need to execute.

The executable programs, read_BATCH_XML.bat and read_AC_XML.bat, are at the top level in the directory. They are started by double clicking, and are stopped by Ctrl-C.

The associated property files, UFS_BATCH_XML.properties and UFS_AC_XML.properties, are located in subdirectory /properties.

Note that the individual parameters in both of these must be reviewed and set according to your specific requirements.