&Allan.Anderson; &Allan.Anderson.mail;

# Estensione di importazione CSV

## Motivi per importare file CSV

In generale, è preferibile importare OFX. Tuttavia, non tutti gli istituti forniscono dati in tale formato. I file CSV (valori separati da virgole) sono quasi sempre disponibili, a volte descritti come file Excel o fogli elettronici. Inoltre, possono essere creati abbastanza facilmente raccogliendo i dati che si desidera importare, ad es. in un file di testo, e modificandoli manualmente.

L'obiettivo principale di questa estensione è l'importazione dei dati dagli estratti conto bancari, ma è presente anche la possibilità di importare alcuni documenti di investimento. Questa estensione è stata inizialmente creata, prima di diventare uno strumento di importazione CSV, per produrre file QIF da CSV, che possono essere poi importati. Questa funzionalità è ancora presente, ma sarà probabilmente rimossa, poiché l'estensione ora pone l'attenzione sull'importazione diretta dei file CSV. Inoltre, &kmymoney; ha una funzione nativa di esportazione di file QIF, perciò non esiste una vera ragione per produrre un file QIF da un file CSV.

## Ottenere l'estensione

&kmymoney; importerà i file CSV. Questa funzionalità è fornita come estensione, e ora è integrata nel programma principale, sia nei pacchetti delle distribuzioni che nel codice sorgente. Una volta che il pacchetto della distribuzione è installato, o il codice sorgente compilato e installato, la voce di menu per importare file CSV sarà mostrata automaticamente nel menu File Importa.

L'estensione di importazione CSV è più recente dell'estensione OFX, ma la maggior parte delle distribuzioni hanno già lo strumento di importazione CSV integrato o disponibile come pacchetto separato. Assicurarsi che sia abilitato in &kmymoney;. Controllare il menu Impostazioni Configura KMyMoney Estensioni. Se lo strumento di importazione CSV non sembra essere installato nella propria versione, il primo posto da controllare è lo stesso dal quale è stato preso il pacchetto base di &kmymoney;. Vedere se una versione più recente è disponibile o se lo strumento di importazione è disponibile come pacchetto separato.

In caso di installazione da RPM o Deb, l'estensione di importazione CSV dovrebbe essere contenuta nel pacchetto di &kmymoney;. In caso di compilazione da sorgenti, non ci dovrebbero essere requisiti aggiuntivi. Il processo di compilazione di &kmymoney; dovrebbe rilevare i sorgenti dell'estensione e compilare l'estensione.

## Importare un file CSV

Per importare un file CSV, scegliere lo strumento di importazione dalla barra dei menu: File Importa CSV.... Se CSV non compare sotto Importa, l'estensione di importazione CSV non è installata correttamente. Vedere la sezione precedente.

Lo strumento di importazione CSV si presenta come una procedura guidata, con una pagina separata per ogni singolo passaggio del processo. Potrebbero esserci alcune piccole differenze tra il testo in questo manuale, le etichette nelle schermate, e le etichette effettivamente visualizzate nella procedura guidata. In questi casi, il manuale descrive il modo in cui la procedura si presenterà nella versione successiva.

### Procedura di importazione CSV: Inizio

All'avvio, lo strumento di importazione CSV visualizza la pagina Inizio. L'area superiore, dove i dati sono visualizzati, è vuota all'inizio. Sotto, a sinistra, c'è un elenco delle fasi del processo di importazione, con quello attuale evidenziato. A destra ci sono delle brevi istruzioni e due pulsanti radio, che consentono di scegliere tra Servizi bancari e Investimento. Accanto si trova un riquadro di selezione del profilo, che è abilitato una volta che i pulsanti radio sono stati selezionati. Nella parte inferiore dello schermo, ci sono pulsanti per passare alla fase successiva della procedura guidata, Indietro per tornare alla fase precedente o Annulla per annullare l'importazione. Nella fase iniziale, c'è anche un pulsante Seleziona file per selezionare subito il file da importare.

