Zum Inhalt springen

Email Email Leseaktivität

Einführung

Eine Email Aktivität Email-Mail lesen unter Verwendung ihrer Email-Verbindung, ruft ungelesene Email mithilfe des Internet Message Access Protocol (IMAP) ab und soll als Quelle für die Bereitstellung von Daten für einen Operation verwendet werden.

Erstellen einer Email - Leseaktivität

Eine Instanz einer Email Aktivität Email lesen wird aus einer Email-Verbindung erstellt mithilfe des Aktivitätstyps Email lesen.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

Eine vorhandene Email Aktivität Email lesen kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Email - Leseaktivität

Führen Sie die folgenden Schritte aus, um die Aktivität „Email Email lesen“ zu konfigurieren:

Schritt 1: Geben Sie einen Namen ein und wählen Sie einen Ordner aus

Geben Sie in diesem Schritt einen Namen für die Aktivität ein und wählen Sie einen Ordner aus. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

Email - Leseaktivität - Konfigurationsschritt 1

  • Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede Email Aktivität Email lesen eindeutig sein und darf keine Schrägstriche enthalten / oder Doppelpunkte :.

  • Ordner auswählen: In diesem Abschnitt werden die im Email Endpoint verfügbaren Ordner angezeigt.

    • Ausgewählter Ordner: Nachdem ein Ordner ausgewählt wurde, wird er hier aufgelistet.

    • Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Ordnerliste zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet. Wenn in der Tabelle bereits Ordner angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Ordner beim Suchen vom Endpoint neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann, wie unten beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Ordner vom Email Endpoint neu zu laden. Dies kann nützlich sein, wenn Ordner zu Email hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Ordnertabelle verwendet werden.

    • Ordner auswählen: Klicken Sie in der Tabelle irgendwo auf eine Zeile, um einen Ordner auszuwählen. Es kann nur ein Ordner ausgewählt werden. Die für jeden Ordner verfügbaren Informationen werden vom Email Endpoint abgerufen:

      • Name: Der Name des Ordners.

    Tipp

    Wenn die Tabelle nicht mit verfügbaren Ordnern gefüllt ist, wird die Email Verbindung ist möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen erneut testen.

  • Speichern und beenden: Klicken Sie, wenn aktiviert, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Filter festlegen

Geben Sie in diesem Schritt die Email Kriterien an, nach denen gefiltert werden soll. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

Email - Leseaktivität - Konfigurationsschritt 2

Notiz

Wenn eine Kombination aus den Feldern Von, Betreff, An, CC, Startdatum oder Enddatum eingegeben wird, werden nur Email abgerufen, die alle angegebenen Filterkriterien erfüllen. Die Verwendung von Platzhalterzeichen wird nicht unterstützt.

Tipp

Felder mit variablem Symbol Unterstützung der Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit einer öffnenden eckigen Klammer [ in das Feld oder durch Klicken auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Von: Geben Sie eine einzelne Absender Email-Adresse oder einen Teil einer Absender-Email-Adresse ein.

  • Betreff: Geben Sie eine einzelne Betreffzeile oder einen Teil einer Betreffzeile ein.

  • An: Geben Sie eine einzelne Empfänger Email-Adresse oder einen Teil einer Empfänger-Email-Adresse ein.

  • CC: Geben Sie eine einzelne CC-Empfänger-Email-Adresse oder einen Teil einer CC-Empfänger-Email-Adresse ein.

  • Startdatum: Geben Sie das Startdatum der Email im Format yyyy-mm-dd.

  • Enddatum: Geben Sie das Enddatum der Email im Format yyyy-mm-dd.

  • Maximale Anzahl von Rücksendungen: Geben Sie die maximale Anzahl ungelesener Emails ein, die in der Antwort zurückgesendet werden sollen. Lassen Sie dieses Feld leer, um alle verfügbaren ungelesenen Nachrichten zurückzusenden.

  • Anhänge einschließen: Wählen Sie diese Option aus, um Email Anhänge in die Antwort einzuschließen (standardmäßig ausgewählt).

  • Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Weiter: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen Klicken Sie nach dem Vornehmen von Änderungen hierauf, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 3: Überprüfen der Datenschemata

Alle vom Endpoint generierten Anforderungs- oder Antwortschemata werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

Email - Leseaktivität - Konfigurationsschritt 3

  • Datenschemata: Diese Datenschemata werden von benachbarten Transformations übernommen und beim Transformation erneut angezeigt.

    Das Schema besteht aus diesen Knoten und Feldern:

    Antwortschemaknoten/-feld Beschreibung
    readEmailResponse Knoten der Email Antwort
    item Knoten des Elements der Email Empfänger
    recipients Knoten der Email Empfänger
    to Knoten der Empfänger des Email-An-Felds
    item Knoten des Empfängerelements des Email Felds „An“
    #text Zeichenfolgenwert einer einzelnen "An"-Empfänger-Email Adresse
    cc Knoten der Empfänger des Email-Felds "cc"
    item Knoten des Empfängerelements des Email-Felds „cc“
    #text Zeichenfolgenwert einer einzelnen „cc“-Empfänger-Email Adresse
    dateTime Zeichenfolge mit Datum und Uhrzeit des Email Versands
    from Zeichenfolge des Email Absenderfelds
    subject Zeichenfolge aus dem Betrefffeld der Email
    mailBody Zeichenfolge des Email-Felds „Textkörper“
    attachments Knoten mit Email Anhängen
    item Knoten des Email Anhangselements
    fileName Zeichenfolge mit dem Dateinamen des Email Anhangs
    base64content String des base64-kodierten Anhangsinhalts

    Tipp

    Sie können Jitterbits Base64Decode Funktion zum Dekodieren von Anhangsinhalten.
    fileSize String der Binärdateigröße für den Email Anhang
    fileBase64Length String der Base64-kodierten Zeichenlänge für den Email Anhang

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas vom Email Endpoint neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im gesamten Projekt neu, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden Transformation.

  • Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Änderungen verwerfen Klicken Sie nach dem Vornehmen von Änderungen hierauf, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine Email-Aktivität „Email lesen“ konfiguriert haben, schließen Sie die Konfiguration des Operation ab, indem Sie andere Aktivitäten, Transformations oder Scripts als Operation hinzufügen und konfigurieren. Sie können auch die Operation konfigurieren, die die Möglichkeit umfassen, Vorgänge zu verketten, die sich im selben oder in unterschiedlichen Workflows befinden.

Auf Menüaktionen für eine Aktivität kann über den Projektbereich und die Design-Canvas zugegriffen werden. Weitere Informationen finden Sie unter Aktionsmenü in Connector-Grundlagen.

Mit diesen Operation können Email-Aktivitäten vom Typ Email-Mail lesen als Quelle verwendet werden:

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie dann diesen temporären Speicherort in der Skriptfunktion.

Wenn Sie bereit sind, einsetzen und ausführen den Operation und validieren Sie das Verhalten durch Überprüfen der Operation.