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 - Specifies the lowest version of the Exchange server that is used. The options displayed in this field range from 2007 to the 2013 version. Please note that the version number indicates the lowest level of service you support. This means that if you have a 2016 exchange server, you can select the Exchange2013 option.
• 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 ne prend en charge que les chaînes et les variables String.
• TypeAuthentification : les options d'authentification pour Office 365. Les options disponibles sont :
  • UserNameAndPassword - Standard Username and Password Login.
    Important :

    La propriété IDApplication est requise lors de la sélection de l’authentification NomUtilisateurEtMotDePasse . Cela garantit que l'authentification ROPC est utilisée à la place de l'authentification de base, qui est obsolète dans Exchange Online.

  • Interactive - Interactive Token (Auth 2.0).
  • Windows Integrated - Integrated Windows Authentication.
• IDRépertoire : l'ID de votre répertoire Azure Active Directory. Ce champ ne prend en charge que les chaînes et les variables String.

Options

• FilterByMessagesIds - Returns only those mail messages with the specified message IDs. If set, then the FilterExpression parameter is ignored. This field supports only String[] variables.
  Remarque :

  Filtering by message IDs is supported starting with Exchange Server 2013.

• FilterExpression - Returns only those mail messages matching the filter expression.
  Remarque :

  The filter expression can be used starting with 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 :

  For Exchange Server 2007 SP1, the activity returns all attachments, including inline attachments. This is a limitation of the Exchange API.

• 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.
• OrderByDate - Order mail messages by date. Choose one of two options: Newest First, Oldest First. The default value is Newest First.
• 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 . La propriété utilise par défaut la valeur 200 lorsque vous ne la spécifiez pas.

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 :

  • To retrieve emails from a public folder, the value of the MailFolder field should be exactly as the name of the public folder that is displayed in Favorites.
  • 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 Posts. S'il y a des éléments Posts dans le dossier public, l'activité échouera, sauf si vous spécifiez une expression de filtre appropriée, par exemple, ExpressionFiltre = “kind:emails”.
• BoîteLettresPartagée : la boîte aux lettres du compte partagé Exchange liée à l’utilisateur Exchange, s’il est souhaitable de récupérer les messages électroniques qu’elle contient. Si vous spécifiez la boîte aux lettres partagée qui inclut le compte utilisé pour l’authentification dans l’activité, seuls les e-mails du dossier Courrier appartenant à la boîte aux lettres partagée sont récupérés. Si la boîte aux lettres partagée n’est pas spécifiée, seuls les e-mails du compte utilisé pour l’authentification sont récupérés.

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 dont l’objet contient « Bienvenue » et qui proviennent de «[e-mail]»	« subject:geting 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 attachments:.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 section Effectuer une recherche AQS en utilisant EWS dans Exchange.