External tab document extension

OpenKM 7.1 comes with two user interfaces, called "classic" and "kcenter". Although both are functionally very similar, the layout and the way they are used may have significant differences. This page is based on the "classic" user interface. If you are using the "kcenter" user interface and have any doubts about accessing any of these features, please create a ticket on the support website.

The External Tab Document feature helps you show tab content in a properties tab based on an external URL request when a node document is selected.  

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

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

  • The authentication token (encrypted)
  • The document uuid
  • The userId

Configuration

Field / PropertyTypeDescription

extension.external.tab.document

List

Each row is a pair of values with a tab content declaration; the format is: name;url

name1;http://localhost:8180/openkm/test.jsp
name2;http://www.openkm.com

webservices.visible.properties

List

To make the values of the parameter "extension.external.tab.document" accessible to all users, you must add the value "extension.external.tab.document" to the current list.

If you forget to add the property name, only administrators will be able to retrieve the value, so some extensions may produce errors for regular users.


More information 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 />
</body>
</html>

Usage

  • Choose a document.
  • Click on "name1" tab.

  • Click on "name2" tab.