ZIPSPLITMAIL. HowTo. Jürgen A.Lamers Version 0.3a

Transkript

1 DokuTransData Jürgen A.Lamers Altstr Aachen Tel.: Fax: WWW: HowTo ZIPSPLITMAIL Jürgen A.Lamers Version 0.3a DokuTransData Aachen 2008

2 Die Informationen in diesem Dokument werden ohne Rücksicht auf einen eventuellen Patentschutz veröffentlicht. Warennamen werden ohne Gewährleistung der freien Verwendbarkeit benutzt. Bei der Zusammenstellung von Texten und Abbildungen wurde mit grö ster Sorgfalt vorgegangen. Trotzdem können Fehler nicht vollständig ausgeschlossen werden. Herausgeber und Autor können für fehlerhafte Angaben und deren Folgen weder eine juristische Verantwortung noch irgendeine Haftung übernehmen. Für Verbesserungsvorschläge und Hinweise auf Fehler sind Autor und Herausgeber dankbar. Alle Rechte vorbehalten, auch die der fotomechanischen Wiedergabe und der Speicherung in elektronischen Medien. Die gewerbliche Nutzung der in diesem Produkt gezeigten Modelle und Arbeiten ist nicht zulässig. Fast alle Hardware- und Softwarebezeichnungen, die in diesem Handbuch erwähnt werden, sind gleichzeitig auch eingetragene Warenzeichen oder sollten als solche betrachtet werden. Kurzbeschreibung zu ZIPSPLITMAIL Dieses Skript ist nur für den privaten Gebrauch genehmigt. c 2008 DokuTransData Aachen, Altstr. 112, Aachen, Germany.

3 Zusammenfassung Kurze Beschreibung wie das Tool ZIPSPLITMAIL eingesetzt wird.

4 Inhaltsverzeichnis 1 Einleitung 1 2 Installation 1 3 Benutzung der GUI-Version Anwendungsbeispiele Versenden eines Bildverzeichnisse Versenden von Bilddateien Fehlermeldungen Benutzung der CLI-Version 5 5 Konfigurationsdatei 6 A Literatur 8 B Abbildungsverzeichnis 8 Index 9 iv

