Get Mail

UiPath.MicrosoftOffice365.Activities.Mail.GetMail

Beschreibung

Verwendet die Microsoft Graph Get message- und List messages- APIs, um die übereinstimmenden Nachrichten aus einem angegebenen Postfach (Postfach) abzurufen.

Nach der Suche gibt die Aktivität ein Array der übereinstimmenden Office365Message -Objekte zurück (Ergebnisse), die Sie in nachfolgenden Aktivitäten als Eingabevariablen verwenden können (z. B. Forward Mail und Move Mail).

Scopes

Diese Aktivität erfordert die folgenden Scopes:

• Mail.Read AND User.Read

ODER

• Mail.ReadWrite AND User.Read

ODER

• Mail.Read.Shared AND User.Read

ODER

• Mail.ReadWrite.Shared AND User.Read

ODER

• Mail.Read AND User.ReadWrite

ODER

• Mail.ReadWrite AND User.ReadWrite

ODER

• Mail.Read.Shared AND User.ReadWrite

ODER

• Mail.ReadWrite.Shared AND User.ReadWrite

Projektkompatibilität

Windows – Legacy | Windows

Konfiguration

Eigenschaften

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.

Eingabe

• Konto – (Optional) Die E-Mail-Adresse, mit der interagiert werden soll. Dies kann ein gemeinsam verwendetes Postfach beinhalten, für das der aktuelle Benutzer Zugriffsrechte hat. Wenn leer gelassen, wird das Konto des aktuellen Benutzers angenommen. Diese Eigenschaft unterstützt String -Variablen und stringformatierte Werte.

  Hinweis:

  Account field is mandatory for ApplicationIdAndSecret and ApplicationIdAndCertificate authentication types.

• E-Mail-Ordner – Der E-Mail-Ordner, aus dem die Nachrichten abgerufen werden. Geben Sie Ihren Ordner ein, so wie er in Ihrer Outlook-Anwendung angezeigt wird (z. B. „Posteingang“, „Gesendete Elemente“, „Gelöschte Elemente“ usw.). Unterordner verwenden das Format „ÜbergeordneterOrdner/Unterordner/AnandererUnterordner“. Diese Eigenschaft unterstützt String -Variablen und stringformatierte Werte.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert. Dieses Feld unterstützt nur boolesche Werte.

Optionen

• E-MailID – Die ID der E-Mail, nach der gesucht werden soll. Wenn angegeben, werden die Parameter Account, Get As HTML und Mark As Read berücksichtigt, während Only Unread Messages, Order By Date, Query und Top ignoriert werden. Wenn die E-Mail mit der angegebenen ID gefunden wird, enthält das Ausgabe-Array genau ein Element. Wenn sie nicht gefunden wird, löst die Aktivität eine Ausnahme aus. Diese Eigenschaft unterstützt String -Variablen und stringformatierte Werte.

• Als HTML abrufen – Wenn diese Option ausgewählt ist, wird der Nachrichtentext im HTML-Format zurückgegeben. Dieses Feld unterstützt nur boolesche Werte.

• Als gelesen markieren – Bei Auswahl werden die zurückgegebenen Nachrichten als gelesen markiert. Dieses Feld unterstützt nur boolesche Werte.

• Nur ungelesene Nachrichten – Wenn diese Option ausgewählt ist, werden nur ungelesene Nachrichten zurückgegeben. Dieses Feld unterstützt nur boolesche Werte. Der Standardwert ist True.

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

• Abfrage – Abfrage, die zum Filtern der zurückgegebenen E-Mails verwendet wird. Wenn die Abfrage nicht abgeschlossen wird, werden alle E-Mails zurückgegeben. Geben Sie Ihre String mithilfe des OData-Abfrageparameters $filter ein . Im Folgenden finden Sie einige Beispieleingaben:

  • „from/emailAddress/address eq '[e-mail] '“
  • "subject eq 'Office365 Quickstart'"
  • „subject eq 'Office365 Quickstart' und from/emailAddress/address eq '[e-mail] '"
  • "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).

Ausgabe

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

Die Variable, die Sie für diese Eigenschaft erstellen, wird auch in den Aktivitäten Forward Mail und Move Mail verwendet (als Eigenschaftswert der Eingabe von Nachricht ). Wenn Sie diese Variable als Eingabeeigenschaftswert verwenden, geben Sie das Element im Array an, das Sie verwenden möchten (z. B. GefundeneNachrichten(0)).

Office365Messageobject enthält mehrere Eigenschaften , die Sie in anderen Aktivitäten verwenden können.

Die Eigenschaft Body.Content wird nur im HTML-Format zurückgegeben.

Wichtig:

Eine bekannte Einschränkung besteht darin, dass die Aktivität das Abrufen von Anhängen aus digital signierten E-Mails nicht unterstützt und sie daher nicht speichern können.

Wie es funktioniert

Die folgenden Schritte und das folgende Nachrichtensequenzdiagramm sind ein Beispiel dafür, wie die Aktivität von der Entwurfszeit (d. h. den Aktivitätsabhängigkeiten und Eingabe-/Ausgabeeigenschaften) bis zur Laufzeit funktioniert.

1. Führen Sie die Schritte aus.
2. Fügen Sie die Aktivität Microsoft Office 365 Scope zu Ihrem Projekt hinzu.
3. Add the Get Mail activity inside the Microsoft Office 365 Scope activity.
4. Geben Sie Werte für die Eingabeeigenschaften ein.
5. Erstellen Sie eine Office365Message[] -Variable für Ihre Output-Eigenschaft, und geben Sie sie ein.
6. Führen Sie die Aktivität aus.
   • Ihre Eingabeeigenschaftswerte werden an die GetMessage- und ListMessages -APIs gesendet.
   • Die API gibt den Wert Office365Message[] an Ihre Ausgabeeigenschaftsvariable zurück.