# Importar y exportar datos

&appname; puede importar y exportar una amplia variedad de archivos de datos, además de buscar información en varios sitios de internet.

## Importar desde internet

&appname; puede buscar en varios sitios de internet usando el Diálogo de búsqueda en internet. Las entradas pueden ser importadas directamente y añadidas a su colección actual. Los diversos proveedores se configuran mediante las Opciones de fuentes de datos.

Las búsquedas pueden usar distintos criterios: Título, Persona, ISBN, UPC/EAN, LCCN, o Palabra clave. No todos los criterios están disponibles para ciertas fuentes de datos. Los valores ISBN y LCCN solo sirven para libros, mientras que los valores UPC o EAN pueden aplicarse a cualquier tipo de elemento.

Una vez se ha iniciado una búsqueda, el botón Buscar se convierte en Detener, que finalizará la búsqueda. A medida que se encuentren resultados, se añadirán a la lista directamente bajo la caja de búsqueda, donde seleccionar un elemento mostrará el resultado sin añadirlo a la colección. Hacer clic en el botón Añadir entrada añadirá los elementos seleccionados a su colección. Si la fuente de datos tiene más resultados de los que se solicitaron inicialmente, el botón Obtener más resultados se volverá activo. Hacer clic en Limpiar eliminará todos los resultados actuales y reiniciará la búsqueda.

El Diálogo de búsqueda en internet de &appname;
El Diálogo de búsqueda en internetde &appname;

Solo se encontrarán las entradas que coincidan con el tipo de la colección actual. La columna Descripción proporciona información adicional acerca de la entrada para diferenciar entre videos en diferentes formatos o libros con distinta encuadernación, por ejemplo. Una vez una entrada se ha añadido con éxito a la colección, se añadirá una marca de verificación a la primera columna de la lista.

Se pueden añadir entradas múltiples usando el método estándar de &kde; para la selección múltiple, que normalmente incluye mantener pulsada la tecla &Shift; o &Ctrl; cuando se hace clic en un elemento.

Para facilitar el uso de los escáneres de código de barras, las búsquedas pueden incluir múltiples valores de ISBN/UPC. Seleccionar la casilla de verificación Búsqueda ISBN/UPC múltiple deshabilitará la caja de búsqueda y habilitará el botón Editar valores ISBN/UPC…, que abrirá una caja de entrada de texto de varias líneas. tras cerrar la caja, cada ISBN será validado para un formato correcto. La validación ISBN puede convertir los valores EAN de 13 dígitos, además de códigos UPC completos al formato apropiado. La lista de ISBN también se puede leer desde un archivo de texto.

## Importar datos

&appname; ofrece tres acciones diferentes cuando se importan datos. Sustituir la colección actual cerrará la colección actual y creará una nueva con los datos del archivo importado. Añadir a la colección actual le dice a &appname; que añada todas las entradas de la colección importada a la actual, además de añadir también cualquier campo que no exista actualmente. La acción Fusionar la colección es lo mismo que añadir, excepto que cada entrada importada se compara con las actuales, omitiendo los valores idénticos. &appname; trata de identificar las entradas coincidentes que no son completamente idénticas comparando los campos más significativos y fusionando después las entradas. Por ejemplo, las colecciones de música comparan el artista y el álbum, y luego se fusionarían las pistas de las entradas coincidentes. El importador de archivos de audio puede construir listas de pistas correctamente las entradas.

### Importar datos de otro software

&appname; puede importar datos directamente de otros programas de gestión de colecciones, como GCstar, Data Crow, Alexandria, Delicious Library, Collectorz, Ant Movie Catalog, Referencer y Griffith.

### Importar otros formatos de datos

&appname; puede importar datos de varios formatos de archivos, como CSV, bibtex, discos y archivos de audio, MODS, &PDF; y RIS.

#### Importar datos de &appname;

Se pueden importar directamente otros archivos de datos de &appname;. Sustituir la colección actual importando otro archivo de &appname; es lo mismo que abrir el propio archivo. Importar datos de &appname; sirve para poder añadir datos o para fusionar dos colecciones.

