&Michael.T.Edwardes; &Michael.T.Edwardes.mail;
30/08/2014
4.7.01

# Primo utilizzo di &kappname;

## Eseguire &kappname; per la prima volta

Una volta che &kappname; 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à &kappname;. Per modificare questo, deselezionare l'opzione corrispondente nella finestra Suggerimento del giorno.

I suggerimenti possono essere letti quando si vuole, selezionando Suggerimento del giorno dal menu Aiuto di &kappname;.

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

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

## La finestra principale

La finestra principale La finestra principale

La finestra principale di &kappname; 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 &kappname;; permettono di Creare file e configurare il funzionamento di &kappname;.

Il selettore della vista consiste in almeno undici icone nella parte sinistra della finestra principale, in base ai programmi installati nel sistema in uso. Varie estensioni possono aggiungere delle icone. Facendo clic su un'icona, la vista visualizzata nella parte destra diventa quella selezionata. Ogni vista fornisce una propria rappresentazione della situazione finanziaria e permette di vedere o modificare le informazioni.

Il selettore della vista contiene 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 transazioni pianificate Transazioni pianificate: le bollette e le entrate 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 &kappname;.

- 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 delle previsioni sui conti e sulle categorie.

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

## Creazione di un nuovo file

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

Per creare un nuovo file si può selezionare File Nuovo dal menu o scegliere l'icona Nuovo dalla barra degli strumenti.

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

Pagina dei dati personali Pagina dei dati personali

Tutti i campi sono opzionali, quindi è possibile usare &kappname; senza inserire nessuna informazione in questo momento. Le informazioni inserite qui servono solo a personalizzare il tuo file dati. In futuro, potrebbero essere usate per i report e l'online banking. Se alcuni campi diventeranno obbligatori nelle prossime versioni di &kappname; e adesso vengono lasciati vuoti, verranno 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 &kappname;.

&kappname; 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. &kappname; selezionerà la valuta predefinita in base alle impostazioni della lingua.

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 &kappname; è 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 &kappname; 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 vuole impostare 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 il gruppo di conti desiderato. Usando &Ctrl;e &Shift;, insieme al &LMB;, è possibile selezionare diversi gruppi di conti, anche di nazioni diverse. Verrà visualizzata un'anteprima della gerarchia dei conti. Se non si trova un gruppo di conti che corrisponde alle proprie esigenze, non selezionare nulla.

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

La pagina successiva della procedura guidata permette di impostare le preferenze. Premere Avanti quando si vuole continuare.

Pagina delle preferenze Pagina delle preferenze

L'ultima pagina della procedura guidata permette di selezionare il nome del file che verrà usato per memorizzare i dati finanziari. Verrà proposto un nome predefinito costruito a partire dalla propria cartella principale e dal nome utente. Se il file esiste già, verrà 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 &kappname; creerà il file e lo aprirà.

## Creazione di conti

È possibile creare un conto in due modi, entrambi descritti qui:

Usando il menu

  Per creare un conto usando il menu, selezionare Conto Nuovo conto....

Usando la vista dei Conti

  Per creare un conto utilizzando la vista dei conti, fare clic sull'icona dei Conti nel selettore della vista, poi fare clic con il tasto destro del mouse sull'icona dell'albero delle Attività e selezionare Nuovo conto dal menu contestuale. L'albero delle Attività contiene tutti i conti relativi alle attività. Le attività e gli altri tipi di conto sono spiegati in dettaglio più avanti in questo manuale.

È bene notare che &kappname; usa molto i menu contestuali, in tutto il programma. Se non riesci a capire come fare qualcosa, prova a fare clic con il &RMB; dove ti aspetti di avere una certa funzione.

Creando un nuovo conto con uno dei due metodi descritti si aprirà la finestra Procedura guidata di creazione di un nuovo conto. Questa procedura ti guiderà passo passo nel processo di creazione di un nuovo conto, richiedendoti man mano le informazioni necessarie. Per spostarti tra le pagine fai clic sui pulsanti Indietro e Avanti.

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

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

## 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 &kappname; in modo da inserire automaticamente una transazione quando si viene pagati.

Per gestire le pianificazioni, fare clic sull'icona Pianificazioni 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 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 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, &kappname; può importare le transazioni dei conti, se sono nel formato 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

&kappname; 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, usando l'icona Trova o selezionando Trova transazione dal menu Modifica.

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. Poi fare clic sull'icona Riconcilia della barra degli strumenti o selezionare Riconcilia dal menu Conto.

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 &kappname; è 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 &kappname;. Il metodo consigliato è quest'ultimo, perché se &kappname; 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 usando &kappname;, selezionare Copia di sicurezza dal menu File ed inserire la cartella in cui si vuole copiare 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 la copia di sicurezza e fare clic su OK.

Il file verrà 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 &kappname;

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

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

### `kmymoney -n`

L'opzione -n indica a &kappname; di non riaprire l'ultimo file aperto. Questo può essere utile se il programma va in crash all'avvio.

### `kmymoney <file>`

Se si passa a &kappname; un file sulla riga di comando, verrà aperto quel file al posto dell'ultimo file aperto. Si può specificare qualsiasi file di &kappname;, come descritto nella sezione sui formati di file, o un file GnuCash, che verrà importato.

## Come spostare &kappname; 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 &kappname;. Il nome del file è mostrato nella barra del titolo quando &kappname; è 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 dalla riga di comando che dal menu File Apri.... Dovrebbe essere inoltre possibile passare 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 &kappname; 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, &kappname; 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 .kde4 all'interno della propria cartella home.

#### Spostare le impostazioni delle estensioni

Se hai eseguito una qualsiasi estensione di &kappname;, 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.

Queste istruzioni riguardano lo spostamento dei dati e delle impostazioni di &kappname;. Tuttavia, potrebbero esserci elementi importanti che sono memorizzati da &kde; e non da &kappname;, 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 o commenti di carattere generale su &kappname;, è disponibile una lista di distribuzione per gli utenti &userlist;. In aggiunta, è possibile contattare gli sviluppatori tramite la lista di distribuzione &devlist;.

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

### Segnalare gli errori

Per segnalare un bug, usa l'interfaccia fornita da &kmymoney;: seleziona Aiuto Segnala un bug e inserisci le informazioni richieste. In caso tu abbia delle difficoltà con questo metodo, puoi segnalare un bug (o richiedere miglioramenti o nuove funzionalità) direttamente alla pagina di segnalazione dei bug di &kde;. I bug segnalati devono essere associati al prodotto kmymoney4. kmymoney2 è specifico per i bug nelle versioni 1.0.x dell'applicazione, e poiché queste versioni non sono più supportate, non può essere utilizzato per nuove segnalazioni di bug.

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 http://issues.apache.org/bugwritinghelp.html (in inglese). Generalmente, basta seguire queste regole:

##### Includere informazioni sul sistema in uso

La funzione 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 includere la versione del sistema operativo utilizzato (&Linux;, &MacOS; o &Windows;), la versione di &kde; e di &kappname;, 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 &kappname; è 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, &kappname; è 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 &kappname; 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 &kappname; a diventare più stabile possibile, questo è il modo migliore per farlo, a parte trovare il problema nel sorgente e inviare una patch.