Portal Express, Version 6.0
Operating systems: i5/OS, Linux, Windows

---

 

Enable Document Conversion Services

Use Document Conversion Services to view a document as HTML.

Documents produced by many standard applications (such as word processors or spreadsheet editors) can be viewed as HTML pages using Document Conversion Services. Document Conversion Services is integrated with the Document Manager portlet. Documents received as attachments to e-mail can be viewed in the browser even if the application that created the document is not installed. Document Conversion Services also allows documents to be searched by content. Document pages can also be converted into an image format such as GIF, BMP, JPG or PNG. This section describes how to set up file type definitions and enable Document Conversion Services for the Document Manager portlet.

 

i5/OS requirement: The document conversion functionality of Document Manager requires the installation of OS/400 - Additional Fonts (5722SS1, Option 43) on your i5/OS system. For more information, refer to the Document Rendering on i5/OS topic.

Perform the following configuration steps to ensure that document conversions will work for Microsoft Office, Lotus SmartSuite, and OpenOffice file types:

1. Locate the content-types.properties file in the following directory:

   app_server_root\java\jre\lib

   For i5/OS, the content-types.properties file is under /QIBM/ProdData/Java400/jdk14/lib.

2. Update the content-types.properties file as follows. These extensions are case-sensitive.

   • Microsoft Office 2007:

     application/vnd.openxmlformats-officedocument.wordprocessingml.document: \
     		 description=Microsoft Word 2007 file;\
     		 file_extensions=.docx 
     application/vnd.openxmlformats-officedocument.presentationml.presentation: \
     		 description=Microsoft PowerPoint 2007 file;\
     		 file_extensions=.pptx 
     application/vnd.openxmlformats-officedocument.spreadsheetml.sheet: \
     		 description=Microsoft Excel 2007 file;\
     		 file_extensions=.xlsx

   • Microsoft Office (prior to 2007):

     application/msword: \
     	description=Microsoft Word;\
     	file_extensions=.doc 
     application/vnd.ms-excel: \
     	description=Microsoft Excel;\
     	file_extensions=.xls 
     application/vnd.ms-powerpoint: \
     	description=Microsoft PowerPoint;\
     	file_extensions=.ppt

   • Lotus SmartSuite:

     application/vnd.lotus-freelance: \
             description=Lotus Freelance;\
             file_extensions=.prz 
     application/vnd.lotus-1-2-3: \
             description=Lotus 1-2-3;\
             file_extensions=.123
     
     application/vnd.lotus-wordpro: \
             description=Lotus WordPro;\
             file_extensions=.lwp

   • OpenOffice:

     application/vnd.sun.xml.writer: \
     	description=Open Office;\
     	file_extensions=.sxw 
     application/vnd.sun.xml.writer.template: \
     	description=Open Office;\
     	file_extensions=.stw 
     application/vnd.sun.xml.writer.global: \
     	description=Open Office;\
     	file_extensions=.sxg 
     application/vnd.sun.xml.calc: \
     	description=Open Office;\
     	file_extensions=.sxc 
     application/vnd.sun.xml.calc.template: \
     	description=Open Office;\
     	file_extensions=.stc 
     application/vnd.sun.xml.impress: \
     	description=Open Office;\
     	file_extensions=.sxi 
     application/vnd.sun.xml.impress.template: \
     	description=Open Office;\
     	file_extensions=.sti 
     application/vnd.sun.xml.draw: \
     	description=Open Office;\
     	file_extensions=.sxd 
     application/vnd.sun.xml.draw.template: \
     	description=Open Office;\
     	file_extensions=.std 
     application/vnd.sun.xml.math: \
     	description=Open Office;\
     	file_extensions=.sxm

3. Make sure you have the appropriate package installed for your system.

   Systems	Additional Packages
   i5/OS (v5 r2) PASE	X11R6
   Linux *	X11R6 LessTif or Motif with libXm.so.1 (Stellent 8.0.1) LessTif or Motif with libXm.so.2 (Stellent 7.75 or earlier)
   Windows	n/a

   * If OpenMotif is included on the Linux server (for example, RedHat 3.0) then you do not need to install the LessTif RPM package, as the binaries for the LessTif package are already included.

A temporary directory is used for document conversion. The default temporary directory is:

• Windows: c:\temp

• Unix: /tmp

  The default Unix /tmp directory is located in the root system and needs to be created if it does not exist.

• i5/OS: /temp

If you wish to create a different temporary directory other than the default, you can edit the convertors.xml file in the portal_server_root\shared\app directory. Add the property "tempDir" to the <global> tag:

<global>
<property name="tempDir" value="yourtempDirectory"/>
</global>

To launch the native application when clicking 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 additional types need to be registered:

• application/msword doc

• application/vnd.ms-excel xls

On platforms that support local document conversion, document conversion services can be delegated to a remote server to better balance processing power and manage server performance. For more information, see Enabling remote document conversion.

 

i5/OS: You can choose to run the X Server on the portal server or a remote server. You can also use a framebuffer device or XVFB to emulate X Windows servers on a headless server. The conversion filters are installed with WebSphere Portal Express. There is no need for configuration. However, you can configure the export.cfg file, located under the portal_server_root_user/shared/app directory, if you want to fine tune conversion properties such as graphics size and resolution.

 

Related tasks
Enabling remote document conversion Converting document formats

 

Related reference

Files that can be viewed as HTML

---