Installing the Aras HTML to PDF Converter

The Aras HTML to PDF Converter consists of files that get imported on top of the existing Aras Conversion Server.

To install the Aras HTML to PDF Converter:

1. Copy the Aras HTML to PDF Converter package to a local drive on the Conversion Server.

This Aras HTML to PDF Converter folder is in the Utilities directory of the Aras Innovator CD Image on the Aras MFT website (https://mft.aras.com/InnovatorLatestRelease/)

2. Copy the ‘ConversionServer’ folder to the root directory where the Conversion Server was installed, overwriting the existing ‘ConversionServer’ folder and its contents.
3. Restart IIS.

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

1. Open ConversionServerConfig.xml file for editing.
1. 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>

5. Save and close the ConversionServerConfig.xml file.
6. Confirm that the Conversion Server is configured to run via the Aras Agent Service. For details, see Section 4.1 of the Aras Innovator 33 – Conversion Server Setup Guide.