Job and document processing options

This page provides a list of all equivalent options in the Conversion Service for application options, job options, and document options when migrating from the 3-Heights® Document Converter.

caution

These tables represent the current implementation. The exact conversion process and options used for internal components and external applications may change in future versions without prior notice.

Application options

[*]	Equivalent setting in Conversion Service	Note
disabled	Not configurable (automatic)	Applications cannot be disabled, you can disable Office file conversion in the Profile settings if MS Office is not available.
Extensions	Not configurable (automatic)	An optimal conversion process is determined automatically for each file type, workflow, and profile configuration. The association of file types with a specific application cannot be configured explicitly.
MaxCallDuration	Profile setting Job Settings -> Task Timeout	This setting simultaneously applies to all conversion tasks independent of component/application used for conversion.
preload	Feature not available (false)	All external applications are currently loaded on demand.
RestartAfterConversions	Not configurable (~1000)	Each worker process and all associated applications are automatically restarted after 1000 conversions, regardless the applications involved.
RestrictToExtension	Not configurable (automatic)	A suitable conversion processes is selected automatically for each file type.
WorkingSet	Not configurable (automatic)	The memory usage of the conversion processes is limited/monitored automatically.

MS Word

[MSWord]	Equivalent setting in Conversion Service	Note
BFFValidate	Feature not available (disable)	Binary format validation for Word 97-2003 documents is currently not available.
BitmapMissingFonts	Not configurable (true)
CreateBookmarks	Not configurable (1)	Bookmarks are always created for Headings.
DocStructureTags	Archive workflows: Profile setting Document Optimization (optional) -> Optimization Profile Conversion Workflow: Profile setting Conversion Settings -> Optimize For	Structure information is always generated unless the optimization profile web, max, print or mrc is selected or Optimize For is set to Size
EmbeddedDocuments	Profile setting Conversion Settings -> Convert Mode for Child Documents	Flexible rule-based configuration See Nested Files & Attachments
LockFields	Feature not available (false)
UpdateFieldsAtPrint	Not applicable	Printing is not used for conversion in the Conversion Service.
PW	Document option DOC.PASSWORD	Password can only be passed at runtime and cannot be configured statically
ShowComments	Not applicable	Only applies if SAVEASPDF=false. See option SAVEASPDF
SAVEASPDF	Not configurable (true)	The Conversion Service never uses printing and thus always uses the export functionality of MS Word.
UseISO19005_1	Not configurable (false)	The built-in PDF/A-1 export of MS Word is not used due to quality issues.

Overriding settings in MS Word

[MSWord]	Equivalent setting in Conversion Service	Note
PageHeight	Profile setting Document Settings -> Default Page Size	This setting simultaneously applies to all non-page based formats such as email or plain text. Limited selection of predefined page sizes available.
PageWidth	Profile setting Document Settings -> Default Page Size	This setting simultaneously applies to all non-page based formats such as email or plain text. Limited selection of predefined page sizes available.
PaperSize	Profile setting Document Settings -> Default Page Size	This setting simultaneously applies to all non-page based formats such as email or plain text. Limited selection of predefined page sizes available.
PageOrientation	Not configurable (0)	Only Portrait orientation is supported at the moment.
PaperMargins	Profile setting Document Settings -> Default Page Margin	This setting simultaneously applies to all non-page based formats such as email or plain text.
PRINTMARKUPS	Not configurable (D)

MS Excel

[Excel]	Equivalent setting in Conversion Service	Note
SAVEASPDF	Not configurable (true)	The Conversion Service never uses printing and thus always uses the export functionality of MS Excel.
BFFValidate	Feature not available (disable)	Binary format validation for Excel 97-2003 documents is currently not available.
FailPageCount	Feature not available (0)
FitToPage	Profile setting Office Conversion -> Excel Layout Settings -> Allow Scaling
ForceLetter	Feature not available (false)
MaxPages	Feature not available ("all pages")	All pages are converted.
PrintArea	Feature not available ( )	The print area of the original document is used
PW	Document option DOC.PASSWORD	Password can only be passed at runtime and cannot be configured statically
SHEET	Feature not available	All sheets are converted
TIFF.DPI	Not applicable	This option only applies to conversion using printing