#### Importar datos CSV

Los valores separados por comas (CSV) son una forma común de importar y exportar datos tabulares. El valor de cada campo se separa por una coma, con una entrada por línea. Los títulos de los campos se pueden incluir en la primera línea. El importador CSV no se limita a usar una coma como separador. Se puede utilizar cualquier carácter o cadena de caracteres.

El diálogo de importación de CSV
El diálogo de importación de CSV

Primero, seleccione el tipo de colección que está importando. Si la está añadiendo o fusionando con su colección abierta, el tipo está limitado al tipo de su colección actual. Si la primera línea del archivo CSV contiene los títulos de los campos, haga clic en la casilla de verificación y el importador comparará automáticamente los títulos con los de los campos en la colección actual. Si el título de un campo coincide, la cabecera para esa columna cambiará para mostrar que la columna se ha asignado a ese campo. Si el archivo usa un separador distinto a la coma, asegúrese de cambiar esa opción de acuerdo con él.

Para que &appname; importe el archivo correctamente, debe saber qué campo corresponde a cada columna. Si la columna solo tiene un número en la cabecera, los datos de esa columna no serán importados. Debería asignar campos a cada columna seleccionando una columna haciendo clic en ella o cambiando el número de columna, y después seleccionando el campo que asignarle de la caja desplegable y haciendo clic en el botón Asignar campo. Si necesita añadir un nuevo campo a la colección, el último elemento en la caja desplegable abrirá el Diálogo de campos de la colección.

Para simplificar, solo se muestran en el diálogo las primeras cinco líneas del archivo CSV importado. No obstante, se importarán todas las líneas del archivo.

#### Importar datos de un &CD; de audio

&appname; puede usar el servicio freedb.org para buscar información sobre un &CD;, incluyendo la lista de pistas. Dependiendo de su distribución, los ajustes para acceder al servicio se podrán configurar en las &systemsettings; de &kde;. Se añadirán el &CD;, artista, título, género, año y lista de pistas.

Además, si el disco contiene texto de &CD;, se leerá esa información y se añadirá a la entrada importada.

#### Importar metadatos de archivos de audio

&appname; puede explorar una carpeta y leer las etiquetas de los formatos de audio más comunes, como `mp3` y `ogg`. Las canciones se introducen en una colección de música, donde cada entrada es un álbum. Si los archivos de la canción contienen el número de pista, el nombre de la canción se inserta en el lugar correcto del listado de pistas. La información del artista y del género también se añaden a la entrada. Si las etiquetas de la canción incluyen comentarios, se añaden al campo de comentarios de la entrada, precedidos por el nombre del archivo.

Además, si una carpeta contiene un archivo `.directory` y el nombre de la carpeta coincide con el título de un álbum, la entrada de `Icono` en el archivo de escritorio se utiliza como imagen de portada para ese álbum.

El importador de metadatos de archivos de audio puede explorar recursivamente una carpeta para encontrar todos los archivos de audio en cualquier subcarpeta, aunque no se siguen los enlaces simbólicos. &appname; usa la biblioteca TagLib para leer metadatos de archivos de sonido, por lo que puede importar datos de cualquier tipo de archivo que entienda TagLib.

#### Importar datos de Bibtex

Bibtex es un formato de bibliografía usado con el sistema de preparación de documentos LaTeX. Se pueden incluir varios tipos de referencias bibliográficas en el archivo. &appname; importa archivos bibtex como una colección bibliográfica.

Si el importador bibtex encuentra campos en el archivo que no están en la colección de bibliografía predeterminada, se añadirán como campos de texto sencillo, con dos excepciones. Si el valor del campo contiene más de 100 caracteres, se convierte en un campo de Párrafo. Si el valor del campo parece contener una &URL; o una referencia de archivo, entonces se crea un campo &URL;. &appname; usa una copia interna de la librería btparse para analizar sintácticamente los archivos bibtex.

Bibtexml es una representación &XML; de datos de bibtex, y los datos de los archivos bibtexml importados se tratan de la misma forma que los datos de bigbtex.

