# &appname; in dettaglio

## Tipi di campo

Ogni collezione può avere un numero illimitato di campi. &appname; supporta undici tipi di campo, che permettono di gestire molti tipi di dati.

### Testo semplice

Il tipo di campo più basilare è detto testo semplice. Non vi sono restrizioni sui valori inseriti in questo campo, e il meccanismo di immissione dati è una semplice casella di testo. Questo tipo di campo è adatto per valori di lunghezza non eccessiva, come ad esempio autori o generi.

### Numero

Il tipo di campo numero è identico a testo semplice, ad eccezione del fatto che i dati devono essere numerici. Gli elementi saranno ordinati numericamente nella vista a colonne se viene fatto clic sulla colonna di un campo numero. La casella di immissione è una casella di testo con frecce per aumentare o diminuire il valore. A questo campo non viene applicata formattazione.

### &URL;

Il tipo di campo &URL; permette di inserire collegamenti ad altri documenti che verranno aperti usando il programma predefinito &kde;. La validità del percorso &URL; non viene verificata, semplicemente i collegamenti non validi non verranno aperti. La casella di immissione è una casella di testo con un pulsante per aprire la finestra standard Apri file sebbene si possa usare ogni tipo valido di &URL;. Le &URL; relative vengono interpretate come relative al percorso dove verrà salvato il file dati.

Nell'editor degli elementi l'etichetta diventa un collegamento, mentre nella vista degli elementi viene usato un collegamento ipertestuale. Questo tipo di campo è utile per collegare, per esempio, file PDF di voci bibliografiche o recensioni di film. Non gli viene applicata nessuna formattazione.

Si possono usare anche &URL; relative. Questi vengono interpretate come relative al percorso del file dati di &appname;. Nell'editor degli elementila casella di immissione dispone dell'auto completamento per i file locali. Se si vuole che l'&URL; venga interpretata come relativa anche quando il file viene selezionato dalla finestra di scelta file &kde;, una proprietà del campo &URL; deve essere impostata come relative : true.

### Paragrafo

Per campi di testo lunghi il tipo paragrafo offre una casella di testo più ampia, e forma sempre una categoria a se stante. Un campo paragrafo non ammette valori multipli, né viene formattato automaticamente. Non può essere usato per il raggruppamento. Estratti, trame, riassunti o recensioni andrebbero inserite utilizzando questo tipo di campo.

### Scelta

Quando i valori di un campo devono essere limitati ad un certo numero si usa il tipo scelta. I valori ammessi sono mostrati in una casella a cascata da cui vengono selezionati. Sono permessi valori multipli. Campi come genere bibliografico o valutazione personale sono campi di tipo scelta.

Per separare i valori ammessi si usa un punto e virgola.

### Casella

Per i campi di valore sì/no è disponibile il tipo casella. Come valore predefinito la casella non è spuntata. I campi casella non vengono formattati e sono limitati ad un solo valore. Internamente i valori sono registrati come `true` o `false`. Alcuni esempi sono i campi regalo o prestato.

### Data

Il campo data include Anno, mese e giorno. La data viene mostrata nel formato standard AAAA-MM-GG, che permette un migliore ordinamento. Si può usare il selettore di data standard &kde; per scegliere la data con il mouse o inserirla direttamente. Il campo non richiede tutti i valori, quindi ad esempio può essere inserito soltanto l'anno. Non permette valori multipli.

### Tabella

Il campo tabella contiene una o più colonne di valori. Nell'editor degli elementi il campo viene rappresentato come una specie di foglio elettronico con righe numerate. Una riga aggiuntiva viene automaticamente aggiunta quando si seleziona l'ultima riga visibile. Il completamento automatico non è disponibile. Il campo risulta utile per una lista di capitoli di un libro, o per le canzoni di un album musicale. I campi tabella formano sempre una categoria a sé stante.

Il numero di colonne, fino ad un massimo di dieci, viene definito aggiungendo una proprietà con nome columns alla definizione del campo. Può essere assegnato un nome alle colonne facendo clic col tasto destro del mouse sull'intestazione di colonna o aggiungendo una proprietà del tipo column1, ecc.

Usando l'editor degli elementi per un campo tabella si possono spostare le colonne tenendo premuto il tasto &Ctrl; e trascinandole con il mouse. Facendo clic con tasto destro del mouse sulla tabella si aprirà un menu a comparsa che permette di inserire e rimuovere righe.

### Immagine

Il campo immagine contiene un immagine, tra quelle supportate da &kde;. Tra queste ad esempio PNG o JPEG. Le immagini possono essere salvate all'interno del file di collezione &appname; o nella cartella dati dell'applicazione.Per selezionare le immagini viene usata la finestra standard di &kde; e si può usare sia un file locale che un &URL;. Le immagini possono essere anche trascinate da un gestore di file o browser web.

### Valutazione

