SOG-Helpcenter Logo SOG Business - Software

Emailimport über den mailimporthandler


Abfragen von IMAP Mailboxen


Über p405 ist für jede abzufragende Mailbox (normalerweise nur eine!) ein Dienst vom Typ "mailimporthandler" zu konfigurieren.

Legen Sie die möglichen Parameter im p405 für den neuen Dienst wie folgt an:

Typ

mailimporthandler

StartComputer

Name des Computers, auf dem der Dienst starten soll, oder leer damit der Dienst überall starten kann.

RestartOnHotfix

ja: Der Dienst soll beendet und neu gestartet werden, wenn ein Hotfix mit einer entsprechenden Installationsaktion eingespielt wird.

Bezeichnung

Beschreibung des Dienstes

 

 

Servername

Name des Email-Servers

 

Port

Netzwerkport auf dem der Pop3-Dienst läuft (Standard: 110)

 

PasswortKey

Name des Passwort-Eintrags, der fpr die Verbindung genutzt wird.

Verweist auf die Funktion pwdsu.

Hinterlegen Sie dort als Benutzername den Namen der Mailbox und als Kennwort das Email-Kennwort.

 

Security

Genutzte Verschlüsselung. Empfohlen: Auto

 

MailTimeout

Anzahl Sekunden für die Timeout-Behandlung beim Abfragen des Mailserver.

 

FolderName

Name des abzufragenden Email-Ordners.

 

 

DienstID

Eindeutiger Dienste-Name. Mit diesem Namen werden Einträge in der Datenbank gespeichert.

 

DeleteMode

Modus für das Löschen von verarbeiteten Emails. HardDelete: Email nicht in einen "Gelöscht" Ordner verschieben.

(Nur falls der EmailServer diese Option unterstützt)

 

ImportMode

Assignment: Die Automatik entscheidet, welchem Sachbearbeiter eine Email zuzuordnen ist.

ForwardMode: Die Email wird dem absendenden Sachbearbeiter zugeordnet.

Archive: Eingehende Email wird nur im Archive abgelegt.

 

Fehlversuche

Anzahl Wiederholungen beim fehlerhaften Import einer Email. Wird die Anzahl überschritten, wird die Email nicht erneut verarbeitet.

 

Days

Anzahl Tage, nach der die Nachricht vom Server gelöscht wird.

 

AssignmentNoSach

true: Es wird nicht versucht, automatisch einen zuständigen Sachbearbeiter zu ermitteln. Stattdessen wird die erzeugte Aufgabe immer dem Standardsachbearbeiter zugeordnet.

 

AssignmentSach

Standardsachbearbeiter, dem die neu erzeugte Aufgabe zugeordnet wird.

AssignmentSeen

Gesehen-Markierung für neue Aufgabe. Standard: !

AssignmentType

Kennzeichen der neu erzeugten Aufgabe (Datenfeld m_kz)

 

AufgabenPresetId

Id eines Aufgabenpreset, dass als Vorlage für die neu erzeugte Aufgabe dienen soll.

 

AssignmentAutoCallIgnoreList

Datei mit Liste von Email-Domains oder Absendern, die ignoriert werden sollen.

 

IgnoreDoms

Mit Komma separierte Liste von Email-Domains die ignoriert werden sollen.

 

MapChar

Zeichen-Umsetzungstabelle für Betreff und Aufgabentext.

 

Bearbeiter

Legt den Inhalt des Datenfeldes "m_bearb" der neuen Aufgabe fest. 0: Keiner darf bearbeiten, 1: Ersteller darf bearbeiten, 2: Jeder darf bearbeiten

 

StandardReceiver

Satzart/Konto als Standardbezug zu einem Konto.

 

ExtractAttachments

true: Anhänge werden automatisch extrahiert und als Dokumente an die Aufgabe gehängt.

 

BackupSpam

Legt fest, ob ggf. eine als Spam erkannte Nachricht vor dem Löschen gesichert werden soll.

 

CheckSpam

Führt eine einfach SPAM-Erkennung durch. Dabei sollte eine entsprechende, vorgeschaltet Funktion Spam-Nachrichten mit einem Text im Email-Betreff kennzeichen, über diesen Schalter und eine entsprechende Konfigurationsdatei können entsprechend markierte Nachrichten automatisch erkannt und behandelt werden.

 

ForceArchive

true: Erzeugt einen Archiv-Datensatz, auch wenn die Aufgabe weitergeleitet wird.

 

Semaname

Semaphorenname für den Dienst. Verhindert, dass mehrere Handler gleichen Namens gestartet werden können.

 

SendCommitMail

true: Sendet eine Bestätigungsmail an den absendenden Sachbearbeiter. (Nur im Archiv-Modus)

 

