agorum core mailadapter administrieren

Das Modul agorum core mailadapter holt E-Mails aus einem beliebigen E-Mail-Postfach automatisch in bestimmten Intervallen oder per manuellem Abruf per IMAP ab und archiviert diese E-Mails in agorum core.

Hinweis: POP3 wird als Abruf nicht unterstützt.

Voraussetzungen zur Benutzung

Sie benötigen agorum core pro.
Die Verbindung über IMAP benötigt in der Regel ein SSL-Zertifikat. Dieses müssen Sie zuerst einrichten. Wurde das SSL-Zertifikat nicht eingerichtet, kann es zu Fehlern im agorum core support tool kommen. Diese sind zum Teil erkennbar an der Fehlermeldung root cause ssl handshake.
Aktivieren Sie das Modul zuvor über das agorum core support tool.
Starten Sie agorum core nach der Aktivierung des Moduls neu.

Icons

Diese Icons begegnen Ihnen in agorum core, wenn Sie mit E-Mail-Adaptern arbeiten:

E-Mail-Adapter

E-Mail-Adapter-Status: noch nicht synchronisiert

E-Mail-Adapter-Status: synchronisiert

E-Mail-Adapter-Status: wird gerade synchronisiert

Einen E-Mail-Adapter anlegen

Idealerweise benötigen Sie nur einen E-Mail-Adapter, der auf ein dediziertes Postfach zugreift, in dem alle relevanten E-Mails kumuliert werden (Journaling-Weiterleitung in ein bestimmtes Postfach). Diese E-Mails können anhand von E-Mail-Inhalten, Betreff, Absender oder Empfänger durch einen zusätzlichen Automatismus im System in eine finale Ordnerstruktur archiviert werden.

Öffnen Sie links in der Seitenleiste Explorer.
Öffnen Sie den Ordner Dateien.
Legen Sie über die rechte Maustaste (Kontextmenü) einen neuen Ordner an, etwa:
```
E-Mail-Adapter
```
Öffnen Sie diesen Ordner.
Klicken Sie auf die rechte Maustaste.
Wählen Sie im Kontextmenü Neu > Adapter > E-Mail-Adapter.
Geben Sie die Daten zum E-Mail-Adapter ein.

Hinweis: Klicken Sie nicht auf Speichern, sondern folgen Sie den Anweisungen unter Verbindung testen und Ordner abrufen.

Daten zum E-Mail-Adapter eingeben

Feld	Beschreibung
Name	Definiert den Namen des E-Mail-Adapters.
Server-Typ	Definiert den Server-Typ.
E-Mail-Host	Definiert die Netzwerk-Adresse des Servers.
E-Mail-Pfad	Definiert den Ordner unterhalb des Postfachs, ab dem das System E-Mails synchronisiert. Beispiele: Eingabe zur Synchronisation des gesamten Postfachs: / Den Ordner dms synchronisieren: dms Den Ordner Rechnungen im Ordner dms synchronisieren: dms/Rechnungen Eine Liste verfügbarer Ordner erscheint, wenn Sie rechts die Verbindung testen und die Ordner vom Server herunterladen. Alternativ können Sie manuell einen bekannten Pfad angeben.
E-Mail-Benutzer	Definiert den Benutzernamen zur Anmeldung am Postfach.
E-Mail-Passwort	Definiert das Passwort zur Anmeldung des Benutzers am Postfach.
E-Mails nicht löschen	Definiert, ob das System die E-Mails nach Abruf auf dem E-Mail-Server löscht. Hinweise: Deaktivieren Sie diese Einstellung nur für temporäre Tests, nicht für den produktiven Betrieb. Löschen Sie regelmäßig E-Mails auf dem E-Mail-Server, damit der E-Mail-Server nicht überläuft.
Abgleich-Intervall (in Minuten)	Definiert in Minuten, wie oft das System E-Mails abruft (0 = keine automatische Synchronisation).
Abgleich-Zeitpunkt	Definiert, zu welchem Zeitpunkt das System E-Mails abruft. Es handelt sich hierbei lediglich um eine Referenz, d. h. der Abruf erfolgt nicht erst zum festgelegten Zeitpunkt, sondern auch schon vorher. Beispiel: Ausgewählter Zeitpunkt 0:00 Uhr und Intervall 60 Minuten Der Abruf erfolgt um 00:00 Uhr und danach um 01:00 Uhr, 02:00 Uhr usw. Wenn Sie ein Intervall größer als 0 angegeben haben (= E-Mail-Adapter ist aktiv), holt er allerdings auch schon vor 00:00 Uhr E-Mails jede Stunde ab.
Beschreibung	Definiert eine beliebige Beschreibung des E-Mail-Adapters.
Testeingabe	Ermöglicht es, erstellte Filter zu testen.

