Deutsch: (English version below) Hamoa 1.4.6 Beta for EGroupWare !!ACHTUNG: Diese Software ist BETA und kann Ihren Rechner zerstören! Benutzen Sie sie lieber nicht! Sie wurden gewarnt. Diese Beta läuft nur bis zum 01.12.2004 1.Entwickelt für Outlook 2000 EGroupWare 0.9.99.014 Windows 98/Me/NT/2000/XP MySQL 2.Getestet auf Server: SuSE Linux 7.1 EGroupWare 0.9.99.014 MySQL 3.23.33 Client: Outlook 2000 Outlook XP Outlook 2003 Windows 98 Windows Me Windows NT WS (SP5) Windows 2000 Professional Windows XP Professional (SP1) 3.Voraussetzungen Auf dem Server sind installiert: Linux EGroupWare 0.9.99.014 MySQL Auf dem Client-Rechner sind installiert: Outlook 2000/XP/2003 Windows 98/Me/NT/2000/XP ODBC-Treiber MyODBC-3.51.06 oder höhe (falls es nicht funktioniert, kann man myodbc_2.50.36_nt (für Windows NT) oder MyODBC-3.51.03 oder höhe (für andere Windows-Versionen) benutzen) 4. Installation Vor der Installation deinstallieren Sie bitte ältere Version des Tools und löschen Sie bitte Installationsordner "Hamoa" mit der alten Dateien, falls sie nicht automatisch gelöscht wurden. Es muss eine ODBC-Verbindung als System-DSN mit dem Namen "egroupware" angelegt werden. Dazu muss eine gültige Login/Kennwort Kombination vorliegen. Der Benutzer der in der Datenbank eingetragen wird, muss folgende Berechtigungen haben: -SELECT -UPDATE -INSERT -DELETE -CREATE -INDEX Wenn es sich um einen MySQL-ODBC-Treiber handelt, müssen folgende Optionen aktiviert sein: -Allow BIG Results -Change BIGINT Columns to INT -Return Matching Rows Wenn die ODBC-Verbindung eingerichtet und erfolgreich getestet wurde, kann Setup von Hamoa ausgeführt werden. 5. Betrieb Wenn Hamoa gestartet wurde, muss der Username und der Passwort der EGroupWare eingegeben werden und auf OK geklickt werden. Das Tool meldet sich dann mit den Daten, die in der ODBC-Verbindung angegeben wurden bei der Datenbank an und greift auf die Ressourcen des Users zu, der in Hamoa eingegeben wurde. Nachdem festgelegt wurde, was übertragen werden soll, klickt man auf Start und das Tool beginnt. 6. ToDo Dokumentation 7. Bugs Einige Felder haben in Outlook eine grössere Länge als in phpgw, das Tool schneidet diese dann ab. Dies kann man umgehen, wenn die Tabellen von phpgw angepasst werden. Bugreports bitte an sd@aloha-systeme.de 8. Vergleich der Kategorie. Allgemein - Die manuelle Zuweisung von Kategorien der Einträge in Outlook zu einer Kategorie, die in EGroupWare existiert, muss so erfolgen, dass die gleichnamige Kategorie im Outlook-Eintrag als erstes im Feld "Kategorie" angezeigt wird (falls ein Eintrag zu mehreren Kategorien gehört). - In Hamoa werden nur die Kategorien angezeigt, die in EGroupWare als "global" gekennzeichnet sind und von Administrator erzeugt werden können. Das ist notwendig, weil die Kategorien, die User für bestimmte Teile der EGroupWare , z.B. für Kalender oder für Notizen, erzeugen, nur in diesen Teilen der EGroupWare sichtbar sind (z.B. nur im Kalender). Die globalen Kategorien sind dagegen in jedem Teil der EGroupWare vorhanden. 9. Synchronisierung - Übernahme der neuen Einträgen - Kopieren der aktualisierten Einträgen - Löschen der Einträge in EGroupWare und in Outlook (außer Kontakte) - Möglichkeit die Einträge, die in EGroupWare gelöscht wurden, in Outlook beibehalten ACHTUNG: Wenn bereits die gleichen Einträge in EGroupWare und in Outlook existieren (durch einen Lauf einer Vorversion (< 1.0) von Hamoa ohne Synchronisierung), dann kann es zu doppelten Einträgen in phpgw oder Outlook führen. Am besten löscht man auf einer Seite alle Einträge und synchronisiert mit der neuen Version. Wenn verschiedene Logins auf das gleiche Outlook synchronisiert werden sollen, kann dies auch zu doppelten Einträgen führen. 10.Kommandozeile Hamoa kann mit der Option "-silence" als Parameter im Batch verwendet werden, es wird dann die zuletzt gespeicherte Konfiguration benutzt. Hamoa beendet sich nach der Synchronisierung selbst. English: ATTENTION!! This software is BETA and could destroy your PC! Please don't use it. You have been warned! This beta-version runs until December 1st 2004 1. Developed for: Outlook 2000 EGroupWare 0.9.99.014 Windows 98/Me/NT/2000/XP MySQL 2.Tested on: Server: SuSE Linux 7.1 EGroupWare 0.9.99.014 MySQL 3.23.33 Client: Outlook 2000 Outlook XP Outlook 2003 Windows 98 Windows Me Windows NT WS (SP5) Windows 2000 Professional Windows XP Professional (SP1) 3. Prequisites: At the serverside is installed: Linux EGroupWare 0.9.99.014 MySQL At the clientside is installed: Outlook 2000/XP/2003 Windows 98/Me, NT/2000/XP ODBC-Driver MyODBC-3.51.06 (if it doesn't work, use ODBC-Driver myodbc_2.50.36_nt (for Windows NT) or MyODBC-3.51.03 (for all other OS') 4. Installation Before new installation, please remove the old installation of Hamoa, and delete the folder with the old data, if it wasn't removed automatically. There must be a ODBC-Connection as a System-DSN with the name "egroupware". To get connected, there must be also a valid login/password combo. The user, which is added to the database must have the following rights: -SELECT -UPDATE -INSERT -DELETE -CREATE -INDEX If it is a MySQL-Odbc-driver, the following options must be set: -Allow BIG Results -Change BIGINT Columns to INT -Return Matching Rows If the odbc-connection was successfully installed and tested, the setup of Hamoa could be started. 5. Usage After starting Hamoa, the user must type in his login of phpgw and click OK. Hamoa then connects with the standarduser/password combination to the database and reads the ressources of the phpgw-user. After selecting which data have to be transfered, simply click start. 6. ToDo Docs 7. Bugs Some fieldlength differ in phpgw and Outlook. Phpgw cuts everything what is to long. If you don't want it, edit the field length in the phpgw database. Bugreport in German to sd@aloha-systeme.de. If you speak English please send to ag@aloha-systeme.de 8. Categorymatching In general: - The manual assignment of the category of the entries in Outlook to a category which exists in phpgw must happen in that way, that the equal named category of the outlook entry is at first place in the field "category" of the outlook entry (if an outlook entry is assigned to more than on category). - Hamoa is showing only these categories which are marked as "global", and normally can only be created by the admin. This is necessary because the user-categories are only valid for some phpgw applications, like notes or calendar, and can only be used within these applications. The global categories are usable in every part of phpgw. 9. Synchonization - Transfer of new entries - Transfer of edited entries - Delete entries in EGroupWare and in Outlook - It is possible to keep the entries in Outlook, which has been deleted in EGroupWare ATTENTION: If there exist already the same entries in phpgw and Outlook (due to a run of an earlier version (< 1.0) of Hamoa without synchonization), it could be possible that all entries double in phpgw or Outlook. As a fix, all entries on one side (phpgw or Outlook) should be deleted and the start a sync with the new version of Hamoa. If several logins are synchronized, all to the same Outlook, could also lead into dupe entries. 10. Commandparameter Hamoa can be started with the parameter "-silence" and will run and terminate without a user action. It can be used in a batch for automatic syncing.