E-Mail-Connector-Methoden

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 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 zu konfigurieren und auf Anmeldeinformationen zuzugreifen. 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- oder For-Schleifenmethode verwenden, um jede Nachricht in der Sammlung zu durchlaufen.

    Legen Sie die Konfiguration fest

    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
    Benutzername Benutzername für die Anmeldung beim E-Mail-Server Daten ein Zeichenfolge (keine) Ja
    Passwort Passwort für die Anmeldung beim E-Mail-Server Daten ein Zeichenfolge (keine) Ja
    Standardanmeldeinformationen verwenden Sendet die Standardanmeldeinformationen des aktuell angemeldeten Benutzers an den SMTP-Server. Daten ein Boolean Falsch Nein
    SMTPMailServer Name des SMTP-Servers Daten ein 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 ein 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 Daten ein Boolean Wahr Nein
    SMTPPort SMTP-Portnummer Daten ein Ganzzahl 587 Nein
    ImapPort IMAP-Portnummer Daten ein Ganzzahl 993 Nein

    GetMails

    Gibt Nachrichten vom E-Mail-Server zurück, die von anderen Methoden verwendet werden sollen. Sie können die Methode so festlegen, dass entweder gelesene (gesehene) oder ungelesene (nicht gesehene) Nachrichten abgerufen werden, und den Ordner angeben, aus dem sie gesammelt werden.

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

    Tabelle : 2. Parameter der GetMails-Methode
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Erforderlich? Notizen
    Ordnername Name des IMAP-Ordners, aus 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\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 Datenausgabe Objekt Objekt Ja

    AlsLesen markieren

    Markiert Nachrichten aus einem angegebenen Ordner als gelesen.

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

    Tabelle : 3. Parameter der MarkAsRead-Methode
    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, aus 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\Besprechungen).

    Als ungelesen markieren

    Markiert Nachrichten aus einem angegebenen Ordner als ungelesen.

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

    Tabelle : 4. Parameter der MarkAsRead-Methode
    Parameter Beschreibung Porttyp Datentyp Standardwert Erforderlich? Notizen
    MailObject Das E-Mail-Objekt, auf dessen Grundlage die entsprechende E-Mail als ungelesen markiert wird. Daten in Objekt Objekt Ja
    Ordnername Name des IMAP-Ordners, aus 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\Besprechungen).

    ReadMail

    Liest eine Nachricht und gibt ihre Details zurück, einschließlich Betreff, Text, Absender (von), Empfänger im CC-Feld, Empfänger im BCC-Feld und die 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? Notizen
    MailObject MailObject, das die Details der letzten empfangenen Nachricht angibt Daten in Objekt Objekt Ja
    Betreff Betreff der Nachricht Datenausgabe Zeichenfolge Keine Nein
    Textkörper Text der Nachricht Datenausgabe Zeichenfolge Keine Nein
    Absender Absender der Nachricht Datenausgabe Zeichenfolge Keine Nein
    CC Empfänger in CC markiert Datenausgabe Zeichenfolge Keine Nein
    BCC Empfänger in BCC markiert Datenausgabe Zeichenfolge Keine Nein
    AttachmentsCount Anzahl der Anhänge in der Nachricht Datenausgabe Ganzzahl Keine Nein

    Antwortmail

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

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

    Tabelle : 6. Parameter der ReplyMail-Methode
    Parameter Beschreibung Datenporttyp Datentyp Standardwert Erforderlich? Notizen
    MailObject Nachrichtenobjekt, das die Nachrichtendetails enthält Daten in Objekt Objekt Ja
    AllenAntworten 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 BCC-Feld 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 zu der Datei in das Feld ein.
    2. Entfernen Sie die Anführungszeichen, die den Pfad einschließen.

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

    SaveAllAttachments

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

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

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

    SendMail

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

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

    Tabelle : 8. SendMail-Methodenparameter
    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 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 zu der Datei in das Feld ein.
    2. Entfernen Sie die Anführungszeichen, die den Pfad einschließen.

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