Einen Filter anlegen und testen (Regular Expressions)

Beim Eingeben der Daten zum E-Mail-Adapter können Sie im Abschnitt Filter eigene Filter erstellen, um den Abruf von E-Mails auf bestimmte Dinge einzuschränken, etwa auf den Betreff einer E-Mail oder auf die Empfängeradresse. Diese Einschränkung erfolgt mithilfe von Regular Expressions (RegExp).

Beispiele

Ziel	Regular Expression
Nur E-Mails abrufen mit dem Betreff Rechnung	.Rechnung.
Nur E-Mails abrufen, die mit der Empfängeradresse (an) rechnung@agorum. versendet wurden	.rechnung@agorum.
Nur E-Mails abrufen, die NICHT mit der Absender-Adresse rechnung@agorum. versendet wurden	!.rechnung@agorum.

Sollten Sie mehrere Regular Expressions angeben, muss mindestens eine der Regular Expressions auf die E-Mail zutreffen, damit das System die E-Mail abruft.

Um die erstellten Filter zu testen, geben Sie den gewünschten Text im Feld Testeingabe ein.

Hinweis: Das Verwenden von Filtern entspricht nicht dem empfohlenen Vorgehen eines dedizierten E-Mail-Servers. Verwenden Sie stattdessen individuell erstellte Automatismen innerhalb von agorum core, die die importierten E-Mails final ablegen und Systemflags setzen.

Die Verbindung testen und Ordner abrufen

Nachdem Sie die Felder angegeben haben, testen Sie die Verbindung zum Postfach, um sicherzugehen, dass die Angaben korrekt sind.

Klicken Sie rechts neben den Feldern E-Mail-Benutzer und E-Mail-Passwort auf Verbindung testen.
Bestätigen Sie die Erfolgsmeldung.
Klicken Sie rechts neben dem Feld E-Mail-Pfad auf .

Ergebnis: Das System lädt einen kurzen Moment und zeigt danach die Pfade des Postfachs im Feld E-Mail-Pfad an. Suchen Sie hier einen Ordner, den Sie zukünftig abrufen möchten. Geben Sie / an, wenn alle Ordner abgerufen werden sollen.
Speichern Sie den E-Mail-Adapter.

Hinweis: Das System prüft bei der Funktion Verbindung testen nicht den E-Mail-Pfad, es erkennt also nicht einen falschen Pfad. agorum core synchronisiert keine E-Mails bei falscher Pfadangabe.

Nach dem Test können Sie die Ordner des Postfachs abrufen und auswählen, welche Ordner Sie zukünftig synchronisieren möchten (siehe Feld E-Mail-Pfad).

E-Mails manuell abrufen

Wenn Sie keinen automatischen Abruf beim Anlegen des E-Mail-Adapters eingestellt haben, können Sie alternativ E-Mails manuell abrufen.

Öffnen Sie im agorum core explorer den Pfad, unter dem Sie den E-Mail-Adapter angelegt haben.
Doppelklicken Sie auf den E-Mail-Adapter, um ihn zu öffnen.
Klicken Sie oben links auf .
Bestätigen Sie die Abfrage.

Ergebnis: Der Text neben dem Symbol wechselt von Sync (ist synchronisiert) zu Sync (synchronisiert gerade). Der Text wechselt wieder zu Sync (ist synchronisiert), sobald der Abruf abgeschlossen ist.

E-Mails manuell abrufen

