# Utiliser &kappname; pour la première fois

## Lancer &kappname; pour la première fois

Une fois &kappname; lancé avec succès, deux fenêtres seront ouvertes. La fenêtre au premier plan, Astuce du jour propose une série d'informations utiles ou importantes à propos de l'application. Astuce du Jour Astuce du Jour

Il est recommendé de lire rapidement ces astuces en cliquant sur les bouttons Précédent et Suivant en bas de la fenêtre.

Une fois que vous aurez lu les astuces, la fenêtre peut être fermée ; elle sera réouverte à chaque fois que &kappname; sera lancé. Pour changer ce comportement par défaut, décochez l'option en question sur la fenêtre Astuce du Jour.

Les astuces peuvent être lues à tout moment en sélectionnant Afficher l'astuce du jour dans le menu Aide de &kappname;.

Toutes les astuces ont été extraites de la Foire Aux Questions (FAQ) qui fournit une aide plus détaillée et qui peut être trouvée sur le site web du projet et dans son manuel.

Veuillez cliquez sur le boutton Fermer pour fermer la fenêtre Astuce du Jour.

## La fenêtre principale

La fenêtre principale La fenêtre principale

La fenêtre principale de &kappname; comporte quatre parties principales

- A. La barre de menu

- B. La barre d'outils

- C. Le sélectionneur de vues

- D. La vue

Le menu et les barres d'outils fournissent un accès aux fonctionnalités de &kappname; et vous permettent de Créer des fichiers ou de configurer comment &kappname; fonctionne.

Le sélectionneur de vues consiste en au moins 11 icônes du côté gauche de la fenêtre principale, en fonction des logiciels disponibles sur votre système. Plus d'icônes pourraient être ajoutées par différents modules. En cliquant sur une icône, la vue appropriée de vos données financières est chargée sur la fenêtre de vue du côté droit. Chaque vue propose une représentation unique de votre situation financière et vous permet de voir ou d'éditer l'information affichée.

Le sélectionneur de vues contient les icônes suivantes

- Accueil Accueil : un aperçu configurable de votre situation financière actuelle (ou une page d'introduction quand aucun fichier de données n'est ouvert).

- EtablissementsEtablissements : tous vos établissements financiers et comptes sont affichés dans une hiérarchie.

- ComptesComptes : tous vos comptes sont affichés dans une hiérarchie.

- Opérations récurrentes Opérations récurrentes : vos factures et virements récurrents.

- Catégories Catégories : les comptes spéciaux qui vous permettent de grouper des opérations liées.

- Bénéficiaires Bénéficiaires : tous les bénéficiaires utilisés par &kappname;.

- Registres Registres : vos opérations

- Investissements Investissements : l'aperçu de votre portefeuille.

- Rapports Rapports : une collection de rapports utiles, vous fournissant des vues alternatives pour vos données financières.

- Budgets Budgets : vos budgets

- Prévisions Prévisions : cette vue vous fournit des prévisions pour vos comptes et catégories

- Boîte d'envoi Boîte d'envoi : utilisée par le module de banque en ligne pour vous fournir un retour sur le processus en cours. Cette vue est fournie par le module KBanking et peut ne pas être présente sur votre système.

## Créer un nouveau fichier

&kappname; enregistre toutes les données sur vos finances dans un fichier. Comme nous l'expliquons dans Définir les comptes, vous pouvez conserver plus d'un groupe de comptes, mais les données pour chacun d'entre eux seront conservées dans un fichier différent, et &kappname; ne peut avoir qu'un fichier ouvert à la fois. Consultez le chapître sur les Formats de Fichiers pour plus de détails sur les fichiers de données de &kappname;.

Pour créer un nouveau fichier vous pouvez soit sélectionner Fichier Nouveau dans le menu ou choisir l'icône Nouveau depuis la barre d'outils.

&kappname; ouvrira L'assistant à la Création d'un Nouveau Fichier qui vous guidera à travers le processus de création du fichier.

Données Personnelles Données Personnelles

Tous les champs sont optionnels, vous pouvez utiliser &kappname; sans saisir aucune information dans l'immédiat. Les informations saisies ici ne seront utilisées que pour personnaliser votre fichier. Dans le futur, elles pourraient être utilisées dans certains rapports ou pour la banque en ligne. Si &kappname; a besoin d'informations personnelles dans les prochaines versions et ne les trouve pas, elles vous seront demandées à ce moment là.