#### Importar datos MODS

MODS es un formato para representar varios tipos de colecciones. En la actualidad, &appname; solo importa libros como colección bibliográfica.

#### Importar datos &PDF;

Si &appname; se ha compilado con exempi o poppler, se podrán importar los metadatos de los archivos &PDF;. Los metadatos pueden incluir información del título, el autor y la fecha, además de identificadores bibliográficos que se utilizarán para actualizar otra información.

#### Importar datos RIS

El formato RIS es un formato de archivo bibliográfico usado por EndNote, Reference Manager y por otras aplicaciones. &appname; importa archivos RIS como colección bibliográfica.

### Importar colecciones en línea

&appname; puede conectarse e importar datos de sitios web que gestionan colecciones personales.

#### Importar colección de BoardGameGeek

BoardGameGeek es un recurso y comunidad de juegos de mesa. &appname; puede importar los juegos de mesa en una colección del usuario, siempre que la colección sea accesible públicamente. La colección importada puede estar limitada a los elementos marcados como propios.

#### Importar colección de Goodreads

Goodreads es una red social en línea para que los lectores sigan sus colecciones de libros. &appname; puede importar la lista de libros de la colección de un usuario, dados tanto el nombre como la identificación del usuario, siempre que la colección esté configurada para ser accesible públicamente.

#### Importar colecciones de LibraryThing

LibraryThing es un service en línea para ayudar a catalogar libros de forma fácil. &appname; puede importar la lista de libros en una colección del usuario, exportada en formato JSON.

#### Importar colección de Discogs

Discogs es una base de datos en línea y un mercado de lanzamientos musicales. &appname; puede importar la lista de lanzamientos musicales en una colección de un usuario, dado el nombre de usuario, siempre que la colección esté configurada para que se pueda acceder a ella públicamente.

### Importar listados de archivos

&tellico; puede explorar carpetas para importar información de archivos, principalmente para crear una colección de Catálogo de archivos. La carpeta se puede examinar recursivamente para añadir todos los archivos que se encuentren en su interior. El importador es más útil para listados de copias de seguridad y para catalogar archivos multimedia, como listados de &CD; o DVD. Además, puede generar las vistas previas del contenido de los archivos. Las vistas previas de los archivos son las mismas que se muestran en el gestor de archivos de &kde;.

Las carpetas con archivos de libros electrónicos y de vídeo también se pueden importar como colecciones de libros y de vídeos. Los metadatos de los archivos se pueden leer y, para los archivos de vídeo, cualquier archivo `nfo` que exista se usa para completar la información de las entradas de vídeo.

### Importar datos &XML; vía XSLT

Cualquier archivo &XML; se puede importar a &appname;, siempre que la hoja de estilo &XML; esté dispuesta a convertir el archivo al formato de &appname;. &appname; carga automáticamente la hoja de estilo y ejecuta el procesamiento &xslt; necesario para cargar el archivo.

## Arrastrar y soltar

Arrastrar archivos de datos a la ventana principal de &appname; y soltarlos importará los archivos, de la misma forma que si se hubiera seleccionado la orden de importar desde un menú. Arrastrar y soltar funciona para los siguientes tipos de archivos: Tellico, Bibtex, RIS y &PDF; y EPub. También se admite la importación de múltiples archivos a la vez.

Así que, por ejemplo, si desea catalogar varios archivos &PDF;, selecciónelos en el gestor de archivos y arrástrelos a la ventana de &appname;. &appname; importará tantos metadatos de los archivos como pueda, y después buscará información adicional de varias fuentes configuradas de internet.

## Exportar datos

Cuando se exporten los datos de la colección, los valores de entrada pueden exportarse como se han introducido, o con el formato automático proporcionado por &appname;. Además, la exportación puede estar limitada a las entradas seleccionadas actualmente en la colección, donde la barra de estado muestra el número de entradas seleccionadas.

Los archivos de texto exportados, como Bibtex o CSV, pueden usar la codificación de caracteres Unicode (UTF-8), o la codificación local del sistema operativo.