Inoltre, notare la casella di selezione Salta la configurazione accanto al selettore del profilo. Inizialmente, non si dovrebbe selezionare questa casella. Dopo aver configurato un profilo e completata la procedura guidata, questi parametri sono salvati nel file delle risorse. La prossima volta che si utilizza lo stesso profilo, i parametri saranno caricati nell'interfaccia. La procedura guidata si soffermerebbe sulle pagine di parametri seguenti che non dovrebbero essere oggetto di modifica. Perciò, una volta soddisfatti di un profilo, potrebbe essere utile marcare questa casella. La procedura guidata salterà direttamente alla pagina finale, e, assumendo che non siano rilevati errori, basterà fare clic su Importa.

Selezionare prima Servizi bancari o Investimento, poi fare clic nel riquadro selezionato, che visualizza «Aggiungi nuovo profilo». Avendo creato dei profili in precedenza, è possibile selezionare uno di quelli, altrimenti digitare il nome di un nuovo profilo, possibilmente il nome del conto nel quale si desidera importare. Se si digita il nome di un nuovo profilo, premere &Enter; per crearlo. Poi, fare clic su Seleziona file, e si aprirà una finestra del selettore dei file, dalla quale si può selezionare il file CSV che si desidera importare.

### Procedura di importazione CSV: Separatori

La procedura guidata avanzerà alla pagina Separatori, dove sarà possibile vedere i propri dati.

Potrebbe sembrare che le voci visualizzate nella sezione superiore della finestra dell'estensione siano modificabili, e, infatti, potrebbero esserlo, ma qualsiasi modifica non viene salvata. La tabella ha solo funzione di visualizzazione, non di modifica. Il file in ingresso non viene mai alterato dall'estensione, e i dati effettivamente importati sono presi dal file, non dalla visualizzazione. L'unica eccezione a questa regola è descritta successivamente in Strumenti finanziari e simboli.

L'estensione dovrebbe aver rilevato il corretto Separatore di campo da utilizzare, e, di solito, non è possibile selezionare un altro. Infatti, se si prova a farlo, si reimposteranno tutte le scelte già fatte per qualsiasi campo. C'è anche un selettore per il Delimitatore di testo, ma, in genere, i doppi apici sono corretti. Ora fare clic sul pulsante Avanti. In base alla selezione effettuata in precedenza, ci si troverà nella pagina Servizi bancari o nella pagina Investimento.

### Procedura di importazione CSV: Servizi bancari

In questa pagina, selezionare i numeri di colonna dai quali importare i campi rilevanti.

Per la maggior parte dei campi, è sufficiente utilizzare il menu a tendina appropriato per selezionare la colonna appropriata. Tuttavia, ci sono alcune considerazioni particolari.

- Al centro sono presenti due pulsanti radio. Se il proprio file ha una colonna singola per tutti i valori, selezionare Colonna Totale. Tuttavia, se sono presenti colonne separate per debiti e crediti, selezionare Colonna Debito/Credito. Ciò abiliterà il selettore Colonna Totale o i selettori Colonna Debito e Colonna Credito.

- È possibile selezionare più di una colonna per il campo Promemoria, per selezioni consecutive. Le colonne Promemoria già selezionate sono marcate nell'elenco a tendina con un asterisco (*). Se si selezionano più colonne in questo modo, il loro contenuto sarà concatenato nel campo Promemoria.

- Se si prova a scegliere lo stesso numero di colonna per due campi, l'estensione restituirà un avviso e cancellerà entrambi le selezioni. Tuttavia, è possibile, se lo si desidera, utilizzare la stessa colonna nei campi Beneficiario/Descrizione e Promemoria. Se si seleziona una colonna per il campo Beneficiario/Descrizione e poi si seleziona la stessa colonna per il campo Promemoria, si riceverà un avviso che sono state selezionate colonne duplicate, ma che chiederà se si vuole continuare, fare clic su Sì.

- Una ragione particolare per copiare il campo Beneficiario/Descrizione nel campo Promemoria è che il campo Beneficiario/Descrizione potrebbe essere modificato completamente in fase di importazione quando &kmymoney; verifica la corrispondenza delle transazioni. La selezione di tale campo anche come Promemoria preserverà tali dati, che andrebbero altrimenti persi.

Se si ritiene di aver effettuato una scelta non corretta, basta cambiare tale selezione. Se sono state eseguite diverse modifiche, fare clic sul pulsante Cancella.

Una volta scelte le colonne per tutti i campi necessari, il pulsante Avanti sarà abilitato, e il clic su di esso permetterà di avanzare nella procedura guidata.