SuppressAwZero

Bei einer Anrufbeantworter-Email wird eine führende "0" aus der erkannten Rufnummer entfernt. z.B. wenn der Anrufbeantworter an einer Nebenstelle läuft.

 

SuppressFaxZero

Bei einem eingehenden Fax wird eine führende "0" aus der erkannten Rufnummer entfernt. z.B. wenn das Fax an einer Nebenstelle läuft.

Forward-Mail-Modus


Der Verarbeitungsmodus "Forward-Mail" ist dafür gedacht, dass Benutzer Emails aus ihrem Email-System an ein definiertes Postfach "weiterleiten" können, und diese Mails nach dem Import in ihrem eigenen Aufgabensystem als Aufgabe erscheinen.

Dabei wird versucht, die Absender Emailadresse einem in SOG ERP (VACOS) vorhandenen Sachbearbeiter zuzuordnen. Schlägt dies fehl, wird die Aufgabe dem Standardsachbearbeiter zugeordnet.

Außerdem wird versucht, eine Kundenzuordnung der Email auf Basis von in dem Dokument gefundenen Email-Adressen durchzuführen. Dabei wird für die Zuordnung die erste gefundene Email-Adresse verwendet.

Der Automatismus der Sachbearbeiter- und Kundenzuordnung kann während der Weiterleitung durch zusätzliche Eingabe von Steuerinformationen beeinflusst werden. Dabei sind die Steuerinformationen in dem Format "@@Feld:Wert" jeweils als einzelne Zeilen im Kopf der Weiterleitungsmail zu schreiben.

Folgende Steuerangaben sind dabei möglich:

  @@sach:{Sachbearbeiterkürzel}

Über diese Angabe kann die erzeugte Aufgabe direkt einem bestimmten Sachbearbeiter zugeordnet werden.

  @@kto:{Anwahl}

Über diese Angabe wird die Aufgabe einem bestimmten Kunden zugeordnet. Als "Anwahl" kann das in SOG ERP (VACOS) übliche Kundenanwahlkriterium dienen. Allerdings muss ein eindeutiges Kriterium verwendet werden. Möglich sind hier: Kundennummer oder Matchcode (soweit eindeutig)

SPAM-Konfigurationsdatei


Wird die Option "CheckSpam" genutzt, versucht der Dienst auf Basis einer Konfigurationsdatei SPAM-Emails zu erkennen und gesondert zu behandeln. Die Konfigurationsdatei muss den Namen "Spam_cfg.xml" tragen, und über die FRMCFGPATH-Variable gefunden werden.

Sie hat folgenden Aufbau:

<?xml version="1.0" encoding="utf-8" ?>
<Config>
  <SpamEntry Text="XXXSPAM1XXX" Aktion="delete" />
  <SpamEntry Text="XXXSPAM2XXX" Aktion="setsach" Ziel="stolle" />
  <SpamEntry Text="XXXSPAM3XXX" Aktion="sendmail" Ziel="a.stolle@sog.de"
             Quelle="info@sog.de" Betreff="Spamweiterleitung"
             MailText="Die im Anhang befindliche Email wurde als Spam-Mail eingestuft."/>
</Config>

Text stellt einen in der Betreffzeile der Email zu suchenden Text dar. Dabei wird nicht zwischen Groß- und Kleinbuchstaben unterschieden.

Unter Aktion kann angegeben werden, was mit der so gefundenen Email passieren soll. Die Aktion "delete" sorgt dafür, dass die Email einfach gelöscht wird. "setsach" leitet die erzeugte Aufgabe an den in "Ziel" festgelegten Sachbearbeiter weiter. "sendmail" versendet die Email wiederum per Email an eine unter "Ziel" angegebene Emailadresse. Dabei sollten dann auch die weiteren Parameter gesetzt werden. Wird kein "MailSrv" angegeben, wird die Variable HHMAILSRV ausgewertet.

Testen einer IMAP Verbindung


Die Funktionen erlauben den Test einer eingerichteten IMAP Verbindung

 

    sogerpconsole.exe -imapfolders Server Port Security PwdKey Folder/*

    sogerpconsole.exe -imapitems Server Port Security PwdKey Foldername

    sogerpconsole.exe -ImapGetItem Server Port Security PwdKey Foldername MailId Dateiname.eml

 

Beispiel:

 

    sogerpconsole.exe -imapfolders imap.web.de 993 auto webde *

    sogerpconsole.exe -imapitems imap.web.de 993 auto webde inbox

    sogerpconsole.exe -imapmessage imap.web.de 993 auto webde inbox E5-u5x4xsc3-nr136/2/13829-00d8xjqz@artegic.net c:\temp\x1.eml