Aktivität 'E-Mail senden'

Eine Orchestrierung, die die Aktivität E-Mail senden enthält, agiert während der Laufzeit als E-Mail-Client.

Die Aktivität E-Mail senden stellt eine Verbindung zum SMTP-Server her und sendet eine Nachricht an den Server. Dies wird in der folgenden Abbildung dargestellt.
Abbildung 1.
Die Schritte zum Hinzufügen und Konfigurieren einer Aktivität E-Mail senden werden in den folgenden Prozeduren beschrieben.

Aktivität 'E-Mail senden' zur Orchestrierung hinzufügen

  1. Erstellen oder öffnen Sie eine Orchestrierung. Eine grafische Darstellung der Orchestrierung wird angezeigt.
  2. Wählen Sie die Registerkarte Aktivitäten aus und erweitern Sie den Ordner E-Mail.
  3. Ziehen Sie die Aktivität E-Mail senden auf die Orchestrierung.
  4. Wählen Sie die Aktivität aus. Die Prüfliste wird angezeigt.

E-Mail-Endpunkt erstellen, auswählen oder bearbeiten

  1. Klicken Sie auf die Task 'Endpunkt auswählen' in der Prüfliste und wählen Sie eine der folgenden Aktionen aus:
    • Wählen Sie einen vorhandenen Endpunkt aus:
      1. Wählen Sie Durchsuchen aus. Der Projektexplorer wird angezeigt.
      2. Wählen Sie einen vorhandenen Endpunkt aus und klicken Sie auf OK. Führen Sie folgende Schritte ausAktivität konfigurieren.
    • Wählen Sie einen vorhandenen Endpunkt aus und bearbeiten Sie den Endpunkt:
      1. Wählen Sie Durchsuchen aus. Der Projektexplorer wird angezeigt.
      2. Wählen Sie einen vorhandenen Endpunkt aus und klicken Sie auf OK.
      3. Klicken Sie auf Bearbeiten. Das Teilfenster 'Endpunkt bearbeiten' wird angezeigt.
    • Erstellen Sie einen neuen Endpunkt: Wählen Sie Neu aus. Das Fenster Endpunkt erstellen wird angezeigt.
  2. Erstellen oder bearbeiten Sie einen E-Mail-Endpunkt. Weitere Informationen finden Sie unter E-Mail-Endpunkt erstellen oder bearbeiten.

Aktivität konfigurieren

  1. Wählen Sie die Task Konfigurieren in der Prüfliste aus. Das Teilfenster 'Konfiguration' wird angezeigt.
  2. Konfigurieren Sie alle Felder in diesem Teilfenster wie in der folgenden Tabelle beschrieben:
    Tabelle 1.
    Feld Beschreibung
    Absenderadresse (Von:) Gibt die Absenderadresse der E-Mail-Nachricht an. Sie müssen die E-Mail-Adresse mithilfe des E-Mail-Standardformats angeben: email@domain.extension. Dieses Feld ist erforderlich.
    Empfängeradresse (An:) Gibt die Empfängeradresse der E-Mail-Nachricht an. Sie müssen die E-Mail-Adresse mithilfe des E-Mail-Standardformats angeben: email@domain.extension. Es können eine oder mehrere Adressen angegeben werden. Trennen Sie die Adressen mit Kommas oder Semikolons voneinander. Sie müssen mindestens eine Adresse angeben. Dieses Feld ist erforderlich.
    CC Gibt die Adresse für die Kopie zur Kenntnisnahme (CC:) der E-Mail-Nachricht an. Sie müssen die E-Mail-Adresse mithilfe des E-Mail-Standardformats angeben: email@domain.extension. Es können eine oder mehrere Adressen angegeben werden. Trennen Sie die Adressen mit Kommas oder Semikolons voneinander. Das Feld ist optional.
    Betreff Gibt den Betreff der E-Mail-Nachricht an.

