Exchange-Mail-Nachrichten erhalten (Get Exchange Mail Messages)

UiPath.Mail.Exchange.Activities.GetExchangeMailMessages

Extrahiert eine E-Mail-Nachricht aus Exchange.

Eigenschaften

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.
• AuszeitMS (TimeoutMS) - Gibt die Wartezeit (in Millisekunden) bis zur Fehlerausgabe einer laufenden Aktivität an. Der Standardwert ist 30000 Millisekunden (30 Sekunden).

Exchange-Einstellungen

• E-Mail-AutoErmittlung (EmailAutodiscover) - Sucht automatisch nach einem Exchange Server über eine E-Mail-Adresse von diesem Server. Funktioniert nur, wenn der Exchange Server die AutoErmittlung (Autodiscover) aktiviert hat.
• ExchangeVersion (ExchangeVersion) - Gibt die niedrigste Version des Exchange-Servers an, der verwendet wird. Die in diesem Feld angezeigten Optionen reichen von der Version 2007 bis 2013. Beachten Sie, dass die Versionsnummer die niedrigste Serviceebene angibt, die Sie unterstützen. Wenn Sie einen Exchange Server für 2016 haben, können Sie die Option Exchange 2013 auswählen.
• Server (Server) - Der zu verwendende E-Mail-Server-Host.

Anmeldung (Logon)

• Domäne (Domain) - Die Active-Directory-Domain, zu der verbunden werden soll.
• Passwort (Password) - Das Passwort des Exchange-Kontos zum Extrahieren der Nachricht.
• SicheresKennwort – Das Kennwort des verwendeten Exchange-Kontos als sichere Zeichenfolge.
• Benutzer (User) - Der Benutzername des Exchange-Kontos zum Extrahieren der Nachricht.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Office 365-Einstellungen

• AnwendungsID – Die ID Ihrer Azure Active Directory-Anwendung. Dieses Feld unterstützt nur Strings und String-Variablen.
• Authentifizierungstyp – Die Authentifizierungsoptionen für Office 365. Die verfügbaren Optionen sind:

  • BenutzernameUndKennwort – Standardmäßiger Benutzername und Kennwort zur Anmeldung.

    Wichtig: Die Eigenschaft AnwendungsID ist erforderlich, wenn Sie die Authentifizierung mit Benutzername und Kennwort auswählen. Dadurch wird sichergestellt, dass die ROPC-Authentifizierung anstelle der einfachen Authentifizierung verwendet wird, die in Exchange online veraltet ist.
  • Interaktiv – Interaktives Token (Auth 2.0).
  • Windows-integriert – Integrierte Windows-Authentifizierung.
• VerzeichnisID – Die ID Ihres Azure Active Directory. Dieses Feld unterstützt nur Strings und String-Variablen.

Optionen

• FilterByMessagesIds - Gibt nur die E-Mail-Nachrichten mit den angegebenen Nachrichten-IDs zurück. Wenn diese Option festgelegt wird, wird der Parameter Filterausdruck ignoriert. Dieses Feld unterstützt nur String[]-Variablen.
  Hinweis: Das Filtern nach Nachrichten-IDs wird ab Exchange Server 2013unterstützt.
• FilterExpression – Gibt nur die E-Mail-Nachrichten zurück, die dem Filterausdruck entsprechen.
  Hinweis: Der Filterausdruck kann ab Exchange Server 2010verwendet werden.
• AnhängeErhalten (GetAttachments) - Gibt an, ob Anhänge der E-Mail-Nachricht extrahiert werden sollen. Standardmäßig ist dieses Auswahlfeld nicht ausgewählt.
  Hinweis: Für Exchange Server 2007 SP1gibt die Aktivität alle Anhänge zurück, einschließlich Inline-Anhänge. Dies ist eine Einschränkung der Exchange-API.
