Activité Obtenir courrier électronique

L'activité Obtenir courrier électronique est une activité de démarrage. Lorsque vous déployez une orchestration commençant par l'activité Obtenir courrier électronique sur le dispositif d'intégration, ce dernier interroge le serveur POP3 en quête de courriers électroniques pour le compte spécifié, suivant l'intervalle indiqué.

Remarque : L'activité Obtenir courrier électronique requiert le serveur POP3 pour la prise en charge des commandes TOP et UIDL. Alors qu'elles sont en option dans le protocole POP3, la plupart des serveurs les prennent en charge.

Le serveur POP3 interrogé et le compte de messagerie électronique sont définis dans le noeud final de courrier électronique, associé à l'activité Obtenir courrier électronique.

Pendant l'exécution, l'activité Obtenir courrier électronique interroge un serveur POP3 à la recherche de courriers électroniques entrants, provenant d'un compte de messagerie électronique particulier, comme indiqué dans le diagramme suivant.

Figure 1.

Si des messages électroniques sont trouvés, l'action suivante a lieu pour chacun d'eux : l'expression régulière définie pour la zone Objet est comparée avec l'objet du courrier entrant et l'expression régulière définie pour la zone De est comparée au compte de messagerie de l'expéditeur du courrier entrant. Si les deux expressions régulières concordent, un travail d'orchestration est créé pour traiter le courrier électronique et ce dernier est marqué pour suppression sur le serveur POP3. Une fois le processus terminé, le courrier est supprimé du serveur POP3. Pour plus d'informations sur la concordance d'expressions régulières, voir Configuration de l'activité.
Remarque : Deux activités Obtenir courrier électronique ne doivent pas effectuer d'interrogation à partir du même serveur POP3, simultanément, en utilisant le même compte de messagerie électronique, même si les expressions régulières spécifiées dans la tâche Configurer de l'activité sont différentes. Si deux activités Obtenir courrier électronique tentent d'obtenir un courrier électronique en utilisant le même compte de messagerie électronique, lorsque la première activité Obtenir courrier électronique traite le courrier électronique depuis le serveur POP3 et supprime ce courrier du serveur, la seconde activité Obtenir courrier électronique poursuit les tentatives d'extraction du courrier électronique sur le serveur POP3 et l'exception suivante peut être renvoyée :
Protocol exception: com.jscape.inet.pop.PopException: Error in TOP 671 0: -ERR The requested message is no longer available; it may have been deleted.

Accès à une pièce jointe de courrier électronique

Pour accéder à la pièce jointe d'un courrier électronique entrant, vous devez ajouter une activité Lire MIME dans l'orchestration après l'activité Obtenir courrier électronique, comme indiqué dans la figure précédente. En outre, vous devez mapper les deux paramètres de sortie de l'activité Obtenir courrier électronique à des variables dans l'orchestration, puis mapper ces variables aux paramètres d'entrée de l'activité Lire MIME. A l'exécution, l'activité Lire MIME lit l'en-tête MIME et le corps du message, puis détache les pièces jointes contenues dans le corps du message et place le résultat dans le paramètre de sortie XML des parties. Pour plus d'informations, voir l'activité Lire MIME.

Ajout d'une activité Obtenir courrier électronique à l'orchestration

  1. Créez ou ouvrez une orchestration. Une représentation graphique de l'orchestration s'affiche.
  2. Sélectionnez l'onglet Activités et développez le dossier Courrier électronique.
  3. Déplacez l'activité Obtenir courrier électronique sur l'orchestration.
  4. Sélectionnez l'activité. La Liste de contrôle est affichée.

Création, sélection ou édition d'un noeud final de messagerie électronique

  1. Cliquez sur la tâche Sélectionner le noeud final dans la liste de contrôle et sélectionnez l'une des actions suivantes :
    • Sélectionnez un noeud final existant :
      1. Sélectionnez Parcourir. L'explorateur de projets apparaît.
      2. Sélectionnez un noeud final existant et cliquez sur OK. Effectuez les étapes Configuration de l'activité.
    • Sélectionnez un noeud final existant et éditez le noeud final :
      1. Sélectionnez Parcourir. L'explorateur de projets apparaît.
      2. Sélectionnez un noeud final existant et cliquez sur OK.
      3. Cliquez sur Editer. Le panneau Editer un noeud final apparaît.
    • Créez un noeud final : sélectionnez Nouveau. Le panneau Créer un noeud final apparaît.
  2. Créez ou éditez un noeud final de courrier électronique. Pour plus d'informations, voir Création ou édition d'un noeud final de messagerie électronique.