Il campo valutazione mostra un numero di stelle equivalente al valore numerico di valutazione per un dato elemento. Il valore predefinito è ad un massimo di cinque stelle. Il numero minimo e quello massimo possono essere cambiati nelle proprietà estese nella finestra campi della collezione, usando rispettivamente minimum e maximum.

### Campi di valori derivati

I campi con valori derivati sono un caso speciale. Sono equivalenti agli altri tipi di campo, però il loro valore è costruito a partire da quello di altri campi, e usano una stringa nel campo descrizione. Per esempio, se il campo ha un modello di valore `%{title} %{year}` i valori del campo consisteranno del titolo seguito dall'anno di pubblicazione. Questo tipo di campo viene usato principalmente per il campo titolo in collezioni di monete, francobolli, carte collezionabili e vini. Sia il campo nome interno che il campo titolo possono essere usati nella descrizione per la formattazione.

Per selezionare solo un valore singolo in un campo con valori multipli occorre aggiungere un indice di posizione, ad esempio `%{author:1}` per il primo autore. La posizione può essere negativa, significa che si sta contando dalla fine; così `%{author:-1}` rappresenta l'ultimo autore. Le lettere maiuscole e quelle minuscole possono essere usate per impostare modelli di contrassegni, come `%{author:1/l}` per il primo autore con la lettera minuscola e `%{author:1/u}` per quello con la lettera maiuscola.

## Tipi di collezione

&appname; supporta 12 specifici tipi di collezioni predefinite: libri,bibliografie, fumetti, video, musica, videogiochi, carte collezionabili, monete, francobolli, vini, giochi da tavolo e cataloghi di file. Inoltre, è disponibile un modello di collezione generico per qualsiasi altro genere da collezione. Le collezioni predefinite includono una serie di campi generici e si può modificarle o aggiungere nuovi campi per adattarle ai propri bisogni. L'unico requisito è che una collezione deve avere sempre un campo titolo, in modo che la vista di gruppo funzioni correttamente. Per alcuni tipi di collezione il campo titolo è semplicemente un campo dipendente che combina due o più altri campi.

In linea di massima non ci sono differenze di funzionalità tra i vari tipi di collezione. Si può creare una collezione personalizzata per i propri libri in modo altrettanto semplice dell'usare la collezione di libri predefinita. Tuttavia &appname; ha delle icone basate sul tipo di collezione e alcune funzioni specifiche che sono limitate ad un dato tipo di collezione e per questo, se possibile, si dovrebbero usare i modelli predefiniti. Quindi se si vuole creare una nuova collezione di vini ma non ci piacciono i campi predefiniti basta creare una collezione standard, cancellare tutti i campi e ricreare quelli che si vogliono. In questo modo &appname; riconosce comunque che si tratta di una collezione di vini.

Come comportamento predefinito tutti i tipi di collezione includono un campo ID, che mostra il numero ID della voce. Inoltre, fatta eccezione per le collezioni fi file, ciascuna collezione include dei campi che mostrano la data in cui la voce è stata creata nella collezione e l'ultima volta in cui è stata modificata.

### Collezioni di libri

La collezione di libri ha 27 campi predefiniti: Titolo, Sottotitolo, Autore, Rilegatura, Data d'acquisto, Prezzo d'acquisto, Casa editrice, Edizione, Copyright Anno, Anno di pubblicazione, ISBN, LCCN, Pagine, Lingua, Genere, Parole chiave, Collana, Numero, Condizioni, Autografato, Letto, Regalo, Prestato, Voto, Copertina, Riassunto della trama, e Commenti.

Il campo ISBN#, è particolare in quanto i numeri ISBN vengono formattati automaticamente e il numero di controllo anch'esso calcolato in automatico. &appname; riconosce un campo come ISBN se il suo nome interno è isbn. Nel caso il campo sia stato cancellato, o qualora si abbia bisogno di aggiungerlo ad un altro tipo di collezione basta creare un nuovo campo di titolo ISBN e applicare i cambiamenti. Successivamente il titolo del campo può essere modificato liberamente. &appname; crea i nomi interni sulla base del titolo iniziale, ma in caso di modifiche successive il nome interno non viene comunque modificato.

### Bibliografie

Le bibliografie hanno 25 campi predefiniti: Titolo, Tipo di elemento, Autore, Chiave Bibtex, Titolo del libro, Editore, Organizzazione, Casa editrice, ISBN#, Indirizzo, Edizione, Pagine, Anno, Rivista, Mese, Numero, Pubblicato come, Capitolo, Collana, Volume, Riferimento incrociato, Parole chiave, Estratto, e Note.

Anche se la collezione bibliografia non è specificamente legata a bibtex, l'insieme dei campi è preso da un tipico gruppo di campi bibtex. Quando si esporta in bibtex una proprietà chiamata bibtex viene usata in ogni campo per definire il campo bibtex corrispondente. Se si aggiunge un campo aggiuntivo ad una bibliografia e si vuole esportarlo in bibtex assicurarsi di aggiungere l'appropriata proprietà bibtex.

