# Importar i exportar dades

El &appname; és capaç d'importar i exportar una gran varietat de fitxers de dades, així com cercar informació a diversos llocs de cerca d'Internet.

## Importar des d'Internet

El &appname; és capaç de cercar a diversos llocs d'Internet utilitzant el diàleg Cerca a Internet. Les entrades es poden importar i afegir directament a la vostra col·lecció actual. Els diferents proveïdors es configuren mitjançant les Opcions de les fonts de dades.

Les cerques poden utilitzar diferents criteris: .Títol, Persona, ISBN, UPC/EAN, LCCN o Paraula clau. No tots els criteris estaran disponibles per a certes fonts de dades. Els valors ISBN i LCCN sols serveixen per a un llibre, mentre que els valors UPC o EAN poden aplicar-se a qualsevol tipus d'element.

Una vegada s'ha iniciat una cerca, el botó Cerca es convertirà en Atura per a aturar una cerca. A mesura que es trobin resultats, s'afegiran a la llista directament sota el quadre de cerca, on la selecció d'un element mostrarà el resultat sense necessitat d'afegir-lo a la col·lecció. Fent clic al botó Afegeix una entrada s'afegiran tots els elements seleccionats a la vostra col·lecció. Si la font de dades té més resultats dels que es van sol·licitar inicialment, el botó Obtén més resultats esdevindrà actiu. Fent clic a Neteja s'eliminaran tots els resultats actuals i es tornarà a iniciar la cerca.

El diàleg Cerca a Internet del &appname;
El diàleg Cerca a Internet del &appname;

Sols es trobaran les entrades que coincideixin amb el tipus de la col·lecció actual. La columna Descripció proporciona informació addicional sobre l'entrada, per tal de diferenciar entre els vídeos en diferents formats o llibres en enquadernacions diferents, per exemple. Una vegada s'ha afegit amb èxit una entrada a la col·lecció, s'afegirà una marca de selecció a la primera columna de la llista.

Es poden afegir entrades múltiples utilitzant el mètode estàndard del &kde; per a la selecció múltiple, el qual normalment implica mantenir premuda la tecla &Maj; o &Ctrl; quan es fa clic sobre un element.

Per a facilitar l'ús d'escàners de codi de barres, les cerques poden incloure múltiples valors d'ISBN/UPC. Seleccionar la casella de selecció Cerca múltiple ISBN/UPC es desactivarà el quadre de cerca i s'activarà el botó Edita els valors ISBN/UPC..., el qual obrirà un quadre d'entrada de text multilínia. Cada valor ISBN s'ha d'introduir en una mateixa línia. Després de tancar el quadre, cada valor ISBN serà validat per a un format correcte. La validació ISBN és capaç de convertir valors EAN de 13 dígits, així com codis UPC complets per al format correcte. La llista ISBN també es pot llegir des d'un fitxer de text.

## Importar dades

El &appname; ofereix tres accions diferents quan s'importen dades. Substitueix la col·lecció actual tancarà la col·lecció actual i en crearà una de nova amb les dades del fitxer importat. Annexa a la col·lecció actual li diu al &appname; que afegeixi totes les entrades de la col·lecció importada a l'actual i que afegeixi els camps que actualment no existeixen. L'acció Fusiona la col·lecció és la mateixa que afegir, excepte que cada entrada importada es compara amb les actuals, i les entrades idèntiques seran omeses. El &appname; intenta identificar les entrades coincidents que no són completament idèntiques comparant camps significatius i, a continuació, combinarà les entrades. Per exemple, en les col·leccions de música es comparen l'artista i l'àlbum, i les pistes es fusionaran per a les entrades coincidents. L'importador de fitxers d'àudio és capaç de construir correctament les llistes de pistes mitjançant la fusió de les entrades.

### Importar des d'un altre programari

El &appname; pot importar dades directament des d'una varietat d'altres programes de gestió de col·leccions, incloent-hi el GCstar, Data Crow, Alexandria, Delicious Library, Collectorz, Ant Movie Catalog, Referencer i Griffith.

### Importar dades d'altres formats de dades

El &appname; pot importar dades des d'altres formats de fitxer, inclosos el CSV, bibtex, discs i fitxers d'àudio, MODS, &PDF; i RIS.

#### Importar dades del &appname;

Es poden importar altres fitxers de dades directament des del &appname;. Substituir la col·lecció actual important un fitxer del &appname; és el mateix que obrir el fitxer en si. El valor de la importació de dades del &appname; és principalment per a afegir o fusionar dues col·leccions.