Die finale E-Mail-Ablage sicherstellen

Nachdem Sie den E-Mail-Adapter angelegt haben, legt das System alle importierten E-Mails unterhalb von diesem ab:

Dateien/E-Mail-Adapter/<importierte E-Mails>

Die Dokumenten-Datenbank kann problemlos mit vielen Dokumenten unterhalb eines Ordners umgehen, Darstellungsoberflächen, etwa der agorum core explorer, jedoch nicht. Legen Sie diese E-Mails aus dem E-Mail-Eingangsordner in ein finales Archiv ab.

Beispiele

Spricht Ihnen kein Modell zu, können Sie mit Unterstützung von JavaScript einen eigenen Archivierungsprozess etablieren, der auf den Volltext, Betreff, Absender oder die Empfänger der E-Mails eingeht. Sie können zudem jederzeit auf Ihren Ansprechpartner von agorum core zukommen, um eine individuelle Konfiguration anzufragen.

Einen E-Mail-Adapter deaktivieren

Sie können einen E-Mail-Adapter temporär deaktivieren, sodass das System keine E-Mails mehr abruft.

Öffnen Sie im agorum core explorer den Pfad, unter dem Sie den E-Mail-Adapter angelegt haben.
Doppelklicken Sie auf den E-Mail-Adapter, um ihn zu öffnen.
Klicken Sie rechts oben auf .
Setzen Sie ein # vor den E-Mail-Host.
Stellen Sie das Abgleich-Intervall auf 0 (Abgleich deaktiviert).
Speichern Sie die Änderungen.

Ergebnis: Sie haben den E-Mail-Adapter deaktiviert.

Entfernen Sie das # vor dem E-Mail-Host, um ihn zu aktivieren, und setzen Sie ein Abgleich-Intervall größer als 1.

Einen E-Mail-Adapter löschen

Sollten Sie einen E-Mail-Adapter zum Testen verwendet haben und benötigen Sie ihn nicht mehr, können Sie ihn löschen.

Öffnen Sie im agorum core explorer den Pfad, unter dem Sie den E-Mail-Adapter angelegt haben.
Markieren Sie den E-Mail-Adapter mit der rechten Maustaste.
Wählen Sie im Kontextmenü Administration > Löschen (ohne Papierkorb).
Bestätigen Sie die Abfrage.

Ergebnis: Sie haben den E-Mail-Adapter gelöscht.

Alle E-Mail-Adapter einsehen

Haben Sie mehrere E-Mail-Adapter erstellt, ist es oftmals nützlich, auf einen Blick alle erstellten E-Mail-Adapter im System einzusehen und wahlweise auch (einzeln) direkt zu bearbeiten.

Öffnen Sie links in der Seitenleiste Suche.
Wählen Sie im Suchergebnis den Filter Administration.
Aktivieren Sie links den Filter MailAdapter.

Ergebnis: Im Suchergebnis erscheinen alle erstellten E-Mail-Adapter.

Alle E-Mail-Adapter einsehen

• Klicken Sie auf einen E-Mail-Adapter, um ihn direkt zu bearbeiten.
• Die Farben im Suchergebnis beim Ordnersymbol signalisieren den Zustand des E-Mail-Adapters.

Zustand des E-Mail-Adapters

rot
Der E-Mail-Adapter synchronisiert gerade.

grün
Der E-Mail-Adapter ist mit der Synchronisation fertig.

grau
Der E-Mail-Adapter wurde noch nie synchronisiert.

Mit einem Microsoft 365-Konto (Office 365, Outlook.com) verbinden

Voraussetzungen

Der agorum core client ist installiert.
Der agorum core client lässt sich mit dem System verbinden, auf dem Sie das Konto einrichten möchten.

Legen Sie einen E-Mail-Adapter an oder bearbeiten Sie einen vorhandenen.
Klicken Sie auf Mit Microsoft 365 verbinden.

Ergebnis: Das Browserfenster für die Autorisierung des Zugriffs bei Microsoft öffnet sich.
Melden Sie sich mit dem gewünschten Konto an.
Bestätigen Sie die Abfrage des Browsers zum Start des agorum core clients.

