EH20Mail Copyright 2004 CWL Computer. Alle Rechte vorbehalten. Alle Angaben zur vorliegenden Dokumentation wurden sorgfältig erarbeitet, erfolgen jedoch ohne Gewähr. CWL Computer behält sich das Recht vor, Änderungen an Spezifikationen und sonstigen Informationen ohne vorherige Bekanntmachung vorzunehmen. Für den Inhalt dieser Dokumentation wird keine Haftung übernommen, insbesondere durch Schäden durch nicht vorhandene oder fehlerhafte Angaben. Kein Teil dieser Dokumentation oder des Programms darf in irgendeiner Weise ohne die schriftliche Genehmigung von CWL Computer reproduziert, vervielfältigt und verbreitet werden. Copyright CWL Computer Seite - 1 -
Versions-History 2004-10-27 MN 2.10 SMTP-Mail, DIMOCO SMS, Dienstmann-Funktionen,... 2004-12-02 MN 2.11 Neuer Parameter: [MAIL]MailOutlexprCheckMAPI 2005-03-17 MN 2.20 Neuer Parameter: [POSMELDUNGEN]Backupverzeichnis 2005-04-22 MN 2.21 Neuer Standardwert für [DIENSTMANN]DienstmannSendeDatei 2.21 Unterstützung für neue DIMOCO SMS-Schnittstelle 2.21 Automatische Updates nach Versionsnummern 2.21 Neu: Setupformular Copyright CWL Computer Seite - 2 -
1. Allgemeines EH20Mail ist ein Internet-Kommuninkations Programm, das speziell an die Bedürfnisse von EH2000 und den CWL-Dienstmann abgestimmt wurde. Folgende Möglichkeiten stehen zur Verfügung: EH2000 Mail Empfang EH20Mail durchsucht den Posteingang in Outlook Express nach neuen Nachrichten eines bestimmten Absenders (EH2000 Mailversand). Sind neue Nachrichten vorhanden, so werden die Dateien aus dem Anhang dieser Mails in einen vordefinierten Ordner kopiert. EH20Mail benötigt für diesen Vorgang ein installiertes Outlook Express mit der Version 6.00 oder höher. EH2000 aufbereiten von POS-Meldungen EH20Mail durchsucht einen vordefinierten Ordner nach Dateien mit POS- Meldungen. Werden solche Dateien vorgefunden, werden diese nach einem bestimmten Schema umbenannt und in den EH2000 Ausgangsordner kopiert EH2000 Mail Versand Je nach eingestellter Mail-Methode werden alle Dateien mit bestimmten Dateierweiterungen aus dem EH2000 Ausgangsordner entweder mittels Outlook Express oder direkt mit dem SMTP-Mailprotokoll verschickt. Nach dem erfolgreichen Mailversand werden die Ausgangs-Dateien gelöscht. Versenden von Dienstmann Mail-Nachrichten Je nach eingestellter Mail-Methode werden Mail-Nachrichten von Dienstmann mittels Outlook Express oder direkt mit dem SMTP-Mailprotokoll verschickt. Dienstmann speichert alle zu versendenden Mail-Nachrichten in einer zentralen Sende-Datei mit der Sende-Type MAIL. Je nach Sende-Resultat werden die dort gespeicherten Nachrichten als Erfolgreich oder als Fehlerhaft markiert. Versenden von Dienstmann SMS-Nachrichten Je nach eingestelltem Mail-Provider (DIMOCO oder SMS.AT) verschickt EH20Mail SMS-Nachrichten im entsprechenden Format an den jeweiligen Betreiber. Dienstmann speichert alle zu versendenden SMS-Nachrichten in einer zentralen Sende-Datei mit der Sende-Type SMS. Je nach Sende-Resultat werden die dort gespeicherten Nachrichten als Erfolgreich oder als Fehlerhaft markiert. Kompatibilität zu Vorgängerversionen: EH20Mail Version 2.10 ist vollständig abwärtskompatibel mit allen Vorgängerversionen. Im Falle eines Updates muss die INI-Datei nicht geändert werden. Die Default- Einstellungen sind so gewählt, dass bei fehlenden Einträgen alle Funktionen wie in älteren Versionen durchgeführt werden. Soll hingegen der Mail-Versand per SMTP oder die Dienstmann-Funktion genutzt werden, so sind die neuen Einträge / Sektionen in der INI- Datei vorzunehmen. Automatische Aktionen bei Update der Versionsnummer: Seit Version 2.21 überprüft EH20Mail bei jedem Start den Versionseintrag in der INI-Datei. Im Falle eines Programm-Updates werden eventuell nötige Änderungen selbständig vorgenommen. Copyright CWL Computer Seite - 3 -
2. Erforderliche Änderungen bei Programm-Updates 1. Update auf Version 2.21 Wenn der SMS-Provider auf DIMOCO eingestellt ist, werden im Zuge des Versions-Checks automatisch die Einstellungen für SMSServer=services.dimoco.at und SMSSendPage=/la/send-sms verändert. Damit wird automatisch die neue Schnittstelle von DIMOCO verwendet. Anschließend bitte manuell im Setup die neuen SMS-Zugangsdaten eintragen. Copyright CWL Computer Seite - 4 -
3. Ausgelieferte Dateien Für den Betrieb von EH20Mail sind nur 3 Dateien erforderlich: EH20MAIL.EXE EH20MAIL.INI WWIPSTUFF.DLL Das ausführbare Programm Die Datei mit den Einstellungen für EH20Mail (muss im gleichen Pfad wie EH20MAIL.EXE liegen) Von EH20Mail verwendete Netzwerk-Routinen EH20Mail kann in jedem beliebigen Verzeichnis installiert und gestartet werden. Unmittelbar nach dem Programmstart wird versucht die Datei mit den Einstellungen (EH20MAIL.INI) zu lesen und auszuwerten. Die INI-Datei muss dabei im selben Verzeichnis wie die EXE-Datei vorhanden sein. 4. Einstellungen in EH20MAIL.INI 2. Sektion [ALLGEMEIN] Version=2.21 Eintrag Version Enthält die Programmversion von EH20Mail 3. Sektion [MAIL] Die Sektion [MAIL] enthält allgemeine Einstellungen zum Versenden und Empfangen von Mail-Nachrichten. MailSendMethode=SMTP MailOutlexprCheckMAPI=1 MailSMTPServer=mail.provider.at MailSMTPSenderMailAdresse=absender@provider.at MailSMTPSenderName=Vorname Nachname MailSMTPUsername= MailSMTPPassword= Eintrag MailSendMethode Gültige Werte: SMTP oder OUTLEXPR ; Default = OTLEXPR Die zu verwendende Sende-Methode für Mails (EH2000 und Dienstmann). Eintrag MailOutlExprCheckMAPI Gültige Werte: 0 (Nein) oder 1 (Ja); Default = 1 Bestimmt, ob vor dem Aufruf einer Outlook-Express-API-Funktion die Windows-Registry auf ordnungsgemäße Installation der Mail-API (MAPI) überprüft werden soll. Auf einigen PCs fehlt dieser Registry-Eintrag, obwohl die MAPI ordnungsgemäß funktioniert. In diesem Fall kann die Überprüfung ausgeschaltet werden. Eintrag MailSMTPServer Enthält den Namen des SMTP Servers (lt. Dokumentation des Internet-Providers). Nur erforderlich, wenn als MailSendMethode SMTP ausgewählt ist. Copyright CWL Computer Seite - 5 -
Eintrag MailSMTPSenderMailAdresse Ist die Absender-Emailadresse (lt. Dokumentation des Internet-Providers). Nur erforderlich, wenn als MailSendMethode SMTP ausgewählt ist. Eintrag MailSMTPSenderName Der Name des Absenders (wird beim Mail-Empfänger als Absender angezeigt). Nur erforderlich, wenn als MailSendMethode SMTP ausgewählt ist. Eintrag MailSMTPUsername Falls SMTP Server eine Anmeldung benötigt ist hier der Username einzutragen (lt. Dokumentation des Internet-Providers). Achtung: die meisten SMTP-Server benötigen KEINE Benutzeranmeldung! Nur erforderlich, wenn als MailSendMethode SMTP ausgewählt ist. Eintrag MailSMTPPasswort Falls SMTP Server eine Anmeldung benötigt ist hier das Passwort einzutragen (lt. Dokumentation des Internet-Providers). Achtung: die meisten SMTP-Server benötigen KEINE Benutzeranmeldung! Nur erforderlich, wenn als MailSendMethode SMTP ausgewählt ist. 4. Sektion [SMS] SMSProvider=DIMOCO SMSServer=services.dimoco.at SMSSendPage=/la/send-sms SMSUserName=1234 SMSPasswort=abcdef SMSSendTestFlag=0 Eintrag SMSProvider Gültige Werte: DIMOCO oder SMSAT Der verwendete SMS-Provider. Default-Wert ist DIMOCO. Eintrag SMSServer Der SMS-Server des entsprechenden Providers. Eintrag SMSSendPage Die verwendete Web-Seite zum versenden von SMS Eintrag SMSUserName Der Benutzername für die Anmeldung am SMS-Server (siehe Lizenz-Vertrag mit CWL) Eintrag SMSPasswort Das Passwort für die Anmeldung am SMS-Server (siehe Lizenz-Vertrag mit CWL) Eintrag SMSSendTestFlag Gültige Werte 1 oder 0 Bestimmt, ob die SMS-Nachrichten im Echt- (0) oder im Test-Betrieb(1) gesendet werden Copyright CWL Computer Seite - 6 -
5. Sektion [SENDEN] Die Sektion SENDEN enthält grundlegende Einstellungen zum Versenden von Mails mit Dateianhängen an EH2000. MailAdresse=empfaenger@provider.at Betreff=abcdefghijk DateiErweiterung=SNT Verzeichnis=C:\EH2000\AUS\ Eintrag MailAdresse Die Mail-Adresse des Empfängers für EH2000 Meldungen. Sollen EH200-Mails an mehrere Empfänger geschickt werden, so sind die Empfänger-Mailadressen mit ; zu trennen. Eintrag Betreff Das EH2000 Passwort Eintrag DateiErweiterung Alle Dateien mit dieser Dateierweiterung werden an den EH2000-Mailempfänger verschickt (Darf auch * sein = ALLE Dateien) Eintrag Verzeichnis EH2000-Dateien werden nur in diesem Verzeichnis gesucht 6. Sektion [EMPFANGEN] Die Sektion [EMPFANGEN] enthält Einstellungen zum Empfangen von Mails von EH2000. MailAdresse=absender@provider.at DateiErweiterungen=SNT Verzeichnis=C:\EH2000\EIN\ LetztMsgID=0 Eintrag MailAdresse Nur Mails von dieser Absender-Adresse werden ausgewertet Eintrag DateiErweiterung Nur Anhänge mit diesen Dateierweiterungen werden gespeichert. Mehrere Dateierweiterungen können mit, (Komma) getrennt eingestellt werden. Eintrag Verzeichnis EH2000-Dateien werden in dieses Verzeichnis kopiert. Eintrag LetztMsgID Die letzte von EH20Mail durchsuchte Nachricht. Dieser Eintrag wird von EH20Mail selbst vorgenommen und immer aktuell gehalten. Wird dieser Eintrag auf 0 zurückgestellt, so werden beim nächsten Programmlauf wieder alle Mails im Posteingang durchsucht. Copyright CWL Computer Seite - 7 -
7. Sektion [POSMELDUNGEN] Die Sektion [POSMELDUNGEN] enthält Einstellungen zur Verarbeitung von POS- Meldungen an EH2000. DateiErweiterung=SNT QuellVerzeichnis=C:\EH2000\POS\ ZielVerzeichnis=C:\EH2000\AUS\ BackupVerzeichnis=C:\EH2000\POSSIK\ Prefix=posmel Eintrag DateiErweiterung Eintrag QuellVerzeichnis Eintrag ZielVerzeichnis Eintrag BackupVerzeichnis Eintrag Prefix Beim Verarbeiten von POS-Meldungen werden Dateien mit der Erweiterung [DateiErweiterung] im Verzeichnis [QuellVerzeichnis] gesucht, nach einem EH2000- spezifischen Mechanismus umbenannt, mit dem Prefix [Prefix] versehen und in den Ordner [ZielVerzeichnis] verschoben. Nach dem Umbenennen der Datei wird ins Verzeichnis [BackupVerzeichnis] eine Sicherung der Datei abgelegt. Wird der Eintrag [BackupVerzeichnis] nicht eingefügt, so erstellt EH20Mail einen Verzeichnisnamen durch anfügen von SIK an das Quellverzeichnis (z.b.: aus C:\EH2000\POS\ wird C:\EH2000\POSSIK\ ). 8. Sektion [DIENSTMANN] Die Sektion [DIENSTMANN] enthält Pfad-Einstellungen zur Kommunikation mit dem CWL-Dienstmann. DienstmannSendeDatei=C:\CWLPROGRAMME\DIENSTMANN\NETSEND.DBF Eintrag DienstmannSendeDatei Die Datei mit den Sende-Aufträgen des CWL-Dienstmann. Copyright CWL Computer Seite - 8 -