Pour chaque e-mail

UiPath.Mail.Activities.Business.ForEachEMailX

Exécute une ou plusieurs activités pour chaque e-mail ou invitation e-mail d'un dossier Outlook spécifié ou associé à un libellé Gmail spécifié. Cette activité doit être ajoutée dans une activité Use Outlook 365, Use Gmail ou Use Desktop Outlook App.

Utilisez cette activité lorsque vous travaillez avec plusieurs messages et que vous souhaitez répéter une ou plusieurs activités pour chacun des messages :

• Pour l'application de bureau Outlook, indiquez un dossier dont les e-mails doivent être parcourus, ou bien parcourez le dossier ou les e-mails sélectionnés sur Outlook lors de l'exécution du projet.
• Pour Outlook 365, indiquez un dossier dont les e-mails doivent être parcourus.
• Pour Gmail, indiquez un libellé dont les e-mails doivent être parcourus. Vous pouvez sélectionner un libellé personnalisé ou l'un des libellés par défaut suivants : Boîte de réception, Envoyé et Spam.

Ajoutez les activités à répéter dans l'activité For Each Email, puis, lorsque vous configurez les activités, sélectionnez EmailActuel dans le menu Plus afin d'indiquer que vous souhaitez répéter les actions pour chaque message de l'itération. Pour certaines activités, vous devez sélectionner un champ de message spécifique à utiliser dans chaque e-mail : Objet, Corps (corps du message en texte brut), Corps au format HTML (corps du message au format HTML), Date (sous forme textuelle), Cci, Cc, À, De (les champs expéditeur et destinataire renvoient une liste d'adresses e-mail séparées par un point-virgule) ou Priorité (Élevée, Basse, Normale).

Pour apprendre à utiliser cette activité, consultez :

• Tutoriel : parcourir les e-mails Outlook et enregistrer les pièces jointes.
• Tutoriel : enregistrer, renommer et déplacer des pièces jointes.

Configurer l'activité

Dans le corps de l’activité

• For Each : saisir le nom par lequel faire référence à l'e-mail actif de l'itération. L'utilisation d'un nom représentatif du type d'e-mail dans le dossier facilitera l'identification et la sélection de l'option « E-mail actuel » lors de la configuration des activités ajoutées dans l'activité « For Each Email ». Par exemple, pour une sélection d'e-mails contenant des factures, vous pouvez saisir Invoice. La valeur par défaut est CurrentMail.
• Dans les e-mails provenant de : cliquez sur l'icône Plus à droite du champ, puis, dans le menu, sélectionnez le dossier ou le libellé que vous souhaitez utiliser, ou bien, lors de l'automatisation de l'application de bureau Outlook, choisissez Messages sélectionnés ou Dossier sélectionné pour utiliser les messages ou le dossier sélectionné dans Outlook au moment de l'exécution du projet. Vous pouvez également sélectionner Ouvrir dans l'éditeur avancé et saisir une expression VB.
• Limiter les e-mails au premier : saisissez ou sélectionnez une limite pour le nombre maximum d'e-mails à traiter. Définissez une limite inférieure si vous souhaitez réduire les délais de traitement. La valeur par défaut est 100 e-mails.
• E-mails non lus : sélectionnez cette option si vous souhaitez traiter uniquement les e-mails non lus. Cette option est désactivée par défaut.
• Récupérer les pièces jointes : sélectionnez cette option si vous souhaitez récupérer les pièces jointes avec les e-mails.
• Avec pièces jointes uniquement : sélectionnez cette option si vous souhaitez traiter uniquement les e-mails contenant des pièces jointes. Cette option est désactivée par défaut.
• Inclure les sous-dossiers (Include subfolders) - Sélectionnez cette option si vous souhaitez étendre l'itération pour inclure tous les sous-dossiers du dossier de courrier sélectionné. Cette option est désactivée par défaut.

• Filtres supplémentaires : cliquez sur ce bouton pour configurer un filtre avancé pour les e-mails à traiter.

  Dans la fenêtre Filtre :

  • Dans le premier menu déroulant, sélectionnez un champ d'e-mail par lequel filtrer : Cci, Corps, Cc, Date, De, À, Objet ou Catégories.

  • Dans le deuxième menu déroulant, sélectionnez un opérateur afin d'évaluer le champ « e-mail » :

    • Pour tous les champs à l'exception de Date et Catégories : contient, ne contient pas, se termine par, commence par, est égal à, est vide ou n'est pas vide.
    • Pour le champ Date : plus ancien que, plus récent que, ou égal à la période indiquée dans le troisième champ.
    • Pour le champ Catégories : contient, ne contient pas.

  • Cliquez sur l'icône Plus à droite du troisième champ, puis utilisez l'une des options du menu pour indiquer la valeur par rapport à laquelle évaluer le champ d'e-mail sélectionné :

    • Données du Bloc-notes du projet, d'un fichier Excel parent ou d'un compte de messagerie. Par exemple, indiquez un champ de l'email sélectionné dans Outlook lors de l'exécution du projet.
    • Utiliser la valeur enregistrée (Use Saved Value) - sélectionnez un nom que vous avez précédemment enregistré pour une utilisation ultérieure dans le projet.
    • Texte (Text) - Saisissez du texte dans le générateur de texte.
    • Demander quand exécuté : permet de demander une valeur lorsque le projet est exécuté.
    • Coller à partir du Presse-papiers : permet de coller une valeur que vous avez précédemment copiée dans le presse-papiers du projet.
    • Ouvrir dans l'éditeur avancé : utilisé pour saisir une expression VB.

  • Cliquez sur Ajouter si vous souhaitez ajouter d'autres conditions, puis déterminer si toutes ou certaines conditions doivent être utilisées pour filtrer.

    Important :

    Lorsqu'ils sont utilisés avec l'activité Use Outlook 365 sur des projets .NET 5, certains filtres ne sont pas pris en charge.

    Tous les filtres appliqués aux champs Corps, À, Cc et Cci ne sont pas pris en charge. Reportez-vous au tableau ci-dessous pour une liste plus détaillée des filtres non pris en charge.

Filtres non pris en charge

Champ	Filtrer (Filter)
Subject	Ne contient pas
Subject	Se termine par
Subject	N'est pas vide
Subject	Est vide
De (From)	Se termine par
De (From)	Est égal à
De (From)	N'est pas vide
De (From)	Est vide

Panneau propriétés

Commun

• NomComplet : le nom affiché pour l'activité dans le panneau Concepteur.

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Options

• Voir les options dans le corps de l'activité.

  Remarque :Lors de l'automatisation de l'application de bureau Outlook, l'activité traite uniquement les e-mails stockés localement dans le fichier de données Outlook. Pour savoir comment procéder si certains de vos e-mails ne sont pas traités, consultez Dépannage Outlook dans le Guide de StudioX.