Veuillez saisir votre nom et adresse (ou pas) et cliquer sur Suivant.

Au cas ou vous auriez stocké votre adresse dans le &kaddressbook;, le boutton Charger à partir du Carnet d'Adresses sera activé et vous pourrez cliquer dessus pour importer toutes vos informations vers &kappname;.

&kappname; gère plusieurs devises. Pour définir votre devise par défaut (la devise que vous utilisez tous les jours et qui doit être utilisée dans vos rapports), sélectionnez le choix adapté dans la liste et cliquez sur Suivant. Une devise par défaut sera sélectionnée par &kappname; en fonction de vos paramètres régionaux et linguistiques.

Page de choix de la devise de base Page de choix de la devise de base

La page suivante vous permet de créer un compte initial. Pour la majorité des utilisateurs de &kappname;, c'est un compte courrant.

Page de création du compte courrant Page de création du compte courrant

Saisissez le nom du compte et un numéro de référence assigné par l'établissement gérant le compte. Saisissez la date d'ouverture et le solde initial du compte. Par example, si vous voulez que &kappname; gère vos finances depuis le 1er Janvier 2008, saisissez le solde de votre compte à ce jour. Ce chiffre peut être obtenu à partir des relevés papier. Saisissez aussi le nom et le numéro de routage de votre établissement, même si cette information est optionnelle et n'est nécessaire que pour les fonctionnalités de banque en ligne.

Au cas où vous ne voudriez pas configurer un compte initial, décochez la case.

Une fois terminé, cliquez sur Suivant pour avancer.

Page de sélection du modèle de compte Page de sélection du modèle de compte

Choisissez le pays et le modèle de compte adéquat. Plusieurs modèles, mêmes de pays différents peuvent être sélectionnés en utilisant la combinaison de &Ctrl;, &Maj; et du bouton gauche de la souris. La hiérarchie de comptes qui sera déployée est affichée dans la partie aperçu de l'assistant. Si vous ne pouvez pas trouver un modèle correspondant à vos besoins, n'en sélectionnez pas.

Une fois la sélection du modèle terminée, cliquez sur Suivant pour continuer.

La page suivante de l'assistant vous permet de configurer les préférences utilisateur. Cliquez sur Suivant quand vous avez terminé et souhaitez continuer.

Page de Préférences Page de Préférences

La dernière page de l'assistant vous permet de choisir le nom de fichier qui sera utilisé pour stocker vos données financières. Un nom de fichier initial sera construit à partir de votre dossier personnel et de votre nom d'utilisateur. Au cas où le fichier existe déjà, un avertissement sera affiché vous appelant à sélectionner le nom d'un fichier non-existant.

Page de sélection du nom de fichier Page de sélection du nom de fichier

Vous avez maintenant saisi toutes les informations utiles à la création du fichier. Cliquez sur Terminer et &kappname; créera le fichier pour vous et l'ouvrira.

## Créer les comptes

Vous pouvez créer un compte de deux façons différentes décrites ci-après :

En utilisant le menu

- Pour créer un compte en utilisant le menu sélectionner Compte Nouveau Compte.

En utilisant la vue Comptes

- Pour créer un compte en utilisant la vue comptes cliquez sur l'icône Comptes dans le sélecteur de vues puis faites un clic droit sur la ligne Actif de l'arborescence et sélectionnez Nouveau Compte dans le menu contextuel. La notion d'Actif /Passif et tous les autres types de comptes seront étudiés plus en détail dans ce manuel.

Notez que &kappname; utilise beaucoup les menus contextuels à travers toute l'application. Si vous ne parvenez pas à savoir comment effectuer une opération, essayez de faire un clic droit là où vous vous attendez à voir une fonctionnalité.

Quelle que soit la méthode utilisée, créer un compte ouvre l'Assistant de Paramétrage d'un Nouveau Compte. Cet assistant vous accompagnera étape par étape dans le processus de création d'un compte, récoltant les informations nécessaires à chaque étape. Pour naviguer à travers les pages cliquez sur les boutons Précédent et Suivant.

Créez un compte en utilisant une des deux méthodes précedemment mentionnées pour continuer. Une description complète de la création des comptes peut être trouvée dans la section Comptes.

Maintenant qu'un ou plusieurs comptes existent dans &kappname;, le résumé de ces comptes est affiché sur la vue d'Accueil. Vous pouvez créer des opérations manuellement dans la vue Registres ou mettre en place des opérations automatiques à travers la vue Opérations Récurentes.

