E-Mail: Daten vorbereiten

Interne ID: agorum.mail.prepare

Sie können mit diesem Knoten das Datenobjekt für die folgenden E-Mail-Knoten über den Editor und mithilfe von Parametern konfigurieren:

Hierzu stellt der Knoten alle Parameter bereit, wie sie in der JavaScript-Bibliothek common/mail verwendet werden.

Aussehen des Knotens

Verhaltensweise

Erreicht das System den Knoten, wird aus den einzelnen Parametern des Knotens automatisch ein Datenobjekt erzeugt. Dieses Datenobjekt wird in die Datenvariable geschrieben und dient dann den anderen E-Mail-Knoten als Konfiguration. So lassen sich etwa Voreinstellungen vornehmen, die in einer nachfolgenden E-Mail-Maske übernommen und vom Benutzer durch die fehlenden Angaben ergänzt werden.

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
Absender	Definiert einen abweichenden agorum core-Benutzer, in dessen Namen die E-Mail später versendet wird. Dieser Benutzer ist Besitzer der E-Mail. Die E-Mail wird nach dem Versenden im Postausgang des gewählten Benutzers abgelegt. Wenn Sie den Parameter nicht angeben, wird automatisch der aktuell angemeldete Benutzer verwendet und in dessen Namen die E-Mail versendet.	Absender
E-Mail-Adresse des Absenders	Definiert, mit welcher E-Mail-Adresse die E-Mail versandt wird. Wenn Sie diesen Parameter nicht angeben, wird automatisch die E-Mail-Adresse des Benutzers verwendet, der die E-Mail versendet.	E-Mail-Adresse des Absenders
Empfänger	Definiert, wohin die E-Mail versandt wird. Sie können mehrere E-Mail-Adressen angeben. Sie müssen mindestens eine E-Mail-Adresse als Empfänger angeben, um eine E-Mail versenden zu können.	Empfänger
Empfänger (Kopie / CC)	Definiert, wohin eine Kopie der E-Mail versandt wird. Sie können mehrere E-Mail-Adressen angeben.	Empfänger (Kopie / CC)
Empfänger (Blind-Kopie / BCC)	Definiert, wohin eine Blind-Kopie der E-Mail versandt wird. Der Empfänger kann nicht nachvollziehen, an welche E-Mail-Adressen die E-Mail als Blind-Kopie geschickt wurde. Sie können mehrere E-Mail-Adressen angeben.	Empfänger (Blind-Kopie / BCC)
Antwort an	Definiert, an welche E-Mail-Adresse die Antworten auf die E-Mail gesendet wird. Hiermit ist die Antwort des Empfängers gemeint, d. h. wenn dieser auf eine von Ihnen versendete E-Mail antwortet. Wenn Sie diesen Parameter nicht angeben, gehen die Antworten automatisch an die E-Mail-Adresse des Absenders.	Antwort an
Betreff	Definiert den Betreff der E-Mail. Sie können eine E-Mail nicht ohne einen Betreff versenden.	Betreff
Inhalt	Definiert den Inhalt der E-Mail. Sie können den Inhalt entweder direkt als HTML-Code oder als Text angeben.	Inhalt
ID der ursprünglichen E-Mail	Referenziert auf eine zuvor eingegangene E-Mail. Der Empfänger kann hiermit die Antwort-E-Mail der ursprünglichen E-Mail zuordnen.	ID der ursprünglichen E-Mail
Datenvariable	Definiert, wo das Ergebnis des Knotens gespeichert wird. Dabei wird ein Datenobjekt erzeugt, das von den anderen E-Mail-Knoten verwendet werden kann. Die Angabe einer Datenvariable ist Pflicht.	Datenvariable

Absender

Im Editor

Der Editor zeigt eine Liste aller in agorum core angelegen Benutzer an. Wählen Sie einen Benutzer aus dieser Liste.

Als Expression

Wenn Sie diesen Parameter als Expression angeben, muss das Ergebnis eine eindeutige ID des Benutzers enthalten:

'user:roi'
'11000'
'714614d0-ce62-11e0-b47a-0800276e2399'

E-Mail-Adresse des Absenders

Im Editor

Im Editor geben Sie die E-Mail-Adresse des Absenders an, die für die E-Mail verwendet wird:

user@your.domain

Als Expression

Um die E-Mail-Adresse des Absenders dynamisch anpassen zu können, verwenden Sie die Expression. Dabei wird als Ergebnis ein String mit der zu nutzenden E-Mail-Adresse erwartet:

token.variables.mail.from

Das zugehörige Token könnte folgendermaßen aussehen:

variables: {
   ...
   sys_acw_attachments: [],
   mail: {
      from: 'user@your.domain',
      to: [ 'to@your.domain' ],
      cc: [ 'cc@your.domain' ],
      bcc: [ 'bcc@your.domain' ]
   },
   ...
}

Empfänger

Im Editor

Im Editor geben Sie eine E-Mail-Adresse oder mehrere E-Mail-Adressen an, an die die E-Mail versandt wird:

receiver_1@your.domain
receiver_2@your.domain

Als Expression

Um die E-Mail-Adressen dynamisch anpassen zu können, verwenden Sie die Expression. Dabei wird als Ergebnis ein Array der zu nutzenden E-Mail-Adressen erwartet, an die die E-Mail versandt werden soll:

token.variables.mail.to

Das zugehörige Token könnte folgendermaßen aussehen:

variables: {
   ...
   sys_acw_attachments: [],
   mail: {
      from: 'user@your.domain',
      to: [ 'to@your.domain' ],
      cc: [ 'cc@your.domain' ],
      bcc: [ 'bcc@your.domain' ]
   },
   ...
}

