&Michael.T.Edwardes; &Michael.T.Edwardes.mail;
30/08/2014
4.7.01

# 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 a aplicação. Dica do Dia Dica do Dia

É recomendável que você leia rapidamente estas dicas, clicando nos botões Anterior e Próximo, no fundo da janela.

Assim que tenha lido as dicas, a janela poderá ser fechadas e será aberta de novo, sempre que o &kappname; for iniciado. Para interromper este comportamento padrão, desligue a opção apropriada na janela da Dica do Dia.

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

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

Por favor, 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; consiste em quatro partes importantes

- A. Barra de menus

- B. A barra de ferramentas

- C. O seletor de áreas

- D. A área selecionada

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

O seletor de áreas consiste em 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 num í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 Inicial 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: Os seus depósitos e movimentos recorrentes.

- Á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 Livros de Registros: As suas transações na 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: Os 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 'feedback' sobre os processos em execução. Esta é uma vista fornecida pelo 'plugin' KBanking e poderá não estar presente no seu sistema.

## Criar um novo arquivo

O &kappname; mantém todos os dados sobre as suas finanças num arquivo. Como foi definido em Definir as contas (registros pessoais), você poderá manter mais de um conjunto de contas, mas os dados de cada um será guardado num 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 por favor o seu nome e endereço, ou então não insira nada, e pressione Próximo.

No caso de ter um endereço próprio registrado no &kaddressbook;, o botão Carregar a Partir do Livro de Endereços ficará ativo e, caso pressione ele, será importada toda a informação para o &kappname;.

O &kappname; suporta várias moedas. Para definir a sua moeda base (a que você usa no dia a dia e que será usada para os seus relatórios), selecione o item apropriado na lista oferecida e pressione Próximo. Será selecionada uma por padrão do &kappname;, baseando-se 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 é 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 faz a gestão da conta. Indique a data de abertura da conta e o saldo inicial da mesma. Por exemplo, se você 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 num 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, desligue por favor a opção

Assim que terminar, pressione 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 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 às suas necessidades, não selecione nenhum modelo.

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

A página seguinte do assistente permite-lhe configurar as preferências do usuário. Pressione 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 selecionar o nome de um 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 criar o arquivo, pressione Terminar para que o &kappname; crie o arquivo e o abra.

## 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 toda a aplicação. Se você não conseguir perceber como tentar fazer algo, tente clicar com o botão direito do mouse onde estaria esperando um determinada funcionalidade.

Ao criar uma conta nova, com qualquer um dos métodos, será aberto o Assistente de Novas Contas. Este assistente irá conduzi-lo, passo-a-passo, pelo processo de criação de uma conta, recolhendo as informações necessárias em cada passo. 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ê poderá encontrar uma descrição completa da criação de contas na seção de 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 ou evento recorrente é uma transação que ocorre uma ou mais vezes, durante um determinado período de tempo. Algumas vezes chamadas de transações recorrentes, um exemplo típico é o cheque do seu salário, que recebe todos os meses ou semanas. Em vez de ter que inserir os detalhes da transação sempre que é pago, você poderá dizer ao &kappname; para criar um evento recorrente que irá inserir uma transação para você, quando for pago.

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ê poderá encontrar uma descrição completa sobre este tópico na seção de Categorias.

## Etiquetas

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

Você poderá 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ê poderá encontrar uma descrição completa sobre este tópico na seção de 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ê poderá encontrar uma descrição completa sobre este tópico na seção de Importação do QIF.

## Procurando por transações

O &kappname; oferece uma funcionalidade útil e poderosa de 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ê poderá 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 existirem discrepâ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ê poderá encontrar uma descrição completa sobre este tópico na seção de 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. Neste caso, o comportamento padrão é que o &kappname; abrirá 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 o programa estourar na inicialização.

### `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.

## Contactar os Programadores / Comunicar Erros

### Contactar 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;.

### Comunicar 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, lei por favos a recomendações abaixo. Ao 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 nos estouros

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

##### 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; estourou. 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 regressei à página de Transferência, o &kappname; estourou. Este erro pode ser completamente reproduzido por mim.

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

Nos estouros, isso é ó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 estava esperando que tivesse 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 um estouro, execute o &kappname; de novo dentro do 'gdb' e reproduza o estouro. Quando estourar, escreva bt para gerar um registro de chamadas.

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