Stella CRM - Mailissa Connector#
Beschreibung#
Der Mailissa Domino Connector ermöglicht die Übertragung von Mails aus Microsoft Outlook heraus in eine beliebige Domino-Anwendung. Ziel des Connectors ist dabei die einfache Konfiguration dieser Verbindungen mittels Konfigurationsmasken ohne Programmierung. Die spezielle Ausprägung des Connectors fur das Stella CRM ist eine stark vereinfachte Variante, die wirklich nur die Mail an ein vordefiniertes Ziel überträgt. Sämtliche Logik danach findet auf der CRM Seite statt.
Server-Einrichtung#
Der Mailissa Connector ist eine HCL Notes-Anwendung, die auf einem Domino Server eingerichtet werden muss. Der Server muss dazu speziell konfiguriert werden, da der Connector eine spezielle Java-Library benutzt, die sonst nicht geladen werden kann. Dazu muss auf dem Server die Java Security angepasst werden. Je nach Version passiert dies auf unterschiedliche Weise.
Anpassung im Detail#
Folgende Zeile muss der java.policy bzw. java.pol hinzugefügt werden:
grant { permission java.security.AllPermission; };
Die Anpassung kann direkt in java.policy erfolgen, jedoch muss beachtet werden, dass diese Datei bei einem Serverupdate überschrieben wird und die Anpassung erneut durchgeführt werden muss. Alternativ kann eine java.pol generiert und die Zeile dort hinzugefügt werden.
Zusätzlich dazu gibt es auf Linux-Maschinen einen noch eleganteren Weg: für den Nutzer notes legt man im Home-Verzeichnis eine Datei .java.policy mit dem o.g. Inhalt an. Diese wird ebenfalls bei Updates nicht mehr verändert.
Nach der Änderung muss der HTTP Task mit restart task http komplett neugestartet werden.
Domino bis Version 12#
Die o.g. Datei findet man im Verzeichnis <DOMINO_BIN>/jvm/lib/security. Die Anpassung erfolgt dann wie oben beschrieben.
Domino ab Version 14#
Ab dieser Version befindet sich die "normale" Datei in <DOMINO_BIN>/jvm/conf/security. Alternativ kann wie oben beschrieben auch im Home-Verzeichnis gearbeitet werden.
Einrichtung der Anwendung#
Die Einrichtung des Connectors als Notes-Anwendung erfolgt wie gewohnt. Die ACL erfordert keine Rollen, lediglich der Default-Zugriff muss mindestens Autor betragen, damit Logs auch im Nutzer-Kontext erzeugt werden können. Weitere Zugriffsrechte z.B. für Administratoren sind empfohlen, aber optional.
Der Connector im Detail#
Der Zugriff auf den Connector zur Konfiguration und zum Debuggen erfolgt über den Notes Client.
Die Anwendung stellt sich wie folgt dar:
Navigation#
Die Navigation befindet sich links und ist in zwei Bereiche eingeteilt:
Connector#
In diesem Bereich werden die Datenverbindungen (Database Connections), die Datenquellen (View Configurations) sowie mehrsprachige Elemente (Localizations) eingerichtet.
Datenverbindungen#
Für den Betrieb mit dem Stella CRM ist nur eine Database Connection erforderlich. Die Abbildung zeigt eine Konfiguration, die für Stella CRM benötigt wird. Es können aber auch mehrere Verbindungen definiert werden. Dies würde es erlauben, eine Mail auch an verschiedene Datenbanken zu übertragen.
| Feld | Beschreibung | Vorgabewert / Empfohlener Wert |
|---|---|---|
| Database Connection | ||
| Unique Key | Eindeutiger Bezeichner der Verbindung | CRM |
| Category | Kategorie für die Verbindung, sinnvoll, wenn es sehr viele davon gibt | CRM |
| Title | Titel der Verbindung, sichtbar für den Nutzer | Mail übertragen |
| Server | Server der Ziel-Datenbank | |
| Full Path | Pfad zur Ziel-Datenbank | |
| Enabled | Verbindung aktiviert oder deaktiviert | |
| Read Access | per Namensauswahl kann die Sichtbarkeit dieser Verbindung gesteuert werden | - |
| Mapping | leer lassen für Vorgabe-Feldnamen | |
| Form | Form-Feld | gen_email |
| From | Absender | - |
| Subject | Betreff | - |
| SendTo | Empfänger | SendToExtern |
| CopyTo | Kopie | CopyToExtern |
| BlindCopyTo | Blindkopie | BCCme |
| Attachments | Anhänge | - |
| Body | Mailtext | - |
| Body2 | alternativer Mailtext | - |
| PostedDate | Sendedatum | - |
| DeliveredDate | Lieferdatum | - |
| Relation / Agent | ||
| Stella CRM Workflow ID | 16-stellige DocID des Workflows | Stella CRM ID des Workflows "CRM Document" |
| Field name where related document UNID is stored | ||
| Execute Agent (Name or Alias) | Name oder Alias des Agenten, der die eigentliche Logik bei der Zuordnung und Speicherung der Mail in der Ziel-Datenbank übernimmt |
Datenquellen#
Für den Betrieb mit dem Stella CRM ist nur eine Database Connection erforderlich, es wird keine View Configuration benötigt.
Darüber hinaus ist eine Datenquelle immer erforderlich. Diese ermöglicht während der Zuordnung die Auswahl eines Dokuments aus einer Notes-Datenbank, zu dem die gewählte Mail zugeordnet wird. Auch die Suche über eine Dokumentenmenge ist damit dann möglich.
Anmerkung
Nicht-Lokalisierte Werte werden in der Vorgabesprache englisch interpretiert, es kann aber auch generell eine andere Sprache als Vorgabe definiert sein.
| Feld | Beschreibung | Vorgabewert / Empfohlener Wert |
|---|---|---|
| Database Connection Key | Name der Datenquelle | Kann ausgewählt werden |
| Display Name | Anzeigename im Connector Add-In | - |
| View Name | Technischer Name der Notes-Ansicht | - |
| Column values in search result *) | Feldnamen bzw. Formeln, um ein Suchergebnis darzustellen | - |
| Column names for search result *) | Spaltenüberschriften für Suchergebnis | - |
| Fields to search in *) | Feldnamensliste, in denen gesucht werden soll | - |
| Summary | @Formel aus Feldwerten, um das gewählte Dokument zu beschreiben | - |
| Default View | Vorgabeansicht im Add-In | - |
Hinweis
*) Mehrfachwerte-Feld, pro Zeile ein Wert
Mehrsprachige Elemente#
Für den Betrieb mit dem Stella CRM ist zunächst keine Lokalisierung notwending.
Optional können für die Standardaktionen im Add-In hier weitere Bezeichnungen definiert werden. Das Schema ist dabei immer gleich, pro Zeile im jeweiligen Feld kann pro Sprache ein Begriff bzw. Bezeichnung definiert werden:
de~deutscher Text
fr~französischer Text
usw.
Zur Laufzweit wird dann die Nutzersprache in MS Outlook ermittelt und hier entsprechend der Text aus den Felder gelesen.
Logs#
Es gibt verschiedene Ansichten auf die Logmeldungen gruppiert nach Datum, Quelle oder Nutzer bzw. alle Meldungen in chronologischer Reihenfolge. Die Logs dienen dem technischen Personal zur Fehlerfindung.
Anwendungs-Konfiguration#
Dies ist die zentrale Konfiguration des Connectors insgesamt.
| Feld | Beschreibung | Vorgabewert / Empfohlener Wert |
|---|---|---|
| Domino Server | Aktueller Server, auf dem der Connector läuft | |
| Log Level | Loglevel für alle Logs | INFO |
| Remove Logs after / days | Logs entfernen nach X Tagen | 7 |
| Log Level for Notification | Loglevel, bei dem Benachrichtigt wird | ERROR |
| Notification E-Mail Address | Benachrichtigungsadresse | |
| Aveedo Instance | Server und Pfad zur Stella Aveedo Instanz | |
| Aveedo AppInstId | AppInstId der Stella CRM Anwendung | |
| Stella CRM Helper DB | Server und Pfad zur Stella Helper Anwendung | |
| Stella CRM Address DB | Server und Pfad zur Stella Adressen DB | |
| Stella CRM Documents DB | Server und Pfad zur Stella Dokumenten DB | |
| OCR Source Field for Mail | Quell-Feldname für Anhänge, die OCR-behandelt werden sollen | body |
| OCR Target Field for Mail | Ziel-Feldname für Anhänge, die OCR-behandelt werden sollen | attachments_ocr |
| Readers | optional, es wird generell die Stella Aveedo Security genutzt | |
| Authors | optional, es wird generell die Stella Aveedo Security genutzt |