Aller au contenu

Agent Notes

Un agent Notes est un morceau de code dans une base Notes qui s'exécute automatiquement à heure fixe, sur un événement ou à la demande de l'utilisateur, généralement écrit en LotusScript.

Un agent Notes est un morceau de code dans une base Notes qui s'exécute automatiquement. Il peut démarrer à heure fixe, quand un document est créé ou modifié, quand un mail arrive, ou quand un utilisateur appuie sur un bouton. Les agents sont le moteur de l'automatisation dans HCL Notes.

Types d'agents

  • Les agents planifiés s'exécutent chaque minute, chaque heure, chaque jour ou chaque semaine sur le serveur Domino. Typiquement pour les rapports, le nettoyage, la synchronisation et les rappels.
  • Les agents événementiels s'exécutent quand des documents sont créés ou modifiés, ou quand un nouveau mail arrive. Utilisés pour les workflows et les réponses automatiques.
  • Les agents manuels sont lancés par l'utilisateur depuis un menu ou un bouton, par exemple un export vers Excel ou des mises à jour en masse.
  • Les agents web sont appelés en HTTP et servent d'API simples, aujourd'hui surtout remplacés par Domino REST API.

En quoi les agents sont-ils écrits ?

La plupart sont écrits en LotusScript. Les agents simples utilisent le langage de formules, et certains sont écrits en Java. Les agents se construisent dans Domino Designer et s'exécutent avec les droits d'un utilisateur donné, généralement le serveur ou la dernière personne qui a enregistré l'agent. C'est un piège de sécurité classique, car un agent enregistré par un administrateur s'exécute avec les accès de l'administrateur.

Problèmes typiques avec les agents

  • L'agent ne s'exécute pas, parce que la personne qui l'a enregistré a quitté l'entreprise et que son ID est bloqué.
  • L'agent manager est surchargé, parce que trop d'agents s'exécutent chaque minute.
  • L'agent envoie du mail, et le mail a migré vers Microsoft 365. Voir la migration Notes.
  • Personne ne sait ce que fait l'agent, parce que le code n'est pas documenté. Nous faisons volontiers une revue.

Questions fréquentes

Comment voir quels agents s'exécutent ?

La commande serveur tell amgr schedule affiche les agents planifiés. Le journal affiche les erreurs. Nous mettons en place une supervision, pour qu'un agent en échec déclenche une alerte.

Un agent peut-il appeler une API externe ?

Oui. LotusScript peut appeler des endpoints HTTP et lire du JSON. C'est ainsi que l'intégration ChatGPT pour Notes est construite.

Qu'est-ce qui remplace les agents après une migration ?

Power Automate, Azure Functions ou des tâches planifiées dans le nouveau système.

Aide sur les agents

Nous dépannons, documentons et réécrivons les agents. Lisez notre page sur le développement Notes.

Tous les termes du glossaire