# Primo utilizzo di &kmymoney;

## Eseguire &kmymoney; per la prima volta

### Le schermate potrebbero differire

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 o distribuzione.

### 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 forniscono accesso alle funzionalità di &kmymoney; e consentono di Creare un nuovo file di dati,aprire un file di dati esistente o configurare il funzionamento di &kmymoney;. La barra degli strumenti può essere configurata per mostrare le icone per le operazioni che si utilizzano più frequentemente.

Sul lato sinistro della finestra principale, il selettore della vista consiste di almeno undici icone con etichette opzionali, in base ai programmi installati nel proprio sistema, poiché alcune funzionalità possono essere incluse o escluse quando il programma viene compilato. Ulteriori icone potrebbero essere aggiunte da varie estensioni. Facendo clic su una delle icone, la finestra delle viste sul lato destro viene caricata con la vista appropriata dei propri dati finanziari. Ogni vista fornisce una rappresentazione unica della situazione finanziaria e consente di visualizzare o modificare le informazioni mostrate.

Il selettore della vista può contenere le icone seguenti

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

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

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

- Vista delle pianificazioni Transazioni pianificate: i tuoi pagamenti ricorrenti, le entrate e i trasferimenti.

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

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

- Vista dei beneficiari Beneficiari: i tuoi beneficiari - le persone e le organizzazioni a cui paghi denaro o da cui ricevi denaro.

- Vista dei registri Registri: le tue transazioni su ogni conto.

- Vista degli investimenti Investimenti: il riepilogo del tuo portafoglio.

- Vista dei report Report: una raccolta di varie visualizzazioni personalizzabili dei tuoi dati finanziari.

- Vista dei budget Budget: i tuoi budget.

- Vista delle previsioni Previsione: previsione dei saldi dei tuoi conti e categorie.

- Vista uscita Uscita: una visualizzazione fornita dall'estensione KBanking per fornire riscontro sui processi in esecuzione.

Tieni presente che alcuni di questi potrebbero non essere presenti sul tuo sistema; dipende da come è stata configurata e compilata la tua copia di &kmymoney;.

## 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.

Oltre a quel file di dati con tutti i dati finanziari per quell'insieme di conti, &kmymoney; usa file aggiuntivi per memorizzare dati riguardanti le impostazioni di configurazione e le preferenze di visualizzazione. La posizione esatta di questi file dipende dal tuo specifico sistema operativo o distribuzione.

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

Tutte le informazioni inserite nella pagina Dati personali sono utilizzate solo per personalizzare il proprio file. Tutti questi campi sono facoltativi, quindi è possibile utilizzare &kmymoney; senza dover inserire alcuna informazione subito. In futuro, queste informazioni potrebbero essere utilizzate in alcuni report e per i servizi bancari in linea. Se &kmymoney; richiede informazioni personali in future versioni e non ne trova, ti sarà chiesto di inserire i dati rilevanti.

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

Una volta completato l'inserimento dei dati, premere Avanti.

Se in futuro avrai bisogno di modificare una di queste informazioni, potrai accedere a questo modulo tramite la voce di menu File Dati personali....

&kmymoney; supporta diverse valute. Per impostare la valuta di base (quella si usa normalmente e che sarà utilizzata nei report), selezionare la voce appropriata nell'elenco fornito e fare clic su Avanti. Sarà selezionata una valuta predefinita in base alle impostazioni locali, ma è possibile scegliere facilmente una valuta diversa, se appropriata per la tua situazione.

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

In questo esempio, il dollaro statunitense è stato selezionato come valuta di base.

Dopo aver fatto clic su Avanti, la pagina seguente ti consente di creare un conto iniziale. Per il tipico utente di &kmymoney; questo è un conto corrente.

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

Digitare il nome del conto e un eventuale conto o numero di riferimento assegnato dall'istituto che gestisce il conto. Il nome è arbitrario e rappresenta semplicemente il modo in cui il conto sarà referenziato e visualizzato da &kmymoney;. Inserisci la data di apertura e il saldo di apertura del conto. Ad esempio, se vuoi usare &kmymoney; per gestire tutte le tue finanze a partire dal 1/1/2008, inserisci il saldo del conto all'inizio a questa data. Il numero può essere eventualmente ricavato da un estratto conto cartaceo. Puoi anche inserire il nome e il codice bancario dell'istituto. Quest'ultimo, noto come numero di routing negli Stati Uniti o come sort code nel Regno Unito, è facoltativo e richiesto solo per scopi bancari in linea, ma può anche essere utile quando si importano estratti conto bancari in alcuni dei formati supportati (OFX, QFX).