Wiederholungsoptionen angeben

  1. Wählen Sie die Task Wiederholung in der Prüfliste aus. Das Fenster 'Wiederholung' wird angezeigt.
  2. Konfigurieren Sie die Wiederholungsoptionen für die Verbindung zu einem SMTP-Server. Die folgende Tabelle beschreibt die Wiederholungsoptionen für die Verbindung zu einem SMTP-Server:
    Tabelle 2.
    Feld Beschreibung
    Wiederholung  
    1) ___ Sekunden zwischen den einzelnen Wiederholungen warten. Gibt die Anzahl der Sekunden an, die die Integrationseinheit (Integration Appliance) wartet, bevor sie erneut versucht, eine Verbindung zu einem SMTP-Server herzustellen.
    2) Verbindungsherstellung ___ mal versuchen, bevor ein Fehler zurückgegeben wird. Gibt die Anzahl der Wiederholungen an - Die maximale Anzahl der Versuche der Integrationseinheit (Integration Appliance), eine Verbindung zum SMTP-Server herzustellen, bevor ein Fehler ausgegeben und die Verarbeitung des aktuellen Orchestrierungsjobs gestoppt wird.

    Wenn Sie eine Orchestrierung implementieren, die eine Aktivität E-Mail senden enthält und die Integrationseinheit (Integration Appliance) keine Verbindung zum angegebenen SMTP-Server herstellen kann, dann protokolliert die Integrationseinheit (Integration Appliance) die Verbindungsfehler als Warnungen in den System- und Orchestrierungsprotokollen, bis der Wert für den Wiederholungszähler erreicht ist. Wenn die Wiederholungsanzahl erreicht wird, protokolliert die Integrationseinheit einen Fehler im System- und Orchestrierungsprotokoll und stoppt die Verarbeitung des aktuellen Orchestrierungsjobs.

    Wenn Sie zum Beispiel die Wiederholungsanzahl auf den Wert 3 setzen, werden der erste, zweite und dritte Verbindungsfehler im Systemprotokoll als Warnung aufgezeichnet. Die Integrationseinheit protokolliert den vierten Verbindungsfehler als Fehler und stoppt die Verarbeitung des aktuellen Orchestrierungsjobs.

     

