Імпорт та експорт

Імпорти та експорти знаходяться в Налаштування → Імпорт і Налаштування → Експорт. Обидва призначені для власників і адміністраторів Локації, працюють у фоні на сервері і потребують з’єднання. Для переміщення всього сервера або дому між серверами дивіться також перехід на новий сервер.

Імпортування

Налаштування → Імпорт запитує, звідки воно:

Джерело	Що це
Електронна таблиця (CSV)	Одна річ у рядку, з заголовковим рядком, який називає колонки; також власний експорт електронної таблиці Homebox
Експорт Homebox	ZIP із Homebox v0.26.1 або новіше, рекомендується v0.27.0 (Collection → Tools → Backup & Restore → Create Backup → Download)
Експорт Kept	Локація, експортована з цього Kept або з іншого

Кожен імпорт перевіряється перед тим, як щось буде записано: Перевірити імпорт показує Що імпорт зробить, по рядках, з причиною чогось, що він пропускає. Потім він запускається з прогрес-баром. Можна залишити сторінку; імпорт триває, а Налаштування → Імпорт показує, до чого дойшов. Якщо зупиниться, Відновити продовжить з останнього рядка. Скасувати імпорт залишає те, що вже імпортовано.

Повторний запуск того ж імпорту пропускає те, що вже привезено, тому повторне виконання ніколи не створює дублікатів. Архів (ZIP) може містити до 5 ГБ. Імпортовані речі приходять підтверджені, а не у Вхідні.

Електронна таблиця (CSV)

Вибрати файл і Локацію, куди він потрапляє: яку ви володієте або адмініструєте. Файл може містити не більше 10 000 рядків (8 МБ); більший поділіть. Під файлом Стовпці, які читає Kept перелічує кожну колонку, яку розуміє, а Завантажити зразок CSV надає маленький файл для початку.
Зіставити колонки. Для кожної колонки оберіть поле, куди вона потрапляє, включно з Поле типу… для власних полів типів. Одна колонка повинна бути назвою: кожній речі потрібна назва.
Кілька варіантів:
- Колонка місця типу Garage > Shelf A створює кімнати та місця: оберіть роздільник і чи Створити місця, назви яких у файлі ще не існують.
- Куди потрапляють рядки без місця (за замовчуванням — не розміщені).
- Як записуються дати (визначаються з файлу, де можливо), і валюта для рядків без неї.
- Зіставити колонку типу з вашими типами за назвою, будь-якою мовою Kept; якщо вимкнено, тип залишається в нотатках.
Перевірити імпорт, прочитати звіт і імпортувати.

Стовпці, які читає Kept: назва, кількість, місце, тип, бренд, модель, серійний номер, штрихкод, колір, стан, нотатки, теги, інші назви, дата покупки, ціна, валюта, магазин, посилання на інструкцію, код старої етикетки, свій код, ID рядка (щоб повторний імпорт пропустив рядок) і власні поля типів.

Заголовки будь-якою мовою Kept зіставляються автоматично. Теги та інші назви розділяються комами, ціна — число без знака валюти, а дати пишуться одним способом у всьому файлі.

Електронна таблиця Homebox

Кожен Homebox може експортувати електронну таблицю (до v0.25: Інструменти → Імпорт/Експорт → Експорт інвентарю). Homebox v0.10.3 і v0.11.0 пишуть її розділеною табуляцією (homebox-items.tsv); Kept читає обидві. Коли це колонки Homebox (HB.name, HB.location, …), Kept каже про це, сам зіставляє колонки і читає те, що простий імпорт електронної таблиці б викинув:

Homebox колонка	Kept
`HB.asset_id`, і посилання на річ у `HB.url` (v0.13 і пізніші)	Старі етикетки: надрукована етикетка Homebox відкриває реч
`HB.sold_*`	З покупцем або ціною: річ закінчилася як продана, з датою, покупцем, нотатками і ціною. Сама дата продажу залишається в нотатках
`HB.archived`	Ваш вибір: В архіві (за замовчуванням), Використовується, або Не переносити. Річ з продажем закінчується як продана
`HB.warranty_expires`, `HB.lifetime_warranty`	Гарантію з дати покупки, де увімкнено Гарантії
`HB.warranty_details`, `HB.insured`	Рядки в нотатках

Ціна 0 читається як відсутня ціна (Homebox пише 0, коли жодної не було встановлено). Рядки Локацій з електронної таблиці v0.26 або пізнішої виключаються; місця беруть зі шляху Локації кожного елемента. Електронна таблиця не може переносити фотографії, файли, обслуговування або речі всередині речей, а власні поля імпортуються лише якщо ви зіставляєте їх із полем типу. Для всього цього скористайтеся ZIP експорту.

