From eb1ab908047072aa4fb224ab7da6e147d4dcf1e0 Mon Sep 17 00:00:00 2001 From: zautrix Date: Tue, 13 Jul 2004 13:54:21 +0000 Subject: Added Migration howto text --- (limited to 'bin/kdepim') diff --git a/bin/kdepim/korganizer/Migration-HowTo.txt b/bin/kdepim/korganizer/Migration-HowTo.txt new file mode 100644 index 0000000..ca767c6 --- a/dev/null +++ b/bin/kdepim/korganizer/Migration-HowTo.txt @@ -0,0 +1,299 @@ + +Migration HowTo Outlook 200X -> KDE + +This HowTo describes the process of migrating data ( contact and calendar data ) from Outlook 200X to the PIM programs of the KDE-Desktop-Environment. +The PIM programs are KAdddressbook and KOrganizer, which may be used embedded in the Kontact PIM management framework. +This HowTo describes version 1.9.3a of the migration tools. +The migration tools are the platform independent versions of KAdddressbook and KOrganizer: KAdddressbook/Pi and KOrganizer/Pi. + +Content: + +1) How to start +2) How to import pst files in Outlook +3) Where to get the migration tools +4) How to install the migration tools +5) How to get the contact data out of Outlook200X +6) How to get the calendar data out of Outlook200X + +APPENDIX A) Problems and solutions when reading contact data +APPENDIX B) Problems and solutions when reading calendar data + +**************************************** +1) How to start +**************************************** + +For the migration we need the actual Outlook 200X data, which Outlook stores in *.pst files. +Then we need an installed version of Outlook 200X to access these *.pst files. +When we have an Outllook 200X running with all data accessable, we need the migration tools. + +If you have no Outlook200X installed please install the Outlook version, you need to a import your *.pst files. +If you have an Outlook200X installed with no contact/calendar data available, and you have some *.pst files please continue with: 2) How to import pst files in Outlook. +If you have a running Outlook200X already with contact/calendar data available, please continue with: 3) Where to get the migration tools. + + +**************************************** +2) How to import pst files in Outlook +**************************************** + +MISSING + +**************************************** +3) Where to get the migration tools +**************************************** + +The data migration is is performed with the Windows versions of KAdddressbook/Pi and KOrganizer/Pi. +Pi stands for platform-independend - platform-independend because the same program is available for different platforms, like Windows, Linux desktop and Sharp-Zaurus PDA. +Note: The Linux desktop versions of KOrganizer/Pi and KOrganizer/KDE-desktop are two different programs! You cannot use KOrganizer/Pi together with or embedded in the KDE-desktop environment. The same is valid for KAdddressbook/Pi. + +The programs you need for the migration are: +a) KAdddressbook/Pi executeable + 2dlls + icons +b) KOrganizer/Pi executeable + icons +c) The Qt3 library qt-mt331.dll and the MSVC library msvcr71.dll + +You can download all of them at: + +http://sourceforge.net/projects/kdepimpi/ + +Download of a) and b) +Please choose there package/project with name KDE/Pim +(Direct link: http://sourceforge.net/project/showfiles.php?group_id=104103&package_id=112604 ) +Choose there the topmost latest version and the files +kapixxx-exe.zip +kopixxx-exe.zip +The latest version is currently ( 2004-07-13 ) 1.9.3a. +Such that the files to download are +kapi193a-exe.zip +kopi193a-exe.zip + +To download b) +Please choose there package/project with name KO/Pi - general files. +(Direct link: http://sourceforge.net/project/showfiles.php?group_id=104103&package_id=116719 ) +Choose there the file: +kopidll.zip + +Now you have downloaded the files + +kapi193a-exe.zip +kopi193a-exe.zip +kopidll.zip + +and we can continue to install the files, which is simply unzipping them. + + +**************************************** +4) How to install the migration tools +**************************************** + +You have downloaded the files + +kapi193a-exe.zip +kopi193a-exe.zip +kopidll.zip + +Unzip these files. +The directory "pics" of the kopidll.zip is useless now and can be completely ignored. +Now choose an arbitrary installation directory, where to copy all the needed files together. +You should have now the following files and the directory "kdepim" in the same directory: +kopi.exe +kapi.exe +microkabc_dir.dll +microkabc_file.dll +msvcr71.dll +qt-mt331.dll +ReadMich.txt +kdepim (directory) + +The directory "kdepim" should contain subdirectories +kaddressbook +korganizer +which itself contain some subdirectories with icons and help text. + +Now the migration tools are ready for use. + + +NOTE AND HINT for performing migration on many workstations: +Just burn the content of the installation dir on a CD. +Then you can put the CD in every workstation and execute the migration tools from that CD directly. + + +************************************************************* +5) How to get the contact data out of Outlook200X +************************************************************* + +Note: When accessing Outlook to read the data, it should not be possible, that there is any data lost in Outlook, because the progam accesses Outlook only Read-Only. + +You have the file +kapi.exe +and the other needed files accessable on your workstation. + +Getting the contact data + +Please start kapi.exe. +Choose menu: +File - Import - Import from OL... +You will get a dialog which shows all "Personal Folders" of Outlook. +Choose the Contact Folder(s) you want to import and select them with a hook. +(All other folder but the contact containing folders are shown, but disabled) +Click the "import" button. +Now Outlook asks you to allow access to the contact data. +Select "Allow access" amd click "Yes" in this dialog. +Now the importing is performed and KA/Pi will show a progress bar. +After importing, KA/Pi shows a dialog, how much contacts are imported. +If you press a second time "import" , already imported contacts are not imported again. +After importing you can choose another "Contact Folder" to import or close the import dialog. +Please close the import dialog. +Now you see the imported contacts in KA/Pi on the left in the list view. +Please verify, that the import was correct. +About problems of mapping particular Outlook-data-fields to KAdressbook-data-fields see Appendix A). + +Choose menu: +File - Save +and close KA/Pi. +Now you should have the contact data in the file std.vcf in your home directory in the path +(YOURHOMEDIR)\kdepim\apps\kabc\std.vcf + +Copy that file to a moveable disk or memory stick or just copy it via network to the destination. +Import that file into KAddressbook/Kontact via Import - Import vcard. + +Now you have your Outlook200X contact data on the KDE desktop available and you are done with the migration of contacts. + +************************************************************* +6) How to get the calendar data out of Outlook200X +************************************************************* + +Note: When accessing Outlook to read the data, it should not be possible, that there is any data lost in Outlook, because the progam accesses Outlook only Read-Only. + +You have the file +kopi.exe +and the other needed files accessable on your workstation. + +Getting the calendar data + +NOTE: Before extracting the calendar data, it is recommended to extract the contact data first. +If you extract the contact data first, the identity (UID) of attendees of a meeting can be mapped correctly in the newly created appointments, such that you can access the attendee contact data later directly from KOrganizer. + +Please start kopi.exe. + +You will see a dialog, that you started KO/Pi for the first time and that the timezone configuration will be shown now. Confirm with "Ok". + +Now you will see the configuration dialog of KO/Pi. +Please choose your timezone and adjust the daylight saving settings. +The dialog shows defaults for CET (Central European Time), such that users located in central Europe simply can press "OK" in that dialog. +(Note: Don't forget to set the timezone in KDE KOrganizer before importing data there. The timezone in KDE KOrganizer is set per default to UTC (GMT), that is -1h of CET). + +Now you will see the KO/Pi main window. +Choose menu: +File - Import from OL +You will get a dialog which shows all "Personal Folders" of Outlook. +Choose the Calendar Folder(s) you want to import and select them with a hook. +(All other folder but the calendar data containing folders are shown, but disabled) +Click the "import" button. +Now Outllok asks you to allow access to the contact data. +Select "Allow access" amd click "Yes" in this dialog. +Now the importing is performed and KO/Pi will show a progress bar. +After importing, KO/Pi shows a dialog, how much calendar items are imported. +If you press a second time "import" , already imported calendar items are not imported again. +After importing you can choose another "Calendar Folder" to import or close the import dialog. +Please close the import dialog. +Now you see the imported calendar items in KO/Pi. +Please verify, that the import was correct. +About problems of mapping particular Outlook-data-fields to KOrganizer-data-fields see Appendix B). +Close KO/Pi - data will be saved automatically. + +Now you should have the calendar data in the file mycalendar.ics in your home directory in the path +(YOURHOMEDIR)\kdepim\apps\korganizer\mycalendar.ics + +Copy that file to a moveable disk or memory stick or just copy it via network to the destination. +Import that file into KOrganizer/Kontact via Import - Import iCal/ics file. +(Warning again: Don't forget to set the timezone in KDE KOrganizer before importing data there. The timezone in KDE KOrganizer is set per default to UTC (GMT), that is -1h of CET). +Now you have your Outlook200X calendar data on the KDE desktop available and you are done with the migration. + +Hint: +If you want to use KO/Pi and KA/Pi on your windows desktop, you should read all the help information available in the KO/Pi Help menu. One Highlight of KO/Pi is the easy syncing with another *.ics file. +(Information about syncing available in the KO/Pi help menu). +Another hint: +KO/Pi + KA/Pi ( = KDE-Pim/Pi ) are available for the Sharp Zaurus PDA. +Syncing data works for KO/Pi ( version 1.9.3) but not yet for KA/Pi. + + + +************************************************************* +APPENDIX A) Problems and solutions when reading contact data +************************************************************* + +All data, which can be displayed and accessed in KAddressbook is imported from Outlook. +In Outlook you can assign an attribute "This is the mailing address" to one of the addresses. +This address shows up in KAddressbook twice. +The first time with the original attribute from Outlook ( e.g. "work" for "business" in OL ). +The second time with the attribute "postal". + +All telephone numbers of OL are imported. +OL offers special case telephone numbers, like "Assistant", which have no counterpart in KAdressbook. +In that case, the imported number has special combined attributes in KAddressbook. +Here is the mapping of types in OL to attributes in KA: + +OL type Attributes in KA + +Assistant Work + Voice +Business Work +Business2 Work +BusinessFax Work + Fax +Car Car +Home Home +Home2 Home +HomeFax Home + Fax +ISDN Isdn +Mobile Cell (displayed as Mobile Phone) +OtherFax Fax +OtherTelephone Voice +Pager Pager +PrimaryTelephone Pref ( displayed as typeless, with attribute preferred ) +TTYTDD Modem +Telex Fax + Bbs (Bbs displayed as MailBox - not very senseful, sorry ...) +CompanyMain Work + Pref +Radio Video +Callback Voice + Pref + +Some mapping may not be very senseful, but it helps to identify the original OL types. + + +************************************************************* +APPENDIX B) Problems and solutions when reading calendar data +************************************************************* + +Almost all data, which can be displayed and accessed in KOrganizer is imported from Outlook. +Attachments of appointments are not imported. +KOrganizer may crash, when reading some kinds of attachments. +These may be changed in future versions. + +Attendee lists of meetings and their state are imported in KOrganizer. + +A problem is importing some kinds of recurring events: + +First problem: +OL offers a recurrence like +- Yearly recurrence, every second Tuesday of July. +KOrganizer ( in versions < 3.3.0 ) does not offer that kind of recurrence. +Such that +"Yearly recurrence, every second Tuesday of July." +is converted to +"Monthly recurrence, every 12. month, second Tuesday in month, StartMonth = July." +which can be edited in KO. + +Second problem: +OL offers an exception in a recurrence with other data/time. +KO offers only an exception in a recurrence , where the exception is deleted from the row of all occurences. +Such that +"Recurring event with exception, that date XX should be at date YY" +in OL is converted to two events in KO: +"Recurring event with exception, that date XX is not included" +"Non-recurring event at date YY with same data like the recurring event (e.g. Summary, location, attendee list, ...)" + + + + + + + + + -- cgit v0.9.0.2