Akonadi and AddressBook/sv: Difference between revisions

From KDE Wiki Sandbox
(no longer fuzzy)
(Updating to match new version of source page)
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
<languages />
<languages />
{{Note|This article also apply to other applications that are using [[Special:myLanguage/Akonadi|Akonadi]] for example KMail and KOrganizer.}}


''Den här informationen kommer från Tobias Koenig, utvecklare av KDE-PIM.''
''Den här informationen kommer från Tobias Koenig, utvecklare av KDE-PIM.''
Line 5: Line 7:
==Några definitioner==
==Några definitioner==


<span class="mw-translate-fuzzy">
By ''real data'' we mean the data, like the contacts or events. These data are stored either on a groupware server or in local files. Where exactly depends on the resource you are using. E.g. the ''Personal Contacts'' resource stores its data under $HOME/.local/share/contacts while the ''VCard File'' resource (which is not recommended to use anyway [[Image:Face-smile.png|16px]]) stores its data under $HOME/.kde/share/apps/kabc/std.vcf.
Med 'riktig data' menar vi data som t.ex. kontakter och planerade möten. Sådan data lagras antingen på en groupware server eller i lokala filer. Exakt var beror på vilken resurs som används. Resursen 'Personliga Kontakter' lagrar t.ex. sin data i $HOME/.local/share/contacts medan resursen 'VCard Fil' (som för övrigt inte borde användas [[Image:Face-smile.png]]) lagrar sin data i $HOME/.kde/share/apps/kabc/std.vcf.
 
</span>
The ''cached data'' are copies of the real data that are kept in the database for faster access and offline caching. The database also keeps the ''meta data'' which are management data needed by '''Akonadi''' to work correctly.
 
The ''configuration data'' are the data that configure the '''Akonadi''' server and the individual resources. The configuration data for the server can be found under $HOME/.config/akonadi, the configuration for the resources are mostly stored under $HOME/.kde/share/config/akonadi_xyz_resourcerc# ('''''xyz''''' is name of resource and '''''#''''' its instance number).
 
The '''Akonadi''' server configuration is a couple of files in ''$HOME/.config/akonadi'' - this can be changed through environment variables, $XDG_DATA_HOME and $XDG_CONFIG_HOME, defaulting to ''$HOME/.local/share'' and ''$HOME/.config'' respectively if not set.  It contains which data sources and helper programs are active and will be started and watched (so they can be restarted on crashes) by one of '''Akonadi's''' server processes '''(akonadi_control)'''.  KDE's local base directory can be changed using $KDEHOME environment variable, defaulting to $HOME/.kde when not set (or to $HOME/.kde4 if the distributor changed the default by patching the code).
See {{Input|1=kde4-config --path data}}


<span class="mw-translate-fuzzy">
Each data source handler (called resources) or helper program (called agents)
Den 'cachade datan' är kopior av den 'riktiga datan' som lagras i databasen för snabbare åtkomst och offline caching. Databasen lagrar även 'meta data' som krävs för att Akonadi ska kunna hantera databasen.
can have its own configuration although some agents or resources don't require configuration.  The general rule is that for every entry in $HOME/.config/akonadi/agentsrc there is a corresponding configuration file in $HOME/.kde/share/config.  For example, if the [Instances] section in agentrc contains an entry for akonadi_ical_resource_2, there is also a config file called akonadi_ical_resource_2rc in the KDE config directory.
</span>


<span class="mw-translate-fuzzy">
Depending on the type of data, such config files for resources will have
'Konfigurationsdata' är data som konfigurerar Akonadi-servern och de individuella resurserna. Konfigurationsdatan som används till servern lagras i $HOME/.config/akonadi, medan datan för de olika resurserna ofta lagras i $HOME/.kde/share/config/akonadi_xyz_resourcerc# (xyz är namnet på resursen och # är dess instansnummer).
filenames or directory names of where the data is stored.  Common locations are KDE's legacy default files, e.g. $HOME/.kde/share/apps/korganizer/std.ics. New default locations are files and directories in $HOME/.local/share,  
</span>
e.g. $HOME/.local/share/contacts.
 
For now (as in actually released versions) the database is merely used for
caching and keeping structural information (e.g. which addressbook a contact
belongs to).  This will change when Akonadi is being used for email, since state information like read/unread is also stored there (unless the backend is also capable of doing this, e.g. IMAP).


==Hantera säkerhetskopior==
==Hantera säkerhetskopior==


