> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OfficeConversionSettings Object (IOfficeConversionSettings Interface)

<Note>
  This object is implemented in FRE for Linux and Windows.
</Note>

<Warning>
  Beginning with v12.8.0, you will need to install Microsoft Office or LibreOffice to ingest office documents.
</Warning>

This object contains the settings used to import digital documents of various formats using the same methods which open the input images.

Opening all input files through a unified procedure will be useful in cases where you do not know beforehand the format of incoming documents, but all of them need to be processed in the same way (for example, added to your organization's document management system).

When an input file in one of the [supported formats](/fine-reader/engine/specifications/supported-digital-document-input-formats) is encountered, the program will start an external application to convert it and load the contents. Which application will be used depends on the OfficeConverters property: it contains the list of converters to be used in the order of priority.

<Note>
  Windows example: If the list contains the OCT\_MsOffice and OCT\_AbbyyOffice constants, in that order, the program will start Microsoft Office; if it is not installed on the workstation, the file will be converted by means of internal ABBYY mechanisms.
</Note>

<Warning>
  You may import digital documents only if your license supports the [Office Formats Opening](/fine-reader/engine/licensing/modules) module.
</Warning>

## Properties

<table><thead><tr><th><p><strong>Name</strong></p></th><th><p><strong>Type</strong></p></th><th><p><strong>Description</strong></p></th></tr></thead><tbody><tr><td><p><strong>Application</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/engine-object-iengine-interface">Engine</a></strong>, <a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">read-only</a></p></td><td><p>Returns the <strong>Engine</strong> object.</p></td></tr><tr><td><p><a name="msofficepassword" /><strong>MsOfficePassword</strong></p><Note>Windows only.</Note></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">BSTR</a></strong></p></td><td><p>The password for the custom user of Microsoft Office.</p><p>The property is ignored if <strong>UseMsOfficeCustomUser</strong> is FALSE.</p></td></tr><tr><td><p><a name="msofficeusername" /><strong>MsOfficeUserName</strong></p><Note>Windows only.</Note></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">BSTR</a></strong></p></td><td><p>The name of the custom user of Microsoft Office.</p><p>The property is ignored if <strong>UseMsOfficeCustomUser</strong> is FALSE.</p></td></tr><tr><td><p><a name="officeconverters" /><strong>OfficeConverters</strong></p></td><td><p><strong><a href="/fine-reader/engine/api-reference/image-related-objects/officeconverters">OfficeConverters</a></strong>, <a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">read-only</a></p></td><td><p>A collection of the types of applications which may be used to convert the incoming documents, in order of priority.</p><p>By default, the collection contains the converters described by the <strong><a href="/fine-reader/engine/api-reference/enumerations/officeconvertertypeenum">OfficeConverterTypeEnum</a></strong> constants, in the following order:</p><ul><li>OCT\_MsOffice (Win),</li> and <li>OCT\_LibreOffice</li></ul></td></tr><tr><td><p><a name="usemsofficecustomuser" /><strong>UseMsOfficeCustomUser</strong></p><Note>Windows only.</Note></td><td><p><strong><a href="/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">VARIANT\_BOOL</a></strong></p></td><td><p>Specifies if Microsoft Office applications should be run under non-default user name. The <strong>MsOfficeUserName</strong> and <strong>MsOfficePassword</strong> properties should be set to this user's name and password, if you set this property to TRUE.</p><p>This property is FALSE by default.</p></td></tr></tbody></table>

## Related objects

<img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/officeconversionsettings.gif?s=48021805b163f58f83da2884834a44ef" alt="OfficeConversionSettings" width="189" height="83" data-path="images/fine-reader/engine/officeconversionsettings.gif" />[](/fine-reader/engine/api-reference/image-related-objects/prepareimagemode#officeconversionsettings)[](/fine-reader/engine/api-reference/image-related-objects/officeconverters)[](/fine-reader/engine/api-reference/image-related-objects/prepareimagemode)

[Object Diagram](/fine-reader/engine/api-reference/object-diagram)

## See also

[Working with Properties](/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)

[Supported Digital Document Input Formats](/fine-reader/engine/specifications/supported-digital-document-input-formats)