# Usando o &kappname; pela primeira vez

## Executando o &kappname; pela primeira vez

Assim que o &kappname; tenha sido completamente carregado, serão abertas duas janelas. A janela de topo, a 'Dica do Dia', oferece uma série de informações rápidas importantes ou úteis sobre o aplicativo. Dica do Dia Dica do Dia

Recomendamos uma rápida leitura dessas dicas, clicando nos botões Anterior e Próximo, disponíveis na parte inferior da janela.

Assim que terminar de ler as dicas, a janela poderá ser fechada; ela será reaberta sempre que iniciar o &kappname;. Para alterar esse comportamento, desmarque a opção apropriada na janela Dica do Dia.

As dicas poderão ser lidas a qualquer momento, selecionando a opção Mostrar a dica do dia no menu Ajuda do &kappname;.

Todas as dicas foram extraídas da lista de perguntas frequentes (FAQ) que oferece uma ajuda mais detalhada, e que poderá ser encontrada na página Web e neste manual.

Clique em Fechar para encerrar a janela da Dica do Dia.

## A janela principal

A janela principal A janela principal

A janela principal do &kappname; é composta de quatro partes importantes

- A. Barra de menus

- B. Barra de ferramentas

- C. Seletor de áreas

- D. Área selecionada

O menu e as barras de ferramentas proporcionam acesso às funcionalidades do &kappname;, permitindo-lhe criar arquivos ou configurar o funcionamento do &kappname;.

O seletor de áreas é composto de pelo menos onze ícones do lado esquerdo da janela principal, dependendo do software fornecido pelo seu sistema. Você poderá adicionar mais ícones através de vários plugins. Clicando em um ícone, a janela da área do lado direito é carregada com a área apropriada a mostrar os seus dados financeiros. Cada área oferece uma vista única sobre a sua situação financeira e permite-lhe ver ou editar a informação apresentada.

O seletor de áreas contém os seguintes ícones:

- Área de Início Início: Uma visão geral configurável sobre a sua situação financeira atual (ou uma página introdutória, quando não existirem dados).

- Área de Instituições Instituições: Todas as suas instituições e contas, apresentadas de forma hierárquica.

- Área de Contas Contas: Todas as suas contas, apresentadas de forma hierárquica.

- Área de Agendamentos Agendamentos: Seus depósitos e movimentações periódicas.

- Área de Categorias Categorias: Contas especiais que oferecem a possibilidade de agrupar as transações associadas.

- Área de etiquetas Etiquetas: Contas especiais que oferecem uma forma adicional de agrupar as transações associadas, além das Categorias.

- Área de Beneficiários Beneficiários: Todos os beneficiários usados pelo &kappname;.

- Área do Livro de Registros Livro de registros: As transações da sua conta.

- Área de Investimentos Investimentos: O resumo do seu portfólio.

- Área de Relatórios Relatórios: Uma coleção de relatórios úteis, oferecendo vistas alternativas sobre os seus dados financeiros.

- Área de Orçamentos Orçamentos: Seus orçamentos

- Área de Previsão Previsão: Esta vista oferece uma antevisão sobre as suas contas e categorias

- Área de Saída Área de Saída: Usada pelo módulo do banco online, de modo a oferecer o retorno dos processos em execução. Esta é uma vista fornecida pelo plugin KBanking e pode não estar presente no seu sistema.

## Criando um novo arquivo

O &kappname; armazena todos os dados sobre suas finanças em um arquivo. Como foi definido em Definir as contas (registros pessoais), você poderá manter mais de um conjunto de contas, mas os dados de cada uma serão armazenados em um arquivo separado, sendo que o &kappname; só pode ter um arquivo aberto de cada vez. Veja o capítulo sobre Formatos de Arquivos para obter mais detalhes sobre os arquivos de dados do &kappname;.

Para criar um novo arquivo, você poderá selecionar a opção Arquivo Novo no menu ou escolher a opção Novo da barra de ferramentas.

O &kappname; irá então abrir o Assistente de Configuração dos Novos Arquivos, que o guiará pelo processo de criação do arquivo.