<span class="mw-translate-fuzzy">
So now we need to decide what to back up.  If you want to backup the "real data", then it depends on the resources you have configured... if you use a groupware server, then the backup should be done there. For contacts, the files under $HOME/.local/share/contacts will normally be what you need.
Nu måste vi bestämma vad som ska säkerhetskopieras. Om du vill spara den 'riktiga datan' beror det på vilka resurser du har konfigurerat... om du använder en groupware server borde säkerhetskopian göras där. Gäller det kontakter är det oftast bara filerna i $HOME/.local/share/contacts som du behöver.
</span>
 
<span class="mw-translate-fuzzy">
Akonadi-ikonen nere i hörnet erbjuder funktioner för att säkerhetskopiera och återställa. Den funktionen lagrar bara den 'cachade datan' som inte alltid innehåller all din data! Det kan vara användbart om du vill göra en system 1:1 klon, för att kopiera den cachade datan och den riktiga datan och konfigurationsdatan, så du slipper ladda all data från källan igen (t.ex. groupware servern).
</span>


The '''Akonadi''' tray icon offers you a backup and restore function.  That backs up the "cache data" which might not include all of your data!  It can be helpful if you want to clone a system 1:1, then you can copy the cached data together with the real data and the configuration, so you don't have to load the data again from the sources (e.g. groupware server).
<span id="Examining your Resources"></span>
==Undersök dina resurser==
==Undersök dina resurser==


<span class="mw-translate-fuzzy">
'''KRunner''' offers you '''Akonadi Resource Configuration''', or you can access this through the <menuchoice>Akonadi tray icon -> Configure</menuchoice>. From KDE 4.6 you will find it in <menuchoice>System Settings -> Personal Information</menuchoice> You may find several resources set up.  You may find one labelled
KRunner erbjuder Akonadi Resurskonfigurering, samma som du kan nå genom att klicka på Akonadi-ikonen nere i hörnet och sedan alternativet Konfigurera. Där kan det finnas flera resursinställningar. Du kanske har en som kallas
</span>


''Adressbok'' - Du har inte konfigurerat någon KDE-adressbok-plugin än.
''Adressbok'' - Du har inte konfigurerat någon KDE-adressbok-plugin än.
Line 40: Line 44:
''std.vcf'' - Klar
''std.vcf'' - Klar


