# Primo utilizzo di &kmymoney;

## Eseguire &kmymoney; per la prima volta

Una volta che &kmymoney; si è caricato completamente, si apriranno due finestre. La finestra in primo piano, «Suggerimento del giorno», offre una serie di informazioni importanti o utili per l'utilizzo del programma. Suggerimento del giorno Suggerimento del giorno

Si raccomanda di dare una letta veloce a questi suggerimenti, premendo i pulsanti Precedente e Successivo nella parte bassa della finestra.

Una volta letti i suggerimenti si può chiudere la finestra; verrà riaperta ogni volta che si avvierà &kmymoney;. Per modificare questo, deselezionare l'opzione corrispondente nella finestra Suggerimento del giorno.

I suggerimenti possono essere letti in qualsiasi momento, selezionando la voce di menu Suggerimento del giorno dal menu Aiuto all'interno di &kmymoney;.

Tutti i suggerimenti sono stati presi dall'elenco delle domande frequenti (&FAQ;) che fornisce un aiuto più dettagliato ed è disponibile sul sito web del progetto e in questo manuale.

Fare clic sul pulsante Chiudi per chiudere la finestra di dialogo Suggerimento del giorno.

Quando si esegue &kmymoney;, potrebbe non apparire esattamente come le schermate in questo manuale. Molti dettagli, come caratteri, colori e icone possono essere personalizzati, sia utilizzando la voce di menu Impostazioni Configura &kmymoney;..., sia dall'applicazione &systemsettings; di &kde;, in base al proprio sistema operativo.

## La finestra principale

La finestra principale La finestra principale

La finestra principale di &kmymoney; consiste di quattro parti principali

- A. La barra dei menu

- B. La barra degli strumenti

- C. Il selettore della vista

- D. La vista

Il menu e le barre degli strumenti permettono di accedere alle funzionalità di &kmymoney; permettono di Creare file e configurare il funzionamento di &kmymoney;.

Sul lato sinistro della finestra principale, il selettore della vista consiste in almeno undici icone nella parte con etichette opzionali, in base ai programmi installati nel sistema in uso. Varie estensioni possono aggiungere altre icone. Facendo clic su un'icona, la finestra di visualizzazione nella parte destra viene caricata con la vista appropriata dei propri dati finanziari. Ogni vista fornisce una propria rappresentazione della situazione finanziaria e permette di vedere o modificare le informazioni.

Il selettore della vista può contenere le icone seguenti

- Inizio Inizio: un riepilogo configurabile della situazione finanziaria corrente (o una pagina introduttiva se non è aperto alcun file dati).

- Vista degli istituti Istituti: tutti i tuoi conti e istituti vengono visualizzati in una gerarchia.

- Vista dei conti Conti: tutti i tuoi conti visualizzati in una gerarchia.

- Vista delle pianificazioni Transazioni pianificate: le fatture e i pagamenti ricorrenti.

- Vista delle categorie Categorie: conti speciali che permettono di raggruppare le transazioni associate.

- Vista delle etichette Etichette: conti speciali che aggiungono altri modi alle categorie per raggruppare le transazioni associate.

- Vista dei beneficiari Beneficiari: tutti i beneficiari usati da &kmymoney; Ci sono tutte le persone o organizzazioni ai quali effettui pagamenti in moneta o ricevi pagamenti in moneta.

- Vista dei registri Registri: lista delle transazioni di un conto.

- Vista degli investimenti Investimenti: un riepilogo del tuo paniere di titoli.

- Vista dei report Report: un'insieme di report utili, che forniscono visualizzazioni alternative dei dati finanziari.

- Vista dei budget Budget: i tuoi budget.

- Vista delle previsioni Previsione: questa vista fornisce una previsione dei conti e delle categorie.

- Vista uscita Usata dal modulo di online banking per fornire informazioni sui processi in corso. Questa vista viene fornita dall'estensione KBanking e potrebbe non essere disponibile sul tuo sistema.

## Creazione di un nuovo file

&kmymoney; memorizza tutti i dati riguardanti le tue finanze in un file. Come viene spiegato in Definizione dei conti (registrazioni personali), è possibile avere più di un insieme di conti, ma i dati relativi ad ogni insieme saranno memorizzati in file diversi e &kmymoney; può aprire solo un file per volta. Per maggiori informazioni sui file dati di &kmymoney;, vedere il capitolo Formati dei file.

Per creare un nuovo file si può selezionare la voce di menu File Nuovo o scegliere l'icona Nuovo dalla barra degli strumenti. Inoltre, se la pagina principale di benvenuto è visualizzata, è possibile selezionare il primo collegamento: «Inizia e configura i conti».

