agorum core mailfilter administrieren

Mit dem Modul agorum core mailfilter steuern Sie, was mit einer eingehenden E-Mail passiert. Sie können E-Mail-Filter für bestimmte Situationen anlegen, anpassen und verwalten.

Einstellungen der E-Mail-Filter als Benutzer öffnen

1. Klicken Sie oben rechts in der Kopfleiste auf Ihr Profilbild.
2. Wählen Sie Einstellungen.
   
   Ergebnis: Ein Dialog öffnet sich.
3. Klicken Sie auf E-Mail-Filter-Einstellungen.
   
   Ergebnis: Ein Dialog öffnet sich.

Einstellungen der E-Mail-Filter öffnen

Einstellungen der E-Mail-Filter als Administrator öffnen

1. Öffnen Sie links in der Seitenleiste Mailfilter.
   
   Ergebnis: Die Oberfläche der E-Mail-Filter öffnet sich.

Die Oberfläche der E-Mail-Filter-Einstellungen

Aufbau der Oberfläche

1. E-Mail-Filter löschen
2. Filter verwenden
3. Angelegte E-Mail-Filter einsehen
4. E-Mail-Filter anlegen
5. E-Mail-Filter bearbeiten

Einen E-Mail-Filter anlegen

1. Klicken Sie auf das Plus-Symbol  in der oberen Leiste.
2. Geben Sie die Daten zum Anpassen des E-Mail-Filters ein.

Daten zum E-Mail-Filter eingeben

Daten zum E-Mail-Filter eingeben

Einen ​​​​Filter anlegen und testen (Regular Expressions)

Im linken Bereich Filter filtern Sie nach spezifischen Bestandteilen einer E-Mail, etwa einem bestimmten Betreff, in Form einer:

• einfachen Schreibweise ohne Regular Expressions (RegExp)
• einer komplexeren Schreibweise mit Regular Expressions

• Geben Sie den gewünschten Text im Feld Testeingabe ein, um die erstellten Filter zu testen.
• Das System filtert mithilfe von Regular Expressions, wenn Sie die Einstellung ist RegExp auswählen.

Beispiel

Im Beispiel wird mithilfe einer Regular Expression nach Adressen mit rechnung@agorum gefiltert, die entweder auf .de oder .com enden.

Übereinstimmender Ausdruck

Übereinstimmender Ausdruck

In dieser Abbildung stimmt die Testeingabe mit dem im Filter angegebenen Kriterium überein, da eine zugelassene Endung (.com) verwendet wurde.

Nicht übereinstimmender Ausdruck

Nicht übereinstimmender Ausdruck

In dieser Abbildung stimmt die Testeingabe mit dem im Filter angegebenen Kriterium nicht überein, da eine unzulässige Endung (.org) verwendet wurde.

Aktionen des E-Mail-Filters

Im Bereich Aktion ausführen können Sie verschiedene Aktionen für einen E-Mail-Filter einstellen:

• E-Mail verschieben (gilt auch für ausgehende E-Mails)
• E-Mail löschen
• Antwort zurücksenden
• E-Mail weiterleiten
• An Workflow senden (gilt auch für ausgehende E-Mails)
• JavaScript ausführen

E-Mail verschieben (gilt auch für ausgehende E-Mails)

E-Mail löschen

Löscht die E-Mail endgültig.

Antwort zurücksenden

E-Mail weiterleiten

An Workflow senden (gilt auch für ausgehende E-Mails)

JavaScript ausführen

​​​​Ein Vorlagentemplate anlegen

Sie können ein Vorlagentemplate für automatische Antwort-E-Mails anlegen.

1. Erstellen Sie eine HTML-Datei mit einem Antworttext.
2. Legen Sie die HTML-Datei in den Ordner templates-auto-reply unter:

   Eigene Dateien/Administration/workspace/agorum.mail.filter

   Tipps:
   • Legen Sie ein Template in einen Unterordner, können Sie diesem Unterordner eine Berechtigung zuweisen.
   • Durch Zuweisung von Berechtigungen steuern Sie, welcher Benutzer welches Template verwenden darf.

Beispiel

Diese Abbildung zeigt ein Template mit Platzhaltern:

Vorlagentemplate für automatische Antwort-E-Mail mit Platzhaltern

​JavaScript im E-Mail-Filter

Sie können in einem E-Mail-Filter ein JavaScript ausführen, um bestimmte Folgeaktionen herbeizuführen.

