|
|
(5 révisions intermédiaires par un utilisateur sont masqué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]] |