<?xml version="1.0" encoding="UTF-8"?>
<chapter id="details.budgets">
<chapterinfo>
  <authorgroup>
    <author
>&Colin.Wright; &Colin.Wright.mail; </author>
    <author
>&Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author>
  </authorgroup>
  <date
>2011-06-29</date>
  <releaseinfo
>4.6</releaseinfo>
</chapterinfo>

<title
>Budgets</title>

<sect1 id="details.budgets.define">
<title
>Qu'est ce qu'un budget ? </title>

<para
>Un budget est une liste, classée en catégories, de dépenses et de revenus prévus pour une période définie. </para>

<para
>La fonction Budget de &kappname; vous permet de créer des budgets annuels. On peut créer plus d'un seul budget dans une même année. Vous répartissez des valeurs budgétaires mensuelles selon les catégories de dépenses et de revenus que vous avez préalablement définies. Les valeurs budgétaires peuvent être définies de trois façons différentes en fonction de la période :  </para>

<variablelist>
  <varlistentry>
    <term
>Mensuel</term>
    <listitem
><para
>(Choix par défaut ) spécifie une valeur unique utilisée chaque mois dans le budget.</para
></listitem>
  </varlistentry>

  <varlistentry>
    <term
>Annuel</term>
    <listitem
><para
>spécifie une valeur unique à répartir également sur chacun des mois de l'année.</para
></listitem>
  </varlistentry>

  <varlistentry>
    <term
>Individuel</term>
    <listitem
><para
>spécifie des valeurs différentes pour chacun des mois.</para>
      <para
>Ceci est utilisé pour des dépenses et des revenus irréguliers le long de l'année.</para
></listitem>
  </varlistentry>
</variablelist>

<para
>&kappname; provides a number of reports which compare actual income and expenses against the entered Budgets. These are described in more detail in <link linkend="budget.details.reports"
>another section</link
>. </para>
</sect1>

<sect1 id="details.budgets.create">
<title
>Vos budgets</title>

<para
>Vous pouvez accéder aux budgets en cliquant sur l'icône appropriée du sélecteur de vues à gauche de la fenêtre de &kappname; </para>

<para
>There are two major sections to the budget window. These are described in more detail below. On the left, the main section displays the list of budgets you have created. Above that are buttons for creating, renaming, and deleting budgets. On the right, there are three sections. At the top is the Accounts List. At the bottom is a display of the amounts assigned to the budget for the category selected in the Accounts List above. Between those two areas are some additional controls for managing the budget. </para>

<sect2>
<title
>Viewing, creating, renaming, and deleting budgets</title>

<para
>This section of the Budgets window displays the list of Budgets contained in the current &kappname; file. If no Budget has yet been created the list will be empty. The list of Budgets has two columns: </para>

<variablelist>
  <varlistentry>
    <term
>Nom</term>
    <listitem>
      <para
>Nom du budget</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
>Année</term>
    <listitem>
      <para
>Fiscal year of the Budget. Note that the starting month and day of the fiscal year can be specified in the <link linkend="details.settings.general.global"
>Configure &kappname; dialog.</link
></para>
    </listitem>
  </varlistentry>
</variablelist>

<para
>Values from the selected Budget are displayed to the right. To select a different Budget you can click on the Budget in the list. Alternatively, when the list has focus, you can select a different Budget using the up and down keys. If you have made changes to a Budget and then select a different budget &kappname; will ask you whether you want to save or discard the changes. </para>

<para
>There are three buttons above the list of Budgets. </para>

<variablelist>
  <varlistentry>
    <term
>Nouveau</term>
    <listitem>
      <para
>Create a new, empty budget. The default name of a new budget is "Budget &lt;year&gt;" where &lt;year&gt; is the current fiscal year. </para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
>Renommer</term>
    <listitem>
      <para
>Renommer le budget sélectionné</para>

      <para
>You can also edit the name of a Budget by double-clicking on the name of a Budget in the list.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
>Supprimer</term>
    <listitem>
      <para
>Supprime le budget sélectionné</para>
    </listitem>
  </varlistentry>

<!--  buttons moved in the UI - they are now described below.  Will remove
      from here after this chapter has been reviewed.
  <varlistentry>
    <term
>Revert</term>
    <listitem>
      <para
>Reverts the selected Budget to its last stored state.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
>Save</term>
    <listitem>
      <para
>Accepts any unsaved changes to the selected Budget and
        stores them.</para>
    </listitem>
  </varlistentry>
 -->
</variablelist>

<para
>Des options complémentaires sont disponibles dans le menu contextuel appelé en cliquant avec le bouton de droite sur un budget. </para>

<variablelist>
  <varlistentry>
    <term
>Nouveau budget</term>
    <listitem>
      <para
