r19948 - gnucash-docs/trunk/guide/C - Related to bug#635357 Remove QIF assistant description and move New Account Hierarchy setup description.
Cristian Marchi
cmarchi at code.gnucash.org
Thu Dec 16 14:49:34 EST 2010
Author: cmarchi
Date: 2010-12-16 14:49:34 -0500 (Thu, 16 Dec 2010)
New Revision: 19948
Trac: http://svn.gnucash.org/trac/changeset/19948
Modified:
gnucash-docs/trunk/guide/C/ch_basics.xml
Log:
Related to bug#635357 Remove QIF assistant description and move New Account Hierarchy setup description.
Modified: gnucash-docs/trunk/guide/C/ch_basics.xml
===================================================================
--- gnucash-docs/trunk/guide/C/ch_basics.xml 2010-12-16 19:45:13 UTC (rev 19947)
+++ gnucash-docs/trunk/guide/C/ch_basics.xml 2010-12-16 19:49:34 UTC (rev 19948)
@@ -275,136 +275,6 @@
Let’s take a look at some of the common screens and screen boxes you will
see.</para>
- <sect2 id="basics-setup2">
- <title>Create a new set of accounts</title>
-
- <para>The <interface>New Account Hierarchy Setup</interface> assistant allows
- you to create several accounts at once. When you open <application>&app;</application> the first
- time, you will get this screen:</para>
-
- <screenshot id="basics-NewAccountHierarchySetup">
- <mediaobject>
- <imageobject>
- <imagedata fileref="figures/basics_NewAccountHierarchySetup.png"
- format="PNG" srccredit="Bengt Thuree" ></imagedata>
- </imageobject>
-
- <textobject>
- <phrase>The New Account Hierarchy Setup assistant</phrase>
- </textobject>
-
- <caption>
- <para>This image shows the first screen of the <interface>New
- Account Hierarchy Setup</interface> assistant.</para>
- </caption>
- </mediaobject>
- </screenshot>
-
- <para>Click <guibutton>Forward</guibutton> and follow the instructions
- provided in the screen. The screen provides a default set of accounts
- with predefined account types, and you simply select the accounts you
- want. For more information on account types, see
- <xref linkend="accts-types1"></xref>.</para>
-
- <screenshot id="basics-NewAccountHierarchySetup-currency">
- <mediaobject>
- <imageobject>
- <imagedata fileref="figures/basics_NewAccountHierarchySetup_currency.png"
- format="PNG" srccredit="Bengt Thuree" ></imagedata>
- </imageobject>
-
- <textobject>
- <phrase>The New Account Hierarchy Setup assistant - Currency</phrase>
- </textobject>
-
- <caption>
- <para>This image shows the second screen of the <interface>New
- Account Hierarchy Setup</interface> assistant where you select the
- currency.</para>
- </caption>
- </mediaobject>
- </screenshot>
-
- <para>The currency you select here, will be assigned to all the
- <guilabel>accounts</guilabel> created in this assistant.</para>
-
- <screenshot id="basics-NewAccountHierarchySetup-Accounts">
- <mediaobject>
- <imageobject>
- <imagedata fileref="figures/basics_NewAccountHierarchySetup_Accounts.png"
- format="PNG" srccredit="Bengt Thuree" ></imagedata>
- </imageobject>
-
- <textobject>
- <phrase>The New Account Hierarchy Setup assistant - Choose
- accounts</phrase>
- </textobject>
-
- <caption>
- <para>This image shows the third screen of the <interface>New
- Account Hierarchy Setup</interface> assistant where you choose the
- various accounts.</para>
- </caption>
- </mediaobject>
- </screenshot>
-
- <para>Select one or more of the predefined account-groups here. For more
- information on account types, see
- <xref linkend="accts-types1"></xref>.</para>
-
- <screenshot id="basics-NewAccountHierarchySetup-Setup.png">
- <mediaobject>
- <imageobject>
- <imagedata fileref="figures/basics_NewAccountHierarchySetup_Setup.png"
- format="PNG" srccredit="Bengt Thuree" ></imagedata>
- </imageobject>
-
- <textobject>
- <phrase>The New Account Hierarchy Setup assistant - Configure</phrase>
- </textobject>
-
- <caption>
- <para>This image shows the fourth screen of the <interface>New
- Account Hierarchy Setup</interface> assistant where you can set
- <guilabel>Opening Balance</guilabel>.</para>
- </caption>
- </mediaobject>
- </screenshot>
-
- <para>In this screen you will be able to set an <guilabel>Opening
- Balance</guilabel> on each of the accounts, as well as indicate if
- the account should be a <guilabel>Placeholder</guilabel> (only
- sub-accounts allowed, no transactions. Like Current Assets in above
- image).</para>
-
- <screenshot id="basics-NewAccountHierarchySetup-Finish">
- <mediaobject>
- <imageobject>
- <imagedata fileref="figures/basics_NewAccountHierarchySetup_Finish.png"
- format="PNG" srccredit="Bengt Thuree" ></imagedata>
- </imageobject>
-
- <textobject>
- <phrase>The New Account Hierarchy Setup assistant - Finish</phrase>
- </textobject>
-
- <caption>
- <para>This image shows the last screen of the <interface>New
- Account Hierarchy Setup</interface> assistant.</para>
- </caption>
- </mediaobject>
- </screenshot>
-
- <para>Click <guibutton>Apply</guibutton> to create all the accounts and
- leave the assistant.</para>
-
- <para>If you intend to import your data from another program and you
- want to keep the same account names you used in that program, you may
- want to delay setting up default accounts at this time. You can simply
- import the data and the account names into <application>&app;</application> from the other
- program (<xref linkend="basics-import1"></xref> explains how to do this).</para>
- </sect2>
-
<sect2 id="basics-tip2">
<title>Tip of the Day</title>
@@ -779,127 +649,6 @@
</note>
</sect1>
- <sect1 id="basics-import1">
- <title>Importing QIF Files</title>
-
- <note>
- <para>This section tells you how to initially import data from other
- financial programs that use QIF (<trademark
- class="registered">Quicken</trademark> Interchange Format).
-<!--
- Section 11.5
- addresses importing QIF data from online bank statements.
--->
- </para>
- </note>
-
- <para>To import data from <trademark
- class="registered">Quicken</trademark>, MS Money, or other programs that
- use QIF(<trademark class="registered">Quicken</trademark> Interchange
- Format), you must first export your data to a QIF file. One way to do this
- is to export each account as a separate QIF file. An easier way, available
- in <trademark class="registered">Quicken</trademark> 98 and beyond, is to
- export all accounts at once into a single QIF file. Check your program’s
- manual to determine if this option is available.</para>
-
- <para>Once your data is in QIF form, follow the easy 3-step import process
- described below. Before you get started, though, please note that part of
- the import process involves checking for duplicate transactions, so it is
- very important that you load <emphasis>all</emphasis> of your QIF files
- before importing. Duplicate transactions result when more than one account
- is involved. For example, if one of your transactions transferred money
- from savings to checking, you would end up with this same transaction
- recorded twice - once in the savings account and once in the checking
- account.</para>
-
- <para>To import QIF files:</para>
-
- <orderedlist>
- <listitem>
- <para>Load all of the QIF files containing data you wish to
- import.</para>
-
- <para>To do this, select <menuchoice><guimenu>File</guimenu>
- <guisubmenu>Import</guisubmenu><guimenuitem>Import
- QIF...</guimenuitem></menuchoice> from the menu. When the <interface>QIF
- Import</interface> screen box appears, click
- <guibutton>Forward</guibutton> and follow the instructions to guide you
- through the process of loading your files.</para>
-
- <screenshot id="basics-QIF-Import-welcome">
- <mediaobject>
- <imageobject>
- <imagedata fileref="figures/basics_QIF_Import_welcome.png"
- format="PNG" srccredit="Bengt Thuree" ></imagedata>
- </imageobject>
-
- <textobject>
- <phrase>The QIF Import assistant</phrase>
- </textobject>
-
- <caption>
- <para>This image shows the start of the <interface>QIF
- Import</interface> assistant.</para>
- </caption>
- </mediaobject>
- </screenshot>
-
- <para>You will be prompted for a filename to load. Use the
- <guibutton>Select</guibutton> button to select your QIF file and click
- <guibutton>Forward</guibutton> to load it. Once the file is loaded,
- select <guibutton>Load another file</guibutton> if you have more files
- to load. When you have loaded all your QIF files, click
- <guibutton>Forward</guibutton> to continue with the import
- process.</para>
- </listitem>
-
- <listitem>
- <para>Review the <application>&app;</application> accounts to be created.</para>
-
- <para>The importer then matches up your QIF accounts and categories
- with <application>&app;</application> accounts and gives you a brief description of the
- matching process. Clicking <guibutton>Forward</guibutton> will bring you
- to a view comparing your QIF accounts with the corresponding <application>&app;</application>
- accounts created. To change an account name, select the row containing
- that account name and edit the name in the screen box provided. Click
- <guibutton>Forward</guibutton> when you have finished making changes, and
- proceed through a similar category matching process. QIF income and
- expense categories import as <application>&app;</application> income and expense accounts (see
- <xref linkend="accts-concepts1"></xref> for more on this).
- Make changes to these account names if
- necessary, and click <guibutton>Forward</guibutton> to continue.</para>
-
- <note>
- <para>If you are not sure what changes are needed, it is safe to
- accept the <application>&app;</application> account names. It is easy to edit the accounts
- later if you find you need to make a change.</para>
- </note>
-
- <para>From the drop-down list, select a standard currency to be used
- for imported accounts and click <guibutton>Forward</guibutton> to
- continue. If you have stocks, mutual funds, or other securities, you
- will be prompted for additional information. The importer screen will
- ask for the exchange or listing (e.g. NASDAQ), the security’s full
- name, and the ticker symbol. If you do not have this information
- handy, you can edit the account information later, once the import is
- complete. Click <guibutton>Forward</guibutton> to continue.</para>
- </listitem>
-
- <listitem>
- <para>Tell <application>&app;</application> to import the data.</para>
-
- <para>The last step of the import. Once you have verified your account
- names and investment information, click <guibutton>Finish</guibutton>
- in the <guilabel>Update your &app; accounts</guilabel> page to
- complete the import process. Depending upon the size of your file, the
- import might take a few minutes to complete, so a progress bar
- displays the percentage finished. When the import process is complete,
- <application>&app;</application> will return you to the main window, which should now display
- the names of the accounts you have imported.</para>
- </listitem>
- </orderedlist>
- </sect1>
-
<sect1 id="basics-backup1">
<title>Backing Up and Recovering Data</title>
@@ -1057,138 +806,174 @@
<orderedlist>
<listitem>
<para>First, let’s create a file to store your real data. Open <application>&app;</application>
- and go through the <interface>New Account Hierarchy Setup</interface>
- screen. You will create a file and accounts to be used for your home
- finances, so choose the accounts that pertain to you. If you are not
- sure what accounts you will need, click the <guibutton>Select
- All</guibutton> option to create all of the accounts provided. When
- you have completed the setup, save this file with a filename you want
- to use for your home data.</para>
- </listitem>
+ and select <menuchoice><guimenu>File</guimenu><guimenuitem>New File</guimenuitem></menuchoice>
+ from the menubar. This will start the <guilabel>New Account Hierarchy Setup</guilabel> assistant that allows
+ you to create several accounts at once.</para>
+ <note>
+ <para>If you are running <application>&app;</application> for the first time, you will be presented with the
+ <guilabel>Cannot find default values</guilabel> screen which is described in details in the
+ <application>&app;</application> manual.</para>
+ </note>
- <listitem>
- <para>Next, create a file to store test data. This is the file that
- will be used in the tutorials throughout this manual. Click
- <menuchoice><guimenu>File</guimenu> <guimenuitem>New File</guimenuitem></menuchoice> to create
- a new file, and name it <filename>gcashdata_1</filename>. Your main
- window should now look something like this:</para>
+ <screenshot id="basics-NewAccountHierarchySetup">
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/basics_NewAccountHierarchySetup.png"
+ format="PNG" srccredit="Bengt Thuree" ></imagedata>
+ </imageobject>
- <figure pgwide="1">
- <title>A new Account Tree window </title>
- <screenshot id="basics-EmptyAccounts">
- <mediaobject>
- <imageobject>
- <imagedata fileref="figures/basics_EmptyAccounts.png"
- format="PNG" srccredit="Bengt Thuree" ></imagedata>
- </imageobject>
+ <textobject>
+ <phrase>The New Account Hierarchy Setup assistant</phrase>
+ </textobject>
- <textobject>
- <phrase>The Main windows showing the test file</phrase>
- </textobject>
- </mediaobject>
- </screenshot>
- </figure>
+ <caption>
+ <para>This image shows the first screen of the <interface>New
+ Account Hierarchy Setup</interface> assistant.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+
+ <para>The first screen of the assistant gives you a description of what the assistant does.
+ Click the <guibutton>Forward</guibutton> button to proceed to the next screen.</para>
+ </listitem>
- <para>This image shows the Account Tree window with a set of
- accounts loaded from the assistant.</para>
- </listitem>
+ <listitem>
+ <para>In the second screen, select the currency to use for the new accounts from the dropdown list.
+ Then press the <guibutton>Forward</guibutton> button.</para>
+ <note>
+ <para>The currency you select here, will be assigned to all the
+ <guilabel>accounts</guilabel> created in this assistant.</para>
+ </note>
+
+ <screenshot id="basics-NewAccountHierarchySetup-currency">
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/basics_NewAccountHierarchySetup_currency.png"
+ format="PNG" srccredit="Bengt Thuree" ></imagedata>
+ </imageobject>
- <listitem>
- <para>Now, adjust some preferences in the account tree window. Select
- <menuchoice><guimenu>Edit</guimenu> <guimenuitem>Preferences</guimenuitem>
- <guimenuitem>Windows</guimenuitem></menuchoice> and change the toolbar Style
- so that they display only text, not icons. The change will take place
- immediately, so look at the Toolbar buttons in the main window. Return
- to the <interface>Preferences</interface> screen and change the Toolbar
- buttons back to the default setting by clicking <guibutton>Use system
- default</guibutton>. From the column header row, select
- <guibutton>Arrow down</guibutton> and select <quote>Type</quote>
- (which means view column "Type"). The main window should now look like
- this:</para>
+ <textobject>
+ <phrase>The New Account Hierarchy Setup assistant - Currency</phrase>
+ </textobject>
- <figure pgwide="1">
- <title>The Main window with changed display options</title>
- <screenshot id="basics-EmptyAccounts2">
- <mediaobject>
- <imageobject>
- <imagedata fileref="figures/basics_EmptyAccounts2.png"
- format="PNG" srccredit="Bengt Thuree" ></imagedata>
- </imageobject>
+ <caption>
+ <para>This image shows the second screen of the <interface>New
+ Account Hierarchy Setup</interface> assistant where you select the
+ currency.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </listitem>
- <textobject>
- <phrase>The effect of changing the display options</phrase>
- </textobject>
- </mediaobject>
- </screenshot>
- </figure>
+ <listitem>
+ <para>In the third screen select the <guilabel>Common Accounts</guilabel> group in the
+ <guilabel>Categories</guilabel> pane. Then press the <guibutton>Forward</guibutton> button to
+ proceed.</para>
+ <note>
+ <para>If you want, you can select one or more of the predefined account-groups here. For more
+ information on account types, see <xref linkend="accts-types1"></xref>.</para>
+ </note>
- <para>Save your file.</para>
- </listitem>
+ <screenshot id="basics-NewAccountHierarchySetup-Accounts">
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/basics_NewAccountHierarchySetup_Accounts.png"
+ format="PNG" srccredit="Bengt Thuree" ></imagedata>
+ </imageobject>
- <listitem>
- <para>If you plan to import QIF data from another program, let’s try a
- practice file first. (If not, skip to <xref linkend="chapter_accts"/>.)</para>
+ <textobject>
+ <phrase>The New Account Hierarchy Setup assistant - Choose
+ accounts</phrase>
+ </textobject>
- <orderedlist>
- <listitem>
- <para>First, create a new file called
- <filename>gcashimport</filename>. It is up to you if you would
- like to specify accounts (like Common Accounts) directly or not.
- If the QIF importer does not find an account, it will create it
- automatically (or allow you to create it manually)</para>
- </listitem>
+ <caption>
+ <para>This image shows the third screen of the <interface>New
+ Account Hierarchy Setup</interface> assistant where you choose the
+ various accounts.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </listitem>
- <listitem>
- <para>From the main menu, select <menuchoice><guimenu>File</guimenu>
- <guisubmenu>Import</guisubmenu><guimenuitem>Import
- QIF...</guimenuitem></menuchoice> to start the import.</para>
- </listitem>
+ <listitem>
+ <para>In the fourth screen you will be able to set an <guilabel>Opening
+ Balance</guilabel> on each of the accounts, as well as indicate if
+ the account should be a <guilabel>Placeholder</guilabel>. As these features will be
+ described in next chapters, leave all as configured by <application>&app;</application>
+ and click <guibutton>Forward</guibutton> to open the last screen of the assistant.</para>
+
+ <screenshot id="basics-NewAccountHierarchySetup-Setup.png">
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/basics_NewAccountHierarchySetup_Setup.png"
+ format="PNG" srccredit="Bengt Thuree" ></imagedata>
+ </imageobject>
- <listitem>
- <para>Select the appropriate currency</para>
- </listitem>
+ <textobject>
+ <phrase>The New Account Hierarchy Setup assistant - Configure</phrase>
+ </textobject>
- <listitem>
- <para>Select <filename>gnc_Sample_QIF.qif</filename> as QIF file
- to load.</para>
- </listitem>
+ <caption>
+ <para>This image shows the fourth screen of the <interface>New
+ Account Hierarchy Setup</interface> assistant where you can set
+ <guilabel>Opening Balance</guilabel>.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </listitem>
- <listitem>
- <para>In the following screens, ensure that each transaction has a
- valid account, if in doubt, just use the default ones.</para>
- </listitem>
+ <listitem>
+ <para>In the last screen of the assistant, click <guibutton>Apply</guibutton> to create all the accounts and
+ leave the assistant.</para>
- <listitem>
- <para>Complete the import.</para>
- </listitem>
- </orderedlist>
+ <screenshot id="basics-NewAccountHierarchySetup-Finish">
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/basics_NewAccountHierarchySetup_Finish.png"
+ format="PNG" srccredit="Bengt Thuree" ></imagedata>
+ </imageobject>
- <para>The main window should now look like this:</para>
+ <textobject>
+ <phrase>The New Account Hierarchy Setup assistant - Finish</phrase>
+ </textobject>
+ <caption>
+ <para>This image shows the last screen of the <interface>New
+ Account Hierarchy Setup</interface> assistant.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </listitem>
+
+ <listitem>
+ <para>Your main window should now look something like this:</para>
+
<figure pgwide="1">
- <title>The Main window after QIF import</title>
- <screenshot id="basics-AccountsSampleQIF">
+ <title>A new Account Tree window </title>
+ <screenshot id="basics-EmptyAccounts">
<mediaobject>
<imageobject>
- <imagedata fileref="figures/basics_AccountsSampleQIF.png"
+ <imagedata fileref="figures/basics_EmptyAccounts.png"
format="PNG" srccredit="Bengt Thuree" ></imagedata>
</imageobject>
<textobject>
- <phrase>After importing the provided sample QIF file</phrase>
+ <phrase>The Main windows showing the test file</phrase>
</textobject>
</mediaobject>
</screenshot>
</figure>
-
- <note>
- <para>If after the import the screen is blank, go to <menuchoice><guimenu>View</guimenu>
- <guimenuitem>New Accounts Page</guimenuitem></menuchoice>
- to display a new Accounts tab.</para>
- </note>
- <para>Save your file.</para>
-
- </listitem>
- </orderedlist>
+
+ <para>Next, create a file to store test data. This is the file that
+ will be used in the tutorials throughout this manual. Click
+ <menuchoice><guimenu>File</guimenu><guimenuitem>Save As...</guimenuitem></menuchoice> (or press
+ <keycombo><keycap>Shift</keycap><keycap>Ctrl</keycap><keycap>S</keycap></keycombo> on your keyboard)
+ to open the <guilabel>Save As...</guilabel> dialog. Select <emphasis>xml</emphasis> as data
+ format, name the file <filename>gcashdata_1</filename> and select the folder where
+ the file will be saved.</para>
+ </listitem>
+
+ </orderedlist>
+
</sect1>
</chapter>
More information about the gnucash-changes
mailing list