&kmymoney; aprirà la Procedura guidata di creazione di un nuovo file che guiderà nella creazione di un nuovo file.

Pagina dei dati personali Pagina dei dati personali

Tutti i campi sono opzionali, quindi è possibile usare &kmymoney; senza inserire nessuna informazione in questo momento. Le informazioni inserite qui servono solo a personalizzare il proprio file di dati. In futuro, potrebbero essere usate per i report e l'online banking. Se alcuni campi diventeranno obbligatori nelle prossime versioni di &kmymoney; e adesso vengono lasciati vuoti, saranno richieste le informazioni necessarie.

Inserire il nome e l'indirizzo (o lasciare vuoto) e fare clic suAvanti.

Se il proprio indirizzo è memorizzato in &kaddressbook;, il pulsanteCarica dalla rubrica sarà abilitato e permetterà di importare tutte le informazioni in &kmymoney;.

&kmymoney; supporta diverse valute. Per impostare la valuta di base (quella si usa normalmente e verrà utilizzata nei report), selezionare la voce corrispondente nella lista e fare clic su Avanti. &kmymoney; selezionerà la valuta predefinita in base alle impostazioni della lingua.

Nell'esempio seguente, il dollaro statunitense è stato selezionato come valuta di base.

Pagina della selezione della valuta di base Pagina della selezione della valuta di base

La pagina seguente permette di creare un conto di base. Normalmente, per gli utenti di &kmymoney; è un conto corrente.

Pagina di creazione di un conto corrente Pagina di creazione di un conto corrente

Inserire il nome del conto e (se si vuole) il numero di riferimento assegnato dall'istituto che gestisce il conto. Inserire la data di apertura del conto e il bilancio di apertura. Per esempio, se si vuole che &kmymoney; gestisca le finanze a partire dal 01/01/2008, inserire questa data e il bilancio del conto in questa data. Il bilancio si può ottenere da un estratto conto. Inserire anche il nome ed il numero identificativo dell'istituto, anche se questa informazione è facoltativa e richiesta solo per l'online banking.

Se non si desidera configurare un conto iniziale, deselezionare la casella relativa.

Una volta completato questo passo, premere Avanti per continuare.

Pagina di selezione dei gruppi di conti Pagina di selezione dei gruppi di conti

Scegliere il Paese e i modelli di conti appropriati. Ogni modello fornisce un insieme diverso di categorie per organizzare le proprie finanze. Usando &Ctrl; e &Shift;, insieme al &LMB;, è possibile selezionare diversi modelli, anche di nazioni diverse. Verrà visualizzata un'anteprima della gerarchia dei conti. Se non si trova un modello che corrisponde alle proprie esigenze, non selezionare nulla in quel momento e configurare manualmente le categorie successivamente.

Una volta completata la selezione dei gruppi di conti, premere Avanti per continuare.

La pagina successiva della procedura guidata permette di configurare le preferenze dell'utente. Se si marca la casella di selezione, sarà visualizzata la finestra delle impostazioni dell'applicazione al termine della procedura guidata di configurazione. Premere Avanti quando si vuole continuare.

Pagina delle preferenze Pagina delle preferenze

L'ultima pagina della procedura guidata permette di selezionare la posizione e il nome del file che sarà utilizzato per memorizzare i dati finanziari. I valori iniziali saranno costruiti a partire dalla propria cartella principale e dal nome utente. Se il file esiste già, sarà visualizzato un avvertimento che ricorda di selezionare un nome di file non esistente.

Pagina della selezione del nome del file Pagina della selezione del nome del file

Sono state inserite tutte le informazioni necessarie alla creazione del file. Premere Fine e &kmymoney; creerà il file e lo aprirà.

## Creazione di conti

È possibile creare un conto in diversi modi, descritti qui:

Usando il menu

- Per creare un conto utilizzando il menu, selezionare la voce di menu Conti Nuovo conto....

Usando la vista dei Conti

- Per creare un conto utilizzando la vista dei conti, fare clic sull'icona Conti nel selettore della vista. Fare clic con il tasto destro del mouse sull'icona dell'albero delle Attività o delle Passività nella vista di destra e selezionare Nuovo conto dal menu a comparsa. L'albero delle Attività contiene tutti i conti relativi alle attività, come risparmi e investimenti. Le passività sono conti che rappresentano il denaro da restituire, come prestiti e carte di credito. Questi e gli altri tipi di conto sono spiegati in dettaglio più avanti in questo manuale.

