The file extension of each file is used to determine what converter is used when Document Conversion Service converts that file.

When using the PEERNET.ConvertUtility.dll methods to convert files, a default file extension mapping profile, File Extension To Converter Map.xml, is used to determine this mapping.  This file can be edited and file extensions can be added, removed and changed as needed.

If desired, the file itself can be copied and renamed and the new mapping file passed to the PEERNET.ConvertUtility methods or the command line tools as needed.

An simpler approach is to customize the file extension mapping by adding the setting into a profile file. This allows you to set the file extension mapping at a file level instead of at the application level. Any file extension mappings found in a profile will override the settings in the base File Extension To Converter Map.xml file.

A common use of this would be to have a profile that uses the PEERNET Passthough Converter to skip processing TIFF files, or one that uses Ghostscript to process PDF files instead of Adobe Reader.

Customizing the File Extension Mapping Profile

File mapping profiles are stored in the same location as the conversion profiles. The default file extension mapping profile, File Extension To Converter Map.xml, is installed as part of Document Conversion Service. The difference between a conversion profile and a mapping profile is detected using the Type attribute on the Profile element. It is 0 for a conversion profile and 1 for a file extension mapping profile.

The mapping consists of the extension (the suffix of the file name past the last dot or period in file's name) and a semi-colon separated list of converter names.  There are two things to remember when modifying this file:

1.Each file extension can only be listed once.

2.The file extensions must be added in lower case and must include both the dot (.) and the extension.

In some cases the file extension may only have one converter associated with it. Others, such as PDF which can be converted using either Adobe Reader, Adobe Acrobat, Ghostscript or Outside-In AX, can potentially have more than one converter, in order of preference, associated with it. The code sample below shows a small snippet of the file mapping in the provided file mapping profile.


Code Sample - File Extension to Converter Mapping


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

<Profile Type="1"

         DisplayName="File Extension To Converter Map"

         Description ="Maps file extensions to the converter to use for that document.">


    <add Name=".doc" Value="Microsoft Word;Outside-In AX"/>

    <add Name=".docx" Value="Microsoft Word;Outside-In AX"/>


    <add Name=".xlsx" Value="Microsoft Excel;Outside-In AX"/>

    <add Name=".xlsm" Value="Microsoft Excel;Outside-In AX"/>



    <add Name=".pdf" Value="Adobe Acrobat Reader;Ghostscript;Outside-In AX"/>






The table below lists the available converters and their default file extensions.


Converter Name

Supported Document Types

Adobe Acrobat Reader

Adobe PDF Documents ( *.pdf)

Autodesk Design Review

Design Review Drawings (*.dwf)

AutoCAD Drawings (*.dwg)

Microsoft Excel

Excel Workbooks (*.xlsx, *.xlsm, *.xls)

Excel Templates (*.xltx, *.xltm, *.xlt)

Excel Binary Workbook (*.xlsb)


Postscript Files (*.ps)

Encapsulated Postscript Files (.eps)

Adobe PDF Documents ( *.pdf)

PEERNET Image Converter

JPEG images (*.jpg)

TIFF images (*.tif)

Windows Bitmap images (*.bmp)

ZSoft PCX images (*.pcx)

ZSoft DCX images (*.dcx)

CServe Portable Network Graphics images (*.png)

Graphics Interchange Format image files (*.gif)

Icon Format (*.ico)

Windows Media Photo images (*.wdp, *.hdp, *.jxr)

PEERNET WIC Image Converter

Icon Format (*.ico)

Windows Media Photo images (*.wdp, *.hdp, *.jxr)


Works with other Windows Imaging Component (WIC) third-party add-ons such as:

DjVu Shell Extension Pack (*.djvu)

FastPicture Viwer Codec Pack adds support for over 45+ image formats and over 500 raw digital camera formats

Internet Explorer

HTML Files (*.htm, *.html)

Secure HTML (*.shtm, *.shtml)

Web Archive (*.mht)

Microsoft Outlook

Outlook Message Files (*.msg)

Outlook Templates (*.oft)

Outside-In AX

Oracle Outside In Viewer Technology (ActiveX) supports over 500 common file formats; see the documentation that came with your Outside In Technology product.

Microsoft PowerPoint

PowerPoint Presentations (*.pptx, *.pptm, *.ppt)

PowerPoint Shows (*.ppsx, *.ppsm, *.pps)

PowerPoint Templates (*potx, *.potm, *.pot)

Microsoft Publisher

Publisher Files (*.pub)

Microsoft Visio

Visio Drawings (*.vsd)

Microsoft Word

Word Documents (*.docx, *.docm, *.doc)

Word Templates (*.dotx, *.dotm, *.dot)

Rich Text Documents (*.rtf)

Plain Text Files (*.txt)

Plain Text Log Files (*.log)

Microsoft XPS

XPS Documents (*.xps)

Open XPS Documents (*.oxps)

PEERNET Passthrough

Any file type.

Passes any file matching the extension through the system without converting.