#### Importar dades CSV

Els valors separats per comes (CSV) són una forma comuna d'importació i exportació de dades tabulars. Cada valor de camp està separat per una coma, amb una entrada per línia. Els títols dels camps es poden incloure a la primera línia. L'importador CSV no es limita a utilitzar una coma com a separador. Es pot utilitzar qualsevol caràcter o cadena.

El diàleg d'importació CSV
El diàleg d'importació CSV

Primer, seleccioneu el tipus de col·lecció que importareu. Si l'esteu afegint o fusionant a la vostra col·lecció oberta, el tipus es limita al vostre tipus de col·lecció actual. Si la primera línia del fitxer CSV conté els títols dels camps, feu clic a la casella de selecció i l'importador els compararà automàticament contra els camps a la col·lecció actual. Si un títol de camp coincideix, la capçalera per a aquesta columna canviarà per a mostrar que la columna ha estat assignada a aquest camp. Si el fitxer utilitza un delimitador diferent de la coma, assegureu-vos de canviar aquesta opció en conseqüència.

Perquè el &appname; importi correctament el fitxer, haurà de saber quin camp correspon a cada columna. Si la columna sols té un número a la capçalera, les dades en aquesta columna no s'importaran. Haureu d'assignar camps a cada columna seleccionant una columna fent clic sobre seu o canviant el número de la columna en si, llavors seleccioneu el camp a assignar-li des de la llista desplegable i feu clic al botó Assigna camp. Si cal afegir un camp nou a la col·lecció, l'últim element de la llista desplegable obre el diàleg Camps de la col·lecció.

Perquè sigui compacte, en el diàleg només es mostraran les primeres cinc línies del fitxer CSV importat. No obstant això, s'importaran totes les línies que hi hagi al fitxer.

#### Importar dades d'un &CD; d'àudio

El &appname; és capaç d'utilitzar el servei freedb.org per a cercar informació sobre un &CD;, incloent-hi la llista de les pistes. Depenent de la vostra distribució, l'arranjament per a accedir al servei es pot establir en &systemsettings; del &kde;. S'afegiran l'artista, el títol, el gènere, l'any i llista de les pistes del &CD;.

A més, si el disc conté &CD;-Text, aquesta informació serà llegida i afegida a l'entrada importada.

#### Importar metadades dels fitxers d'àudio

El &appname; és capaç d'escanejar una carpeta i llegir les etiquetes per als formats de fitxer d'àudio més comuns, com `mp3` i `ogg`. Les cançons s'introdueixen en una col·lecció de música, on cada entrada és un àlbum. Si els fitxers de música contenen el número de pista, el nom de la cançó serà inserit al lloc correcte a la llista de pistes. La informació sobre l'artista i el gènere també s'afegiran a l'entrada. Si les etiquetes de les cançons contenen comentaris, aquests seran afegits al camp de comentaris de l'entrada, precedida pel nom del fitxer.

A més, si una carpeta conté un fitxer `.directory` i el nom de la carpeta coincideix amb un títol de l'àlbum, l'entrada `Icon` al fitxer d'escriptori s'utilitzarà com a imatge de portada per a l'àlbum.

L'importador de metadades dels fitxers d'àudio pot explorar de forma recursiva una carpeta per a trobar tots els fitxers d'àudio en qualsevol subcarpeta, no se seguiran els enllaços simbòlics. El &appname; utilitza la biblioteca TagLib per a llegir les metadades dels fitxers d'àudio, de manera que podreu importar dades de qualsevol tipus de fitxer que entengui TagLib.

#### Importar dades de «bibtex»

«Bibtex» és un format de bibliografia utilitzat amb el sistema de preparació de documents LaTeX. Es poden incloure diferents tipus de referències bibliogràfiques en el fitxer. El &appname; importarà els fitxers «bibtex» com una col·lecció bibliogràfica.

Si l'importador «bibtex» troba camps en el fitxer que no es troben a la col·lecció bibliogràfica predeterminada, llavors seran afegits com a camps Text pla, amb dues excepcions. Si el valor del camp conté més de 100 caràcters, es convertirà en un camp Paràgraf. Si el valor del camp sembla contenir un &URL; o una referència de fitxer, llavors es crearà un camp &URL;. El &appname; utilitza una còpia interna de la biblioteca btparse per a analitzar els fitxers «bibtex».

