Get Mail

UiPath.MicrosoftOffice365.Activities.Mail.GetMail

Description

Utilise les API Microsoft Graph Get message et List messages pour récupérer les messages correspondants d’une boîte aux lettres spécifiée (Mailbox).

Après avoir effectué la recherche, l'activité renvoie un tableau des objets Office365Message correspondants (Results) que vous pouvez utiliser comme variables d'entrée dans des activités ultérieures (par exemple, Forward Mail et Move Mail).

Étendues

Cette activité nécessite les étendues suivantes :

• Mail.Read AND User.Read

OU

• Mail.ReadWrite AND User.Read

OU

• Mail.Read.Shared AND User.Read

OU

• Mail.ReadWrite.Shared AND User.Read

OU

• Mail.Read AND User.ReadWrite

OU

• Mail.ReadWrite AND User.ReadWrite

OU

• Mail.Read.Shared AND User.ReadWrite

OU

• Mail.ReadWrite.Shared AND User.ReadWrite

Compatibilité du projet

Windows - Héritage | Windows

Configuration

Propriétés

Commun

• NomAffichage (DisplayName) : nom affiché de l'activité. Cette propriété prend en charge les variables de chaîne String et les valeurs au format chaîne.

Entrée

• Compte (Compte) - (Facultatif) L'adresse e-mail avec laquelle interagir. Cela peut inclure n'importe quelle boîte aux lettres partagée à laquelle l'utilisateur actuel a des droits d'accès. Si ce champ est laissé vide, le compte de l'utilisateur actuel est utilisé. Cette propriété prend en charge les variables String et les valeurs au format chaîne.
  Remarque : Le champCompte est obligatoire pour les types d'authentification ApplicationIdAndSecret et ApplicationIdAndCertificate .
• Dossier de messagerie : le dossier de messagerie à partir duquel les messages sont récupérés. Saisissez votre dossier tel qu'il apparaît dans votre application Outlook (par exemple, « Boîte de réception », « Éléments envoyés », « Éléments supprimés », etc.). Les sous-dossiers utilisent le format « ParentFolder/SubFolder/AnotherSubfolder ». Cette propriété prend en charge les variables String et les valeurs au format chaîne.

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). Ce champ prend en charge les valeurs booléennes.

Options

• ID de l'e-mail (Email ID ) : l'ID de l'e-mail à rechercher. Lorsqu'ils sont spécifiés, les paramètres Account, Get As HTMLet Mark As Read sont pris en compte, tandis que les paramètres Only Unread Messages, Order By Date, Queryet Top sont ignorés. Si l'e-mail avec l'ID spécifié est trouvé, le tableau de sortie contient exactement un élément. Si elle est introuvable, l'activité lève une exception. Cette propriété prend en charge les variables String et les valeurs au format chaîne.
• Obtenir en tant que HTML : si cette option est sélectionnée, le corps du message est renvoyé au format HTML. Ce champ prend en charge les valeurs booléennes.
• Marquer comme lu (Mark As Read ) : si cette option est sélectionnée, les messages renvoyés sont marqués comme lus. Ce champ prend en charge les valeurs booléennes.
• Messages non lus uniquement (Only Unread Messages ) : si cette option est sélectionnée, seuls les messages non lus sont renvoyés. Ce champ prend en charge les valeurs booléennes. La valeur par défaut est True.
• Trier par date : les messages renvoyés sont triés par date. Les options disponibles sont Le plus récent d'abord et le plus ancien d'abord.
• Requête : requête utilisée pour filtrer les e-mails renvoyés. Si la requête n'est pas terminée, tous les e-mails sont renvoyés. Saisissez votre String à l'aide du $filter paramètre de requête OData. Voici quelques exemples d’entrées :
  • "from/emailAddress/address eq '[e-mail]'"
  • "subject eq 'Office365 Quickstart'"
  • "subject eq 'Office365 Quickstart' and from/emailAddress/address eq '[e-mail]'"
  • "categories/any(a:a eq 'Red category')"
• Haut (Top ) - Le nombre maximum d'e-mails à récupérer. Ce champ prend uniquement en charge les variables entières et Int32 . La valeur par défaut est 50 (non affichée).

Sortie

• Résultat - Renvoie tous les e-mails de la boîte de réception de l'utilisateur. Ce champ prend uniquement en charge les variables Office365Message[]. Obligatoire si vous prévoyez d'utiliser les données de sortie dans des activités ultérieures.

  La variable que vous créez pour cette propriété est également utilisée dans les activités Transférer le courrier ( Forward Mail ) et Déplacer le courrier ( Move Mail ) (en tant que valeur de la propriété d'entrée Message ). Lorsque vous utilisez cette variable comme valeur de propriété d'entrée, spécifiez l'élément du tableau que vous souhaitez utiliser (p. ex., foundMessages(0)).

  Le Office365Messageobject inclut plusieurs propriétés que vous pouvez utiliser dans d'autres activités.
  La propriété Body.Content est renvoyée au format HTML uniquement.

Mode de fonctionnement

Les étapes et le diagramme de séquence de messages suivants illustrent le fonctionnement de l'activité, depuis la conception (c'est-à-dire les dépendances d'activité et les propriétés d'entrée/sortie) jusqu'à l'exécution.

1. Effectuez les étapes.
2. Ajoutez l’activité Étendue Microsoft Office 365 à votre projet.
3. Ajoutez l’activité Get Mail à l’intérieur de l’activité Étendue Microsoft Office 365.
4. Entrez des valeurs pour les propriétés d'entrée.
5. Créez et entrez une variable Office365Message[] pour votre propriété Output (Sortie).

6. Exécutez l’activité.

   • Vos valeurs de propriété d'entrée sont envoyées aux API GetMessage et ListMessages .
   • L'API renvoie la valeur Office365Message[] à votre variable de propriété de sortie.