Ergebnis: Das System füllt die Felder Server-Typ, E-Mail-Host und E-Mail-Passwort automatisch, wenn die Autorisierung erfolgreich ist.

Wenn Sie nach der Einrichtung Probleme mit E-Mails haben

Sollte der Abruf von E-Mails nach Einrichtung Probleme bereiten, finden Sie detaillierte Fehlermeldungen im agorum core support tool.

Öffnen Sie links in der Seitenleiste Weitere Apps und dann Support tool.
Wählen Sie links im Menü Ngfs Adapter > Sub Statistics > Mail Adapter.
Suchen Sie den Bereich Active Notifications nach Fehlermeldungen ab.

Fehlermeldung im agorum core support tool prüfen

Nachfolgend finden Sie eine Auflistung bekannter Fehlermeldungen oder Probleme sowie deren Lösungen.

MailAdapter: Connection failed for

Beschreibung des Problems

Beim Testen der Verbindung erscheint folgende Meldung:

MailAdapter: Connection failed for: ...
...
sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

Ursache

Im Truststore von agorum core konnte kein Zertifikat gefunden werden.

Lösung

Nehmen Sie das Zertifikat des E-Mail-Servers in den Truststore von agorum core auf oder tauschen Sie das Zertifikat aus, falls der Alias bereits enthalten ist.

Langsame Synchronisation

Eine langsame Synchronisation kann folgende Ursachen haben:

Die Verbindung zum E-Mail-Server ist sehr langsam
Öffnen Sie hierzu die Einstellungen des E-Mail-Adatpers und klicken Sie Verbindung testen. Erhalten Sie zügig eine Antwort, dass die Verbindung funktioniert, ist Ihre Netzwerkanbindung performant. Benötigt die Rückmeldung etwas Zeit, kann es etwa sein, dass Ihre Internetleitung etwas leistungsschwach ist, um auf einen externen E-Mail-Server oder Provider zuzugreifen.

agorum core ist sehr langsam
Stellen Sie fest, dass das System generell langsam arbeitet, starten Sie den Benchmark-Test im agorum core support tool. Damit können Sie gut abschätzen, ob Ihr System für grundlegende Funktionen wie das Anlegen oder Löschen von neuen Objekten lange braucht. Darunter fallen auch E-Mails. Sie können gerne Ihre Hardwareausstattung mit unseren Empfehlungen gegenprüfen.

Größe der E-Mails
Diese Information wird für Sie keine Überraschung sein, aber natürlich bestimmt auch die Größe einer E-Mail die Geschwindigkeit der Synchronisation. Sprechen wir von einer E-Mail mit wenig Text und keinen Anhängen? Oder dauert es lange bis E-Mails, die 50 Tage Verlauf sowie Dateianhänge beinhalten, importiert werden? Dies nimmt Einfluss auf die Übertragungs- und die Schreibzeit von agorum core.

E-Mail-Adapter verschiebt keine E-Mails

Beschreibung des Problems

Trotz erfolgreicher Synchronisation verschiebt der E-Mail-Adapter keine E-Mails.

Ursache

Eventuell sind die Angaben bei den Filtern (Regular Expressions) falsch eingestellt.

Lösung

Überprüfen Sie die angegebenen Regular Expressions.
Denken Sie an die richtige Schreibweise (.*Wort.*) von Regular Expressions.
Achten Sie darauf, dass die Regular Expressions sich nicht gegenseitig beeinflussen.

Authentifizierungsprobleme mit Office 365

Verwenden Sie den E-Mail-Adapter in Kombination mit dem E-Mail-Server in der Microsoft Cloud (Office 365), kann es zu Authentifizierungsproblemen durch das neueste Microsoft Update kommen.

Aktualisieren Sie in diesem Falle agorum core auf eine Version ab 10.4 oder 11.1, um das Konto an Office 365 anzubinden.

Übergangsweise befolgen Sie die Anweisungen in der Dokumentation Office 365-Umgebung für die Nutzung des E-Mail-Adapters in Zusammenhang mit MFA konfigurieren.