Bij starten, toont het CSV-importprogramma de pagina Start of Bestand. Links is een lijst met de stappen van het importproces, met de huidige geaccentueerd. Het gebied rechtsboven is waar te importeren gegevens getoond zullen worden; Voordat toont het enige beknopte instructies relevant voor het huidige stadium van de assistent. Daaronder is een set keuzerondjes voor het selecteren van het type te importeren gegevens. Die lijst omvat Bankieren, Investeringen, Valutakoersen en Aandelenkoersen. Verder is er een afrollijst profielkiezer, die is ingeschakeld als eenmaal het keuzerondje is geselecteerd voor een van de typen importbestanden.

Elk type te importeren CSV-bestand vereist specificatie van verschillende details met betrekking tot de verwachte formattering van de gegevens, zoals beschreven in de volgende secties. Niet alleen verschillen de details voor de verschillende typen te importeren gegevensbestanden, het is mogelijk nodig verschillende configuraties voor hetzelfde type gegevens uit verschillende bronnen nodig te hebben. Dus u hoeft niet al die details in te voeren elke keer dat u een bestand importeert, het CSV-importprogramma biedt u het eenmaal specificeren van de details en ze op te slaan in een genoemd profiel.

De naam van een CSV-importprofiel is volledig willekeurig, maar zal gemakkelijk te onthouden zijn als het beide het type te importeren gegevens (bank, creditcard, investering, ...) en de bron van de gegevens weergeeft. Er is geen noodzaak om de rekening waarin de gegevens geïmporteerd worden weer te geven en het is mogelijk om hetzelfde profiel te gebruiken voor het importeren in meer dan één rekening, zoals twee dagelijkse rekeningen bij dezelfde bank.

De afrollijst voor profielkeuze omvat de namen van alle CSV-importprofielen die u eerder hebt aangemaakt en het laat u ook de naam van een nieuw profiel typen. Onder de afrollijst voor profielkeuze zijn er drie knoppen. Wanneer u op Toevoegen klikt, die altijd is ingeschakeld, zal een nieuw profiel aangemaakt worden met de naam ingevoerd in de afrollijst. Er zal niets gebeuren als dat veld leeg is of het toont de naam van een bestaand profiel. Terwijl u verder gaat door de rest van de CSV-importassistent, zullen de verschillende configuratie-instellingen die u invoert of wijzigt opgeslagen worden in het geselecteerde profiel.

Als u eerder een of meer profielen hebt aangemaakt, dan zullen de andere twee knoppen ingeschakeld worden. Als u op Verwijderen klikt, zal het profiel genaamd in de afrollijst worden verwijderd. Als u op Hernoemen klikt, verander dan de naam getoond in de afrollijst en klik opnieuw op Hernoemen, het profiel zal overeenkomstig hernoemd worden.

Naast de kiezer van het profiel is er een keuzevak Instellingen overslaan. Initieel zou u dit keuzevakje niet moeten selecteren. Nadat u een profiel hebt ingesteld en de assistent heeft beëindigd, zijn alle ingevoerde configuratieparameters opgeslagen in het hulpbronbestand. De volgende keer gebruikt u datzelfde profiel, de parameters zullen geladen worden in het UI (gebruikersinterface). De assistent zou dan ploegen door de volgende pagina's met parameters die u niet zult wijzigen. Dus nadat u gelukkig bent met een profiel, help het u om dit vakje te activeren. De assistent zal dan direct naar de eindpagina gaan en, aangenomen dat er geen problemen zijn gevonden, hoeft u alleen op Importeren te klikken.

Onderaan is er een knop Bestand selecteren. Hier op klikken brengt een bestandskiezerdialoog om u het te importeren bestand te laten kiezen. Onderaan de overblijvende pagina's van de assistent zijn knoppen om < Terug te gaan naar de vorige stap van de assistent, verder gaan naar de volgende > stap of de import Annuleren.

