HandyCafe Docs
owner it-admin

データ移行

移行ページでは、他のインターネットカフェ管理システムから HandyCafe に顧客、商品、価格設定、履歴をインポートします。これは、インフラストラクチャとシステムグループの設定の下にあります。

3つのソースがサポートされています:

ソース 読み取る内容
HandyCafe レガシー このマシンにある既存の HandyCafe 3.x または 4.x のインストール。
EveryCafe EveryCafe の .ecm SQLite データベースファイル。
Pancafe Pancafe の USDB.DAT Firebird データベースファイル。

ページ上部のカードからソースを選択します。下のパネルは選択に応じて変わります。

各ソースの動作

3つのソースは同じ作業モデルを共有しています。1つで学んだことは他にも適用されます。

  • ソースは読み取り専用です。 HandyCafe は元のファイルを読み取り専用で開き、書き込みは行いません。古いインストールはそのまま残ります。いつでも戻ることができます。
  • インポート前に確認。 確認ボタンはソースファイルを読み取り、見つかった内容を報告します。確認が成功するまで移行開始ボタンは無効のままです。
  • 進行状況はフェーズごとに表示されます。 実行中に進行状況ダイアログが開き、メンバー、商品、取引などの進行中のフェーズを報告します。
  • 再実行は安全です。 既にインポートされた行はその場で更新され、重複しません。移行が完了すると、ボタンは移行再実行に変わります。
  • すべての実行は取り消し可能です。 完了した実行後に移行取り消しボタンが表示されます。それはそのソースからインポートされたすべての行を削除します。最初に確認を求められます。
  • 警告は実行を止めません。 一部の行が読み取れない場合、警告付きで実行が完了します。スキップされた行を確認するにはログを開いてください。
  • 中断された実行は自動的に回復します。 アプリケーションが閉じるか、マシンがインポート中に電源を失った場合、ページは前回のインポートが中断されたと報告します。再開は安全です。

パネルの下部で最後のインポート数を展開して、最近の実行で各カテゴリにインポートされた行数を確認します。

HandyCafe レガシー

HandyCafe 3.x または 4.x のインストールからインポートします。これは、以前の世代の HandyCafe からアップグレードするカフェのためのソースです。

検出

Windows では、ページがシステムをスキャンしてレガシーインストールを報告します:

ラベル 意味
インストールパス レガシーインストールがディスク上にある場所。
データベースパス レガシーデータベースファイルへのフルパス。
サーバーバージョン 古いサーバーのバージョン文字列、例: 3.4.01 または 4.0.10。
INI ファイル数 インストールフォルダで見つかった設定 INI ファイルの数。

何も検出されない場合、ページはレガシーインストールが見つからなかったと報告します。レガシーファイルが Program Files\HandyCafeC:\HandyCafe などの標準の場所にあることを確認してください。

macOS と Linux では自動スキャンは実行できません。代わりにフォルダピッカーが提供されます。古い Windows マシンからコピーしたレガシー Db フォルダを指定し、移行を開始します。

インポートされる内容

メンバー、価格設定階層、商品、注文、取引、ログ、およびレガシー INI ファイルに保持されている設定。

開始する前にレガシーサーバーを停止してください。読み取り中にソースデータベースに書き込みを行わないでください。

完全な手順については、レガシーインストールからの移行方法を参照してください。

EveryCafe

通常 ecmdata.ecm と名付けられた EveryCafe データベースファイルからインポートします。

  1. 参照を選択し、.ecm ファイルを選びます。.db または .sqlite 拡張子のファイルも受け付けられます。
  2. HandyCafe はファイルを選択すると自動的に検査します。パスを手動で編集した後に再度チェックを実行するには、確認を使用します。
  3. プレビューを確認し、移行開始を選択します。

プレビューには EveryCafe のサーバー名サーバーバージョン、およびファイルに含まれるキャッシャー、メンバー、商品、価格リスト、注文、セッションの数が報告されます。

インポートされる内容

キャッシャー、メンバー、商品、価格設定階層、注文、取引、Steam アカウント。Steam アカウントのパスワードは HandyCafe のゲームライセンスプールに書き込まれる際に暗号化されます。

セッションと価格リストはプレビューでカウントされ、ソースデータのサイズを確認できますが、インポートされません。

価格リスト参照

完了した実行後、パネルには元の EveryCafe 価格行を一覧する価格リスト参照テーブルが提供されます: 価格リスト ID、レガシータイプ、開始価格、時間単価、リフレッシュ分。

EveryCafe の価格設定は HandyCafe の価格プランにうまくマッピングされません。これらの行は手動で価格設定を設定するための参照として保持されます。カフェテリアの商品としてインポートされません。価格設定と併用して料金を再構築してください。

Pancafe

通常 USDB.DAT と名付けられた Pancafe データベースファイルからインポートします。HandyCafe は Firebird ファイルを直接読み取ります。Firebird サーバーやクライアントライブラリをインストールする必要はありません。

  1. 参照を選択し、USDB.DAT ファイルを選びます。.fdb または .gdb 拡張子のファイルも受け付けられます。
  2. プレビューを確認し、移行開始を選択します。

プレビューには検出されたフォーマット(例: Firebird ODS バージョン)とデータがカバーする履歴範囲が報告されます。また、キャッシャー、メンバー、商品、現金台帳エントリ、セッション、メンバーウォレット履歴行の数も一覧されます。

インポートされる内容

キャッシャー、ウォレット残高を持つメンバー、商品、現金台帳からの収入エントリと支出エントリ。

セッション行はプレビューのために読み取られますが、意図的にインポートから除外されます。現金台帳にはこれらのセッションで収集されたものが既に記録されています。両方をインポートすると同じ収益が二重にカウントされます。

タイムゾーン

Pancafe はタイムゾーンなしで日付を保存します。HandyCafe はインポートを実行するコンピュータのタイムゾーンを使用してそれらを変換します。データを使用し続けるマシンで移行を実行してください。別の場所で実行すると、履歴の日付が数時間ずれる可能性があります。

始める前に

  • まずバックアップを取ります。データベースメンテナンスを開き、今すぐバックアップを使用します。移行はライブデータベースに書き込みます。新しいスナップショットは、移行取り消し以外に戻るためのもう一つの方法を提供します。
  • ソースアプリケーションを閉じます。アクティブに書き込みが行われているデータベースは不完全な読み取りを引き起こす可能性があります。
  • 十分な時間を確保します。大規模なデータセットは数分かかることがあります。進行状況ダイアログが実行が終了したと報告するまで HandyCafe を開いたままにしてください。
  • 実行終了時にカウントを確認します。新しいシステムで取引を開始する前に、古いシステムから期待されるものと比較してください。

関連ページ