&Thomas.Baumgart; &Thomas.Baumgart.mail;
30/08/2014
4.7.01

# Formatos de arquivo

A menos que você opte por usar uma base de dados relacional, o &kappname; irá guardar todas as suas informações financeiras num arquivo que termina em '.kmy'. Do mesmo modo, a menos que use uma opção da linha de comando que indique para não fazer isso, ao lançar o &kappname; ele irá abrir o último arquivo que tiver aberto. Contudo, é importante que saiba que existe mais de um tipo de arquivo que o &kappname; pode usar para guardar os seus dados financeiros.

Este capítulo descreve os formatos onde o &kappname; guarda os seus dados, de forma permanente, no dispositivos de armazenamento do usuário. De um modo geral, o &kappname; guarda a sua informação sob um documento em &XML;. Dependendo do formato atual, este documento em &XML; será escrito

- como um arquivo de texto simples, codificado em UTF-8,

- como um arquivo comprimido, usando a compressão GZIP,

- como um arquivo criptografado, usando a criptografia do GPG ou

- como um arquivo de texto simples anônimo, codificado em UTF-8, mas com todos os seus dados pessoais embaralhados.

## Arquivo de texto simples

Este é o formato que consome mais espaço, uma vez que não é efetuada nenhuma compressão. Não foi feito para um uso normal e é fornecido apenas para fins de depuração, e com a ideia de modificar manualmente o arquivo. Se terminar o nome do arquivo em `.xml`, o arquivo será gravado nesse formato.

A modificação manual do arquivo não é recomendada para o usuário normal, devendo apenas ser efetuada se o funcionamento interno do &kappname; estiver completamente compreendido ou tiver indicações dos programadores sobre o que fazer. Não culpe os programadores do &kappname; se perder os seus dados: Você foi avisado!

## Arquivo comprimido com o GZIP

Este é o formato normal, usado pelo &kappname;, quando salvar um arquivo com a extensão `.kmy`.

Se tiver selecionado a criptografia, o arquivo será gravado criptografado.

Se você quiser ver um arquivo comprimido com o GZIP, mude o nome do arquivo para algo terminado em `.gz` (&eg; `financas.kmy` para `financas.kmy.gz`, usando depois o `gunzip` para descomprimir o arquivo e olhar para ele. Você não terá de comprimi-lo antes de carregá-lo no &kappname; da próxima vez, porque o &kappname; também consegue ler os dados não-comprimidos. Em todo o caso, se salvá-lo posteriormente, ele será gravado comprimido novamente. Use a extensão .xml para o salvar num formato não-comprimido.

## Arquivo criptografado com o GPG

O uso do formato de arquivo criptografado com o GPG é um método muito seguro de guardar os seus dados financeiros pessoais no seu dispositivo de armazenamento. Quando o &kappname; for configurado na respectiva janela para guardar os seus dados criptografados, ele irá codificar os dados com o GPG e com a chave que indicar, antes de salvá-lo propriamente. Ao abrir um arquivo criptografado, você terá que indicar a frase-senha necessária para abrir o seu porta-chaves. O arquivo criptografado em si será guardado no formato armado em ASCII do GPG.

Ao usar a criptografia do GPG, este irá também comprimir o arquivo, não sendo necessária nenhuma compressão extra.

### Chaves do GPG

Se você não a tiver já feito para a criptografia do correio, você terá que gerar um par de chaves para poder usar a funcionalidade de criptografia com GPG do &kappname;. Do mesmo modo, o GPG terá que estar instalado no seu sistema.

Os detalhes sobre a geração de um par de chaves, e como lidar com ele, está fora do escopo deste documento. Está disponível um Mini-Howto sobre o assunto em http://www.gnupg.org/documentation/howtos.en.html.

### Configurar as chaves no &kappname;

Na página de criptografia da janela de configuração, existe um campo onde você poderá inserir a chave que deverá ser usada para criptografia e descriptografia. Além disso, você poderá encontrar um campo onde poderá usar o ID de uma chave que não conste na lista. Você tanto poderá usar o ID da chave, o endereço de e-mail associado a esta chave ou qualquer outra identificação de chaves do GPG válida como valor para este campo. Quando inserir o ID da chave, o &kappname; irá verificar a sua validade e ligar um LED verde na janela, caso seja encontrada uma chave.

Certifique-se de que tem tanto a chave pública como a privada para este ID. Se você não possuir a chave privada do ID introduzido, não será capaz de acessar o arquivo de novo.

### A chave de recuperação do &kappname;

Do mesmo modo, nesta página da janela de configuração, você poderá selecionar uma criptografia suplementar com a chave de recuperação do &kappname;. Esta opção está disponível para você, se essa chave estiver no seu porta-chaves do GPG. Se selecionar esta opção, poderá recuperar os seus dados, mesmo no caso de perder a sua chave privada. Isto é possível, porque os dados não estão só encriptados para a sua chave, mas também para a chave de criptografia do &kappname;. Esta chave só está disponível para os programadores do &kappname; selecionados (no momento da escrita deste documento, somente o autor). Com o lançamento do &kappname; versão 4.7, a chave de recuperação está configurada para expirar dia 3 de janeiro de 2015.

Em circunstâncias normais, você irá abrir/salvar/fechar o seu arquivo, como de costume. No caso anormal de perda da sua chave, você terá a chance de contactar um dos programadores que tiver acesso à chave de recuperação do &kappname;, pedindo para tal ajuda para recuperar os seus dados. Você poderá contactar os programadores por e-mail, na lista de correio do &kappname;, em &devlist;.

## Arquivo anônimo

Este formato não pretende ser usado para o armazenamento de dados normais. É suportado para que, em caso de ocorrer algum problema, possa fornecer à equipe de desenvolvimento do &kappname; o seu arquivo sem revelar nenhum dos seus detalhes confidenciais dos seus dados financeiros. Por exemplo, muda a instituição, a conta, o beneficiário e os nomes das categorias para coisas do tipo "I000001" e "A000001,", fazendo alterações semelhantes para todos os dados, como os números de conta, mudando também de forma aleatória os montantes das transações.

Se for indicado pelos programadores, use a opção do menu Salvar Como... para salvar os seus dados num formato anônimo, selecionando os `Arquivos anônimos` como filtro. Isto irá também mudar a extensão do arquivo para `.anon.xml`.

Para verificar se o seu problema ainda existe, recarregue este arquivo anônimo e tente replicar o seu problema. Se ele continuar existindo, envie o arquivo à lista de correio dos programadores, em &devlist;, para mais informações. Se o problema não se manifestar... bem, não queremos pensar nesse cenário por agora.