Página de Dados Pessoais Página de Dados Pessoais

Uma vez que todos os campos são opcionais, você poderá usar o &kappname; sem inserir qualquer informação agora. Toda a informação que for aqui inserida só é usada para personalizar o seu arquivo. No futuro, poderá ser usada em alguns relatórios e para o banco 'online'. Se o &kappname; necessitar de alguma informação pessoal nas versões futuras e não encontrar nada, será solicitada a inserção então dos dados relevantes.

Insira o seu nome e endereço, ou então não insira nada, e clique em Próximo.

No caso de ter um endereço próprio registrado no &kaddressbook;, o botão Carregar do livro de endereços ficará ativo e, caso clique nele, todas as informações serão importadas para o &kappname;.

O &kappname; tem suporte a várias moedas. Para definir a sua moeda base (a que você usa no dia a dia e que será usada nos seus relatórios), selecione o item apropriado na lista oferecida e clique em Próximo. O &kappname; selecionará uma moeda por padrão, com base na sua configuração regional.

Página de seleção da moeda base Página de seleção da moeda base

A página seguinte permite-lhe criar uma conta inicial. Para o usuário típico do &kappname;, esta será uma conta-corrente.

Página de criação de uma conta corrente Página de criação de uma conta corrente

Insira o nome da conta e um possível número de referência, atribuído pela instituição que gerencia a conta. Indique a data de abertura e o saldo inicial da conta. Por exemplo, se quiser usar o &kappname; para gerenciar todas as suas finanças desde 01/01/2008, indique então o saldo da conta no início dessa data. O número poderá ser obtido a partir de um extrato em papel. Indique depois o nome e o número da agência, ainda que esta informação só seja necessária para o banco online.

Caso não queira configurar uma conta inicial, desmarque a opção

Assim que terminar, clique em Próximo para prosseguir.

Página de seleção do modelo de contas Página de seleção do modelo de contas

Escolha o país e os modelos de conta apropriados. Você poderá selecionar vários modelos, incluindo de vários países, com uma combinação das teclas &Ctrl; e &Shift;, em conjunto com o botão esquerdo do mouse. A hierarquia de contas a configurar será apresentada numa área de previsão do assistente. No caso de não conseguir encontrar um modelo adequado as suas necessidades, não selecione nenhum modelo.

Assim que terminar a seleção do modelo, clique em Próximo para prosseguir.

A próxima página do assistente permite-lhe configurar as preferências do usuário. Clique em Próximo se tiver terminado e quiser prosseguir.

Página de Preferências Página de preferências

A última página do assistente permite-lhe selecionar o nome do arquivo que será usado para guardar os seus dados financeiros. Será criado um nome inicial para o arquivo, com base na sua pasta HOME e o seu nome de usuário. No caso do arquivo existir, será apresentado um aviso que lhe diz para escolher um nome de arquivo inexistente.

Página de seleção do nome do arquivo Página de seleção do nome do arquivo

Agora que você terminou de inserir todas as informações relevantes para criação do arquivo, clique em Concluir para criar o arquivo e abri-lo no &kappname;.

## Criando contas

Você poderá criar uma conta numa de duas formas, as quais são descritas aqui:

Usando o menu

- Para criar uma conta com o menu, selecione a opção Contas Nova conta.

Usando a área de contas

- Para criar uma conta com a área de contas, clique no ícone Contas no seletor de áreas e depois clique com o botão direito no ícone da árvore de Ativos, do lado direito, e escolha a opção Nova conta no menu de contexto. A árvore de Ativos mantém todas as contas que sejam ativos. Os ativos, assim como todos os outros tipos de contas, serão discutidos em mais detalhes neste manual.

Repare que o &kappname; usa os menus de contexto de um modo geral em todo o aplicativo. Se não souber como fazer algo, tente clicar com o botão direito do mouse onde você espera encontrar um determinada funcionalidade.