## Opérations récurrentes

Une opération récurrente est une opération qui a lieu une ou plusieurs fois dans un certain laps de temps. Par exemple si vous recevez votre salaire chaque mois ou chaque semaine. Au lieu d'avoir à saisir les détails de l'opération à chaque fois que vous êtes payé, vous pouvez demander à &kappname; de créer une opération récurrente qui saisira l'opération à votre place à chaque fois que vous êtes payé.

Pour mettre à jour les Opérations récurrentes cliquez sur l'icône Opérations récurrentes dans le sélectionneur de vues.

## Catégories

Pour mettre à jour les Catégories cliquez sur l'icône Catégories du sélectionneur de vues.

Une description complète de ce sujet peut être consultée dans la section Catégories.

## Bénéficiaires

Pour mettre à jour votre liste de bénéficiaires cliquez sur l'icône Bénéficiaires du sélectionneur de vues.

Une description complète de ce sujet peut être consultée dans la section Bénéficiaires.

## Importation depuis un fichier Quicken Interchange Format (QIF)

Si vous utilisez déjà une application de gestion financière, &kappname; peut importer les opérations d'un compte à partir du moment où elles sont dans le Format Quicken Interchange (QIF). La majorité des programmes de gestion financière peut exporter vers ce format et nous ne discuterons pas des différentes méthodes d'exportation au format QIF ici, par souci de concision.

Une description complète de ce sujet peut être consultée dans la section Importation QIF.

## Chercher des opérations

&kappname; fournit un outil de recherche de opérations puissant et utile sous la forme d'une fenêtre de recherche.

La fenêtre de recherche peut être ouverte à partir de la barre d'outils en utilisant l'icône Trouver ou en sélectionnant Trouver l'opération depuis le menu Edition.

Une description complète de ce sujet peut être consultée dans la section Recherche.

## Réconciliation

A un certain point, vous aurez besoin de réconcilier les opération que vous avez saisies avec celles listées dans un relevé, que ce soit celui de votre compte en banque, de votre carte de crédit, de votre prêt ou autres. La réconciliation implique la mise en correspondance de ce que vous avez saisi et de ce qui est listé par le relevé. Si des incohérences sont trouvées c'est que vous ou la personne ayant généré le relevé a fait une erreur.

Pour réconcilier un compte, sélectionnez tout d'abord le compte, soit depuis la vue Comptes, soit depuis la vue Registres. Puis, cliquez sur l'icône Réconcilier de la barre d'outils ou sélectionnez Réconcilier depuis le menu Compte.

Une description complète de ce sujet peut être trouvée dans la section Réconciliation.

## Effectuer des copies de secours

Maintenant que vous avez créé quelques comptes et saisi des opérations il serait bon de faire une sauvegarde. Le fichier utilisé par &kappname; étant un fichier Unix standard, vous pouvez tout simplement le copier vers un autre endroit pour le sauvegarder ou utiliser la fenêtre fournie par &kappname;. Il vaut mieux utiliser la fenêtre, car si un jour &kappname; utilise un autre format de fichier, comme une base SQL, alors il sera beaucoup plus difficile de copier le fichier manuellement.

Pour effectuer une copie de secours de votre fichier à travers &kappname;, sélectionnez Sauvegarde dans le menu Fichier et saisissez le dossier où vous souhaiteriez que le fichier soit copié. Si le dossier à besoin d'être monté en premier lieu, vous devrez avoir les privilèges suffisants et cocher la case Monter ce dossier avant de sauvegarder puis cliquer sur OK.

Le fichier sera copié dans le dossier spécifié avec la date actuelle concaténée à la fin du nom du fichier pour qu'il vous soit facile de voir à quelle date le fichier a été enregistré.

## Lancer &kappname;

De manière générale, vous lancerez &kappname; depuis une icône ou le menu de démarrage de votre environnement de bureau. Dans ce cas, le comportement par défaut de &kappname; est d'ouvrir le dernier fichier ouvert. Néanmoins, dans certains cas, vous aurez envie ou besoin de lancer &kappname; depuis la ligne de commande.

Pour une description complète de toutes les options disponibles en ligne de commande, consultez la page man de &kappname;. Néanmoins, nous décrirons deux cas particuliers ici.

## `kmymoney -n`