Se non desideri creare un conto iniziale o non hai un conto corrente, deseleziona semplicemente la casella.

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.

Questa è la pagina finale della procedura guidata. Se si marca la casella Configura le preferenze dopo aver terminato la procedura guidata, la finestra delle impostazioni dell'applicazione sarà visualizzata dopo aver completato la procedura guidata di configurazione del conto.

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

A questo punto, facendo clic su Fine si aprirà la finestra Salva archivio con nome..., in cui puoi scegliere il tipo di archivio (XML, eventualmente con cifratura, o SQL) e specificare i dettagli di tale metodo di archiviazione, come nome file e posizione o dettagli della banca dati SQL. Consulta i capitoli Formati file e Formati file per maggiori informazioni su ciascun tipo di archivio.

## Creazione di conti

Esistono diversi modi per creare un conto:

Usando il menu

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

Utilizzare la vista dei conti

- Per creare un conto utilizzando la vista dei conti, fare clic sull'icona Conti nel selettore della vista per visualizzare la vista dei conti. 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 nel capitolo Conti.

Utilizzare la barra degli strumenti

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

Nota che &kmymoney; usa menu contestuali in tutta l'applicazione. Se ti ritrovi bloccato nel tentativo di capire come fare qualcosa, prova a fare clic sul &RMB; dove ti aspetteresti di vedere una funzionalità.

La creazione di un nuovo conto con uno dei due metodi sopra 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. Una descrizione completa della creazione dei conti è disponibile nella sezione Conti.

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

## Transazioni pianificate

Una transazione pianificata, a volte chiamata pianificazione o transazione ricorrente, è una transazione che si verifica una o più volte a intervalli specifici in un determinato periodo di tempo. Un esempio tipico è la busta paga che ricevi ogni settimana o mese, o una bolletta che paghi ogni mese. Invece di dover inserire i dettagli della transazione ogni volta che vieni pagato, puoi istruire &kmymoney; a creare un programma che inserirà una transazione per te quando sarai pagato.

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

## Categorie

Per gestire le categorie fare clic sull'icona 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 Etichette nel selettore della vista.

Una descrizione più dettagliata di questo argomento può essere trovata nella sezione Etichette.

## Beneficiari

Per gestire i tuoi beneficiari, fai clic sull'icona Beneficiari nel selettore della vista.

Una descrizione più dettagliata di questo argomento può essere trovata nella sezione Beneficiari.

## Importazione di dati finanziari da altre applicazioni

Se si usa già un programma per la gestione delle finanze, è molto probabile che &kmymoney; possa importare molti o tutti i dati da quel programma, a patto che possano essere esportati o salvati in un formato che &kmymoney; capisca. Il più comune di questi è il Quicken Interchange Format (QIF). La maggior parte dei programmi finanziari può esportare questo formato, sebbene i metodi di esportazione QIF delle diverse applicazioni non siano discussi qui per brevità.

Una descrizione completa dell'importazione di dati in questo formato può essere trovata nella sezione Importazione QIF.

Oltre a importare file in formato QIF, &kmymoney; può aprire direttamente i file di dati utilizzati dal file di &gnucash;.

## 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

A un certo punto, vorrai riconciliare le tue registrazioni e i dettagli di un conto con il conto effettivo per assicurarti che corrispondano. Questo viene generalmente fatto confrontando il conto in &kmymoney; con un estratto conto stampato o elettronico emesso dall'istituto, come banca, carta di credito, prestito o qualsiasi altro estratto conto. La riconciliazione implica la corrispondenza di ciò che hai inserito, in particolare le transazioni dalla precedente riconciliazione, con ciò che elenca l'estratto conto. Se vengono rilevate delle discrepanze, o tu o la persona che ha creato l'estratto conto avete commesso un errore.

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

Una descrizione più dettagliata di questo argomento può essere trovata nella sezione Riconciliazione.

## Copie di sicurezza

Una volta creati dei conti e inserite delle transazioni, è una buona idea creare un copia di sicurezza. Poiché il file utilizzato da &kmymoney; è un file standard &Linux; (o un file di &macOS; o di &Windows;, in base al proprio sistema operativo) , basta copiarlo in un'altra posizione per creare una copia di sicurezza, oppure si può usare la finestra fornita da &kmymoney;. Il metodo consigliato è quest'ultimo, perché se &kmymoney; dovesse iniziare ad utilizzare altri formati, come SQL, diventerebbe molto più difficile copiare il file manualmente.

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.