Om, op de startpagina van de assistent, selecteer eerst het keuzevak voor het type gegevens dat u importeert. In de profielafrolkiezer kunt u de naam ven een eerder aangemaakt CSV-importprofiel selecteren, of voer een nieuwe naam in, mogelijk de naam van de rekening waarin u wilt importeren en klik op Toevoegen. Klik tenslotte op Bestand selecteren en een bestandsselectiedialoog zal openen, waarin u het CSV-bestand selecteert dat u wilt importeren.

Na het openen van uw geselecteerde bestand zal de assistent doorgegaan naar de pagina Scheidingstekens en u zou nu uw gegevens moeten zien.

Het CSV-importprogramma zou de juiste Codering, Veldscheidingsteken en Tekstscheidingsteken gedetecteerd moeten hebben. U kunt de codering wijzigen als het programma dat niet juist gekozen had. Als u het veldscheidingsteken moet wijzigen, zoals als uw gegevens in feite gescheiden worden door en tab en geen komma-geschieden, wees er van bewust dat dat doen elke veldkeuzes die u al gemaakt heeft reset. In het algemeen is de quote (") het juiste tekstscheidingsteken, maar u kunt het naar behoefte wijzigen. Klik op Volgende om verder te gaan.

U zou nu op de pagina Rijen of Regels moeten zijn. Hier geeft u aan of regels genegeerd zouden moeten worden aan het begin of einde van het bestand.

Deze pagina biedt u het aanpassen van de import om kop- en voetrijen aan het begin of eind van het bestand te negeren, die niet echt te importeren gegevens bevatten.

Begin bij regel. Stel dit zo in dat de importeur kopregels in het bestand overslaat. Uw keuze zal opgeslagen worden in dit profiel voor toekomstig gebruik. De start- en eindregels hebben met elkaar te maken en de startregel kan niet hoger zijn dan de eindregel, noch mag het hoger zijn dan het echte aantal regels in het bestand. Als de selectie van Startregel niet reageert, controleer dan de instelling van de eindregel.

Eindregel. De importeur zal dit automatisch op de laatste regel in het bestand zetten of op de laatst opgeslagen instelling. U hoeft het alleen aan te passen als er er regels in de voettekst zijn die de importeur zou moeten negeren. Anders is het waarschijnlijk dat u een waarschuwing gegevensfout krijgt wanneer de plug-in probeert de onjuiste gegevens te interpreteren. Opnieuw, als de selectie Eindregel niet reageert, controleer dan de instelling Startregel.

Boven deze twee velden is een keuzevakje Kop bevat rekeningnaam of -nummer. Indien geactiveerd zal het importprogramma in de regels boven de beginregel naar de naam of nummer van de te gebruiken rekening voor het importeren. Zo niet, u zult worden gevraagd voor die informatie.

Wanneer u gereed bent, klik op Volgende om verder te gaan met de volgende stap.

U zou nu op de pagina Kolommen moeten zijn. Dit is waar u het importprogramma vertelt welke kolommen in het bestand de gegevens staan die overeenkomen met de gespecificeerde velden nodig om een betekenisvol record of transactie aan te maken, afhankelijk van het type gegevens dat wordt geïmporteerd. Er is een andere versie van deze pagina voor elk type gegevens, omdat elk een andere combinatie van items vereist.

Assistent voor importeren van CSV: bankieren

Voor de meeste velden hoeft u alleen de afrollijst te gebruiken om de bijbehorende kolom te selecteren. Merk op dat veel velden een knop “x” rechts hebben. Er op klikken zal elke waarde wissen die was ingevoerd of geselecteerd in het veld links. Bovendien zijn er enige speciale overwegingen.

• Rechts is een gebied met twee tabbladen. Als uw bestand een enkele kolom heeft voor alle waarden, selecteer het tabblad Hoeveelheid. Als er echter aparte kolommen zijn voor debet en credit, selecteer het tabblad Debet/Credit.

  Op het tabblad Hoeveelheid, begin door de kolom te selecteren die de hoeveelheid van de transactie bevat. Als er een kolom is die “Credit” of “Debet” bevat om aan te geven welke hoeveelheid he is, select die kolom als de Debet/Credit-indicator. Los daarvan, als er een tekenreeks is in het veld hoeveelheid die aangeeft of de hoeveelheid een credit of een debet is, voer die tekenreeks in in het bijbehorende veld Indicator. Tenslotte, als ondanks juist instellen van alle bovenstaande waarden, de geïmporteerde hoeveelheid omgekeerd is van wat het zou moeten zijn, activeer het keuzevakje Tegengesteld teken.

  Op het tabblad Debet/credit, voer eenvoudig de getallen in van de kolommen met deze waarden in de bijbehorende velden.

• Het is mogelijk om meer dan één kolom voor het memo-veld te selecteren, door opvolgende selecties te maken. Reeds geselecteerde memo-kolommen worden in het veld Memo-kolommen: aangegeven. Als u meerdere kolommen op deze manier selecteert zal hun inhoud geconcateneerd worden in het memo-veld.

• Als u probeert om hetzelfde kolomnummer te kiezen voor twee velden, zal het importprogramma u attent maken en beide selecties wissen. Het is echter mogelijk, indien gewenst, om dezelfde kolom in beide velden Begunstigde/Beschrijving en Memo. Als u een kolom selecteert voor het veld Begunstigde/Beschrijving en daarna dezelfde kolom voor het veld Memo, dan zult u een waarschuwing krijgen dat dubbele kolommen zijn geselecteerd, maar vragen of u door wilt gaan. Zo ja, klik op Ja en de kolom zal gebruikt worden door beide velden.

• Een speciale reden om ook het veld Begunstigde/Beschrijving in het veld Memo te vangen is dat het inkomende veld Begunstigde/Beschrijving volledig gewijzigd kan worden bij importeren wanneer KMyMoney transacties overeen laten komen doet. Dat veld ook als Memo selecteren zal die gegevens veilig stellen, die anders verloren zouden gaan.

Als u merkt dat u een onjuiste keuze hebt gemaakt, wijzig gewoon die selectie. Als er meerdere wijzigingen gemaakt moeten worden, kunt u klikken op Alles wissen en opnieuw beginnen.

Nadat kolommen zijn gekozen voor alle noodzakelijke velden zal de knop Volgende ingeschakeld worden en er op klikken zal de assistent laten doorgaan.

CSV-importassistent: formaat

De volgende pagina van de assistent toont nog steeds bovenaan de te importeren gegevens, maar de lagere sectie biedt drie afrolmenu's. De initiële waarden zijn ingesteld door KMyMoney gebaseerd op het onderzoeken van de actuele gegevens.

Het Decimale symbool is standaard “auto”, wat gewoonlijk de juiste resultaten produceert. Zo niet, dan kunt u expliciet de “punt” of “komma” specificeren.

Het Duizendensymbool is automatisch gezet en het veld kan uitgeschakeld zijn als het de resultaten niet beïnvloedt.

Dit moet ingesteld worden volgens de volgorde van jaar, maand en dag in de datums in het bestand. Als de plug-in gegevens vindt die incompatibel zijn met deze instelling zal het klagen wanneer u het probeert te importeren. Als de instelling echter fout is, maar het geen gedetecteerde ongeldige resultaten produceert (zoals gegevens zonder dagen hoger dan 12, dus maand en dag kunnen verwisseld zijn) dan zult u eenvoudig onjuiste gegevens krijgen, omdat de plug-in niet kan weten dat u een fout maakte. In dit geval zal de fout helder zijn in het grootboek na importeren.

Het Datumformaat specificeert de volgorde van dag, maand en jaar en wordt ook automatisch gezet. In sommige gevallen echter, zoals gegevens met geen dag hoger dan 12, dan zult u het probleem na het importeren merken. In zulke gevallen zult u het importeren moeten herhalen en de actuele volgorde van de datumcomponenten kiezen.

Assistent voor importeren van CSV: investeringen

Deze pagina is vergelijkbaar met de pagina Bankieren, hoewel het wat complexer is. De meeste keuzes zijn tamelijk duidelijk, maar er zijn enige items die verwarrend lijken totdat u het proces een of twee keer hebt doorlopen.

• Zoals op de pagina Bankieren kunt u meer dan een kolom kiezen voor het veld Memo

• De selectie Type/Actie is voor het identificeren van de kolom die het type actie bevat, zoals Kopen, Verkopen, Dividend, etc.

• De selector Prijsfractie is om de fractie/vermenigvuldiger aan te geven voor compatibiliteit tussen geïmporteerde en opgeslagen prijzen. Als het importbestand prijzen in centen bevat, maar uw rekening in KMyMoney is geprijsd in dollars, selecteer dan 0,01. Of, als uw gegevensbestand in KMyMoney prijzen heeft in dollars en ook het CSV-bestand dat geïmporteerd wordt, zet dan de Prijsfractie op 1,0.

• Er zijn twee manieren om kosten voor transacties te specificeren. Als uw bestand een aparte kolom heeft voor kosten, gebruik de kiezer Vrije kolom. Merk op dat op deze pagina, dit het enige veld is om expliciet "kolom" in de label op te nemen, om te accentueren dat het voor de kolom Kosten is, niet voor actuele kosten. Let op, echter, dat met de kosten al rekening gehouden kan zijn in de prijs.

  Als er kosten zijn, maar het is een percentage, in plaats van een gespecificeerde waarde, klik op het keuzevakje Kosten is percentage en voer het percentage in in het veld Kostenpercentage. Daarnaast, als er een minimum percentage is, specificeer het in het veld Minimaal percentage, die wordt ingeschakeld wanneer u het Kostenpercentage invoert (met een decimale punt). Op dit punt, klikken op Kosten berekenen zal een kolom toevoegen rechts van de bovenstaande tabel en zal de berekende kosten voor elke transactie aangeven.

  Als u een vergissing maakte in invoeren van de kosteninformatie, klikken op Kosten wissen zal alle aan de kosten gerelateerde velden restten naar hun initiële waarden.

• Onder de selectie van een kolom zijn twee gebieden voor de identiteit van van het waardepapier. Afhankelijk van uw makelaar of financieel instituut, kan uw bestand items bevatten voor slechts één of voor meerdere waardepapieren.

  • Als het bestand transacties bevat voor een enkel waardepapier, met de naam mogelijk in een koprij, dan zou de naam ingevoerd moeten worden in het vak Naam waardepapier. De naam die u invoert zal toegevoegd worden aan de afrollijst voor later gebruik. U zou zou vervolgens deze naam uit de lijst willen verwijderen. Zo ja, selecteer deze, klik dan op Waardepapier verbergen. Dit verwijdert het alleen uit deze lijst en heeft geen effect op uw hoofdbestand van KMyMoney.

  • Als het bestand transacties bevat voor verschillende waardepapieren, zal elk worden geïdentificeerd door zijn tickersymbool in een kolom met verdere details in een andere kolom. Selecteer deze kolommen in de selecties Symbool en Detail. Het kan zijn dat een waardepapier geen officieel symbool heeft en in dat geval kan een pseudo-symbool worden bedacht; dit is geen probleem, zolang als het uniek dat waardepapier identificeert in het importbestand. Soms is het actuele activiteitstype ingebed in de detailkolom, mogelijk vooraf gegaan door een standaard tekst. Als het veld bijvoorbeeld “type: dividend” bevat, ga naar het tekstvak Filter en voer in “type: ” inclusief de achterliggende spatie.

Wanneer alle vereiste velden zijn geselecteerd, zal de knop Volgende ingeschakeld worden en er op klikken zal de assistent laten doorgaan.

Bij het bereiken van de laatste pagina zal de plug-in automatisch de waarden valideren. Als de kolommen met numerieke waarden in groen zijn geaccentueerd, dan was de validatie succesvol en alles wat nodig is is het klikken op CSV importeren en de besturing gaat over naar het hoofdprogramma van KMyMoney. Als echter de begin en/of eindregels onjuist zijn ingesteld of als de foute kolommen waren geselecteerd, dan zal de accentuering in rood zijn en er zal een foutmelding verschijnen die aangeeft in waar de fout zit. De gebruiker zal dan op Terug moeten klikken om naar de relevante pagina te gaan om de fout te corrigeren.

Het kan ook zijn dat als debet en credit kolommen gebruikt zijn, een van deze kolommen legitiem geen invoer bevat. Dit zou betekenen dat die kolom geen decimaal symbool aangeeft en dit zou resulteren in een waarschuwing. Als u ziet dat dit het geval is, dan kunt u op een van de knoppen klikken om (Dit accepteren of Alles accepteren) te accepteren.

Decimaalteken. Een ander mogelijk probleem kan zijn dat het geselecteerde decimaalteken onjuist is. Het symbool selecteren dat overeenkomt met de gegevens zou die fout moeten wissen. Normaal zou u deze selectie niet hoeven wijzigen. Merk op dat het Decimaalteken overeen moet komen met uw bestand, niet met uw regiocode. Als uw instelling voot regiocode een andere waarde heeft, zal conversie plaatsvinden. Het tonen van het bestand in het bovengedeelte van het venster zal numerieke velden in groen accentueren als de huidige instelling geldige resultaten produceert, anders in rood. Het accepteren toont ook de Beginregel en Eindregel instellingen. Er kunnen waarschuwingen zijn als elk van de geselecteerde cellen verschijnen en niet het geselecteerde symbool bevatten.

Scheidingsteken duizendtallen. Dit hoeft niet geselecteerd te zijn, omdat het automatisch is ingesteld gebaseerd op het Decimaalteken. Het wordt puur geleverd als een gids. Bovendien wordt de selector inactief als geen van de te importeren waarden groter of gelijk is aan 1000.

CSV-bestand importeren. Op deze knop drukken vertelt de plug-in om de gegevens uit het bestand echt te importeren, gebaseerd op de keuzes die u hebt bovenstaand hebt gemaakt. KMyMoney zal u vragen naar de juiste rekening waarin de gegevens te importeren.

Deze knop geeft u de mogelijkheid, nadat het importeren gereed is, om de gegevens uit het CSV-bestand als een QIF-bestand op te slaan, voor het geval u het voor geval dat u dar een reden voor hebt. Dit was eigenlijk de oorspronkelijke functionaliteit die het maken van deze plug-in dreef. Omdat KMyMoney zelf nu in staat is om een qif-bestand te exporteren, is deze mogelijkheid nu waarschijnlijk van weinig nut en kan op den duur worden verwijderd.

Voor het importeren van Bankieren is de plug-in gereed en KMyMoney zal u vragen naar, zoals boven aangegeven, de juiste rekening waarin de gegevens te importeren. Voor het importeren van een Investering kan echter iets meer zijn vereist. Als tijdens importeren van een transactie de plug-in geen geldig transactietype vindt, zal het de foute transactie tonen en de gebruiker kan een geldig type invoeren, afhankelijk van de combinatie van hoeveelheid, prijs, en aantal waarden. Voor elke transactie zal de plug-in de inhoud van de kolommen valideren om zeker te stellen dat ze overeenkomen met het actietype. Als er bijvoorbeeld een hoeveelheid verschijnt maar geen prijs of aantal, wordt er aangenomen dat de transactie alleen een Toevoegen of Verwijderen van aandelen is. Of, als er een aantal is maar geen hoeveelheid of prijs, dan wordt een Dividend aangenomen, etc.

Als u uw instellingen wilt opslaan, vergeet dan niet om op Beëindigen te klikken en de plug-in zal dan sluiten.

Als u vindt dat uw investeringsafschriften typen activiteiten blijven invoegen die niet herkend worden, voeg ze dan eenvoudig toe aan de sectie in het hulpbronbestand. (Zie onderstaand voor meer details over dit bestand.) In de sectie [InvestmentSettings] van het bestand, bevat het veld BuyParam items voor Purchase, Buy, New Inv en Switch In. Als u een andere vindt, voeg deze toe aan de juiste lijst en start de plug-in opnieuw. U merkt misschien op dat er overeenkomsten zijn in de items in verschillende velden en u vindt misschien dat het verkeerde type activiteit wordt geselecteerd. De plug-in gebruikt deze lijsten in de volgende volgorde: Shrsin, DivX, Reinvdiv, Brokerage, Buy, Sell, Remove. De lijsten opnieuw ordenen om dit te verbeteren werkt niet zoals verwacht kan worden, omdat de items in het hulpbronbestand gesorteerd wordt in alfabetische volgorde. Als de parameter met problemen diegene is die u niet nodig hebt, verwijder deze dan gewoon uit het bestand. Als dat niet mogelijk is, dan kan het nodig zijn om uw bestand te bewerken alvorens het als invoer te gebruiken.

Een welbekend nadeel van het QIF-formaat is dat het een tamelijk los formaat is. Met CSV-bestanden bestaat het zelfde probleem, zelfs meer, omdat er helemaal geen overeengekomen standaard is. Speciaal met investeringsbestanden is er veel meer ruimte voor variatie in het specificeren van de verschillende typen activiteiten gerepresenteerd in de gegevens. De plug-in behandelt dit door een lijst met deze typen activiteiten in een hulpbronbestand, genaamd csvimporterrc. De locatie van dit bestand hangt af van uw besturingssysteem of distributie. Op een Linux® systeem zal dit in $KDEHOME/share/config zijn waar $KDEHOME gewoonlijk “.config” is in uw persoonlijke map. Als u migreert van een versie van KMyMoney eerder dan 5.0, was de oude locatie van $KDEHOME .kde4, ook in uw persoonlijke map. Met dit hulpbronbestand kan de gebruiker een type activiteit toevoegen die de ontwikkelaar niet is tegengekomen. Als het bestand niet bestaat wanneer het importprogramma de eerste keer actief is, zal het een standaard versie aanmaken, met een paar van de meer gebruikelijke beschrijvingen.

Een aantal voorbeeld CSV-bestanden worden geleverd (in de map kmymoney/contrib/csvimporter/ in de boomstructuur van de broncode) in de hoop dat ze kunnen helpen. In het investeringsvoorbeeld is een type activiteit "ReInvestorContract Buy : ReInvested Units". In het validatieproces is de eerste succesvolle overeenkomst op de ReInv in ReInvestorContract Buy, de transactie krijgt dus daarom de klasse Reinvdiv, hoewel Buy ook is genoemd. Een ander voorbeeld dat wordt gezien als een type activiteit is Reinvest hoewel de transactie geen prijs of aantal bevat, maar alleen een hoeveelheid, zodat het behandelt moet worden als Add Shares of Shrsin.

Toen deze plug-in werd gemaakt, waren er slechts een paar investeringsformaten als voorbeeld te zien en het is zeer wel mogelijk dat u er een kunt tegenkomen die niet juist verwerkt kan worden. Als u zo'n bestand vindt, stuur dan aub een geschikt voorbeeld (bewerkt om persoonlijke informatie te bewerken of te verwijderen) naar de gebruikerslijst (kmymoney kde.org) of ontwikkelaarslijst (kmymoney-devel kde.org), de ontwikkelaar zal zijn best doen om de plug-in te wijzigen om het te behandelen.