MS PowerPoint

[PowerPoint]	Equivalent setting in Conversion Service	Note
BFFValidate	Feature not available (disable)	Binary format validation for PowerPoint 97-2003 documents is currently not available.
BitmapMissingFonts	Not configurable (true)
DocStructureTags	Archive workflows: Profile setting Document Optimization (optional) -> Optimization Profile Conversion workflow: Profile setting Conversion Settings -> Optimize For	Structure info is always generated unless Optimization Profile "web", "max", "print" or "mrc" is selected or "Optimize For" is set to "Size"
FitToPage	Not applicable	The Conversion Service does not use printing for conversion. All slides are exported in their original size.
OutputType	Not configurable (1)	PowerPoint presentations are always converted as slides
PrintComments	Not applicable	Only applies if SAVEASPDF=false. See option SAVEASPDF
SAVEASPDF	Not configurable (true)	The Conversion Service never uses printing and thus always uses the export functionality of MS PowerPoint.
UseISO19005_1	Not configurable (false)	The built-in PDF/A-1 export of MS Word is not used due to quality issues.

MS Visio

Conversion of Visio documents is not supported.

MS Outlook

note

Outlook is not used for conversion of MSG files. See EML

[Outlook]	Equivalent setting in Conversion Service	Note
access_grant	Not applicable	Outlook is not used for conversion of MSG files
button_yes	Not applicable	Outlook is not used for conversion of MSG files
OUTLOOKEXE	Not applicable	Outlook is not used for conversion of MSG files
button_yes	Not applicable	Outlook is not used for conversion of MSG files
SKIPFILES	Profile setting Conversion Settings -> Convert Mode for Child Documents	Flexible rule-based configuration. Nested Files & Attachments
SELECTFILES	Profile setting Conversion Settings -> Convert Mode for Child Documents	Flexible rule-based configuration. Nested Files & Attachments
UseHtmlBody	Not applicable	Outlook is not used for conversion of MSG files

MS Project

Conversion of MS Project files is not supported.

OO

Conversion of ODF documents using OpenOffice or LibreOffice is currently not supported. ODF documents are converted using MS Word.

EML

[EML]	Equivalent setting in Conversion Service	Note
HeaderTemplate	Profile setting Document Settings -> Default Language	The email header cannot be customized except for the language of the labels.
Styles	Feature not available (built-in)	Custom styling of the email header is not supported
SELECTFILES	Profile setting Conversion Settings -> Convert Mode for Child Documents	Flexible rule-based configuration. See Nested Files & Attachments
SKIPFILES	Profile setting Conversion Settings -> Convert Mode for Child Documents	Flexible rule-based configuration. See Nested Files & Attachments
SkipUnusedInline	Feature not available (false)	Inline images that are not referenced in the body are always treated as attachments.
DateFormat	Feature not available	The date format is currently not customizable.

TXT2PDF

| [TXT2PDF] | Equivalent setting in Conversion Service | Note | |---|---|---|---| | TEXT.BORDER | Profile setting Document Settings -> Default Page Margin | This setting simultaneously applies to all non-page based formats like email or plain text. | | TEXT.FONTNAME | Not configurable (Windows: Calibri, Linux: LiberationSans) | | | TEXT.FONTSIZE | Not configurable (9) | | | TEXT.HEIGHT | Profile setting Document Settings -> Default Page Size | This setting simultaneously applies to all non-page based formats like email or plain text. | | TEXT.WIDTH | Profile setting Document Settings -> Default Page Size | This setting simultaneously applies to all non-page based formats like email or plain text. | | TEXT.WRAP | Not configurable (true) | The Conversion Service always wraps lines in plain text documents. | | TEXT.LANG | Feature not available | | | TEXT.TITLE | Profile setting Metadata -> Title
Job option META.TITLE | These setting applies to the entire job and set the metadata of the output document. In case of multiple documents per job the effect is not exactly the same. |

EMF

Conversion of Metafiles is not supported.

PDF

