# Importare ed esportare i dati

&appname; è in grado di importare ed esportare vari tipi di file dati e di cercare informazioni in vari siti Internet.

## Importare dati da Internet

&appname; è in grado di effettuare ricerche in vari siti Internet utilizzando la finestra Ricerca Internet. Gli elementi posso essere importati direttamente e aggiunti all'attuale collezione. I vari fornitori sono configurati attraverso leOpzioni della fonte dei dati.

Le ricerche possono utilizzare diversi criteri: Titolo, Persona, ISBN, UPC/EAN, LCCN, o Parole chiave. Non tutti i criteri sono disponibili per alcune fonti di dati. I valori di ISBN e LCCN sono solo per i libri, mentre i valori UPC o EAN si applicano a ogni tipo di elemento.

Quando una ricerca viene avviata il pulsante Cerca diventa Ferma che, se premuto, terminerà la ricerca. Se vengono trovati risultati questi vengono aggiunti alla lista sotto la casella di ricerca, e selezionandone uno verrà visualizzato senza però aggiungerlo alla collezione. Facendo clic sul pulsate Aggiungi elemento gli elementi selezionati verranno aggiunti. Se la ricerca ha prodotto più risultati di quelli visibili il pulsante Ottieni più risultati diventerà attivo. Facendo clic sul pulsante Pulisci tutti i risultati verranno rimossi e la ricerca azzerata.

La finestra Ricerca Internet di &appname;
La finestra Ricerca Internet di &appname;

Solo gli elementi che corrispondono al tipo di collezione in uso verranno trovati. La colonna Descrizione fornisce ulteriori informazioni sull'elemento, per differenziarlo da altri elementi simili, come altri video con formati diversi o libri con rilegature diverse. Quando un elemento è aggiunto con successo alla collezione un segno di spunta viene aggiunto alla prima colonna della lista.

Si possono aggiungere più elementi in una sola volta usando il metodo standard &kde; di selezione multipla che in genere si effettua premendo i tasti &Shift; o &Ctrl; quando si fa clic sugli elementi.

Per facilitare l'uso degli scanner di codici a barre, le ricerche possono includere più valori ISBN/UPC. Marcando la casella di selezione Ricerca di ISBN/UPC multipli, la casella di ricerca sarà disabilitata e il pulsante Modifica valori ISBN/UPC..., che apre una casella di testo multi linea, sarà attivo. Ogni valore ISBN dovrebbe essere inserito in una riga separata. Dopo aver chiuso la casella, i valori saranno convalidati per una corretta formattazione. La convalida ISBN è in grado di convertire valori EAN di 13 caratteri, così come interi codici UPC nella giusta formattazione. L'elenco ISBN può essere letto anche da un file di testo.

## Importare dati

&appname; offre tre diverse azioni in fase di importazione dei dati. Sostituisci la collezione attuale chiuderà la collezione attuale e ne creerà un'altra con i dati del file importato. Aggiungi alla collezione attuale farà sì che &appname; aggiunga tutti gli elementi del file importato alla collezione attuale, aggiungendo tutti i campi non presenti. L'azione Fondi collezione è identica all'aggiunta eccetto per il fatto che gli elementi importati saranno confrontati a quelli già presenti e gli elementi identici saranno saltati. &appname; prova a identificare gli elementi corrispondenti che non sono completamente identici confrontando i campi significativi e fonderà quindi gli elementi. Ad esempio, le collezioni musicali confrontano l'artista e l'album, e le tracce verrebbero unite per le voci corrispondenti. Lo strumento di importazione dei file audio è in grado di creare correttamente elenchi di tracce unendo gli elementi.

### Importare dati da altri programmi

&appname; può importare i dati direttamente da una varietà di altri programmi di gestione delle collezioni, inclusi GCstar, Alexandria, Delicious Library, Ant Movie Catalog, Referencer, e Griffith.

### Importare altri formati di dati

&appname; può importare i dati da una varietà di altri formati di file, inclusi CSV, bibtex, dischi audio e file, MODS, &PDF;, e RIS.

