Додаток імпортування CSVЗагалом кажучи, імпортувати краще OFX Але не всі банківські установи надають виписки саме у цьому форматі. Доступ же до файлів CSV (значень, відокремлених комами) майже завжди можна отримати (іноді такі файли описують як файли Excel або файли електронних таблиць). Крім того, часто такі файли створити доволі просто, достатньо скопіювати дані, наприклад з текстового файла, і виконати їхнє редагування вручну.
Основним призначенням цього додатка є імпортування даних з банківських виписок, втім передбачено можливість імпортування деяких інвестиційних виписок. Початкову версію цього додатка було створено для перетворення даних CSV на файли QIF, які програма могла б імпортувати. Цю можливість у поточній версії збережено, але, ймовірно, її буде усунуто у наступних версіях, оскільки тепер розробку зосереджено на безпосередньому імпортуванні даних з файлів CSV. Крім того, у KMyMoney передбачено вбудовану можливість експортувати файли QIF, тому немає ніякого сенсу створювати на основі даних CSV файл QIF.
Програма KMyMoney здатна імпортувати файли CSV. Роботу цієї функціональної можливості забезпечує додаток, поточну версію якого вбудовано до ядра програми, як у пакунках дистрибутивів, так і у файлах початкових кодів. Щойно буде встановлено пакунок дистрибутива або зібрано програму з початкових кодів і встановлено її, файли CSV буде автоматично показано у списку форматів імпортування меню → .
Додаток імпортування даних CSV є набагато новішим за додаток імпортування OFX, але у більшості дистрибутивів засіб імпортування CSV вже включено до пакунка з програмою або зібрано як окремий пакунок. Переконайтеся, що додаток увімкнено у параметрах KMyMoney. Для цього скористайтеся сторінкою діалогового вікна налаштувань: → → . Якщо вам здається, що засіб імпортування CSV у вашій версії не встановлено, варто спочатку перевірити там, де ви брали базовий пакунок KMyMoney. Спробуйте знайти новіший пакунок програми або окремий пакунок додатка.
Якщо ви виконували встановлення з пакунків RPM або Deb, додаток імпортування CSV має міститься у пакунку KMyMoney. Якщо ви збирали програму з вихідних кодів, ніяких додаткових залежностей не потрібно. Скрипт збирання KMyMoney виявить відповідні файли і збере додаток.
Щоб імпортувати дані з файла CSV, скористайтеся пунктом основного меню програми: → → . Якщо пункту CSV немає у меню «Імпортувати», додаток імпортування CSV встановлено з помилками. Щоб усунути їх, будь ласка, зверніться до попереднього розділу підручника.
Засіб імпортування CSV створено у формі майстра, де кожному з кроків процесу присвячено окрему сторінку. Між текстом у цьому підручнику, мітками на знімках вікон та мітками, які ви побачите у цьому майстрі, можуть бути незначні відмінності. Якщо це так, у підручнику описано вигляд майстра у наступному випуску програми.
Одразу після запуску засіб імпортування CSV покаже сторінку Вступ. Спочатку, верхня панель, де буде показано дані, буде порожньою. Нижче, ліворуч, буде показано список кроків процесу імпортування, у якому буде позначено напівжирним шрифтом пункт поточного кроку. Праворуч від цього списку буде наведено короткі настанови та два пункт-перемикачі, за допомогою яких можна вибрати варіант імпортування: Робота з банком або Інвестиція. Нижче буде наведено список вибору профілю, доступ до якого буде відкрито, щойно ви виберете один з варіантів. У нижній частині вікна ви побачите кнопку для переходу до наступного кроку майстра, кнопку , призначену для переходу до попереднього кроку, та кнопку для скасування імпортування. На початковому кроці також буде показано кнопку Вибрати файл, призначену для початкового вибору файла для імпортування.
Крім того, ви побачите пункт Пропустити налаштовування поряд із списком вибору профілю. На початку, вам не варто позначати цей пункт. Щойно ви налаштуєте якийсь профіль і завершите роботу майстра, відповідні параметри буде збережено у файлі ресурсів. Наступного разу, коли ви скористаєтеся тим самим профілем, параметри буде завантажено до інтерфейсу користувача. Майстер пройде наступними сторінками параметрів, які не потрібно змінювати. Отже, якщо профіль ваш влаштовує, варто позначити цей пункт. Майстер перейде одразу до останньої сторінки, і, якщо проблем не буде виявлено, ви зможете просто натиснути кнопку Імпортувати.
Спочатку виберіть варіант імпортування, Робота з банком або Інвестиція, потім клацніть у полі списку вибору, де ви бачите напис «Додати новий профіль». Якщо ви раніше створили якийсь профіль, ви можете вибрати його. Якщо ж профілю створено не було, введіть назву нового профілю, наприклад, назву рахунку, до якого ви хочете імпортувати дані. Якщо було введено назву нового профілю, достатньо натиснути клавішу Enter, щоб створити його. Після цього натисніть кнопку Вибрати файл для відкриття стандартного вікна вибору файла, за допомогою якого ви зможете вибрати файл CSV, дані з якого слід імпортувати.
Далі, майстер перемкнеться на сторінку Роздільники, і ви маєте побачити ваші дані.
Застереження
Показані у верхній частині вікна додатка записи можна редагувати, але внесені зміни збережено не буде. Цю частину вікна призначено лише для показу даних, а не для їхнього редагування. Додаток ніколи не вносить змін до файла вхідних даних, а імпортовані дані визначаються вмістом файла вхідних даних, а не тим, що показано на екрані. Єдине виключення з цього правила описано у розділі Цінні папери і символи, наведеному нижче.
Алгоритми додатка мають визначити відповідний Роздільник полів. Зазвичай, вибирати інший не варто. Фактично, спроба вибору іншого роздільника призведе до того, що буде скасовано вибір усіх полів, який уже було зроблено. Також передбачено можливість вибору Роздільника тексту, втім, здебільшого, таким роздільником є лапки ("). Натисніть кнопку Далі. Залежно від вибраного варіанта, ви опинитеся або на сторінці роботи з банком, або на сторінці інвестицій.
За допомогою цієї сторінки ви можете вибрати номери стовпчиків, з яких слід імпортувати дані відповідних полів.
Для більшості полів вам достатньо буде скористатися відповідним спадним списком для вибору стовпчика. Втім, існує декілька окремих випадків.
У центрі буде показано два пункти варіантів. Якщо у вашому файлі один стовпчик для усіх значень, позначте стовпчик Сума. Якщо ж є окремі стовпчики для витрат і надходжень, позначте стовпчик Витрати/Надходження. У відповідь буде увімкнено засіб вибору стовпчика Сума або засоби вибору стовпчика Витрати і Надходження.
Ви можете вибрати декілька стовпчиків для поля нотаток, позначивши їх послідовно. До вже позначених стовпчиків нотаток у списку буде додано символ зірочки (*). Якщо ви позначите у таких спосіб декілька стовпчиків, їхній вміст буде послідовно об’єднано для отримання вмісту поля нотаток.
Якщо ви спробуєте вибрати один стовпчик для двох полів, додаток попередить вас і скасує обидва вибори. Втім, можна, якщо це потрібно, скористатися одним стовпчиком для полів Отримувач/Опис та Нотатка. Якщо ви виберете певний стовпчик для поля Отримувач/Опис, а потім виберете той самий стовпчик для поля Нотатка, програма покаже вікно з попередженням щодо дублювання стовпчиків і попросить вас підтвердити зроблений вибір. Щоб підтвердити це, натисніть кнопку .
Причиною для використання вмісту поля «Отримувач/Опис» у полі «Нотатка» є те, що початковий вміст поля отримувача/опису може бути повністю змінено під час встановлення відповідності операцій у KMyMoney. Використання даних у полі нотаток збереже початковий текст, який інакше було б втрачено.
Якщо ви помітите, що було зроблено помилковий вибір, просто змініть вибір. Якщо потрібно буде внести декілька змін, натисніть кнопку Спорожнити.
Щойно буде вибрано стовпчики для усіх необхідних полів, програма увімкне кнопку , і ви зможете перейти до наступної сторінки майстра.
Ця сторінка є подібною до сторінки Робота з банком, хоча є дещо складнішою. Призначення більшості пунктів є очевидним, втім, декілька пунктів можуть видатися незрозумілими, доки ви не спробуєте виконати процедуру імпортування один або декілька разів.
Як і на сторінці Робота з банком, ви можете вибрати для поля нотаток декілька стовпчиків одразу.
Пункт Тип/Дія призначено для визначення стовпчика, у якому міститься тип дії, наприклад «купівля», «продаж», «дивіденди» тощо.
За допомогою пункту Коефіцієнт ціни можна визначити дільник або множник, призначений для встановлення сумісності між імпортованими та збереженими цінами. Наприклад, якщо ціни у імпортованому файлі визначаються у центах, а рахунок у вашій програмі KMyMoney ведеться у доларах, виберіть значення 0,01. Якщо ж у обліковій книзі KMyMoney підрахунок ведеться у доларах, і ціни у імпортованому файлі CSV також вказано у доларах, встановіть у полі Коефіцієнт ціни значення 1,0.
Пунктом Стовпчик мита можна скористатися, якщо у вашому файлі міститься певний стовпчик для мита. Майте на увазі, що це мито може бути враховано у ціні. Якщо мито вказано у відсотках, а не як абсолютне значення, позначте пункт Мито у відсотках. Зауважте, що на цій сторінці це єдине поле, у мітку якого включено слово «стовпчик», щоб наголосити на тому, що це стовпчик мита, а не справжня сума мита.
Під пунктами вибору стовпчиків ви побачите дві панелі для ідентифікації цінних паперів. Залежно від вашого брокера або фінансової установи, у вашому файлі можуть міститися дані щодо одного або декількох цінних паперів.
Якщо у файлі містяться дані щодо операцій з лише одним цінним папером, де його назву може бути вказано у рядку шапки таблиці, назву слід ввести у полі Назва цінного паперу. Введену вами назву буде додано до спадного списку для наступного використання. Можливо, згодом ви захочете вилучити цю назву зі списку. Для вилучення позначте пункт із назвою, потім натисніть кнопку Приховати цінний папір. Після цього назву буде вилучено зі списку, вона не впливатиме на вміст вашого основного файла KMyMoney.
Якщо у файлі містяться дані щодо операцій з декількома цінними паперами, кожен з них буде ідентифіковано за його кодовою назвою (тікерним символом) у одному стовпчику з докладнішим описом у іншому стовпчику. Виберіть ці стовпчики за допомогою пунктів Символ та Подробиці. Може так статися, що цінний папір не має офіційного символу. У цьому випадку можна використати псевдосимвол. Його використання не спричинить проблем, якщо він унікальним чином ідентифікує цінний папір у імпортованому файлі. Іноді, тип дії вбудовано до стовпчика подробиць з можливим префіксом певного стандартного тексту. Наприклад, якщо у полі містяться записи «type: dividend», введіть до поля Фільтрувати текст текст «type: » разом із кінцевим пробілом.
Щойно буде вибрано варіанти для усіх обов’язкових полів, програма увімкне кнопку , і ви зможете перейти до наступної сторінки майстра.
За допомогою цієї сторінки ви можете визначити, чи слід пропустити певні рядки на початку та наприкінці файла. Ви також можете визначити формат даних стовпчика дат.
Початковий рядок. Тут встановіть таке значення, щоб засіб імпортування пропустив усі рядки заголовків у файлі. Ваш вибір буде збережено у профілі для наступного використання. Значення для початкового і кінцевого рядка взаємопов’язано. Ви не можете вказати для початкового рядка більший номер, ніж для кінцевого рядка. Якщо ви не можете змінити значення у полі Початковий рядок, спробуйте змінити значення у поля кінцевого рядка.
Кінцевий рядок. Засіб імпортування автоматично встановить у цьому полі номер останнього рядка у файлі або останнє збережене значення. Змінювати автоматичне значення потрібно, лише якщо у файлі є рядки підвалу, які засіб імпортування має проігнорувати. Якщо ви цього не зробите, ймовірно, буде показано попередження щодо помилки у даних під час обробки засобом імпортування помилкових даних. Знову ж таки, якщо ви не можете змінити значення у полі Кінцевий рядок, спробуйте змінити значення у полі Початковий рядок.
Формат дати. Значення цього параметра слід встановити відповідно до порядку запису року, місяця і дня у датах файла. Якщо додатком буде виявлено несумісність зі значенням цього параметра, програма поскаржиться під час спроби імпортування. Але якщо значення є помилковим і не призводить до визначення некоректних результатів (якщо значення днів не перевищує 12, отже програма може сплутати місяць і день), ви просто отримаєте помилкові дані, оскільки самому додатку важко виявити помилку, але помилки будуть очевидними у обліковій книзі після імпортування.
Після відповідні значення буде визначено, програма увімкне кнопку , і ви зможете перейти до наступної сторінки майстра.
Якщо виконується обробка файла записів інвестицій, після сторінки Рядки вам доведеться переконатися, що програмі вдалося встановити належну відповідність кожного запису цінного паперу у імпортованому файлі записам у базі даних KMyMoney, перш ніж розпочнеться процес імпортування. На цьому кроці буде відкрито інше вікно зі списком цінних паперів та символів у імпортованому файлі. Зауважте, що на відміну від панелі показу даних у основному вікні майстра, зміни, внесені на цій сторінці, буде імпортовано.
Заповнити цю сторінку доволі просто, якщо зосередити увагу на таких пунктах:
Кожен з рядків відповідає лише одній операції, отже, може так статися, що будуть дублікати рядків. Це нормально.
Кожна назва цінного паперу має точно відповідати одному запису цінного паперу, визначеного у KMyMoney. Якщо відповідність встановити не вдасться, буде створено новий запис цінного паперу, можливо небажаний, якщо, звичайно, не виконується купівля якогось нового цінного паперу.
Символ має бути показано для усіх цінних паперів.
Єдиною інформацією на цій сторінці має бути символ цінного паперу та його назва. Будь-які інші спочатку показані дані (зокрема дати та типи дій) зберігатимуться у імпортованому фалі, але їх не буде показано на цій сторінці.
Редагувати символ або назву цінного паперу можна після подвійного клацання лівою кнопкою миші на комірці. Для кожного цінного паперу, якщо це потрібно, змініть назву одному з його рядків. Якщо у імпортованому файлів вказано правильну назву цінного паперу, двічі клацніть на ній, щоб позначити дані, скопіюйте і вставте/редагуйте її, зважаючи на те, чи було використано варіант або абревіатуру у KMyMoney. Якщо ви зміните назву цінного паперу, результати редагування буде застосовано до усіх рядків з тим самим символом.
Усі рядки без символу будуть вважатися записами куртажного типу. Якщо у якійсь операції використовується інший рахунок, наприклад чековий або куртажний рахунок для отримання дивідендів або сплати, буде відкрито вікно повідомлення для введення назви рахунку для переказу. Зазвичай, таким рахунком є куртажний рахунок, який було вибрано або створено під час створення інвестиційного рахунку. Так само, введіть номер стовпчика з даними отримувача, якщо потрібно. Якщо під час введення назви рахунку було зроблено помилку, імпортування продовжиться, але KMyMoney не зможе розпізнати рахунок і позначить відповідні операції як такі, у яких немає прив’язки до категорій. Якщо назва рахунку є довгою, просто введіть перші декілька символів. Імпортування буде продовжено, але записи операцій буде позначено у KMyMoney як такі, що не мають прив’язки до категорій, вам доведеться вибрати належний рахунок переказу після імпортування. Натисніть кнопку щойно вибір буде зроблено. Процес імпортування поверне вас назад до вікна KMyMoney.
Якщо існує декілька записів операцій з одним цінним папером, ви можете редагувати усі ці записи одразу за допомогою позначення декількох записів. Наприклад, щоб додати символ до декількох рядків, натисніть і утримуйте натиснутою клавішу Ctrl і позначте за допомогою клацання лівою кнопкою миші усі записи операцій у стовпчику символів. Не відпускаючи клавіші Ctrl (усі комірки символів має бути позначено), клацніть лівою кнопкою миші на одній з комірок і введіть символ. Клацніть у вікні поза межами стовпчика і натисніть клавішу Enter (а не кнопку ). Тепер, коли ці записи операцій мають один символ, двічі клацніть на одному з записів подробиць і змініть потрібним чином назву цінного паперу. Клацніть десь у вікні (або натисніть клавішу Enter), щоб підтвердити редагування, і усі записи буде змінено відповідно до внесених вами змін щодо подробиць. Для решти записів буде показано символи, запозичені із записів операцій у імпортованому файлі.
Далі, натисніть кнопку , потім кнопку . У полі Введіть рахунок введіть назву куртажного або чекового рахунку для сплат. Якщо ви введете коректну назву, буде використано відповідний рахунок. Якщо вам не хочеться вводити правильну, але довгу назву, введіть перші декілька символів цієї назви. Імпортування буде виконано, але після імпортування записи у обліковій книзі потребуватимуть вибору належного рахунку. У полі Запис комісійних введіть номер стовпчика, у якому містяться відповідні дані. Тепер, у полі Некоректна операція може бути показано декілька записі, оскільки тип дій не відповідає комбінації кількості, ціни та суми. Клацніть на кожному із повідомлень кнопку Вибрати тип операції. У відповідь буде показано спадний список з коректними типами дій для цієї комбінації значень.
Тепер, після завершення імпортування ви повернетеся до вікна KMyMoney для вибору інвестиційного рахунку, яким слід скористатися, а далі чекового рахунку, якщо було використано якість куртажні операції.
Під час переходу до останньої сторінки додаток автоматично виконає перевірку значень. Якщо числові значення у стовпчиках буде позначено зеленим, перевірку виконано успішно. Все, що потрібно буде зробити, це натиснути кнопку , після чого керування буде передано до основного вікна програми KMyMoney. Втім, якщо помилково вказано початковий і/або кінцевий рядки або вибрано помилкові стовпчики, ви побачите позначення червоним кольором і повідомлення щодо того, у чому полягає помилка. Після цього слід натиснути кнопку , щоб повернутися до відповідної сторінки і виправити помилку.
Крім того, може так статися, що, якщо використовуються стовпчики витрат і надходжень, один з цих стовпчиків може не містити записів. Це може означати, що у відповідному стовпчику немає символу відокремлення дробової частини, а це призведе до попередження з боку програми. Якщо причина, очевидно, саме у цьому, ви можете натиснути одну з кнопок Обробити ( або .)
Десятковий знак. Ще однією можливою проблемою є те, що вибраний символ відокремлення дробової частини є помилковим. Вибір відповідного символу може усунути помилку. Зазвичай, змінювати цей символ не слід. Зауважте, що Десятковий знак має відповідати даним у вашому файлі, а не вашій локалі. Якщо у вашій локалі визначено інше значення, перетворення буде виконано. Якщо використання поточного символу дає коректні результати, у верхній частині вікна числові поля буде позначено зеленим кольором. Якщо виникнуть помилки, ви побачите червоні записи. Колір також покаже результат застосування параметрів Початковий рядок і Кінцевий рядок. Також може бути показано попередження, якщо у якійсь із позначених комірок не міститиметься вибраного символу.
Символ тисячних розрядів. Значення цього параметра, ймовірно, не слід змінювати, оскільки його буде визначено автоматично на основі Десяткового знаку. Можливість зміни надано для особливих випадків. Крім того, засіб вибору залишиться неактивним, якщо жодне з імпортованих значень не перевищуватиме 1000.
Імпортувати CSV. За допомогою цієї кнопки можна наказати додатку виконати дію з імпортування даних з файла на основі параметрів, визначених раніше. KMyMoney спитає вас про назву рахунку, до якого слід імпортувати дані.
За допомогою цієї кнопки, після завершення процесу імпортування, ви можете зберегти дані з файла CSV до файла QIF, якщо вам з певної причини потрібен такий файл. Насправді, це початковий варіант дії цього додатка. Втім, оскільки програма KMyMoney має вбудовані механізми експортування даних у форматі файлів qif, ця можливість навряд чи вам знадобиться. Зрештою, її може бути усунуто у наступних версіях додатка.
Якщо використовується варіант імпортування даних Роботи з банком, додаток завершить роботу, а програма KMyMoney попросить вас, як це було вказано вище, вказати відповідний рахунок, до якого слід імпортувати дані. Втім, якщо використовується варіант імпортування даних Інвестиція, можуть знадобитися додаткові дані. Якщо під час імпортування операції додатком буде виявлено відсутність коректного типу операції, додаток покаже сумнівний запис, а користувач зможе вибрати коректний тип для заміни, залежно від комбінації значень кількості, ціни та суми. Для кожного запису операції додаток виконає перевірку вмісту стовпчика так, щоб він відповідав типу дії. Наприклад, якщо вказано кількість, але не вказано ціну або суму, вважатимуться, що операцією може бути лише додавання або вилучення цінних паперів. Або, якщо не вказано суми, але вказано кількість або ціну, вважатимуться, що йдеться про дивіденди, тощо.
Якщо хочете збережіть значення визначених вами параметрів, не забудьте натиснути кнопку , щоб закрити вікно додатка.
Якщо ви помітите, що у ваших виписках щодо інвестицій містяться типи дій, які не розпізнаються програмою, просто додайте нові типи у відповідний розділ файла ресурсів. Докладніші відомості щодо цього файла викладено нижче. Наприклад, у розділі [InvestmentSettings] цього файла поле BuyParam містить записи для дій Purchase, Buy, New Inv і Switch In. Якщо вами буде виявлено інший запис дії, додайте його до відповідного списку і перезапустіть додаток. Ви можете зауважити, що між записами різних полів є подібність, через що вибрано помилковий тип дії. Додаток обробляє списки у такому порядку: Shrsin, DivX, Reinvdiv, Brokerage, Buy, Sell, Remove. Перевпорядкування списків відповідно до ваших потреб не спрацює, оскільки записи у файлі ресурсів впорядковано за абеткою. Якщо помилковий параметр вам не потрібен, просто вилучіть його з файла. Якщо параметр є потрібним, ймовірно, вам доведеться редагувати файл імпортованих даних.
Добре відомою вадою формату QIF є те, що стандарт форматування є доволі розпливчастим. Проблема файлів CSV схожа на проблему файлів QIF, але для цих файлів взагалі не існує стандартів. Зокрема, у файлах інвестиційних даних можливі значні різночитання у визначенні типів дій. У додатку передбачено визначення типів дій у файлі ресурсів, який має назву csvimporterrc. Місце зберігання цього файла залежить від використаного вами дистрибутива. Зазвичай, цей файл зберігається у теці $KDEHOME/share/config, де $KDEHOME, зазвичай, є каталогом «.config» у вашій домашній теці. Якщо ви переходите з версії KMyMoney до 5.0, старим значенням $KDEHOME було .kde4. За допомогою цього файла ресурсів користувач здатен додати тип дій, який не передбачено розробниками. Якщо такого файла у вашій системі немає, під час першого використання додатка буде створено файл з типовими даними, що міститиме декілька очевидних описів дій.
З програмою постачається декілька зразків файлів CSV. Ці файли зберігаються у теці kmymoney/contrib/csvimporter/ ієрархії кодів програми у сподіванні, що ці зразки будуть корисними. У прикладі для інвестицій, наприклад, визначено тип дії ReInvestorContract Buy : ReInvested Units. Під час процедури перевірки першим відповідником дії буде ReInv у розділі ReInvestorContract Buy, отже операцію буде визначено як Reinvdiv, хоча Buy також було згадано. Іншим прикладом є призначення типу дії Reinvest, хоча у записі операції не було згадки ні про ціну, ні про суму, а лише про кількість, отже операцію слід вважати операцією типу «додавання цінних паперів, тобто Shrsin.
Під час створення цього додатка було використано як приклади лише декілька форматів запису інвестицій, отже, ймовірно, ви можете зіткнутися з форматами, які обробляються неправильно. Якщо вами буде виявлено файл у такому форматі, будь ласка, надішліть відповідний приклад (змініть дані так, щоб не залишилося конфіденційних частин) до списку листування користувачів KMyMoney, (kmymoney kde.org), або до списку листування розробників, (kmymoney-devel kde.org). Розробники зроблять все можливе, щоб додаток зміг обробляти ваші дані.