| [PDF] | Equivalent setting in Conversion Service | Note | |---|---|---|---| | PDFA-PRECONVERT | Not configurable (~true) | The Conversion Service avoids unnecessary conversions whenever possible. | | URLPerms | Not applicable | This setting applies to the conversion of XFA forms in PDF documents using Adobe Acrobat Reader, which is not supported in the Conversion Service. | | RenderXFA | Not applicable | This setting applies to the conversion of XFA forms in PDF documents using Adobe Acrobat Reader, which is not supported in the Conversion Service. |

Image

| [Image] | Equivalent setting in Conversion Service | Note | |---|---|---|---| | IMG2PDF.EXE | Not applicable / not configurable (~true) | All conversion tasks in the Conversion Service are executed in an external worker process, regardless of the file type. However, the img2pdf.exe command line tool is not involved. | | FitImage | Profile setting Document Settings -> Default Page Size
Profile setting Image Settings -> Conversion | The default page size setting also applies to other file formats like email or plain text. | | Border | Profile setting Document Settings -> Default Page Margin | The default page margin setting also applies to other file formats like email or plain text. |
| CMPRQUAL | Not applicable | Images using lossy compression are not recompressed during conversion. |
| ResolutionDPI | Feature not available | Resampling of images during conversion is not supported in the Conversion Service. |
| ThresholdDPI | Feature not available | Resampling of images during conversion is not supported in the Conversion Service. | | FailSize | Feature not available | |

JPM

Conversion of JPEG2000 Compound Images is not supported.

XPS

Conversion of XPS documents is not supported.

PdfPrinter

[PdfPrinter]	Equivalent setting in Conversion Service	Note
Match	Not applicable	Printing is not used for conversion in the Conversion Service
PaperSize	Profile setting Document Settings -> Default Page Size	The default page size setting only applies to non-page based file formats like email or plain text.
Resolution	Not applicable	Printing is not used for conversion in the Conversion Service
Quality	Not applicable	Printing is not used for conversion in the Conversion Service

TIFFPrinterBW

TIFF output format is not supported.

TIFFPrinterColor

TIFF output format is not supported.

HTML

[HTML]	Equivalent setting in Conversion Service	Note
IEPRINT	Not applicable	Neither Internet Explorer nor MS Word are used for HTML conversion
HTMLMAXLOADTIME	Profile setting Job Settings -> Task Timeout	The task timeout setting simultaneously applies to all conversion tasks, not only HTML conversion
PageSetup	Profile setting Document Settings -> Default Page Size and Default Page Margin	Other than the page size and margin, the page setup cannot be configured
HTMOPT	Not configurable (true)	HTML pre-optimization is always executed, the settings used are determined automatically and cannot be configured

ZIP

[ZIP]	Equivalent setting in Conversion Service	Note
SELECTFILES	Profile setting Conversion Settings -> Convert Mode for Child Documents	Flexible rule-based configuration. See Nested files and attachments
SKIPFILES	Profile setting Conversion Settings -> Convert Mode for Child Documents	Flexible rule-based configuration. See Nested files and attachments
Provider	Not configurable	A built-in component is used for extraction of ZIP archives

PdfOptimize

note

No additional license is necessary to enable optimization in the Conversion Service.

[PdfOptimize]	Equivalent setting in Conversion Service	Note
*	Not configurable	Optimization profiles are built in and cannot be configured explicitly
exepath	Not configurable	The Conversion Service uses a built-in component for PDF optimization. This also means that optimization cannot be repurposed to implement custom post-processing of the resulting document.

Options

[Options]	Equivalent setting in Conversion Service	Note
AllowedTransforms	Feature not available	Custom transforms are not supported in the Conversion Service.
MAXTRANSFORMTIME	Not applicable	Custom transforms are not supported in the Conversion Service.
plugins	Feature not available	Custom plugins are not supported in the Conversion Service.
ForceClose	Not configurable (true)	All external applications are terminated on worker process exit.
TerminateApps	Not configurable (true)	All external applications are terminated on worker process exit.

ACRORD

Adobe Acrobat Reader is not used in the conversion process.

PDFOCR

[PDFOCR]	Equivalent setting in Conversion Service	Note
MaxCallDuration	Profile setting Job Settings -> Job Timeout and Task Timeout	This setting simultaneously applies to all conversion tasks independent of component/application used for conversion. In the Conversion Service, the OCR recognition is split into multiple tasks (per page); in the 3-Heights® Document Converter, the MaxCallDuration applies to the recognition of the entire document. The specific timeout values thus cannot be taken as-is.