Utilizzare la barra degli strumenti

- Se il pulsante Nuovo conto... è visualizzato nella barra degli strumenti, è possibile fare clic per creare un conto.

È bene notare che &kmymoney; usa molto i menu contestuali, in tutto il programma. Se non si riesce a capire come fare qualcosa, provare a fare clic con il tasto destro del mouse dove ci si aspetta di avere una certa funzione.

La creazione di un nuovo conto con uno dei due metodi descritti aprirà la finestra Procedura guidata di creazione di un nuovo conto. Questa procedura guiderà passo passo nel processo di creazione di un conto, richiedendo man mano le informazioni necessarie. Per spostarsi tra le pagine fare clic sui pulsanti Avanti e Indietro.

Creare un conto con uno dei due metodi descritti in precedenza per continuare. Nella sezione Conti si può trovare una descrizione completa del processo di creazione di un conto.

Adesso che ci sono uno o più conti in &kmymoney;, il riepilogo dei conti viene visualizzato nella vista Inizio. È possibile creare transazioni manualmente nella vista dei Registri, o impostare transazioni automatiche attraverso la vista Pianificazioni.

## Pianificazioni

Detta anche transazione ricorrente, una Pianificazione è una transazione che avviene una o più volte in un certo periodo di tempo. Un esempio tipico sono gli stipendi settimanali o mensili. Al posto di dover aggiungere i dettagli della transazione ad ogni pagamento, si può creare una pianificazione in &kmymoney; in modo da inserire automaticamente una transazione quando si viene pagati.

Per gestire le pianificazioni, fare clic sull'icona delle pianificazioni nel selettore della vista.

## Categorie

Per gestire le categorie fare clic sull'icona delle categorie nel selettore della vista.

Si possono trovare maggiori informazioni su questo argomento nella sezione Categorie.

## Etichette

Per gestire le etichette, fare clic sull'icona delle etichette nel selettore della vista.

Una descrizione completa di questo argomento è disponibile nella sezione Etichette.

## Beneficiari

Per gestire il proprio elenco di beneficiari, fare clic sull'icona dei beneficiari nel selettore della vista.

Si possono trovare maggiori informazioni su questo argomento nella sezione Beneficiari.

## Importazione da Quicken Interchange Format (QIF)

Se si usa già un programma per la gestione delle finanze, &kmymoney; può importare le transazioni dei conti, così come può esportarle o salvarle in un formato che &kmymoney; comprende. Il più comune è il Quicken Interchange Format (QIF). La maggior parte dei programmi finanziari è in grado di esportare in questo formato, ma qui, per brevità, non viene spiegato come farlo.

Si possono trovare maggiori informazioni su questo argomento nella sezione Importazione da QIF.

## Ricerca di transazioni

&kmymoney; fornisce un'utile e potente funzione di ricerca, nella finestra di dialogo di ricerca.

La finestra di ricerca può essere aperta dalla barra degli strumenti, utilizzando l'icona Trova o selezionando la voce di menu Modifica Trova transazione.

Si possono trovare maggiori informazioni su questo argomento nella sezione Ricerca.

## Riconciliazione

Ad un certo punto, si vorranno riconciliare le transazioni inserite con quelle elencate in un estratto conto, ad esempio di un conto corrente, di una carta di credito o di un prestito. La riconciliazione consiste nel mettere in corrispondenza le transazioni inserite con quelle elencate nell'estratto conto. Se si trovano delle differenze, è stato commesso un errore, o da te o da chi ha fatto l'estratto conto.

Per riconciliare un conto, selezionarlo dalla vista Conti o dalla vista Registri o dalla vista Registri. Poi fare clic sull'icona Riconcilia della barra degli strumenti o selezionare la voce di menu Conto Riconcilia.

Si possono trovare maggiori informazioni su questo argomento nella sezione Riconciliazione.

## Copie di sicurezza

Una volta creati dei conti e inserite delle transazioni, è una buona idea creare un copia di sicurezza. Il file utilizzato da &kmymoney; è un file standard Unix, quindi basta copiarlo in un'altra posizione per creare una copia di sicurezza, oppure si può usare la funzione specifica di &kmymoney;. Il metodo consigliato è quest'ultimo, perché se &kmymoney; dovesse iniziare ad usare altri formati, come SQL, diventerebbe molto più difficile la copia manuale del file.

Per creare una copia di sicurezza del file tramite &kmymoney;, selezionare la voce di menu File Backup e digitare la cartella in cui si vuole salvare il file. Se la cartella ha bisogno di essere montata e si hanno i privilegi richiesti, marcare l'opzione Monta questa cartella prima di effettuare il backup e fare clic su OK.

