We apologize for untranslated text, you can use the Google Translation button to get an automatic translation of the web page in the language of your choice.

deployment of jalios agent inside Lotus Domino server

Introduction

Jalios Agent is provided with Lotus Notes plugin. All portlets included in this plugin retrieve data from this agent to display Notes content in JCMS.

The agent is packaged in a jar file and should be deployed on Lotus Domino server.

Deployment of the agent in Lotus Notes 7.x

Database creation

  1. Open Lotus Domino Designer.
  2. Create a new database : File > Database > Create...
  3. In Title field type jaliosagent, Filename field is automatically filled with jaliosagent.nsf.

create domino db

Creation of the agent

  1. Open the database jaliosagent
  2. Select Shared Code > Agents
  3. Click on New Agent button lotus_new_agent_button

open base create agent

Agent frame opens.

Fill  lotus_agent_general_tab (Général tab) with these parameters:

create agent general tab

Fill lotus_agent_security_tab (sécurité tab) with these parameters:

create agent secuty tab

Close this windows with the cross.

Agent configuration

In the database jaliosagent, go to Action zone:

  1. Select Imported java
  2. Click on Import classes...

agent action

In Define java agent files

  1. Select the directory which contains the JAR
  2. Select the JAR in the left column
  3. Add this file in right column with Add/replace files button
  4. Fill Base class field with com.jalios.notes.JaliosAgent.class
  5. Click on OK button.

agent files

Agent frame contains JAR and base class is filled.

Click on File > Save.

Jalios Agent is displayed in agent list.

agent after import jar

Deployment for Lotus Notes 8.5

  • Open "Lotus designer"

rdesktop_-_notes85.jalios.net_016

Source image

  • Create a new application ("jalios agent" / jaliosagent.nsf)
  • Affect this application to the correct server and select "Blank' as model

rdesktop_-_notes85.jalios.net_017

Source image

  • Click on "Encryption" button and select "Do not locally encrypt this database"

rdesktop_-_notes85.jalios.net_018

Source image

  • Validate the creation of the application

Now, we configure read rights on this application.

  • Right-click on the application and go to "Application->Access Control"

rdesktop_-_notes85.jalios.net_019

Source image

  • Configure a read access by default (and perhaps others groups if any)

rdesktop_-_notes85.jalios.net_020

Source image

  • Click on "OK" for saving the parameter

Now, we will create the agent.

  • In the application, on the node "Code", click on "New Agent"

rdesktop_-_notes85.jalios.net_021

Source image

  • Fill agent name (Jalios) and choose "Imported Java" type

rdesktop_-_notes85.jalios.net_022

Source image

  • Agent window opens, cliquer on "Import Class Files" button

rdesktop_-_notes85.jalios.net_023

Source image

  • Add agent JAR (here notesAgent.jar)

rdesktop_-_notes85.jalios.net_024

Source image

  • Add class base (com.jalios.notes.JaliosAgent.class)

rdesktop_-_notes85.jalios.net_025

Source image

  • Some parameters should be configured for this agent.
  • To access to parameters screen, right-click in the grey zone on the top, zone which contains agent name and choose "Agent properties"

rdesktop_-_notes85.jalios.net_026

Source image

  • In "runtime" block, select "Agent list selection" in "Trigger" field and "All documents in database" in "target" field

rdesktop_-_notes85.jalios.net_027

Source image

  • Click on the key tab to access to rights management
  • Select "2. Allow restricted operations" in "Set runtime security level" field

rdesktop_-_notes85.jalios.net_028

Source image

* Agent is now installed. It's accessible with URL http://server:port/jaliosagent/Jalios?openAgent

Configuration in Jalios JCMS

In JCMS,

  1. Go to plugin properties : Admin Area > Modules > Plugin Lotus Notes > Administration
  2. Fill Jalios Agent URL property with jaliosagent.nsf/Jalios?openAgent

lotus notes prop

Tests

To test agent deployment, open a browser with iNotes portal. Once connected to this portal, with the same browser, open URL:

http://server/jaliosagent.nsf/Jalios?openagent

The result is a XML document with empty documentset.

Import from  Notes

 

This paragraph is to define document import specifications from Notes to JCMS
It should be defined to fit to existing database.

A software exist to retrieve Notes styles: Notespeek

To get a particular field style, you must use "RichTextNavigator" (class contains in notes.jar)
The browser will construct a RichtextStyle and you will access to paragraph style.