5 1 Einleitung Ich supporte eine kleine WebSite ( mit dem Thema Wanderungen. Unter anderem werden dort die Fotos von unseren Wanderungen präsentiert, die ich nach jeder Wanderung entsprechend aufbereite. Dazu muss ich von meinen MitWanderFotografen die Fotos einsammeln, doch zum einen funktioniert meine MiniFestplatte nicht immer (Strom?!?, SDHC etc.... ) oder ich habe die Wanderung nicht mitgemacht. Deswegen müssen meine Wanderkameraden(Innen) die Fotos mir per Mail zu kommen lassen. Und dies kann sehr mühselig sein, je nachdem wieviel MB der MailAccount erlaubt... Darum habe ich meine Java-Kenntnisse herausgekramt und sogar eine Oberfläche programmiert 1 und dieses Progrämmchen möchte ich im nachfolgenden erläutern. 2 Installation Man/frau benutze auf Windows das InstallerScript, bei Linux muss ich entsprechendes noch umsetzen, dort fehlt u. a. noch das Shell-Script. 3 Benutzung der GUI-Version 2 Abbildung 1: Hauptseite Abbildung 2: Eingabe der Senderinformationen Das Programm präsentiert sich mit einer einfachen Oberfläche (Abb. 1, 2), in dieser hat der Anwender seine Mail-Adresse (Von ( )), die Zieladresse (An ( ) sowie den Mailserver einzugeben. Die Felder Zieldatei, Betrifft und Nachricht sind Themenbezogen schon vorbelegt. Nach der ersten Anwendung sollten die Informationen sowieso abgespeichert werden, so dass beim nächsten Start die gespeicherten Werte angezeigt werden 3. 1 Mir hätte ja ein ANT-Script gereicht. 2 GUI = Graphical User Interface 3 Vorsicht: Das Passwort wird nicht abgespeichert, da dies derzeit im Klartext in dieser Datei landet! 1

6 Als nächstes muss der Server (SMTP) eingetragen und der Port geändert werden. Zur Sicherheit ist der Benutzer und das Passwort einzugeben, der Benutzer kann gleichbedeutend mit der Absenderadresse (Von ( ) sein. In dem Feld Dateigröße kann die maximale Größe der eingestellt werden, der Wert wird als Megabyte-Angabe interpretiert. 3.1 Anwendungsbeispiele Versenden eines Bildverzeichnisse Wie versende ich jetzt ein Verzeichnis mit Bildern: 1. An ( ) eingeben (mit Kommas getrennt). 2. Zieldatei bei Bedarf ändern. 3. Betrifft nach Situation ändern. 4. Nachricht bearbeiten. 5. Bei Von ( ) deine -Adresse eingeben. 6. Bei Server (SMTP) die Adressse wie z. B. smtp.web.de eingeben. 7. Port eventuell ändern. 8. Benutzername eventuell eingeben, der Benutzername kann durchaus von Von ( ) abweichen. 9. Passwort bei Bedarf eingeben, sofern Benutzername eingegeben wurde. 10. Dateigröße ändern. 11. Datei > Speichern 12. Ausführen > Versende Verzeichnis, Verzeichnis auswählen und bestätigen und warten bis die Erfolgsmeldung (Abb. 10) erscheint. 13. Bei Erfolg beendet sich das Programm selber. Die Schritte 5 bis 8, sowie sind nach Datei > Speichern nicht mehr notwendig, die Schritte 1 bis 4 eigentlich auch nicht. Der einzige Wert der evtl. jedesmal eingegeben werden muss ist Schritt Versenden von Bilddateien Beim Versenden von Bilder bitte die Schritte 1 bis 11 in Abschnitt durchführen, anschliessend Ausführen > Versende Dateien anwählen, jetzt einzelne Bilder anwählen, bestätigen und warten bis die Erfolgsmeldung (Abb. 10) erscheint, bei Erfolg beendet sich das Programm selber. 2

7 3.2 Fehlermeldungen Im nachfolgenden die möglichen Fehlermeldungen: Abbildung 3: Keine Zieladresse eingegeben Abbildung 4: Keine Zieldatei eingegeben Abbildung 5: Keine Absenderadresse eingegeben 3

8 Abbildung 6: Kein Mailhost eingegeben Abbildung 7: Keinen Mailport eingegeben Abbildung 8: Keinen Benutzer eingegeben Abbildung 9: Kein Passwort eingegeben Abbildung 10: Es hat alles funktioniert 4

9 4 Benutzung der CLI-Version 4 ZSM (v 0.3a) <Usage>: ZSM -d <destfile> [-f <from>] [-h <mailhost>] [-p <password>] [-t <to>]+ [-P <propertyfile>] [-g <splitsize>] [-b <betrifft>] Directory File File File -d <destfile> : Destinationfile -f <from> : From-Address -n <fromname> : FromName-Address -h <mailhost> : Mailhost (smtp.web.de) -o <port> : Mailport (25) -l : Use SSL -p <password> : Password to Mail -u <username> : Username to login -t <to> : To-Address (multiple) -P <propertyfile> : Property-Datei mit Informationen zu MailHost etc. -g <splitsize> : Größe der einzelnen Dateien (Default 2Mb). -b <betrifft> : Subject -v : Verbose Argumente Argumente in [] sind optional, Argumente in []+ können keinmal oder mehrmals verwendet werden, Argumente ohne Klammern müssen einmal angegeben werden. -d <destfile> Zieldatei die beim Adressaten zusammengestellt werden soll. -f <from> Von ( ) -n <fromname> Ihr Name -h <mailhost> Server (SMTP) z. B. smtp.web.de -o <port> Port z. B. 25 (default) -l Benutze SSL (ungetestet) -p <password> Passwort für den Mailserver -u <username> Benutzer für den Mailserver (kann unabhängig von der -Adresse sein) -t <to> Zieladresse (Das Argument kann mehrfach vorkommen) 4 CLI = Command Line Interface (Eingabeaufforderung) 5

10 -P <propertyfile> Property-Datei mit Informationen zu Mailserver etc. (s. Abschnitt 5) -g <splitsize> Größe der einzelnen Dateien (Default 2Mb). -b <betrifft> Betreffzeile -v Ausgabe von Kommentaren zu einzelnen Aktionen. Beispiel 1 ZSM -d Bilder.zip -f irgendwen@wo.de -n "Mein Name" -h smtp.wer.da\ -t erster@da.de -t zweiter@wesch.de "Meine Bilder" Beispiel 2 ZSM -d Bilder.zip -f irgendwen@wo.de -n "Mein Name" -h smtp.wer.da\ -t erster@da.de -t zweiter@wesch.de c:\meinebilder\img_3007.jpg\ c:\meinebilder\img_3009.jpg Das Ganze muss in einer Zeile eingegeben werden! Die letzten Argumente werden als Dateien interpretiert. Ist das erste Element ein Verzeichnis, werden alle nachfolgenden Argumente ignoriert und nur das Verzeichnis eingepackt. 5 Konfigurationsdatei Bei der GUI-Version wird diese Datei mit Datei > Speichern als zsm.ini erstellt, in der CLI-Version muss man/frau sich mit einem Texteditor begnügen. from=irgend@wer.de fromname=irgend Wer mailhost=smtp.irgendwer.de #Wenn Passwort gesetzt ist *muss* auch der User gesetzt sein password=passwort user=irgend@wer.de mailport=25 #Wenn SSL genutzt wird muss der Mailport angepasst werden. usessl=false messagetext=hallo,\nhier sind deine gewünschten Bilder.\nGruss Jürgen\n subject=wanderbilder splitsize=3#= 3Mb Alle Zeichen nach # werden nicht interpretiert (Kommentare). Properties from Von ( -Adresse) 6

11 fromname mailhost mailport usessl password user splitsize subject messagetext Ihr Name Server (SMTP) z. B. smtp.web.de Port z. B. 25 (default) Benutze SSL (ungetestet) Passwort für den Mailserver Benutzer für den Mailserver (kann unabhängig von der -Adresse sein) Größe der einzelnen Dateien (Default 2Mb). Betreffzeile Text der Nachricht. Zeilenumbrüche können mit \n erzeugt werden. Hinweise Das Passwort sollte in dieser Datei nicht gespeichert werden, in der GUI-Version wird das Passwort nicht abgespeichert. In der CLI-Version wird zuerst die angegebene Konfigurationsdatei (-P) ausgewertet, anschliessend die weiteren Argumente. 7

12 A Literatur [Apa] [ecl] [pro] APACHE SOFTWARE FOUNDATION, Entwickeln mit ANT. ECLIPSE SOFTWARE FOUNDATION, Homepage der Eclipse IDE. Processing command line arguments in Java: Case closed - Java World. [SUN] SUN, JavaMail API. [zip] zipsplitsend - Google Code. B Abbildungsverzeichnis 1 Hauptseite Eingabe der Senderinformationen Keine Zieladresse eingegeben Keine Zieldatei eingegeben Keine Absenderadresse eingegeben Kein Mailhost eingegeben Keinen Mailport eingegeben Keinen Benutzer eingegeben Kein Passwort eingegeben Es hat alles funktioniert

13 Index Mailserver, 5 Port, 5 9