summaryrefslogtreecommitdiffabout
Unidiff
Diffstat (more/less context) (show whitespace changes)
-rw-r--r--bin/kdepim/korganizer/Migration-HowTo.txt299
1 files changed, 299 insertions, 0 deletions
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 @@
1
2Migration HowTo Outlook 200X -> KDE
3
4This HowTo describes the process of migrating data ( contact and calendar data ) from Outlook 200X to the PIM programs of the KDE-Desktop-Environment.
5The PIM programs are KAdddressbook and KOrganizer, which may be used embedded in the Kontact PIM management framework.
6This HowTo describes version 1.9.3a of the migration tools.
7The migration tools are the platform independent versions of KAdddressbook and KOrganizer: KAdddressbook/Pi and KOrganizer/Pi.
8
9Content:
10
111) How to start
122) How to import pst files in Outlook
133) Where to get the migration tools
144) How to install the migration tools
155) How to get the contact data out of Outlook200X
166) How to get the calendar data out of Outlook200X
17
18APPENDIX A) Problems and solutions when reading contact data
19APPENDIX B) Problems and solutions when reading calendar data
20
21****************************************
221) How to start
23****************************************
24
25For the migration we need the actual Outlook 200X data, which Outlook stores in *.pst files.
26Then we need an installed version of Outlook 200X to access these *.pst files.
27When we have an Outllook 200X running with all data accessable, we need the migration tools.
28
29If you have no Outlook200X installed please install the Outlook version, you need to a import your *.pst files.
30If 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.
31If you have a running Outlook200X already with contact/calendar data available, please continue with: 3) Where to get the migration tools.
32
33
34****************************************
352) How to import pst files in Outlook
36****************************************
37
38MISSING
39
40****************************************
413) Where to get the migration tools
42****************************************
43
44The data migration is is performed with the Windows versions of KAdddressbook/Pi and KOrganizer/Pi.
45Pi stands for platform-independend - platform-independend because the same program is available for different platforms, like Windows, Linux desktop and Sharp-Zaurus PDA.
46Note: 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.
47
48The programs you need for the migration are:
49a) KAdddressbook/Pi executeable + 2dlls + icons
50b) KOrganizer/Pi executeable + icons
51c) The Qt3 library qt-mt331.dll and the MSVC library msvcr71.dll
52
53You can download all of them at:
54
55http://sourceforge.net/projects/kdepimpi/
56
57Download of a) and b)
58Please choose there package/project with name KDE/Pim
59(Direct link: http://sourceforge.net/project/showfiles.php?group_id=104103&package_id=112604 )
60Choose there the topmost latest version and the files
61kapixxx-exe.zip
62kopixxx-exe.zip
63The latest version is currently ( 2004-07-13 ) 1.9.3a.
64Such that the files to download are
65kapi193a-exe.zip
66kopi193a-exe.zip
67
68To download b)
69Please choose there package/project with name KO/Pi - general files.
70(Direct link: http://sourceforge.net/project/showfiles.php?group_id=104103&package_id=116719 )
71Choose there the file:
72kopidll.zip
73
74Now you have downloaded the files
75
76kapi193a-exe.zip
77kopi193a-exe.zip
78kopidll.zip
79
80and we can continue to install the files, which is simply unzipping them.
81
82
83****************************************
844) How to install the migration tools
85****************************************
86
87You have downloaded the files
88
89kapi193a-exe.zip
90kopi193a-exe.zip
91kopidll.zip
92
93Unzip these files.
94The directory "pics" of the kopidll.zip is useless now and can be completely ignored.
95Now choose an arbitrary installation directory, where to copy all the needed files together.
96You should have now the following files and the directory "kdepim" in the same directory:
97kopi.exe
98kapi.exe
99microkabc_dir.dll
100microkabc_file.dll
101msvcr71.dll
102qt-mt331.dll
103ReadMich.txt
104kdepim (directory)
105
106The directory "kdepim" should contain subdirectories
107kaddressbook
108korganizer
109which itself contain some subdirectories with icons and help text.
110
111Now the migration tools are ready for use.
112
113
114NOTE AND HINT for performing migration on many workstations:
115Just burn the content of the installation dir on a CD.
116Then you can put the CD in every workstation and execute the migration tools from that CD directly.
117
118
119*************************************************************
1205) How to get the contact data out of Outlook200X
121*************************************************************
122
123Note: 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.
124
125You have the file
126kapi.exe
127and the other needed files accessable on your workstation.
128
129Getting the contact data
130
131Please start kapi.exe.
132Choose menu:
133File - Import - Import from OL...
134You will get a dialog which shows all "Personal Folders" of Outlook.
135Choose the Contact Folder(s) you want to import and select them with a hook.
136(All other folder but the contact containing folders are shown, but disabled)
137Click the "import" button.
138Now Outlook asks you to allow access to the contact data.
139Select "Allow access" amd click "Yes" in this dialog.
140Now the importing is performed and KA/Pi will show a progress bar.
141After importing, KA/Pi shows a dialog, how much contacts are imported.
142If you press a second time "import" , already imported contacts are not imported again.
143After importing you can choose another "Contact Folder" to import or close the import dialog.
144Please close the import dialog.
145Now you see the imported contacts in KA/Pi on the left in the list view.
146Please verify, that the import was correct.
147About problems of mapping particular Outlook-data-fields to KAdressbook-data-fields see Appendix A).
148
149Choose menu:
150File - Save
151and close KA/Pi.
152Now you should have the contact data in the file std.vcf in your home directory in the path
153(YOURHOMEDIR)\kdepim\apps\kabc\std.vcf
154
155Copy that file to a moveable disk or memory stick or just copy it via network to the destination.
156Import that file into KAddressbook/Kontact via Import - Import vcard.
157
158Now you have your Outlook200X contact data on the KDE desktop available and you are done with the migration of contacts.
159
160*************************************************************
1616) How to get the calendar data out of Outlook200X
162*************************************************************
163
164Note: 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.
165
166You have the file
167kopi.exe
168and the other needed files accessable on your workstation.
169
170Getting the calendar data
171
172NOTE: Before extracting the calendar data, it is recommended to extract the contact data first.
173If 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.
174
175Please start kopi.exe.
176
177You 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".
178
179Now you will see the configuration dialog of KO/Pi.
180Please choose your timezone and adjust the daylight saving settings.
181The dialog shows defaults for CET (Central European Time), such that users located in central Europe simply can press "OK" in that dialog.
182(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).
183
184Now you will see the KO/Pi main window.
185Choose menu:
186File - Import from OL
187You will get a dialog which shows all "Personal Folders" of Outlook.
188Choose the Calendar Folder(s) you want to import and select them with a hook.
189(All other folder but the calendar data containing folders are shown, but disabled)
190Click the "import" button.
191Now Outllok asks you to allow access to the contact data.
192Select "Allow access" amd click "Yes" in this dialog.
193Now the importing is performed and KO/Pi will show a progress bar.
194After importing, KO/Pi shows a dialog, how much calendar items are imported.
195If you press a second time "import" , already imported calendar items are not imported again.
196After importing you can choose another "Calendar Folder" to import or close the import dialog.
197Please close the import dialog.
198Now you see the imported calendar items in KO/Pi.
199Please verify, that the import was correct.
200About problems of mapping particular Outlook-data-fields to KOrganizer-data-fields see Appendix B).
201Close KO/Pi - data will be saved automatically.
202
203Now you should have the calendar data in the file mycalendar.ics in your home directory in the path
204(YOURHOMEDIR)\kdepim\apps\korganizer\mycalendar.ics
205
206Copy that file to a moveable disk or memory stick or just copy it via network to the destination.
207Import that file into KOrganizer/Kontact via Import - Import iCal/ics file.
208(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).
209Now you have your Outlook200X calendar data on the KDE desktop available and you are done with the migration.
210
211Hint:
212If 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.
213(Information about syncing available in the KO/Pi help menu).
214Another hint:
215KO/Pi + KA/Pi ( = KDE-Pim/Pi ) are available for the Sharp Zaurus PDA.
216Syncing data works for KO/Pi ( version 1.9.3) but not yet for KA/Pi.
217
218
219
220*************************************************************
221APPENDIX A) Problems and solutions when reading contact data
222*************************************************************
223
224All data, which can be displayed and accessed in KAddressbook is imported from Outlook.
225In Outlook you can assign an attribute "This is the mailing address" to one of the addresses.
226This address shows up in KAddressbook twice.
227The first time with the original attribute from Outlook ( e.g. "work" for "business" in OL ).
228The second time with the attribute "postal".
229
230All telephone numbers of OL are imported.
231OL offers special case telephone numbers, like "Assistant", which have no counterpart in KAdressbook.
232In that case, the imported number has special combined attributes in KAddressbook.
233Here is the mapping of types in OL to attributes in KA:
234
235OL type Attributes in KA
236
237Assistant Work + Voice
238Business Work
239Business2 Work
240BusinessFax Work + Fax
241Car Car
242Home Home
243Home2 Home
244HomeFax Home + Fax
245ISDN Isdn
246Mobile Cell (displayed as Mobile Phone)
247OtherFax Fax
248OtherTelephone Voice
249Pager Pager
250PrimaryTelephone Pref ( displayed as typeless, with attribute preferred )
251TTYTDD Modem
252Telex Fax + Bbs (Bbs displayed as MailBox - not very senseful, sorry ...)
253CompanyMain Work + Pref
254Radio Video
255Callback Voice + Pref
256
257Some mapping may not be very senseful, but it helps to identify the original OL types.
258
259
260*************************************************************
261APPENDIX B) Problems and solutions when reading calendar data
262*************************************************************
263
264Almost all data, which can be displayed and accessed in KOrganizer is imported from Outlook.
265Attachments of appointments are not imported.
266KOrganizer may crash, when reading some kinds of attachments.
267These may be changed in future versions.
268
269Attendee lists of meetings and their state are imported in KOrganizer.
270
271A problem is importing some kinds of recurring events:
272
273First problem:
274OL offers a recurrence like
275- Yearly recurrence, every second Tuesday of July.
276KOrganizer ( in versions < 3.3.0 ) does not offer that kind of recurrence.
277Such that
278"Yearly recurrence, every second Tuesday of July."
279is converted to
280"Monthly recurrence, every 12. month, second Tuesday in month, StartMonth = July."
281which can be edited in KO.
282
283Second problem:
284OL offers an exception in a recurrence with other data/time.
285KO offers only an exception in a recurrence , where the exception is deleted from the row of all occurences.
286Such that
287"Recurring event with exception, that date XX should be at date YY"
288in OL is converted to two events in KO:
289"Recurring event with exception, that date XX is not included"
290"Non-recurring event at date YY with same data like the recurring event (e.g. Summary, location, attendee list, ...)"
291
292
293
294
295
296
297
298
299