Nous allons maintenant ecrire notre premier agent. N'oubliez pas que nous creons du code dans la perspective d'une application web : l'agent sera donc execute depuis un client web.

• Dans Domino Designer, ouvrez votre base Domino puis cliquez sur Agent
• Au dessus de la liste des agents, cliquez sur New Agent.

La copie d'ecran ci-dessous nous donne un apercu de la fenetre du designer lors de la creation d'un nouvel agent :

J'ai encadre en rouge les zones qui me semblent importantes. Comme vous pouvez le remarquer, je travaille sur une version anglaise du logiciel, mais je suppose que vous n'aurez aucune difficulte a transposer les explications dans la version francaise. Sinon, ecrivez-moi.

Name
C'est le titre de l'agent. Comme pour les autres elements de structure, vous pouvez lui associer un alias (le mot qui apparait apres la barre verticale |). L'utilisation des alias facilite le developpement d'agents pour le web : ils constituent de bons raccourcis lorsqu'ils sont utliises dans les URL ou dans le code, alors que le nom complet de l'agent, que l'on choisira pour son sens, facilite la comprehension d'ensemble du code. Il est donc conseille d'utiliser les alias systematiquement.

Shared agent
Il est essentiel que votre agent puisse etre execute par d'autres utilisateurs : en consequence, vous creerez toujours des agents publics (Shared Agents). ATTENTION : Pensez-bien a cocher cette case des la creation de l'agent car cela deviendra impossible des que l'agent sera sauvegarde. Il vous faudra alors creer un nouvel agent et faire un copier/coller du code.

Which document should it act on?
Lorsque vous utilisez le client natif (ie Notes) vous pouvez executer des agents sur l'integralite des documents de la base,sur une vue, ou simplement sur une selection de documents. Pour les agents web, vous devez imperativement selectionner 'All documents in database'. Tout autre choix entrainera une erreur d'execution, que vous pourrez mettre beaucoup de temps a identifier si vous ne pensez pas tout de suite a consulter le fichier journal.

Objects
En bas a gauche, vous voyez la liste des methodes de l'agent. J'ai encadre "Initialize" parce que c'est ici que vous saisirez l'essentiel du code. On se sert rarement de Terminate dans ce contexte. Voici la signification des trois objets principaux.

• (Options) : on y saisit les options generales comme celle que j'ai encadre et sur laquelle je vais revenir un peu plus loin. C'est egalement a cet emplacement que l'on indique les eventuelles bibliotheques de script que l'on utilise. Nous reviendrons sur cette notion, mais sachez deja que les bibliotheques de script facilitent grandement le developpement en rendant possible la re-utilisation du code.
• (Declarations) : contient la liste des variables globales, c'est a dire des variables definies pour l'ensemble des fonctions et procedures de l'agent. Mais j'aurai l'occasion de revenir sur cette zone.
• Initialize : contient le code principal de l'agent.

A droite, dans la section "(Options)", j'ai entoure Option Declare car il s'agit d'une option particulierement utile lorsque l'on developpe en basic. Si vous etes familier de ce langage, vous savez certainement qu'il n'est pas indispensable de declarer les variables en prealable de toute utilisation. C'est pratique mais cela complique considerablement la tache de debuggage en raison des multiples erreurs liees a une mauvaise saisie. Croyez-en mon experience, vous avez tout interet a utiliser cette option.