Структура файла экспорта

Для обоих проектов структура общая

Разберем построчно.

Первая строка — по ней идентифицируется тип структуры и как потом импортировать этот файл. Не трогать.

### CE

Строки, начинающиеся с ### — строки заголовки последующей структуры данных, бывают следующие:

### preferences info
### cards info
### vehicle info
### fuel_type info
### money_type info
### category info
### pattern info
### parts info
### notes info
### pattern info (***)
### parts info (***)
### notes info (***)
### expenses info (***)
### exp-part info (***)
### records info (***)
### images info (***)

После заголовочной строки в обязательном порядке строка с описанием полей данных. После заголовочной строки и строки с названиями полей идут строки с данными.

  • Имена полей фиксированы, менять нельзя.
  • Порядок полей не важен, но должен быть соблюден между заголовком и самой таблицей записей
  • Имена, как и поля разделяются невидимым символом — табуляцией (Tab).
  • Обязательные поля для корректного импорта помечены *, остальные могут быть не заполнены (и не описаны в заголовке)
  • Если поле указанно в заголовочной строке, о все последующие записи должны иметь ее значение, хотя бы просто пробел, отделенный (Tab)
  • Пробелы в расчет не берутся.

 

Теперь о значении полей.

 

### preferences info — поля настроек приложения

  • calc_rest_period — период расчета остатка топлива, 0 — ежедневно, 1 -после записи
  • calc_costmil — на сколько км выводить стоимость пути
  • date_format — формат даты (0 — 25.02.2015, 1 — 02.25.2015, 2 — 2015.02.25, 3 — 2015.25.02)
  • date_separator — разделитель даты в [ ] скобках
  • money_round — количество разрядов после запятой для денег
  • digit_round — количество разрядов после запятой для остальных цифр
  • digit_separator — разделитель дробной части цифр в [ ] скобках
  • digit_thou — отделитель тысячной части от числа — например 1’000 руб — тысяча рублей
  • show_dlg_exit_app — показывать ли диалог выхода (true — да, false — нет)
  • show_consumption_true — для тех, кто в теме (где показывать расход)
  • animation_enabled — включены ли дополнительные анимации (при прокрутке списков, отрисовке графиков и т.п.) (true — да, false — нет)
  • refuels_bar_show — показывать цветные бары в списке заправок или нет (true — да, false — нет)
  • theme — номер выбранной темы (0-15)
  • refuels_trip_cost_show — показывать ли стоимость пути в списке заправок
  • prediction_use_last — использовать ли при прогнозе остатка топлива последнюю статистику вместо средней (расход топлива/дневной выбег)
  • fab_position — положение плавающей кнопки (+)при добавлении записи
  • column_port — задание количества карточек в табличной раскладке при портретной ориентации (0 — автоматически)
  • column_land — задание количества карточек в табличной раскладке при ландшафтнойориентации (0 — автоматически)
  • event_missed — дорассиытвать ли для прогнозируемый событий отсутствующий пробег/дату — если базовый шаблон имеет только одну настройку для периодичности
  • image_quality — качество сохраняемых изображений

 

### cards info — поля настроек карточек (какие выбраны (вид/тип/параметр)

  • place — экран карточки, 0 — главный (CE), 1 — главный (FM), 2 — статистика трат, 3 — статистика топлива
  • order — номер вкладки, если экран с пролистываемыми табами (для экранов статистики)
  • value — строка набора карточек, ее заполнение зависит от экрана:
    place = 0 — массив записей вида «[1,2,3,4,5];», где по порядку перечислены ее параметры:1 — вид карточки (0 — fuel, 1 — expenses, 2 — events)
    2 — тип карточки (0-…)
    3 — параметр карточки (выбранный период 0-5)
    4 — дата начальной точки статистики для карточки (20160328), актуально для выбранного периода = 5
    5 — дата конечный точки статистики для карточки (20160328), актуально для выбранного периода = 5
    place = 2/3 — вначале общие настройки для всех карточек экрана в виде «[1,2,3];», а потом все карточки в виде «[4-5,4-5,4-5,4-5,4-5]»
    1 — параметр карточки (выбранный период 0-5)
    2 — дата начальной точки статистики для карточки (20160328), актуально для выбранного периода = 5
    3 — дата конечный точки статистики для карточки (20160328), актуально для выбранного периода = 5
    4 — вид карточки (0 — fuel, 1 — expenses, 2 — events)
    5 — тип карточки (0 — …)

 

