Get Mail

UiPath.MicrosoftOffice365.Activities.Mail.GetMail

Description

Utilise les API Obtenir le message Microsoft Graph et Lister les messages pour récupérer les messages correspondants d'une boîte aux lettres spécifiée.

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 les activités suivantes (par exemple, Transférer un e-mail et Déplacer un e-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 String et les valeurs au format chaîne.

Entrée

• Compte - (Facultatif) L'adresse e-mail avec laquelle interagir. Cela peut inclure toute boîte aux lettres partagée à laquelle l'utilisateur actuel a des droits d'accès. S’il 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 :

  Account field is mandatory for ApplicationIdAndSecret and ApplicationIdAndCertificate authentication types.

• Dossier courriels - 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 - L'ID de l'e-mail à rechercher. Lorsqu'ils sont spécifiés, les paramètres Compte, Obtenir au format HTML et Marquer comme lu sont pris en compte tandis que les paramètres Seuls les messages non lus, Trier par date, Requête, et Top sont ignorés. Si l'e-mail comportant l'ID spécifié est trouvé, le tableau de sortie contiendra exactement un élément. S'il n'est pas trouvé, l'activité générera une exception. Cette propriété prend en charge les variables String et les valeurs au format chaîne.

• Obtenir au format HTML : si cette option est sélectionnée, le corps du message sera renvoyé au format HTML. Ce champ prend en charge les valeurs booléennes.

• Marquer comme lu : si cette option est sélectionnée, les messages renvoyés seront marqués comme lus. Ce champ prend en charge les valeurs booléennes.

• Messages non lus uniquement : 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 Vrai.

• Order By Date - The returned messages are ordered by date. The available options are NewestFirst and OldestFirst.

• Requête : la requête utilisée pour filtrer les e-mails renvoyés. Si la requête n'est pas effectuée, tous les e-mails sont renvoyés. Entrez votre String à l'aide du paramètre de requête OData $filter . Voici quelques exemples d'entrées :

  • «créer
  • "subject eq 'Office365 Quickstart'"
  • « objets eq « Démarrage rapide Office365 » et depuis/adresse e-mail/adresse eq 'quelqu'@company.com ' »
  • "categories/any(a:a eq 'Red category')"

• Top - The maximum number of emails to retrieve. This field supports only integer and Int32 variables. The default value is 50 (not shown).

Sortie

• Result - Returns all emails from the user's inbox. This field supports only Office365Message[] variables. Required if you plan to use the output data in subsequent activities.

La variable que vous créez pour cette propriété est également utilisée dans les activités Transférer un courrier et Déplacer un courrier (comme 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 (par exemple, FindMessages(0)).

Le Office365Messageobject comprend 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.

Important :

Il existe une limitation connue selon laquelle l’activité ne prend pas en charge l’obtention des pièces jointes des e-mails signés numériquement et, par conséquent, ne peut pas les enregistrer.

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. Add the Get Mail activity inside the Microsoft Office 365 Scope activity.
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é.
   • Les valeurs de vos propriétés d'entrée sont envoyées aux API GetMessage et ListMessages .
   • L'API renvoie la valeur Office365Message[] à votre variable de propriété de sortie.