Obtenir les messages électroniques Exchange (Get Exchange Mail Messages)

UiPath.Mail.Exchange.Activities.GetExchangeMailMessages

Récupère un message électronique à partir d'Exchange.

Propriétés

Commun

• NomAffichage (DisplayName) - Nom affiché de l'activité.
• TimeoutMS - Spécifie la durée (en millisecondes) d'attente d'exécution de l'activité avant la génération d'un message d'erreur. La valeur par défaut est 30 000 millisecondes (30 secondes).

Paramètres d'échange

• Détection auto d'e-mail (EmailAutodiscover) - Recherche automatiquement un serveur Exchange à l'aide d'une adresse e-mail provenant de ce serveur. Cela ne fonctionne que si Autodiscover est activé sur le serveur Exchange.
• ExchangeVersion : Spécifie la version la plus ancienne du serveur Exchange utilisée. Les options affichées dans ce champ vont de la version 2007 à la version 2013. Veuillez noter que le numéro de version indique le niveau de service le plus bas que vous prenez en charge. Cela signifie que si vous avez un serveur Exchange 2016, vous pouvez sélectionner l'option Exchange2013.
• Serveur (Server) - Serveur de messagerie hôte à utiliser.

Ouverture de session (Logon)

• Domaine (Domain) - Domaine Active Directory auquel se connecter.
• Mot de passe (Password) - Mot de passe du compte Exchange utilisé pour récupérer le message.
• MotDePasseSécurisé (SecurePassword) - Le mot de passe du compte Exchange utilisé, sous forme de chaîne sécurisée.
• Utilisateur (User) - Nom d'utilisateur du compte Exchange utilisé pour récupérer le message.

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

Paramètres d'Office 365

• IDApplication : l'ID de votre application Azure Active Directory. Ce champ prend uniquement en charge les chaînes et les variables String.
• TypeAuthentification : les options d'authentification pour Office 365. Les options disponibles sont :

  • NomUtilisateurEtMotDePasse : Nom d'utilisateur et mot de passe standards pour se connecter.

    Important : la propriété IDApplication est requise lors de la sélection de l’authentification par NomUtilisateurEtMotDePasse . Cela garantit que l'authentification ROPC est utilisée au lieu de l'authentification de base, qui est obsolète dans Exchange en ligne.
  • Interactif : Jeton interactif (Auth 2.0).
  • Intégration Windows : Authentification Windows intégrée.
• IDRépertoire : l'ID de votre répertoire Azure Active Directory. Ce champ prend uniquement en charge les chaînes et les variables String.

Options

• FilterByMessagesIds : Renvoie uniquement les e-mails avec les ID de message spécifiés. Si cet élément est sélectionné, alors le paramètre ExpressionFiltre sera ignoré. Ce champ prend uniquement en charge les variables String[].
  Remarque : le filtrage par ID de message est pris en charge à partir d' Exchange Server 2013.
• FilterExpression : renvoie uniquement les e-mails correspondant à l'expression du filtre.
  Remarque : l'expression de filtre peut être utilisée à partir d' Exchange Server 2010.
• Obtenir les pièces jointes (GetAttachments) - Indique si les pièces jointes doivent être récupérées dans le message électronique. Par défaut, cette case à cocher est désactivée.
  Remarque : pour Exchange Server 2007 SP1, l'activité renvoie toutes les pièces jointes, y compris les pièces jointes intégrées. Il s'agit d'une limitation de l'API Exchange.
• Corps HTML (IsBodyHtml) - Spécifie si le corps du message est écrit au format HTML.
• Marquer comme lu (MarkAsRead) - Spécifie s'il faut marquer les messages récupérés comme lus. Par défaut, cette case à cocher n'est pas cochée.
• Messages non lus uniquement (OnlyUnreadMessages) - Spécifie s'il faut récupérer uniquement les messages non lus. Par défaut, cette case est cochée.
• DateCommande (OrderByDate) : permet de trier les e-mails par date. Choisissez l'une des deux options : Le plus récent d'abord, Le plus ancien d'abord. La valeur par défaut est Le plus récent en premier.
• Top : Le nombre de messages à récupérer, en commençant soit du plus récent, soit du plus ancien, selon le paramètre choisi dans TrierParDate.

Sortie

• Messages (Messages) - Messages récupérés en tant que collection d'objets MailMessage.
  Remarque : à partir de la version 1.10.4 de UiPath.Mail.Activities, l'objet MailMessage expose :

  • ID de message (Message-ID) d’un e-mail, par exemple MailMessage.Headers("Message-ID").
  • Les catégories associées à un message électronique, par exemple MailMessage.GetCategories().

Cible

• Dossier courriels (MailFolder) - Dossier de messagerie à partir duquel les messages doivent être récupérés.
  Important :

  • Pour récupérer des e-mails à partir d'un dossier public, la valeur du champ DossierMail (MailFolder ) doit correspondre exactement au nom du dossier public affiché dans les Favoris.
  • Lors de l'utilisation d'un dossier public, s'il existe un dossier personnel dans la boîte aux lettres avec le même nom, l'activité renvoie les e-mails du dossier personnel. Afin de renvoyer les e-mails du dossier public, le dossier personnel doit être renommé.
  • L’activité ne prend pas en charge les éléments Publications. S'il y a des éléments Publications dans le dossier public, l'activité échouera, sauf si vous spécifiez une expression de filtre appropriée, par exemple, FilterExpression = « kind:emails ».
• Messagerie partagée (SharedMailbox)- Active la récupération des messages d'une boîte aux lettres partagée liée à un compte d'utilisateur Exchange.

Exemples de filtrage

Le tableau suivant montre des exemples de filtres qui peuvent être utiles lorsque vous interrogez des messages électroniques Exchange :

Requête	ExpressionFiltre
Tous les e-mails dont l’objet contient « Welcome (Bienvenue) »)	"subject:welcome"
Tous les e-mails contenant « Welcome (Bienvenue) » dans l’objet et provenant de « [e-mail] »	"subject:welcome AND from:""[e-mail]"""
Tous les e-mails d'un compte de messagerie d'exemple.com	"from:example.com"
Tous les e-mails dont le corps contient « Please review »	"body:please review"
Tous les e-mails avec pièces jointes	"hasattachment:true"
Tous les e-mails de haute importance auxquels est joint un fichier pdf	"importance:high AND attachment:.pdf"
Tous les e-mails dont les catégories sont la « Catégorie rouge » et la « Catégorie bleue »	"category:Red category, Blue category"
Tous les messages électroniques de type réunion (par ex. invitations de calendrier, réponses)	"kind:meetings"
Tous les e-mails reçus aujourd’hui	"received:today"
Tous les e-mails reçus le 23/10/2020	"received:10/23/2020"
Tous les e-mails reçus depuis le 23/10/2020	"received: >=10/23/2020"

Remarque : pour en savoir plus sur la spécification d'une expression de filtre, consultez la page Effectuer une recherche AQS en utilisant EWS dans Exchange.