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

UiPath.Mail.Exchange.Activities.GetExchangeMailMessages

Beschreibung

Extrahiert eine E-Mail-Nachricht aus Exchange.

Projektkompatibilität

Windows – Legacy | Windows

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 - Specifies the lowest version of the Exchange server that is used. The options displayed in this field range from 2007 to the 2013 version. Please note that the version number indicates the lowest level of service you support. This means that if you have a 2016 exchange server, you can select the Exchange2013 option.
• 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:
  • UserNameAndPassword - Standard Username and Password Login.
    Wichtig:

    Hinweis: Die Eigenschaft AnwendungsID ist erforderlich, wenn die Authentifizierung mit Benutzername und Kennwort ausgewählt wird. Dadurch wird sichergestellt, dass die ROPC-Authentifizierung anstelle der einfachen Authentifizierung verwendet wird, die in Exchange online veraltet ist.

  • Interactive - Interactive Token (Auth 2.0).
  • Windows Integrated - Integrated Windows Authentication.
• VerzeichnisID – Die ID Ihres Azure Active Directory. Dieses Feld unterstützt nur Strings und String-Variablen.

Optionen

• FilterByMessagesIds - Returns only those mail messages with the specified message IDs. If set, then the FilterExpression parameter is ignored. This field supports only String[] variables.
  Hinweis:

  Filtering by message IDs is supported starting with Exchange Server 2013.

• FilterExpression - Returns only those mail messages matching the filter expression.
  Hinweis:

  The filter expression can be used starting with Exchange Server 2010.

• AnhängeErhalten (GetAttachments) - Gibt an, ob Anhänge der E-Mail-Nachricht extrahiert werden sollen. Standardmäßig ist dieses Auswahlfeld nicht ausgewählt.
  Hinweis:

  For Exchange Server 2007 SP1, the activity returns all attachments, including inline attachments. This is a limitation of the 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 - Order mail messages by date. Choose one of two options: Newest First, Oldest First. The default value is Newest First.
• Top – Die Anzahl abzurufender Nachrichten, beginnend mit der neuesten oder ältesten Nachricht . Die Eigenschaft verwendet standardmäßig den Wert 200 , wenn Sie ihn nicht angeben.

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:

  • To retrieve emails from a public folder, the value of the MailFolder field should be exactly as the name of the public folder that is displayed in Favorites.
  • 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 Post-Elemente. Wenn im öffentlichen Ordner Post-Elemente vorhanden sind, schlägt die Aktivität fehl, es sei denn, Sie geben einen geeigneten Filterausdruck an, z. B. FilterExpression = “kind:emails”.
• FreigegebenesPostfach – Das freigegebene Exchange-Konto-Postfach, das mit dem Exchange-Benutzer verknüpft ist, wenn E-Mail-Nachrichten von ihm abgerufen werden sollen. Wenn Sie das freigegebene Postfach angeben, das das zur Authentifizierung verwendete Konto innerhalb der Aktivität enthält, werden nur die E-Mails aus dem zum freigegebenen Postfach gehörenden E-Mail-Ordner abgerufen. Wenn das freigegebene Postfach nicht angegeben ist, werden nur die E-Mails aus dem Konto abgerufen, das für die Authentifizierung verwendet wird.

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-Mails, die in der Betreffzeile „wilcome“ enthalten und von „ [e-mail] “ stammen	"subject:wilcome AND von:""[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:

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