|
|
| (5 versions intermédiaires par le même utilisateur non affichées) |
| Ligne 1 : |
Ligne 1 : |
| ===Activités de messagerie=== | | ===Activités de messagerie=== |
| Les activités disponibles pour gérer les messageries sont les suivantes : | | Les activités disponibles pour gérer les messageries sont les suivantes : |
| {| class="wikitable"
| |
| |-
| |
| |
| |
| |Envoyer un Email (SMTP)
| |
| |-
| |
| |
| |
| |Attendre la réponse d’un Email (REST)
| |
| |-
| |
| |
| |
| |Attendre la réponse d’un Email (POP3)
| |
| |-
| |
| |
| |
| |Attente de réception d’Email dans une boîte à lettre (POP3)
| |
| |}
| |
|
| |
|
| Les activités de messageries fonctionnent sur les protocoles standards Internet. | | *[[Envoyer un mail (activity bp)|Envoyer un Email (SMTP)]] |
| | *[[Réponse à un mail (REST) (activity bp)|Attendre la réponse d’un Email (REST)]] |
| | *[[Réponse à un mail (POP3) (activity bp)|Attendre la réponse d’un Email (POP3)]] |
| | *[[Réception de mail (activity bp)|Attente de réception d’Email dans une boîte à lettre (POP3)]] |
| | |
| | {{info|Les activités de messageries fonctionnent sur les protocoles standards Internet.}} |
|
| |
|
| Trois types scénarios sont possibles : | | Trois types scénarios sont possibles : |
|
| |
|
| *Envoyer un mail, | | *Envoyer un mail. |
| *Recevoir un mail, | | *Recevoir un mail. |
| *Déclencher une activité dès réception d’un mail. | | *Déclencher une activité dès réception d’un mail. |
|
| |
|
| Deux méthodes sont offertes pour recueillir la réponse d’un Email : | | Deux méthodes sont possibles pour recueillir la réponse d’un Email : |
|
| |
|
| * REST | | * REST |
| Ligne 32 : |
Ligne 23 : |
| : l’utilisateur répond au message reçu en en modifiant son contenu. L’activité scrute la boîte aux lettres de retour pour recueillir la réponse (Solution Internet). | | : l’utilisateur répond au message reçu en en modifiant son contenu. L’activité scrute la boîte aux lettres de retour pour recueillir la réponse (Solution Internet). |
|
| |
|
| ===Exemple d’utilisation d’une réponse REST=== | | ===Exemples=== |
| | |
| Déroulement du processus :
| |
| | |
| #Lorsqu’un utilisateur modifie le code d’un objet de WFClasseA, une instance du processus est déclenchée.
| |
| #Un email est alors envoyé à deux destinataires.
| |
| #Les destinataires peuvent répondre par Oui ou Non.
| |
| #Le processus attend la réponse, et en fonction du choix de l’utilisateur, exécute l’une ou l’autre des activités.
| |
| | |
| {{#images:image62.png|Guide_-_Processus_métiers}}
| |
| | |
| Comme précédemment le déclenchement du processus utilise un évènement métier, l’activité suivante est l’envoi de l’email.
| |
| | |
| ====Onglet « Mail »====
| |
| | |
| {{#images:image63.png|Guide_-_Processus_métiers}}
| |
| | |
| ====Onglet « Mail »====
| |
| | |
| Identifiant
| |
| | |
| L’identifiant du mail est un identifiant arbitraire utilisé pour réaliser le lien avec l’activité qui va gérer la réponse.
| |
| | |
| Adresse
| |
| | |
| La saisie des adresses des destinataires utilise la convention suivante :
| |
| | |
| les adresses sont séparées par des points-virgules,
| |
| | |
| *si l’adresse contient un caractère arobase @ alors il s’agit d’une adresse externe Internet
| |
| *si l’adresse ne contient pas de caractère arobase @ alors il s’agit d’une adresses interne d’une boîte à message de l’application.
| |
| | |
| Le corps du message est rédigé en HTML. Il contient les URL qui permettent à l’utilisateur de répondre. Pour placer ces URL, sélectionnez une zone de texte qui constituera le texte associée à l’URL puis utilisez la fonction URL de la barre d’outils.
| |
| | |
| {{#images:image64.png|Guide_-_Processus_métiers}}
| |
| | |
| Le corps du message contient aussi des valeurs d’attributs du processus qui seront substituées à l’exécution : [Instance.unCode] la valeur entre les crochets est une expression qui sera évaluée par l’activité lors de l’exécution.
| |
| | |
| ====Onglet « Avancé »====
| |
| | |
| Le lien vers l’écran associé fonctionne si vous renseignez le nom de l’écran dans l’onglet « Avancé ».
| |
| | |
| {{#images:image65.png|Guide_-_Processus_métiers}}
| |
| | |
| Il permet à l’utilisateur d’accéder directement à une interface en rapport avec l’objet métier associé à l’instance du processus.
| |
| | |
| L’attente de la réponse à l’email est paramétrée de la façon suivante :
| |
| | |
| {{#images:image66.png|Guide_-_Processus_métiers}}
| |
| | |
| Il suffit de reprendre l’identifiant de l’activité mail pour effectuer le lien avec l’email envoyé.
| |
| | |
| L’enchainement du processus en fonction de la réponse du destinataire est réalisé ainsi :
| |
| | |
| *Si le destinataire répond OK la séquence Succès suivante est exécutée.
| |
| *Si le destinataire répond NOK la séquence Echec suivante est exécutée.
| |
| | |
| Les activités qui suivront ne feront qu’écrire un message dans l’historique de l’instance.
| |
| | |
| {{#images:image67.png|Guide_-_Processus_métiers}}
| |
| | |
| Exécutez cet exemple en utilisant une machine locale.
| |
| | |
| Tout d’abord ce processus envoi un Email à travers le protocole SMTP, il faut donc fournir les informations sur le serveur de messagerie utilisé. Avec l’application Desktop cela s’effectue dans le panneau de configuration du menu ''Fichier''.
| |
| | |
| {{#images:image68.png|Guide_-_Processus_métiers}}
| |
| | |
| Si nous avions utilisé un Service 1000 comme Serveur du processus ces informations seraient renseignées dans son fichier de configuration.
| |
| | |
| Ensuite le processus attend une réponse renvoyée à travers un service du Serveur 1000, il faut donc exécuter un Serveur 1000 pour récupérer cette réponse.
| |
| | |
| {{#images:image69.png|Guide_-_Processus_métiers}}
| |
| | |
| Utilisez une machine locale. Cette machine n’étant pas le Serveur 1000 qui récupérera la réponse, il est nécessaire de renseigner l’adresse de ce serveur. Cela s’effectue sur les propriétés des « Serveurs de processus métiers ».
| |
| | |
| {{#images:image70.png|Guide_-_Processus_métiers}}
| |
| | |
| Démarrez une instance du processus en modifiant un objet de la classe métier.
| |
| | |
| {{#images:image71.png|Guide_-_Processus_métiers}}
| |
| | |
| L’instance a démarré.
| |
| | |
| {{#images:image72.png|Guide_-_Processus_métiers}}
| |
| | |
| Vérifiez que les emails ont été envoyés. Tout d’abord dans la boîte à message de l’utilisateur vous retrouvez le message de départ.
| |
| | |
| {{#images:image73.png|Guide_-_Processus_métiers}}
| |
| | |
| Il est possible de répondre à partir de la boîte à messages accessible depuis la barre Outlook, la barre d’outils de votre application Desktop ou le menu Fichier de votre application web.
| |
| | |
| {{#images:image74.png|Guide_-_Processus_métiers}}
| |
| | |
| Puis dans le compte de votre messagerie.
| |
| | |
| {{#images:image75.png|Guide_-_Processus_métiers}}
| |
| | |
| L’adresse du destinataire provient du paramètre situé dans les préférences de l’utilisateur (TODO).
| |
| | |
| Consultez l’écran associé au message en cliquant sur le lien du message, le navigateur est ouvert par le logiciel de messagerie. A cet instant l’utilisateur n’a pas de session ouverte sur le Serveur 1000, la page de connexion est donc tout d’abord proposée.
| |
| | |
| {{#images:image76.png|Guide_-_Processus_métiers}}
| |
| | |
| Après avoir renseigné les informations de connexion, l’utilisateur est redirigé sur l’écran.
| |
| | |
| {{#images:image77.png|Guide_-_Processus_métiers}}
| |
| | |
| Répondez maintenant « Répondre à l’email » en cliquant sur le lien ''Réponse NOK''. Comme il s’agit d’un lien, le navigateur est ouvert par le logiciel de messagerie.
| |
| | |
| {{#images:image78.png|Guide_-_Processus_métiers}}
| |
| | |
| L’exécution du service a été réalisée et sa réponse est un fragment XML indiquant que l’évènement a bien été créé. (TODO)
| |
| | |
| Concernant le processus, on constate que l’instance s’est terminée, et il est possible de visualiser le le journal de ce processus.
| |
| | |
| {{#images:image79.png|Guide_-_Processus_métiers}}
| |
| | |
| La réponse reçue est bien NOK.
| |
| | |
| Vous pouvez aussi consulter les deux évènements métiers utilisés par ce processus : le changement d’état initial de l’objet métier et l’évènement créé par la réponse de l’utilisateur.
| |
| | |
| {{#images:image80.png|Guide_-_Processus_métiers}}
| |
| | |
| ===Exemple utilisant une réponse POP3===
| |
| | |
| Ce second exemple est identique au précédent, excepté la réponse de l’utilisateur qui est retrouvée dans sa réponse à l’email. C’est la référence du mail qui fait le lien.
| |
| | |
| L’envoi de l’email a été modifié pour permettre une réponse par messagerie.
| |
| | |
| {{#images:image81.png|Guide_-_Processus_métiers}}
| |
| | |
| Les fragments entre crochet seront substitués à l’exécution ; ils ont été insérés avec la fonction suivante de la barre d’outils.
| |
| | |
| {{#images:image82.png|Guide_-_Processus_métiers}}
| |
| | |
| Pour que la réponse de l’utilisateur soit reconnue, il est important qu’elle contienne la référence de l’email , le reste du texte n’a pas d’importance.
| |
| | |
| Si la réponse contient le fragment correspondant à [mailreponse_ok] la réponse sera considérée comme positive.
| |
| | |
| Pour paramétrer l’attente d’une réponse POP3, il faut paramétrer les informations nécessaires à la connexion sur le serveur de messagerie POP3.
| |
| | |
| {{#images:image83.png|Guide_-_Processus_métiers}}
| |
| | |
| Exemple :
| |
| | |
| {{#images:image84.png|Guide_-_Processus_métiers}}
| |
| | |
| L’email est reçu dans le logiciel de messagerie.
| |
| | |
| {{#images:image85.png|Guide_-_Processus_métiers}}
| |
| | |
| Répondez en acceptant la réponse, pour cela supprimez la clause de refus.
| |
| | |
| {{#images:image86.png|Guide_-_Processus_métiers}}
| |
| | |
| L’envoi de la réponse est détecté par l’instance du processus qui se termine. Vous retrouvez la trace dans le journal.
| |
| | |
| {{#images:image87.png|Guide_-_Processus_métiers}}
| |
| | |
| ===Cas d’utilisation déclenchant un processus par la réception d’un email===
| |
| | |
| Dans cet exemple vous allez réaliser un processus déclenché par la réception d’un email dans une boîte de messagerie. Le processus répond ensuite à l’email puis se termine.
| |
| | |
| {{#images:image88.png|Guide_-_Processus_métiers}}
| |
| | |
| ====Evènement initial====
| |
| | |
| L’évènement initial est la réception d’un email par le protocole POP3. En double-cliquant sur l’activité « Réception d’un Email dans une boîte à lettre », vous la paramétrez avec les informations de connexion du compte POP3.
| |
| | |
| {{#images:image89.png|Guide_-_Processus_métiers}}
| |
| | |
| Le préfixe des paramètres sera utilisé pour copier les informations de l’email déclencheur dans les paramètres de l’instance.
| |
| | |
| ====Activité====
| |
| | |
| L’activité envoyant la réponse est paramétrée dans la boîte de dialogue des propriétés de l’activité « Envoyer un email »..
| |
| | |
| {{#images:image90.png|Guide_-_Processus_métiers}}
| |
| | |
| L’activité utilise les informations copiées lors de la création de l’instance pour :
| |
| | |
| déterminer l’adresse du destinataire : [GetParameter(‘inbox’,’ReplyTo’) ],
| |
| | |
| déterminer l’objet de l’Email : [Get(‘inbox.Subject’) ],
| |
| | |
| déterminer le corps de l’Email : [Get(‘inbox.Content’)].
| |
| | |
| Les deux formes GetParameter et Get sont équivalentes dans cet exemple.
| |
| | |
| Exécutez ce processus en utilisant le logiciel de messagerie d’envoi d’email dans la boîte à lettre utilisée par le processus.
| |
| | |
| {{#images:image91.png|Guide_-_Processus_métiers}}
| |
| | |
| La réception de l’Email a créé une instance, celle-ci a répondu puis s’est terminée. Vous en trouvez la trace dans le journal.
| |
| | |
| {{#images:image92.png|Guide_-_Processus_métiers}}
| |
| | |
| Vous pouvez aussi consulter les paramètres de l’email.
| |
| | |
| {{#images:image93.png|Guide_-_Processus_métiers}}
| |
| | |
| Consultez la boîte à lettre de l’expéditeur pour retrouver la réponse.
| |
| | |
| {{#images:image94.png|Guide_-_Processus_métiers}}
| |
| | |
| ===Cas d’utilisation faisant appel à un formulaire===
| |
|
| |
|
| | *[[Envoi d'un mail avec réponse REST (bp)|Envoi d'un mail avec réponse REST]] |
| | *[[Envoi d'un mail avec réponse POP3 (bp)|Envoi d'un mail avec réponse POP3]] |
| *[[Envoi d'un mail avec formulaire (bp)|Envoi d'un mail avec formulaire]] | | *[[Envoi d'un mail avec formulaire (bp)|Envoi d'un mail avec formulaire]] |
| | *[[Attente de la réception d'un mail (bp)|Attente de la réception d'un mail]] |
|
| |
|
| {{Footer|Processus Métiers (bp)}} | | {{Footer|Processus Métiers (bp)}} |
| [[category:Processus Métiers]] | | [[category:Processus Métiers]] |
