How to Specify PDF Builder for Output

We offer three different means of generating PDF output through our engines: our internal Windward PDF renderer, Microsoft Office PDF and PdfTron. We use our internal PDF render by default. Here are the instructions on how to specify which PDF builder you want yo use for output.

.NET RESTful Engine#

If you use the .NET RESTful engine, you can specify your desired PDF builder in the Web.config file. To do so set these properties:

  • For PDFtron builder:
<WindwardReports>
<add key="use.external.output.builder" value="on" />
<add key="output.builder" value="net.windward.env.PDFTronOutputBuilder" />
</WindwardReports>
  • For Microsoft Office PDF builder, you will need to supply the path to the "OfficeOutputBuilder.dll" file in the bin folder of your engine:
<WindwardReports>
<add key="use.external.output.builder" value="on" />
<add key="output.builder" value="{Path_To_OfficeOutputBuilder.dll};OfficeOutputBuilder.WindwardOutputBuilder"/>
</WindwardReports>
note

Make sure to include the name of the dll in the {Path_To_OfficeOutputBuilder.dll}

Configuring IIS to Access Microsoft Office#

  1. In a command prompt, run 'DCOMCNFG'
  2. In the Component Services window, browse to 'Component Services' -> 'Computers' -> 'My Computer'
  3. Double click 'DCOM Config'
  4. Click ‘NO’ for all ‘DCOM Configuration Warning’ popup windows.

  1. Find 'Microsoft Word 97 - 2003 Document'
  2. If it isn't there, run 'mmc comexp.msc /32' in a command prompt and repeat steps 2 and 3
  3. Right click on 'Microsoft Word 97 - 2003 Document' and select 'Properties'
  4. In the 'General' tab, change the 'Authentication Level' to 'None'

  1. Open the 'Security' tab
  2. In all three sections (‘Launch and Activation Permissions’, ‘Access Permissions’, and ‘Configuration Permissions’), do the following:
    1. Toggle the radio button from 'Use Default' to 'Customize'
    2. Click on ‘Edit…’
    3. Click on ‘Add…’
    4. Enter ‘Everyone’
    5. Click ‘OK’
    6. Select all the available permissions for Everyone
    7. Click ‘OK’ to close the Permission window

  1. Open the ‘Identity’ tab
  2. Change the radio button from ‘The launching user’ to ‘The interactive user’
  3. Click "Apply'
  4. Click 'OK' in the 'Microsoft Word 97 - 2003 Document Properties' window to save your changes and close the window

  1. Open the ‘Properties’ of your C:\Windows\Temp directory
  2. Select the 'Security’ tab
  3. Select the ‘Edit...’ button
  4. Click the ‘Add...’ button
  5. Add the IIS user
  6. Give that user the ‘Modify’ permission
  7. Click ‘Apply’
  8. Select ‘OK’ to save your changes and close the window
  9. Select ‘OK’ again in the 'Temp Properties' window to save the changes and close the window

Java RESTful Engine#

If you use the Java RESTful engine, you can specify your desired PDF builder in the WindwardReports.properties file. To do so set these properties:

  • For PDFtron builder:
use.external.output.builder=true
output.builder=net.windward.env.PDFTronOutputBuilder
  • For Microsoft Office PDF builder, you will need the "OfficeToPdf.exe" file. To get this file please contact our support team at support@windward.net. Once you have the file, enter the following values in the WinwardReports.properties file:
use.external.output.builder=true
OfficeToPdf.exe= "PATH_TO\\OfficeToPdf.exe"
note

Make sure to include the name of the exe in the PATH_TO\\OfficeToPdf.exe