Home
Batch processing
Process accumulated requests from EngageOne Interactive, or process your own multiple or individual files, in a scheduled, or ad hoc manner.
Non-accumulated batch
In NA batch, which is a traditional batch process, the batch process accepts one or more input files containing document data sets, as well as optional processing instructions.
Express Batch
Express Batch processing can significantly improve NA batch performance; in this mode NA batch skips additional configurations provided by Engage One Server during delivery channel definition, thus reducing I/O operations. Resources such as Keymaps, Journals and, Lookup Tables can be assigned to the template in Designer or defined/overridden via OPS settings in EngageOne Server as described below.
Using symbols

EngageOne Server overview
EngageOne Administration is used to configure and manage operating modes and user roles.
Getting started
Information on creating and configuring communities, running the EngageOne Server Admin and common features available in the web application.
Template management
Template management allows you to create and organize folders that contain templates and Active Content, created in Designer and imported into EngageOne.
External File management
External resources not contained in the template, succh as images (key maps or keyed images), lookup tables, and RTF files.
Delivery management
Before you can use a template in EngageOne Administration you must define a device for viewing and define at least one delivery option.
Community Administration
Features for managing shared community document classes, retention policies, spelling dictionaries, data maps, and diagnostics.
System administration
As an EngageOne Server system administrator you will be responsible for configuration, diagnostics and account activities.
Event Monitor
Events related to the document cycle and administration, these are captured throughout the system and sent to the Event Monitor.
Batch processing
Process accumulated requests from EngageOne Interactive, or process your own multiple or individual files, in a scheduled, or ad hoc manner.
- Accumulated batch
  The process of submitting documents for batch delivery in EngageOne Interactive is referred to as accumulated batch.
- Non-accumulated batch
  In NA batch, which is a traditional batch process, the batch process accepts one or more input files containing document data sets, as well as optional processing instructions.
  - Modes and features
    Batch operating modes presented in the table below are in order of performance, from left (fastest) to right.
  - Setup
    Batch capabilities are packaged in the batch bundle and are installed at the batch.install.dir location configured in deploy.properties.
  - Input files
    NA batch works with both interactive templates and non-interactive templates. Interactive templates always use the interactive data model. Non-interactive templates can use one of the following data models: keyed record, delimited, or custom XML.
  - Using interactive templates
    Each template has its own unique answer file, which contains the data that will be used in the generated document. Within the <answer> nodes are CDATA blocks that contain answer file XML for the given template. Before developing your own input XML, you will need to make sure that you can produce the answer file XML with the intended data.
  - Using non-interactive templates
    NA batch can process non-interactive templates that include an input file that contains data in any format supported by Designer and generate the appropriate content as defined by the selected output channels. A non-interactive template refers to an EngageOne template that represents a publication that is intended for non-interactive, batch processing.
  - EngageOne Video PURL generation
  - NA batch and XML processing files
    The input folder contains an XML processing file just as it does for the Interactive Data Model. This file provides process-specific values for the template, template effective date, and delivery option for a given records section. The XML also identifies the data file that is to be used for the batch/records instance.
  - NA batch and native input file support
    NA batch supports the processing of keyed record and delimited-format data model types directly as input files. This eliminates the need for an XML processing file to provide control information for the non-XML data file.
  - Running the non-accumulated batch job
    A single batch run constitutes a set of files (one to many) where each file can have multiple records.
  - Express Batch
    Express Batch processing can significantly improve NA batch performance; in this mode NA batch skips additional configurations provided by Engage One Server during delivery channel definition, thus reducing I/O operations. Resources such as Keymaps, Journals and, Lookup Tables can be assigned to the template in Designer or defined/overridden via OPS settings in EngageOne Server as described below.
    - Publishing for EngageOne in Designer
      While publishing for EngageOne in Designer, select the option Express Batch, in the Publish for EngageOne task. The result is a ZIP file containing resources required for onward processing by EngageOne. The ZIP file contains a template_Master.xml file which holds configuration information. A Express Batch compatible template will have its Bypass OCP field set to true as highlighted below.
    - Using overrides
      You can either specify resources used by the template in Designer in the Publish for EngageOne task or by using an override production settings (OPS) file; this allows you to specify supplements and alternatives to some of the job settings that were used in Designer. Note that the use of overrides is valid only for templates run Express Batch processing mode.
    - XML processing file
      The standard XML processing file has been extended to cater for the definition of the OPS file used in Express Batch process via the additionalOptions construct.
    - Using symbols
  - Running multiple batch programs on the same server
    You can concurrently execute multiple non-accumulated batch instances on the same machine without any additional configuration.
  - Running batch on a different machine
    The batch programs can run on a separate machine other than the EngageOne server provided that it has access to the database, the EngageOne server' s JNDI, and the EngageOne repository.
  - Batch configuration
    These are the non-accumulated batch thread size settings that are used to control the configuration in the com.pb.engageone.server.batch.na namespace.
- NA batch setup and performance optimization
- Purging using batch
  Running purge is an important maintenance activity to prevent gradual performance degradation due to the build-up of data in the database tables. Make sure you implement a purge routine as part of your EngageOne Server maintenance plan.
- Log file location
- Logging information (accumulated and non-accumulated batch)
- Modifying log file count
- Batch error handling
  Error handling for accumulated and non-accumulated batch have some differences.
- Batch threshold settings
  The threshold level is the limit where a running batch will terminate, if the number of processed documents that have errors has been reached.
- Setting up the batch programs on a separate machine
- Running batch with integrated security database connections
Managing your EngageOne environment
Best practices for managing your EngageOne and safeguarding your environment.
EngageOne Server system monitoring
This section describes how to monitor the EngageOne Server system.
Copyright

Using symbols

In order to dynamically assign values to OPS configuration files, symbols support is provided in Express Batch processing mode.

Symbols can be used on the command line used to run NA batch using the –symbolsswitch, as shown below:

run-na-batch.bat -domain sampledomain -dir C:\nabatchinput -symbols "outputfolder=C:\output journalfilename=journal.dij"

Symbols can also be used in the OPS file, as shown below:

<Symbols>
outputfolder=C:\output
journalfilename=journal.dij

To reference symbols in the OPS file should be wrapped inside the % sign, as shown below:

<Journal>
Document=%outputfolder%\All_Sections_Message_Test.JRN
TLE_Print_Index=%outputfolder%\TLE_Print_Index.JRN

In the example that follows two symbols are used to dynamically resolve the paths for the input data and output using the following symbols:

Data uses the value from the command-line,
Output uses the same value from Data"

<Symbols>
Data=%1%
Output=%Data%
 
<Input>
DataInput=c:\EngageOne\GenTest\input\%Data%
ActiveContentLocation=c:\EngageOne\gentest\ActiveContent
MessagesFile=c:\EngageOne\GenTest\HIM\*.him
 
<Journal>
Journal2=c:\EngageOne\gentest\output\%Output%.jrn2
Journal3=c:\EngageOne\gentest\output\%Output%.jrn3
 
<Output>
Output1=c:\EngageOne\gentest\output\%Output%.pdf
;Output2=c:\gentest\output\%Output%.ps
 
<Advanced>
LogFile=c:\EngageOne\gentest\output\%Data%log
 
<DIJ>
Output1=c:\EngageOne\gentest\output\%Output%.xml
 
;<trace>
;Outputfile=c:\EngageOne\gentest\output\%Data%_trace.log
;TraceLevel=verbose
;outputcodepage=utf8
;memlimit=0
;supporttrace=on