# Il manuale di &kaddressbook;

## Introduzione

&kaddressbook; è la principale applicazione per la gestione di una rubrica degli indirizzi di &kde;; permette di gestire i contatti in modo comodo ed efficiente. Poiché è basata sulla libreria kabc, gestisce le cosiddette risorse, che possono essere usate per gestire i contatti in molte locazioni diverse — non solo il filesystem locale, ma anche server LDAP o database SQL.

L'interfaccia utente è simile a quella di MS Outlook e gestisce viste multiple per rappresentare i dati dei contatti in vari modi; fornisce inoltre la ricerca incrementale su tutti i campi ed una barra di pulsanti per accedere rapidamente a voci specifiche. Poiché la libreira kabc sottostante usa il formato vCard (specificato nell'RFC 2426) come mezzo di memorizzazione preferito, &kaddressbook; sostanzialmente rispecchia i campi supportati nell'interfaccia utente.

## Usare &kaddressbook;

### Primi passi

Dopo l'avvio di &kaddressbook; (effettuato attraverso il menu del pannello o inserendo `kaddressbook` dalla linea di comando) verrà mostrata la finestra principale di &kaddressbook;:

L'avvio di &kaddressbook; La finestra principale di &kaddressbook;.

La finestra principale di &kaddressbook;.

### Configura risorse

&kaddressbook; può usare diversi tipi di risorse per caricare o conservare i contatti. Dopo un primo avvio di &kaddressbook; verrà installata una risorsa predefinita che memorizza i contatti in un file vCard sotto $HOME/.kde/share/apps/kabc/std.vcf; puoi aggiungere altre risorse usando la finestra di dialogo di configurazione delle risorse, che è disponibile in kcontrol inComponenti di KDE->Configurazione risorse KDE:

La finestra di dialogo Configurazione risorse La finestra di dialogo Configurazione risorse.

La finestra di dialogo Configurazione risorse.

Carica il modulo di configurazione a cui vuoi aggiungere le tue risorse selezionandolo dalla casella combinata presente in cima alla sezione Risorse. Il modulo di &kaddressbook; è contatto.

Avvia la finestra di Configurazione risorse premendo il pulsante Aggiungi.... Scegli la risorsa che vuoi aggiungere al modulo dei contatti e fai clic su OK per confermare la scelta.

Elenco

- ciascun contatto verrà conservato in un file separato;

File

- tutti i contatti saranno conservati in un solo file;

IMAP

- Ancora da scrivere

Kolab

- I contatti saranno conservati nella cartella contatti del tuo account DIMAP.

  Specificità del server Kolab: La risorsa Kolab non dovrebbe mai essere configurata come a sola lettura. Nel caso che tu abbia aggiunto vari tipi di risorsa, è necessario impostare il Server Kolab come la risorsa Standard.

LDAP

- tutti i contatti saranno conservati su un server LDAP;

Rete

- tutti i contatti saranno conservati in un solo file, che può essere localizzato su un server remoto (usando, per esempio HTTP, WebDAV, FTP o Fish).

SLOX

- Ancora da scrivere

XML-RPC

- Ancora da scrivere

Dopo aver selezionato il tipo di risorsa appare un'altra finestra da cui si possono modificare le impostazioni specifiche della risorsa.

I tipi di risorsa File e Directory gestiscono diversi formati in cui memorizzare i contatti:

vCard

- i contatti saranno conservati in formato vCard, come specificato dall'RFC 2426;

binario

- i contatti saranno conservati in un formato binario — questo migliora le prestazioni durante il caricamento ed il salvataggio, ma non è portabile come il formato vCard.

&kaddressbook; ha bisogno di una risorsa standard, in cui memorizzare tutti i contatti se non viene specificata un'altra risorsa; per questo motivo, dopo aver lanciato &kaddressbook; per la prima volta, ci sarà già una risorsa disponibile. Se vuoi cambiare la risorsa standard, usa il pulsante Imposta come standard per selezionarla. Devi avere i permessi di lettura e scrittura per la nuova risorsa standard, altrimenti non ti sarà possibile selezionarla.

### Gestire i contatti

Per creare o modificare i contatti, &kaddressbook; offre una finestra di dialogo da cui puoi inserire tutti i dati che possono essere memorizzati in una vCard.

La finestra di dialogo Contatti La finestra di dialogo Contatti.

La finestra di dialogo Contatti.

#### Analisi automatica del nome