Експорт Homebox

Kept читає власний ZIP експорту Homebox, який містить усе, включаючи файли. У Homebox відкрийте Колекція → Інструменти → Резервне копіювання та відновлення, оберіть Створити резервну копію і Завантажити резервну копію, якщо вона з’явиться у списку. Він доступний з Homebox v0.26: використовуйте v0.26.1 або новіше (образ Docker v0.26.0 втрачає вкладення), і v0.27.0, якщо можете. Homebox старше v0.26 не має експорту: див. перехід зі старшого Homebox. ZIP без manifest.json Homebox відхиляється з посиланням на цю пораду.

Після завантаження Kept показує колекцію та дату її експорту. Його додано до Нова Локація або Локація, якою ви керуєте, де речі, що вже там є, залишаються, а повторний запуск додає лише нове. Нова Локація створюється, коли ви натискаєте Імпорт, а не раніше: імпорт, який ви залишили на перевірці, нічого не залишає поза собою. Підключити до Homebox (необов’язково) читає валюту колекції, якої немає у ZIP: подайте адресу Homebox та ключ API, або електронну пошту і пароль. Вони використовуються один раз і ніколи не зберігаються.

Для Нової Локації далі йде Що відстежувати: Основне (кімнати, коробки, етикетки та пошук), а під ним, позначені, те, що використовує резервна копія: Ціни на 10 речей увімкнено Гроші, 5 гарантій увімкнено Гарантії, 2 записи обслуговування увімкнено Розклади. Зніміть одну — і дані залишаться в нотатках речей як текст, що пізніше не стане записами. Резервна копія без нього починається лише з Основного. Теж для Особистої надає те саме вашій Особистій Локації, тому меню показує лише те, що ви відстежуєте. Змінюйте будь-яке з них коли завгодно в Налаштування Локації → Що відстежувати; вимкнення чогось ніколи нічого не видаляє.

Потім оберіть:

Ціни в: валюта, запитується лише якщо резервна копія містить ціни. Вибір однієї перейменовує суми, але не конвертує їх.
Архівовані елементи: В архіві (за замовчуванням: архівоване в Kept також, все ще ваше, відкладене), Використовується, або Не переносити. Архівований елемент з покупцем або ціною закінчується як проданий.
Позиції з кількістю 0: Зберегти 0 або в архів (за замовчуванням: тип, що закінчився, зберігає 0, решта приходить архівованими), Задати 1, або Не переносити. Кожна з них, що приходить, має “Кількість в Homebox: 0” у нотатках. Елемент, що тримає інші елементи, ніколи не архівується і не виключається через свій 0, а Локація, що стає коробкою, не має кількості для перевірки.
Додати поле так/ні “Застраховано”, і Не переносити стартові місця та теги Homebox (вісім кімнат і шість тегів, з яких починається кожна нова колекція Homebox, якщо вони не використовуються).
Вони схожі на коробки: Локації, названі як коробка або контейнер (Box 01, Bin 2, Kiste 3…), які не тримають інших Локацій. Позначте їх, або Вибрати все, і вони приходитимуть як коробки: речі, що тримають речі, з їхніми тегами та вмістом. Решта приходитимуть як місця.
Власні поля: для кожного — Додати до типу або Зберегти в нотатках.
Типи: для кожного типу Homebox — тип Kept, Новий тип… з назвою, яку ви набираєте, або Немає типу. Власні типи Homebox 0.27, global.item і global.location, читаються як Позиція і Локація, як у Homebox; загальна Позиція починається як Немає типу.

Перевірка перелічує кожен запис, який потрібно переглянути, із описом того, що з ним сталося, а сторінка імпорту зберігає цей список після імпорту: відкрийте його з Активність (Виконано імпорт).

Що приходить:

Homebox	Kept
Колекція	Одна Локація
Локації (вкладені)	Кімнати та місця, зберігаючи дерево
Елементи	Речі; елемент, що тримає інші, стає коробкою, ніколи не весь його тип
Виробник, модель, серійний номер	Бренд, модель, серійний номер
Дата покупки, магазин і ціна	Покупка з її магазином
Гарантія, первинна гарантія	Гарантія
Деталі продажу	З покупцем або ціною (більше 0): річ закінчилася як продана, з датою, ціною, покупцем і нотатками. Сама дата продажу не є продажем: річ залишається в використанні, а дата — у її нотатках
Теги	Теги з їхніми кольорами (вкладені теги згорнуті)
Фотографії, інструкції, чеки, файли гарантій	Фотографії, інструкції, чек покупки, документ гарантії
Посилання	Посилання. Посилання на документ Paperless-ngx, до якого підключена Локація (така сама адреса), приходить як посилання Paperless, як створює Прив’язане з Paperless, з його заголовком з Paperless (з Homebox, якщо Paperless не може надати; звіт повідомляє скільки); підключіть Paperless перед імпортом
Завершене обслуговування	Записи обслуговування
Заплановане обслуговування	Одноразові розклади
Шаблони	Шаблони обліку, наскільки вони відображаються

