External preview extension

The External Preview feature helps you preview documents based on an external URL request.

This option is only available if you have enabled the External preview extension.

There are two parameters passed as request parameters in the URL request:

  • The document uuid.
  • The downloadUrl.

Configuration

Field / PropertyTypeDescription

extension.external.preview

List

Each row is a pair of values declaring preview content; the format is:

mime-type;url

application/illustrator;http://localhost:8180/openkm/test.jsp
application/epub+zip;http://localhost:8180/openkm/epub_previewer.jsp
application/x-mspublisher;http://localhost:8180/openkm/mspreviewer_previewer.jsp

More information is available at Configuration parameters.

Sample

Configuration

Create a file named test.jsp and copy it into the $TOMCAT_HOME/webapps/openkm folder.

<%@ page language="java" contentType="text/html; charset=UTF-8"	pageEncoding="UTF-8"%>
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>External URL request example</title>
</head>
<body>
	Request parameters
	<br />
	<br />
	<b>uuid:</b><%=request.getParameter("uuid")%><br />
	<br />
	<b>dowloadUrl:</b><%=request.getParameter("downloadUrl")%><br />
</body>
</html>

Usage

  • Choose a document with one of the MIME types set in the configuration parameters.
  • Open the Preview tab. The external URL based on the document's MIME type will be shown.