Optional:
To get help from the Batch Monitor window:
To access the desired batch interface:
- Double-click the batch of your choice from the list.
- Right-click the batch from the list then select
New parameter file.
- Click the batch from the list then select .
Depending on the location of the objects to be converted, click:
Set the batch
parameters as explained in the corresponding documentation.
Specify the report directory either by entering its path
directly in the Report directory box, or by clicking
to
browse your filetree.
The Report directory box contains the path of the directory
where the reports and the processed documents will be
stored.
Enter the name of the report that will be generated in
HTML format.
The default report name depends on the batch you are running but
you can replace it by the name of your choice if needed.
This report is a global
report dealing with all the documents that have been processed.
In addition to this global report, the batch also creates an
individual report for each processed document in the report
directory.
Optional: Use the Suffix for object report box to enter a string to be added at the end of each report name.
Click Save to save your
batch parameters in an XML file.
By default, it is saved in a temporary
folder.
The file is named "BatchParameters" suffixed with the hour at
which the batch was run (for instance,
"BatchParameters_14.41.25.xml" to indicate that the batch was
run at 14.41.25 PM).When saved, this file can be edited manually and used later on to run the batch directly
without having
to re-access the batch interface.
You can now either click Run to run the batch from the interface of the selected
batch or click Cancel to close
the batch window and go back to the Batch Monitor window
(if you want to start other batches for instance).
In the Batch Monitor, access the Start
tab.
The name and location of the XML file containing
the batch parameters you defined in the previous steps (as well
as the name of the host computer if you run the batch in remote
mode) are displayed:
Optional: If you have not already run the batch, select
(or right-click the batch
to run then select Run).
Optional: From the batch interface, click Open
Main HTML Report
which is activated as soon as a report has been generated:
This opens directly the global report in HTML
format.
You can also visualize
the report by opening the result file from the directory where
it has been saved.
Note:
If a GlobalResults.htm file already exists, it is
automatically replaced by the new one.
Access the Processes tab to display
information on the batch execution:
The following batch-related information is
displayed:
- Name of the batch.
- Name of the parameter file used to run the batch.
- Name of the host computer (if you run the batch on a remote
computer).
- Status of the batch ("Ended", "Running", etc.).
- Feedback on the
batch completion in the "Progress" column. "100%" is displayed
when the batch is ended.
- Start and end time, respectively in the "Beginning at" and
"Ending at" columns.
- Return code: "0" means that the batch executed correctly ; a
code other than zero means that the batch has failed. For more
information, see
Generic Batch Monitor Error Codes and Generic Batch Error Codes.
- Result of the batch execution (either "Succeeded" or
"Failed").
- Batch identification number.
Note:
The Processes tab also lets you
interrupt the batch execution. To do so, right-click the desired
batch from the list then select Interrupt.
You can also delete a batch from the list by right-clicking the
corresponding line then selecting Delete.
To display the report of the batch execution,
double-click the desired batch in the list to display the Results:
This window indicates the beginning and end date
and time of the batch execution as well as the name and path of the
documents that have been processed.
You can then:
- Click Save to save your results in the folder of
your choice. The file formats available are .txt and .xml. Note that this file is different from the one you save from the
batch interface: the Save button in the Batch
Monitor window lets you save the batch results (i.e. the
data displayed in the Results window displayed above)
whereas the Save button available in the batch
interface lets you save the batch parameters.
- Click Close to close the window and go back to the
Batch Monitor window.
To read the reports generated by
the batch execution, access the folder c:\temp\batchID.
Three files are created:
- A report in text format named batchIDLOG.txt
- A report in XML format named batchIDLOG.xml
- A log containing the output named batchIDOUTPUT.xml.
where batchID is the number identifying the batch.
You can modify the default storage location of these files
by exporting the following variable:
set BATCH_HOME=new_path
where new_path is the path of the new storage location.
Select to
exit the Batch Monitor.