author | zautrix <zautrix> | 2004-08-06 10:57:10 (UTC) |
---|---|---|
committer | zautrix <zautrix> | 2004-08-06 10:57:10 (UTC) |
commit | fc862590cffbef8429bb8804dadfa61a21a52c7b (patch) (unidiff) | |
tree | 0ce6e4eabe0285f1efe1119c5c5a8958957011e7 /bin/kdepim/korganizer | |
parent | cde989298c4891f54ad70ae03080ac8fa57b5c3f (diff) | |
download | kdepimpi-fc862590cffbef8429bb8804dadfa61a21a52c7b.zip kdepimpi-fc862590cffbef8429bb8804dadfa61a21a52c7b.tar.gz kdepimpi-fc862590cffbef8429bb8804dadfa61a21a52c7b.tar.bz2 |
Moved Migration howto file
-rw-r--r-- | bin/kdepim/korganizer/Migration-HowTo.txt | 386 |
1 files changed, 0 insertions, 386 deletions
diff --git a/bin/kdepim/korganizer/Migration-HowTo.txt b/bin/kdepim/korganizer/Migration-HowTo.txt deleted file mode 100644 index 0fc7f70..0000000 --- a/bin/kdepim/korganizer/Migration-HowTo.txt +++ b/dev/null | |||
@@ -1,386 +0,0 @@ | |||
1 | |||
2 | Migration HowTo Outlook 200X -> KDE | ||
3 | |||
4 | Version 1.0.2 | ||
5 | The latest version of this file can be downloaded from | ||
6 | http://sourceforge.net/projects/kdepimpi/ | ||
7 | Please choose there package/project/file: | ||
8 | general Files for KDE/Pim | ||
9 | MigrationHowTo_OL2KDE | ||
10 | MigrationHowTo_OL2KDE.txt.zip | ||
11 | |||
12 | |||
13 | This HowTo describes the process of migrating data ( contact and calendar data ) from Outlook 200X to the PIM programs of the KDE-Desktop-Environment. | ||
14 | The PIM programs are KAdddressbook and KOrganizer, which may be used embedded in the Kontact PIM management framework. | ||
15 | This HowTo describes version 1.9.3a of the migration tools. | ||
16 | The migration tools are the platform independent versions of KAdddressbook and KOrganizer: KAdddressbook/Pi and KOrganizer/Pi. | ||
17 | |||
18 | Content: | ||
19 | |||
20 | 1) How to start | ||
21 | 2) How to import pst files in Outlook | ||
22 | 3) Where to get the migration tools | ||
23 | 4) How to install the migration tools | ||
24 | 5) How to get the contact data out of Outlook200X | ||
25 | 6) How to get the calendar data out of Outlook200X | ||
26 | 7) How to import your contact data into Kontact | ||
27 | 8) How to import your calendar data into Kontact | ||
28 | |||
29 | APPENDIX A) Problems and solutions when reading contact data | ||
30 | APPENDIX B) Problems and solutions when reading calendar data | ||
31 | |||
32 | **************************************** | ||
33 | 1) How to start | ||
34 | **************************************** | ||
35 | |||
36 | For the migration we need the actual Outlook 200X data, which Outlook stores in *.pst files. | ||
37 | Then we need an installed version of Outlook 200X to access these *.pst files. | ||
38 | When we have an Outllook 200X running with all data accessable, we need the migration tools. | ||
39 | |||
40 | If you have no Outlook200X installed please install the Outlook version, you need to a import your *.pst files. | ||
41 | 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. | ||
42 | If you have a running Outlook200X already with contact/calendar data available, please continue with: 3) Where to get the migration tools. | ||
43 | |||
44 | |||
45 | **************************************** | ||
46 | 2) How to import pst files in Outlook | ||
47 | **************************************** | ||
48 | |||
49 | To open a local *.pst file in Outlook2003, choose menu: | ||
50 | File - Open - Outlook Data File ... | ||
51 | Now the data included in this file is shown | ||
52 | as folders of a newly added root folder in the Outlook folder view. | ||
53 | This root folder is probably not accessable from | ||
54 | the migration tools via OLE. | ||
55 | To access data stored in one of the subfolders, | ||
56 | copy this subfolder to a root folder, | ||
57 | which can be accessed from the migration tools via OLE. | ||
58 | (To know, which folder can be accessed, just perform 5.) or 6.) until | ||
59 | you get the Oulook import dialog!) | ||
60 | |||
61 | To copy it, right click on that subfolder and choose | ||
62 | Copy "<subfoldername>"... | ||
63 | in the popup menu. | ||
64 | |||
65 | **************************************** | ||
66 | 3) Where to get the migration tools | ||
67 | **************************************** | ||
68 | |||
69 | The data migration is is performed with the Windows versions of KAdddressbook/Pi and KOrganizer/Pi. | ||
70 | Pi stands for platform-independend - platform-independend because the same program is available for different platforms, like Windows, Linux desktop and Sharp-Zaurus PDA. | ||
71 | 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. | ||
72 | |||
73 | The programs you need for the migration are: | ||
74 | a) KAdddressbook/Pi executeable + 2dlls + icons | ||
75 | b) KOrganizer/Pi executeable + icons | ||
76 | c) The Qt3 library qt-mt331.dll and the MSVC library msvcr71.dll and the MSVC library mfc71u.dll | ||
77 | You can download all of them at: | ||
78 | |||
79 | http://sourceforge.net/projects/kdepimpi/ | ||
80 | |||
81 | Download of a) and b) | ||
82 | Please choose there package/project with name KDE/Pim | ||
83 | (Direct link: http://sourceforge.net/project/showfiles.php?group_id=104103&package_id=112604 ) | ||
84 | Choose there the topmost latest version and the files | ||
85 | kapixxx-exe.zip | ||
86 | kopixxx-exe.zip | ||
87 | The latest version is currently ( 2004-07-13 ) 1.9.3a. | ||
88 | Such that the files to download are | ||
89 | kapi193a-exe.zip | ||
90 | kopi193a-exe.zip | ||
91 | |||
92 | To download c) | ||
93 | Please choose there package/project/file: | ||
94 | general Files for KDE/Pim | ||
95 | Needed Windows Dlls | ||
96 | kdepimdll.zip | ||
97 | |||
98 | (Direct link: http://sourceforge.net/project/showfiles.php?group_id=104103&package_id=122438&release_id=256700 ) | ||
99 | Choose there the file: | ||
100 | kdepimdll.zip | ||
101 | |||
102 | Now you have downloaded the files | ||
103 | |||
104 | kapi193a-exe.zip | ||
105 | kopi193a-exe.zip | ||
106 | kdepimdll.zip | ||
107 | |||
108 | and we can continue to install the files, which is simply unzipping them. | ||
109 | |||
110 | |||
111 | **************************************** | ||
112 | 4) How to install the migration tools | ||
113 | **************************************** | ||
114 | |||
115 | You have downloaded the files | ||
116 | |||
117 | kapi193a-exe.zip | ||
118 | kopi193a-exe.zip | ||
119 | kdepimdll.zip | ||
120 | |||
121 | Unzip these files. | ||
122 | Now choose an arbitrary installation directory, where to copy all the needed files together. | ||
123 | You should have now the following files and the directory "kdepim" in the same directory: | ||
124 | kopi.exe | ||
125 | kapi.exe | ||
126 | microkabc_dir.dll | ||
127 | microkabc_file.dll | ||
128 | msvcr71.dll | ||
129 | mfc71u.dll | ||
130 | qt-mt331.dll | ||
131 | ReadMich.txt | ||
132 | kdepim (directory) | ||
133 | |||
134 | The directory "kdepim" should contain subdirectories | ||
135 | kaddressbook | ||
136 | korganizer | ||
137 | which itself contain some subdirectories with icons and help text. | ||
138 | |||
139 | Now the migration tools are ready for use. | ||
140 | |||
141 | |||
142 | NOTE AND HINT for performing migration on many workstations: | ||
143 | Just burn the content of the installation dir on a CD. | ||
144 | Then you can put the CD in every workstation and execute the migration tools from that CD directly. | ||
145 | |||
146 | |||
147 | ************************************************************* | ||
148 | 5) How to get the contact data out of Outlook200X | ||
149 | ************************************************************* | ||
150 | |||
151 | 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. | ||
152 | |||
153 | You have the file | ||
154 | kapi.exe | ||
155 | and the other needed files accessable on your workstation. | ||
156 | |||
157 | Getting the contact data | ||
158 | |||
159 | Please start kapi.exe. | ||
160 | Choose menu: | ||
161 | File - Import - Import from OL... | ||
162 | You will get a dialog which shows all "Personal Folders" of Outlook. | ||
163 | Choose the Contact Folder(s) you want to import and select them with a hook. | ||
164 | (All other folder but the contact containing folders are shown, but disabled). | ||
165 | (If the data you want to import is not stored in one of the shown folders, | ||
166 | please read step 2.) and click on "close" ). | ||
167 | Click the "import" button. | ||
168 | Now Outlook asks you to allow access to the contact data. | ||
169 | Select "Allow access" amd click "Yes" in this dialog. | ||
170 | Now the importing is performed and KA/Pi will show a progress bar. | ||
171 | After importing, KA/Pi shows a dialog, how much contacts are imported. | ||
172 | If you press a second time "import" , already imported contacts are not imported again. | ||
173 | After importing you can choose another "Contact Folder" to import or close the import dialog. | ||
174 | Please close the import dialog. | ||
175 | Now you see the imported contacts in KA/Pi on the left in the list view. | ||
176 | Please verify, that the import was correct. | ||
177 | About problems of mapping particular Outlook-data-fields to KAdressbook-data-fields see Appendix A). | ||
178 | |||
179 | Choose menu: | ||
180 | File - Save | ||
181 | and close KA/Pi. | ||
182 | Now you should have the contact data in the file std.vcf in your home directory in the path | ||
183 | (YOURHOMEDIR)\kdepim\apps\kabc\std.vcf | ||
184 | |||
185 | Copy that file to a moveable disk or memory stick or just copy it via network to the destination. | ||
186 | Import that file into KAddressbook/Kontact via Import - Import vcard. | ||
187 | Details about importing you can read at: 7) How to import your contact data into Kontact | ||
188 | |||
189 | Now you have your Outlook200X contact data on the KDE desktop available and you are done with the migration of contacts. | ||
190 | |||
191 | ************************************************************* | ||
192 | 6) How to get the calendar data out of Outlook200X | ||
193 | ************************************************************* | ||
194 | |||
195 | 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. | ||
196 | |||
197 | You have the file | ||
198 | kopi.exe | ||
199 | and the other needed files accessable on your workstation. | ||
200 | |||
201 | Getting the calendar data | ||
202 | |||
203 | NOTE: Before extracting the calendar data, it is recommended to extract the contact data first. | ||
204 | 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. | ||
205 | |||
206 | Please start kopi.exe. | ||
207 | |||
208 | 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". | ||
209 | |||
210 | Now you will see the configuration dialog of KO/Pi. | ||
211 | Please choose your timezone and adjust the daylight saving settings. | ||
212 | The dialog shows defaults for CET (Central European Time), such that users located in central Europe simply can press "OK" in that dialog. | ||
213 | (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). | ||
214 | |||
215 | Now you will see the KO/Pi main window. | ||
216 | Choose menu: | ||
217 | File - Import from OL | ||
218 | You will get a dialog which shows all "Personal Folders" of Outlook. | ||
219 | Choose the Calendar Folder(s) you want to import and select them with a hook. | ||
220 | (All other folder but the calendar data containing folders are shown, but disabled). | ||
221 | (If the data you want to import is not stored in one of the shown folders, | ||
222 | please read step 2.) and click on "close" ). | ||
223 | Click the "import" button. | ||
224 | Now Outllok asks you to allow access to the contact data. | ||
225 | Select "Allow access" amd click "Yes" in this dialog. | ||
226 | Now the importing is performed and KO/Pi will show a progress bar. | ||
227 | After importing, KO/Pi shows a dialog, how much calendar items are imported. | ||
228 | If you press a second time "import" , already imported calendar items are not imported again. | ||
229 | After importing you can choose another "Calendar Folder" to import or close the import dialog. | ||
230 | Please close the import dialog. | ||
231 | Now you see the imported calendar items in KO/Pi. | ||
232 | Please verify, that the import was correct. | ||
233 | About problems of mapping particular Outlook-data-fields to KOrganizer-data-fields see Appendix B). | ||
234 | Close KO/Pi - data will be saved automatically. | ||
235 | |||
236 | Now you should have the calendar data in the file mycalendar.ics in your home directory in the path | ||
237 | (YOURHOMEDIR)\kdepim\apps\korganizer\mycalendar.ics | ||
238 | |||
239 | Copy that file to a moveable disk or memory stick or just copy it via network to the destination. | ||
240 | Import that file into KOrganizer/Kontact. | ||
241 | Details about importing your calendar data you can read at: 8) How to import your calendar data into Kontact. | ||
242 | (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). | ||
243 | Now you have your Outlook200X calendar data on the KDE desktop available and you are done with the migration. | ||
244 | |||
245 | Hint: | ||
246 | 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. | ||
247 | (Information about syncing available in the KO/Pi help menu). | ||
248 | Another hint: | ||
249 | KO/Pi + KA/Pi ( = KDE-Pim/Pi ) are available for the Sharp Zaurus PDA. | ||
250 | Syncing data works for KO/Pi ( version 1.9.3) but not yet for KA/Pi. | ||
251 | |||
252 | |||
253 | ************************************************************* | ||
254 | 7) How to import your contact data into Kontact | ||
255 | ************************************************************* | ||
256 | |||
257 | We want to import and upload our contacts to a Kolab server. | ||
258 | You should have access to a properly configured Kolab client. | ||
259 | This Kolab client is Kontact in KDE. | ||
260 | Make sure, you have the needed IMAP resources configured in KAddressbook. | ||
261 | To configure IMAP resources, you should do: | ||
262 | |||
263 | Open KDE control center, choose there | ||
264 | KDE Components - KDE Resource Configuration | ||
265 | Choose there: | ||
266 | Resources: contact | ||
267 | and then: | ||
268 | Add... | ||
269 | IMAP | ||
270 | |||
271 | Now start Kontact and select the Contacts icon on the left side. | ||
272 | Choose menu: | ||
273 | File... - Import - Import VCard... | ||
274 | Select the imap resource as destination of the import | ||
275 | and choose the file to import. | ||
276 | Now the contacts should be imported and you are done. | ||
277 | |||
278 | Don't forget to sync the IMAP account to upload to contacts to the server. | ||
279 | |||
280 | ************************************************************* | ||
281 | 8) How to import your calendar data into Kontact | ||
282 | ************************************************************* | ||
283 | |||
284 | We want to import and upload our calendar data to a Kolab server. | ||
285 | You should have access to a properly configured Kolab client. | ||
286 | This Kolab client is Kontact in KDE. | ||
287 | Make sure, you have the needed IMAP resources configured in KOrganizer. | ||
288 | To configure IMAP resources, you should do: | ||
289 | |||
290 | Open KDE control center, choose there | ||
291 | KDE Components - KDE Resource Configuration | ||
292 | Choose there: | ||
293 | Resources: calendar | ||
294 | and then: | ||
295 | Add... | ||
296 | Calendar on IMAP-server via KMail | ||
297 | |||
298 | Now start Kontact and select the Calendar icon on the left side. | ||
299 | Choose menu: | ||
300 | File... - Import - Merge Calendar... | ||
301 | Select the imap resource as destination of the import | ||
302 | and choose the file to import. | ||
303 | Now the calendar data should be imported and you are done. | ||
304 | |||
305 | Don't forget to sync the IMAP account to upload the calendar data to the server. | ||
306 | |||
307 | ************************************************************* | ||
308 | APPENDIX A) Problems and solutions when reading contact data | ||
309 | ************************************************************* | ||
310 | |||
311 | All data, which can be displayed and accessed in KAddressbook is imported from Outlook. | ||
312 | In Outlook you can assign an attribute "This is the mailing address" to one of the addresses. | ||
313 | This address shows up in KAddressbook twice. | ||
314 | The first time with the original attribute from Outlook ( e.g. "work" for "business" in OL ). | ||
315 | The second time with the attribute "postal". | ||
316 | |||
317 | All telephone numbers of OL are imported. | ||
318 | OL offers special case telephone numbers, like "Assistant", which have no counterpart in KAdressbook. | ||
319 | In that case, the imported number has special combined attributes in KAddressbook. | ||
320 | Here is the mapping of types in OL to attributes in KA: | ||
321 | |||
322 | OL type Attributes in KA | ||
323 | |||
324 | Assistant Work + Voice | ||
325 | Business Work | ||
326 | Business2 Work | ||
327 | BusinessFax Work + Fax | ||
328 | Car Car | ||
329 | Home Home | ||
330 | Home2 Home | ||
331 | HomeFax Home + Fax | ||
332 | ISDN Isdn | ||
333 | Mobile Cell (displayed as Mobile Phone) | ||
334 | OtherFax Fax | ||
335 | OtherTelephone Voice | ||
336 | Pager Pager | ||
337 | PrimaryTelephone Pref ( displayed as typeless, with attribute preferred ) | ||
338 | TTYTDD Modem | ||
339 | Telex Fax + Bbs (Bbs displayed as MailBox - not very senseful, sorry ...) | ||
340 | CompanyMain Work + Pref | ||
341 | Radio Video | ||
342 | Callback Voice + Pref | ||
343 | |||
344 | Some mapping may not be very senseful, but it helps to identify the original OL types. | ||
345 | |||
346 | |||
347 | ************************************************************* | ||
348 | APPENDIX B) Problems and solutions when reading calendar data | ||
349 | ************************************************************* | ||
350 | |||
351 | Almost all data, which can be displayed and accessed in KOrganizer is imported from Outlook. | ||
352 | Attachments of appointments are not imported. | ||
353 | KOrganizer may crash, when reading some kinds of attachments. | ||
354 | These may be changed in future versions. | ||
355 | |||
356 | Attendee lists of meetings and their state are imported in KOrganizer. | ||
357 | |||
358 | A problem is importing some kinds of recurring events: | ||
359 | |||
360 | First problem: | ||
361 | OL offers a recurrence like | ||
362 | - Yearly recurrence, every second Tuesday of July. | ||
363 | KOrganizer ( in versions < 3.3.0 ) does not offer that kind of recurrence. | ||
364 | Such that | ||
365 | "Yearly recurrence, every second Tuesday of July." | ||
366 | is converted to | ||
367 | "Monthly recurrence, every 12. month, second Tuesday in month, StartMonth = July." | ||
368 | which can be edited in KO. | ||
369 | |||
370 | Second problem: | ||
371 | OL offers an exception in a recurrence with other data/time. | ||
372 | KO offers only an exception in a recurrence , where the exception is deleted from the row of all occurences. | ||
373 | Such that | ||
374 | "Recurring event with exception, that date XX should be at date YY" | ||
375 | in OL is converted to two events in KO: | ||
376 | "Recurring event with exception, that date XX is not included" | ||
377 | "Non-recurring event at date YY with same data like the recurring event (e.g. Summary, location, attendee list, ...)" | ||
378 | |||
379 | |||
380 | |||
381 | |||
382 | |||
383 | |||
384 | |||
385 | |||
386 | |||