External preview extension

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

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

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

  • The document uuid.
  • The downloadUrl.

Configuration

Field / PropertyTypeDescription

extension.external.preview

List

Each row couple of values is a preview content declaration, 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 at Configuration parameters.

Sample

Configuration

Create file named test.jsp and copy into $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("dowloadUrl")%><br />
</body>
</html>

Usage

  • Choose a document with one of the MIME type set in configuration parameters.
  • Show preview tab. Will be shown the external URL based on document mime-type.