Empfänger (Kopie / CC)

Im Editor

Im Editor geben Sie eine E-Mail-Adresse oder mehrere E-Mail-Adressen an, an die die Kopie der E-Mail versandt wird:

receiver_1@your.domain
receiver_2@your.domain

Als Expression

Um die E-Mail-Adressen dynamisch anpassen zu können, verwenden Sie die Expression. Dabei wird als Ergebnis ein Array der zu nutzenden E-Mail-Adressen erwartet, an die die Kopie der E-Mail versandt werden soll:

token.variables.mail.cc

Das zugehörige Token könnte folgendermaßen aussehen:

variables: {
   ...
   sys_acw_attachments: [],
   mail: {
      from: 'user@your.domain',
      to: [ 'to@your.domain' ],
      cc: [ 'cc@your.domain' ],
      bcc: [ 'bcc@your.domain' ]
   },
   ...
}

Empfänger (Blind-Kopie / BCC)

Im Editor

Im Editor geben Sie eine E-Mail-Adresse oder mehrere E-Mail-Adressen an, an die die Blind-Kopie der E-Mail versandt wird:

receiver_1@your.domain
receiver_2@your.domain

Als Expression

Um die E-Mail-Adressen dynamisch anpassen zu können, verwenden Sie die Expression. Dabei wird als Ergebnis ein Array der zu nutzenden E-Mail-Adressen erwartet, an die die Blind-Kopie E-Mail versandt werden soll:

token.variables.mail.bcc

Das zugehörige Token könnte folgendermaßen aussehen:

variables: {
   ...
   sys_acw_attachments: [],
   mail: {
      from: 'user@your.domain',
      to: [ 'to@your.domain' ],
      cc: [ 'cc@your.domain' ],
      bcc: [ 'bcc@your.domain' ]
   },
   ...
}

Antwort an

Im Editor

Im Editor geben Sie eine E-Mail-Adresse an, an die die Antworten gesendet werden:

replyTo@your.domain
${mail.replyTo}

Als Expression

Um die E-Mail-Adresse dynamisch anpassen zu können, verwenden Sie die Expression. Dabei wird als Ergebnis ein String mit der zu nutzenden E-Mail-Adresse erwartet, an die die Antworten gesendet werden sollen:

token.variables.mail.replyTo

Das zugehörige Token könnte folgendermaßen aussehen:

variables: {
   ...
   sys_acw_attachments: [],
   mail: {
      from: 'user@your.domain',
      replyTo: 'replyTo@your.domain',
      inReplyTo: 'b290204d-3b19-4332-9926-95521537cce9@your.domain'
   },
   ...
}

Betreff

Im Editor

Im Editor formulieren Sie eine Betreffzeile, die für die ausgehende E-Mail verwendet wird:

Ihre Rechnung
Ihre Rechnung ${invoice.id}

Als Expression

Um den Betreff dynamisch anpassen zu können, verwenden Sie die Expression. Hierbei wird als Ergebnis ein String mit der Betreffzeile erwartet:

'Ihre Rechnung ' + token.variables.invoice.id

Inhalt

Im Editor

Im Editor geben Sie einen E-Mail-Text als HTML-Code oder als Text an. Den Inhalt können Sie um Variablen aus dem Workflow ergänzen, wie folgendes Beispiel zeigt. Für größere E-Mails erstellen Sie Vorlagen und legen Sie deren Inhalt vorab in einer Variable ab. Diese E-Mail-Vorlagen binden Sie mit einer Expression ein.

Sehr geehrte Damen und Herren,

anbei erhalten Sie Ihre Rechnung mit der Nummer ${invoice.id}.

Freundliche Grüße

Als Expression

Um den Inhalt dynamisch anpassen zu können und etwa E-Mail-Vorlagen zu verwenden, verwenden Sie die Expression. Hierbei wird als Ergebnis ein String mit dem Inhalt der E-Mail erwartet. Der String darf HTML-Code enthalten:

token.variables.invoice.mailTemplate

Das zugehörige Token könnte folgendermaßen aussehen:

variables: {
   ...
   sys_acw_attachments: [],
   invoice: {
      id: 'RE20210001', 
      mailTemplate: '<p>Sehr geehrte Damen und Herren,</p><p>anbei erhalten Sie Ihre Rechnung mit der Nummer ${invoice.id}.</p><p>Freundliche Gr&uuml;&szlig;e</p>'
   }, 
   ...
}

ID der ursprünglichen E-Mail

Im Editor

Im Editor geben Sie die ID der ursprünglichen E-Mail an, sofern Sie nicht auf Workflow-Variablen zurückgreifen können. Da die ID der ursprünglichen E-Mail für jede E-Mail eindeutig ist, stellt der Editor hier nur durch Nutzung von Workflow-Variablen sinnvolle Werte zur Verfügung:

b290204d-3b19-4332-9926-95521537cce9@your.domain
${mail.inReplyTo}

Als Expression

Um die ID der ursprünglichen E-Mail dynamisch anpassen zu können, verwenden Sie die Expression. Dabei wird als Ergebnis ein String erwartet:

token.variables.mail.inReplyTo

Das zugehörige Token könnte folgendermaßen aussehen:

variables: {
   ...
   sys_acw_attachments: [],
   mail: {
      from: 'user@your.domain',
      replyTo: 'replyTo@your.domain',
      inReplyTo: 'b290204d-3b19-4332-9926-95521537cce9@your.domain'
   },
   ...
}

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).

dataVariable

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.nameOfDataVariable'