&kaddressbook; cerca di permettere l'immissione semplificata dei nomi attraverso l'analisi automatica del nome; perché questa funzioni correttamente, è a volte necessario aggiungere prefissi, inclusioni o suffissi personalizzati nella finestra di configurazione. Ciò nonostante, nessun algoritmo è perfetto, per cui alcuni nomi possono non essere riconosciuti correttamente; in questo caso, puoi disabilitare l'analisi automatica del nome nella finestra di modifica del nome, disponibile premendo il pulsante Nome... nella finestra dei contatti. Se vuoi disabilitare l'analisi dei nomi per tutti i nuovi contatti puoi farlo dalla finestra di configurazione.

#### Nome esteso

Il nome esteso di un contatto è usato dagli altri programmi per rappresentare il contatto. &kaddressbook; offre tre tipi predefiniti di nomi estesi:

Nome Semplice

- <nome> <cognome>

Nome Completo

- <titoli> <nome> <altri nomi> <cognome> <suffissi>

Nome inverso

- <cognome>, <nome>.

Se nessuno di questi tipi è adeguato alle tue esigenze, puoi scegliere il tipo di nome Personalizzato, da cui puoi inserire il nome completo come preferisci — questa configurazione può essere fatta nella finestra di dialogo di modifica del nome. Per specificare un tipo di nome completo predefinito per i nuovi contatti, usa la finestra di configurazione.

#### Messaggi istantanei

Il campo di testo Indirizzo IM contiene l'indirizzo preferito per i messaggi istantanei di questo contatto. Per aggiungere, vedere e modificare ulteriori indirizzi IM, premi il pulsante Modifica indirizzo IM.... Apparirà la finestra di modifica degli indirizzi IM.

La finestra di modifica degli indirizzi di IM La finestra di modifica degli indirizzi di IM.

La finestra di modifica degli indirizzi IM

Un contatto può avere associati più indirizzi per i messaggi istantanei. Altre applicazioni, come Kopete e Konversation, inseriscono qui le loro informazioni. È raccomandabile aggiungere, modificare e cancellare gli indirizzi per i messaggi istantanei direttamente da Kopete o Konversation invece che da qui, perché questi ti assistono meglio nell'aggiungere l'indirizzo, nell'aggiungere l'utente ad un gruppo, e così via. Se non ti interessa se saranno usati da altre applicazioni, a vuoi semplicemente inserire l'indirizzo per i messaggi istantanei del contatto, allora puoi farlo da qui senza problemi.

Per ulteriori informazioni sull'aggiunta di indirizzi per i messaggi istantanei, vedi il manuale di Kopete ed il manuale di Konversation.

#### Scheda Impostazioni crittografiche

In questa scheda puoi definire le preferenze sulla crittografia di un contatto. Al momento della stesura di questo manuale, solo KMail usa queste preferenze per la composizione dei messaggi. Il meccanismo sostituisce le preferenze crittografiche per-destinatario delle precedenti versioni di KMail, che erano difficilmente utilizzabili.

Protocolli consentiti

- Qui puoi limitare i formati di messaggio crittografico da usare per questo contatto. Vedi la sezione Formati di messaggio crittografico del manuale di KMail per una discussione sui vari formati disponibili.

Chiave di cifratura OpenPGP preferita, Certificato di cifratura S/MIME preferito

- Qui puoi inserire la chiave OpenPGP e/o il certificato S/MIME preferito da usare per la cifratura con questo contatto. Altrimenti verranno cercate le chiavi o i certiificati corrispondenti nel portachiavi locale o nella scatola dei certificati locale.

Preferenze messaggio

- Qui puoi selezionare da un elenco di direttive come interagire con l'utente sia per la firma che per la cifratura.

  <nessuna>

- Nessuna preferenza, usa la modalità preferita da KMail.

Non firmare mai, Non cifrare mai

- Non firma (o cifrare) mai i messaggi per questo contatto. Non chiedere conferma (tranne in caso di conflitti con le preferenze di altri contatti).

Firma sempre, Cifra sempre

- Firma (o cifra) sempre i messaggi per questo contatto. Non chiedere conferma (tranne in caso di conflitti con le preferenze di altri contatti).

Firma sempre, se possibile, Cifra sempre, se possibile

- Firma (o cifra) sempre i messaggi per questo contatto quando è possibile farlo. Non chiedere niente se non è possibile. Le situazioni in cui la firma non è possibile includono quando altri destinatari hanno preferenze sulla firma di "Mai". Le situazioni in cui la cifratura può non essere possibile includono la mancanza di chiavi o certificati per uno o più dei destinatari.

Chiedi conferma

- Chiedi sempre se firmare (o cifrare).

### Usare le viste

Questa versione di &kaddressbook; offre varie viste che mostrano i contatti in modi diversi:

