E-Mail-Maske konfigurieren

Diese Dokumentation beschreibt das benutzerspezifische Konfigurieren von E-Mail-Masken und enthält Folgendes:

Aktionen der E-Mail-Maske konfigurieren
Automatisches Einfügen eines Paragrafen konfigurieren
Verhalten beim Ausführen der Aktionen Antworten und Allen Antworten konfigurieren

Hinweis: Diese Dokumentation erklärt mögliche Konfigurationen anhand von Beispielen. Die Werte sind beliebig anpassbar und dienen lediglich als Orientierung.

Aktionen der E-Mail-Maske konfigurieren

Sie konfigurieren die Aktionen der E-Mail-Maske benutzerspezifisch. Dabei können Sie etwa die Senden-Schaltfläche oder das Aktionsmenü anpassen, indem Sie es um Aktionen erweitern.

Ein Klick auf Senden könnte etwa die Aktionen Senden und ablegen bei Antwort und Senden an alle (intern) aufklappen.
Ein Klick auf in der E-Mail-Maske könnte etwa die Aktion Allen antworten mit Vorlage aufklappen.

Um die Aktionen der E-Mail-Maske zu konfigurieren, gehen Sie wie folgt vor.

Das JavaScript „reply-adress-handler-default.js“ kopieren

Im ersten Schritt kopieren Sie das JavaScript reply-adress-handler-default.js und fügen es in Ihr eigenes Konfigurationsprojekt ein, um das Skript danach anzupassen.

Öffnen Sie links in der Seitenleiste Explorer.

Öffnen Sie den Pfad:

Eigene Dateien/Administration/customers/agorum.mail/js/settings

Kopieren Sie das Skript reply-adress-handler-default.js und fügen Sie es in den Ordner js Ihres Konfigurationsprojekts ein.
Passen Sie die JavaScript-Datei nach Ihren Wünschen an.

Für mögliche Anpassungen mit Erklärungen siehe JavaScript-Beispiel zum Konfigurieren der Aktionen der E-Mail-Maske.
Speichern Sie die Datei.

Konfigurationen in der MetaDB vornehmen

Im zweiten Schritt legen Sie in der MetaDB im Property-Bundle agorum.mail eine benutzerspezifische Property-Gruppe, ein Property-Bundle sowie ein Property-Entry an. Im Property-Entry geben Sie anschließend den Pfad zum angepassten JavaScript an.

Öffnen Sie links in der Seitenleiste Administration und dann MetaDB.

Öffnen Sie den Pfad:

MAIN_MODULE_MANAGEMENT/customers/agorum.mail/settings

Legen Sie über eine Property-Gruppe an.
Tipp: Benennen Sie die Property-Gruppe nach folgender Struktur:
```
[ agorum-mail-sample-settings ]
```
Öffnen Sie die neue Property-Gruppe mit einem Doppelklick.
Legen Sie über ein Property-Bundle mit einem beliebigen Namen an.
Öffnen Sie das neue Property-Bundle mit einem Doppelklick.
Legen Sie über das Property-Entry js an.
Geben Sie im Feld Wert (String) den Pfad zum angepassten JavaScript reply-adress-handler-default.js an.
```
/agorum/roi/customers/agorum.mail/js/settings/sample-settings.js
```
Speichern Sie das Property-Entry.

Das automatische Einfügen eines Paragrafen konfigurieren

Über das Property-Entry UseParagraphFormat in der MetaDB konfigurieren Sie, ob beim Schreiben einer E-Mail bei der Betätigung der Entertaste ein Paragraf eingefügt werden soll.

Das Property-Entry „UseParagraphFormat“ konfigurieren

Öffnen Sie links in der Seitenleiste Administration und dann MetaDB.

Öffnen Sie den Pfad:

MAIN_MODULE_MANAGEMENT/customers/agorum.mail/defaults

Kopieren Sie das Property-Entry UseParagraphFormat.
Fügen Sie das kopierte Property-Entry im übergeordneten Property-Bundle agorum.mail ein.
Passen Sie den Wert (String) des Property-Entrys an.

true
Fügt bei Betätigung der Entertaste einen Paragrafen ein.

false
Fügt bei Betätigung der Entertaste einen Zeilenumbruch ein.
Speichern Sie das Property-Entry.

Den Style einer E-Mail anpassen

In agorum core verfasste E-Mails weisen im Standard einen bestimmten Style auf, der festlegt, wie E-Mails in agorum core und aufseiten des Empfängers aussehen (Schriftart, Schriftgröße).

Sie können diesen Style anpassen, wenn Ihnen der im Standard konfigurierte Style nicht zusagt. Die Einstellung dazu nehmen Sie in der MetaDB im Property-Entry BodyStyle vor.

Das Property-Entry „BodyStyle“ einstellen

Öffnen Sie links in der Seitenleiste Administration und dann MetaDB.

Öffnen Sie den Pfad:

MAIN_MODULE_MANAGEMENT/customers/agorum.mail/defaults