#### Importare dati &appname;

Altri file dati di &appname; possono essere importati direttamente. Sostituire la collezione attuale importando un file di &appname; è come aprire semplicemente il file stesso. Il senso nell'importare file dati di &appname; è principalmente quello di aggiungere o incorporare collezioni.

#### Importare dati CSV

I valori separati da virgole (CSV, "comma-separated values") sono un modo comune di importare ed esportare dati tabulari. Ogni valore di campo è separato da una virgola, con un elemento per ogni riga. Il titolo di campo possono essere inclusi nella prima riga. L'importazione dati CSV non è limitata all'uso della virgola come separatore ma si può usare ogni carattere o stringa.

La finestra di dialogo Importa CSV
La finestra di dialogo Importa CSV

Prima di tutto selezionare il tipo di collezione che si sta importando. Se si sta aggiungendo o incorporando dati alla collezione aperta il tipo sarà limitato a quello della collezione corrente. Se la prima riga del file CSV contiene i titoli dei campi spuntare l'apposita casella. Così facendo i titoli verranno confrontati coi campi della collezione, e se coincidono l'intestazione di colonna cambierà per far vedere che la colonna è stata assegnata ad un campo. Se il file usa un delimitatore diverso dalla virgola assicurarsi di cambiare l'opzione di conseguenza.

Per fare in modo che &appname; importi il file correttamente, bisogna che conosca quale campo corrisponde a ciascuna colonna. Se le colonne hanno un numero nell'intestazione, i dati in quella colonna non saranno importati. È possibile assegnare i campi alle colonne selezionando una colonna, sia facendoci clic che cambiando manualmente il numero di colonna, scegliendo poi il campo da assegnare dal menu a tendina e infine facendo clic sul pulsante Assegna campo. Se è necessario aggiungere un nuovo campo alla collezione, l'ultima voce del menu aprirà la finestra Campi della collezione.

Per compattezza, nella finestra sono visualizzate solo le prime cinque righe del file CSV importato. Tuttavia, saranno importate tutte le righe nel file.

#### Importare dati da un &CD; audio

&appname; è in grado di utilizzare il servizio freedb.org per ricercare informazioni su un &CD;, compresa l'elenco delle tracce. A seconda della propria distribuzione le opzioni di accesso al servizio possono essere impostate nelle &systemsettings; di &kde;. I dati di artista, titolo, genere, anno e l'elenco delle tracce saranno aggiunti tutti.

Inoltre, se il disco contiene informazioni &CD;-Text queste saranno lette e aggiunte all'elemento importato.

#### Importare metadati di file audio.

&appname; è in grado di analizzare una cartella e leggere i tag per i tipi di file audio più comuni, come `mp3` e `ogg`. Le canzoni sono inserite in una collezione di musica, dove ogni elemento è un album. Se il nome della canzone contiene il numero di traccia il nome della stessa viene aggiunto nella giusta posizione nella lista delle tracce. Anche informazioni su artista e genere vengono aggiunte all'elemento. Se i tag della canzone contengono commenti questi vengono aggiunti al campo commenti preceduti dal nome del file.

Inoltre se una cartella contiene un file `.directory` e il nome della cartella coincide col titolo dell'album l'elemento `Icon` nel file desktop viene usato come immagine per l'album.

L'importatore di metadati di file audio può analizzare ricorsivamente una cartella per trovare file audio in qualsiasi sottocartella, anche se i collegamenti simbolici non vengono seguiti. &appname; utilizza la libreria TagLib per leggere i metadati dei file audio e quindi può importare dati da qualsiasi file supportato da TagLib.

#### Importare dati Bibtex

Bibtex è un formato bibliografico utilizzato con il sistema di preparazione documenti LaTeX. Si possono includere varie referenze bibliografiche nel file. &appname; importa i file bibtex come una collezione bibliografica.