Opciones generales de exportación
Opciones generales de exportación

### Exportar &XML;

El formato de archivo para los datos de &appname; es un archivo &XML; comprimido. Exportar a &XML; simplemente crea el archivo &XML; sin comprimirlo. Las imágenes se pueden incluir en el archivo &XML; como datos codificados en base 64 en un elemento de imagen, pero hacerlo así puede crear archivos de texto muy grandes.

### Exportar zip

El formato de archivo estándar para &appname; es un archivo comprimido, que contiene el archivo &XML; de la colección y, opcionalmente, todas las imágenes a las que se hace referencia en la misma. Si las imágenes, por el contrario, se están almacenando en la carpeta de la aplicación, exportarlas a un archivo Zip creará un archivo de datos autocontenido, que incluirá todas las imágenes de la colección.

### Exportar &HTML;

La exportación &HTML; usa la misma hoja de estilo `tellico2html.xsl`. Las imágenes se exportan a una carpeta con el mismo nombre que el archivo &HTML; exportado, con `_files` adjuntado.

El formato por defecto es similar a la salida impresa, y permite varias opciones para modificar el &HTML;. Las cabeceras de los campos pueden ser impresas en la parte superior de cada columna, pero por desgracia &kde; no permite aún que las cabeceras de tabla se repitan en cada página. Las entradas pueden también ser agrupadas como en la Vista de grupo.

Adicionalmente, se pueden crear archivos individuales para cada entrada de la colección, con enlaces creados en el archivo &HTML; de nivel superior. Los archivos de entrada se crearán en la misma carpeta que las imágenes. Los archivos &HTML; de entrada usarán la plantilla de hoja de estilo actual, como se muestra en la Vista de entrada.

Opciones de exportación de &HTML;
Opciones de exportación de &HTML;

### Exportar CSV

Los valores separados por comas (CSV) son una manera común de importar y exportar datos tabulares. El valor de cada campo está separado por una coma, con una o dos entradas por línea. Los títulos de campo pueden incluirse como cabeceras en la primera línea. Cualquier otro carácter o cadena de caracteres diferente a una coma se puede usar para delimitar los campos.

Opciones de exportación de CSV
Opciones de exportación de CSV

### Exportar Alexandria

Alexandria es un gestor de colecciones de libros para el entorno de escritorio GNOME. &appname; puede exportar un subconjunto limitado de campos de las colecciones de libros a la localización por defecto de los datos de Alexandria.

### Exportar ONIX

ONIX es un formato &XML; para representar y comunicar información sobre productos de la industria del libro, principalmente para vendedores de libros. &appname; puede exportar colecciones de libros usando un pequeño subconjunto de ONIX.

### Exportar Bibtex

Cuando se exporta a Bibtex, los valores de los campos pueden escaparse con paréntesis o comillas. Si se están utilizando macros de cadena en esta colección, opcionalmente pueden exportarse como macros o expandirse. Para los campos de &URL;, &appname; puede incluir los valores del campo con la etiqueta `\url{…}`. Finalmente, las entradas sin clave de cita pueden ser obviadas, más que hacer que &appname; autogenere la clave.

Opciones de exportación de Bibtex
Opciones de exportación de Bibtex

### Exportar GCstar

GCstar es otro gestor de colecciones de películas. &appname; puede exportar la mayoría de los tipos de colección a un archivo de datos de GCstar.

### Exportar &XML; vía &xslt;

Finalmente, &appname; puede procesar su representación interna en &XML; de los datos de la colección a través de una hoja de estilo &XML; externa antes de exportarlos. Este tipo de exportación puede ser útil para generar informes de texto u otros tipos de archivo.

## Trabajar con citas

Cuando trabaje con una bibliografía, se pueden generar citas a partir de las entradas actualmente seleccionadas y usarse en otras aplicaciones. Una cita en formato bibtex puede copiarse al portapapeles, y después pegarse en un archivo latex. las citas de Bibtex también pueden incluirse en una aplicación externa como LyX o Kile, utilizando el llamado lyxpipe.