«Bibtexml» és una representació &XML; de les dades «bibtex», i les dades del fitxer «bibtexml» importat es tracten de la mateixa manera com ho serien les dades de «bibtex».

#### Importar dades de «MODS»

MODS és un format per a la representació de diferents tipus de col·leccions multimèdia. Actualment, sols s'importen els llibres per al &appname;, com una col·lecció bibliogràfica.

#### Importar dades de &PDF;

Si el &appname; es va compilar amb suport exempi o poppler, les metadades dels fitxers &PDF; es podran importar. Les metadades poden incloure informació sobre el títol, l'autor, i la data, així com identificadors bibliogràfics que després s'utilitzaran per a actualitzar d'altra informació.

#### Importar dades de «RIS»

El format RIS és un format de fitxer bibliogràfic utilitzat per Reference Manager i altres. El &appname; importa fitxers RIS com una col·lecció bibliogràfica.

### Importar col·leccions en línia

El &appname; es pot connectar i importar des de llocs web que gestionen col·leccions personals.

#### Importar col·leccions de BoardGameGeek

BoardGameGeek és un recurs en línia i comunitat de jocs de taula. El &appname; pot importar els jocs de taula a la col·lecció de l'usuari, sempre que la col·lecció estigui establerta com d'accés públic. La col·lecció importada podrà limitar-se als elements marcats com en propietat.

#### Importar col·leccions de «Goodreads»

Goodreads és una xarxa social en línia perquè els lectors segueixin les seves col·leccions de llibres. El &appname; pot importar la llista de llibres a la col·lecció d'un usuari, ja sigui el nom com la identificació d'usuari, sempre que la col·lecció resti ajustada de manera que sigui accessible públicament.

#### Importar col·leccions de «LibraryThing»

LibraryThing és un servei en línia per a ajudar les persones a catalogar els seus llibres amb facilitat. El &appname; pot importar la llista de llibres que hi ha a la col·lecció d'un usuari, exportada en el format JSON.

#### Importar col·leccions de «Discogs»

Discogs és una base de dades i mercat en línia de llançaments musicals. El &appname; pot importar la llista de llançaments musicals en una col·lecció d'usuari, indicant el nom d'usuari, sempre que la col·lecció s'hagi definit com a públicament accessible.

### Importar llistes de fitxers

El &tellico; pot escanejar carpetes per a importar informació de fitxers, principalment per a crear una col·lecció de catàleg de fitxers. La carpeta es pot cercar recursivament, per a afegir tots els fitxers trobats. Aquest importador és més útil per a llistes de còpies de seguretat i catalogació d'elements multimèdia, com llistes de &CD; o DVD. A més, es poden generar vistes prèvies d'imatges del contingut del fitxer. Les vistes prèvies de fitxer són les mateixes que les que es mostren al gestor de fitxers de &kde;.

Les carpetes amb fitxers de llibres electrònics i fitxers de vídeo també es poden importar com a col·leccions de llibres i vídeos. Es poden llegir les metadades dels fitxers, i per als fitxers de vídeo, qualsevol fitxer `nfo` existent s'utilitzarà per completar la informació de les entrades dels vídeos.

### Importar dades &XML; mitjançant &xslt;

Es pot importar qualsevol fitxer &XML; al &appname; proporcionant un full d'estil &XSL; disponible per a convertir el fitxer al format del &appname;. El &appname; carregarà automàticament el full d'estil i realitzarà el processament &xslt; necessari per a carregar el fitxer.

## Arrossegar i deixar anar

Arrossegar fitxers de dades a la finestra principal del &appname; i deixar-los anar importarà aquests fitxers, com si se seleccionés l'ordre importa des dels menús. Arrossegar i deixar anar funciona per als formats següents de fitxer: Tellico, Bibtex, RIS, &PDF; i EPub. També està implementada la importació des de múltiples fitxers alhora.

De manera que si voleu catalogar diversos fitxers &PDF;, seleccioneu-los al gestor de fitxers i arrossegueu-los a la finestra del &appname;. El &appname; importarà tantes metadades dels fitxers com pugui, i després cercarà informació addicional des de diverses fonts d'Internet configurades.

## Exportar les dades

En exportar les dades de la col·lecció, els valors d'entrada es poden exportar com es van introduir, o amb el format automàtic proporcionat pel &appname;. A més, l'exportació es pot limitar a les entrades seleccionades de la col·lecció, on la barra d'estat indicarà el nombre d'entrades seleccionades.