Vista a tabella

- Tutti i contatti sono mostrati in una tabella; possono essere messi in ordine premendo le intestazioni delle colonne della tabella. Le colonne di cui è composta la tabella possono essere scelte dalla finestra di dialogo di configurazione della vista.

Vista ad icone

- I contatti sono mostrati come icone in una vista. Se il contatto contiene una foto o un marchio, questo viene usato nella vista; altrimenti, viene usata l'icona predefinita.

Vista a scheda

- Tutti i contatti sono mostrati come biglietti da visita. I titoli dei biglietti sono i nomi estesi; il corpo dei biglietti dipende da quali campi sono stati selezionati nella finestra di configurazione della vista.

La finestra di configurazione della vista La finestra di configurazione della vista.

La finestra di configurazione della vista.

La pagina Campi selezionati permette di selezionare i dettagli di un contatto da mostrare nella vista. Dalla pagina Filtro predefinito puoi scegliere quale filtro debba essere usato dalla vista.

### Uso dei filtri

Puoi configurare in &kaddressbook; dei filtri che dipendono dalla categoria a cui appartiene un certo contatto. Ad esempio, puoi creare un filtro che selezioni tutti i contatti che apparengono alle categorie 'famiglia' ed 'amici'; puoi anche creare un filtro che selezioni i contatti che non appartengono a queste categorie. Per gestire i filtri, usa la finestra di configurazione dei filtri:

La finestra di configurazione dei filtri La finestra di configurazione dei filtri.

La finestra di configurazione dei filtri.

Si possono usare i filtri per ridurre il numero di contatti mostrati. Nella finestra di configurazione della vista puoi specificare quali filtri attivare normalmente in una vista.

### Uso delle estensioni

Le estensioni sono implementate come plugin in &kaddressbook;, in modo che terze parti possano fornirne altre. Per il momento, ci sono tre estensioni:

Editor dei contatti

- Simile alla finestra di modifica dei contatti, ma progettato per permettere di modificare velocemente i contatti.

Luogo del contatto

- Questa estensione prende l'indirizzo postale del contatto e carica questi dati in servizio di mappe digitali su internet (come www.map24.de); i risultati sono mostrati in una vista HTML.

Gestione liste di di distribuzione

- Questa estensione permette la semplice gestione delle liste di distribuzione: crea una nuova lista e seleziona un contatto nella vista; premendo Aggiungi contatto, il contatto selezionato verrà aggiunto alla lista di distribuzione. Un modo più semplice di procedere è di trascinare un contatto dalla vista e rilasciarlo sul gestore delle liste di distribuzione. Vedi la sezione Menu Impostazioni per maggiori informazioni su come aggiungere un'estensione.

La finestra principale con l'estensione lista di distribuzione. La finestra principale con l'estensione lista di distribuzione.

La finestra principale con l'estensione lista di distribuzione.

### Importazione ed esportazione

Con il nuovo modulo di import/export, &kaddressbook; offre una finestra di dialogo da cui selezionare i contatti da esportare.

La finestra di selezione di esportazione. La finestra di selezione di esportazione.

La finestra di selezione di esportazione.

I seguenti plugin di import/export sono attualmente disponibili:

vCard

- Il formato vCard è uno standard (RFC 2426) che è gestito dalla maggior parte delle applicazioni di rubrica elettronica — &kaddressbook; può importare ed esportare file in formato 2.1 e 3.0;

Telefono mobile

- questo plugin può importare i contatti dai telefoni mobili Nokia usando la libreria gnokii;

Rubrica di Eudora

- con questo plugin puoi importare i contatti dal client di posta Eudora;

CSV

- CSV (comma separated value, cioè valori separati da virgole) è un formato usato da molte applicazioni — puoi importare ed esportare i contatti in questo formato;

KDE2

- per importare i vecchi dati della rubrica di KDE 2.X puoi usare questa voce;

LDIF

- LDIF è una rappresentazione puramente testuale di dati LDAP, ed è usata da Netscape e Mozilla per conservare i dati delle loro rubriche — con questo formato, &kaddressbook; gestisce l'importazione e l'esportazione;

PAB

- PAB è il formato Personal Address Book di MS Exchange, ed è usato da MS Outlook e MS Outlook Express per conservare i dati dei contatti — &kaddressbook; gestisce solo l'importazione da questo formato;

Opera

- usa questo plugin per importare la base dati dei contatti del browser web Opera;

Segnalibri

- questo è un plugin di pseudo-esportazione che rende disponibili gli URL associati ai tuoi contatti al menu dei segnalibri di Konqueror.