Il file sarà copiato nella cartella specificata, aggiungendo al nome la data attuale, in modo da poter vedere facilmente la data di creazione della copia di sicurezza.

## Avviare &kmymoney;

Il modo più comune di avviare &kmymoney; consiste nell'utilizzare un'icona o il menu di avvio del tuo gestore delle finestre. In questo caso, il comportamento predefinito di &kmymoney; è di riaprire l'ultimo file aperto. Ad ogni modo, in alcuni casi si può voler eseguire &kmymoney; da riga di comando.

Per una descrizione completa di tutte le opzioni a riga di comando disponibili, consultare la pagina di man relativa a &kmymoney;. Comunque, ci sono due casi speciali descritti qui di seguito.

## `kmymoney -n`

L'opzione -n indica a &kmymoney; di non riaprire l'ultimo file aperto. Questo può essere utile se il programma si chiude in modo inatteso all'avvio.

## `kmymoney <file>`

Se si passa a &kmymoney; un nome file sulla riga di comando, sarà aperto quel file al posto dell'ultimo file aperto. Si può specificare il nome di qualsiasi file valido di &kmymoney;, come descritto nel capitolo sui formati di file. Inoltre, questa modalità può essere utilizzata per importare un file di &gnucash;.

## Come spostare &kmymoney; su un nuovo computer

### Spostare i propri dati

Se si acquista un nuovo computer, è molto semplice spostare i propri dati. Infatti, tutto ciò che bisogna fare è copiare il proprio file di dati di &kmymoney;. Il nome del file è mostrato nella barra del titolo quando &kmymoney; è in esecuzione, e normalmente ha estensione `.kmy`. La prima volta che si esegue l'applicazione sul nuovo computer, sarà necessario indicare dove è stato posizionato il file di dati, sia eseguendo il programma dalla riga di comando che dalla voce di menu File Apri.... Dovrebbe essere inoltre possibile spostarsi tra sistemi &Windows;, &MacOS; e &Linux;.

Se il proprio file di dati è stato cifrato, assicurarsi di aver configurato, in modo appropriato, il programma e le chiavi su un altro computer.

Se i propri dati sono in una base di dati SQL, fare riferimento alla documentazione della base di dati per le istruzioni sulla migrazione dei dati.

Notare che ciò presume che sul nuovo computer sia stata installata la stessa versione di &kmymoney; che era eseguita sul vecchio computer. Installare una nuova versione dovrebbe essere ugualmente sicuro, ma è necessario essere informati su qualsiasi possibile problema relativo a tale aggiornamento. Ogni possibile problema dovrebbe essere descritto nelle note di rilascio per la nuova versione.

### Spostare le impostazioni

Se si sposta solo il proprio file di dati nella nuova macchina, come descritto nella sezione precedente, &kmymoney; funzionerà correttamente, ma si perderanno tutte le impostazioni modificate dai valori predefiniti sulla vecchia macchina. Per conservare queste impostazioni, sarà necessario copiare anche il proprio file di configurazione. Questo file si chiama `kmymoneyrc`. Il file sarà in una cartella con gli altri file di configurazione delle applicazioni di &kde;. Su un sistema &Linux;, sarà in `$KDEHOME/share/config` dove `$KDEHOME` è normalmente .config all'interno della propria cartella home. Se si sta migrando da una versione di &kmymoney; che precedente alla 5.0 o successive, la vecchia posizione di `$KDEHOME` era `.kde4`.

#### Spostare le impostazioni delle estensioni

Se si esegue una qualsiasi estensione di &kmymoney;, come lo strumento di importazione o di esportazione csv, potrebbe essere stato creato un file di configurazione nella stessa cartella, come `csvimporterrc` o `csvexporterrc`. Anche questi dovrebbero essere copiati sul nuovo computer.

Come per il file di dati principale, ciò assume la stessa versione dell'estensione su entrambi i computer. Gli aggiornamenti sono normalmente sicuri, ma se la funzionalità dell'estensione è stata modificata in modo sostanziale, è consigliabile provare con attenzione a utilizzare il vecchio file di configurazione, per essere sicuri che l'estensione si comporti come previsto.

Notare che quando si aggiorna da una versione precedente alla versione 5.0 o superiore, la posizione dei file di modello utilizzati dall'estensione di stampa degli assegni cambia. Consultare le note di rilascio o il sito web del progetto per ulteriori dettagli.

