4.14 Understanding and Configuring Document Conversions with Micro Focus KeyView

Micro Focus Vibe uses the Micro Focus KeyView converter to perform document conversions. Documents undergo two types of conversions:

  • Word conversion when they are first added to the Vibe site

  • HTML conversion when they are viewed as HTML from the Vibe site

If the Micro Focus KeyView converter is crashing with certain file types during the word conversion process, you can exclude the problematic file types from being indexed to the Vibe site.

4.14.1 Configuring Which File Formats Can Be Viewed as HTML

Many file formats in Micro Focus Vibe can be viewed as HTML by default, as described in Viewing the File in HTML Format in the Micro Focus Vibe 4.0.8 User Guide. File formats that can be viewed as HTML by default are: .123, .bmp, .doc, .docx, .dotm, .drw, .dxf, .htm, .html, .lwp, .odp, .ods, .odt, .ppt, .pptx, .prz, .rtf, .shw, .sxw, .tif, .txt, .vsd, .wpd, .xls, .xlsx, .sxi

Some file formats, such as .pdf files, cannot be viewed as HTML by default. This is because the quality of these files is lessened when viewed as HTML. However, if you choose, you can enable non-default file formats, such as .pdf files, to be viewed as HTML.

Not all file formats can be enabled to be viewed as HTML in Vibe, but many can be. If you are unsure whether Vibe supports a particular file format to be viewed as HTML, try it and see.

You can enable additional file formats to be viewed as HTML during the Vibe installation, as described in Installing and Setting Up a Basic Vibe Site in the Vibe 4.0.8 Installation Guide.

4.14.2 Excluding File Types from Being Indexed

If the Micro Focus KeyView converter is crashing with certain file types during indexing, you can restrict the problematic file types from being indexed.

Excluding File Types from Being Indexed to the Vibe Site

IMPORTANT:Performing the following procedure causes the file types that you specify to be excluded from searches performed in Vibe.

  1. Change to the following directory:

    Linux:

    /opt/novell/teaming/apache-tomcat/
                               webapps/ssf/WEB-INF/classes/config

    Windows:

    c:\Program Files\Novell\Teaming\apache-tomcat\
                               webapps\ssf\WEB-INF\classes\config
  2. Open the ssf.properties file in a text editor.

  3. Search for the following line:

    exclude.from.keyview.indexing.extensions=
    exclude.from.libreoffice.indexing.extensions=
  4. Make a backup copy of the ssf-ext.properties file, which is located in the same directory as the ssf.properties file.

  5. Open the ssf-ext.properties file in a text editor.

  6. Copy the exclude.from.keyview.indexing.extensions= line from the ssf.properties file to the bottom of the ssf-ext.properties file.

  7. Add the file types that are causing LibreOffice to crash to be the value of this property. For example, exclude.from.keyview.indexing.extensions=.pptx,.odf

  8. Save and close the ssf-ext.properties file.

  9. Close the ssf.properties file without saving it.

  10. Stop and restart Vibe.

Excluding File Types from Being Displayed in HTML

You can display files in HTML view as described in Viewing the File in HTML Format in Working with Folder Entries in the Micro Focus Vibe 4.0.8 Advanced User Guide. If LibreOffice crashes during this HTML conversion process with certain files, you can exclude the problematic file types from being converted. These file types can then no longer be viewed in HTML. For information on how to exclude file types from displaying in HTML, see Configuring Which File Formats Can Be Viewed as HTML.