Se l'importatore bibtex incontrerà campi nel file che non sono inclusi nella collezione bibliografica predefinita, questi saranno aggiunti come campi di Testo semplice, con due eccezioni: se il valore contiene più di 100 caratteri sarà convertito come un campoparagrafo, se invece contiene un &URL; o un riferimento a un file sarà creato un campo &URL;. &appname; utilizza una copia interna della libreria btparse per elaborare i file bibtex.

Bibtexml è una rappresentazione &XML; di dati bibtex e i dati importati da questo formato sono trattati come dati bibtex.

#### Importare dati MODS

MODS è un formato utilizzato per rappresentare vari tipi di collezioni di media. Al momento, solo le collezioni di libri possono essere importate da &appname;, come una collezione bibliografica.

#### Importare dati &PDF;

Se &appname; è stato compilato con il supporto per exempi o poppler si possono importare i metadati dei file &PDF;. I metadati possono includere titolo, autore e data, così come identificatori che vengono poi utilizzati per aggiornare altre informazioni.

#### Importare dati RIS

Il formato RIS è un formato di file bibliografici utilizzato da EndNote, Reference Manager e altri. &appname; importa i file RIS come collezioni bibliografiche.

### Importare collezioni in linea

&appname; può collegarsi e importare da siti web che gestiscono collezioni personali.

#### Importa collezione BoardGameGeek

BoardGameGeek è una risorsa e una comunità di giochi da tavolo in linea. &appname; può importare i giochi da tavolo nella raccolta di un utente, purché la raccolta sia impostata per essere accessibile pubblicamente. La raccolta importata può essere limitata a quegli articoli marcati come di proprietà.

#### Importare collezione Goodreads

Goodreads è una rete sociale in linea per i lettori per tenere traccia delle raccolte di libri. &appname; può importare l'elenco dei libri nella raccolta di un utente, specificando il nome utente o l'ID utente, purché la raccolta sia impostata per essere accessibile pubblicamente.

#### Importare collezione LibraryThing

LibraryThing è un servizio in linea che aiuta le persone a catalogare facilmente i loro libri. &appname; può importare l'elenco dei libri nella raccolta di un utente, esportato in formato JSON.

### Importare liste di file

Il miglior modo di creare un catalogo di file è importare il contenuto di una cartella. La cartella può essere analizzata ricorsivamente, per cercare tutti i file che vi sono contenuti. Questo importatore è utile per creare copie di sicurezza di elenchi e catalogazione di media, come &CD; o DVD. Inoltre, è possibile generare anteprime del contenuto dei file sebbene questo possa richiedere del tempo per leggere collezioni di grandi dimensioni. Le anteprime dei file sono come quelle mostrate nel gestore dei file di &kde;.

### Importare dati &XML; tramite XSLT

Qualsiasi file &XML; può essere importato in &appname; a condizione che un foglio di stile &XSL; sia disponibile per convertire il file nel formato di &appname;. &appname; carica automaticamente il foglio di stile ed esegue la conversione necessaria per caricare il file.

## Trascinamento

Il trascinamento e il rilascio dei file di dati sulla finestra principale di &appname; importerà i file, allo stesso modo che scegliendo il comando di importazione dal menu. Il trascinamento funziona per i seguenti formati di file: Tellico, Bibtex, RIS e &PDF;. È possibile importare anche più file alla volta.

Quindi, se ad esempio si vuole creare un catalogo di molti file &PDF; basterà selezionarli nel gestore dei file e trascinarli nella finestra di &appname;. &appname; importerà il maggior numero di metadati possibile, e poi recupererà informazioni dalle varie fonti di dati Internet impostate.

## Esportare i dati

Quando si esportano i dati di una collezione i valori degli elementi possono essere formattati così come sono stati immessi o usando la formattazione automatica fornita da &appname;. Inoltre si può decidere di limitare gli elementi esportati a quelli selezionati. Il numero di elementi selezionati viene indicato nella barra di stato.

I file di testo esportati, come Bibtex o CSV, possono essere codificati in Unicode (UTF-8) o usando le impostazioni locali del sistema operativo.

Opzioni generali di esportazione
Opzioni generali di esportazione

### Esportare in &XML;

Il formato dei file di dati di &appname; è un file &XML; compresso. Esportare in &XML; crea semplicemente il file &XML; senza comprimerlo. Le immagini possono essere incluse nel file &XML; come testo codificato in base64 e racchiuso in un elemento immagine, ma così facendo potrebbero essere creati file di dati di grandi dimensioni.

### Esportare in Zip

Il formato standard di &appname; è un file compresso che contiene il file &XML; e, facoltativamente, tutte le immagini inserite nella collezione. Se le immagini sono invece salvate nella cartella del programma queste saranno salvate in un solo file compresso dopo l'esportazione.

### Esportare in &HTML;

L'esportazione in &HTML; usa il foglio di stile `tellico2html.xsl`. Le immagini sono esportate in una cartella con lo stesso nome del file &HTML; con l'aggiunta di `_files`.

Il formato predefinito è simile al risultato stampato, e permette varie opzioni per modificare il codice &HTML;. Si possono visualizzare le intestazioni di campo in cima a ogni colonna, ma, sfortunatamente, &kde; non permette ancora di fare questa operazione per ogni pagina. Gli elementi possono essere anche raggruppati come nella vista di gruppo.

Inoltre, si possono creare singoli file per ogni elemento della collezione con collegamenti dal file &HTML; principale. I file degli elementi saranno creati nella stessa cartella delle immagini. I file degli elementi &HTML; utilizzeranno il foglio di stile impostato, lo stesso che si può vedere nella vista degli elementi.

Opzioni di esportazione &HTML;
Opzioni di esportazione &HTML;

### Esportare in CSV

I valori separati da virgole (CSV >, «comma-separated values») sono un modo comune di importare ed esportare dati tabulari. Ogni valore di campo è separato da una virgola, con un elemento per ogni riga. Il titolo di campo possono essere inclusi come intestazioni nella prima riga. La delimitazione dei campi non è limitata all'uso della virgola ma si può usare ogni carattere o stringa.

Opzioni di esportazione in CSV
Opzioni di esportazione in CSV

### Esportare in Alexandria

Alexandria è un gestore di collezioni di libri per il desktop GNOME. &appname; è in grado di esportare un limitato sottoinsieme di campi di una collezione di libri nella posizione predefinita dei file di Alexandria.

### Esportare in ONIX

ONIX è un formato &XML; per rappresentare e comunicare informazioni sui prodotti dell'industria libraria, usato principalmente da chi vende libri. &appname; può esportare le collezioni di libri utilizzando un piccolo sottogruppo ONIX.

### Esportare in Bibtex

Quando si esporta in Bibtex i valori dei campi possono essere racchiusi da parentesi o interpunzioni. Se nella collezione vengono usate stringhe macro si può scegliere se esportarle come macro o espanderle. Per i campi &URL; i valori possono essere racchiusi in un tag `\url{...}`. Infine gli elementi che non hanno chiavi di citazione possono essere saltati o si può far generare automaticamente da &appname; una chiave.

Opzioni di esportazione in Bibtex
Opzioni di esportazione in Bibtex

### Esportare in GCstar

GCstar è un altro gestore di collezioni di film. &appname; è in grado di esportare la maggior parte dei tipi di collezione in un file di dati GCstar.

### Esportare &XML; tramite &xslt;

Infine, &appname; è in grado di elaborare la rappresentazione interna &XML; dei dati di una collezione attraverso un foglio di stile &XSL; esterno prima dell'esportazione. Questo tipo di esportazione può tornare utile per generare resoconti testuali o altri tipi di file.

## Lavorare con le citazioni

Quando si lavora con una bibliografia si possono generare citazioni per gli elementi selezionati da usare con varie altre applicazioni. Una citazione in formato bibtex può essere copiata negli appunti e successivamente incollata in un file latex. Le citazioni bibtex possono essere anche inviate ad un'applicazione esterna come LyX o Kile usando la cosiddetta lyxpipe.