# Importar e exportar dados

O &appname; é capaz de importar e exportar uma grande variedade de arquivos de dados, assim como pesquisar em vários serviços da Internet para obter informações.

## Importando da Internet

O &appname; é capaz de pesquisar em vários serviços da Internet com a Janela de Pesquisa na Internet. Os itens poderão ser importados e adicionados diretamente à sua coleção atual. Os vários fornecedores são configurados com as Opções das Fontes de Dados.

As pesquisas poderão usar critérios diferentes: o Título, a Pessoa, o ISBN, o UPC/EAN o LCCN ou a Palavra-Chave. Nem todos os critérios estão disponíveis para todas as fontes de dados. Os valores do ISBN e do LCCN são somente para livros, enquanto os valores do UPC e do EAN podem ser aplicados a qualquer tipo de item.

Logo que inicie uma pesquisa, o botão Procurar tornar-se-á Parar, de modo a interromper uma pesquisa. À medida que forem encontrados resultados, eles são adicionados diretamente à lista sob o campo de pesquisa; a seleção de um item irá mostrar o resultado sem o adicionar à coleção. Se clicar no botão Adicionar um Item, irá adicionar todos os itens selecionados à sua coleção. Se a fonte de dados tiver mais resultados do que os pedidos inicialmente, o botão Obter Mais Resultados ficará ativo. Clicar em Limpar, irá remover todos os resultados atuais e limpar a pesquisa.

A Janela de Pesquisa na Internet do &appname;
A Janela de Pesquisa na Internet do &appname;

Somente os itens correspondentes ao tipo de coleção atual serão encontrados. A coluna da Descrição oferece informações adicionais sobre o item, de modo a diferenciar entre os vídeos com diferentes formatos ou os livros com diferentes encadernações, por exemplo. Assim que um item for adicionado com sucesso à coleção, é feita uma marcação na primeira coluna na lista.

Você poderá adicionar vários itens de uma vez, usando o método-padrão do &kde; de seleção múltipla, que envolve normalmente a utilização das teclas &Shift; ou &Ctrl; enquanto clica num item.

Para facilitar a utilização de leitores de códigos de barras, as pesquisas poderão incluir vários valores de ISBN/UPC. A seleção da opção Pesquisa por ISBN/UPC múltipla irá desativar o campo de pesquisa e ativar o botão Editar os valores de ISBN/UPC..., que irá abrir um campo de inserção de texto multi-linhas. Cada ISBN deverá ser inserido numa linha própria. Depois de fechar a janela, cada um dos ISBNs será validado à procura da formatação correta. A validação do ISBN é capaz de converter os valores de 13 algarismos do EAN, assim como os códigos completos do UPC, para uma formatação correta. A lista de ISBNs poderá também ser lida a partir de um arquivo de texto.

## Importar Dados

O &appname; oferece três ações diferentes quando importa os dados. A Substituir a coleção atual irá fechar a coleção atual, criando uma nova com os dados do arquivo importado. A Adicionar à coleção atual diz ao &appname; para adicionar todos os itens na coleção importada à atual, assim como para adicionar os campos que atualmente não existam. A ação Mesclar a coleção é a mesma que a adição, exceto que cada item importado é comparado com os atuais, sendo que os itens idênticos são descartados. O &appname; tenta identificar entradas correspondentes que não são completamente idênticas, comparando campos significativos e, em seguida, fará a mesclagem das entradas. Por exemplo, as coleções de músicas comparam o artista e o álbum, sendo que as faixas deveriam ser mescladas para os itens correspondentes. O módulo de importação de arquivos de áudio é capaz de construir corretamente as listagens de faixas ao mesclar os itens.

### Importação de dados a partir de outro software

O &appname; pode importar dados diretamente de diversos outros programas de gerenciamento de coleções, incluindo GCstar, Data Crow , Alexandria, Delicious Library, Collectorz, Catálogo Ant Movie, Referenciador e Griffith.

### Importação de outros formatos de dados

O &appname; pode importar os dados de uma variedade de outros formatos de arquivo, incluindo CSV, Bibtex, discos de áudio e arquivos, MODS, &PDF; e RIS.

#### Importar Dados do &appname;

Poderão ser importados diretamente outros arquivos de dados do &appname;. A substituição da coleção atual, através da importação de um arquivo de dados do &appname;, é a mesma coisa que abrir o próprio arquivo. O valor da importação dos dados do &appname; é apenas para adicionar ou mesclar duas coleções.