### vehicle info — поля настроек транспорта

  • name* — имя, ключевое поле, к которому потом привязываются все записи в файле (лучше покороче)
  • comment — комментарий
  • mileage_unit — единицы пробега (0 — км, 1 — мили)
  • volume_unit — единицы объема (0 — литры, 1 — галлоны США, 2 — галлоны UK)
  • volmil_unit — единицы расхода (0 — л/100км, …)
  • currency_unit — единицы денег
  • currency_order — где рисовать деньги (0 — до, 1 — после)
  • mileage_method — как добавлять пробег по умолчанию (0 — одометр, 1 — счетчик)
  • tank_count — количество топливных систем в авто (0 — одна система, 1 — две (газ/бензин))
  • tank_volume — объем топливного бака №1
  • tank_rest — остаток в баке №1 при контрольной точке
  • tank_volume_1 — объем топливного бака №2
  • tank_volume_rest_1— остаток в баке №2 при контрольной точке
  • sell_date — дата продажи авто (20160328)
  • buy_date — дата покупки авто (20160328)
  • sell_price — цена продажи авто (35,467)
  • buy_price — цена покупки авто (35,467)
  • sell_mileage — пробег продажи авто (10125)
  • buy_mileage — пробег покупки авто (76523)
  • veh_manufacturer — производитель авто, строковое значение
  • veh_model — модель авто, строковое значение
  • veh_modification — модификация авто, строковое значение
  • veh_equipment — комплектация авто, строковое значение
  • veh_birthday — дата изготовления авто, (20160328)
  • veh_vin — VIN код авто, строковое значение
  • key_code — код ключа (сигнализации), строковое значение
  • mms_code — код мультимедийной системы (ММС), строковое значение
  • veh_body — тип кузова авто (0 — …)
  • veh_color — цвет авто (0 — …)
  • engine_volume — объем двигателя авто (0 — …)
  • engine_type — тип двигателя авто (0 — …)
  • tm_type — тип трансмиссии авто (0 — …)
  • mil_coef — коэффициент скорости/пробега, учитывающий отличие установленных шин от штатных (увеличение диаметра) — (1,035)
  • w_def — ширина резины по умолчанию (185)
  • h_def — высота резины по умолчанию (55)
  • r_def — посадочный диаметр резины по умолчанию (15)
  • w_set — ширина установленной резины (185)
  • h_set — высота резины по умолчанию (55)
  • r_set — посадочный диаметр резины по умолчанию (15)
  • coef_a — коэффициент А для встроенного конвертера пробега (1,0)
  • coef_b — коэффициент B для встроенного конвертера пробега (1,0)
  • coef_c — коэффициент C для встроенного конвертера пробега (1,0)
  • oil_capacity — объем трансмиссионного масла
  • oil_type — тип масла, строковое значение
  • tire_pressure_before — давление шин спереди (2,2)
  • tire_pressure_behind — давление шин сзади (2,2)
  • buy_calc — учитывать ли дату покупки при расчете статистики (1) или использовать дату первой записи (0)
  • sell_calc — учитывать ли дату продажи при расчете статистики (1) или использовать дату последней записи (0)

 

### fuel_type info — поля видов топлива

  • name — название (лучше покороче)
  • parse — перечисление через ; ключевых слов, по которым можно распознать тип топлива — ищется при авторазборе в комментарии
  • tank_numb — номер бака
  • color — цвет заправки с указанным типом топлива

 

### money_type info — поля дополнительных валют

  • name — название
  • unit —  обозначение (лучше покороче)
  • order — где рисовать (0 — до, 1 -после)
  • equal — пример 55 рублей это один доллар, сюда пишем 1
  • equal_orig — а сюда 55

 

### category info — поля категорий трат

  • _id — уникальный номер шаблона — используется в списке записей о тратах
  • name — название
  • comment — комментарий
  • color — цвет заправки с указанным типом топлива
  • stat_included — указывает, учитывать ли траты по этой категории в содержании авто
  • fuel_includes — указывает на топливную (неудаляемую) категорию (0 — обычная, 1 — топливная)

 

