Migration de Données
La page Migration importe les clients, produits, tarifs et historique d'un autre système de gestion de cybercafé dans HandyCafe. Elle se trouve sous Paramètres dans le groupe Infrastructure et Système.
Trois sources sont prises en charge :
| Source | Ce qu'elle lit |
|---|---|
| HandyCafe Legacy | Une installation existante de HandyCafe 3.x ou 4.x sur cette machine. |
| EveryCafe | Un fichier de base de données SQLite .ecm EveryCafe. |
| Pancafe | Un fichier de base de données Firebird USDB.DAT Pancafe. |
Choisissez une source parmi les cartes en haut de la page. Le panneau ci-dessous change en fonction de la sélection.
Comportement de Chaque Source
Les trois sources partagent le même modèle de fonctionnement. Ce que vous apprenez sur l'une s'applique aux autres.
- La source est en lecture seule. HandyCafe ouvre le fichier original pour lecture et n'y écrit jamais. Votre ancienne installation reste exactement comme elle était. Vous pouvez y revenir à tout moment.
- Inspectez avant d'importer. Le bouton Inspecter lit le fichier source et rapporte ce qu'il a trouvé. Le bouton Démarrer la migration reste désactivé tant qu'une inspection n'a pas réussi.
- Le progrès est affiché par phase. Une boîte de dialogue de progression s'ouvre pendant l'exécution et indique la phase en cours, comme les membres, les produits ou les transactions.
- Relancer est sûr. Les lignes déjà importées sont mises à jour sur place, pas dupliquées. Une fois la migration terminée, le bouton change pour Relancer la migration.
- Chaque exécution peut être annulée. Après une exécution terminée, un bouton Annuler la migration apparaît. Il supprime chaque ligne importée de cette source. Une confirmation vous est demandée d'abord.
- Les avertissements ne stoppent pas l'exécution. Si certaines lignes n'ont pas pu être lues, l'exécution se termine avec des avertissements. Ouvrez Logs pour voir quelles lignes ont été ignorées.
- Une exécution interrompue se rétablit d'elle-même. Si l'application se ferme ou si la machine perd de l'alimentation en cours d'importation, la page indique que l'importation précédente a été interrompue. Recommencer est sans risque.
Développez Derniers comptes d'importation en bas d'un panneau pour voir combien de lignes la dernière exécution a importées pour chaque catégorie.
HandyCafe Legacy
Importe à partir d'une installation HandyCafe 3.x ou 4.x. C'est la source pour les cafés qui passent à une génération plus récente de HandyCafe.
Détection
Sous Windows, la page scanne le système pour une installation legacy et rapporte :
| Étiquette | Signification |
|---|---|
| Chemin d'installation | Où se trouve l'installation legacy sur le disque. |
| Chemin de la base de données | Chemin complet vers le fichier de base de données legacy. |
| Version du serveur | La chaîne de version de l'ancien serveur, par exemple 3.4.01 ou 4.0.10. |
| Nombre de fichiers INI | Combien de fichiers de configuration INI ont été trouvés dans le dossier d'installation. |
Si rien n'est détecté, la page indique qu'aucune installation legacy n'a été trouvée. Vérifiez que les fichiers legacy sont dans un emplacement standard tel que Program Files\HandyCafe ou C:\HandyCafe.
Sur macOS et Linux, le scan automatique ne peut pas s'exécuter. Le panneau propose un sélecteur de dossier à la place. Pointez-le vers le dossier legacy Db copié depuis l'ancienne machine Windows, puis démarrez la migration.
Ce Qui Est Importé
Membres, niveaux de tarification, produits, commandes, transactions, journaux et les paramètres contenus dans les fichiers INI legacy.
Arrêtez le serveur legacy avant de commencer. La base de données source ne doit pas être écrite pendant qu'elle est lue.
Pour un guide complet, voir Comment Migrer depuis une Installation Legacy.
EveryCafe
Importe à partir d'un fichier de base de données EveryCafe, normalement nommé ecmdata.ecm.
- Sélectionnez Parcourir et choisissez le fichier
.ecm. Les fichiers avec une extension.dbou.sqlitesont également acceptés. - HandyCafe inspecte automatiquement le fichier une fois choisi. Utilisez Inspecter pour relancer la vérification après avoir modifié le chemin manuellement.
- Examinez l'aperçu, puis sélectionnez Démarrer la migration.
L'aperçu rapporte le Nom du serveur EveryCafe et la Version du serveur ainsi que le nombre de caissiers, membres, produits, listes de prix, commandes et sessions contenus dans le fichier.
Ce Qui Est Importé
Caissiers, membres, produits, niveaux de tarification, commandes, transactions et comptes Steam. Les mots de passe des comptes Steam sont chiffrés lorsqu'ils sont écrits dans le pool de licences de jeux de HandyCafe.
Les sessions et les listes de prix sont comptées dans l'aperçu pour que vous puissiez voir la taille des données sources. Elles ne sont pas importées.
Référence de Liste de Prix
Après une exécution terminée, le panneau propose un tableau de Référence de Liste de Prix listant les lignes de prix originales EveryCafe : ID de la Liste de Prix, type legacy, prix de départ, prix horaire et minutes de rafraîchissement.
La tarification EveryCafe ne se mappe pas directement sur les plans tarifaires de HandyCafe. Ces lignes sont conservées comme référence pour configurer les tarifs manuellement. Elles ne sont pas importées en tant que produits de cafétéria. Utilisez-les avec Tarification pour reconstruire vos tarifs.
Pancafe
Importe à partir d'un fichier de base de données Pancafe, normalement nommé USDB.DAT. HandyCafe lit directement le fichier Firebird. Aucun serveur ou bibliothèque client Firebird n'a besoin d'être installé.
- Sélectionnez Parcourir et choisissez le fichier
USDB.DAT. Les fichiers avec une extension.fdbou.gdbsont également acceptés. - Examinez l'aperçu, puis sélectionnez Démarrer la migration.
L'aperçu rapporte le Format détecté (par exemple la version ODS de Firebird) ainsi que la Plage historique couverte par les données. Il liste également le nombre de caissiers, membres, produits, entrées du grand livre de caisse, sessions et lignes d'historique de portefeuille de membres trouvées.
Ce Qui Est Importé
Caissiers, membres avec leur solde de portefeuille, produits, entrées de revenus du grand livre de caisse et entrées de dépenses.
Les lignes de session sont lues pour l'aperçu mais laissées de côté lors de l'importation intentionnellement. Le grand livre de caisse enregistre déjà ce qui a été collecté pour ces sessions. Importer les deux compterait les mêmes revenus deux fois.
Fuseau Horaire
Pancafe stocke les dates sans fuseau horaire. HandyCafe les convertit en utilisant le fuseau horaire de l'ordinateur exécutant l'importation. Exécutez la migration sur la machine qui continuera à utiliser les données. L'exécuter ailleurs peut décaler les dates historiques de quelques heures.
Avant de Commencer
- Faites d'abord une sauvegarde. Ouvrez Maintenance de la Base de Données et utilisez Sauvegarder maintenant. Une migration écrit dans la base de données en direct. Un instantané frais vous donne une seconde voie de retour en plus de Annuler la migration.
- Fermez l'application source. Une base de données qui est activement écrite peut produire des lectures incomplètes.
- Prévoyez suffisamment de temps. Les grands ensembles de données peuvent prendre plusieurs minutes. Laissez HandyCafe ouvert jusqu'à ce que la boîte de dialogue de progression indique que l'exécution est terminée.
- Vérifiez les comptes lorsque l'exécution se termine. Comparez-les à ce que vous attendez de l'ancien système avant de commencer à utiliser le nouveau.
Pages Connexes
- Paramètres des Clients Legacy pour permettre aux PC clients V3 et V4 de continuer à se connecter à ce serveur.
- Maintenance de la Base de Données pour les sauvegardes et les points de restauration.
- Membres, Produits et Tarification des Sessions pour examiner les enregistrements importés.