Inhalt/Content
Einführung
Mit der Systemkomponente novomind iMAIL4Letter kann die Eingangskorrespondenz im Kanal Brief, sowie die Ausgangskorrespondenz im Format PDF für die Kanäle Brief, aber auch E-Mail und Fax abgewickelt werden. Diese Anleitung beschreibt alle notwendigen Anpassungen, die nötig sind, um die Komponente novomind iMAIL4Letter zu konfigurieren. Benutzerhinweise für den Agenten finden Sie im Benutzerhandbuch novomind iAGENT Desk.
Prozesse stoppen (Beispiel Linux)
$ /srv/novomind/iAGENT/imail-system.sh stop |
Änderung der Feature-Bitmaske
Die spezifischen Antwortkanäle für die Briefbearbeitung – E-Mail (PDF) und Brief (PDF) – werden über eine Feature-Bitmaske mittels des Parameter Dimail.workflow.supportedFeatures gesetzt.
Die Werte für diesen Parameter dürfen nur von einem novomind Projektleiter verändert werden. Bitte nehmen Sie zu Ihrem Projektleiter Kontakt auf, um den Parameter für Ihr System anzupassen.
Jar-Dateien ablegen
Mit der Release-Umstellung auf Version 12 gibt es unterschiedliche Libraries, die abgelegt werden müssen. Die Libraries werden von novomind zur Verfügung gestellt (intern findet man sie in W:\ProductDevelopment\iAGENT_release\iMAIL4Letter\lib\).
iAGENT < 12:
- itextpdf-5.5.12.jar
- licensekey-1.0.2.jar
- pdfbox-2.0.15.jar
- pdfImpl.jar
- xmlworker-5.5.12.jar
iAGENT >= 12:
- ecom-iagent-imail-pdf.jar
- itextpdf-5.5.12.jar
- licensekey-1.0.2.jar
- pdfbox-2.0.15.jar
- xmlworker-5.5.12.jar
Zur Installation des Konvertierungstools für PDF-Dateien durch Libraries müssen die jar-Dateien jeweils in drei lib-Verzeichnissen hinterlegt werden (Beispiel für Standard-Installationsverzeichnis auf Linux):
Supervisor: /srv/novomind/iAGENT/tomcat/webappsiMail/iMail/WEB-INF/lib Agent: /srv/novomind/iAGENT/tomcat/webappsiMailAgent/agent/WEB-INF/lib Core: /srv/novomind/iAGENT/mail/lib
JPedal sollte nicht mehr genutzt werden, da dies ab iAGENT 11.32 nicht mehr funktioniert.
Ab einer iAGENT-Version 11.3x setzt der Routing-Prozess vom xmlworker eine Version 5.5.12 statt 5.5.9 voraus.
Für Projektleiter: Die iText-Lizenz (licensekey-xxx.jar) wird von IST (nicht aus Testlink) bereitgestellt, siehe unten.
Konfiguration der iText Lizenz
Neue Lizenzen werden bei novomind, Abteilung Infrastruktur (IST), beauftragt. IST stellt das itextkey.xml
sowie die License Key Library (licensekey-xxx.jar
) zur Verfügung.
Sobald dies geschehen ist, müssen die folgenden Punkte geprüft werden:
- Die Lizenz und Bibliothek muss allen 3 Prozessen (Agent, Routing, Core) vorliegen (Verzeichnispfade siehe oben).
- Die aktuellste iText Lizenz muss im Verzeichnis
/srv/novomind/iAGENT/mail
abgelegt werden. - (novomind intern) In iNSIDE muss das Feature iMail4Letter am Kundendatensatz aktiviert werden.
Danach wird die Datei nmIQMail.cfg
wie folgt konfiguriert:
|
Im Anschluss müssen im iAGENT-Installationsverzeichnis die folgenden Ordner angelegt werden:
|
Prozesse starten
|
Nachdem die Prozesse wieder gestartet wurden, sind die Logs von Routing, Agent und Core (routing.out, agent.out, imail.out) auf eine gleichartige Ausgabe zu prüfen:
|
Konfiguration der Wissensbasis
Folgende Schritte müssen für die Wissensbasis durchgeführt werden, damit im Supervisor PDF Templates hochgeladen werden können
- Die Wissensbasis muss über den Supervisor heruntergeladen werden.
- Es muss die globale String-Variable PDF_TEMPLATE angelegt und auf persistent gesetzt werden.
- Eine Funktion mit dem Namen determine_pdf_template muss angelegt werden. Die Funktion muss den Rückgabe-Typ „String“ haben. Die Funktion sollte aber leer bleiben (wird nachher von iAGENT anhand der Template-Zuordnung im Supervisor automatisch gefüllt).
- Im FINISH-Event muss die Variable PDF_TEMPLATE durch die Funktion determine_pdf_template gesetzt werden (z. B. dort wo auch TEMPLATE und CONFIRMATION definiert werden):
PDF_TEMPLATE = determine_pdf_template();
- Optional: PDF-Templates können jetzt schon im Verzeichnis TEMPLATE unterhalb der Wissensbasis-Verzeichnisstruktur abgelegt werden. Dies kann aber auch im Nachhinein über den Supervisor durchgeführt werden.
- Die angepasst Wissensbasis muss nun über den Composer exportiert, dann über den Supervisor hochgeladen und aktiviert werden. Danach ist im Supervisor unter Administration –> Antworten –> Vorlagen der Knoten PDF in der Baumansicht unter Datei zu finden. Die eventuell bereits im Composer kopierten PDF-Templates sollten jetzt dort sichtbar sein und können nun den Kategorien zugeordnet werden.