Installation de l'agent Jalios sur un serveur Lotus Domino

1. Introduction

Jalios Agent est fourni avec le module JCMS Lotus Notes. Les portlets du module Lotus Notes dialoguent avec cet agent pour obtenir les données quelles doivent afficher.

L'agent est fournit sous forme d'un fichier JAR à déployer dans une base de documents du serveur Lotus Domino.

2. Déploiement sur Lotus Domino 7.x

2.1 Création de la base

  1. Ouvrir Lotus Domino Designer.
  2. Créer une nouvelle base : Fichier > Base de documents > Créer...
  3. Dans le champ Titre entrer jaliosagent, le champ Nom de fichier est automatiquement rempli avec jaliosagent.nsf.

create domino db

2.2 Création de l'agent

  1. Ouvrir la base jaliosagent
  2. Sélectionner Code partagé > Agents
  3. Cliquer sur le bouton Nouvel agent lotus_new_agent_button

open base create agent

La fenêtre Agent s'ouvre.

Remplir l'onglet lotus_agent_general_tab (Général) comme ci-dessous:

create agent general tab

Remplir l'onglet lotus_agent_security_tab (sécurité) comme ci-dessous:

create agent secuty tab

Fermer cette fenêtre en cliquant sur la croix.

2.3 Configuration de l'agent

Dans la base jaliosagent, aller dans la fenêtre Action :

  1. Sélectionner Java importé
  2. Cliquer sur le bouton Importer fichiers de classes...

agent action

Dans la fenêtre Définition de fichiers d'agents Java

  1. Sélectionner le répertoire où se trouve votre fichier JAR
  2. Sélectionner le fichier JAR dans la colonne de gauche
  3. Ajouter ce fichier dans la colonne de droite avec le bouton Ajouter/rempl. fichier(s)
  4. Renseigner le champ Classe de base de l'agent avec com.jalios.notes.JaliosAgent.class
  5. Cliquer sur Ok.

agent files

La fenêtre de l'agent contient le JAR et la classe de base est renseignée.

Cliquer sur Fichier > Enregistrer.

L'agent (Jalios) apparait sur la liste des Agents.

agent after import jar

3. Déploiement sur Lotus Domino 8.5

  • Ouvrir "Lotus designer"

rdesktop_-_notes85.jalios.net_016 Source image

  • Créer une nouvelle application ("jalios agent" / jaliosagent.nsf)
  • Affecter l'application au bon serveur et sélectionner "Blank" comme modèle

rdesktop_-_notes85.jalios.net_017 Source image

  • Cliquer ensuite sur le bouton "Encryption" et sélectionner "Do not locally encrypt this database"

rdesktop_-_notes85.jalios.net_018 Source image

  • Valider ensuite la création de l'application

Nous allons maintenant donner les droits de lecture sur cette application.

  • Effectuer un clic droit sur l'application et aller dans "Application->Access Control"

rdesktop_-_notes85.jalios.net_019 Source image

  • Configurer ici un accés en lecture seule par défaut (et peut-être d'autres groupes s'il y en a)

rdesktop_-_notes85.jalios.net_020 Source image

  • Cliquer sur "OK pour enregistrer ces paramètres

Nous allons maintenant créer l'agent

  • Dans l'application, dans le noeud "Code", cliquer sur "New Agent"

rdesktop_-_notes85.jalios.net_021 Source image

  • Entrer le nom de l'agent (Jalios) et choisir comme type "Imported Java"

rdesktop_-_notes85.jalios.net_022 Source image

  • La fenêtre de l'agent s'ouvre, cliquer alors en bas au milieu sur le bouton "Import Class Files"

rdesktop_-_notes85.jalios.net_023 Source image

  • Ajouter le jar de l'agent (ici notesAgent.jar)

rdesktop_-_notes85.jalios.net_024 Source image

  • Preciser la base class (com.jalios.notes.JaliosAgent.class)

rdesktop_-_notes85.jalios.net_025 Source image

  • Nous devons maintenant configuré quelques paramètres sur l'agent
  • Pour accéder à l'écran de paramètrage, faire un clic droit dans la zone grise en haut contenant le nom de l'agent et choisir "Agent properties"

rdesktop_-_notes85.jalios.net_026 Source image

  • Dans le bloc "runtime", sélectionner "Agent list selection" dans "Trigger" et All documents in database" dans "target"

rdesktop_-_notes85.jalios.net_027 Source image

  • Cliquer alors sur la clé en haut de la fenêtre de propriété pour accéder à la gestion des droits
  • Sélectionner "2. Allow restricted operations" dans le champ "Set runtime security level"

rdesktop_-_notes85.jalios.net_028 Source image

L'agent est maitenant installé. Il est accessible à l'URL http://server:port/jaliosagent/Jalios?openAgent

4. Configuration dans JCMS

Dans JCMS,

  1. Aller dans les propriétés du module : Espace d'administration > Gestion des modules > Module Notes > Administration
  2. Remplir la propriété URL de l'Agent Jalios avec jaliosagent.nsf/Jalios?openAgent

lotus notes prop

5. Tests

Tester la bonne configuration du module et de l'agent en insérant dans une page portail les portlets Notes.

Pour tester si le dépoloiement de l'agent s'est bien passé dans notre cas, lancer un navigateur avec l'url ci-dessous:

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

Le résultat est un document xml avec documentset comme racine.

Import des styles Notes

Ce paragraphe a pour but de definir les specs de l'import de styles Notes (et conversion en css)
Dans un deuxième temps il sera modifié pour expliqué l'existant.

Il existe un logiciel pour browser le style des documents notes : Notespeek
Pour récupérer le style d'un champ en particulier il faut d'abord passer par un "RichTextNavigator" (qui est une classe java présente dans notes.jar)
Le navigator permet de construire un RichtextStyle qui permet d'accéder au style de chaque paragraphes.