Ao criar uma nova conta, com qualquer um dos métodos, será aberto o Assistente de Novas Contas. Este assistente irá conduzi-lo por cada etapa da criação de uma conta, reunindo as informações necessárias em cada uma delas. Para navegar pelas páginas, clique nos botões Anterior e Próximo.

Crie uma conta com qualquer um dos dois métodos mencionados anteriormente para continuar. Você pode encontrar uma descrição completa sobre a criação de contas na seção Contas.

Agora que uma ou mais contas já existem no &kappname;, o seu resumo de contas aparece na área inicial. Você poderá criar transações manualmente na área do Livro de Registros ou configurar as transações automáticas com a área de Agendamento.

## Agendamentos

Um Agendamento, também chamado de evento recorrente, é uma transação que ocorre uma ou mais vezes, durante um determinado período de tempo. Um exemplo típico é o cheque do salário, recebido por mês ou semana. Em vez de precisar inserir os detalhes da transação sempre que receber o pagamento, você poderá instruir o &kappname; a criar um evento recorrente que irá inserir automaticamente uma transação para você.

Para fazer a manutenção dos agendamentos, clique no ícone Agendamentos no seletor de áreas.

## Categorias

Para fazer a manutenção das categorias, clique no ícone Categorias no seletor de áreas.

Você pode encontrar uma descrição completa sobre este tópico na seção Categorias.

## Etiquetas

Para fazer a manutenção das etiquetas clique no ícone Etiquetas no seletor de áreas.

Você pode encontrar uma descrição completa sobre este tópico na seção Etiquetas.

## Beneficiários

Para manter sua lista de beneficiários, clique no ícone Beneficiários no seletor de áreas.

Você pode encontrar uma descrição completa sobre este tópico na seção Beneficiários.

## Importação do Formato de Intercâmbio do Quicken (QIF)

Se você atualmente usar uma aplicação de gerenciamento financeiro, o &kappname; poderá então importar as transações de uma conta, desde que estejam no formato de intercâmbio do Quicken (QIF). A maioria dos programas financeiros poderá exportar para este formato, e os diferentes métodos das aplicações para exportar em QIF não são aqui explicados, de modo a não alongar este manual.

Você pode encontrar uma descrição completa sobre este tópico na seção Importação do QIF.

## Procurando por transações

O &kappname; oferece uma funcionalidade útil e poderosa para pesquisa de transações, sob a forma de uma janela de pesquisa.

A janela de pesquisa poderá ser aberta na barra de ferramentas, usando o ícone ou selecionando a opção Procurar transação do menu Editar.

Você pode encontrar uma descrição completa sobre este tópico na seção Procurar.

## Reconciliação

Em algum momento, você desejará reconciliar as transações que inseriu com as transações que constam num extrato, seja este um extrato bancário, do cartão de crédito, do financiamento ou outro qualquer. A reconciliação envolve fazer a correspondência do que inseriu com o que o extrato apresenta. Se forem encontradas divergências, então você ou a pessoa que criou o extrato cometeram um erro.

Para reconciliar uma conta, selecione-a primeiro, quer na área de Contas quer na área de Livros de Registros. Depois, você poderá clicar no ícone Reconciliar da barra de ferramentas ou selecionar a opção Reconciliar do menu Conta.

Você pode encontrar uma descrição completa sobre este tópico na seção Reconciliação.

## Fazendo cópias de segurança

Agora que você criou algumas contas e inseriu as transações, é uma boa ideia fazer uma cópia de segurança. Uma vez que o arquivo usado pelo &kappname; é um arquivo normal do Unix, você poderá simplesmente copiar o arquivo para outra localização, de modo a fazer uma cópia de segurança, ou usar a janela oferecida pelo &kappname;. O uso da janela é o método preferido, porque se o &kappname; começar a usar outros formatos de arquivos, como o SQL, seria então muito mais complicado copiar o arquivo manualmente.

Para fazer uma cópia de segurança pelo &kappname;: Selecione a Cópia de Segurança no menu Arquivo e insira a pasta para onde deseja copiar o arquivo. Se a pasta precisar ser montada, e se tiver os privilégios suficientes, então assinale a opção chamada Montar esta pasta antes de fazer a cópia de segurança e clique em OK.