### Procedura di importazione CSV: Investimento

Questa pagina è simile alla pagina Servizi bancari, anche se leggermente più complessa. La maggior parte delle scelte è abbastanza ovvia, ma ci sono degli elementi che possono generare confusione fino a che non si sia completata la procedura una o due volte.

- Come nella pagina Servizi bancari, è possibile selezionare più di una colonna per il campo Promemoria

- Il selettore Tipo/Azione serve a identificare la colonna che contiene il tipo di azione, come Acquisto, Vendita, Dividendo, &etc;.

- Il selettore Frazione del prezzo indica la frazione/moltiplicatore per la compatibilità tra prezzi importati e archiviati. Ad esempio, se il prezzo del file da importare è espresso in centesimi, ma il proprio conto di &kmymoney; è in euro, selezionare 0,01. Se il file di dati di &kmymoney; è espresso in euro e lo è anche il file CSV da importare, impostare Frazione del prezzo a 1,0.

- Utilizzare il selettore Colonna dei pagamenti se il proprio file ha una colonna separata per i pagamenti. Bisogna prestare attenzione, comunque, al fatto che i pagamenti potrebbero essere stati contabilizzati nel prezzo. Se c'è un pagamento, sotto forma di percentuale, invece che di valore. Notare ciò su questa pagina, è il solo campo che include esplicitamente «colonna» nell'etichetta, per evidenziare che è per la colonna dei pagamenti, non un pagamento qualsiasi.

- Sotto i selettori di colonna si trovano due aree per l'identità degli strumenti finanziari. In base all'intermediario o all'istituto finanziario, il proprio file potrebbe contenere voci per uno solo o per diversi strumenti finanziari.

  - Se il file contiene transazioni per un singolo strumento finanziario, con il nome in una possibile riga di intestazione, il nome dovrebbe essere digitato nel riquadro Nome dello strumento finanziario. Il nome digitato sarà aggiunto all'elenco a tendina per usi futuri. Si potrebbe voler rimuovere in seguito il nome dall'elenco. Per fare ciò, selezionarlo, fare quindi clic sul pulsante Nascondi strumento finanziario. Ciò lo rimuoverà solo da questo elenco, e non ha effetto sul file principale di &kmymoney;.

  - Se il file include transazioni con diversi strumenti finanziari, ognuno sarà identificato dal suo simbolo del ticker in una colonna e con altri dati in un'altra colonna. Seleziona queste colonne nei selettori Simbolo e Dettagli. Potrebbe capitare che uno strumento finanziario non abbia un simbolo ufficiale, e, in questo caso, potrebbe essere inventato uno pseudo-simbolo; ciò non costituisce un problema, dato che identifica quello strumento unicamente nel file di importazione. A volte, il tipo di attività effettivo è integrato nella colonna dei dettagli, probabilmente con del testo standard come prefisso. Ad esempio, se il campo contiene tipo: dividendo, digitare nel riquadro Testo del filtro tipo: con lo spazio alla fine.

Quando tutti i campi richiesti sono selezionati, il pulsante Avanti sarà abilitato, e facendo clic su di esso si avanzerà nella procedura guidata.

### Procedura di importazione CSV: Righe

In questa pagina, è possibile indicare se le righe all'inizio o alla fine del file devono essere ignorate. Si può indicare inoltre il formato delle date.

### Riga iniziale

Impostare questa opzione in modo che lo strumento di importazione salti le righe di intestazione nel file. La scelta sarà salvata in questo profilo per gli usi futuri. Le righe iniziali e finali interagiscono, e la riga iniziale non dovrebbe essere maggiore della riga finale. Se il selettore Riga iniziale non risponde, controllare l'impostazione della riga finale.

### Riga finale

Lo strumento di importazione lo imposterà automaticamente all'ultima riga del file, o all'ultima impostazione salvata. Sarà necessario solo regolarlo se nel file ci sono righe di piè di pagina che lo strumento di importazione dovrebbe ignorare. Altrimenti, si potrebbe ricevere un avviso di errore di dati quando l'estensione prova ad analizzare dati non corretti. Ancora, se il selettore Riga finale non risponde, controllare l'impostazione Riga iniziale.

### Formato della data

