# Usar o &kappname; pela primeira vez

## Executar o &kappname; pela primeira vez

Assim que o &kappname; tenha sido completamente carregando, serão abertas duas janelas. A janela de topo, a 'Dica do Dia', oferece uma série de peças informativas importantes ou úteis acerca da aplicação. Dica do Dia Dica do Dia

Recomenda-se que leia rapidamente estas dicas, carregando nos botões Anterior e Seguinte, 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 parar este comportamento predefinido, desligue a opção apropriada na janela da Dica do Dia.

As dicas poderão ser lidas em qualquer altura, seleccionando 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 mais frequentes) que oferece mais alguma ajuda detalhada, e que poderá ser encontrada na página Web e neste manual.

Por favor, carregue 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. A barra do menu

- A. A barra de ferramentas

- C. O selector de áreas

- D. A área seleccionada

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

O selector de áreas consiste em pelo menos onze ícones do lado esquerdo da janela principal, dependendo do 'software' fornecido pelo seu sistema. Poderá adicionar mais ícones através de vários 'plugins'. Se carregar 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 selector de áreas contém os seguintes ícones

- Área Inicial Início: Uma visão geral configurável sobre a sua situação financeira actual (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 Calendarização Eventos Recorrentes: Os seus depósitos e movimentos recorrentes.

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

- Área de Marcas Marcas: Contas especiais que oferecem uma forma adicional de agrupar as transacções associadas, para além das categorias.

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

- Área do Livro de Registos Livros de Registos: As suas transacções na conta.

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

- Área de Relatórios Relatórios: Uma colecçã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 Usada pelo módulo da banca '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 ficheiro

O &kappname; mantém todos os dados acerca das suas finanças num ficheiro. Como foi definido em Definir as contas (registos pessoais), poderá manter mais de um conjunto de contas, mas os dados de cada um será guardado num ficheiro separado, sendo que o &kappname; só pode ter um ficheiro aberto de cada vez. Veja o capítulo sobre Formatos de Ficheiros para obter mais detalhes sobre os ficheiros de dados do &kappname;.

Para criar um novo ficheiro, poderá tanto seleccionar a opção Ficheiro 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 Ficheiros, que o guiará pelo processo de criação do ficheiro.

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

Dado que todos os campos são opcionais, poderá usar o &kappname; sem introduzir qualquer informação agora. Toda a informação que for aqui introduzida só é usada para personalizar o seu ficheiro. De futuro, poderá ser usada em alguns relatórios e para a banca 'online'. Se o &kappname; necessitar de alguma informação pessoal nas versões futuras e não encontrar nada, ser-lhe-á pedido para introduzir então os dados relevantes.

Introduza por favor o seu nome e endereço, ou então não introduza nada de todo, e carregue em Seguinte.

No caso de ter um endereço próprio registado no &kaddressbook;, o botão Carregar a Partir do Livro de Endereços ficará activo e, caso carregue nele, irá importar toda a informação para o &kappname;.

O &kappname; suporta várias moedas. Para definir a sua moeda de base (a que usa no dia-a-dia e que será usada para os seus relatórios), seleccione o item apropriado na lista oferecida e carregue em Seguinte. Será seleccionada uma por omissão do &kappname;, baseando-se na sua configuração regional.

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

A seguinte página permite-lhe criar uma conta inicial. Para o utilizador típico do &kappname;, esta é uma conta à ordem.

Página de criação de uma conta à ordem Página de criação de uma conta à ordem

Indique 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 quiser usar o &kappname; para gerir 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 extracto em papel. Indique depois o nome e o número da agência, ainda que esta informação só seja necessária para a banca 'online'.

No caso de não querer configurar uma conta inicial, desligue por favor a opção

Assim que terminar, carregue em Seguinte para prosseguir.

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

Escolha o país e modelos de conta apropriados. Poderá seleccionar 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 rato. A hierarquia de contas a configurar será apresentada numa área de antevisão do assistente. No caso de não conseguir encontrar um modelo adequado às suas necessidades, não seleccione nenhum modelo.

Assim que terminar a selecção do modelo, carregue em Seguinte para prosseguir.

A página seguinte do assistente permite-lhe configurar as preferências do utilizador. Carregue em Seguinte se tiver terminado e quiser prosseguir.

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

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

Página de selecção do nome do ficheiro Página de selecção do nome do ficheiro

Agora que terminou de recolher toda a informação relevante para criar o ficheiro, carregue em Terminar para que o &kappname; crie o ficheiro para si e o abra.

## Criar contas

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

Usar o menu

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

Usar a área de contas

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

Repare que o &kappname; usa os menus de contexto de um modo geral em toda a aplicação. Se não conseguir perceber como tentar fazer algo, tente carregar com o botão direito do rato onde estaria à espera de uma dada funcionalidade.

Ao criar uma conta nova, com qualquer um dos métodos, abre o Assistente de Novas Contas. Este assistente irá conduzi-lo, passo-a-passo, pelo processo de criação de uma conta, recolhendo a informação necessária em cada passo. Para navegar pelas páginas, carregue nos botões Anterior e Seguinte.

Crie uma conta com qualquer um dos dois métodos mencionados anteriormente para continuar. Poderá encontrar uma descrição completa da criação de contas na secção de Contas.

Agora que uma ou mais contas já existem no &kappname;, o seu resumo de contas aparece na área inicial. Poderá criar transacções manualmente na área do Livro de Registos ou configurar as transacções automáticas com a área de Calendarização.

## Escalonamentos

Uma Calendarização ou evento recorrente é uma transacção que ocorre uma ou mais vezes, durante um dado período de tempo. Algumas vezes chamadas de transacções recorrentes, um exemplo típico é o cheque do seu salário, que recebe todos os meses ou semanas. Em vez de ter de introduzir os detalhes da transacção sempre que é pago, poderá dizer ao &kappname; para criar um evento recorrente que irá introduzir uma transacção para si, quando for pago.

Para fazer a manutenção das calendarizações, carregue no ícone Eventos Recorrentes no selector de áreas.

## Categorias

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

Poderá encontrar uma descrição completa sobre este tópico na secção de Categorias.

## Marcas

Para fazer a manutenção das marcas, carregue no ícone Marcas no selector de áreas.

Poderá encontrar uma descrição completa sobre este tópico na secção de Marcas.

## Beneficiários

Para manter a sua lista de beneficiários, carregue no ícone de Beneficiários no selector de áreas.

Poderá encontrar uma descrição completa sobre este tópico na secção de Beneficiários.

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

Se usar de momento uma aplicação de gestão financeira, o &kappname; poderá então importar as transacções de uma conta, desde que estejam no formato de intercâmbio do Quicken (QIF). A maioria dos programas financeiros poderá exportar este formato, e os diferentes métodos das aplicações para exportar em QIF não são aqui explicados, por razões de brevidade.

Poderá encontrar uma descrição completa sobre este tópico na secção de Importação do QIF.

## Procurar por transacções

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

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

Poderá encontrar uma descrição completa sobre este tópico na secção Procurar.

## Reconciliação

Em alguma altura, irá querer reconciliar as transacções que introduziu com as transacções que constam num extracto, seja este um extracto bancário, do cartão de crédito, do financiamento ou outro qualquer. A reconciliação envolve fazer a correspondência do que introduziu com o que o extracto apresenta. Se existirem discrepâncias, então você ou a pessoa que criou o extracto cometeram um erro.

Para reconciliar uma conta, seleccione-a primeiro, quer na área de Contas quer na área de Livros de Registos. Depois, tanto poderá carregar no ícone Reconciliar da barra de ferramentas como seleccionar a opção Reconciliar do menu Conta.

Poderá encontrar uma descrição completa sobre este tópico na secção de Reconciliação.

## Fazer cópias de segurança

Agora que criou algumas contas e introduziu as transacções, é uma boa ideia fazer uma cópia de segurança. Dado que o ficheiro usado pelo &kappname; é um ficheiro normal do Unix, poderá simplesmente copiar o ficheiro para outra localização, de modo a fazer uma cópia de segurança, ou usar a janela oferecida pelo &kappname;. A utilização da janela é o método preferido, porque mesmo se o &kappname; começar a usar outros formatos de ficheiros, como o SQL, seria então muito mais complicado de copiar o ficheiro manualmente.

Para fazer uma cópia de segurança pelo &kappname;: Seleccione a Cópia de Segurança no menu Ficheiro e introduza a pasta para onde deseja copiar o ficheiro. Se a pasta necessitar de 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 carregue em OK.

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

## Invocar o &kappname;

Geralmente, irá lançar o &kappname; a partir de um ícone ou do menu inicial do seu gestor de janelas. Nesse caso, o comportamento por omissão do &kappname; é abrir o último ficheiro aberto por si. Contudo, em algumas circunstâncias, irá querer ou precisar de invocar o &kappname; a partir da linha de comandos.

Para uma descrição completa de todas as opções da linha de comandos, 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 ficheiro aberto na ocasião anterior. Isto pode ser útil se o programa estoirar no arranque.

## `kmymoney <localização do ficheiro>`

A indicação ao &kappname; de um nome de ficheiro na linha de comandos diz a ele para abrir esse ficheiro, em vez de abrir o último ficheiro aberto. Poderá usar o nome de qualquer ficheiro válido do &kappname;, tal como está descrito no capítulo de formatos de ficheiros. Para além disso, poderá ser usado para importar um ficheiro do GnuCash.

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

### Mover os seus dados

Se tiver recebido um computador novo, é bastante simples mover os seus dados. De facto, tudo o que terá de fazer é copiar o seu ficheiro de dados do &kappname;. O nome do ficheiro aparece na barra de título quando o &kappname; está em execução, terminando normalmente em '.kmy'. Da primeira vez que executar a aplicação no novo computador, terá de lhe indicar onde é que colocou o ficheiro de dados, quer através da linha de comandos quer através da opção do menu Ficheiro Abrir.... Até deverá conseguir mudar entre sistemas &Windows;, &MacOS; e &Linux;.

Se tiver cifrado ou encriptado o seu ficheiro de dados, certifique-se que as aplicações e as chaves apropriadas também foram configuradas no novo computador.

Se os seus dados estiverem numa base de dados SQL, consulte a documentação da sua base de dados para saber como migrar os seus dados.

Lembre-se que isto assume que instalou a mesma versão do &kappname; no computador novo que se encontrava no antigo. A instalação de uma versão mais recente também deverá ser segura, mas terá de ter atenção a quaisquer questões relacionadas com essa actualização. Todas essas questões deverão ser referenciadas nas notas de lançamento da nova versão.

### Mover a sua configuração

Se só mover o seu ficheiro de dados para a nova máquina, como foi descrito na secção anterior, o &kappname; irá funcionar correctamente, mas terá perdido todas as definições que tenha alterado no seu computador antigo. Para manter essas definições, também terá de copiar o seu ficheiro de configuração. Esse ficheiro chama-se kmymoneyrc. Este ficheiro irá estar numa pasta com outros ficheiros de configuração das aplicações do &kde;. Num sistema &Linux;, esta será a $KDEHOME/share/config, onde a $KDEHOME normalmente é a .kde4 dentro da sua pasta pessoal.

#### Mover a configuração do 'plugin'

Se tiver executado alguns 'plugins' do &kappname;, como a importação ou exportação de CSV, também poderá ter criado um ficheiro de configuração na mesma pasta, como por exemplo 'csvimporterrc' ou 'csvexporterrc'. Estes deverão também ser copiados para o novo computador.

Assim como no ficheiro de dados principal, isto assume a mesma versão do 'plugin' em ambos os computadores. As actualizações normalmente são seguras, mas se a funcionalidade do 'plugin' tiver mudado em grande medida, aconselha-se que teste com cuidado o ficheiro de configuração antigo, para se certificar que o 'plugin' se comporta como será de esperar.

Estas instruções servem apenas para mover os seus dados e configurações do &kappname;. Contudo, poderão existir itens importantes que são guardados 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ão além do âmbito deste manual, ainda que boa parte dos ficheiros de configuração relevantes também são guardados sob a pasta $KDEHOME.

## Contactar os Programadores / Comunicar Erros

### Contactar os programadores

Para questões ou comentários gerais sobre o &kappname;, existe uma lista de correio para utilizadores em &userlist;. Para além disso, poderá contactar os programadores através da sua lista de correio em &devlist;.

Ficamos ansiosos por ouvir as suas experiências com a utilização do &kappname;.

### Comunicar erros

Para comunicar um erro, use a interface oferecida pelo &kappname; em Ajuda Comunicar um Erro e preencha a informação necessária. Contudo, no caso de ter algumas dificuldades com esse método, poderá comunicar um erro (ou enviar um pedido de funcionalidade ou melhoria) directamente na página Web de relatórios de erros do &kde;. Os relatórios deverão ser enviados para o produto kmymoney4. O kmymoney2 corresponde de forma específica às versões 1.0.x da aplicação, sendo que essas versões já não são mais suportadas, pelo que está fechado a novos relatórios de erros.

Em qualquer dos casos, antes de comunicar um erro, leia por favor as instruções abaixo. Se as seguir, será mais provável que os programadores consigam identificar rapidamente o problema, sem que tenham de lhe pedir mais informações.

#### Criar Relatórios de Erros de Qualidade

Encorajamos os utilizadores a ocuparem algum tempo extra a escrever relatórios de erros de qualidade, quando os enviarem. Isto reduz o esforço dispensado por ambas as partes, dado que o utilizador 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, ficará bem servido com estas recomendações:

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

O menu Ajuda Comunicar um Erro irá preencher isto automaticamente mas, se preferir não usar esta interface, existem diversos itens que terá de incluir no relatório. Teremos de saber qual o sistema operativo que está a usar (&Linux;, &MacOS; ou &Windows;), a versão do &kde; e do &kappname; que você está a correr, o nome e a versão da sua distribuição de &Linux;, bem como a versão do seu 'kernel'.

#### Incluir um registo de chamadas nos estoiros

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

#### Tentar reproduzi-lo

Deixe-nos saber se é capaz de o fazer. É ú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 noutras.

#### Incluir passos específicos

Este é um mau relatório de erros: Eu inseri uma transacção, e o &kappname; estoirou. Um relatório de erros muito melhor é: Ao usar o formulário da transacção, introduzi uma nova transacção na minha conta de Cartão de Crédito. Seleccionei a página de Transferências, introduzi 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; estoirou. Este erro pode ser completamente reproduzido por mim.

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

Nos estoiros, isso é óbvio, mas em alguns erros mais subtis, 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 à espera que tivesse acontecido.

#### Pense em executá-lo com a depuração activa

Ao compilar uma versão com a opção '--enable-debug=full', poderá garantir que serão gerados os melhores registos de chamadas. Se encontrar um estoiro, execute o &kappname; de novo dentro do 'gdb' e reproduza o estoiro. Quando estoirar, escreva bt para gerar um registo de chamadas.

Executar a aplicação desta forma é um pouco mais complicado, por isso não se espera que todos os utilizadores façam isto. Contudo, se 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 correcção.