Сповіщачі, учасники та ролі не імпортуються. Де модуль вимкнено в Локації, текст запису зберігається у нотатках речі. Опис Локації не зберігається (місця не мають нотаток); перевірка називає кожну з них.

Homebox пише дати, які ніхто не набирав: деякі оновлення заповнюють порожні поля дат, а резервна копія може носити порожню дату як останній день року 0. Kept читає дату до року 1000 як відсутню дату, а продаж потребує покупця або ціни.

Виправлення попереднього імпорту

Імпорти до Kept 1.13.0 перетворювали кількість 0 на 1, робили весь тип типом коробки, коли один з його елементів тримав інший (тому кожна річ з нього відкривалася на порожній вкладці Вмісту), і могли створити тип з назвою global.item. Імпорти до 1.14.1 закінчували річ як продану, коли Homebox мав лише дату продажу. Відкрийте імпорт з Активність (Виконано імпорт): Виправити цей імпорт перелічує те, що може виправити, за назвою:

Архівувати речі, що мали кількість 0 в Homebox (ще в використанні, з кількістю 1);
Зробити тип знову звичайним типом (річ, що тримає речі, залишається коробкою);
Перейменувати global.item на Позицію;
Повернути в використання речі, позначені як продані на одній даті: продані без покупця і без ціни, і не змінені з тих пір. Елемент, архівований в Homebox, також повертається в використання: архівуйте його знову вручну.

Позначте те, що хочете, і натисніть Виправити. Один Скасувати повертає все назад.

Старі етикетки продовжують працювати. Кожен ID актива Homebox (000-001) запам’ятовується і перелічується під Ваші коди на речі. Сканер Kept розпізнає етикетку Homebox і відкриє імпортовану річ; якщо навести старий hostname Homebox на Kept, сканування камерою телефона також працює. Довгі ID елементів і Локацій Homebox (ті, що у посиланнях на етикетки) запам’ятовуються для сканування, але не перелічуються. Імпортовані речі отримують свої коди Kept, які залишаються поза списками доки ви не надрукуєте їхні етикетки.

Перехід зі старшого Homebox

Homebox старше v0.26 не може створити ZIP експорту. Два шляхи:

Все, з фотографіями та обслуговуванням: оновіть копію Homebox до v0.27.0 та експортуйте ZIP з копії. Протестовано з Homebox v0.10.3 (останній випуск оригінального hay-kot/homebox) прямим шляхом до v0.27.0.
Швидше, з меншим: імпортуйте її електронну таблицю.

Оновлення не можна скасувати (з v0.23 Homebox саме так пише у своїх нотатках), тому воно виконується на копії, а ваш Homebox залишається таким, як є:

Зупиніть Homebox та скопіюйте його папку даних, що монтується в /data (homebox.db з її -wal і -shm файлами, і вкладеннями). Збережіть оригінал як свою резервну копію.
Запустіть Homebox v0.27.0 на копії. Homebox тепер знаходиться за адресою ghcr.io/sysadminsmedia/homebox; v0.26 і пізніші потребують HBOX_AUTH_API_KEY_PEPPER, 32 або більше випадкових символів:
Terminal window
```
docker run --rm -p 7745:7745      -e HBOX_AUTH_API_KEY_PEPPER="$(openssl rand -hex 24)"      -v /path/to/homebox-copy:/data      ghcr.io/sysadminsmedia/homebox:0.27.0
```
Перший запуск оновлює базу даних одразу. Він також додає вісім стартових кімнат Homebox, які Kept за замовчуванням виключає, коли вони порожні.
Увійдіть за своїм звичайним обліковим записом та відкрийте Колекція → Інструменти → Резервне копіювання та відновлення. Оберіть Створити резервну копію, а потім Завантажити резервну копію, якщо вона з’явиться у списку.
Імпортуйте його в Kept як експорт Homebox.
Зупиніть копію та видаліть її після завершення імпорту.

Фотографії, додані до того як Homebox почав записувати типи файлів, також приходитимуть: Kept перевіряє кожен файл самостійно.

Експорт Kept