Configuration de l'activité

  1. Sélectionnez la tâche Configurer dans la Liste de contrôle. Le panneau Configurer apparaît.
  2. Configurez toutes les zones de ce panneau comme décrit dans le tableau suivant. Dans cette tâche, vous spécifiez les expressions régulières utilisées pour correspondre aux zones Objet et De des courriers électroniques interrogés. Vous devez spécifier une expression régulière pour chacune de ces deux zones même si l'expression régulière est égale à *, ce qui signifie que toutes les chaînes concordent. Pour qu'un message entrant soit traité, les deux chaînes Objet et De du courrier électronique doivent correspondre à leurs expressions régulières respectives. Dans chaque zone d'expression régulière, les caractères génériques suivants sont pris en charge :
    • * (astérisque) - pour zéro ou plusieurs caractères
    • ? (point d'interrogation) - pour zéro ou un caractère
    Tableau 1.
    Zone Description
    Correspondances d'objet Entrez une expression régulière qui correspond aux objets des courriers électroniques qui commencent un travail d'orchestration pour traiter le courrier électronique. Dans l'expression régulière, vous pouvez spécifier une combinaison de caractères et de caractères génériques.
    Correspondances De   Entrez une expression régulière qui définit l'adresse électronique de l'expéditeur des courriers électroniques qui commencent un travail d'orchestration pour traiter le courrier électronique. Dans l'expression régulière, vous pouvez spécifier une combinaison de caractères et de caractères génériques.
    Le tableau suivant montre des exemples d'expression régulière et le résultat de la correspondance des expressions régulières avec des échantillons de texte.
    Tableau 2.
    Expression régulière Echantillon de texte Résultat
    *test* test correspond
    *test* ttttesttt correspond
    test test correspond
    test ttttesttt ne correspond pas, doit correspondre exactement à la chaîne d'expression régulière : test
    test est ne correspond pas, doit correspondre exactement à la chaîne d'expression régulière : test
    ?est test correspond
    ?est best correspond
    ?est est correspond

Spécification des règles de distribution

  1. Sélectionnez la tâche Règles de distribution dans la Liste de contrôle. Le panneau Règles de distribution apparaît.
  2. Spécifiez l'intervalle d'interrogation du serveur POP3 à la recherche de nouveaux courriers électroniques :
    1. Sélectionnez une unité de temps dans le menu : secondes, minutes, heures ou jours.
    2. Spécifiez la durée à l'aide de l'une des options d'entrée suivantes :
      • En cliquant dans la zone Interroger les modifications toutes les et en entrant une nouvelle valeur.
      • A l'aide des flèches vers le haut et vers le bas.
Pour plus d'informations, voir Comportement de l'intervalle d'interrogation.

Spécification des options de nouvelle tentative

  1. Sélectionnez la tâche Réessayer dans la Liste de contrôle. Le panneau Réessayer apparaît.
  2. Configurez les options de tentative pour la connexion à un serveur POP3. Le tableau suivant définit les options de tentative pour une connexion à un serveur POP3 :
    Tableau 3.
    Zone Description
    Réessayer  
    1) Attendre __ seconde(s) entre chaque tentative. Indique le nombre de secondes pendant lesquelles le dispositif d'intégration attend avant de tenter d'établir une connexion avec le serveur POP3.
    2) Tenter de se connecter __ fois avant l'échec. Indique le nombre de tentatives - nombre maximum de fois que le dispositif d'intégration tente d'établir une connexion avec le serveur POP3 avant d'émettre une erreur.

    Si vous déployez une orchestration qui commence par une activité Obtenir courrier électronique et que le dispositif d'intégration ne peut pas se connecter au serveur POP3 spécifié, le dispositif d'intégration consigne les erreurs de connexion en tant qu'avertissements dans le journal système jusqu'à ce que la valeur du nombre de tentatives soit atteinte. Lorsque le nombre de tentatives est atteint, le dispositif d'intégration consigne une erreur dans le journal système, remet le nombre d'erreurs de connexion à zéro et poursuit les tentatives d'établissement d'une connexion au serveur POP3.

    Par exemple, si vous définissez le nombre de tentatives à 3, les erreurs de première, seconde et troisième connexions apparaissent dans le journal système en tant qu'avertissements. Le dispositif d'intégration consigne la quatrième erreur de connexion en tant qu'erreur et remet à zéro le nombre d'erreurs de connexion. Par conséquent, la cinquième erreur de connexion génère un avertissement dans le journal système. Le dispositif d'intégration continue de tenter l'établissement d'une connexion avec le serveur POP3.

Mappage de la sortie de l'activité

  1. Sélectionnez la tâche Mapper les sorties dans la Liste de contrôle. Les paramètres de sortie de l'activité sont affichés dans le panneau Depuis l'activité.
  2. Dans cette tâche, vous mappez les paramètres de sortie mailheader (de type XML) et body (de type chaîne) sur des variables. Vous devez mapper les paramètres de sortie de l'activité afin que l'orchestration soit valide. Voir Création d'une mappe pour des instructions générales sur le mappage. Le paramètre de sortie mailheader contient des méta-informations sur le courrier électronique, par exemple, les adresses électroniques auxquelles est envoyé le message et l'en-tête MIME du message-même. Le paramètre de sortie body contient le corps du courrier électronique et les pièces jointes associées.
    ATTENTION :
    L'ordre des pièces jointes et du corps dans la sortie du corps dépend du client de message électronique qui a envoyé le message et du type de message (texte en clair ou HTML.).
Remarque : Lorsque vous utilisez une charge non anglaise, mailheader, mimeHeader et otherheaders doivent être mappés vers l'orchestration de l'activité getEmail et mappés depuis l'orchestration de nouveau vers l'activité sendMail.



Commentaires | Notices


Icône d'horodatage Dernière révision: Friday, November 1, 2013


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.doc/email_get_activity.html