Durchsuchbare Dokumentation aufrufen

Zurück zur Dokumentationsübersicht

E-Mail: Erstellen und versenden

Interne ID: agorum.mail.create

Mit diesem Knoten erstellen Sie eine neue E-Mail und speichern diese entweder als Entwurf ab oder versenden sie direkt. Hierzu verwendet der Knoten die Parameter, die im Datenobjekt der Datenvariable angegeben wurden.

Aussehen des Knotens

Verhaltensweise

Erreicht das System den Knoten, führt es zunächst eine strikte Validierung der übergebenen Parameter durch. Hierbei wird geprüft, ob die Datentypen der angegebenen Daten stimmen und ob alle Informationen vorhanden sind, die für den E-Mail-Versand benötigt werden. Sofern die Validierung erfolgreich ist, wird im Anschluss durch die JavaScript-Bibliothek common/mail der Entwurf gespeichert oder die E-Mail versandt (je nach gesetztem Parameter). Andernfalls erzeugt die Validierung eine Fehlermeldung.

Das erzeugte E-Mail-Objekt wird als Array in der Ergebnisvariable zurückgegeben.

Folgenden Angaben sind für den E-Mail-Versand verpflichtend:

Endpoints

Standard Veränderbar? Weitere Endpoints möglich?
Default (Inlet) Nein, kann nur ausgeblendet werden. nicht nötig
Default (Outlet) Nein, kann nur ausgeblendet werden. nicht nötig

Parameter

Parameter Beschreibung Beispiel
Als Entwurf speichern E-Mail als Entwurf speichern (Haken gesetzt)
Legt die E-Mails als Entwurf im E-Mail-Ordner Entwürfe ab. Sie müssen die E-Mails anschließend manuell versenden.

E-Mail direkt versenden (Haken nicht gesetzt)
(Standard) Versendet E-Mails direkt.		 –
Datenvariable Definiert die Variable, in der das Datenobjekt liegt, aus dem die E-Mail-Knoten alle nötigen Parameter erhalten, um die E-Mail zu verarbeiten.
  • Das Parameterobjekt besteht aus den gleichen Parametern, wie sie auch in der JavaScript-Bibliothek common/mail verwendet werden.
  • Der Parameter attachments wird über die Eingangsvariable des jeweiligen Knotens abgebildet.
 Datenvariable
Eingangsvariable Definiert ein Array von Elementen, die mit diesem Knoten verarbeitet werden.

Wenn Sie die Variable nicht angeben, verwendet das System automatisch die Anhänge des Workflows aus der internen Variable sys_acw_attachments.		 Eingangsvariable
Ergebnisvariable Definiert die Variable, in der das Ergebnis des Knotens enthalten ist, in diesem Fall ein Array mit der UUID des erzeugten E-Mail-Objekts.

Wenn Sie die Variable nicht angeben, wird das Ergebnis nicht im Token abgelegt.		 Ergebnisvariable

Datenvariable

Für generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen.


Im Editor

Im Editor geben Sie den Namen der Workflow-Variable an. Das System platziert die Variable automatisch in der Variable des Tokens (token.variables).Das Datenobjekt mit den darin enthaltenen Parametern erstellen Sie über den Knoten E-Mail: Daten vorbereiten. 

mail.data


Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, von der das System den eigentlichen Namen der gewünschten Variable lesen soll.

'token.variables.' + 'mail.' + 'data'
'token.variables.mail.data'

Das Ergebnis der Expression lautet jeweils:

'token.variables.nameOfMailData'

Der Inhalt der angegebenen Variable wird für die Verarbeitung von diesem Knoten verwendet.


Aufbau des Datenobjekts

variables: {
   ...
   sys_acw_attachments: [],

mail: {
      data: {
         from: 'user@your.domain', // Absender-Adresse
         to: [ 'to@your.domain' ],  // Array der Empfänger-Adressen
         cc: [ 'cc@your.domain' ], // Array der CC-Empfänger-Adressen
         bcc: [ 'bcc@your.domain' ], // Array der BCC-Empfänger-Adressen
         subject: 'Betreff',
         body: 'Mail-Inhalt, auf mit HTML möglich',
      
         replyTo: 'antwort@your.domain',

         // Absender der Mail, Beispiel: objects.find('user:demo')
         user: <agorum user>,

         // RFC822MessageId der E-Mail, auf die geantwortet wurde
         inReplyTo: 'b290204d-3b19-4332-9926-95521537cce9@your.domain'
      }
​​​​​​   },
   ...
​​​​}

Eingangsvariable

Für generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen.


Im Editor

Im Editor geben Sie den Namen der Workflow-Variable an. Das System platziert die Variable automatisch in der Variable des Tokens (token.variables).

inputVariable


Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, von der das System den eigentlichen Namen der gewünschten Variable lesen soll.

'token.variables.nameOfInputVariable'

Ergebnisvariable

Für generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen.


Im Editor

Im Editor geben Sie den Namen der Workflow-Variable an. Das System platziert die Variable automatisch in der Variable des Tokens (token.variables).

resultVariable


Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, von der das System den eigentlichen Namen der gewünschten Variable lesen soll.

'token.variables.nameOfResultVariable'