>Create a new, empty Budget.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
>Renommer le budget</term>
    <listitem>
      <para
>Renomme le budget sélectionné</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
>Changer l'année du budget</term>
    <listitem>
      <para
>Displays a window with a list of years to select a different fiscal year for the budget.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
>Supprimer le budget</term>
    <listitem>
      <para
>Supprime le budget sélectionné. </para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
>Copier un budget</term>
    <listitem>
      <para
>Crée une copie du budget sélectionné. Le nouveau budget prend le nom « Copie de &lt;budget&gt; », où &lt;budget&gt; le nom du budget copié.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
>Budget based on forecast</term>
    <listitem>
      <para
>Fills in budget amounts based on data from &kappname;'s Forecast values. See the section on <link linkend="details.forecast.define"
>Forecasts</link
> for more information. </para>
    </listitem>
  </varlistentry>
</variablelist>
</sect2>

<sect2>
<title
>Liste des comptes</title>

<para
>The Accounts List displays the list of Income and Expense Categories. (Remember, within &kappname;, categories are treated as a special type of account.) As in other places in &kappname;, the list is organized in a tree structure. The list can be expanded or collapsed to show or hide Subcategories within a Category. The Accounts List has a number of columns: </para>

<variablelist>
  <varlistentry>
    <term
>Compte</term>
    <listitem>
      <para
>Account (Category) name</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
>Type</term>
    <listitem>
      <para
>Category Type (Income or Expense)</para>
    </listitem>
  </varlistentry>

<!-- these seem to have been removed from the display.  Remove from here
     once this is confirmed by the programmers.
  <varlistentry>
    <term
>Tax</term>
    <listitem>
      <para
>Checked if a Category included in Tax Reports</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
>VAT</term>
    <listitem>
      <para
>Checked if a Category marked as a VAT Category</para>
    </listitem>
  </varlistentry>
-->

  <varlistentry>
    <term
>Total Balance</term>
    <listitem>
      <para
>Current balance of Account. This will be blank for Categories, unless the Category is defined in a foreign currency. In this case, Total Balance will show the value for the Category in its defined currency.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
>Total Value</term>
    <listitem>
      <para
>Total yearly value in the Budget. If a Category has Subcategories and the Category's list of Subcategories is collapsed the value displayed is the sum of the values for the Category and all of its Subcategories. If a Category is defined in a foreign currency, the Total Value will show the value in the base currency.</para>
    </listitem>
  </varlistentry>
</variablelist>

<!-- It would be nice to include the actual button icons here to confirm
     which buttons are referred to.  -->
<para
>Below the Accounts List are several controls. The Update and Revert buttons are described further below. The collapse and expand buttons collapse or expand the entire Accounts List. </para>

<para
>The Accounts List can be filtered in two ways. Checking the "Hide unused categories" checkbox hides any Categories for which no value has been assigned to the Category or any of its Subcategories. To the right of this, is an unlabelled text box. Only categories which include whatever is typed in this box are listed, but their parent categories are also listed. </para>

<para
>Note that changing either the "Hide unused budget categories" or the filter value is likely to change the list of Categories display. You may need to re-expand the list to see all the Categories that should be displayed with the current settings. </para>

</sect2>

<sect2>
<title
>Affectation</title>

<para
>The Assignments area shows the values for the Category selected in the Accounts List. </para>

<variablelist>
  <varlistentry>
    <term
>Compte</term>
    <listitem>
      <para
>Displays the name of the selected Category. If the Category is a Subcategory, its full name is displayed in the Category:Subcategory format.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
>Total</term>
    <listitem>
      <para
>Displays the total yearly value assigned to the Category</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
>Inclure les sous-comptes</term>
    <listitem>
      <para
>If this is checked, then Reports show actual income or expenses in Subcategories belonging to the Category against the Category instead of the Subcategory.</para>

      <para
>If a Subcategory has a value defined in the Budget, then the income and expenses are shown against the Subcategory.</para>

      <para
>If the Category selected in the Accounts List has its Subcategories collapsed, although its Total Value will show the sum of the Total Values for all its Subcategories, the amounts in the Assignments area may still show 0, unless this box has been checked or an amount has explicitly been assigned to the Category.</para>

      <para
>In general, for you will either check this box and assign values to the Category and not to any of its Subcategories, or not check the box, and assign values to the Subcategories but not the Category. If any Subcategories have assigned amounts when this box is checked, then those amounts are rolled up to the Category.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
>Effacer</term>
    <listitem>
      <para
>The Clear button resets the budgeted category value or values to zero.</para>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
>Période</term>
    <listitem>
      <para
>Le bouton radio Période vous permet de choisir la période correspondant au montant.</para>

      <variablelist>
	<varlistentry>
	  <term