Eingabe der Aktivität zuordnen

  1. Wählen Sie die Task Eingaben zuordnen in der Prüfliste aus. Die Eingabeparameter der Aktivität werden im Teilfenster 'An Aktivität' angezeigt.
  2. In dieser Task ordnen Sie Variablen den folgenden Eingabeparametern der Aktivität zu:
    • Der Eingabeparameter body enthält den Hauptteil der E-Mail-Nachricht und zugehörige Anhänge. Der Eingabeparameter body weist den Typ 'string' auf. Sie müssen eine Variable zuordnen oder einen Standardwert zum Eingabeparameter body zuordnen.
    • Der optionale Eingabeparameter mailheader enthält Metainformationen zur E-Mail-Nachricht. Zum Beispiel die E-Mail-Adressen, die die Nachricht an den mimeHeader der Nachricht selbst sendet. Der Eingabeparameter mailheader ist optional. Sie müssen keine Variable zuordnen oder Standardwerte zum Eingabeparameter mailheader zuordnen.

      Wenn der optionale Eingabeparameter mailheader nicht im Teilfenster An Aktivität des Teilfensters Eingaben zuordnen aufgelistet ist, wählen Sie im Symbolleistenmenü Zuordnen > Optionale Parameter anzeigen aus oder klicken mit der rechten Maustaste auf das Teilfenster 'An Aktivität' und wählen die Option Optionale Parameter anzeigen aus. Wenn die Option Zuordnen > Optionale Parameter anzeigen im Symbolleistenmenü nicht auswählbar ist, klicken Sie auf einen Knoten im Teilfenster 'Eingaben zuordnen' um diese Option zu aktivieren.

      Sie können die Einstellungen, die Sie in der Task Konfigurieren der Prüfliste dynamisch während der Laufzeit angegeben haben, optional überschreiben, indem Sie Werte von Variablen in die in der folgenden Tabelle angegebenen Knoten übergeben. Sie können zum Beispiel die Einstellung für das Feld Absenderadresse während der Laufzeit überschreiben, indem Sie eine Variable zum Ausgangsknoten (from) des Eingabeparameters mailheader zuordnen. Während der Laufzeit ist der Wert der Variablen die Ausgangsadresse from in der gesendeten E-Mail-Nachricht.

      Tabelle 3.
      Knoten der Eingabeparameter 'mailheader' Beschreibung Welche Einstellungen in der Konfigurierungstask werden überschrieben?
      Von Gibt die Absenderadresse der E-Mail-Nachricht an. Sie müssen die E-Mail-Adresse mithilfe des E-Mail-Standardformats angeben: email@domain.extension. Der Knoten from des Eingabeparameters mailheader überschreibt das Feld Absenderadresse, das in der Task Konfigurieren angegeben ist.
      An Gibt die Empfängeradresse für die E-Mail-Nachricht an. Sie müssen die E-Mail-Adresse mithilfe des E-Mail-Standardformats angeben: email@domain.extension. Es können eine oder mehrere Adressen angegeben werden. Trennen Sie die Adressen mit Kommas oder Semikolons voneinander. Der Knoten to des Eingabeparameters mailheader überschreibt das Feld An, das in der Task Konfigurieren angegeben ist.
      CC Gibt die Adresse für die Kopie zur Kenntnisnahme (CC:) der E-Mail-Nachricht an. Sie müssen die E-Mail-Adresse mithilfe des E-Mail-Standardformats angeben: email@domain.extension. Es können eine oder mehrere Adressen angegeben werden. Trennen Sie die Adressen mit Kommas oder Semikolons voneinander. Der Knoten cc des Eingabeparameters mailheader überschreibt das Feld CC, das in der Task Konfigurieren angegeben ist.
      Betreff Gibt den Betreff der E-Mail-Nachricht an. Der Knoten subject des Eingabeparameters mailheader überschreibt das Feld Betreff, das in der Task Konfigurieren angegeben ist.
      mimeHeader Gibt den MIME-Header der E-Mail-Nachricht an. Keine.
      otherHeaders Gibt ein Element an, das eine Gruppe von MIME-Headern als Name/Wert-Paare enthält und nicht bereits im Knoten mimeHeader angegeben ist. Beispiel: Der MIME-Header 'Content-Location' ist nicht im MIME-Header angegeben, der folgenden Knoten 'headerItem' kann daher nicht die folgenden Werten annehmen: otherheaders/headerItem/name ist gleich 'Content-Location' otherHeaders/headerItem/value ist gleich dem Wert des MIME-Headers 'Content-Location', also kann zum Beispiel die Zeichenfolge: 'RN-Preamble Multiple MIME headers' angegeben werden, damit dies ein wiederholt auftretender Knoten ist. Keine.
      Anmerkung: Sie können die Aktivität MIME schreiben verwenden, um den Inhalt des Knotens mimeHeader des optionalen Eingabeparameters mailheader zu erstellen. Sie könnten eine Aktivität MIME schreiben vor der Aktivität E-Mail senden zur Orchestrierung hinzufügen und durch die Aktivität MIME schreiben den Inhalt der XML-Variablen mimeHeader auffüllen lassen und anschließend die Variable mimeHeader an die Aktivität E-Mail senden übergeben.

      Weitere Informationen finden Sie unter Zuordnung erstellen.

      Anmerkung: Wenn Sie nicht-englische Nutzdaten verwenden, müssen mailheader, mimeHeader und otherheaders beim Hinzufügen zu der Orchestrierung der Aktivität E-Mail abrufen zugeordnet werden und anschließend von der Orchestrierung wieder der Aktivität E-Mail senden zugeordnet werden.