Questo deve essere impostato in base all'anno, al mese e al giorno nelle date del file. Se l'estensione trova dati non compatibili con questa impostazione, lo segnalerà quando si prova a importare. Tuttavia, se l'impostazione è errata, ma non produce risultati non validi (come date senza alcun giorno maggiore di 12, con mese e giorno che potrebbero essere scambiati) si otterranno semplicemente dati non corretti poiché l'estensione non è in grado di capire un errore del genere. In questo caso, l'errore sarà ovviamente riportato nel registro dopo l'importazione.

Una volta pronto, il pulsante Avanti sarà abilitato, e il clic su di esso permetterà di avanzare nella procedura guidata.

### Procedura di importazione CSV: Strumenti finanziari e simboli

Per un file di investimento, dopo aver accettato la pagina Righe, è necessario assicurarsi che ogni strumento finanziario nel file corrisponda allo strumento finanziario corretto nel file di &kmymoney;, prima che l'importazione possa continuare. A questo punto, si aprirà un'altra finestra che mostra gli strumenti finanziari e i simboli contenuti nel file di importazione. Notare che diversamente dalla visualizzazione dei dati nelle finestre della procedura guidata principale, le modifiche eseguite su questa pagina sono importate.

Il completamento di questa pagina è semplice, se si considerano questi elementi:

- Ogni riga rappresenta una transazione, e potrebbe sembrare che ci siano righe duplicate. Ciò non costituisce un problema.

- Ogni nome di strumento finanziario deve corrispondere esattamente allo strumento finanziario esistente come specificato in &kmymoney;. Se non corrisponde, sarà creato come un nuovo strumento finanziario, cosa che probabilmente non si desidera, a meno che rappresenti l'acquisto di un nuovo strumento finanziario.

- Un simbolo deve essere mostrato per ogni strumento finanziario.

- Le sole informazioni su questa pagina dovrebbero essere il simbolo e il nome dello strumento finanziario. Qualsiasi altra informazione mostrata inizialmente (come data o tipo di attività) è ancora nel file di importazione attuale, ma non dovrebbe essere mostrata qui.

È possibile modificare un simbolo o il nome di uno strumento finanziario facendo doppio clic sulla cella. Per ogni strumento finanziario, se necessario, modificare il nome in una delle sue righe. Se il nome corretto dello strumento finanziario appare nel file importato, fare doppio clic su di esso per selezionarlo, poi copiare e incollare/modificare, facendo attenzione nel caso in cui siano state utilizzate varianti o abbreviazioni in &kmymoney;. Se si modifica il nome di uno strumento finanziario, tale modifica sarà applicata a tutte le righe con lo stesso simbolo.

Qualsiasi riga senza un simbolo sarà trattata come elemento di un conto di intermediazione. Se una transazione implica un altro conto, ⪚ un conto corrente o di intermediazione per un dividendo ricevuto o per l'esecuzione di un pagamento, comparirà una finestra di dialogo con la richiesta di digitare il nome del conto per il trasferimento. Questo sarà, in genere, il conto di intermediazione selezionato o generato al momento della creazione del conto di investimento. Allo stesso modo, digitare il numero della colonna che contiene il beneficiario, se richiesto. Se si commette un errore al momento della digitazione del nome del conto, l'importazione continuerà, ma &kmymoney; non lo riconoscerà, e marcherà le transazioni come mancati dell'assegnazione di una categoria. Se il nome del conto richiesto è troppo lungo, digitare solo alcuni caratteri. L'importazione andrà avanti, ma &kmymoney; marcherà le transazioni come mancanti dell'assegnazione di una categoria, e sarà necessario selezionare il conto di trasferimento corretto dopo l'importazione. Fare clic su OK al termine. Il processo di importazione lascerà il posto a &kmymoney;

Se si hanno più transazioni che si riferiscono allo stesso strumento finanziario, è possibile modificarle contemporaneamente, utilizzando la selezione multipla. Ad esempio, per aggiungere un simbolo a diverse righe, premere e mantenere il tasto&Ctrl;, e nella colonna dei simboli, selezionare ogni transazione. Mentre si trattiene il tasto &Ctrl;, tutte le celle dei simboli dovrebbero essere ancora selezionate, quindi fare clic su una di esse e digitare il simbolo. Fare clic all'interno della finestra, ma fuori dalla colonna, o premere &Enter; (non OK). Ora che le tutte le transazioni hanno lo stesso simbolo, fare doppio clic su una voce dei dettagli e modificare il nome dello strumento finanziario come si desidera. Fare clic in un punto qualsiasi della finestra (o &Enter;) per accettare la modifica, che si applicherà a tutte le voci. Le voci rimanenti mostreranno i simboli presenti nelle transazioni nel file di importazione.