Queste istruzioni riguardano lo spostamento dei dati e delle impostazioni di &kmymoney;. Tuttavia, potrebbero esserci elementi importanti che sono memorizzati da &kde; e non da &kmymoney;, come le password conservate in kwallet. Lo spostamento di altre parti della configurazione di &kde; va oltre gli scopi di questo manuale, anche se molti dei file importanti sono memorizzati in `$KDEHOME`.

## Come contattare gli sviluppatori / Segnalare errori

### Contattare gli sviluppatori

Per domande generiche e commenti su &kmymoney;, esiste una lista di distribuzione degli utenti &userlist;. (ulteriori dettagli qui.) In aggiunta, è possibile contattare gli sviluppatori tramite la loro lista di distribuzione &devlist;. (ulteriori dettagli qui). Dato che le risposte sono spesso inviate solo alla lista, potresti non ricevere risposta se non ti iscrivi a una delle liste prima di inviare.

Siamo felici di conoscere le tue esperienze con &kmymoney;.

### Segnalare gli errori

Per segnalare un bug, utilizzare l'interfaccia fornita da &kmymoney; selezionando Aiuto Segnala un bug e inserire le informazioni richieste. In caso si abbiano delle difficoltà con questo metodo, è possibile segnalare un bug (o richiedere miglioramenti o nuove funzionalità) direttamente al sito web di segnalazione dei bug di &kde;. I bug segnalati devono essere associati al prodotto kmymoney.

In ogni caso, prima di segnalare un bug, leggere le linee guida che seguono. Queste linee guida servono per aiutare gli sviluppatori a identificare velocemente il problema, senza doverti chiedere maggiori informazioni.

#### Scrittura di segnalazioni di qualità

Incoraggiamo gli utenti a usare tutto il tempo necessario per scrivere una buona segnalazione degli errori. Questo riduce lo speco di tempo per entrambi, perché lo sviluppatore e il segnalatore devono scambiarsi messaggi email finché non vengono fornite abbastanza informazioni.

Eli Goldberg ha scritto le linee guida per la scrittura di bug, disponibili all'indirizzo https://issues.apache.org/bugwritinghelp.html. Generalmente, basta seguire queste regole:

#### Includere informazioni sul sistema in uso

La voce di menu Aiuto Segnala un bug compilerà automaticamente le informazioni, ma se si preferisce evitare l'utilizzo di questa interfaccia, ci sono diversi elementi da includere nella segnalazione. Sarà necessario conoscere la versione del sistema operativo utilizzato (&Linux;, &MacOS; o &Windows;), la versione di &kde; e di &kmymoney;, la versione di &MacOS; o di &Windows; o il nome e la versione della distribuzione &Linux; e la versione del kernel.

#### Includere un backtrace per i crash

Il backtrace è spesso l'informazione più utile che si può fornire per risolvere i crash.

#### Provare a riprodurre il problema

Facci sapere se si è in grado di riprodurre il problema. È utile sapere se il problema è capitato solo una volta, capita sempre o solo a volte.

#### Includere passi specifici

Questa non è una buona segnalazione di errori: Ho inserito una transazione e &kmymoney; è andato in crash.. Una segnalazione molto migliore potrebbe essere: Usando il modulo per l'inserimento delle transazioni, ho inserito una nuova transazione nel mio conto della carta di credito. Ho selezionato la scheda Trasferimenti e inserito il valore, poi sono andato nella scheda Deposito e poi sono tornato nella scheda Trasferimenti. Quando sono tornato nella scheda Trasferimenti, &kmymoney; è andato in crash. Questo problema è sempre riproducibile.

#### Dì cosa ti aspettavi che succedesse

In alcuni casi questo è ovvio, ma nei problemi più sottili, a volte ci sono delle segnalazioni in cui non si capisce bene cosa si aspettava di ottenere chi ha segnalato il problema. Dì sempre quello che ti aspettavi che sarebbe successo.

#### Considerare la possibilità di eseguire il programma in modalità di correzione errori

Compilando il programma con l'opzione --enable-debug=full è possibile assicurarsi di generare backtrace migliori. Se si incontra un crash, avviare &kmymoney; da gdb e provare a riprodurre il problema. Quando si incontra il crash, digitare bt per generare un backtrace.

L'esecuzione in questa modalità è più difficoltosa, non ci aspettiamo che la maggior parte degli utenti lo facciano. Comunque, se sei interessato ad aiutare &kmymoney; a diventare più stabile possibile, questo è il modo migliore per farlo, a parte trovare il problema nel sorgente e inviare una patch.