Zum Hauptinhalt springen

SendEMail@1

Der Node SendEMail@1 wird verwendet, um eine E-Mail über die angegebene SMTP-Server-Konfiguration zu versenden. Der Node benötigt Betreff und Text der E-Mail im Payload. Die E-Mail kann an einen oder mehrere Empfänger gesendet werden.

Dieser Node benötigt eine bestehende SMTP-Konfiguration. Die Konfiguration wird in der OctoMesh-Benutzeroberfläche unter dem Reiter General/Configuration erstellt. Die Konfiguration wird zur Verbindung mit dem SMTP-Server verwendet.

Adapter-Voraussetzungen​

Node-Konfiguration​

Zu den Feldern targetPath, targetValueWriteMode und targetValueKind siehe Überblick. Das Feld path wird in diesem Node nicht verwendet.

Konfigurationsoptionen​

Der Node SendEMail@1 bietet flexible Optionen zum Versenden von E-Mails:

  • serverConfiguration: Name des globalen SMTP-Konfigurationsobjekts (erforderlich).
  • cssConfiguration: Name der globalen CSS-Konfiguration für das E-Mail-Styling (optional).
  • subjectPath: Pfad zum E-Mail-Betreff im Payload (erforderlich).
  • path: Pfad zum E-Mail-Text im Payload (erforderlich).
  • toPath: Pfad zu den E-Mail-Adressen der Empfänger im Payload (erforderlich).
  • ccPath: Pfad zu einer Liste von CC-E-Mail-Adressen im Payload (optional).
  • ccAddresses: Statische Liste von CC-E-Mail-Adressen (optional).
  • bccPath: Pfad zu einer Liste von BCC-E-Mail-Adressen im Payload (optional).
  • bccAddresses: Statische Liste von BCC-E-Mail-Adressen (optional).
  • attachmentRtIdPath: Pfad zur Runtime-ID des Anhangs im Payload (optional).
  • attachmentRtId: Runtime-ID der Anhang-Entität (optional).
  • attachmentFileName: Dateiname für den Anhang (optional).
  • attachmentContentType: MIME-Typ für den Anhang (optional, Standard application/octet-stream).

Anwendungsbeispiel​

Hier ist ein Beispiel, wie Sie den Node SendEMail@1 in einer Transformations-Pipeline verwenden könnten. In diesem Beispiel ruft der Node eine Benachrichtigungsvorlage namens emaildemo ab und speichert den Vorlagentext im Payload unter $.body und den Betreff unter $.subject. Im Vorlagentext gibt es zwei Platzhalter, tableData und firstName, die durch das Abfrageergebnis bzw. den Vornamen des Kunden ersetzt werden. Nach dem Ersetzen der Platzhalter wird die E-Mail an die angegebene E-Mail-Adresse gesendet.

triggers:
  - type: FromExecutePipelineCommand@1
transformations:
  - type: GetNotificationTemplate@1 # Get the notification template
    notificationTemplateName: emaildemo
    targetPath: body
    subjectTargetPath: subject
  - type: GetRtEntitiesById@1 # Get the customer entity
    ckTypeId: OctoSdkDemo/Customer
    rtIds:
      - 673b5e451c7375d2ea2bec85
    targetPath: $.customer
  - type: GetQueryById@1 # Get the query result
    targetPath: $.query
    queryRtId: 673b5c06de73e7b1755754e4
  - type: QueryResultToMarkdownTable@1 # Convert the query result to a Markdown table
    path: $.query
    targetPath: $.table
  - type: PlaceholderReplace@1 # Replace placeholders in the notification template
    replaceRules:
      - placeholder: tableData
        path: $.table
      - placeholder: firstName
        path: $.customer.Attributes.FirstName
      - placeholder: lastName
        path: $.customer.Attributes.LastName
    path: $.body
    targetPath: $.resultBody
  - type: SetPrimitiveValue@1 # Set the email address
    value: "demo@demo.com"
    targetPath: $.to
  - type: SendEMail@1 # Send the email
    serverConfiguration: smtptest
    subjectPath: $.subject
    path: $.resultBody
    toPath: $.to

Hinweise:

  • Sie können für CC- und BCC-Adressen sowohl den pfadbasierten als auch den statischen Listenansatz verwenden.
  • Wenn sowohl attachmentRtId als auch attachmentRtIdPath angegeben sind, verwendet der Node den Wert aus dem Payload-Pfad.
  • Wenn attachmentFileName oder attachmentContentType nicht angegeben ist, werden Standardwerte verwendet oder ein Fehler wird protokolliert.