 |
|
Handy ist ein kleines Kommandozeilenprogramm um die Ausgabe des Lotus Notes Terminkalenders der Versionen 5.x oder 6.x in das vCal Version 2.0 Format zu konvertieren. Das Programm kann den Terminkalender an ein Handy der Type Siemens S45 (getstet), oder eines beliebigen anderen Geräts senden, welches das vCal − Format versteht, senden. Mit Ausnahme des Siemens S45 wurde jedoch noch kein Gerät getstet.
Zunächst benötigt man einen Lotus Notes Client der Version 5.x oder 6.x, wo die Termine verwaltet werden. Starten Sie Lotus Notes, öffnen Sie den Terminkalender und wählen Sie den Menüpunkt "Datei->Exportieren". Geben Sie in der Dateiauswahlbox einen Dateinamen ein und wählen Sie das gewünschte Unterverzeichnis aus, in das die Datei gespeichert werden soll. Vergewissern Sie sich, dass "Structured Text" als Dateiformat eingestellt ist! Wählen Sie in der Dialogbox unter "Exportieren" "Alle Dokumente" aus (voreingestellt) und klicken Sie auf "OK". Nun werden alle Ihre Termine in die Datei gespeichert, welche Sie zuvor angegeben haben.
Öffnen Sie ein Kommandozeilenfenster (Shell) um das Programm zu verwenden. Mit dem Kommandozeilenbefehl -h oder --help erhalten Sie eine ausführliche Hilfe über alle möglichen Befehle. Das Programm wurde mit dem Siemens S45 getestet, sollte aber auch mit dem Siemens S35, bzw. jedem anderen Gerät funktionieren, welches das vCal 2.0 Format unterstützt. Seit der Version 0.3.0 verarbeitet das Programm auch sich wiederholende Einträge korrekt, sowie auch Feiertage. Lediglich Alarme werden noch ignoriert.
Falls SIe Fragen oder Anregungen haben, scheuen Sie sich nicht mir ein EMail an andreas at theossoft dot net zu schreiben. Patches sind ebenfalls sehr willkommen!
TODO list:
Laden Sie das Programm hier herunter:
| Datum | Beschreibung |
|---|---|
| 16.05.2005 | Ein weiterer Schalter Namens [-l] bzw. [--line-feed] wurde hinzugefügt. Ist der Schalter gesetzt, werden in den Befehlen in der Ausgabedatei keine Zeilenumbrüche mehr gemacht. Dadurch sollte auch ein Palm beispielsweise die Ausgabedatei importieren können. |
| 02.03.2006 | Fehler bei der Zeiterkennung wurde behoben. Nun sollte auch ein 12 Stundenfomat mit AM und PM Kennzeichnung korrekt erkannt werden. |
| 16.12.2005 | Fixed a minor bug. Now the time should be correct again. |
| 13.12.2005 | Added a new feature to set the date format of the date contained in the Lotus Notes file. If the date is not central european or us, you can set the format manually to support your country. |
| 13.09.2005 | Added support for Lotus Notes 6.x client (tested with version 6.5). Some basic functions like parsing attendies, date and time is completely new. Now only appointments of the current and future years are exported into the vCal format, excepted repeating entries. |
| 09.06.2003 |
Added language support. All messages are now in an optional external
file. This makes it easy to translate the messages into any language. Added support for repeating appointments, like holidays. All kinds of holidays are supported now, when exporting to KOrganizer. They are still not send to a cellphone. Now I check for a SIEMENS S35/S45 cellphone, but if I find anything other, I only display a warning and try to send the appointments to it. |
| 22.05.2003 | Corrected a minor bug in recognizing the keywords in the source file. Now it's not case sensitive any more. |
HANDY funktioniert nur mit Dateien im "Structured Text" Format, die Termine beinhalten. Die Lotus Notes Versionen 5.x und 6.x können dieses Dateiformat erzeugen.
Starten Sie zunächt Lotus Notes und öffnen Sie den Terminkalender. Klicken Sie auf den Menüpunkt "Datei" und wählen Sie den Punkt "Exportieren" aus. Eine Dateidialogbox erscheint. Wählen Sie das Verzeichnis in das Sie die Datei speichern wollen und geben Sie einen Dateinamen ein. Vergewissern Sie sich, dass das Dateiformat "Structured Text" eingestellt ist! Falls die von Ihnen angegebene Datei bereits existiert, können Sie die Datei überschreiben oder die Aktion abbrechen.
Nach dem Sie auf den Knopf "Export" in der dateidialogbox geklickt haben, erscheint eine weitere Dialogbox. Vergewissern Sie sich, dass unter der Rubrik "Exportieren", "Alle Dokumente" aktiviert ist (Voreingestellt) und klicken Sie auf "OK". Falls noch die Version 5.x des Lotus Notes Clients benutzen, erscheinen die beden Dialogboxen in umgekehrter Reihenfolge. Nun erscheint ein kleines Fenster mit einem Fortschrittsbalken, welches für die Dauer des Exports sichtbar ist. Sobald alle Termine in die Datei geschrieben wurden, können wir daran gehen, diese in das vCal − Format umzuwandeln.
Open a shell (in case of Windows, click on start, choose Run..., type cmd in the small dialog window and click OK. A command line window should appear.) and go to the directory where you've stored the calendar file. Now it's necessary to know, where you've connected your cellphone to the computer. One possibility is, that you have a data cable and the phone is connected to serial device one or two. On Linux, this is /dev/ttyS0 (first serial device) or /dev/ttyS1 (second serial device). This is also true for the windows version!
If your cellphone is connected over the IR Port, you don't need speed settings at all. On Linux the device depends on the type of IR Port you have. One possibility may be /dev/ircomm0. On Windows your IR Port is simply another serial device therefore one of /dev/ttyS[0-4].
Now, that we know our port where our cellphone is connected, we can start HANDY to send the contents of our previously saved file. Type the following command on the command line:
handy -a <calendar file> -w -d <device>
The above command assumes, that the cellphone is connected over an IR Port. <calendar file> is your previous saved calendar file and <device> is the path and name of the device your cellphone is connected to.
handy -a <calendar file> -w -d <device> -b 19200
The above command assumes, that the cellphone is connected over a serial device. It sets the baudrate of the device to 19200 baud. This speed must be the same you set on your cellphone. Read the manual of your cellphone on how to set the baudrate!
To create a file that KOrganizer can import, you can use HANDY with the following parameters:
handy -a <calendar file> -o icalout.ics
The above command tells HANDY to convert the previous stored calendar file into the file icalout.ics. You can name the file different of course, but you should always add the extension .ics. Because this is what KOrganizer expects.
Another problem may be the time zone at your location. HANDY tries to find out the correct time zone itself. Lotus Notes 6.5 supports the time zone and HANDY uses this information. If however the time appears not correct, you can manualy correct it using the following parameter on the command line:
handy -a <calendar file> -o icalout.ics -t +2
The above command makes the conversation as described above, and sets all time codes two hours back. The stored time of 09:00:00 MESZ is translated into 07:00:00 UTC, for example.
That's it! There are some more parameters available, but you'll not need them mostly. The parameter -h or --help gives you a short description of all possible parameters.
In case you have questions, write an email to andreas at TheosSoft dot net. If you're still using Windows, your are at your own! I can not and will not answer any questions about Windows!