&appname; ha alcune funzioni specifiche per le bibliografie. Le stringhe macro di bibtex possono essere aggiunte, modificate o cancellate in &appname; e esportando in bibtex si può scegliere di espandere le macro. Le citazioni bibtex possono essere inviate ad un'applicazione esterna come LyX o Kile usando la cosiddetta lyxpipe.

Le collezioni di libri possono essere convertite in bibliografie. I campi predefiniti di bibtex verranno automaticamente aggiunti e le proprietà di bibtex impostate. Questa funzione è stata implementata soprattutto per convertire le vecchie collezioni, prima che le collezioni di libri e bibliografie venissero divise.

### Collezione di fumetti

La collezione di fumetti ha 23 campi predefiniti: Titolo, Sottotitolo, Sceneggiatore, Artista, Collana, Numero, Casa editrice, Edizione, Anno di pubblicazione, Pagine, Paese, Lingua, Genere, Parole chiave, Condizioni, Data d'acquisto, Prezzo d'acquisto, Autografato, Regalo, Prestato, Copertina, Riassunto della trama, e Commenti.

### Collezione di video

La collezione di video ha 30 campi predefiniti: Titolo, Supporto, Anno di produzione, Certificazioni, Genere, Regione, Nazionalità, Formato, Cast, Regista, Produttore, Sceneggiatore, Compositore, Studio, Lingue audio, Lingue dei sottotitoli, Tracce audio, Durata, Tipo di visualizzazione, Widescreen, Colore, Director's Cut, Trama-Riassunto, Valutazione personale, Data d'acquisto, Prezzo d'acquisto, Regalo, Prestato, Copertina, e Commenti.

Il campo Cast è una tabella con due colonne in cui il nome degli attori è inserito nella prima colonna e il ruolo nella seconda. La durata è intesa in minuti, anche se naturalmente non è una regola.

### Collezione di musica

La collezione di musica ha 15 campi predefiniti: Titolo, Supporto, Artista, Etichetta, Anno, Genere, Tracce, Voto, Data d'acquisto, Prezzo d'acquisto, Regalo, Prestato, Parole chiave, Copertina, e Commenti.

### Collezioni di videogiochi

La collezione di videogiochi ha 16 campi predefiniti: Titolo, Piattaforma, Genere, Anno, Editore, Sviluppatore, Classificazione ESRB, Descrizione, Valutazione personale, Finito, Data d'acquisto, Prezzo d'acquisto, Regalo, Prestato, Copertina, e Commenti..

### Collezione di carte

La collezione di carte ha 17 campi predefiniti: Titolo, Giocatore, Squadra, Marchio, Carta numero, Anno, Collana, Tipo di carta, Data d'acquisto, Prezzo d'acquisto, Collocazione, Regalo, Parole chiave, Quantità, Immagine frontale, Immagine posteriore, e Commenti.

### Collezione di monete

La collezione di monete ha 16 campi predefiniti: Titolo, Tipo, Denominazione, Anno, Segno di zecca, Paese, Serie, Stato, Servizi di valutazione, Data d'acquisto, Prezzo d'acquisto, Collocazione, Regalo, Dritto (Recto), Rovescio (Verso), e Commenti.

### Collezione di francobolli

La collezione di francobolli ha 18 campi predefiniti: Titolo, Descrizione, Denominazione, Paese, Anno di emissione, Colore, Scott#, Stato, Annullato, Linguellato, Centratura, Gommato, Data d'acquisto, Prezzo d'acquisto, Collocazione, Regalo, Immagine, e Commenti.

### Collezione di vini

La collezione di vini ha 15 campi predefiniti: Titolo, Produttore, Denominazione, Varietà, Tipo, Paese, Data di acquisto, Prezzo d'acquisto, Collocazione, Quantità, Da bere entro, Voto, Regalo, Immagine dell'etichetta, e Commenti.

### Collezione di giochi da tavolo

La collezione di giochi da tavolo ha 17 campi predefiniti: Titolo, Genere, Meccanismo, Anno, Casa editrice, Ideatore, Numero di giocatori, Tempo di gioco, Età minima, Descrizione, Voto, Data di acquisto, Prezzo d'acquisto, Regalo, Prestato, Copertina, e Commenti.

### Catalogo di file

Il catalogo di file ha 14 campi predefiniti: Nome, &URL;, Descrizione, Volume, Cartella, Tipo MIME, Dimensioni, Permessi, Proprietario, Gruppo, Data creazione, Ultima modifica, Meta informazioni, e Icona.

### Collezioni personalizzate

Le collezioni personalizzate hanno un solo campo predefinito, quello del titolo. Vanno usate quando gli oggetti collezionati non rientrano in alcuna delle categorie predefinite.