Customizing Document Conversion Service

---

Controlling Which Converters Are Running

Need: Document Conversion Service comes with many converters for handling the most commonly used document formats. The initial installation settings are to try and run each converter.

When only one or two document formats are to be converted, there is no need to run the converters that are not being used. This can free up memory and processing power for the converters that are being used.

Solution: There are two ways to control which converters are run. You can disable the converters for any file types you are not using, or you can only install the third-party applications for the file types you need to convert. A combination of both methods can be used as needed.

1. Disable the Unused Converters in the Document Conversion Service Configuration File

   Each converter can be manually enabled or disabled in the configuration file for Document Conversion Service.

   If you modify the configuration file while Document Conversion Service is running you will need to restart the service to have the new settings applied.

   A shortcut to the configuration file is created as part of the installation. From the Start menu, go to All Programs – PEERNET Document Conversion Service 2.0 – Edit DCS Configuration File to open the file for editing.

   In the configuration file, look for the section labelled <AppFactories>. Inside this section there is an <AppFactory> section for each converter and each converter has a collection of settings. To disable the converter change the Enabled setting to false. The Enabled setting can be one of the following:

   • auto – the Document Conversion Service will try to run the converter; if it cannot be run, it is treated as if disabled.
   • true – the converter must always be running; this causes Document Conversion Service to fail to start if this converter cannot be run.
   • false – the converter is disabled and will not be loaded.

   The section of the configuration file shown below shows the Microsoft Word (*.doc, *.docx) converter disabled and the Adobe Reader (*.pdf) converter enabled.

   <AppFactories>
     <Factories>
        <AppFactory Name="Microsoft Word"
                   Type="PEERNET.PNDocConv.Applications.PNWordApplicationFactory"
                   Assembly="PNWordApplicationFactory">
         <Settings>
           <add Name="Enabled" Value="false"/>
           <add Name="MaxInstances" Value="5"/>
           <add Name="RecycleThreshold" Value="1000"/>
         </Settings>
       </AppFactory>
       <AppFactory Name="Adobe Acrobat Reader"
              Type="PEERNET.PNDocConv.Applications.PNAcrobatReaderApplicationFactory"
              Assembly="PNAcrobatReaderApplicationFactory">
         <Settings>
           <add Name="Enabled" Value="auto"/>
           <add Name="MaxInstances" Value="2"/>
         </Settings>
       </AppFactory>
        ...     
     </Factories>
     <Settings>
       <!-- Global factory settings -->
       <add Name="MaxInstances" Value="5"/>
       <add Name="RecycleThreshold" Value="100"/>
     </Settings>
   </AppFactories>

2. Only Install the Third-Party Applications for the File Types Being Converted

   For any converter that uses a third-party application, Document Conversion Service auto-detects if the application is installed and only runs the converter if it finds the required application. By not installing and licensing these applications, by default, these converters will not be run.

   This method applies to any converter that uses a third-party application. Some of the converters do not require a third-party application and these would need to be disabled in the configuration file as explained above. See the online help section What Files Can I Convert? for a table outlining which of the converters require a third-party application.