Status Document Job Converter

StatusJobDataRunner has support for document conversion, along with status update. This feature utilizes LEADTOOLS caching to:

• Convert a document in the cache and upload it automatically.
• Perform the operation in a separate process (if the cache allows multiple processes to access the same value).
• Use the cache to save and obtain the status of the conversion.

The main class for running a conversion with status is StatusJobDataRunner that uses instances of StatusJobData for each conversion. A simple workflow of an application using the status job converter is as follows:

// Create a new status job data and set its options 
var jobData = new lt.Document.DocumentConverterJobData(); 
jobData.documentFormat = lt.Document.Writer.DocumentFormat.pdf; 
// etc. 
// Run the conversion on an existing document in the cache 
// sourceDocumentId is the ID of an existing document in the cache 
lt.Document.Converter.StatusJobDataRunner.runConvertJob(sourceDocumentId, jobData) 

This workflow performs the conversion job but does not allow status information about the job to be obtained. To do that, modify the code as specified in the StatusJobDataRunner example.

When conversion starts, the runner will create a new cache item with Region/Key set to userToken/jobToken respectively, and the value set to a copy of the StatusJobData input object. As the job progresses, the runner will update this item in the cache with the latest status and timestamps. The application can use queryConvertJobStatus at any time to get the latest version of StatusJobData from the cache with updated values of the conversion status and any errors that might have occurred. The value of isCompleted is true when the runner has completed the conversion.

StatusJobData contains various members that can be organized into the following sections:

Status Section

userToken and jobToken must be specified by the application (or set automatically by the StatusJobDataRunner class), and combining them should create a unique string. Internally, the runner will use userToken and jobToken as the Region and Key of a cache item added to the cache.

jobStatus will be set to one of the DocumentConverterJobStatus enumeration members.

jobStatusMessage will contain extra information about the last job status.

isCompleted will be false as long as the runner is performing the conversion. It is set to true when the job finishes (successfully or not: the status will contain Success or Aborted, depending on the result of the conversion). In case of errors, errorMessages contains helpful hints and messages for one or more errors that occurred.

The various timestamps can be queried to check the health of the conversion and whether it is still performing correctly.

Input Section

These members must be initialized to the information about the input document in the cache to be converted.

Output Section

The resulting output document from the conversion is uploaded to the cache. These members define how to store the document.

Conversion Section

Finally, this section specifies the output document type and annotation mode to use.

For a full example, refer to StatusJobDataRunner.

See Also

• Document Library Features
• Document Viewer Application
• Loading Documents Using LEADTOOLS Document Library
• Creating Documents with LEADTOOLS Document Library
• Document Toolkit and Caching
• Uploading Using the Document Library
• Document Library Coordinate System
• Loading Encrypted Files Using the Document Library
• Parsing Text with the Document Library
• Barcode processing with the Document Library
• Using jQuery Promises in the Document Library
• Loading Images in the Document Library
• Document Page Transformation
• Using LEADTOOLS Document Viewer
• Status Document Job Converter
• Document View and Convert Redaction