HandyCafe Docs
owner it-admin

Миграция данных

Страница Миграция импортирует клиентов, продукты, цены и историю из другой системы управления интернет-кафе в HandyCafe. Она находится в разделе Настройки в группе Инфраструктура и Система.

Поддерживаются три источника:

Источник Что читает
HandyCafe Legacy Существующая установка HandyCafe 3.x или 4.x на этом компьютере.
EveryCafe Файл базы данных EveryCafe .ecm в формате SQLite.
Pancafe Файл базы данных Pancafe USDB.DAT в формате Firebird.

Выберите источник из карточек в верхней части страницы. Панель ниже изменится в соответствии с выбором.

Как работает каждый источник

Все три источника работают по одной модели. То, что вы изучите на одном, применимо и к другим.

  • Источник доступен только для чтения. HandyCafe открывает оригинальный файл для чтения и никогда не записывает в него. Ваша старая установка остается в неизменном виде. Вы можете вернуться к ней в любое время.
  • Проверьте перед импортом. Кнопка Проверить считывает файл источника и сообщает, что было найдено. Кнопка Начать миграцию остается неактивной, пока проверка не будет успешной.
  • Прогресс отображается по этапам. Во время выполнения открывается диалог прогресса, который сообщает о текущем этапе, например, участники, продукты или транзакции.
  • Повторный запуск безопасен. Уже импортированные строки обновляются на месте, а не дублируются. После завершения миграции кнопка изменяется на Повторить миграцию.
  • Каждый запуск можно отменить. После завершенного запуска появляется кнопка Отменить миграцию. Она удаляет все строки, импортированные из этого источника. Сначала вас попросят подтвердить действие.
  • Предупреждения не останавливают выполнение. Если некоторые строки не удалось прочитать, выполнение завершается с предупреждениями. Откройте Логи, чтобы увидеть, какие строки были пропущены.
  • Прерванный запуск восстанавливается автоматически. Если приложение закрывается или компьютер теряет питание во время импорта, страница сообщает, что предыдущий импорт был прерван. Начать заново безопасно.

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

HandyCafe Legacy

Импорт из установки HandyCafe 3.x или 4.x. Это источник для кафе, обновляющихся с более ранней версии HandyCafe.

Обнаружение

На Windows страница сканирует систему на наличие старой установки и сообщает:

Метка Значение
Путь установки Где на диске находится старая установка.
Путь к базе данных Полный путь к файлу старой базы данных.
Версия сервера Строка версии старого сервера, например 3.4.01 или 4.0.10.
Количество INI файлов Сколько конфигурационных INI файлов найдено в папке установки.

Если ничего не обнаружено, страница сообщает, что старая установка не найдена. Проверьте, что файлы находятся в стандартном месте, таком как Program Files\HandyCafe или C:\HandyCafe.

На macOS и Linux автоматическое сканирование не может быть выполнено. Вместо этого панель предлагает выбрать папку. Укажите папку Db, скопированную с старого Windows компьютера, затем начните миграцию.

Что импортируется

Участники, ценовые категории, продукты, заказы, транзакции, логи и настройки, хранящиеся в старых INI файлах.

Остановите старый сервер перед началом. В исходную базу данных не должно быть записей во время чтения.

Для полного руководства смотрите Как мигрировать со старой установки.

EveryCafe

Импорт из файла базы данных EveryCafe, обычно называемого ecmdata.ecm.

  1. Выберите Обзор и выберите файл .ecm. Также принимаются файлы с расширением .db или .sqlite.
  2. HandyCafe автоматически проверяет файл после его выбора. Используйте Проверить, чтобы повторно выполнить проверку после ручного редактирования пути.
  3. Просмотрите предварительный просмотр, затем выберите Начать миграцию.

Предварительный просмотр сообщает имя сервера EveryCafe и версию сервера, а также количество кассиров, участников, продуктов, прайс-листов, заказов и сессий, содержащихся в файле.

Что импортируется

Кассиры, участники, продукты, ценовые категории, заказы, транзакции и аккаунты Steam. Пароли аккаунтов Steam шифруются при записи в пул игровых лицензий HandyCafe.

Сессии и прайс-листы учитываются в предварительном просмотре, чтобы вы могли увидеть объем исходных данных. Они не импортируются.

Справочник прайс-листов

После завершенного запуска панель предлагает таблицу Справочник прайс-листов, в которой перечислены оригинальные строки цен EveryCafe: ID прайс-листа, тип, начальная цена, почасовая цена и минуты обновления.

Цены EveryCafe не сопоставляются напрямую с планами ценообразования HandyCafe. Эти строки сохраняются как справочные для ручной настройки цен. Они не импортируются как продукты кафе. Используйте их вместе с Ценообразованием для восстановления ваших тарифов.

Pancafe

Импорт из файла базы данных Pancafe, обычно называемого USDB.DAT. HandyCafe читает файл Firebird напрямую. Устанавливать сервер или библиотеку клиента Firebird не требуется.

  1. Выберите Обзор и выберите файл USDB.DAT. Также принимаются файлы с расширением .fdb или .gdb.
  2. Просмотрите предварительный просмотр, затем выберите Начать миграцию.

Предварительный просмотр сообщает обнаруженный Формат (например, версию ODS Firebird) и Диапазон истории, охватываемый данными. Также перечисляется количество кассиров, участников, продуктов, записей в кассовой книге, сессий и строк истории кошелька участников.

Что импортируется

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

Строки сессий читаются для предварительного просмотра, но намеренно не импортируются. Кассовая книга уже фиксирует, что было собрано за эти сессии. Импорт обоих привел бы к двойному учету одного и того же дохода.

Часовой пояс

Pancafe хранит даты без часового пояса. HandyCafe конвертирует их, используя часовой пояс компьютера, на котором выполняется импорт. Выполняйте миграцию на машине, которая будет продолжать использовать данные. Запуск на другой машине может сдвинуть исторические даты на несколько часов.

Перед началом

  • Сначала сделайте резервную копию. Откройте Обслуживание базы данных и используйте Сделать резервную копию сейчас. Миграция записывает в рабочую базу данных. Свежий снимок дает вам второй способ вернуться, кроме Отмены миграции.
  • Закройте исходное приложение. База данных, в которую активно записываются данные, может привести к неполным чтениям.
  • Оставьте достаточно времени. Большие наборы данных могут занять несколько минут. Оставьте HandyCafe открытым, пока диалог прогресса не сообщит, что выполнение завершено.
  • Проверьте количество строк, когда выполнение завершится. Сравните их с тем, что вы ожидаете от старой системы, прежде чем начать работу на новой.

Связанные страницы