### pattern info — поля шаблонов трат

  • _id — уникальный номер шаблона — используется в списке записей о тратах
  • name — название шаблона
  • avatar — иконка шаблона (0 — …)
  • id_category — категория трат шаблона
  • period_type — тип периодичности (0 — никак, 1 — каждые * пробега, 2 — каждые Н месяцев, 3 — что раньше (1/3/4/5) , 4 — однажды при * пробега, 5 — однажды при такой дате
  • period_mileage — эти самые каждые Н пробега в целых числах
  • period_month — эти самые каждые Н месяцев в целых числах
  • period_mileage_once — эти самый Н пробег для «однажды» в целых числах
  • period_date_once — эта самая дата для «однажды» в формате 20150225
  • event_show — показывать ли по этому шаблону напоминания в списке событий (1 — да, 0 — нет)
  • expense_when — показывает, как учитывать трату в содержании (0 — однажды, 1 — распределить, 2 — после, 3 — до)
  • expense_type — показывать, как учитывать трату (0 — доход, 1 — трата)
  • fuel_includes — указывает на топливный (неудаляемый) шаблон (0 — обычная, 1 — топливная)
  • period_from_first — наступающее событие будет отсчитываться от первой записи, а не от последней (но с поправкой на количество повторений) (1)
  • period_done — событие исполнено при покупке ТС

 

### parts info — поля запчастей/материалов

  • _id* — уникальный номер
  • name — название
  • comment — комментарий
  • avatar — иконка шаблона (0 — …)
  • reusable — запчасть имеет ресурс, и его следует считать (1) или нет (0)
  • recycle_mileage — ресурсный пробег (30000)
  • basic_mileage — начальный пробег (3200)

 

### notes info — поля заметок

  • _id — уникальный номер шаблона — используется в списке записей о тратах
  • date — дата (20150225)
  • mileage — пробег (125607)
  • note — название
  • comment — комментарий
  • color — цвет
  • period_type — тип периодичности (0 — никак, 1 — каждые * пробега, 2 — каждые Н месяцев, 3 — что раньше (1/3/4/5) , 4 — однажды при * пробега, 5 — однажды при такой дате
  • period_mileage — эти самые каждые Н пробега в целых числах
  • period_month — эти самые каждые Н месяцев в целых числах
  • period_mileage_once — эти самый Н пробег для «однажды» в целых числах
  • period_date_once — эта самая дата для «однажды» в формате 20150225
  • event_show — показывать ли по этому шаблону напоминания в списке событий (1 — да, 0 — нет)

 

### pattern info (***), ### parts info (***), ### notes info (***) — таблицы шаблонов, запчастей и заметок, предназначенных к конкретному автомобилю и содержащие дополнительное поле:

  • id_vehicle — имя автомобиля, к которому привязана запись, должно совпадать с именем авто в списке транспорта

 

### expenses info (***) — поля записей о тратах

  • id_vehicle — имя автомобиля, к которому привязана запись, должно совпадать с именем авто в списке транспорта
  • id_pattern — уникальный номер шаблона — должен совпадать с номером шаблона из их списка, также может быть массивом вида «26; 43; 28; 40»
  • date — дата (20150225)
  • mileage — пробег (125607)
  • name — название (везде показывается)
  • note — заметка к записи
  • comment — комментарий к шаблону, также может быть массивом вида при нескольких указанных шаблонах «текст1; текст2; текст3; текст4»
  • costpart — стоимость запчастей, также может быть массивом вида при нескольких указанных шаблонах «0,0; 200,0; 350,0; 200,0»
  • costwork — стоимость работ, также может быть массивом вида при нескольких указанных шаблонах «0,0; 200,0; 350,0; 200,0»

 

### exp-part info (***) — поля привязки запчастей к записям траты

  • id_expense* — уникальный номер траты
  • id_part* — уникальный номер запчасти
  • comment — комментарий
  • costpart — стоимость материалов
  • costwork — стоимость работ по замене
  • count_in — купленное количество запчастей
  • count_out — установленное количество запчастей

### records info (***) — поля записей о заправках

  • id_vehicle — имя автомобиля, к которому привязана запись, должно совпадать с именем авто в списке транспорта
  • date — дата в формате 20150225
  • note — заметка к записи
  • mileage — пробег (целое число)
  • volume — объем залитого топлива, через запятую — 5,467
  • volumecost — стоимость топлива, через запятую — 35,467
  • cost — стоимость заправки, через запятую — 1235,467
  • type — название топлива, должно совпадать с именем вида топлива в списке транспорта
  • mark — тип записи — полный перечень здесь
  • mileageadd — разница пробега от предыдущего (производное поле, можно не заполнять)
  • current_tank — номер бака записи ( 0 — первый, 1 — второй)
  • tankvolume — остаток в баке, если известен и указан
  • mil_coef — коэффициент скорости/пробега, учитывающий отличие установленных шин от штатных (увеличение диаметра) — (1,035)
  • missed — флаг того, что предыдущие записи пропущены (1)

 

Добавить комментарий