# 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. Nos planos futuros, existe uma heurística melhorada para identificar os itens correspondentes mas atualmente e excetuando as coleções de músicas, eles deverão ser iguais em todos os campos. As coleções de músicas comparam apenas o artista e a música, sendo que as faixas são 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.

### Importar Dados do &appname;

Poderão ser importados 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.

Só são apresentadas as primeiras cinco linhas do arquivo CSV importado na janela.

### 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 as Bibliotecas do Alexandria

O Alexandria é um gerenciador de coleção de livros alternativo para o ambiente de trabalho GNOME. O módulo de importação oferece a opção de importar qualquer uma das bibliotecas encontradas em `$`HOME`/.alexandria/`.

### Importar os Dados do Catálogo de Filmes Ant

O Catálogo de Filmes Ant é um gerenciador de coleções de filmes alternativo.

### Importar Dados do Bibtex

O 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.

### Importar Dados do Bibtexml

O 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 das Delicious Library

O Delicious Library é um gerenciador de coleções alternativo para o ambiente de trabalho &Mac; OS X. O &appname; importa um sub-conjunto dos dados usados pela Delicious Library.

### Importar Dados do GCstar

O GCstar é um gerenciador de coleções alternativo. É suportada a importação de livros, filmes, músicas, moedas, jogos normais, jogos de tabuleiro e vinhos.

O &appname; também consegue importar os arquivos de dados do GCfilms. O GCfilms é o antecessor do GCstar e era um gerenciador de coleções de filmes. Normalmente, os arquivos de dados do GCfilms encontram-se em `$`HOME`/.local/share/gcfilms/`.

### Importar Dados do Griffith

O Griffith é um gerenciador de coleções de filmes alternativos. O &appname; é capaz de importar a maioria dos dados de uma base de dados do Griffith.

### 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 Referencer

O Referencer é um organizador de documentos e um gerenciador bibliográfico para o ambiente de trabalho GNOME. O &appname; irá importar a maioria dos dados encontrados numa base de dados do Referencer.

### Importar Dados do RIS

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

### 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 Listagens de Arquivos

A melhor forma de criar um Catálogo de arquivos é importar o conteúdo de uma pasta. A mesma pasta poderá ser percorrida de forma recursiva, para adicionar todos os arquivos encontrados dentro dela. Esta importação é mais útil para as listagens de cópias de segurança e para o catálogo de conteúdos, como as listagens de &CD;s ou DVDs. Além disso, as previsões das imagens do conteúdo do arquivo poderão ser geradas, ainda que isso leve algum tempo para ler uma grande quantidade de arquivos. As previsões dos arquivos são as mesmas que aparecem no gerenciador de arquivos do &kde;.

### 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 e PDF. 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 Pilot-DB

O Pilot-DB é um formato de banco de dados para o &PalmOS;. Existem diversas aplicações de computador que conseguem ler e escrever arquivos do Pilot-DB. Os arquivos `.pdb` exportados poderão ser transferidos para um PDA e serem utilizados diretamente. Atualmente, o &appname; não é capaz de importar os arquivos do Pilot-DB.

Opções de Exportação para Pilot-DB
Opções de Exportação para Pilot-DB

### Exportar para o Alexandria

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

### Exportar para o ONIX

O ONIX é um formato em &XML; para representar e comunicar informações de produtos da indústria de livros, principalmente para os fabricantes de livros. O &appname; consegue exportar as coleções de livros com um sub-conjunto 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 Bibtexml

O Bibtexml é um formato para expressar os dados do 'bibtex' em &XML;.

### 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 atualmente selecionados poderão ser geradas e usadas em muitas outras aplicações. 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 uma aplicação externa, como o LyX ou o Kile, usando o mecanismo conhecido do lyxpipe.