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