Aufbau des JavaScripts

/* global Packages, sc, sca, object */

Der Parameter object steht für die E-Mail.

Beispiel

Dieses Beispiel zeigt ein JavaScript, bei dem das System an die E-Mail (object) eine Notiz (note) hängt.

/* global Packages, sc, sca, object */

let objects = require('common/objects');

let note = 'Das ist eine Text-Notiz\nzum Testen';

objects.create('note', {
  content: note,
  target: object,  // Die E-Mail
  // noteFormat: 'text/html',
  recipients: [  ]  // keine Empfänger setzen, da nur als Info
});

Eigene Dateien/Administration/customers/agorum.mail.filter/js/test

Einen E-Mail-Filter bearbeiten

1. Markieren Sie den zu bearbeitenden E-Mail-Filter und klicken Sie auf das Stift-Symbol  in der oberen rechten Leiste.
   
   Ergebnis: Ein Dialog öffnet sich.

   Hinweise:
   • Sie können den Benutzer nicht ändern.
   • Wenn Sie einen anderen Benutzer wählen möchten, legen Sie einen neuen E-Mail-Filter an. 

Einen E-Mail-Filter löschen

1. Wählen Sie den entsprechenden E-Mail-Filter aus und klicken Sie auf das Löschen-Symbol  in der oberen linken Leiste.
2. Bestätigen Sie die Abfrage.
   
   Ergebnis: Das System löscht den E-Mail-Filter.

   Hinweis: Der E-Mail-Filter landet beim Löschen nicht im Serverpapierkorb.

Filter verwenden

Möchten Sie nur bestimmte E-Mail-Filter einsehen, etwa alle aktiven oder die eines bestimmten Benutzers, können Sie nach diesen filtern.

Filter

Es stehen folgende Filtergruppen zur Verfügung:

• E-Mail-Filter: Schränkt die Liste anhand der Eigenschaften eines E-Mail-Filters ein, etwa Meine Filter, Benutzer, Aktiv, Auf alle E-Mails, Globaler Filter oder Stop.
• Filterart: Schränkt die Liste anhand der konfigurierten Aktion ein, die beim Anlegen des E-Mail-Filters gewählt werden kann.

Einen angelegten E-Mail-Filter einsehen

In der Liste der angelegten E-Mail-Filter sehen Sie folgende Informationen:

• Name des E-Mail-Filters
• Beschreibung des E-Mail-Filters
• Besitzer des E-Mail-Filters
• Angabe, ob der E-Mail-Filter für alle E-Mails gilt
• Angabe, ob der E-Mail-Filter aktiv ist
• Angabe, ob der E-Mail-Filter global für alle Benutzer gilt
• Angabe, ob der E-Mail-Filter angehalten ist
• Letzte Änderung
• Zuletzt geändert durch
• Erstelldatum
• Ersteller

Die Bearbeitungsreihenfolge der E-Mail-Filter bestimmen

Mit den Pfeilen  neben dem Plus-Symbol  ordnen Sie die E-Mail-Filter an.

• Die Bearbeitungsreihenfolge der E-Mail-Filter erfolgt von oben nach unten. 
• Eine bestimmte Bearbeitungsreihenfolge ist wichtig, wenn Sie etwa einen E-Mail-Filter verwenden, der nachfolgende E-Mail-Filter stoppt.
• Sie können die Bearbeitungsreihenfolge nur ändern, wenn Sie nach einem einzelnen Benutzer filtern und alle angezeigten E-Mail-Filter genau diesem Benutzer zugeordnet sind.
• Ein Beispiel für die Festlegung der Bearbeitungsreihenfolge der E-Mail-Filter finden Sie unter Mit dem agorum core mailfilter arbeiten.

Einstellungen der E-Mail-Filter berechtigen

Mit ACLs passen Sie die Berechtigungen für das Einstellen von E-Mail-Filtern an.

So finden Sie die ACLs:

1. Öffnen Sie links in der Seitenleiste Administration und dann ACLs/Rechte.
2. Öffnen Sie den Pfad:

   Rechte(ACLs)/agorum.mail.filter

• Jede ACL enthält Benutzergruppen.
• In den Benutzergruppen passen Sie die Berechtigungen an. 
• Die Benutzergruppen der ACLs finden Sie in der Administration im Pfad:

Gruppen/agorum.mail.filter