Question:
How to use DocuWare JAPI in Lotus Notes?
Solution:
This article describes how the DocuWare JAPI can be used from IBM Lotus Notes.
The general requirements for installing and using the DocuWare JAPI are set out in the DocuWare JAPI Tutorial.
System data used for this article:
- Windows 7 32-bit German (Note: Only 32-bit operating systems are supported)
- DocuWare 5.1b Service Pack 3. This article describe the handling on the basis of 5.1b SP3, but you could adept it till the DocuWare Version 6.7.
- IBM Lotus Notes 8.5.1
- Java Virtual Machine used by Lotus Notes 8.5.1: 1.6.0
- The following steps must be carried out so that the DocuWare JAPI can be accessed from a Java agent or Java library in Lotus Notes:
- Unzip DW51b_0003_JAPI.zip to a temporary folder.
- Copy the files from the following table to the Java Classpath of all Lotus Notes clients that need to work with the JAPI.
(Default Classpath for Notes Clients is <Notes_Programpath>\jvm\lib\ext)
JAPI-Core.jar
JAPI-WSAL-Factory.jar
JAPI-WSAL-Impl.jar
JAPI-WSAL-Interface.jar
JAPI-WSAL-Junit-Test.jar
JAPI-WSAL-Test.jar
All files in the \lib sub-folder (without the folder itself)
japi.properties
japi-client.properties - Adapt the content of the japi.properties file to the system used (port and server name).
- Create a new Java agent or a Java library in Notes. This article uses a Java agent as an example.
- Configure the agent's security settings as highlighted in the screenshot:
Set "Runtime security level" to "2. Allow restricted operations".
- Insert the following line in the java.policy file (<Notes_Programpath>\jvm\lib\security) of each Lotus Notes client that needs to work with the DocuWare JAPI. See file section in the screenshot.
"permission java.lang.RuntimePermission "createSecurityManager";"
Once all the steps above have been carried out, the DocuWare JAPI can be used in Lotus Notes. The Lotus Notes client may need to be restarted after these changes have been made.
Example:
