HandyCafe Docs
owner it-admin

Πώς να Μεταφέρετε από μια Παλιότερη Εγκατάσταση

Αυτός ο οδηγός εισάγει τα υπάρχοντα δεδομένα σας από μια παλιότερη εγκατάσταση HandyCafe V3 ή V4 σε έναν σύγχρονο διακομιστή HandyCafe. Η μεταφορά δεν επηρεάζει την πηγή: τα αρχικά αρχεία δεν τροποποιούνται ή διαγράφονται.

Η μεταφορά βάσης δεδομένων λειτουργεί μόνο σε Windows. Η υποστήριξη χρόνου εκτέλεσης για σύνδεση παλιών πελατών μέσω του αρχικού πρωτοκόλλου λειτουργεί σε κάθε πλατφόρμα (δείτε Ρυθμίσεις Παλιών Πελατών).

Τι Θα Χρειαστείτε

  • Ένα μηχάνημα Windows με την παλιά εγκατάσταση και τον σύγχρονο διακομιστή HandyCafe στο ίδιο σύστημα ή πρόσβαση στο αρχείο βάσης δεδομένων της παλιάς εγκατάστασης.
  • Δικαιώματα διαχειριστή στον διακομιστή HandyCafe.
  • Ο παλιός διακομιστής να είναι σταματημένος. Η πηγή της βάσης δεδομένων δεν πρέπει να γράφεται ενεργά κατά τη διάρκεια της μεταφοράς.
  • Ελεύθερος χώρος στο δίσκο τουλάχιστον ίσος με το μέγεθος της παλιάς βάσης δεδομένων (για το νέο αντίγραφο βάσης δεδομένων HandyCafe).
  • 10 έως 30 λεπτά αδιάλειπτου χρόνου. Οι μεταφορές σε μεγάλα σύνολα δεδομένων μπορεί να διαρκέσουν αρκετά λεπτά. Μην κλείσετε το HandyCafe κατά τη διάρκεια της εκτέλεσης.

Βήμα 1: Σταματήστε τον Παλιό Διακομιστή

Ανοίξτε την εφαρμογή του παλιού διακομιστή HandyCafe. Σταματήστε όλες τις συνεδρίες και κλείστε την εφαρμογή. Αν ο παλιός διακομιστής λειτουργεί ως υπηρεσία Windows, σταματήστε την υπηρεσία από το services.msc.

Αναμενόμενο αποτέλεσμα: Η διαδικασία του παλιού διακομιστή δεν εκτελείται πλέον. Το αρχείο βάσης δεδομένων δεν είναι ανοιχτό.


Βήμα 2: Ανοίξτε τη Σελίδα Ρυθμίσεων Παλιών Πελατών

  1. Εκκινήστε το HandyCafe.
  2. Ανοίξτε τις Ρυθμίσεις στην πλαϊνή μπάρα.
  3. Κάντε κλικ στο Legacy Clients.
  4. Μετακινηθείτε στην ενότητα Database Migration.

Αναμενόμενο αποτέλεσμα: Αν το σύστημα ανιχνεύσει μια παλιά εγκατάσταση, η σελίδα εμφανίζει τη διαδρομή εγκατάστασης, τη διαδρομή βάσης δεδομένων, την έκδοση διακομιστή και τον αριθμό αρχείων INI. Αν δεν ανιχνευθεί τίποτα, η σελίδα λέει "Δεν ανιχνεύθηκε παλιά εγκατάσταση." Σε αυτή την περίπτωση, επιβεβαιώστε ότι τα παλιά αρχεία υπάρχουν σε μια τυπική τοποθεσία όπως Program Files\HandyCafe ή C:\HandyCafe.


Βήμα 3: Ελέγξτε την Ανιχνευμένη Εγκατάσταση

Επιβεβαιώστε ότι οι ανιχνευμένες τιμές ταιριάζουν με την γνωστή παλιά εγκατάστασή σας:

Πεδίο Τι να Ελέγξετε
Διαδρομή Εγκατάστασης Δείχνει στον σωστό φάκελο HandyCafe.
Διαδρομή Βάσης Δεδομένων Δείχνει στο αρχείο βάσης δεδομένων της παλιάς εγκατάστασης μέσα στον φάκελο εγκατάστασης.
Έκδοση Διακομιστή Ταιριάζει με την έκδοση του παλιού διακομιστή σας (για παράδειγμα 3.4.01 ή 4.0.10).
Αριθμός Αρχείων INI Μη μηδενικός. Μια υγιής εγκατάσταση έχει πολλαπλά αρχεία INI για διαφορετικές ρυθμίσεις.

Αν κάποιο πεδίο είναι λάθος, κλείστε το HandyCafe, διορθώστε την εγκατάσταση και ανοίξτε ξανά.


Βήμα 4: Ελέγξτε το Πεδίο Κωδικοποίησης

Πριν εκτελέσετε τη μεταφορά, επιβεβαιώστε ότι το πεδίο Encoding στην ενότητα Πρωτόκολλο Χρόνου Εκτέλεσης έχει ρυθμιστεί σωστά για τα δεδομένα πηγής σας. Αυτό βρίσκεται στην ίδια σελίδα ρυθμίσεων, πιο πάνω.

Τοπική Ρύθμιση Πηγής Συνιστώμενη Κωδικοποίηση
Τουρκικά cp1254
Δυτική Ευρώπη (Αγγλικά, Γαλλικά, Γερμανικά, Ισπανικά, Ιταλικά, Πορτογαλικά) cp1252
Άλλα cp1254 (ο διακομιστής το αποδέχεται ως προεπιλεγμένη εφεδρεία)

Αν αλλάξετε την κωδικοποίηση, κάντε κλικ στο Αποθήκευση πριν συνεχίσετε.

Αναμενόμενο αποτέλεσμα: Οι συμβολοσειρές πηγής θα αποκωδικοποιηθούν καθαρά κατά τη μεταφορά, αποφεύγοντας ένα αποτέλεσμα completed_with_warnings.


Βήμα 5: Ξεκινήστε τη Μεταφορά

  1. Κάντε κλικ στο Start Migration.
  2. Ανοίγει ένα παράθυρο προόδου. Εμφανίζει τη τρέχουσα φάση και τον αριθμό των γραμμών που έχουν επεξεργαστεί μέχρι στιγμής.
  3. Μην κλείσετε το HandyCafe ή θέσετε τον υπολογιστή σε αναστολή λειτουργίας.
  4. Περιμένετε για την ολοκλήρωση. Μικρά σύνολα δεδομένων ολοκληρώνονται σε λιγότερο από ένα λεπτό. Μεγαλύτερα σύνολα δεδομένων μπορεί να διαρκέσουν 5 έως 10 λεπτά.

Αναμενόμενο αποτέλεσμα: Το παράθυρο προόδου κλείνει και η κατάσταση αλλάζει σε completed ή completed_with_warnings. Εμφανίζεται μια ειδοποίηση που επιβεβαιώνει την εκτέλεση.


Βήμα 6: Ελέγξτε τους Μεταφερμένους Αριθμούς

Μετά την ολοκλήρωση, η σελίδα εμφανίζει τους αριθμούς των μεταφερμένων εγγραφών:

Αριθμός Σημασία
Μέλη Εισαγωγή εγγραφών πελατών.
Τιμοκατάλογοι Εισαγωγή πινάκων τιμών και καταχωρήσεων προγράμματος.
Προϊόντα Εισαγωγή καταχωρήσεων καταλόγου προϊόντων.
Παραγγελίες Εισαγωγή ιστορικών παραγγελιών.
Συναλλαγές Εισαγωγή καταχωρήσεων λογιστικού βιβλίου.
Αρχεία Καταγραφής Εισαγωγή αρχείων ελέγχου και προειδοποιήσεων.
Προειδοποιήσεις Εγγραφές που παραλείφθηκαν κατά την εισαγωγή. Εμφανίζεται μόνο όταν η κατάσταση είναι completed_with_warnings.

Κάντε κλικ στο Details expander για να δείτε την πλήρη ανάλυση. Επιβεβαιώστε ότι οι αριθμοί φαίνονται λογικοί σε σχέση με τις προσδοκίες σας.

Αναμενόμενο αποτέλεσμα: Όλες οι τέσσερις κατηγορίες (μέλη, προϊόντα, παραγγελίες, συναλλαγές) εμφανίζουν μη μηδενικούς αριθμούς αν η πηγή σας είχε δεδομένα σε αυτούς τους πίνακες.


Βήμα 7: Αντιμετωπίστε τις Προειδοποιήσεις (Αν Υπάρχουν)

Αν η κατάσταση είναι completed_with_warnings, επεκτείνετε τη λίστα προειδοποιήσεων και εξετάστε τις παραλειφθείσες εγγραφές.

Συνηθισμένες προειδοποιήσεις και οι διορθώσεις τους:

Προειδοποίηση Αιτία Διόρθωση
Σφάλμα αποκωδικοποίησης κωδικοποίησης Το κείμενο πηγής περιέχει bytes που δεν αποκωδικοποιούνται στην ρυθμισμένη κωδικοποίηση. Εκτελέστε Αναίρεση, αλλάξτε το πεδίο Κωδικοποίησης για να ταιριάζει με την τοπική ρύθμιση πηγής και εκτελέστε ξανά τη μεταφορά.
Κακή μορφή ημερομηνίας Μια παλιά εγγραφή έχει άκυρη χρονική σήμανση (για παράδειγμα 0000-00-00). Αυτές παραλείπονται με ασφάλεια. Δεν απαιτείται ενέργεια.
Διπλότυπο κλειδί Μια εγγραφή με το ίδιο αναγνωριστικό υπάρχει ήδη στο HandyCafe. Αν αυτό ήταν μια ακούσια δεύτερη μεταφορά, εκτελέστε Αναίρεση και Επανεκτέλεση. Αν συγχωνεύετε βάσεις δεδομένων, αποδεχτείτε την παράλειψη.

Αναμενόμενο αποτέλεσμα: Είτε αποδέχεστε τις προειδοποιήσεις ως γνωστές αποδεκτές απώλειες είτε διορθώνετε το υποκείμενο πρόβλημα και εκτελείτε ξανά.


Βήμα 8: Ελέγξτε Δειγματοληπτικά τα Εισαγόμενα Δεδομένα

Πριν αποσύρετε τον παλιό διακομιστή, επαληθεύστε χειροκίνητα ένα δείγμα από κάθε τύπο εγγραφής.

  1. Ανοίξτε τα Μέλη στην πλαϊνή μπάρα. Αναζητήστε ένα μέλος που γνωρίζετε από το παλιό σύστημα. Επιβεβαιώστε το όνομα, το υπόλοιπο και τα στοιχεία επικοινωνίας.
  2. Ανοίξτε τις Ρυθμίσεις > Τιμοκατάλογοι. Επιβεβαιώστε ότι οι ωριαίες τιμές ταιριάζουν με το παλιό πρόγραμμα.
  3. Ανοίξτε τα Προϊόντα. Επιβεβαιώστε τα ονόματα και τις τιμές των προϊόντων.
  4. Ανοίξτε την Αναφορά Ταμείου για μια πρόσφατη ιστορική ημέρα. Επιβεβαιώστε ότι τα σύνολα ταιριάζουν με αυτά που περιμένετε από το παλιό σύστημα.

Αναμενόμενο αποτέλεσμα: Τυχαία δείγματα ταιριάζουν με την πηγή. Αν μια συγκεκριμένη εγγραφή είναι λάθος, σημειώστε το πρόβλημα. Μικρές διαφορές μορφοποίησης είναι φυσιολογικές. Μεγάλες αναντιστοιχίες αξιών υποδηλώνουν πρόβλημα κωδικοποίησης ή ακεραιότητας δεδομένων που αξίζει να διερευνηθεί πριν από την έναρξη λειτουργίας.


Βήμα 9: Ενεργοποιήστε την Υποστήριξη Χρόνου Εκτέλεσης Παλιών Πελατών (Προαιρετικό)

Αν θέλετε οι υπάρχοντες πελάτες V3 ή V4 να συνεχίσουν να συνδέονται ενώ μεταβαίνετε, ενεργοποιήστε τώρα το πρωτόκολλο χρόνου εκτέλεσης.

  1. Μετακινηθείτε στην κορυφή της σελίδας ρυθμίσεων Παλιών Πελατών.
  2. Ενεργοποιήστε το Enable Legacy Client Support.
  3. Επιβεβαιώστε ότι οι θύρες ακρόασης (UDP 710, TCP 712, μεταφορά αρχείων 717) δεν συγκρούονται με τίποτα άλλο στο δίκτυό σας.
  4. Κάντε κλικ στο Αποθήκευση.

Αναμενόμενο αποτέλεσμα: Οι παλιοί πελάτες στο LAN εμφανίζονται στον Πίνακα Διαχείρισης μέσα σε 5 έως 10 δευτερόλεπτα. Δείτε Παλιούς Πελάτες για το πώς να τους διαχειριστείτε από τον πίνακα.


Πώς να Αναίρεσετε μια Μεταφορά

Αν η μεταφορά παρήγαγε απρόσμενα αποτελέσματα, μπορείτε να την αναιρέσετε πλήρως. Η αρχική βάση δεδομένων παραμένει ανέπαφη.

  1. Ανοίξτε τις Ρυθμίσεις > Παλιούς Πελάτες.
  2. Μετακινηθείτε στην ενότητα Μεταφορά Βάσης Δεδομένων.
  3. Κάντε κλικ στο Undo Migration.
  4. Επιβεβαιώστε στο διάλογο.

Κάθε μεταφερμένη γραμμή διαγράφεται από το HandyCafe. Η κατάσταση επανέρχεται σε never. Μπορείτε στη συνέχεια να διορθώσετε το υποκείμενο πρόβλημα (κωδικοποίηση, καθαρισμός δεδομένων πηγής κ.λπ.) και να εκτελέσετε ξανά το Start Migration.


Πώς να Επανεκτελέσετε μια Μεταφορά

Η επανεκτέλεση αντικαθιστά τα μεταφερμένα δεδομένα με νέα δεδομένα από την πηγή.

  1. Ανοίξτε τις Ρυθμίσεις > Παλιούς Πελάτες.
  2. Κάντε κλικ στο Re-run Migration (το κουμπί μετονομάζεται από Start Migration μετά την πρώτη ολοκληρωμένη εκτέλεση).
  3. Η ροή είναι ίδια με την αρχική εκτέλεση.

Η επανεκτέλεση είναι ασφαλής να χρησιμοποιηθεί όσες φορές χρειαστεί. Δεν διπλασιάζει τα δεδομένα επειδή αντικαθιστά το υπάρχον αποτέλεσμα μεταφοράς.


Συνηθισμένα Λάθη προς Αποφυγή

  • Εκτέλεση μεταφοράς ενώ ο παλιός διακομιστής είναι ενεργός. Η πηγή της βάσης δεδομένων μπορεί να είναι κλειδωμένη ή να περιέχει μερικές εγγραφές. Πάντα σταματήστε πρώτα τον παλιό διακομιστή.
  • Παράβλεψη του πεδίου Κωδικοποίησης. Η εκτέλεση με λάθος κωδικοποίηση καταστρέφει τα ονόματα μελών και τα μηνύματα καταγραφής. Η διόρθωση αυτού μετά το γεγονός απαιτεί Αναίρεση και Επανεκτέλεση.
  • Κλείσιμο του HandyCafe κατά τη διάρκεια της μεταφοράς. Η εκτέλεση διακόπτεται και γράφονται μερικά δεδομένα. Η ανάκτηση απαιτεί Αναίρεση. Πάντα αφήστε το παράθυρο προόδου να ολοκληρωθεί.
  • Παράλειψη του βήματος δειγματοληπτικού ελέγχου. Η εμπιστοσύνη στους αριθμούς εγγραφών χωρίς επαλήθευση δειγματοληπτικών δεδομένων παραβλέπει λεπτά ζητήματα όπως αναντιστοιχίες τοπικής ρύθμισης ή σφάλματα στρογγυλοποίησης.
  • Διαγραφή της παλιάς εγκατάστασης πολύ νωρίς. Κρατήστε τα αρχεία πηγής για τουλάχιστον έναν πλήρη κύκλο πληρωμής μετά τη μεταφορά. Αν προκύψει κάποια διαφορά σε μια μηνιαία αναφορά, μπορείτε να ανατρέξετε στα αρχικά αρχεία.
  • Μεταφορά χωρίς αντίγραφο ασφαλείας. Αντιγράψτε τον φάκελο της παλιάς εγκατάστασης πριν από την πρώτη μεταφορά. Ενώ η πηγή δεν τροποποιείται από τη μεταφορά, μπορεί να συμβούν προβλήματα δίσκου ή ατυχήματα. Ένα αντίγραφο ασφαλείας είναι φθηνή ασφάλεια.