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.
Two parameters are passed in the URL as request parameters:
- The document UUID.
- The downloadUrl.
Configuration
| Field / Property | Type | Description |
|---|---|---|
|
extension.external.preview |
List |
Each row contains a pair of values that define preview content; the format is: mime-type;url application/illustrator;http://localhost:8180/openkm/test.jsp When you embed a URL in an iframe that belongs to a subdomain different from the application's domain, you must include that domain in the configuration; otherwise, the browser will block it for security reasons. You can find more information about the okm.content.security.policy configuration parameter in the Experimental configuration parameters section. |
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.