<span class="mw-translate-fuzzy">
This is the ''VCard File Resource'' which points to $HOME/.kde/share/apps/kabc/std.vcf per default. It is not recommended that you use that one, as it doesn't share the benefit of '''Akonadi'''.
Det här är 'VCard Filresurs' som pekar på $HOME/.kde/share/apps/kabc/std.vcf normalt sett. Vi rekommenderar att du inte använder den, eftersom den inte utnyttjar fördelarna med Akonadi.
</span>


''Personliga Kontakter'' - Offline
''Personliga Kontakter'' - Offline


Det här är den resurs du borde använda för dina lokala kontakter, som pekar till
That's the preferred resource for your local contacts which points to
  $HOME/.local/share/contacts
{{Output|1=$HOME/.local/share/contacts}}


Observera att den kan säga "Offline" även om du faktiskt använder den. Det är en visuell bug och kan tryggt ignoreras.
<!--T:17-->
Note that this may say "Offline" when in fact you are using it. This is a display bug, and can safely be ignored.


==Vad händer när fler komponenter använder Akonadi?==
==Vad händer när fler komponenter använder Akonadi?==


<span class="mw-translate-fuzzy">
When the rest of the components move to '''Akonadi''', will all the data be under ~/.local/share? That should make backup easy. Well, contacts and mails are stored there now, I don't know what the plan for events/todos is, but it would make sense to store them there as well. We'll keep it in mind when discussion pops up!
När allla andra komponenter flyttar till Akonadi, kommer all data lagras i ~/.local/share? Det hade gjort säkerhetskopiering enklare. Kontakter och epost lagras där redan nu, jag vet inte vad planen är för kalenderdata är, men det hade passat bra att lagra dem där med. Det är något vi kommer ha i tankarna när diskussionen sätter igång!
 
</span>
==Troubleshooting==
 
''Problem'':  You update to 4.6 and your addressbook is suddenly completely blank
 
''Solution'':  This is new behaviour in 4.6 - you can choose whether to display specific addressbooks or all of them.  In front of each addressbook name there is a checkbox.  Use that to enable the addressbooks you want to use.
 
== Related pages ==
 
:[[Special:myLanguage/Akonadi|Akonadi]]<br />
:[[Special:myLanguage/KAddressBook/index|KAddressBook]]


[[Category:System/sv]]
[[Category:System/sv]]

Latest revision as of 11:00, 19 January 2019

Note
This article also apply to other applications that are using Akonadi for example KMail and KOrganizer.


Den här informationen kommer från Tobias Koenig, utvecklare av KDE-PIM.

Några definitioner

By real data we mean the data, like the contacts or events. These data are stored either on a groupware server or in local files. Where exactly depends on the resource you are using. E.g. the Personal Contacts resource stores its data under $HOME/.local/share/contacts while the VCard File resource (which is not recommended to use anyway ) stores its data under $HOME/.kde/share/apps/kabc/std.vcf.

The cached data are copies of the real data that are kept in the database for faster access and offline caching. The database also keeps the meta data which are management data needed by Akonadi to work correctly.

The configuration data are the data that configure the Akonadi server and the individual resources. The configuration data for the server can be found under $HOME/.config/akonadi, the configuration for the resources are mostly stored under $HOME/.kde/share/config/akonadi_xyz_resourcerc# (xyz is name of resource and # its instance number).

The Akonadi server configuration is a couple of files in $HOME/.config/akonadi - this can be changed through environment variables, $XDG_DATA_HOME and $XDG_CONFIG_HOME, defaulting to $HOME/.local/share and $HOME/.config respectively if not set. It contains which data sources and helper programs are active and will be started and watched (so they can be restarted on crashes) by one of Akonadi's server processes (akonadi_control). KDE's local base directory can be changed using $KDEHOME environment variable, defaulting to $HOME/.kde when not set (or to $HOME/.kde4 if the distributor changed the default by patching the code).

See

kde4-config --path data

Each data source handler (called resources) or helper program (called agents) can have its own configuration although some agents or resources don't require configuration. The general rule is that for every entry in $HOME/.config/akonadi/agentsrc there is a corresponding configuration file in $HOME/.kde/share/config. For example, if the [Instances] section in agentrc contains an entry for akonadi_ical_resource_2, there is also a config file called akonadi_ical_resource_2rc in the KDE config directory.

Depending on the type of data, such config files for resources will have filenames or directory names of where the data is stored. Common locations are KDE's legacy default files, e.g. $HOME/.kde/share/apps/korganizer/std.ics. New default locations are files and directories in $HOME/.local/share, e.g. $HOME/.local/share/contacts.

For now (as in actually released versions) the database is merely used for caching and keeping structural information (e.g. which addressbook a contact belongs to). This will change when Akonadi is being used for email, since state information like read/unread is also stored there (unless the backend is also capable of doing this, e.g. IMAP).

Hantera säkerhetskopior

So now we need to decide what to back up. If you want to backup the "real data", then it depends on the resources you have configured... if you use a groupware server, then the backup should be done there. For contacts, the files under $HOME/.local/share/contacts will normally be what you need.

The Akonadi tray icon offers you a backup and restore function. That backs up the "cache data" which might not include all of your data! It can be helpful if you want to clone a system 1:1, then you can copy the cached data together with the real data and the configuration, so you don't have to load the data again from the sources (e.g. groupware server).

Undersök dina resurser

KRunner offers you Akonadi Resource Configuration, or you can access this through the Akonadi tray icon -> Configure. From KDE 4.6 you will find it in System Settings -> Personal Information You may find several resources set up. You may find one labelled

Adressbok - Du har inte konfigurerat någon KDE-adressbok-plugin än.

Det är den gamla kompatibilitetsbron (möjligtvis skapad av migrationsverktyget). Du borde ta bort den!

std.vcf - Klar

This is the VCard File Resource which points to $HOME/.kde/share/apps/kabc/std.vcf per default. It is not recommended that you use that one, as it doesn't share the benefit of Akonadi.

Personliga Kontakter - Offline

That's the preferred resource for your local contacts which points to

$HOME/.local/share/contacts

Note that this may say "Offline" when in fact you are using it. This is a display bug, and can safely be ignored.

Vad händer när fler komponenter använder Akonadi?

When the rest of the components move to Akonadi, will all the data be under ~/.local/share? That should make backup easy. Well, contacts and mails are stored there now, I don't know what the plan for events/todos is, but it would make sense to store them there as well. We'll keep it in mind when discussion pops up!

Troubleshooting

Problem: You update to 4.6 and your addressbook is suddenly completely blank

Solution: This is new behaviour in 4.6 - you can choose whether to display specific addressbooks or all of them. In front of each addressbook name there is a checkbox. Use that to enable the addressbooks you want to use.

Related pages

Akonadi
KAddressBook