Kopieren Sie das Property-Entry BodyStyle.
Fügen Sie das kopierte Property-Entry im übergeordneten Property-Bundle agorum.mail ein.
Passen Sie den Wert (String) des Property-Entrys an.

• Fügen Sie keinen Zeilenumbruch ein.
• Die Zeile muss mit einem Semikolon enden.
• Verwenden Sie den Stil, wie er auch für Inline-HTML-Elemente verwendet wird.
Speichern Sie das Property-Entry.

Verhalten beim Ausführen der Aktion „Antworten“ oder „Allen Antworten“ konfigurieren

Sie können definieren, was passieren soll, wenn Sie die Aktion Antworten oder Allen Antworten ausführen. Dabei stellen Sie ein, welche Adressen das System vom Input im Output verwenden soll und welche nicht. Etwa, dass das System die im CC angegebenen Adressen beim Antworten auf eine E-Mail übernimmt, aber bestimmte Empfänger oder Doppelungen nicht im CC aufführt.

Beispiel

Sie erhalten folgende E-Mail:

Von: "roi" <roi@agorumcore.com>

An: "roi" <roi@agorumcore.com>

CC: "roi" <roi@agorumcore.com>, "demo demo" <demo@agorumcore.com>, "vb d4wdemo" <d4wdemo_vb@agorumcore.com>

Wenn Sie auf diese E-Mail antworten, wird roi nicht nochmals im CC aufgeführt, da er bereits im An-Feld steht:

Von: "roi" <roi@agorumcore.com>

An: "roi" <roi@agorumcore.com>

CC: "demo demo" <demo@agorumcore.com>, "vb d4wdemo" <d4wdemo_vb@agorumcore.com>

Um das Verhalten beim Ausführen der Aktion Antworten oder Allen Antworten zu konfigurieren, gehen Sie wie folgt vor.

Das JavaScript „reply-adress-handler“ kopieren

Im ersten Schritt kopieren Sie das JavaScript reply-adress-handler und fügen es in Ihr eigenes Konfigurationsprojekt ein, um das Skript danach anzupassen.

Öffnen Sie links in der Seitenleiste Explorer.

Öffnen Sie den Pfad:

Eigene Dateien/Administration/customers/agorum.mail/js/handler

Kopieren Sie das Skript reply-adress-handler.js und fügen Sie es in den Ordner js Ihres Konfigurationsprojekts ein.
Passen Sie die JavaScript-Datei nach Ihren Wünschen an.

Für mögliche Anpassungen mit Erklärungen siehe Inhalt des JavaScripts (Beispiel) und Parameter im JavaScript.
Speichern Sie die Datei.

Inhalt des JavaScripts (Beispiel)

let common = require('/agorum/roi/customers/agorum.mail/js/handler/common.js');

/**
 * handler for returning mail addresses in the wanted destination fields
 * 
 * this handler can be customized by defining a custom script in 
 *   MAIN_MODULE_MANAGEMENT/customers/agorum.mail/ReplyAllHandler
 *
 * input:
 *   {
 *     user: {
 *       value: '"Vorname Nachname" <vorname.nachname@email.de>',
 *       raw: 'vorname.nachname@email.de'
 *     },
 *     from: {
 *       value: '"Vorname Nachname" <vorname.nachname@email.de>',
 *       raw: 'vorname.nachname@email.de'
 *     },
 *     to: [
 *       {
 *         value: '"Fullname 1" <name.1@adomain.tld>',
 *         raw: 'name.1@adomain.tld'
 *       },
 *       {
 *         value: '"Fullname 2" <name.2@adomain.tld>',
 *         raw: 'name.2@adomain.tld'
 *       } 
 *     ],
 *     cc: [
 *       {
 *         value: '"Fullname 3" <name.3@adomain.tld>',
 *         raw: 'name.3@adomain.tld'
 *       } 
 *     ]
 *   }
 * ID: 822098425
 * return: ...
 * 
 */
module.exports = (input, replyAll) => {  
  let output = {};

  if (!replyAll) {
    if (input.from.raw === input.user.raw) {
      // is my mail
      output.to = common.filterDoubles((input.from && [ input.from ] || []).concat(input.to || []));      
      output.to = common.filter(output.to, input.user.raw);
    }
    else {
      // not from me
      output.to = [ input.from ];
    }
    return output;
  }
  
  // reply all
  // put all to in "to" field
  // put all cc in "cc" field
  output.to = common.filterDoubles((input.from && [ input.from ] || []).concat(input.to || []));
  output.cc = common.filterDoubles(input.cc);
  
  // filter out user (if there are more than 2 entries)
  output.to = common.filter(output.to, input.user.raw);
  output.cc = common.filter(output.cc, input.user.raw);
  
  return output;
};

Parameter im JavaScript

Folgende wichtige Parameter existieren.

input

Entspricht dem Input, d. h. den Daten der empfangenen E-Mail. Dabei können Sie den Input spezifizieren, sodass das System etwa nur die Adresse des Absenders ausgibt.

