| -rw-r--r-- | bin/kdepim/SyncHowto.txt | 102 |
1 files changed, 28 insertions, 74 deletions
diff --git a/bin/kdepim/SyncHowto.txt b/bin/kdepim/SyncHowto.txt index b0473a1..a901616 100644 --- a/bin/kdepim/SyncHowto.txt +++ b/bin/kdepim/SyncHowto.txt @@ -1,90 +1,83 @@ WARNING: -YOU MAY GET UNEXPECTED (I.E. WRONG) SYNCHRONIZATION RESULTS, -IF YOU CHANGE AN EVENT ON THE FIRST DEVICE AND SYNC IMMEDIATELY FROM -THE OTHER DEVICE WITH THIS DEVICE, IF THE CLOCKS OF THE TWO DEVICES -HAVE TOO MUCH DIFFERENCE. +YOU MAY GET UNEXPECTED (I.E. WRONG) SYNCHRONIZATION RESULTS, IF YOU CHANGE AN EVENT ON THE FIRST DEVICE AND SYNC IMMEDIATELY FROM THE OTHER DEVICE WITH THIS DEVICE, IF THE CLOCKS OF THE TWO DEVICES HAVE TOO MUCH DIFFERENCE. -In other words: Please make sure, that the clocks of the devices -you want to sync have only a difference of some seconds! +In other words: Please make sure, that the clocks of the devices you want to sync have only a difference of some seconds! CONTENT: 0) How syncing works 1) Qick overview of settings 2) Sync settings in sync dialog 3) Syncing background 4) Sync preferences 5) How a filter works 6) Details about sync profile kinds ************************************************************************* 0) How syncing works ************************************************************************* Note: -The recommended and easiest way to syncronize two devices where -KO/Pi, KA/Pi or PWM/Pi is installed, is the profile kind "Pi-Sync". +The recommended and easiest way to syncronize two devices where KO/Pi, KA/Pi or PWM/Pi is installed, is the profile kind "Pi-Sync". Details about that in 6) b). -In KDE-Pim/Pi you can synchronize ( sync ) your calendar/addressbook/ -passwordfile with another calendar/addressbook/passwordfile, -by syncing your (local) calendar/addressbook/passwordfile +In KDE-Pim/Pi you can synchronize ( sync ) your +calendar/addressbook/passwordfile with another c +alendar/addressbook/passwordfile, +by syncing your (local) +calendar/addressbook/passwordfile with a (remote) file. This remote file may on your local filesystem or on another (remote) device. If you want to sync with another remote device, you have to create a sync profile. You have two choices for choosing the profil kind: I) You can choose profile kind "Remote file" and specify a command line download/upload command ( like scp, ftp, ...) to a) download the remote file to your local machine to a temp file b) sync with this temp file c) upload the synced file to the remote device II) If you want to sync with a device, where KO/Pi( or KA/Pi, PWM/Pi) is installed, you can easily get the remote file via network with the build in file transfer feature: Choose profile kind "Pi-Sync" and a) Start KO/Pi,KA/Pi or PWM/Pi on remote device and enable "Pi-Sync" on remote device with password and port. b) Specify password, port and IP address in your profile. You can sync with your mobile phone as well. Everything is explained in more details below. NOTE: -If you do not use profile kind "Pi-Sync", -it is recommended to close -a running KO/Pi (KA/Pi, PWM/Pi) on the remote device. +If you do not use profile kind "Pi-Sync", it is recommended to close a running KO/Pi (KA/Pi, PWM/Pi) on the remote device. (Note: KO/Pi(KA/Pi, PWM/Pi) running on Zaurus with FastLoad enabled will never be closed!) -After syncing with a running KO/Pi on the remote device, -a "save" on the remote device will tell you that it needs to merge (sync). -After merging (just a syncing with the changed file) -you will get the new data showing in remote KO/Pi. +After syncing with a running KO/Pi on the remote device, a "save" on the remote device will tell you that it needs to merge (sync). +After merging (just a syncing with the changed file) you will get the new data showing in remote KO/Pi. ************************************************************************* 1) Qick overview of settings ************************************************************************* a) Open sync settings dialog (Menu Synchronize - Configure...) b) Give your device a unique name. (unique in the set of all devices you want to sync with). If you have already configured another devive and created there a sync profile to sync with this device, give your device the same name as this sync profile! The same name is important, because it makes it possible to sync first A->B (A local device, that performs the sync, B remote device) and then B->A. Such that the B->A sync knows about the already performed A->B sync. That means: It is unimportant if you sync A->B or B->A, the devices A and B will be synced properly. c) Create a new sync profile and give it a unique name. (unique in the set of all sync profiles on this device). If you want to sync with a device, where KO/Pi is already installed and which has a given unique device name, use this device name as your profile name ( refer to b) ). d) Choose the profile kind of your syncing method: (i) Local file or @@ -184,165 +177,126 @@ i) Apply filter when adding data to remote: If there is an event in the local database which is not "public", but "private", this event is not added to the remote database. If there is an event in the local database and in the remote database which is "private" (maybe added by someone else) then this event is synced and it is in the local database and in the remote database after syncing. That means in particular you cannot remove an event from the remote database but setting it to "private". If you want to remove the event you can clone it, set it to private and delete the original event. Then the original event is deleted in the remote database after sync and the cloned event is not added to the remote database, because it is private. j) Write back (calendar) entries for time period only: Check this to write back only calendar entries for a given time period. (Useful when syncing with mobile phones.) You can specify the date range in weeks for the weeks in the past to the weeks in the future. k) Profile kind: Details -> 6) ************************************************************************* 3) Syncing background ************************************************************************* The same mentioned for calendars is valid for addressbooks as well. -Synchronizing calendars ( i.e. files ) means, -to merge two calendars in a useful way. -If the two calendars are completely different, -there is no problem, the resulting calendar contains -all data from the local and from the remote calendar. - -Problems will occur, if you have edited items -from the local calendar on the remote machine. -Then it could be, that items are in conflict. -Two items are "in conflict", if they have the -same unique ID (which get an item at time of -creation and owns it until it is deleted ) -and they both are modified after the last -synchronization. - -At first sync of two calendars there is no item deleted. -If the calendars are synced before and there is an item, -which is not edited after the last sync and is only -available in one calendar, then this item is deleted -in this calendar. +Synchronizing calendars ( i.e. files ) means, to merge two calendars in a useful way. If the two calendars are completely different, there is no problem, the resulting calendar contains all data from the local and from the remote calendar. + +Problems will occur, if you have edited items from the local calendar on the remote machine. Then it could be, that items are in conflict. Two items are "in conflict", if they have the same unique ID (which get an item at time of creation and owns it until it is deleted ) and they both are modified after the last synchronization. + +At first sync of two calendars there is no item deleted. If the calendars are synced before and there is an item, which is not edited after the last sync and is only available in one calendar, then this item is deleted in this calendar. But when was the last synchronization between two calendars? -To know that, KO/Pi creates at first syncing -of two files an unique event "<profile name> - sync Event" -on the remote and the local calendar. -After syncing, the start time of this event is set -to the time of syncing. -The event is read only and the user may not change it. +To know that, KO/Pi creates at first syncing of two files an unique event "<profile name> - sync Event" on the remote and the local calendar. After syncing, the start time of this event is set to the time of syncing. The event is read only and the user may not change it. -If two such files are synced, that both have an event -"<profile name> - sync Event" and the events have -the same start time, then deleted items on the one calendar -are deleted on the other as well. +If two such files are synced, that both have an event "<profile name> - sync Event" and the events have the same start time, then deleted items on the one calendar are deleted on the other as well. ************************************************************************* 4) Sync preferences ************************************************************************* -Two items are "in conflict", if they have the same unique ID -and they both are modified after the last synchronization. +Two items are "in conflict", if they have the same unique ID and they both are modified after the last synchronization. (Details -> 3) ). -If an item is not modified after the last sync and -it is not found in the other calendar, it is deleted. +If an item is not modified after the last sync and it is not found in the other calendar, it is deleted. On the first sync, there is no item deleted. SYNC PREFERENCES: -Take local entry on conflict: Takes the local entry on conflict. If it is the first sync, "Ask for every entry" is chosen automatically, if this is selected. -Take remote entry on conflict: Takes the remote entry on conflict. If it is the first sync, "Ask for every entry" is chosen automatically, if this is selected. -Take newest entry on conflict: This takes the newest entry on conflict. May be the most useful syncing mode. -Ask for every entry on conflict: Pops up an event viewer dialog and shows the two conflicting entries there. The user can chose, which entry he would like to take. The button for the newest entry is automatically set as default button. The color for the newest entry is green. -Force: Take local entry always: Even if the calendars are already synced there is no item deleted on local. -Force: Take remote entry always: Analogous to "Force: Take local entry always" ************************************************************************* 5) How a filter works ************************************************************************* -A filter is a rule to decide if a particular item -(calendar iten item or contact item) belongs to a set of items. +A filter is a rule to decide if a particular item (calendar iten item or contact item) belongs to a set of items. For example, you can specify a set as: Only items, that belongs to that category. Or: Only items, that does not belong to that category. Or: Only items, that are public. -If you specify a filter in a syncing profile, you can set the -rules of adding items to the local or remote database. +If you specify a filter in a syncing profile, you can set the rules of adding items to the local or remote database. Example: -You have a public calendar in your company, which contains all -company relevant data. - -You have different projects in the company and for project specific events -is always set the project name as a category: -E.g. all events of the project PRO_ABC do have set the categorie PRO_ABC. -But you are not interested in events of PRO_ABC, because you are not working on it. -Then you can specify a filter: All, but not with categoroy PRO_ABC. -When you specify this filter as an incoming filter for your sync profile, -all events of the company are synced and added to your local calendar, but not -the evenst of the project PRO_ABC. - -You do not want that your private data can be seen -in the public calendar of your company. -Well, set the property to "private" for all your private data -and specify an outgoing filter: Only " public" and "confidential". -Then you can sync your personal calendar with the calendar of the company, -but your private data is not added to the public calendar. +You have a public calendar in your company, which contains all company relevant data. + +You have different projects in the company and for project specific events is always set the project name as a category: +E.g. all events of the project PRO_ABC do have set the categorie PRO_ABC. But you are not interested in events of PRO_ABC, because you are not working on it. Then you can specify a filter: All, but not with categoroy PRO_ABC. When you specify this filter as an incoming filter for your sync profile, all events of the company are synced and added to your local calendar, but not the evenst of the project PRO_ABC. + +You do not want that your private data can be seen in the public calendar of your company. Well, set the property to "private" for all your private data and specify an outgoing filter: Only " public" and "confidential". Then you can sync your personal calendar with the calendar of the company, but your private data is not added to the public calendar. ************************************************************************* 6) Details about sync profile kinds ************************************************************************* a) Local file Please specify a local file you want to sync with. Note: If you are syncing a file, which is used by KA/Pi, please check the "Addressbook file (*.vcf) is used by KA/Pi". If you are syncing with a file from KAddressbook or another program, please uncheck "Addressbook file (*.vcf) is used by KA/Pi". To set this properly is important! KA/Pi uses a "last modified" property, which is not supported by KAddressbook. b) Pi-Sync (direct Kx/Pi to Kx/Pi sync) We mention here only KO/Pi, but the same is valid for KA/Pi. If you want to sync with a device, where KO/Pi is installed, you can easily get the remote file via network with the build in file transfer feature "Pi-Sync": You have first to enable file transfer on the remote device: - Start KO/Pi on the remote device. - Choose Menu Synchronize-Enable Pi-Sync. - Choose a port number, where KO/Pi should listen for file sending requests. Valid port numbers are numbers |