External tab folder 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 in the support website.

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

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

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

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

Configuration

Field / PropertyTypeDescription

extension.external.tab.folder

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.folder" accessible to all users, you must add the value "extension.external.tab.folder" to the current list.

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

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

Usage

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

  • Click on "name2" tab.