Configurer un connecteur e-mail

Pour qu'un processus interagisse avec des systèmes externes tels que la publication d'un document sur un CMS, l'appel d'une API REST ou l'envoi d'un mail, Bonita fournit des connecteurs. Dans notre exemple, nous allons configurer un connecteur e-mail pour informer le responsable qu'une tâche Deal with unsatisfied customer requiert son attention.

ℹ info :
Un connecteur est un morceau de code exécuté au début ou à la fin d'un processus ou d'une tâche. Il traite les données d'entrée (par exemple, les valeurs des variables métier) et génère (en option) certaines sorties. Le code du connecteur peut uniquement transformer des entrées, mais peut également exécuter une interaction avec des systèmes externes.

Afin d'éviter les paramètres qui sont spécifiques au fournisseur du service mail, nous allons utiliser un outil permettant de disposer d'un serveur mail local « FakeSMTP » :

  1. Téléchargez FakeSMTP à partir de ce lien : http://nilhcem.github.com/FakeSMTP/downloads/fakeSMTP-latest.zip

  2. Décompressez le fichier

  3. Exécutez FakeSMTP en double-cliquant sur le fichier JAR ou en exécutant cette commande shell : java -jar fakeSMTP-2.0.jar

  4. Lorsque l'interface utilisateur s'affiche, paramétrez le Port d'écoute sur 2525

  5. Cliquez sur le bouton Démarrer le serveur.

    FakeSMTP configuré et en écoute sur le port 2525

Maintenant que le serveur est démarré, configurons le connecteur mail sur la tâche Deal with unsatisfied customer :

  1. Sélectionnez la tâche Deal with unsatisfied customer

  2. Allez dans Exécution > Connecteurs en entrée

  3. Cliquez sur le bouton Ajouter...

  4. Sélectionnez le connecteur Courriel

  5. Cliquez sur le bouton Suivant

  6. Nommez la configuration du connecteur Send notification

  7. Cliquez sur le bouton Suivant

  8. Définissez les valeurs des paramètres suivantes :

    • Hôte SMTP : localhost
    • Port SMTP : 2525 (le numéro de port spécifié dans FakeSMTP)
    • SSL (dans la section Sécurité) : décochée

  9. Cliquez sur le bouton Suivant

  10. Saisissez no-reply@acme.com dans le champ De

  11. Utilisez l'icône icône du crayon pour modifier l'expression du champ À

  12. Définissez Type d'expression sur Script

  13. Collez le script Groovy suivant dans la zone de modification du code : BonitaUsers.getUserProfessionalContactInfo(apiAccessor,taskAssigneeId).email

  14. Cliquez sur le bouton OK

  15. Cliquez sur le bouton Suivant

  16. Définissez You have a pending task comme objet

  17. Cliquez sur Terminer

    Configuration du connecteur courriel

Si vous exécutez le processus avec le connecteur configuré, vous devez voir un nouvel e-mail entrant dans l'interface utilisateur FakeSMTP lorsque la tâche Deal with unsatisfied customer est disponible.

Vous avez maintenant une définition de processus qui utilise une large palette de fonctionnalités de Bonita. Dans les chapitres suivants, nous allons créer une application s'appuyant sur ce processus.