>Mensuel</term>
	  <listitem>
	    <para
>Une valeur unique est saisie, spécifiant le montant mensuel. Ceci est le réglage par défaut.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term
>Annuel</term>
	  <listitem>
	    <para
>Une valeur unique est saisie, spécifiant le montant annuel.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term
>Individuel</term>
	  <listitem>
	    <para
>Des valeurs sont données pour chacun des mois du calendrier. Ceci s'applique au cas où les revenus et les dépenses sont irréguliers le long de l'année.</para>
	  </listitem>
	</varlistentry>
      </variablelist>

      <para
>Si des valeurs sont déjà spécifiées et que la période est changée, &kappname; vous demandera si vous voulez utiliser le total annuel comme base de calcul des nouvelles valeurs. </para>
    </listitem>
  </varlistentry>
</variablelist>
</sect2>

<sect2>
<title
>Mettre à jour et rétablir</title>

<para
>For performance reasons, changes made to a Budget are not saved immediately. Instead, they must first be stored using the Update button and then permanently saved using the &kappname; Save. </para>

<para
>When a Budget's values are first modified, the Update and Revert buttons are enabled. Multiple changes can be made to the Budget. Pressing Update will store the changes and disable the Update and Revert buttons. </para>

<para
>&kappname; enregistre seulement les changements qui ont été enregistrés à l'aide du bouton de mise à jour dans la fenêtre des budgets. Ainsi, si vous avez modifié un budget mais que vous n'avez pas demandé la mise à jour, la fonction d'enregistrement de &kappname; ne prendra pas les changements en compte et les boutons de mise à jour et de rétablissement des valeurs de la fenêtre des budgets resteront activés.  </para>

<para
>Le bouton de retour aux valeurs dernièrement enregistrées par le bouton de mise à jour efface toutes les modifications faites depuis ce dernier enregistrement et désactive les deux boutons dans la fenêtre des budgets (bouton de mise à jour et bouton de retour). </para>

<para
>Les modifications apportées enregistrées à partir du bouton d'enregistrement de la fenêtre des budgets et qui n'ont pas encore été enregistrées par la fonction d'enregistrement de &kappname; ne peuvent être annulées qu'en rechargeant le fichier &kappname;. </para>
</sect2>
</sect1>

<sect1 id="budget.details.reports">
<title
>Rapports budgétaires</title>

<para
>&kappname; provides a number of reports to compare actual income and expenses against a Budget. These are listed in Reports under "Budgeting". There are two types of Budget Reports: </para>

<variablelist>
  <varlistentry>
    <term
>Budget seulement</term>
    <listitem
><para
>These reports display values from a Budget.</para>
      <variablelist>
        <varlistentry>
          <term
>Monthly Budget</term
> 
          <listitem
><para
>Displays the monthly values from a Budget.</para>
          </listitem
></varlistentry>
        <varlistentry>
          <term
>Yearly Budget</term
> 
          <listitem
><para
>Displays the monthly values from a Budget, with yearly total.</para>
          </listitem
></varlistentry>
      </variablelist>
    </listitem>
  </varlistentry>

  <varlistentry>
    <term
>Budget vs. Actual</term>
    <listitem
><para
>These reports compare values from a Budget to actual income and expenses. In each budget report you can find the columns Budget, Actual, and Difference. Each report differs in the period that is shown.</para>
      <variablelist>
      <varlistentry>
      <term
>Budget vs. Actual This Year</term
> 
      <listitem
><para
>Depuis le début de l'année en cours jusqu'à la date courante</para>
      </listitem
></varlistentry>
      <varlistentry>
      <term
>Budget vs. Actual This Year (YTM)</term
> 
      <listitem
><para
>Depuis le début de l'année en cours jusqu'à le fin du mois précédant le mois en cours</para>
      </listitem
></varlistentry>
      <varlistentry>
      <term
>Monthly Budgeted vs. Actual</term
> 
      <listitem
><para
>Présente la comparaison « réel - budgétisé » du mois en cours.</para>
      </listitem
></varlistentry>
      <varlistentry>
      <term
>Yearly Budgeted vs. Actual</term
> 
      <listitem
><para
>Du 1 janvier au 31 décembre</para>
      </listitem
></varlistentry>
      <varlistentry>
      <term
>Yearly Budgeted vs. Actual (Graph)</term
> 
      <listitem
><para
>Affiche le graphe comparatif entre le réel et le budgétisé pour tous les mois de l'année.</para>
      </listitem
></varlistentry>
      </variablelist>

      <para
>Ces rapports constituent une base à partir de laquelle des rapports personnalisés peuvent être créés en changeant, la période couverte et le budget, parmi d'autres options. </para>
    </listitem>
  </varlistentry>
</variablelist>
</sect1>
</chapter>