<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE appendix SYSTEM "gnc-locale-pt.dtd">
<!-- (Do not remove this comment block.)
  Version: 2.0.0
  Last modified: July 9th 2006
  Maintainers:
    Chris Lyttle <chris@wilddev.net>
  Author:
    Jon Lapham <lapham@extracta.com.br>
  Originally designed by Carol Champagne.
  Translators:
    (translators put your name and email here)
-->
<appendix id="appendixa">
  <title>Guia de migração</title>

  <para>Este apêndice serve para ajudar utilizadores de outros programas de gestão financeira na sua
    migração para o &app;. Abordamos as diferenças conceptuais entre a disposição das contas do
    &app; versus outros programas.
  </para>

  <sect1 id="appendixa_accts_vs_cats1">
    <title>Contas vs. Categorias</title>

    <para>Se está familiarizado com outros programas de finanças pessoais, já está habituado a controlar
      as suas receitas e despesas como categorias. Dado que o &app; é um sistema de dupla entrada
      (veja a secção <xref linkend="basics-accounting1"/>
<!--2.1-->
      ), as receitas e despesas são controladas em contas. O conceito básico é o mesmo, mas a
      estrutura de contas permite maior consistência com práticas empresariais comuns. Assim, se
      é um utilizador empresarial assim como privado, o &app; torna fácil o controlo dos seus
      negócios e das sua contas privadas.
    </para>

    <para>Contas de receita e despesa dão-lhe a mesma informação que obteria com categorias, mas também
      lhe dão mais flexibilidade na introdução de transacções. No &app;, tem a opção de
      inserir transacções directamente nas contas de receita e despesa através dos seus próprios
      diários. Outros programas que usam categorias, não oferecem esta opção, porque não
      existem <quote>diários de conta</quote> para uma categoria.
    </para>

    <para>No &app; tem também a opção de tratar contas de receita e despesa tal como trataria as
      categorias, se se sentir mais confortável com esse método. No
      <trademark class="registered">Quicken</trademark> e programas semelhantes, as transacções
      requerem uma conta e uma categoria. No &app;, use um nome de conta de receita ou despesa onde
      normalmente usaria uma categoria noutros programas e o resultado deve ser o mesmo. Discute-se
      a introdução de transacções com maior detalhe no capítulo <xref linkend="chapter_txns"/>
<!--capítulo 4-->
      .
    </para>
  </sect1>

  <sect1 id="appendixa_qif1">
    <title>Organização de ficheiros <acronym>QIF</acronym> (em discussão)</title>

    <para></para>
  </sect1>

  <sect1 id="appendixa_entercharge1">
    <title>Problemas comuns de duplicação (em discussão)</title>

    <para></para>
  </sect1>

  <sect1 id="appendixa_enterpay1">
    <title>Verificar dados <acronym>QIF</acronym> (em discussão)</title>

    <para></para>
  </sect1>

  <sect1 id="appendixa_xmlconvert1">
    <title>Converter ficheiro <acronym>XML</acronym> do &app;</title>

    <para>O ficheiro de dados <acronym>XML</acronym> do &app; pode ser transformado em praticamente qualquer
      formato (por exemplo, <acronym>QIF</acronym>, <acronym>CSV</acronym>...) com bastante
      facilidade se se estiver familiarizado com <acronym>XSLT</acronym>. O ficheiro de dados do
      &app; é um <acronym>XML</acronym> bem formado e pode ser lido por um processador
      <acronym>XSLT</acronym> com uma folha de estilos associada. Isto permite transformar o
      ficheiro em qualquer formato que possa ser desenhado, dispondo da folha de estilo apropriada.
    </para>

    <para>Têm de se seguir alguns passos. Escrever uma folha de estilos é tarefa para outra altura, mas se
      conseguir obter uma, eis o que tem de fazer:
    </para>

    <orderedlist>
      <listitem>
        <para>Copie o ficheiro <acronym>XML</acronym> do &app; para um ficheiro de trabalho.
        </para>

        <important>
          <para>Se o ficheiro foi modificado pela última vez com uma versão do &app; anterior à 2.0, antes de
            continuar para o próximo passo tem de modificar a etiqueta &lt;gnc-v2&gt; do ficheiro
            de trabalho para algo como isto:
<programlisting language="xml">
&lt;gnc-v2 xmlns:cd="http://www.gnucash.org/XML/cd"
  xmlns:book="http://www.gnucash.org/XML/book"
  xmlns:gnc="http://www.gnucash.org/XML/gnc"
  xmlns:cmdty="http://www.gnucash.org/XML/cmdty"
  xmlns:trn="http://www.gnucash.org/XML/trn"
  xmlns:split="http://www.gnucash.org/XML/split"
  xmlns:act="http://www.gnucash.org/XML/act"
  xmlns:price="http://www.gnucash.org/XML/price"
  xmlns:ts="http://www.gnucash.org/XML/ts"
  xmlns:slot="http://www.gnucash.org/XML/kvpslot"
  xmlns:cust="http://www.gnucash.org/XML/cust"
  xmlns:entry="http://www.gnucash.org/XML/entry"
  xmlns:lot="http://www.gnucash.org/XML/lot"
  xmlns:invoice="http://www.gnucash.org/XML/invoice"
  xmlns:owner="http://www.gnucash.org/XML/owner"
  xmlns:job="http://www.gnucash.org/XML/job"
  xmlns:billterm="http://www.gnucash.org/XML/billterm"
  xmlns:bt-days="http://www.gnucash.org/XML/bt-days"
  xmlns:sx="http://www.gnucash.org/XML/sx"
  xmlns:fs="http://www.gnucash.org/XML/fs"
  xmlns:addr="http://www.gnucash.org/XML/custaddr"&gt;
</programlisting>
          </para>
        </important>

        <note>
          <para>Pode pôr praticamente tudo o que quiser dentro dos sinais de igual, mas um <acronym>URL</acronym>
            é o que costuma ser usado.
          </para>
        </note>
      </listitem>

      <listitem>
        <para>Crie uma folha de estilo <acronym>XSLT</acronym> contendo a transformação desejada, ou obtenha uma
          já escrita (tanto quanto sabemos, não há nenhuma, mas estamos a trabalhar numa para
          <acronym>CSV</acronym>).
        </para>
      </listitem>

      <listitem>
        <para>Instale um processador <acronym>XSLT</acronym> tal como o
          <ulink url="http://saxon.sourceforge.net/">Saxon</ulink> ou o
          <ulink url="http://xml.apache.org/">Xalan-J</ulink>. Qualquer processador normalizado
          serve, realmente...
        </para>
      </listitem>

      <listitem>
        <para>Passe o ficheiro de trabalho e a folha de estilo pelo processador, seguindo as suas instruções
          específicas.
        </para>
      </listitem>

      <listitem>
        <para>Terá agora um ficheiro no formato de saída desejado. Uma pessoa empreendedora pode mesmo chegar a
          escrever uma folha de estilo para transformar o ficheiro de dados do &app; numa folha de
          cálculo do OpenOffice (ou vice-versa, já agora). Coisas como <acronym>QIF</acronym>
          deviam dar um bocadinho menos de trabalho.
        </para>
      </listitem>
    </orderedlist>

    <para>Os benefícios são não ter de escrever um módulo Scheme ou uma nova rotina em C para fazer esta
      transformação. Qualquer pessoa que saiba ou possa aprender <acronym>XML</acronym> e
      <acronym>XSLT</acronym> pode realizar esta tarefa. Não é muito mais difícil do que escrever
      uma página web...
    </para>

    <para>De qualquer forma, isto é só para deixar esta informação gravada em qualquer lado. O processo
      funciona em ficheiros de dados &vers-stable; e também deve funcionar em versões anteriores.
    </para>
  </sect1>
</appendix>
