DocumentConvertResult Object

Result of a successful document conversion.

DocumentConvertResult is the result of calling LEADDocument.Convert. Each member is of type ConvertItem which contains the URL and the MIME type and file length of an output conversion file. The values are dependent on whether the output format set in DocumentConverterJobData object passed to Convert supports multipages. If the format supports multi-pages, then DocumentConvertResult.Archive is not used and the resulting document can be obtained through DocumentConvertResult.Document (and the document ID is stored in DocumentConvertResult.DocumentId. If the format does not support multi-pages, then the output files are compressed into a ZIP file and its properties set in Archive. This occurs only if the conversion results in more than one file (if the input document contains more than a single page).

For example, if the user selected a document format using DocumentConverterJobData.DocumentFormat that supports multiple pages, such as DocumentFormat.Pdf or DocumentFormat.Docx, then Archive is not used. Instead, the final document is stored in Document and the user can retrieve this document using Document.Url. The name of the document is DocumentConverterJobData.DocumentName plus the common extension of the output format (for instance, .pdf for PDF files and .docx for DOCX files).

If the user selected a document format that does not support multiple pages, such as SVG, then the archive is used if the conversion results in multiple pages. In this case, the DocumentConverterJobData.PageNumberingTemplate is used to generate the names of each page and the result is compressed into a single ZIP file that is stored in Archive. The user can retrieve this document using Archive.Url. The name of the document will be DocumentConverterJobData.DocumentName plus .zip which is the common extension of ZIP archives. If the conversion results in a single file, then archiving is not used and the result will be similar to the previous case of a multipage capable format conversion.

Similar to document conversion, if the user selected a raster format using DocumentConverterJobData.RasterImageFormat that supports multiple pages, such as RasterImageFormat.Tif or RasterImageImage.RasPdf, then the same rules are used for multipage document files discussed above. If the user selects a format that does not support multiple pages, such as RasterImageFormat.Jpeg or RasterImageFormat.Png, then the rules of single-page formats discussed above are used.

If the user selected to generate an external annotation file (by setting DocumentConverterJobData.AnnotationsMode to DocumentConverterAnnotationsMode.External) or if the output format does not support embedded annotations, then the annotations are saved into a separate file on the server and its properties can be retrieved using Annotations. The engine will use DocumentConverterJobData.DocumentName plus the extension ".xml" as the file name. If DocumentName is null, then the generic "annotations.xml" file name will be used.

After a successful conversion, the user can obtain the URL's result directly from Document.Url, Archive.Url or Annotation.Url and pass the values to other part of the system that accept a URL (for example, window.open) or can call the DocumentFactory.DownloadDocumentData method to download the document in its entirety or in chunks as a stream of byte array. In either case, the MimeType and Length properties of each item contains the MIME-type and length of the file in bytes values that can be used when downloading the data.

For an example, refer to LEADDocument.Convert

Target Platforms

Reference

DocumentConvertResult Members

Leadtools.Document Namespace