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é.
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.

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
- Créez ou ouvrez une orchestration. Une représentation graphique de l'orchestration s'affiche.
- Sélectionnez l'onglet Activités et développez le dossier Courrier électronique.
- Déplacez l'activité Obtenir courrier électronique sur l'orchestration.
- 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
- 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 :
- Sélectionnez Parcourir. L'explorateur de projets apparaît.
- 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 :
- Sélectionnez Parcourir. L'explorateur de projets apparaît.
- Sélectionnez un noeud final existant et cliquez sur OK.
- 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.
- Sélectionnez un noeud final existant :
- 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é
- Sélectionnez la tâche Configurer dans la Liste de contrôle. Le panneau Configurer apparaît.
- 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
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 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. 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
- Sélectionnez la tâche Règles de distribution dans la Liste de contrôle. Le panneau Règles de distribution apparaît.
- Spécifiez l'intervalle d'interrogation du serveur POP3 à la recherche de nouveaux courriers électroniques :
- Sélectionnez une unité de temps dans le menu : secondes, minutes, heures ou jours.
- 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.
Spécification des options de nouvelle tentative
- Sélectionnez la tâche Réessayer dans la Liste de contrôle. Le panneau Réessayer apparaît.
- Configurez les options de nouvelle tentative pour la connexion à un serveur POP3. Le tableau suivant définit les options de nouvelle 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é
- 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é.
- 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.).