• IstTextkörperHTML (IsBodyHtml) - Gibt an, ob der Textkörper der Nachricht im HTML-Format geschrieben ist.
• AlsGelesenMarkieren (MarkAsRead) - Gibt an, ob extrahierte Nachrichten als gelesen markiert werden sollen. Standardmäßig ist dieses Auswahlfeld nicht ausgewählt.
• NurUngeleseneNachrichten (OnlyUnreadMessages) - Gibt an, ob nur ungelesene Nachrichten extrahiert werden sollen. Standardmäßig ist dieses Auswahlfeld ausgewählt.
• OrderByDate – Sortiert E-Mail-Nachrichten nach Datum. Wählen Sie eine von zwei Optionen aus: Neueste zuerst, Älteste zuerst. Der Standardwert ist Newest First.
• Top - Die Anzahl abzurufender Nachrichten, beginnend mit der neuesten oder ältesten Nachricht (abhängig vom Parameter NachDatumSortieren).

Ausgabe

• Nachrichten (Messages) - Die extrahierten Nachrichten als Sammlung von MailNachricht- (MailMessage-)Objekten.
  Hinweis: Ab UiPath.Mail.Activities, Version 1.10.4, Das MailMessage-Objekt macht Folgendes verfügbar:

  • Die Nachrichten-ID einer E-Mail-Nachricht, z. B. MailMessage.Headers("Message-ID").
  • Die Kategorien, die einer E-Mail-Nachricht zugeordnet sind, z. B. MailMessage.GetCategories().

Ziel

• MailOrdner (MailFolder) - Der E-Mail-Ordner, aus dem die Nachrichten extrahiert werden sollen.
  Wichtig:

  • Um E-Mails aus einem öffentlichen Ordner abzurufen, muss der Wert des Felds MailFolder genau dem Namen des öffentlichen Ordners entsprechen, der in den Favoriten angezeigt wird.
  • Wenn bei der Verwendung eines öffentlichen Ordners ein persönlicher Ordner mit demselben Namen im Postfach vorhanden ist, gibt die Aktivität die E-Mails aus dem persönlichen Ordner zurück. Um die E-Mails aus dem öffentlichen Ordner zurückzugeben, muss der persönliche Ordner umbenannt werden.
  • Die Aktivität unterstützt keine Posts-Elemente. Wenn sich Posts-Elemente im öffentlichen Ordner befinden, schlägt die Aktivität fehl, es sei denn, Sie geben einen richtigen Filterausdruck an, z. B. FilterExpression = „kind:emails“.
• FreigegebenesPostfach (SharedMailbox) - Ermöglicht das Extrahieren von Nachrichten aus einem mit dem Exchange-Benutzerkonto verknüpften freigegebenen Postfach.

Filterbeispiele

Die folgende Tabelle zeigt Beispiele für Filter, die beim Abfragen von Exchange-E-Mail-Nachrichten nützlich sein können:

Abfrage	Filterausdruck
Alle E-Mail-Nachrichten, deren Betreff „Willkommen“ enthält	"subject:welcome"
Alle E-Mail-Nachrichten, die „welcome“ im Betreff enthalten und von „[e-mail]“ stammen.	"subject:welcome AND from:""[e-mail]"""
Alle E-Mail-Nachrichten von einem E-Mail-Konto von example.com	"from:example.com"
Alle E-Mail-Nachrichten, deren Text „Bitte überprüfen“ enthält	"body:please review"
Alle E-Mail-Nachrichten mit Anhängen	"hasattachment:true"
Alle E-Mail-Nachrichten mit hoher Bedeutung mit einer angehängten PDF-Datei	"importance:high AND attachments:.pdf"
Alle E-Mail-Nachrichten mit den Kategorien „Rote Kategorie“ und „Blaue Kategorie“	"category:Red category, Blue category"
Alle E-Mail-Nachrichten vom Typ Besprechung (z. B. Kalendereinladungen, Antworten)	"kind:meetings"
Alle heute empfangenen E-Mail-Nachrichten	"received:today"
Alle E-Mail-Nachrichten, die am 23.10.2020 empfangen wurden	"received:10/23/2020"
Alle seit dem 23.10.2020 empfangenen E-Mail-Nachrichten	"received: >=10/23/2020"

Hinweis: Informationen zum Angeben eines Filterausdrucks finden Sie unter Durchführen einer AQS-Suche mithilfe von EWS in Exchange.