--- sourceDocument: Xanadu: Integrationen mit Anwendungen erstellen sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/integrate-applications Release : - xanadu ft:locale : - de-DE ft:publication_title : - Xanadu: Integrationen mit Anwendungen erstellen ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # E-Mail-Connector-Methoden # E-Mail-Connector-Methoden {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 Minuten Lesedauer Die -Methoden im E-Mail-Connector rufen E-Mail-Nachrichten ab, senden und beantworten sie und können Anhänge herunterladen. Verwenden Sie zuerst die SetConfig-Methode, um die Verbindung zu Ihrem E-Mail-Server einzurichten. Verwenden Sie die SetConfig-Methode, um die E-Mail-Server-Eigenschaften und Anmeldeinformationen zu konfigurieren. Diese Methode muss allen anderen E-Mail-Connector-Methoden in der Automatisierung vorausgehen. Die GetMails-Methode ruft Nachrichten vom E-Mail-Server ab und übergibt sie als Objekt, das eine oder mehrere Nachrichten enthält, an andere Methoden. Die Methoden „ReadMail", „ReplyMail" und „SaveAllAttachments" werden jeweils für eine einzelne Nachricht ausgeführt. Wenn diese Methoden ein Objekt empfangen, das mehr als eine Nachricht enthält, muss die Automatisierung eine For-Each-Methode oder eine For-Loop-Methode verwenden, um jede Nachricht in der Sammlung zu iterieren. * Informationen zur Verwendung der For-Each-Methode finden Sie unter [Verwenden Sie die Komponente „Für alle".](https://servicenow-prod.fluidtopics.net/qMxRuYyh46vHMUVZcdZhiA "Durchlaufen Sie jedes Element in einer Sammlung in der Reihenfolge vom ersten bis zum letzten mithilfe der Komponente „Für jeden“ in RPA Desktop Design Studio. Die Sammlung kann ein Array, eine Liste oder eine Tabelle sein."). * Informationen zur Verwendung der For-Schleifenmethode finden Sie unter [Verwenden Sie die For-Schleifenkomponente](https://servicenow-prod.fluidtopics.net/P53QxvwBMOOpvReEjlaxmA "Führen Sie Code wiederholt aus, um sich wiederholende Aufgaben mit der For-Schleifenkomponente in RPA Desktop Design Studioauszuführen. Die For-Schleife ist eine Steuerungs-Flow-Komponente zum Angeben von Iterationen."). {#email-connector-methods__ul_rkc_ss4_lzb} ## Legen Sie die Konfiguration fest {#email-connector-methods__section_psc_jv2_mtb} Richtet die Verbindung zum E-Mail-Server ein, damit die Automatisierung mit Nachrichten arbeiten kann. Hinweis: Sie müssen diese Methode ausführen, bevor Sie andere Methoden im E-Mail-Connector ausführen. Informationen zum Festlegen der Parameter finden Sie unter [Porteigenschaften konfigurieren](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#email-connector-methods__table_qrp_jx2_mtb__entry__7} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Erforderlich? | Notizen | |-|-|-|-|-|-|-| | Anwendername | Anwendername für die Anmeldung beim E-Mail-Server | Dateneingang | Zeichenfolge | (keine) | Ja | | | Passwort | Passwort für die Anmeldung beim E-Mail-Server | Dateneingang | Zeichenfolge | (keine) | Ja | | | Standardanmeldeinformationen verwenden | Sendet die Standardanmeldeinformationen des aktuell angemeldeten Anwenders an den SMTP-Server. | Dateneingang | Boolean | Falsch | Nein | | | SMTPMailServer | Name des SMTP-Servers | Dateneingang | Zeichenfolge | smtp.gmail.com | Nein | Der Zugriff auf Gmail über den E-Mail-Connector wird derzeit nicht unterstützt. Stellen Sie sicher, dass Sie den Standardwert ändern. | | ImapMailServer | Name des IMAP-Servers | Dateneingang | Zeichenfolge | imap.gmail.com | Nein | Der Zugriff auf Gmail über den E-Mail-Connector wird derzeit nicht unterstützt. Stellen Sie sicher, dass Sie den Standardwert ändern. | | SSL | Verwenden Sie das Secure Socket Layer-Protokoll | Dateneingang | Boolean | True | Nein | | | SMTPPort | SMTP-Portnummer | Dateneingang | Ganzzahl | 587 | Nein | | | ImapPort | IMAP-Portnummer | Dateneingang | Ganzzahl | 993 | Nein | | [Tabelle : 1. SetConfig-Methodenparameter] {#email-connector-methods__table_qrp_jx2_mtb} ## GetMails {#email-connector-methods__section_rw5_4mk_mtb} Gibt Nachrichten vom E-Mail-Server zurück, um sie mit anderen Methoden zu verwenden. Sie können die Methode so festlegen, dass entweder gelesene (gesehene) oder ungelesene (unsichtbare) Nachrichten abgerufen werden, und den Ordner angeben, in dem sie gesammelt werden. Informationen zum Festlegen der Parameter finden Sie unter [Porteigenschaften konfigurieren](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#email-connector-methods__table_uvc_1nk_mtb__entry__7} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Erforderlich? | Notizen | |-|-|-|-|-|-|-| | Ordnername | Name des IMAP-Ordners, für den die Methode die Sammlung abruft (z. B. „ Posteingang") | Daten in | Zeichenfolge | Posteingang | Ja | Um einen geschachtelten IMAP-Ordner anzugeben, geben Sie die Ordnerhierarchie mithilfe von umgekehrten Schrägstrichen ein (z. B. „Projekt\\Besprechungen") | | Filter | Legen Sie diese Option fest, um nur ungelesene (Ungesehen) oder gelesene (Gesehen) Nachrichten abzurufen | Daten in | Filtermodus | Ungesehen | Ja | | | Zurück | Gibt die E-Mail-Sammlung als Objekt zurück | Daten aus | Objekt | Objekt | Ja | | [Tabelle : 2. Parameter der GetMails-Methode] {#email-connector-methods__table_uvc_1nk_mtb} ## MarkAlsRead {#email-connector-methods__section_uhb_31l_mtb} Markiert Nachrichten aus einem angegebenen Ordner als gelesen. Informationen zum Festlegen der Parameter finden Sie unter [Porteigenschaften konfigurieren](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#email-connector-methods__table_zhf_kbl_mtb__entry__7} | Parameter | Beschreibung | Porttyp | Datentyp | Standardwert | Erforderlich? | Notizen | |-|-|-|-|-|-|-| | MailObject | Das E-Mail-Objekt, auf dessen Grundlage die entsprechende Nachricht als gelesen markiert wird | Daten in | Objekt | Objekt | Ja | | | Ordnername | Name des IMAP-Ordners, für den das E-Mail-Objekt abgerufen wird | Daten in | Zeichenfolge | Posteingang | Ja | Um einen geschachtelten IMAP-Ordner anzugeben, geben Sie die Ordnerhierarchie mithilfe von umgekehrten Schrägstrichen ein (z. B. „Projekt\\Besprechungen") | [Tabelle : 3. Parameter der MarkAsRead-Methode] {#email-connector-methods__table_zhf_kbl_mtb} ## Als ungelesen markieren {#email-connector-methods__section_l3t_hcl_mtb} Markiert Nachrichten aus einem angegebenen Ordner als ungelesen. Informationen zum Festlegen der Parameter finden Sie unter [Porteigenschaften konfigurieren](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#email-connector-methods__table_phg_mcl_mtb__entry__7} | Parameter | Beschreibung | Porttyp | Datentyp | Standardwert | Erforderlich? | Notizen | |-|-|-|-|-|-|-| | MailObject | Das E-Mail-Objekt basierend auf der entsprechenden E-Mail, die als ungelesen markiert ist. | Daten in | Objekt | Objekt | Ja | | | Ordnername | Name des IMAP-Ordners, für den das E-Mail-Objekt abgerufen wird. | Daten in | Zeichenfolge | Posteingang | Ja | Um einen geschachtelten IMAP-Ordner anzugeben, geben Sie die Ordnerhierarchie mithilfe von umgekehrten Schrägstrichen ein (z. B. „Projekt\\Besprechungen") | [Tabelle : 4. Parameter der MarkAsRead-Methode] {#email-connector-methods__table_phg_mcl_mtb} ## ReadMail {#email-connector-methods__section_iqz_tfl_mtb} Liest eine Nachricht und gibt deren Details zurück, einschließlich Betreff, Text, Absender (Von), Empfänger im Feld „CC", Empfänger im Feld „BCC" und Anzahl der Anhänge. Informationen zum Festlegen der Parameter finden Sie unter [Porteigenschaften konfigurieren](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#email-connector-methods__table_uts_bgl_mtb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Erforderlich? | |-|-|-|-|-|-| | MailObject | MailObject, das die Details der letzten empfangenen Nachricht angibt | Daten in | Objekt | Objekt | Ja | | Betreff | Betreff der Nachricht | Daten aus | Zeichenfolge | Keine | Nein | | Textkörper | Textkörper der Nachricht | Daten aus | Zeichenfolge | Keine | Nein | | Absender | Absender der Nachricht | Daten aus | Zeichenfolge | Keine | Nein | | CC | In CC markierte Empfänger | Daten aus | Zeichenfolge | Keine | Nein | | BCC | In BCC markierte Empfänger | Daten aus | Zeichenfolge | Keine | Nein | | AttachmentsCount | Anzahl der Anhänge in der Nachricht | Daten aus | Ganzzahl | Keine | Nein | [Tabelle : 5. Parameter der ReadMail-Methode] {#email-connector-methods__table_uts_bgl_mtb} ## Antwortmail {#email-connector-methods__section_l11_gyy_mtb} Antwortet automatisch auf eine Nachricht. Verwenden Sie die Parameter, um den Textkörper der Nachricht und andere Details festzulegen. Sie können Anhänge einfügen. Informationen zum Festlegen der Parameter finden Sie unter [Porteigenschaften konfigurieren](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#email-connector-methods__table_hm3_kmz_mtb__entry__7} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Erforderlich? | Notizen | |-|-|-|-|-|-|-| | MailObject | Nachrichtenobjekt, das die Nachrichtendetails enthält | Daten in | Objekt | Objekt | Ja | | | Alle Antworten | Antwort an alle Empfänger in den Feldern An und CC der Nachricht | Daten in | Boolean | Falsch | Nein | | | BCC | Antwort an alle Empfänger im BCC-Feld der Nachricht | Daten in | Zeichenfolge | Keine | Nein | | | Textkörper | Textkörper der Antwortnachricht | Daten in | Zeichenfolge | Keine | Nein | | | IsHtmlBody | Option, um anzugeben, ob der Antworttext im HTML-Format vorliegt | Daten in | Boolean | Falsch | Nein | | | Anhänge | Anhänge an die Antwortnachricht | Daten in | Zeichenfolge | Keine | Nein | So hängen Sie eine Datei an: 1. Fügen Sie den Pfad zu der Datei in das Feld ein. 2. Entfernen Sie die Anführungszeichen, die den Pfad einschließen. {#email-connector-methods__ol_v5m_j4z_mtb} Um mehrere Anhänge einzubeziehen, trennen Sie die Pfade durch Kommas. | [Tabelle : 6. Parameter der PayMail-Methode] {#email-connector-methods__table_hm3_kmz_mtb} ## AlleAnhänge speichern {#email-connector-methods__section_mz4_gyy_mtb} Speichert alle Anhänge einer Nachricht auf dem lokalen Laufwerk. Informationen zum Festlegen der Parameter finden Sie unter [Porteigenschaften konfigurieren](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#email-connector-methods__table_vbt_5zy_mtb__entry__6} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Erforderlich? | |-|-|-|-|-|-| | MailObject | Nachricht, von der die Methode die Anhänge herunterladt | Dateneingang | Objekt | Objekt | Ja | | Ordnerpfad | Pfad des Verzeichnisses, in das die Anhänge heruntergeladen werden | Dateneingang | Zeichenfolge | Keine | Ja | [Tabelle : 7. Parameter der SaveAllAttachments-Methode] {#email-connector-methods__table_vbt_5zy_mtb} ## SendMail {#email-connector-methods__section_r4g_xqz_mtb} Sendet eine Nachricht. Verwenden Sie die Parameter, um den Textkörper der Nachricht und andere Details festzulegen. Sie können Anhänge einfügen. Hinweis: Verwenden Sie die SetConfig-Methode, um die Absenderadresse festzulegen. Informationen zum Festlegen der Parameter finden Sie unter [Porteigenschaften konfigurieren](https://servicenow-prod.fluidtopics.net/inkwzmXhYoxpYR_STKUQmA "Konfigurieren Sie, wie Daten an die Eingabefelder einer Komponente oder Methode in RPA Desktop Design Studioübergeben werden."). {#email-connector-methods__table_qvr_frz_mtb__entry__7} | Parameter | Beschreibung | Datenporttyp | Datentyp | Standardwert | Erforderlich? | Notizen | |-|-|-|-|-|-|-| | AnAdresse | Adresse, an die die Nachricht gesendet werden soll | Daten in | Zeichenfolge | Keine | Ja | | | CC | Adressen, die in das CC-Feld aufgenommen werden sollen | Daten in | Zeichenfolge | Keine | Nein | | | BCC | Adressen, die in das BCC-Feld aufgenommen werden sollen | Daten in | Zeichenfolge | Keine | Nein | | | Betreff | Nachrichtenbetreff | Daten in | Zeichenfolge | Keine | Nein | | | Textkörper | Nachrichtentext | Daten in | Zeichenfolge | Keine | Nein | | | IsHtmlBody | Option, um anzugeben, ob der Antworttext im HTML-Format vorliegt | Daten in | Zeichenfolge | Falsch | Nein | | | Anhänge | Nachrichtenanhänge | Daten in | Zeichenfolge | Keine | Nein | So hängen Sie eine Datei an: 1. Fügen Sie den Pfad zu der Datei in das Feld ein. 2. Entfernen Sie die Anführungszeichen, die den Pfad einschließen. {#email-connector-methods__ol_jsq_kb4_lzb} Um mehrere Anhänge einzubeziehen, trennen Sie die Pfade durch Kommas. | [Tabelle : 8. Parameter der SendMail-Methode] {#email-connector-methods__table_qvr_frz_mtb}