Setting up file type definitions to enable Document Conversion Services | HCL Digital Experience

Set up file definition types to ensure that document conversions works for the Microsoft Office and OpenOffice file types.

Notice of Deprecation and Replacement of Document Conversion Services:

Document Conversion Services components in HCL Digital Experience software will be updated and replaced in the future HCL DX Container Update release in 2022. HCL Digital Experience will remove the third-party component, which is supplied by Oracle, that provides these capabilities and replace them with HCL supported functions. After that point, HCL Digital Experience v8.5, v9 and v9.5 Container Update and CF releases will include the newer HCL supported component. Refer to the following HCL Digital Experience support Knowledge Article: Replacement of Document Conversion Services component in HCL Digital Experience software for additional information.


  1. Locate the file in the following directory:
    • AIX®, HP-UX, Linux, Solaris, Windows: AppServer_root/java/jre/lib
    • IBM® i:
      • JDK 7: /QOpenSys/QIBM/ProdData/JavaVM/jdk70/64bit/jre/lib
      • JDK 7.1: /QOpenSys/QIBM/ProdData/JavaVM/jdk71/64bit/jre/lib
    • z/OS®: AppServer_root/java/lib
  2. Update the file as follows.
    These extensions are case-sensitive.
    Microsoft® Office 2007
    application/vnd.openxmlformats-officedocument.wordprocessingml.document: \
    		 description=Microsoft Word 2007 file;\
    application/vnd.openxmlformats-officedocument.presentationml.presentation: \
    		 description=Microsoft PowerPoint 2007 file;\
    application/vnd.openxmlformats-officedocument.spreadsheetml.sheet: \
    		 description=Microsoft Excel 2007 file;\
    Microsoft® Office (before 2007)
    application/msword: \
    	description=Microsoft Word;\
    application/ \
    	description=Microsoft Excel;\
    application/ \
    	description=Microsoft PowerPoint;\
    Lotus® SmartSuite®
    application/vnd.lotus-freelance: \
            description=Lotus Freelance;\
    application/vnd.lotus-1-2-3: \
            description=Lotus 1-2-3;\
    application/vnd.lotus-wordpro: \
            description=Lotus WordPro;\
    application/vnd.sun.xml.writer: \
    	description=Open Office;\
    application/vnd.sun.xml.writer.template: \
    	description=Open Office;\
    application/ \
    	description=Open Office;\
    application/vnd.sun.xml.calc: \
    	description=Open Office;\
    application/vnd.sun.xml.calc.template: \
    	description=Open Office;\
    application/vnd.sun.xml.impress: \
    	description=Open Office;\
    application/vnd.sun.xml.impress.template: \
    	description=Open Office;\
    application/vnd.sun.xml.draw: \
    	description=Open Office;\
    application/vnd.sun.xml.draw.template: \
    	description=Open Office;\
    application/vnd.sun.xml.math: \
    	description=Open Office;\
  3. Install the appropriate package for your system.
    Table 1. Systems and packages
    Systems Extra Packages
    AIX® X11R6
    HP-UX X11R6
    IBM® i (v7r1) X11R6
    LessTif or Motif with (Stellent 8.0.1)
    LessTif or Motif with (Stellent 
    7.75 or earlier)
    Solaris X11R6
    Windows n/a
    z/OS® X11R6

    If OpenMotif is included on the Linux server, do not need to install the LessTif Rational Portfolio Manager package. The binary files for the LessTif package are already included.


A temporary directory is used for document conversion.
  • Windows: c:\temp
  • AIX®, HP-UX, Linux, Solaris: /tmp
    Note: The default /tmp directory is in the root system. If it does not exist, it must be created.
  • IBM® i: /temp
  • z/OS®: /tmp
To create a temporary directory other than the default, edit the convertors.xml file in wp_profile_root/PortalServer/dcs. Add the property tempDir to the <global> tag as follows:
<property name="tempDir" value="yourtempDirectory"/>

What to do next

To start the native application when you click the attachment, the following MIME types must be registered in WebSphere® Application Server to enable browsers to properly display documents of that type. The following extra types must be registered:
  • application/msword doc
  • application/ xls
For AIX®, HP-UX, Linux, Solaris, you must start IBM® Workplace Services Express® from the console or an X-Server-enabled client with the same privileges (xhost+) as the console.
Note: Graphical conversions require access to an X Windows server. They require access to the Xm, Xt, and X11 libraries. Also, the DISPLAY environment variable must be set to the account that Portal is running under. The DISPLAY must be valid at the point that Portal is started. Therefore, telnetting to a server and starting Portal from there does not work. You must start the portal from an X terminal.

For AIX®, HP-UX, and IBM® i, refer to the prerequisites as described in Configuring images for Document Conversion Services.

For IBM® i, refer to the prerequisites as described in Configuring images for Document Conversion Services.