#### Importando os Dados em CSV

Os valores separados por vírgulas (CSV) são uma forma comum de importar e exportar dados em tabelas. Cada valor do campo é separado por uma vírgula, com um item por linha. Os títulos dos campos podem ser incluídos na primeira linha. O módulo de importação de CSV não está limitado apenas a usar uma vírgula como separador. Você poderá usar qualquer caractere ou sequência de texto.

A Janela de Importação de CSV
A Janela de Importação de CSV

Primeiro, selecione o tipo de coleção que está importando. Se estiver adicionando ou mesclando à coleção atualmente aberta, o tipo é limitado ao tipo da sua coleção atual. Se a primeira linha do arquivo CSV tiver os títulos dos campos, clique na opção para que o módulo de importação compare automaticamente os títulos com os campos da coleção atual. Se o título de um campo corresponder, o cabeçalho dessa coluna muda para mostrar que a coluna foi associada a esse campo. Se o arquivo usar um separador que não seja uma vírgula, certifique-se de alterar a opção de acordo com isso.

Para que o &appname; importe convenientemente o arquivo, ele deverá saber qual o campo que corresponde a cada coluna. Se a coluna só tiver um número no cabeçalho, os dados nessa coluna não serão importados. Você deverá atribuir os campos a cada coluna, selecionando uma coluna com o mouse ou alterando número da coluna em si, e depois selecionando o campo a atribuir a partir da lista e, finalmente, clicando no botão Atribuir o Campo. Se quiser adicionar um campo novo à coleção, o último item na lista abre a Janela de Campos da Coleção.

Por questões de compactação, apenas as primeiras cinco linhas do arquivo CSV importado serão mostradas na caixa de diálogo. Contudo, serão importadas todas as linhas do arquivo.

#### Importar Dados de &CD;'s de Áudio

O &appname; é capaz de usar o serviço do freedb.org para consultar informações sobre um &CD;, incluindo a lista de faixas. Dependendo da sua distribuição, a configuração do acesso ao serviço poderá ser definida nas &systemsettings; do &kde;. O artista do &CD;, o título, o gênero, o ano e a lista das faixas são todos adicionados.

Além disso, se o disco tiver &CD;-Text, essa informação é lida e adicionada ao item importado.

#### Importar os metadados dos arquivos de áudio

O &appname; é capaz de percorrer uma pasta e ler as marcas dos formatos de arquivos de áudio comuns, como o `mp3` e o `ogg`. As músicas são inseridas numa coleção de músicas, onde cada item é um álbum. Se os arquivos de música tiverem o número de faixa, o nome da música é inserido no local correto da lista de faixas. A informação do artista e do gênero também é adicionada ao item. Se as marcas da música tiverem comentários, estes serão adicionados ao campo de 'comentários' do item, antecedido pelo nome do arquivo.

Além disso, se uma pasta tiver um arquivo `.directory` e o nome da pasta corresponder ao título de um álbum, o item `Ícone` no arquivo '.desktop' é usado como imagem de capa para o álbum.

O módulo de importação de metadados de arquivos de áudio pode percorrer uma pasta de forma recursiva, de modo a encontrar todos os arquivos de áudio em qualquer subpasta, ainda que as ligações simbólicas não sejam seguidas. O &appname; usa a biblioteca TagLib para ler os metadados do arquivo de áudio, para que possa importar os dados de qualquer tipo de arquivo que esta biblioteca reconheça.

#### Importar Dados do Bibtex

Bibtex é um formato bibliográfico usado com o sistema de preparação de documentos LaTeX. Você poderá incluir diversos tipos de referências bibliográficas no arquivo. O &appname; importa os arquivos do 'bibtex' como uma coleção bibliográfica.

Se o módulo de importação do 'bibtex' encontrar campos no arquivo que não estejam na coleção bibliográfica padrão, eles serão adicionados como campos de Texto Simples, com duas exceções. Se o valor do campo tiver mais de 100 caracteres, tornar-se-á um campo de Parágrafo. Se o valor do campo parecer ter um &URL; ou uma referência de arquivos, então será criado um campo de &URL;. O &appname; usa uma cópia interna da biblioteca do 'btparse' para processar os arquivos do bibtex.