Job options

Option in 3-Heights® Document Converter	Equivalent setting in Conversion Service	Note
ALIVECHECK	Not applicable	the Conversion Service is licensed by number of cores, not by number of pages. Any normal conversion can be used as "alive check".
CERTNAME	Profile setting Digital Signatures (optional) -> Signature -> Common Name	This setting only applies to a subset of signature types.
COLLCOMP	Profile setting Conversion Settings -> Collect Mode	See Nested Files & Attachments
CONVERTALWAYS	Not configurable (false)	the Conversion Service automatically determines whether a conversion is necessary and minimizes the amount of conversions to improve performance
EMBEDSOURCE	Archive PDF/A-3 workflow: Profile setting Conversion Settings -> Attach Source Document
ERRSUMMARY	Not applicable	Error handling works differently in the Conversion Service. See Errors & Warnings
ERRPAGE	Feature not available	Error handling works differently in the Conversion Service See Errors & Warnings
FlattenSignatures	Not configurable (true)	The visual part of digital signatures is always preserved.
FlattenFormFields	Not configurable (false)	Form fields are preserved unless document optimization is enabled with profile "max".
FORMAT	Feature not available (pdf)	TIFF output format is not supported.
HTMLPRINTRESOLUTION	Not applicable	The printing infrastructure is not used by the Conversion Service
LINEARIZE	Feature not available (false)	Linearization / Fast web view is not supported.
MAILHEADER	Feature not available (false)	Including extended email header information is not supported.
OCR	Profile setting OCR Settings (optional)	See OCR
OCR.BITONAL	Not configurable (automatic)	The service automatically determines the optimal setting for each page. See OCR
OCR.EMBEDBARCODES	Feature not available (false)	Barcode recognition is not supported. See OCR
OCR.ENGINE	Profile setting OCR Settings (optional) -> Engine	Select type when adding an engine configuration. See OCR
OCR.LANGUAGE	Profile setting OCR Settings (optional) -> Engine -> Languages	See OCR
OCR.IMAGEMODE	Profile setting OCR Settings (optional) -> Images -> Image Processing Mode	See OCR
OCR.TEXTMODE	Profile setting OCR Settings (optional) -> Text -> Text Processing Mode	See OCR
OCR.PAGEMODE	Profile setting OCR Settings (optional) -> Pages -> Page Processing Mode	See OCR
OCR.PARAMETERS	Profile setting OCR Settings (optional) -> Engine -> Parameters or Predefined Profile and Custom Profile	The configuration settings depend on the chosen type of engine configuration. See OCR
OCR.REEMBEDIMAGE	Not configurable (false)	The original appearance of the document is always preserved. See OCR
OCR.ROTATEPAGE	Profile setting OCR Settings (optional) -> Images -> Correct Rotation	See OCR
OCR.TAGGING	Profile setting OCR Settings (optional) -> Tagging -> Tagging Mode	See OCR
PASSTHROUGH	Workflow Archive PDF/A-3: Profile setting Conversion Settings -> Convert Mode for Child Documents	The rule settings only apply to nested documents, not to documents added to the job directly. See Nested Files & Attachments
PDFA	Workflow selection	Whether a PDF/A is produced depends on the selected workflow: true -> "Archive PDF/A-", false -> "Conversion". See PDF-A and Conformance
PDFA.ERROR	Not applicable	PDF/A conversion errors are handled the same way as all other types of errors and warnings. See Errors & warnings and PDF-A and Conformance
PDFA.LOGDETAILS	Not applicable	PDF/A conversion errors are handled the same way as all other types of errors and warnings. See Errors & warnings and PDF-A and Conformance
PDFA.LOGSUMMARY	Not applicable	PDF/A conversion errors are handled the same way as all other types of errors and warnings. See Errors & warnings and PDF-A and Conformance
PDFA.OCRMODE	Profile setting OCR Settings (optional) -> Images -> Image Processing Mode	Option OCR.IMAGEMODE, See OCR
PDFA.EMBEDALLFONTS	Not configurable (false)
PDFA.SUBSET	Not configurable (true)	The use of option PDFA.SUBSET=false is strongly discouraged in the 3-Heights® Document Converter
PDFA.WARNCOLL	Profile setting Conversion Settings -> Warnings -> General -> Child Removed	See Nested Files & Attachments
PDFA.WARNDOWNGRADE	Not applicable	The desired conformance level cannot be configured explicitly. See PDF-A and Conformance
PDFA.WARNUPGRADE	Not applicable	the Conversion Service never upgrades the file to a different PDF/A standard. See PDF-A and Conformance
PDFA.WARNNOTPDFA	Not configurable (false)	The output of the conversion service is always compliant to the requested PDF/A standard. See PDF-A and Conformance
PDFA.WARNFONTSUBST	Profile setting Conversion Settings -> Warnings -> General -> Font Substituted
PDFA.WARNVISDIFF	Profile setting Conversion Settings -> Warnings -> General -> Visual Differences
PDFA.XMPWARNINGS	Profile setting Conversion Settings -> Warnings -> General -> Metadata Removed
PDFA.CONVERTEMBPDF	Profile setting Conversion Settings -> Convert Mode for Child Documents	Flexible rule-based configuration. See Nested Files & Attachments
PDF.COMPLIANCE	Workflow selection	The available workflows correspond to the settings 1AB, 2AUB, 3AUB and PDF. See PDF-A and Conformance
PDF.DATE	The creation date of the input document is used if available
PDF.Embed	Invoice workflow: Option DOC.ROLE	The role of each document has to be specified explicitly. See Nested Files & Attachments
PDF.Info	Profile setting Metadata. Options META..	Only standard info entries can be set. For custom metadata, XMP schemas should be used
PDF.InitialView	Feature not available
PDF.OWNERPASS	Feature not available	PDF encryption is not supported.
PDF.PERMISSION	Feature not available	PDF encryption is not supported.
PDF.Producer	Not configurable (built-in)
PDF.USERPASS	Feature not available	PDF encryption is not supported.
PDFOPTIMIZE	Profile setting Document Optimization (optional)
SIGEMBEDOCSP	Profile setting Digital Signatures (optional) -> Signature	Dependent on the type of signature that is selected.
SIGFIELDS	Feature not available
SIGISSUER	Not applicable	Certificate selection using "Common Name" and "Issuer" is not supported, only by "Fingerprint"
SIGPAGE	Feature not available	Only invisible signatures are supported.
SIGPROFILE	Profile setting Digital Signatures (optional) -> Signature	No separate configuration file necessary: All settings can be made in the respective signature configuration (type dependent).
SIGPROVIDER	Profile setting Digital Signatures (optional) -> Signature	There are separate signature types for each available provider.
SIGPROXYCRED	General application setting Proxy	This setting applies to all outgoing connections of the service, not just signatures.
SIGPROXYURL	General application setting Proxy	This setting applies to all outgoing connections of the service, not just signatures.
SIGREASON	Not configurable (none)
SIGRECT	Feature not available	Only invisible signatures are supported.
SIGSTORE	Not configurable (MY)
SIGSTORELOCATION	Not configurable (1)
SIGTSCRED	Profile setting Digital Signatures (optional) -> Signature -> TSA	Only available for certain signature types.
SIGTSURL	Profile setting Digital Signatures (optional) -> Signature -> TSA	Only available for certain signature types.
WARNSIGNATURES	Profile setting Conversion Settings -> Warnings -> General -> Signature Removed
STAMP	Profile setting Stamping (optional) -> Stamps	The stamp configuration differs significantly and cannot be ported 1:1. See Stamping
TEXTBODY	Not configurable (false)	HTML/RTF body is always used if available.
THUMBS	Feature not available (false)	Thumbnail generation is not supported.
TIFF.BPI	Not applicable	TIFF output is not supported.
TIFF.COMPR	Not applicable	TIFF output is not supported.
TIFF.COMPR.BITON	Not applicable	TIFF output is not supported.
TIFF.COMPR.CONTINOUS	Not applicable	TIFF output is not supported.
TIFF.COMPR.INDEXED	Not applicable	TIFF output is not supported.
TIFF.COMPR.MRC	Not applicable	TIFF output is not supported.
TIFF.COMPR.PDF	Not applicable	TIFF output is not supported.
TIFF.DITHERINGMODE	Not applicable	TIFF output is not supported.
TIFF.DPI	Not applicable	TIFF output is not supported.
TIFF.RENDERINGMODE	Not applicable	TIFF output is not supported.
TIFF.ROTATE	Not applicable	TIFF output is not supported.
TIFF.UNPACK	Not applicable	TIFF output is not supported.
TIFF.XDPI	Not applicable	TIFF output is not supported.
TIFF.YDPI	Not applicable	TIFF output is not supported.
ZIPPED	Feature not available (false)	All workflows produce only PDF output.
ZUGFeRDinvoice.xml:ADD	Feature not available	Embedding of ZUGFeRD electronic invoice data is not supported.
factur-x.xml:ADD	Feature not available	Embedding of Factur-X electronic invoice data is not supported.
#	Feature not available	Passing documents to the service by file path is not supported