### Interrogazioni LDAP

Le informazioni sugli indirizzi dei server LDAP possono essere importate nella rubrica locale di &kaddressbook; usando la finestra di ricerca LDAP.

Per configurare uno o più server LDAP, usa la finestra di configurazione.

Sulla barra degli strumenti principale di &kaddressbook; è disponibile un pulsante con l'immagine di una lente d'ingrandimento; usalo per aprire una finestra per la ricerca su LDAP. La finestra è di uso piuttosto semplice; basta inserire parte di un nome, di un indirizzo di posta elettronica o di un numero di telefono e premere il pulsante Cerca.

Quando i risultati appaiono nella lista, è possibile selezionare uno o più indirizzi; puoi usare il pulsante Aggiungi selezionato per importare gli indirizzi nella rubrica locale, o puoi fare clic su Manda una mail al contatto... per invocare un programma di posta elettronica e scrivere una lettera ai destinatari scelti.

La casella Ricerca ricorsiva è normalmente marcata; in questo modo le interrogazioni LDAP considerano tutti gli oggetti al di sotto del DN base di ogni server. Se ti interessano solo gli oggetti immediatamente al di sotto della base, deseleziona la casella; in caso di dubbio, lasciala selezionata.

### Preferenze

Puoi modificare molti aspetti del comportamento di &kaddressbook; dalla finestre delle preferenze; la finestra può essere aperta selezionando la voce del menu Impostazioni Configura KAddressBook o usando l'icona nella barra degli strumenti.

Configurare &kaddressbook; La finestra delle preferenze.

La finestra delle preferenze.

#### La pagina Rubrica

##### La scheda Generale

Rispetta il singolo click di KDE

- Se la casella è marcata, &kaddressbook; rispetta le convenzioni di KDE sull'uso del clic singolo.

Controllo automatico dei nomi per nuovi indirizzi

- Se questa casella è marcata, verrà usata la funzionalità di analisi automatica dei nomi per gli indirizzi nuovi.

Script-Hooks

- Da qui puoi specificare i comandi da eseguire quando fia clic sul collegamento ad un numero di telefono o di un numero di fax nella pagina dei dettagli.

Estensioni

- Da questa vista puoi abilitare o disabilitare le estensioni una per una, e cambiarne le impostazioni.

##### La scheda Contatto

&kaddressbook; può analizzare un nome per dividerlo nei suoi componenti; per assicurarti che funzioni in molti casi, puoi aggiungere qui parti di nome aggiuntive, come prefissi onorifici, suffissi ed inclusioni.

Prefissi

- Da qui puoi gestire i prefissi, come 'Prof.' o 'Dott.'.

Inclusioni

- Da qui puoi gestire le inclusioni dei nomi, come 'van' o 'von', che sono spesso parte dei nomi Olandesi e Tedeschi.

Suffissi

- Da qui puoi gestire i suffissi come 'Sr.' o 'Jr.'.

Nome esteso predefinito

- Da qui puoi scegliere il tipo predefinito di nome esteso da usare per i nuovi contatti.

#### La pagina Ricerca LDAP

Da questa pagina puoi configurare i server LDAP da usare per le ricerche LDAP di &kaddressbook;.

Usa Aggiungi Host... per aggiungere e configurare un nuovo server.

Configurare la ricerca su LDAP per Kolab Esempio di configurazione della ricerca su LDAP (Kolab).

La finestra Aggiungi host - Esempio di configurazione di ricerca su LDAP (Kolab).

Puoi includere od escludere i server dalla ricerca selezionando o deselezionando le caselle da marcare nella lista dei server. Premi OK per chiudere la finestra di dialogo.

Puoi configurare l'ordine di ricerca spostando su e giù i server nella lista. Questo può essere fatto con le frecce corrispondenti preenti sul lato destro della finestra.

## Guida di riferimento dei comandi

### Il menu File

&Ctrl;N File Nuovo contatto...

- Apre l'editor dei contatti per aggiungere un contatto nuovo.

File Modifica contatto...

- Apre l'editor dei contatti per modificare il contatto attualmente selezionato.

&Ctrl;S File Salva

- Salva i contatti modificati.

File Importa

- Elenca tutti i moduli di importazione disponibili.

File Esporta

- Elenca tutti i moduli di esportazione disponibili.

&Ctrl;P File Stampa

- Stampa i contatti attualmente selezionati.

File Invia una mail al contatto...

- Apre il programma di posta preferito con i contatti attualmente selezionati come destinatari.

File Invia contatto...

- Apre il programma di posta preferito con i dettagli del contatto attualmente selezionato allegato come vCard.

