Get Mail

UiPath.MicrosoftOffice365.Activities.Mail.GetMail

Beschreibung

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

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

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, die zum Filtern der zurückgegebenen E-Mails verwendet wird. Wenn die Abfrage nicht abgeschlossen wird, werden alle E-Mails zurückgegeben. Geben Sie Ihren String mit dem OData-Abfrageparameter $filter ein. Im Folgenden 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. Schließen Sie die Einrichtungsschritte ab.
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.