Configuring the Conversion Server

After you install the Aras HTML to PDF Converter, configure the ConversionServerConfig.xml file as follows:

  1. Open ConversionServerConfig.xml file for editing.

    Typically, this file is located at the root of the Aras Innovator code tree (Sample: C:\Program Files (x86)\Aras\Innovator\ConversionServerConfig.xml)

  2. After the comment <!-- Place here class configuration section definitions for converters --> add:

    <section name="PdfPublishingConverter” type="Aras.Publishing.Configuration.PdfConverterConfig, Aras.TDF.PublishingConverter"></section>

  3. Into the section <Converters/> add:

    <Converter name="tp_PdfPublishingConverter” type="Aras.Publishing.PdfPublishingConverter, Aras.TDF.PublishingConverter"/>

  4. Into the section <ConverterSettings/> after the comment <!-- Place here configuration sections for converters --> add:

    <PdfPublishingConverter>
    <ConvertionTool path="C:\Program Files (x86)\Aras\Innovator\ConversionServer\Prince\bin\prince.exe"/>
    </PdfPublishingConverter>

Note
The path may need to be modified to match the location of your ConversionServer directory.

The following is a sample of a ConversionServerConfig.xml file with the required setup:

<?xml version="1.0" encoding="utf-8"?>

<configuration>

    <configSections>

       <!-- Common converter service configuration -->

       <section name="ConversionServer" type="Aras.ConversionFramework.ConversionServer.Configuration.ConversionServerConfigurationSection, Conversion_Base"/>

       <sectionGroup name="ConverterSettings">

           <!-- Place here class configuration section definitions for converters -->

           <section name="PdfPublishingConverter" type="Aras.Publishing.Configuration.PdfConverterConfig, Aras.TDF.PublishingConverter"></section>

       </sectionGroup>

    </configSections>

    <ConversionServer>

       <InnovatorServer url="http://localhost/InnovatorServer/Server/InnovatorServer.aspx"/>

       <Converters>

           <Converter name="tp_PdfPublishingConverter" type="Aras.Publishing.PdfPublishingConverter, Aras.TDF.PublishingConverter"/>

       </Converters>

    </ConversionServer>

    <ConverterSettings>

       <!-- Place here configuration sections for converters -->

       <PdfPublishingConverter>

           <ConvertionTool path="C:\Program Files (x86)\Aras\Innovator\ConversionServer\Prince\bin\prince.exe"/>

       </PdfPublishingConverter>

    </ConverterSettings>

</configuration>

  1. Save and close the ConversionServerConfig.xml file.
  2. Confirm that the Conversion Server is configured to run via the Aras Agent Service. For details, see Section 4.1 of the Aras Innovator 37– Conversion Server Setup Guide.
Note
Because of difference between Windows and Linux file systems it is required to use OS-specific path separator in paths. Remember that Linux file system is case sensitive so file names "./path/to/file.xml” and "./path/to/File.xml” are different. For more information about cross-platform development please see section “Cross-platform development” in “Aras Innovator 36 - Programmer’s Guide” document.