&Ctrl;Q File Esci

- Esce da &kaddressbook;.

### Il menu Modifica

&Ctrl;Z Modifica Annulla

- Annulla l'ultima modifica.

&Ctrl;&Shift;Z Modifica Rifai

- Rifa l'ultima modifica.

&Ctrl;X Modifica Taglia

- Taglia i contatti attualmente selezionati.

&Ctrl;C Modifica Copia

- Copia negli appunti i contatti attualmente selezionati.

&Ctrl;V Modifica Incolla

- Incolla il contenuto degli appunti nella rubrica (se è in un formato valido).

Canc Modifica Elimina contatto

- Elimina i contatti attualmente selezionati.

&Ctrl;A Modifica Seleziona tutto

- Seleziona tutti i contatti.

Modifica Seleziona categorie...

- Apre una finestra di dialogo da cui impostare le categorie a cui appartengono i contatti attualmente selezionati; quando le categorie scelte sono diverse dalle categorie dei contatti, ti verrà chiesto se vuoi unire queste differenze o se le categorie devono essere sovrascritte.

Modifica Imposta "chi sono io"

- Marca il contatto attualmente selezionato come il contatto 'chi sono io'. che rappresenta i dati dell'utente. È importante avere questo contatto, perché altre applicazioni, come &kmail; e &kword;, possono usare questi dati se disponibili: in questo modo non dovrai inserirli separatamente in ogni applicazione.

### Il menu Visualizza

Vista Seleziona vista

- Elenca tutte le viste disponibili.

Vista Aggiungi vista...

- Apre una finestra per creare una nuova vista.

Vista Modifica vista...

- Apre una finestra da cui modificare le impostazioni per la vista corrente.

Vista Cancella vista

- Elimina la vista corrente.

View Aggiorna vista

- Aggiorna la vista corrente.

### Il menu Strumenti

Questo menu formisce gli strumenti per manipolare la base dati dei contatti.

Strumenti Ricerca indirizzi nella directory LDAP...

- Apre la finestra di ricerca per gli indirizzi presenti su server LDAP. Puoi configurare le impostazioni dei server con la finestra di configurazione.

### Il menu Impostazioni

Questo menu fornisce le opzioni per configurare &kaddressbook;, cambiarne l'aspetto, le scorciatoie ed il comportamento predefinito.

Impostazioni Barre degli strumenti

- Mostra o nasconde le barre degli strumenti.

Impostazioni Mostra la barra estensione

- Seleziona quale estensione debba essere mostrata nella barra estensione sul fondo della finestra principale.

Impostazioni Mostra la barra di ricerca alfabetica

- Attiva o disattiva la barra di ricerca alfabetica.

Impostazioni Mostra dettagli

- Attiva e disattiva la pagina dei dettagli.

Impostazioni Modifica filtri...

- Apre una finestra da cui modificare i filtri.

Impostazioni Configura le scorciatoie...

- Apre una finestra per cambiare l'associazione dei tasti. Usando questa opzione si possono cambiare le scorciatoie da tastiera per i comandi di &kaddressbook; o se ne possono creare di nuove.

Impostazioni Configura le barre degli strumenti...

- Apre una finestra per la configurazione della barra degli strumenti. Da qui puoi aggiungere e rimuovere pulsanti per i comandi di &kaddressbook;.

Impostazioni Configura KAddressBook...

- Apre la finestra delle preferenze.

### Il menu Aiuto

&help.menu.documentation;

## Opzioni da linea di comando

&kaddressbook; gestisce alcuni argomenti da linea di comando, che possono essere usati per cambiare il comportamento all'avvio:

`kaddressbook` `-a, --addr <email>`

- Mostra l'editor dei contatti con l'indirizzo email fornito.

`kaddressbook` `--uid <uid>`

- Mostra l'editor dei contatti con l'uid fornito.

`kaddressbook` `--editor-only`

- Avvia in modalità solo-edit.

`kaddressbook` `--new-contact`

- Avvia la maschera per la creazione di un nuovo contatto.

&kaddressbook; gestisce anche le opzioni da linea di comando comuni a tutti i programmi di &kde; e &Qt;. Puoi veder e la lista di queste opzioni con ``--help``, ``--help-kde`` e ``--help-qt``.

## Riconoscimenti e licenze

&kaddressbook; - la rubrica degli indirizzi di &kde;

Copyright (c) 1997-2003,Il team di KDE-PIM

&kaddressbook; è stato scritto in origine nel 1997 da Don Sanders dsanders@kde.org. Attualmente il responsabile è Tobias Koenig tokoe@kde.org.

&underFDL;