Els fitxers de text exportats, com Bibtex o CSV, poden utilitzar la codificació de caràcters Unicode (UTF-8), o la configuració regional actual del sistema operatiu.

Opcions generales de l'exportació
Opcions generales de l'exportació

### Exportar a &XML;

El format de fitxer per a les dades del &appname; és un fitxer &XML; comprimit. L'exportació a &XML; es limita a crear el fitxer &XML; sense comprimir-lo. Les imatges es poden incloure en el fitxer &XML; com a dades codificades en base64 en un element d'imatge, però això pot crear fitxers de text molt grans.

### Exportar a Zip

El format de fitxer estàndard per al &appname; és un fitxer comprimit, que contindrà el fitxer de col·lecció &XML;, i de manera opcional, totes les imatges referenciades a la col·lecció. Si les imatges s'emmagatzemen a la carpeta de l'aplicació, exportar a un fitxer Zip crearà un fitxer de dades independent, el qual inclourà totes les imatges de la col·lecció.

### Exportar a &HTML;

L'exportació &HTML; utilitza el full d'estil `tellico2html.xsl`. Les imatges s'exporten a una carpeta amb el mateix nom que el fitxer &HTML; exportat amb `_files` adjuntat.

El format predeterminat és similar a la sortida impresa, i permet diverses opcions per a modificar el codi &HTML;. Les capçaleres dels camps es poden imprimir a la part superior de cada columna, però malauradament, el &kde; no permet encara que es repeteixi cap capçalera de taula a cada pàgina. Les entrades també es poden agrupar com a la Vista de grup.

A més, els fitxers individuals es poden crear per a cada entrada de la col·lecció, amb enllaços creats al fitxer &HTML; de nivell superior. Els fitxers d'entrada seran creats a la mateixa carpeta que les imatges. Els fitxers &HTML; d'entrada utilitzaran la plantilla de fulls d'estil actual, com es mostra en la Vista d'entrada.

Opcions de l'exportació a &HTML;
Opcions de l'exportació a &HTML;

### Exportar a CSV

Els valors separats per comes (CSV) són una manera comuna d'importació i exportació de dades tabulars. Cada valor de camp està separat per una coma, amb una entrada per línia. Els títols dels camps es poden incloure com a capçaleres en la primera línia. Per a delimitar els camps també es pot utilitzar qualsevol caràcter o cadena que no sigui una coma.

Opcions de l'exportació a CSV
Opcions de l'exportació a CSV

### Exportar a «Alexandria»

Alexandria és un gestor de col·lecció de llibres per a l'entorn d'escriptori GNOME. El &appname; és capaç d'exportar un subconjunt limitat de camps de col·lecció de llibres a la ubicació predeterminada de les dades d'Alexandria.

### Exportar a «ONIX»

ONIX és un format &XML; per a representar i comunicar informació sobre productes de la indústria del llibre, principalment per als venedors de llibres. El &appname; pot exportar col·leccions de llibres utilitzant un petit subconjunt d'ONIX.

### Exportar a «bibtex»

Quan s'exporta a Bibtex, els valors dels camps es poden tancar amb marques de claus o cometes. Si s'utilitzen macros de cadena a la col·lecció, de manera opcional es poden exportar com a macros o expandir-se. Per als camps d'&URL;, el &appname; pot tancar els valors de camp amb l'etiqueta `\url{...}`. Finalment, les entrades sense clau de cita es poden ometre abans que el &appname; generi la clau automàticament.

Opcions de l'exportació a «bibtex»
Opcions de l'exportació a «bibtex»

### Exportar a GCstar

GCstar és un altre gestor de col·lecció de pel·lícules. El &appname; és capaç d'exportar la majoria dels tipus de col·lecció a un fitxer de dades de GCstar.

### Exportar a &XML; mitjançant &xslt;

Finalment, el &appname; és capaç de processar la seva representació &XML; interna de les dades de la col·lecció a través d'un full d'estil &XSL; extern abans d'exportar. Aquest tipus d'exportació pot ser útil per a la generació d'informes de text o altres tipus de fitxer.

## Treballar amb cites

Quan es treballa amb una bibliografia, es poden generar cites a partir de les entrades seleccionades i utilitzar-les en altres aplicacions. Una cita en el format «bibtex» es pot copiar al porta-retalls, i després enganxar-la a un fitxer de LaTeX. Les cites «bibtex» també es poden incloure a una aplicació externa, com ara LyX o Kile utilitzant l'anomenada lyxpipe.