External tab mail extension

The External Tab Mail feature helps you display tab content in the properties tab based on an external URL request when a mail node is selected.  

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

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

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

Configuration

Field / PropertyTypeDescription

extension.external.tab.mail

List

Each row is a pair of values that declare a tab's content; the format is: name;url

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

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 section Experimental configuration parameters  

webservices.visible.properties

List

To make the values of the parameter "extension.external.tab.mail" accessible to all users, the value "extension.external.tab.mail" must be added 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 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 mail.
  • Click on the "name1" tab.

  • Click on the "name2" tab.