Ora fare clic su OK, poi su Importa. Nel riquadro Inserisci conto, digita il nome di un conto di intermediazione/corrente per denaro. Se digiti un nome valido, il conto sarà utilizzato. Se non si desidera avere problemi digitando un nome corretto, ma lungo, digitare pochi caratteri. L'importazione lo accetterà, ma le transazioni nel registro dopo l'importazione richiederanno la selezione di un conto appropriato. Per il riquadro Elemento d'intermediazione, digitare il numero della colonna che contiene tale informazione. Ora, nel riquadro Transazione non valida si potrebbero ottenere poche voci poiché il tipo di attività non corrisponde alla combinazione quantità/prezzo/importo. In ogni messaggio, fare clic su Seleziona il tipo di transazione, e un elenco a tendina apparirà indicando i tipi di attività validi per quella combinazione di valori.

Ora l'importazione è avvenuta e si è in KMM per selezionare il conto di investimento da utilizzare. Poi il conto corrente, se erano presenti transazioni di intermediazione.

### Procedura di importazione CSV: Fine

Una volta raggiunta la pagina finale, l'estensione convalida automaticamente i valori. Se le colonne con valore numerico sono evidenziate in verde, la convalida è avvenuta correttamente e tutto ciò che rimane da fare è fare clic su Importa CSV e il controllo passerà al programma principale di &kmymoney;. Tuttavia, se le righe iniziali e finali non sono impostate correttamente, o se sono selezionate le colonne sbagliate, l'evidenziazione sarà in rosso, e un messaggio di errore apparirà indicando dove è l'errore. L'utente dovrà quindi fare clic su Indietro per raggiungere la pagina in cui correggere l'errore.

Potrebbe inoltre verificarsi che se si utilizzano le colonne di debito e credito, una di queste colonne potrebbe legittimamente non contenere alcuna voce. Ciò significa che la colonna non conterrebbe simboli decimali, e potrebbe essere generato un avviso. Se ciò si verifica, è possibile fare clic sui pulsanti Accetta (Accetta questo o Accetta tutto).

### Simbolo decimale

Un altro possibile problema potrebbe essere rappresentato dalla selezione del simbolo decimale non corretto. La selezione del simbolo che corrisponde ai dati dovrebbe far sparire l'errore. Di solito, non dovrebbe essere necessario cambiare questa selezione. Notare che il simbolo decimale deve essere impostato per verificare il proprio file, non la propria localizzazione. Se le impostazioni di localizzazione hanno un valore diverso, si verificherà la conversione. La visualizzazione del file nella parte superiore della finestra mostrerà i campi numerici evidenziati in verde se le impostazioni attuali producono risultati validi, altrimenti in rosso. L'evidenziazione riflette inoltre l'impostazione della riga iniziale e della riga finale. Potrebbero esserci degli avvisi se una delle celle selezionate non contiene il simbolo scelto.

### Simbolo delle migliaia

Non è necessario selezionarlo, poiché è impostato automaticamente sulla base del simbolo decimale. Viene fornito esclusivamente come guida. In aggiunta, il selettore sarà inattivo se nessuno dei valori da importare è maggiore o uguale a 1000.

### Importare CSV

Il clic su questo pulsante dice all'estensione di importare effettivamente i dati dal file, sulla base delle scelte fatte in precedenza. &kmymoney; chiederà di specificare in quale conto si desidera importare i dati.

### Creare file QIF

Questo pulsante offre la possibilità, dopo che l'importazione sia stata completata, di salvare i dati del file csv come un file qif, nel caso dovesse servire per qualsiasi motivo. Questa era la funzionalità originale che ha portato alla creazione di questa estensione. Tuttavia, poiché &kmymoney; è ora in grado di esportare in file qif, questa funzionalità è ora scarsamente utile e potrebbe essere rimossa in futuro.