L'option -n indique à &kappname; de ne pas ouvrir le dernier fichier ouvert. Ca peut être utile si le programme plante au démarrage.

## `kmymoney <emplacement du fichier>`

Donner à &kappname; un nom de fichier via la ligne de commande lui indique d'ouvrir ce fichier et non le dernier fichier ouvert. Vous pouvez utiliser le nom de n'importe quel fichier &kappname; valable, comme décrit dans le chapitre sur les formats de fichiers. De plus, cette fonctionnalité peut être utilisée pour importer un fichier GnuCash.

## Contacter les Développeurs / Signaler des Bogues

### Contacter les Développeurs

Vous pouvez contacter les développeurs à travers leur liste de discussion &devlist;.

Nous sommes heureux d'avoir votre retour d'expérience sur &kappname;.

### Signaler des Bogues

Pour signaler un bogue, veuillez utiliser l'interface fournie par &kappname; en sélectionnantAide Rapport de Bug et en remplissant les informations utiles. Néanmoins, au cas où vous auriez des difficultés à utiliser cette méthode, vous pouvez signaler un bug (ou faire une demande d'amélioration) directement sur la page web des bogues de &kde;. Les rapports doivent être soumis par rapport au produit kmymoney4. kmymoney2 est spécifique aux bogues des versions 1.0.x de l'application.

Dans tous les cas, avant de signaler un bogue, veuillez lire les règles ci-dessous. Les suivre augmentera les chances des développeurs d'identifier rapidement le problème sans avoir besoin de vous demander plus d'informations.

#### Ecrire des Raports de Bogues de Bonne Qualité

Nous encourageons les utilisateurs à prendre du temps supplémentaire pour écrire des raports de bogues de bonne qualité lorsqu'ils les soumettent. Cela réduit les efforts inutiles des deux côtés, étant donné que la personne à l'origine du rapport et le développeur qui règlera le bogue devront le cas échéant échanger des mails jusqu'à ce que cette information soit bien déterminée.

Eli Goldberg a écrit les règles d'écriture de rapports de bogues, disponibles sur http://issues.apache.org/bugwritinghelp.html. De manière générale, il est conseillé de suivre ces règles :

#### Incluez les informations sur votre système

La fonctionnalité Aide Rapporter un Bogue remplira ces informations à votre place automatiquement, mais si vous choisissez de ne pas utiliser cette interface, vous devrez connaître la version de &kappname; que vous utilisez, la version de &kde;, le nom et la version de votre distribution et la version de votre noyau.

#### Inclure les traces lors d'un plantage

Les traces sont souvent l'élément d'information le plus utile pour la résolution des plantages.

#### Essayez de le reproduire

Faites nous savoir si vous êtes capables de reproduire le bogue. Il est utile pour nous de savoir si le bogue ne s'est produit qu'une fois et vous n'avez pas réussi à le faire se reproduire, si il arrive à chaque fois ou si il arrive parfois.

#### Inclure les étapes spécifiques

J'ai saisi une opération et &kappname; a planté., voila un mauvais rapport de bogue. En utilisant le formulaire d'opération, j'ai saisi une nouvelle opération dans mon compte Carte de Crédit. J'ai sélectionné l'onglet Transfert, saisi un montant, puis je suis passé à l'onglet Dépôt, et de revenu à l'onglet Transfert. Quand je suis revenu à l'onglet Transfert, &kappname; a planté. Ce bug est reproductible chez moi., ceci est un bien meilleur rapport de bogue.

#### Dites nous ce à quoi vous vous attendiez

Dans certains cas, c'est évident, mais pour certains bogues plus subtils, vous verrez parfois un rapport de bogue où il n'est pas évident de deviner ce que la personne l'ayant signalé attendait. Dites nous systématiquement le comportement que vous attendiez.

#### Considérez lancer l'application avec le débogage activé

En compilant une version configurée avec --enable-debug=full vous pouvez vous assurer que les meilleures traces possibles sont générées. Si vous plantez, lancez une nouvelle fois &kappname; à partir de gdb et reproduisez le plantage. Lorsque le logiciel plante, saisissez bt pour générer une trace.

Faire ceci est un peu plus difficile, nous ne nous attendons donc pas à ce que tous les utilisateurs le fassent. Néanmoins, si vous souhaitez rendre &kappname; le plus stable possible, la meilleure façon de faire est encore de trouver le bogue dans le code source et de nous envoyer un patch.