Bibtexml é uma representação em &XML; dos dados do 'bibtex', onde os dados do arquivo 'bibtexml' são tratados da mesma forma que seriam os dados do 'bibtex'.

#### Importar Dados do MODS

O MODS é um formato para representar diversos tipos de coleções de conteúdos. Atualmente, só são importados livros pelo &appname;, como uma coleção bibliográfica.

#### Importar Dados em &PDF;

Se o &appname; foi compilado com o suporte para o exempi ou o poppler, os metadados dos arquivos &PDF; poderão ser importados. Os metadados poderão incluir o título, o autor e a informação da data, assim como alguns identificadores bibliográficos que são então usados para atualizar outros dados.

#### Importar Dados do RIS

O RIS é um formato de arquivos bibliográficos usado pelo EndNote, Reference Manager, entre outros. O &appname; importa arquivos RIS como uma coleção bibliográfica.

### Importação de coleções online

O &appname; consegue-se conectar e importar dados de páginas Web que gerenciam coleções pessoais.

#### Importar coleção do BoardGameGeek

O BoardGameGeek é um recurso online de jogo de tabuleiro e comunidade. O &appname; pode importar os jogos de computador na coleção do usuário, desde que a coleção esteja definida para ser publicamente acessível. A coleção importada pode ser limitada a esses itens marcados como seus.

#### Importar coleção do Goodreads

O Goodreads é uma rede social online de leitores para procurar por coleções de livros. O &appname; pode importar a lista de livros em uma coleção de usuário, fornecendo-se o nome do usuário ou sua ID, caso a coleção esteja configurada como pública.

#### Importar coleção do LibraryThing

O LibraryThing é um serviço online para ajudar as pessoas a catalogarem seus livros facilmente. O &appname; pode importar a lista de livros em uma coleção do usuário, exportada no formato JSON.

#### Importar coleção do Discogs

O Discogs é um banco de dados online e um mercado de lançamentos musicais. O &appname; pode importar a lista de lançamentos musicais da coleção de um usuário, dado o nome do usuário, desde que a coleção esteja configurada para ser acessível publicamente.

### Importar Listagens de Arquivos

O &tellico; pode analisar pastas para importar informações de arquivos, principalmente para criar uma coleção de Catálogo de Arquivos. A pasta pode ser pesquisada recursivamente para adicionar todos os arquivos encontrados nela. Este importador é muito útil para listas de backups e catalogação de mídias, como listas de &CD;s ou DVDs. Além disso, pré-visualizações de imagens do conteúdo do arquivo podem ser geradas. As pré-visualizações de arquivos são as mesmas exibidas no gerenciador de arquivos do &kde;.

Pastas com arquivos de e-books e arquivos de vídeo também podem ser importadas como coleções de livros e vídeos. Os metadados dos arquivos podem ser lidos e, para arquivos de vídeo, quaisquer arquivos `nfo` existentes são usados ​​para completar as informações de entrada do vídeo.

### Importar Dados em &XML; com XSLT

Qualquer arquivo &XML; poderá ser importado para o &appname;, desde que exista uma folha de estilo &XSL; disponível para converter o arquivo para o formato do &appname;. O &appname; carrega automaticamente essa folha de estilo e aplica o processamento de &xslt; necessário para carregar o arquivo.

## Arrastar e Soltar

O arrastamento de arquivos de dados para a janela principal do &appname; e a posterior soltura dos mesmos irá importá-los, como se fosse invocado o comando de importação a partir dos menu. O processo de 'arrastar e soltar' funciona para os seguintes formatos de arquivos: Tellico, Bibtex, RIS, &PDF; e EPub. A importação de vários arquivos de uma vez também é suportada.

Por isso, por exemplo, se quiser catalogar diversos arquivos &PDF;, selecione-os no gerenciador de arquivos e arraste-os para a janela do &appname;. O &appname; irá importar tantos metadados dos arquivos quanto conseguir, obtendo depois a informação adicional a partir das diversas fontes na Internet configuradas.

## Exportar Dados

Ao exportar os dados na coleção, os valores dos itens poderão ser exportados tal como foram inseridos, ou então com a formatação automática oferecida pelo &appname;. Adicionalmente, a exportação poderá estar limitada aos itens selecionados atualmente na coleção, onde a barra de estado mostra o número de itens selecionados.