Експорт Kept завжди приходить як Нова Локація, з її речами, місцями, файлами, звітами про стан, переїздами та історією, і позицією Локації, якщо вона є (для Пропонує де я знаходжусь). Якщо містить секретні значення, Відкрити секрети за паролем, обраним під час експорту; без нього імпортується все інше. Для відкриття потрібен HTTPS: через звичайний HTTP екран імпорту повідомляє про це і імпортує решта. Люди, яких запросити перелічує хто ділився Локацією; ніхто не запрошується імпортом, тому запрошуйте кожну людину самостійно.

Звіти про стан повертаються з їхніми днями, нотатками, кімнатами та фотографіями, і кожна фотографія зберігає час, коли Kept вперше її отримав. Завершений звіт повертається завершеним о тому ж часі і залишається закритим. На новому сервері фотографії та завершення під іменем того, хто їх імпортував; історія все ще показує хто зробив кожне до імпорту.

Переїзди повертаються з їхніми коробками: номер кожної коробки, стан і кімната, куди вона йде, і виконаний переїзд виконується знову. Переїзд до іншої Локації приходить як переїзд всередині нової, з її кімнатами для повторного вибору.

Експорт, зроблений новішою Kept ніж сервер, в який ви імпортуєте, може бути відхилений: оновіть цей сервер спочатку.

Історія LubeLogger транспортного засобу

На Огляді транспортного засобу Імпорт із LubeLogger бере CSV, яке LubeLogger експортує для одного транспортного засобу: його паливо, записи обслуговування (ремонти та вдосконалення також) або показники одометра, по одному файлу за раз. Kept читає файл, каже, який це тип і вгадує як записані дати та десяткові числа (LubeLogger пише їх мовою свого сервера); змінюйте будь-яке якщо вгадження невірне, і кажіть чи паливо в літрах чи галонах. Перевірити показує що буде додано та які рядки неможливо, і чому; Імпорт додає їх, найстарішими першими, з їхніми показниками одометра. Повторний імпорт того ж файлу нічого не додає. Власники та адміністратори Локації можуть імпортувати.

Пошукові слова після імпорту

Коли підключено постачальника ШІ, кінець імпорту може пропонувати Додати пошукові слова за допомогою ШІ?, з оцінкою токенів, які потрібні. Воно працює у фоні і додає псевдоніми мовами Локації, так як отримують додані речі (постачальники ШІ).

Експортування

Налаштування → Експорт має два види:

Експортувати Локацію, яку ви володієте або адмініструєте: кожна річ, місце, фотографія, документ, звіт про стан та переїзд завжди у ньому.
Експортувати мої дані: ваша Особиста Локація з її файлами, ваш профіль та предпочитания, і ваші власні виклики ШІ. З Особиста прихована вона носить першу іншу Локацію, яку ви володієте, і Особиста на Експортувати Локацію.

Що входить окрім: архівовані та закінчені речі (продані, віддані, викинуті), Кошик, історія, виклики ШІ, і Копія, яку можна читати без Kept: веб-сторінки, електронні таблиці, мініатюри та чеки, що відкриваються в будь-якому браузері, за бажанням з PDF інвентаризації, власною мовою.

Включити секрети для власника Локації. Секретні значення шифруються паролем не менше 12 символів, введеним двічі. Кожен з файлом і паролем може прочитати кожен секрет у ньому, і Kept не може відновити забутий пароль. Читабельна копія ніколи не містить секретів.

Експорт без секретів виключає кожне секретне значення та повідомляє про це: кожна річ або місце, яке мало одне, називає поле в secretsWithheld, маніфест рахує їх, а читабельна копія має рядок про це. Імпортується як будь-який інший експорт; поля приходять порожніми. Через звичайний HTTP це єдиний вид (Включити секрети потребує HTTPS, Kept у домашній мережі).

Експорт будується у фоні; вам надходить повідомлення, коли він готовий. Кожен експорт залишається у списку, готовий до Завантажити, сім днів. Кожен файл у ZIP датований часом створення експорту.

Експорти та резервні копії

Експорт — це те, що ви забираєте собі: одна Локація, читабельна де завжди, імпортується в будь-яку Kept. Нічне резервне копіювання сервера окремне і покриває весь екземпляр; він також містить читабельну копію кожної Локації (резервні копії). Видалення Локації пропонує Спершу експортувати.

Перехід між екземплярами

Щоб перемістити один дім на інший сервер Kept: експортуйте Локацію (з секретами якщо потрібні), потім імпортуйте ZIP там як експорт Kept. Надруковані етикетки продовжують працювати: етикетка зберігає свій код коли той код вільний на новому сервері, і коли ні, стара етикетка все ще відкриває річ. Щоб перемістити цілий сервер з кожним обліковим записом, використовуйте резервну копію замість цього. Обидва способи в перехід на новий сервер.