O arquivo será copiado para a pasta indicada, com a data atual adicionada ao nome do arquivo, para que seja fácil de ver a data em que a cópia de segurança foi criada.

## Iniciando o &kappname;

Normalmente, você lançará o &kappname; a partir de um ícone ou de menu do seu gerenciador de janelas. Nesse caso, o comportamento padrão é que o &kappname; usará o último arquivo que você abriu. No entanto, em algumas situações, você desejará ou precisará iniciar o &kappname; a partir da linha de comando.

Para uma descrição completa de todas as opções da linha de comando, veja a página do 'man' para o &kappname;. Contudo, existem dois casos especiais que serão aqui descritos.

## `kmymoney -n`

A opção '-n' diz ao &kappname; para não abrir o último arquivo aberto anteriormente. Isto pode ser útil se, por algum problema, não conseguir iniciar o programa.

## `kmymoney <caminho do arquivo>`

Fornecer ao &kappname; um nome de arquivo na linha de comando faz com que este arquivo seja aberto ao invés do anterior. Você pode usar o nome de qualquer arquivo válido do &kappname;, como descrito no capítulo sobre formatos de arquivo. Além disso, ele pode ser usado para importar um arquivo do GnuCash.

## Como mover o &kappname; para um novo computador

### Movendo seus dados

É muito fácil mover seus dados para um novo computador. De fato, tudo o que você precisará fazer é copiar seu arquivo de dados do &kappname;. O nome do arquivo aparece na barra de título quando o &kappname; está em execução e termina normalmente com a extensão .kmy. Da primeira vez que executar o aplicativo no novo computador, você precisa indicar onde colocou o arquivo de dados, seja através da linha de comando ou a partir da opção do menu Arquivo Abrir.... Você deve conseguir mudar entre sistemas &Windows;, &MacOS; e &Linux;.

Se você criptografou seu arquivo de dados, verifique se o aplicativo e as chaves apropriados também foram configurados no novo computador.

Se os seus dados estiverem em um banco de dados SQL, consulte a documentação do software do seu banco de dados para saber como fazer a migração.

Lembre-se de que parte-se do pressuposto de que você instalou no novo computador a mesma versão do &kappname; usada no antigo. A instalação de uma versão mais recente também deverá ser segura, mas você precisa ficar atento a quaisquer questões relacionadas com essa atualização. Todas essas questões devem ser referenciadas nas notas de lançamento da nova versão.

### Movendo suas configurações

Se mover apenas seu arquivo de dados para o novo computador, na forma descrita na seção anterior, o &kappname; irá funcionar corretamente, mas perderá todas as configurações que você alterou no seu computador antigo. Para manter essas configurações, você também deve copiar seu arquivo de configuração. Esse arquivo chama-se kmymoneyrc e pode ser encontrado na pasta de arquivos de configuração dos aplicativos do &kde;. Em um sistema &Linux;, esta pasta estará em $KDEHOME/share/config, onde $KDEHOME normalmente é .kde4 dentro da sua pasta pessoal.

#### Movendo as configurações do plugin

Se você executou algum plugin do &kappname;, como a importação ou exportação de CSV, também poderá existir um arquivo de configuração na mesma pasta, como por exemplo, 'csvimporterrc' ou 'csvexporterrc'. Esses arquivos também deverão ser copiados para o novo computador.

Assim como no arquivo de dados principal, assume-se que a versão do plugin em ambos os computadores seja a mesma. As atualizações normalmente são seguras, mas se a funcionalidade do plugin foi consideravelmente alterada, aconselhamos testar com cuidado o arquivo de configuração antigo, para ter certeza de que o plugin se comporta como esperado.

Estas instruções servem apenas para mover seus dados e configurações do &kappname;. Contudo, poderão existir itens importantes que são armazenados pelo &kde; e não pelo &kappname;, como as senhas guardadas no KWallet. A replicação de outras partes da sua configuração do &kde; está fora do escopo deste manual, ainda que boa parte dos arquivos de configuração relevantes também são armazenados na pasta $KDEHOME.