Os arquivos de texto exportados, como o Bibtex ou o CSV, poderão usar a codificação de caracteres Unicode (UTF-8) ou ainda a codificação local do sistema operacional.

Opções Gerais de Exportação
Opções Gerais de Exportação

### Exportar para &XML;

O formato do arquivo de dados do &appname; é um arquivos &XML; comprimido com o ZIP. A exportação para &XML; simplesmente cria o arquivo &XML; sem o comprimir. As imagens poderão ser incluídas no arquivo &XML; como dados codificados em 'base64' num elemento de imagem; porém, ao fazê-lo, poderá criar arquivos de dados muito grandes.

### Exportar para ZIP

O formato de arquivo padrão para o &appname; é um arquivo comprimido com o ZIP, contendo o arquivo de coleção em &XML; e, opcionalmente, todas as imagens referenciadas na coleção. Se as imagens forem guardadas na pasta da aplicação, a exportação para um arquivo ZIP irá criar um arquivo de dados autônomo, que contém todas as imagens na coleção.

### Exportar para &HTML;

A exportação para &HTML; usa a folha de estilo `tellico2html.xsl`. As imagens são exportadas para uma pasta com o mesmo nome que o arquivo &HTML; exportado, adicionando o texto `_files`.

O formato padrão é similar ao resultado impresso, permitindo várias opções para modificar o &HTML;. Os cabeçalhos dos campos poderão ser impressos no topo de cada coluna; porém, infelizmente, o &kde; não permite ainda a repetição dos cabeçalhos das tabelas em cada página. Os itens também poderão ser agrupados, como acontece na Área de Grupos.

Além disso, você poderá criar arquivos individuais para cada item na coleção, com as referências criadas no arquivo &HTML; de topo. Os arquivos dos itens serão criados na mesma pasta que as imagens. Os arquivos &HTML; dos itens irão usar o modelo da folha de estilo atual, tal como aparece na Área de Itens.

Opções de Exportação para &HTML;
Opções de Exportação para &HTML;

### Exportar para CSV

Os valores separados por vírgulas (CSV) são uma forma comum de importar e exportar dados em formato de tabela. Cada valor do campo é separado por uma vírgula, existindo um item por cada linha. Os títulos dos campos poderão ser incluídos como cabeçalhos na primeira linha. Todos os caracteres ou sequências de texto que não sejam uma vírgula também poderão ser usados para delimitar os campos.

Opções de Exportação para CSV
Opções de Exportação para CSV

### Exportar para o Alexandria

Alexandria é um gerenciador de coleção de livros alternativo para o ambiente de trabalho GNOME. O &appname; é capaz de exportar um subconjunto limitado dos campos das coleções de livros para a localização padrão do Alexandria.

### Exportar para o ONIX

ONIX é um formato em &XML; para representar e comunicar informações de produtos da indústria de livros, principalmente para os vendedores de livros. O &appname; consegue exportar as coleções de livros com um subconjunto do ONIX.

### Exportar para o Bibtex

Ao exportar para o Bibtex, os valores dos campos poderão ser marcados com parênteses ou marcas de citação. Se forem usadas algumas macros de texto na coleção, elas poderão ser exportadas opcionalmente como macros ou expandidas. Para os campos &URL;, o &appname; poderá envolver os valores dos campos com a marca `\url{...}`. Finalmente, os itens sem chave de citação poderão ser ignorados em vez de ter o &appname; gerando automaticamente a chave.

Opções de Exportação para Bibtex
Opções de Exportação para Bibtex

### Exportar para GCstar

O GCstar é outro gerenciador de coleções de filmes. O &appname; é capaz de exportar a maioria dos tipos de coleção para um arquivo de dados GCstar.

### Exportar para &XML; com o &xslt;

Finalmente, o &appname; consegue processar a sua representação interna em &XML; dos dados da coleção, através de uma folha de estilo &XSL; externa, antes da exportação. Este tipo de exportação poderá ser útil para gerar relatórios de texto ou outros tipos de arquivos.

## Trabalhar com Citações

Ao trabalhar numa bibliografia, as citações para os itens selecionados poderão ser geradas e usadas em muitos outros aplicativos. Uma citação no formato 'bibtex' poderá ser copiada para a área de transferência e depois colada num arquivo em LaTeX. As citações do Bibtex poderão também ser enviadas para um aplicativo externo, como o LyX ou o Kile, usando o mecanismo conhecido do lyxpipe.