Document options

Option in 3-Heights® Document Converter	Equivalent setting in Conversion Service	Note
ADD	Invoice workflow: Option DOC.ROLE	See Nested Files & Attachments
ATTACHMENTS:ADD	Profile setting Conversion Settings -> Collect Mode -> Type -> Email	See Nested Files & Attachments
ATT.Name	REST interface: Multipart header Content-Disposion	It's not possible to specify different names for ATT.Name and ORIGINALNAME. See Option ORIGINALNAME Nested Files & Attachments
ATT.Description	Invoice workflow: Option DOC.DESCRIPTION	See Nested Files & Attachments
CMPRQUAL	Not applicable	Images using lossy compression are not recompressed during conversion.
CODEPAGE	Not configurable	UTF-8 and UTF-16 are detected automatically.
COLLCOMP	Profile setting Conversion Settings -> Collect Mode	Setting cannot be overridden for individual files. Nested Files & Attachments
FAILFILES	Profile setting Conversion Settings -> Convert Mode for Child Documents Profile setting Conversion Settings -> Warnings -> General -> Child Removed	Can only be configured for nested documents (i.e. attachments), not documents that are added to the job directly. See Nested Files & Attachments
FORCEAPP	Not configurable	The association of file types with a specific application cannot be configured explicitly.
HTZDOCS	Not applicable	The conversion of website archives is not supported.
IncludeStructureTags	Not applicable	The conversion of Visio documents is not supported.
IncludeDocumentProperties	Not applicable	The conversion of Visio documents is not supported.
IncludeBackground	Not applicable	The conversion of Visio documents is not supported.
MAILPARTS	Profile setting Conversion Settings -> Convert Mode for Child Documents Watched Mailbox setting Attachments only	Nested Files & Attachments and Mail Folders (Watched Mailboxes)
ORIGINALNAME	REST interface: Multipart header Content-Disposion
AlternateText	Feature not available
LanguageTag	Feature not available
Outline	Dossier workflow: Profile setting Outline (Bookmarks) -> Document Outline Other workflows: Not configurable (automatic)	Nested Files & Attachments
OutputType	Not configurable (1)	PowerPoint presentations are always converted as slides
PRINTCOLOR	Not applicable	TIFF output is not supported.
PRINTDM	Not applicable	The printing infrastructure is not used by the Conversion Service.
PW	Option DOC.PASSWORD
SAVEASPDF	Not configurable (true)	The Conversion Service never uses printing and thus always uses the export functionality of MS Word.
RemoveVBA	Feature not available (false)	Visual Basic macros are not removed from Office documents before conversion, but macros are disabled during conversion to PDF.
AcroRdEnableJS	Not applicable	Conversion of XFA forms in PDF is not supported.
TIFF.COMPR.BITONAL	Not configurable (automatic)
TIFF.COMPR.CONTINOUS	Not configurable (automatic)
TIFF.COMPR.INDEXED	Not configurable (automatic)
TIFF.COMPR.MRC	Not configurable (automatic)
TIFF.UNPACK	Not configurable (automatic)
TRANSFORM	Feature not available	Custom transforms are not supported in the Conversion Service.