E-Mail-Connector-Methoden

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 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 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.

    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 Porteigenschaften konfigurieren.

    Tabelle : 1. SetConfig-Methodenparameter
    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

    GetMails

    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.

    Tabelle : 2. Parameter der GetMails-Methode
    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

    MarkAlsRead

    Markiert Nachrichten aus einem angegebenen Ordner als gelesen.

    Informationen zum Festlegen der Parameter finden Sie unter Porteigenschaften konfigurieren.

    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, 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“)

    Als ungelesen markieren

    Markiert Nachrichten aus einem angegebenen Ordner als ungelesen.

    Informationen zum Festlegen der Parameter finden Sie unter Porteigenschaften konfigurieren.

    Tabelle : 4. Parameter der MarkAsRead-Methode
    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“)

    ReadMail

    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.

    Tabelle : 5. Parameter der ReadMail-Methode
    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

    Antwortmail

    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.

    Tabelle : 6. Parameter der PayMail-Methode
    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.

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

    AlleAnhänge speichern

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

    Informationen zum Festlegen der Parameter finden Sie unter Porteigenschaften konfigurieren.

    Tabelle : 7. Parameter der SaveAllAttachments-Methode
    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

    SendMail

    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.

    Tabelle : 8. Parameter der SendMail-Methode
    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.

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