let common = require('/agorum/roi/customers/agorum.mail/js/handler/common.js');
...
 * input: // structure of the email addresses contained in the incoming email
 *   {
 *     user: {
 *       value: '"Vorname Nachname" <vorname.nachname@email.de>',
 *       raw: 'vorname.nachname@email.de'
 *     },
...
 * ID: 822098425
 * return:
...

input besitzt folgende Parameter:

Wert	Beschreibung
input.from	Vorname, Nachname und E-Mail-Adresse des Absenders der empfangenen E-Mail
input.user	Vorname, Nachname und E-Mail-Adresse des Benutzers der empfangenen E-Mail
input.to	Vorname, Nachname und E-Mail-Adresse des Empfängers der empfangenen E-Mail
input.cc	Vorname, Nachname und E-Mail-Adresse des CC-Empfängers der empfangenen E-Mail
input.from.raw	nur E-Mail-Adresse des Absenders von der empfangenen E-Mail
input.user.raw	nur E-Mail-Adresse des Benutzers von der empfangenen E-Mail
input.to.raw	nur E-Mail-Adresse des Empfängers von der empfangenen E-Mail
input.cc.raw	nur E-Mail-Adresse des CC-Empfängers von der empfangenen E-Mail

Sie können einen Input-Wert etwa verwenden, um ihn als neuen Output-Wert zu setzen:

output.cc = input.to

Beispiel

Sie erhalten eine E-Mail.

Von: roi@agorumcore.com

An: "vb d4wdemo" <d4wdemo_vb@agorumcore.com>, "demo demo" <demo@agorumcore.com>

Das System setzt die von der Ausgangs-E-Mail erhaltenen Empfänger-Adressen als CC für die Antwort-E-Mail:

Von: roi@agorumcore.com

An: roi@agorumcore.com

CC: "vb d4wdemo" <d4wdemo_vb@agorumcore.com>, "demo demo" <demo@agorumcore.com>

replyAll

Steht für die Funktion Allen Antworten, die Sie beim Versenden einer E-Mail über die Schaltfläche Allen Antworten wählen. Über den Parameter geben Sie an, was passiert, wenn Sie Allen Antworten wählen.

module.exports = (input, replyAll) => {

output

Entspricht dem Output, d. h. den Daten, die das System beim Schreiben einer neuen E-Mail versendet. Sie können etwa für den Output direkt die Werte aus dem Input setzen (wie beim Parameter input beschrieben) oder spezielle Filterungen vornehmen. Speziell können Sie etwa Doppelungen oder eine bestimmte Adresse herausfiltern, wie nachfolgend in den Beispielen beschrieben.

...
module.exports = (input, replyAll) => {  
  let output = {};

  if (!replyAll) {
    if (input.from.raw === input.user.raw) {
      // sender and user mail address are matching => is my mail
      output.to = common.filterDoubles((input.from && [ input.from ] || []).concat(input.to || [])); filter duplicate mail addresses
      output.to = common.filter(output.to, input.user.raw); // filter ou the user's mail address if it's set as new recipient address
    }
    else {
      // not from me
      output.to = [ input.from ]; // set mail of sender as recipient
    }
    return output;
  }
...
  output.cc = common.filterDoubles(input.cc); // filter out all duplicates of the cc recipients.
 
  // filter out user (if there are more than 2 entries)
  output.to = common.filter(output.to, input.user.raw); // filter out the users mail address if it corresponds to the recipient's e-mail address.
  output.cc = common.filter(output.cc, input.user.raw); // filter out the users mail address if it corresponds to the CC - recipient's e-mail address.
 
  return output;
};

output besitzt folgende Parameter:

Wert	Beschreibung
output.from	Vorname, Nachname und E-Mail-Adresse des Absenders für die neue E-Mail
output.user	Vorname, Nachname und E-Mail-Adresse des Benutzers für die neue E-Mail
output.to	Vorname, Nachname und E-Mail-Adresse des Empfängers für die neue E-Mail
output.cc	Vorname, Nachname und E-Mail-Adresse des CC-Empfängers für die neue E-Mail

Das Property-Entry „ReplyAdressHandler“ konfigurieren

Im zweiten Schritt konfigurieren Sie das Property-Entry ReplyAdressHandler. Im Property-Entry geben Sie anschließend den Pfad zum angepassten JavaScript an.

Öffnen Sie links in der Seitenleiste Administration und dann MetaDB.

Öffnen Sie den Pfad:

MAIN_MODULE_MANAGEMENT/customers/agorum.mail/defaults

Kopieren Sie das Property-Entry ReplyAdressHandler.
Fügen Sie das kopierten Property-Entry im übergeordneten Property-Bundle agorum.mail ein.
Bearbeiten Sie das Property-Entry ReplyAdressHandler durch einen Doppelklick.
Geben Sie im Feld Wert (String) den Pfad zum angepassten JavaScript reply-adress-handler an.
```
/agorum/roi/customers/agorum.mail/js/handler/reply-address-handler-default.js
```
Speichern Sie das Property-Entry.