Per maggiori dettagli sul formato effettivo del file di dati e sul processo di backup, vedere Formati di file.

## Avviare &kmymoney;

Il modo più comune di avviare &kmymoney; consiste nell'utilizzare un'icona o il menu di avvio del tuo gestore delle finestre o ambiente desktop. 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; 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, eseguendo il programma dalla riga di comando o 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 sulla 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. La posizione di questo file dipende dal sistema operativo e dalla distribuzione. Su un sistema &Linux;, sarà molto probabilmente `.config` nella propria cartella home. Se si sta migrando da una versione di &kmymoney; precedente alla 5.0, la vecchia posizione 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, questo presuppone la stessa versione dell'estensione su entrambi i computer. Gli aggiornamenti sono generalmente sicuri, ma se la funzionalità dell'estensione è cambiata notevolmente, è consigliabile verificare attentamente utilizzando il vecchio file di configurazione, per essere certi che l'estensione si comporti come previsto. Naturalmente questo vale anche quando si aggiorna la versione di &kmymoney; su un singolo PC.

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 servono esclusivamente per spostare i dati e le impostazioni di &kmymoney;.Tuttavia, potrebbero esserci elementi importanti che sono memorizzati da &kde; e non da &kmymoney;, come le password memorizzate nel portachiavi. Spostare altre parti della tua configurazione di &kde; va oltre lo scopo di questo manuale, sebbene molti dei file rilevanti siano archiviati anche in `$KDEHOME`.

## Ottenere aiuto / Contattare gli sviluppatori / Segnalare bug

Poiché i canali di supporto cambiano nel tempo, puoi fare riferimento alla pagina di supporto sul sito web di &kmymoney; per le informazioni più aggiornate su dove ottenere assistenza con &kmymoney;.

Se hai semplicemente domande sull'utilizzo di &kmymoney;, vuoi confermare di aver compreso il funzionamento dell'applicazione o hai bisogno di assistenza per capire il modo migliore per gestire una particolare situazione finanziaria, considera l'utilizzo di una delle fonti di informazioni, forum, liste di distribuzione o canali di chat disponibili al collegamento sopra.

### Contattare gli sviluppatori

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

Nota che gli sviluppatori in genere monitorano i vari canali di contatto menzionati sopra, quindi il contatto diretto via posta elettronica è raramente necessario. Tuttavia, siamo lieti di conoscere le tue esperienze nell'uso di &kmymoney; su qualsiasi canale tu preferisca.

### 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. Seguendole sarà più probabile che gli sviluppatori riescano a identificare rapidamente il problema senza doverti chiedere maggiori informazioni. Cerca anche di essere sicuro che ciò che stai segnalando sia davvero un bug (o una richiesta di miglioramento/lista dei desideri). Se le cose non funzionano come ti aspetti, o hai bisogno di aiuto per usare qualche funzionalità di &kmymoney;, usa uno dei canali di supporto alternativi elencati sopra..

#### 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. In genere, ti sarà utile seguire le linee guida e i consigli di quella pagina. Alcuni di quei punti sono ripetuti di seguito:

#### 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. Dovremo sapere quale sistema operativo stai utilizzando (&Linux;, &MacOS;, o &Windows;), la versione di &kde;, e la versione di &kmymoney; che stai eseguendo, e la versione di &MacOS; o &Windows; o il nome e la versione della tua distribuzione &Linux; e la versione del kernel. Queste informazioni sono estremamente importanti, poiché tutti i bug (così come i comportamenti erroneamente identificati come bug) dipendono dal sistema operativo.

#### 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 sei riuscito a farlo. È utile sapere se il bug si è verificato solo una volta e non sei riuscito a replicarlo, se si verifica ogni volta o se si verifica a volte, ma non altre.

#### Includere passi specifici

Questa è una segnalazione di bug non corretta: Ho inserito una transazione e &kmymoney; si è bloccato. Una segnalazione di bug decisamente migliore è: Utilizzando il modulo di transazione, ho inserito una nuova transazione nel mio conto Carta di credito. Ho selezionato la scheda Trasferimento, ho inserito un importo, quindi sono passato alla scheda Deposito e sono tornato alla scheda Trasferimento. Quando sono tornato alla scheda Trasferimento, &kmymoney; si è bloccato. Questo bug è completamente riproducibile per me.

#### 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. Descrivi sempre ciò che ti aspettavi che sarebbe successo e cosa invece si è verificato.

#### 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.