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 (Mailbox) abzurufen.

Nach der Suche gibt die Aktivität ein Array der übereinstimmenden Office365Message -Objekte (Results) zurück, das Sie als Eingabevariablen in nachfolgenden Aktivitäten 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. Dazu kann jedes freigegebene Postfach gehören, für das der aktuelle Benutzer Zugriffsrechte hat. Wenn dieses Feld leer bleibt, wird das Konto des aktuellen Benutzers verwendet. Diese Eigenschaft unterstützt String -Variablen und zeichenfolgenformatierte Werte.
  Hinweis: Das Kontofeld ist für die Authentifizierungstypen ApplicationIdAndSecret und ApplicationIdAndCertificate obligatorisch.
• E-Mail-Ordner – Der E-Mail-Ordner, aus dem die Nachrichten abgerufen werden. Geben Sie Ihren Ordner so ein, wie er in Ihrer Outlook-Anwendung angezeigt wird (z. B. „Posteingang“, „Gesendete Objekte“, „Gelöschte Objekte“usw.). Unterordner verwenden das Format „ParentFolder/SubFolder/AnotherSubfolder“. Diese Eigenschaft unterstützt String -Variablen und zeichenfolgenformatierte 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-Mail-ID – Die ID der E-Mail, nach der gesucht werden soll. Wenn angegeben, werden die Parameter Account, Get As HTMLund Als gelesen markieren berücksichtigt, während die Parameter Only Unread Messages, Order By Date, Queryund Top ignoriert werden. Wenn die E-Mail mit der angegebenen ID gefunden wird, enthält das Ausgabearray genau ein Element. Wenn sie nicht gefunden wird, löst die Aktivität eine Ausnahme aus. Diese Eigenschaft unterstützt String -Variablen und zeichenfolgenformatierte Werte.
• Als HTML abrufen (Get As HTML ) – Wenn diese Option ausgewählt ist, wird der Nachrichtentext im HTML-Format zurückgegeben. Dieses Feld unterstützt boolesche Werte.
• Als gelesen markieren – Wenn diese Option ausgewählt ist, werden die zurückgegebenen Nachrichten als gelesen markiert. Dieses Feld unterstützt boolesche Werte.
• Nur ungelesene Nachrichten – Wenn diese Option ausgewählt ist, werden nur ungelesene Nachrichten zurückgegeben. Dieses Feld unterstützt boolesche Werte. Der Standardwert ist True.
• Nach Datum sortieren – Die zurückgegebenen Nachrichten werden nach Datum sortiert. Die verfügbaren Optionen sind NewestFirst und OldestFirst.
• Abfrage – Abfrage zum Filtern der zurückgegebenen E-Mails. Wenn die Abfrage nicht abgeschlossen ist, werden alle E-Mails zurückgegeben. Geben Sie Ihre String mithilfe des OData-Abfrageparameters $filter ein. Nachfolgend finden Sie einige Beispieleingaben:
  • "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')"
• Oben – Die maximale Anzahl der abzurufenden E-Mails. Dieses Feld unterstützt nur Integer- und Int32 -Variablen. Der Standardwert ist 50 (nicht angezeigt).

Ausgabe

• Ergebnis – Gibt alle E-Mails aus dem Posteingang des Benutzers zurück. Dieses Feld unterstützt nur Office365Message[] Variablen. Erforderlich, wenn Sie die Ausgabedaten in nachfolgenden Aktivitäten verwenden möchten.

  Die Variable, die Sie für diese Eigenschaft erstellen, wird auch in den Aktivitäten Forward Mail und Move Mail verwendet (als Nachrichteneingabe -Eigenschaftswert). Wenn Sie diese Variable als Eingabeeigenschaftswert verwenden, geben Sie das Element im Array an, das Sie verwenden möchten (z. B. foundMessages(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.

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. Fügen Sie die Aktivität Get Mail innerhalb der Aktivität Microsoft Office 365 Scope hinzu.
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 APIs GetMessage und ListMessages gesendet .
   • Die API gibt den Wert Office365Message[] an Ihre Ausgabeeigenschaftsvariable zurück.