### Terminare

Per un'importazione in Servizi bancari, l'estensione ha terminato, e &kmymoney; richiederà, come detto in precedenza, il conto nel quale importare i dati. Per un'importazione in Investimento, tuttavia, potrebbe essere richiesto dell'altro. Se, durante l'importazione di una transazione, l'estensione non trova tipo di transazione validi, visualizzerà la transazione problematica, e l'utente potrà selezionare un tipo valido da sostituire, in base alla combinazione dei valori di quantità, prezzo e importo. Per ogni transazione, l'estensione convaliderà il contenuto delle colonne per assicurare che corrisponda al tipo di azione. Ad esempio, se è presente una quantità, ma non un prezzo o un importo, si assume che la transazione possa essere solo di tipo Aggiungi o Rimuovi quote. Oppure, se c'è un importo, ma non una quantità o un prezzo, si assume che sia un Dividendo, &etc;.

Se si desidera salvare le impostazioni, ricordarsi di fare clic sul pulsante Fine, e l'estensione sarà chiusa.

### Aggiungere i tipi di attività di investimento

Se i propri documenti di investimento continuano a includere tipi di attività non riconosciute, basta aggiungerli alla sezione nel file delle risorse. (Vedere sotto per ulteriori dettagli su questo file). Ad esempio, nella sezione [InvestmentSettings] del file, il campo BuyParam include voci per Purchase, Buy, New Inv e Switch In. Se si trova una voce diversa, aggiungerla all'elenco corretto e riavviare l'estensione. Si potrebbero notare delle somiglianze tra le voci dei diversi campi, e riscontrare che il tipo di attività errato sia stato selezionato. L'estensione controlla questi elenchi nel seguente ordine: Shrsin, DivX, Reinvdiv, Brokerage, Buy, Sell, Remove. Cambiando l'ordine degli elenchi per risolvere il problema potrebbe non funzionare come previsto, poiché le voci nel file delle risorse è organizzato in ordine alfabetico. Se il parametro problematico è uno non necessario, sarà sufficiente eliminarlo dal file. Se ciò non è possibile, potrebbe essere necessario modificare il proprio file prima dell'inserimento.

### Configurazione dell'estensione di importazione CSV

Un svantaggio ben noto del formato QIF sta nel fatto di essere un formato abbastanza vago. Lo stesso problema interessa i file CSV, anche maggiormente, con una mancanza totale di standard concordati. Con i file di investimento, in particolare c'è un ambito di variazione maggiore nella specifica dei diversi tipi di attività rappresentati nei dati. L'estensione gestisce questo problema elencando questi tipi di attività in un file di risorse, chiamato csvimporterrc. La posizione di questo file dipende dalla propria distribuzione. Normalmente, è posizionato in ~/.kde4/share/config/, o in ~/.kde/... diversamente. L'utilizzo di questo file di risorse consente all'utente di aggiungere un tipo di attività che lo sviluppatore non ha considerato. Se il file non esiste alla prima esecuzione dello strumento di importazione, l'estensione creerà una versione predefinita, che contiene alcune delle descrizioni più comuni.

Diversi esempi di file csv sono forniti (nella cartella kmymoney/contrib/csvimporter/ dell'albero dei sorgenti) nella speranza che possano essere d'aiuto. Ad esempio, per gli investimenti, un tipo di attività è "ReInvestorContract Buy : ReInvested Units". Nel processo di convalida, la prima corrispondenza è su ReInv in ReInvestorContract Buy, perciò la transazione viene classificata come Reinvdiv, anche se Buy è menzionato. Un altro esempio che è stato osservato è un tipo di attività di Reinvest, anche se la transazione non includeva né il prezzo, né il totale, ma solo una quantità, perciò doveva essere trattata come Aggiungi quote, o Shrsin.

Quando questa estensione è stata creata, sono stati presi ad esempio solo alcuni formati di investimento, e potrebbe accadere di incontrarne uno che non può essere gestito correttamente. Se si trova un file del genere, inviare un esempio appropriato (modificato per rimuovere o sostituire le informazioni personali) alla lista degli utenti &userlist; di &kmymoney; o alla lista degli sviluppatori &devlist;, lo sviluppatore farà il suo meglio per modificare l'estensione affinché possa gestirlo.