## Contactando os programadores / Comunicando erros

### Contactando os programadores

Para questões ou comentários gerais sobre o &kappname;, existe uma lista de discussão para usuários em &userlist;. Além disso, você poderá contatar os desenvolvedores através da lista de discussão &devlist;.

Nós estamos ansiosos para ouvir as suas experiências com a utilização do &kappname;.

### Comunicando erros

Para relatar um erro, use a interface fornecida pelo &kappname;, selecionando Ajuda Relatar erro e preencha as informações necessárias. No entanto, caso tenha dificuldades com esse método, você pode relatar um erro (ou solicitar uma nova funcionalidade ou melhoria) diretamente na página de comunicação de erros do &kde;. Os relatórios devem ser preenchidos para o produto kmymoney4. O kmymoney2 refere-se a erros nas versões 1.0.x do aplicativo, sendo que já não há mais suporte para essas versões e está fechada para novos relatórios de erro.

De qualquer modo, antes de relatar um erro, leia as recomendações abaixo. Se segui-las, será mais provável que os desenvolvedores sejam capazes de rapidamente identificar o problema sem ter que pedir mais informações.

#### Criando Relatórios de Erros de Qualidade

Encorajamos os usuários a gastarem algum tempo extra escrevendo relatórios de erros de qualidade, quando os enviarem. Isto reduz o esforço dispendido por ambas as partes, uma vez que o usuário que relata e o programador que irá corrigir irão trocar e-mails até toda esta informação estar realmente no lugar.

Eli Goldberg escreveu as Recomendações de Escrita de Erros, disponível em http://issues.apache.org/bugwritinghelp.html. De um modo geral, você ficará bem servido com estas recomendações:

#### Inclua a informação do seu sistema

O menu Ajuda Relatar erro irá preencher isso automaticamente, mas se preferir não usar essa interface, será preciso incluir algumas informações no relatório. Nós precisamos saber qual sistema operacional você está usando (&Linux;, &MacOS; ou &Windows;), a versão do &kde; e a versão do &kappname;. Adicionalmente, você deverá informar qual a versão do &MacOS; ou &Windows;, ou o nome e versão da sua distribuição &Linux;, assim como a versão do seu kernel.

#### Incluir um registro de chamadas nas falhas

O registro de chamadas é normalmente a única e mais útil peça de informação na resolução de falhas.

#### Tentar reproduzi-lo

Deixe-nos saber se é capaz de fazer isso. É útil saber se o erro só ocorreu uma vez, e se não o consegue reproduzir de novo, ou se acontece sempre ou muitas vezes, mas não em outras.

#### Incluir passos específicos

Este é um mau relatório de erros: Eu inseri uma transação, e o &kappname; falhou. Um relatório de erros muito melhor é: Ao usar o formulário da transação, inseri uma nova transação na minha conta de Cartão de Crédito. Selecionei a página de Transferências, inseri um montante, depois mudei para a página do Depósito e voltei à página de Transferência. Quando retornei à página de Transferência, o &kappname; falhou. Este erro pode ser completamente reproduzido por mim.

#### Diga-nos o que esperava que acontecesse

Nos falhas isso parece óbvio, mas em alguns erros mais sutis, você poderá ver um relatório de erros onde não seja óbvio o que a pessoa que relatou o erro esperava que acontecesse. Diga-nos sempre o que acha que deveria ter acontecido.

#### Considere executá-lo com a depuração ativa

Ao compilar uma versão com a opção '--enable-debug=full', você poderá garantir que serão gerados os melhores registros de chamadas. Se encontrar uma falha, execute o &kappname; de novamente dentro do 'gdb' e reproduza a falha. Quando ocorrer, digite bt para gerar um registro de chamadas.

Executar o aplicativo dessa forma é um pouco mais complicado, por isso não esperamos que todos os usuários o faça. Contudo, se você estiver interessado em ajudar o &kappname; a ficar o mais estável possível, esta é a melhor forma de encontrar o erro no código e enviar uma correção.