E-Mail-Connector-Methoden

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 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 die 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 an andere Methoden als Objekt, das eine oder mehrere Nachrichten enthält. Die Methoden „ReadMail“, „ReplyMail“ und „SaveAllAttachments“ arbeiten jeweils für eine einzelne Nachricht. Wenn diese Methoden ein Objekt empfangen, das mehr als eine Nachricht enthält, muss die Automatisierung eine für jede oder eine for-Schleife-Methode verwenden, um jede Nachricht in der Sammlung zu iterieren.

    SetConfig

    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 Konfigurieren Sie Porteigenschaften.

    Tabelle : 1. SetConfig-Methodenparameter
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Erforderlich? Notizen
    Anwendername Anwendername, der sich beim E-Mail-Server anmelden soll Daten In Zeichenfolge (keine) Ja
    Passwort Passwort für die Anmeldung beim E-Mail-Server Daten In Zeichenfolge (keine) Ja
    UseDefaultAnmeldeinformationen Sendet die Standardanmeldeinformationen des derzeit angemeldeten Anwenders an den SMTP-Server. Daten In Boolean Falsch Nein
    SmtpMailServer Name des SMTP-Servers Daten In 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 Daten In 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 Protokoll Secure Socket Layer Daten In Boolean True Nein
    SmtpPort SMTP-Portnummer Daten In Ganzzahl 587 Nein
    ImapPort IMAP-Portnummer Daten In Ganzzahl 993 Nein

    GetMails

    Gibt Nachrichten vom E-Mail-Server zur Verwendung mit anderen Methoden zurück. Sie können die Methode festlegen, um gelesene (gesehen) oder ungelesene (nicht gesehen) Nachrichten abzurufen, und den Ordner angeben, in dem sie erfasst werden.

    Informationen zum Festlegen der Parameter finden Sie unter Konfigurieren Sie Porteigenschaften.

    Tabelle : 2. GetMails-Methodenparameter
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Erforderlich? Notizen
    Ordnername Name des IMAP-Ordners, von dem die Methode die Sammlung abruft (z. B. Posteingang ) Daten in Zeichenfolge Posteingang Ja Um einen geschachtelten IMAP-Ordner anzugeben, geben Sie die Ordnerhierarchie mit umgekehrten Schrägstrichen ein (z. B. Projekt\Meetings).
    Filter Legen Sie diese Option fest, um nur ungelesene ( Nicht Gesehen ) Oder lesen ( Gesehen ) Nachrichten Daten in Filtermodus Nicht Gesehen Ja
    Zurück Gibt die E-Mail-Sammlung als Objekt zurück Daten aus Objekt Objekt Ja

    MarkAsLesen

    Markiert Nachrichten aus einem angegebenen Ordner als gelesen.

    Informationen zum Festlegen der Parameter finden Sie unter Konfigurieren Sie Porteigenschaften.

    Tabelle : 3. MarkAsRead-Methodenparameter
    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, in dem das E-Mail-Objekt abgerufen wird Daten in Zeichenfolge Posteingang Ja Um einen geschachtelten IMAP-Ordner anzugeben, geben Sie die Ordnerhierarchie mit umgekehrten Schrägstrichen ein (z. B. Projekt\Meetings).

    MarkAsUngelesen

    Markiert Nachrichten aus einem angegebenen Ordner als ungelesen.

    Informationen zum Festlegen der Parameter finden Sie unter Konfigurieren Sie Porteigenschaften.

    Tabelle : 4. MarkAsRead-Methodenparameter
    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, in dem das E-Mail-Objekt abgerufen wird. Daten in Zeichenfolge Posteingang Ja Um einen geschachtelten IMAP-Ordner anzugeben, geben Sie die Ordnerhierarchie mit umgekehrten Schrägstrichen ein (z. B. Projekt\Meetings).

    E-Mail lesen

    Liest eine Nachricht und gibt ihre 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 Konfigurieren Sie Porteigenschaften.

    Tabelle : 5. ReadMail-Methodenparameter
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Erforderlich?
    MailObject MailObject, das die Details der letzten empfangenen Nachricht enthält 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
    Anhangsanzahl Anzahl der Anhänge in der Nachricht Daten aus Ganzzahl Keine Nein

    ReplyMail

    Antwortet automatisch auf eine Nachricht. Verwenden Sie die Parameter, um den Nachrichtentext und andere Details festzulegen. Sie können Anhänge einfügen.

    Informationen zum Festlegen der Parameter finden Sie unter Konfigurieren Sie Porteigenschaften.

    Tabelle : 6. ReplyMail-Methodenparameter
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Erforderlich? Notizen
    MailObject Nachrichtenobjekt mit den Nachrichtendetails Daten in Objekt Objekt Ja
    ReplyToAll Antwortet an alle Empfänger in den Feldern an und CC der Nachricht Daten in Boolean Falsch Nein
    BCC Antwortet an alle Empfänger im Feld BCC der Nachricht Daten in Zeichenfolge Keine Nein
    Textkörper Text 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 zur Datei in das Feld ein.
    2. Entfernen Sie die Angebote, die den Pfad umschließen.

    Um mehrere Anhänge einzubeziehen, trennen Sie die Pfade durch Kommas.

    Alle Anhänge speichern

    Speichert alle Anhänge aus einer Nachricht auf dem lokalen Laufwerk.

    Informationen zum Festlegen der Parameter finden Sie unter Konfigurieren Sie Porteigenschaften.

    Tabelle : 7. Parameter der SaveAllAttachments-Methode
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Erforderlich?
    MailObject Nachricht, aus der die Methode die Anhänge herunterlädt Daten In Objekt Objekt Ja
    Ordnerpfad Pfad des Verzeichnisses, in das die Anhänge heruntergeladen werden Daten In Zeichenfolge Keine Ja

    Sendmail

    Sendet eine Nachricht. Verwenden Sie die Parameter, um den Nachrichtentext und andere Details festzulegen. Sie können Anhänge einfügen.
    Hinweis:
    Verwenden Sie die Methode SetConfig, um die Absenderadresse festzulegen.

    Informationen zum Festlegen der Parameter finden Sie unter Konfigurieren Sie Porteigenschaften.

    Tabelle : 8. Parameter der sendmail-Methode
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Erforderlich? Notizen
    ToAddress Adresse, an die die Nachricht gesendet werden soll Daten in Zeichenfolge Keine Ja
    CC Adressen, die in das Feld CC aufgenommen werden sollen Daten in Zeichenfolge Keine Nein
    BCC Adressen, die in das BCC-Feld aufgenommen werden sollen Daten in Zeichenfolge Keine Nein
    Betreff Betreff der Nachricht 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 zur Datei in das Feld ein.
    2. Entfernen Sie die Angebote, die den Pfad umschließen.

    Um mehrere Anhänge einzubeziehen, trennen Sie die Pfade durch Kommas.