Come Migrare da un'Installazione Legacy
Questa guida importa i tuoi dati esistenti da un'installazione HandyCafe V3 o V4 più vecchia a un server HandyCafe moderno. La migrazione non è distruttiva per la fonte: i file originali non vengono modificati o eliminati.
La migrazione del database funziona solo su Windows. Il supporto runtime per i client legacy per connettersi tramite il protocollo originale funziona su ogni piattaforma (vedi Impostazioni Client Legacy).
Cosa Ti Serve
- Un computer Windows con sia l'installazione legacy che il server HandyCafe moderno sullo stesso sistema, o accesso al file del database legacy.
- Accesso amministrativo al Server HandyCafe.
- Il server legacy fermo. Il database sorgente non deve essere scritto attivamente durante la migrazione.
- Spazio libero su disco almeno pari alla dimensione del database legacy (per la nuova copia del database HandyCafe).
- Da 10 a 30 minuti di tempo ininterrotto. Le migrazioni su grandi set di dati possono richiedere diversi minuti. Non chiudere HandyCafe durante l'esecuzione.
Passo 1: Ferma il Server Legacy
Apri l'applicazione server legacy di HandyCafe. Ferma tutte le sessioni ed esci dall'applicazione. Se il server legacy è in esecuzione come servizio Windows, ferma il servizio da services.msc.
Risultato atteso: Il processo del server legacy non è più in esecuzione. Il file del database non è aperto.
Passo 2: Apri la Pagina Impostazioni Client Legacy
- Avvia HandyCafe.
- Apri Impostazioni nella barra laterale.
- Clicca su Client Legacy.
- Scorri fino alla sezione Migrazione Database.
Risultato atteso: Se il sistema rileva un'installazione legacy, la pagina mostra il percorso di installazione, il percorso del database, la versione del server e il conteggio dei file INI. Se non viene rilevato nulla, la pagina dice "Nessuna installazione legacy rilevata." In tal caso, verifica che i file legacy esistano in una posizione standard come Program Files\HandyCafe o C:\HandyCafe.
Passo 3: Verifica l'Installazione Rilevata
Verifica che i valori rilevati corrispondano alla tua installazione legacy conosciuta:
| Campo | Cosa Verificare |
|---|---|
| Percorso Installazione | Indica la cartella corretta di HandyCafe. |
| Percorso Database | Indica il file del database legacy all'interno della cartella di installazione. |
| Versione Server | Corrisponde alla versione del tuo server legacy (ad esempio 3.4.01 o 4.0.10). |
| Conteggio File INI | Non zero. Un'installazione sana ha più file INI per diverse configurazioni. |
Se qualche campo è errato, chiudi HandyCafe, correggi l'installazione e riapri.
Passo 4: Controlla il Campo Codifica
Prima di eseguire la migrazione, conferma che il campo Codifica nella sezione Protocollo Runtime sia impostato correttamente per i tuoi dati sorgente. Questo si trova nella stessa pagina delle impostazioni, più in alto.
| Locale Sorgente | Codifica Consigliata |
|---|---|
| Turco | cp1254 |
| Europa Occidentale (Inglese, Francese, Tedesco, Spagnolo, Italiano, Portoghese) | cp1252 |
| Altro | cp1254 (il server accetta questo come fallback predefinito) |
Se cambi la codifica, clicca su Salva prima di continuare.
Risultato atteso: Le stringhe sorgente verranno decodificate correttamente durante la migrazione, evitando un risultato completed_with_warnings.
Passo 5: Avvia la Migrazione
- Clicca su Avvia Migrazione.
- Si apre una finestra di avanzamento. Mostra la fase corrente e il numero di righe elaborate finora.
- Non chiudere HandyCafe o mettere il computer in sospensione.
- Attendi il completamento. I piccoli set di dati finiscono in meno di un minuto. I set di dati più grandi possono richiedere da 5 a 10 minuti.
Risultato atteso: La finestra di avanzamento si chiude e lo stato cambia in completed o completed_with_warnings. Appare una notifica che conferma l'esecuzione.
Passo 6: Verifica i Conteggi Migrati
Dopo il completamento, la pagina mostra i conteggi dei record migrati:
| Conteggio | Significato |
|---|---|
| Membri | Record dei clienti importati. |
| Prezzi | Tabelle dei prezzi e voci di programma importate. |
| Prodotti | Voci del catalogo prodotti importate. |
| Ordini | Ordini storici importati. |
| Transazioni | Voci del registro importate. |
| Log | Log di audit e avvisi importati. |
| Avvisi | Record che sono stati saltati durante l'importazione. Appare solo quando lo stato è completed_with_warnings. |
Clicca sull'espansore Dettagli per vedere la ripartizione completa. Verifica che i conteggi siano ragionevoli rispetto alle tue aspettative.
Risultato atteso: Tutte e quattro le categorie (membri, prodotti, ordini, transazioni) mostrano conteggi non zero se la tua fonte aveva dati in quelle tabelle.
Passo 7: Gestisci gli Avvisi (Se Presenti)
Se lo stato è completed_with_warnings, espandi l'elenco degli avvisi e rivedi i record saltati.
Avvisi comuni e loro soluzioni:
| Avviso | Causa | Soluzione |
|---|---|---|
| Errore di decodifica codifica | Il testo sorgente contiene byte che non si decodificano nella codifica configurata. | Esegui Annulla, cambia il campo Codifica per corrispondere al locale sorgente e riesegui la migrazione. |
| Data malformata | Un record legacy ha un timestamp non valido (ad esempio 0000-00-00). |
Questi vengono saltati in sicurezza. Nessuna azione necessaria. |
| Chiave duplicata | Un record con lo stesso identificatore esiste già in HandyCafe. | Se questa era una seconda migrazione non intenzionale, esegui Annulla e Riprova. Se stai unendo database, accetta il salto. |
Risultato atteso: Accetti gli avvisi come perdite accettabili conosciute o correggi il problema sottostante e riesegui.
Passo 8: Controllo a Campione dei Dati Importati
Prima di ritirare il server legacy, verifica manualmente un campione di ciascun tipo di record.
- Apri Membri nella barra laterale. Cerca un membro che conosci dal sistema legacy. Conferma nome, saldo e informazioni di contatto.
- Apri Impostazioni > Prezzi. Conferma che le tariffe orarie corrispondano al programma legacy.
- Apri Prodotti. Conferma nomi e prezzi dei prodotti.
- Apri Rapporto Cassa per un giorno storico recente. Conferma che i totali corrispondano a ciò che ti aspetti dal sistema legacy.
Risultato atteso: I campioni casuali corrispondono alla fonte legacy. Se un particolare record è errato, annota il problema. Differenze minori di formattazione sono normali. Grandi discrepanze di valore suggeriscono un problema di codifica o integrità dei dati da indagare prima di andare in produzione.
Passo 9: Abilita il Supporto Runtime per Client Legacy (Opzionale)
Se vuoi che le tue macchine client V3 o V4 esistenti continuino a connettersi mentre effettui la transizione, abilita ora il protocollo runtime.
- Scorri fino alla parte superiore della pagina delle impostazioni Client Legacy.
- Attiva Abilita Supporto Client Legacy.
- Conferma che le porte di ascolto (UDP 710, TCP 712, trasferimento file 717) non confliggano con nient'altro sulla tua rete.
- Clicca su Salva.
Risultato atteso: I client legacy sulla LAN appaiono nel Pannello Amministrativo entro 5-10 secondi. Vedi Client Legacy per come gestirli dal pannello.
Come Annullare una Migrazione
Se la migrazione ha prodotto risultati inaspettati, puoi annullarla completamente. Il database legacy originale non viene toccato.
- Apri Impostazioni > Client Legacy.
- Scorri fino alla sezione Migrazione Database.
- Clicca su Annulla Migrazione.
- Conferma nella finestra di dialogo.
Ogni riga migrata viene eliminata da HandyCafe. Lo stato ritorna a mai. Puoi quindi correggere il problema sottostante (codifica, pulizia dei dati sorgente, ecc.) ed eseguire nuovamente Avvia Migrazione.
Come Rieseguire una Migrazione
Rieseguire sostituisce i dati migrati con dati freschi dalla fonte.
- Apri Impostazioni > Client Legacy.
- Clicca su Riesegui Migrazione (il pulsante cambia etichetta da Avvia Migrazione dopo la prima esecuzione completata).
- Il flusso è identico alla prima esecuzione.
Rieseguire è sicuro da usare tutte le volte che ne hai bisogno. Non duplica i dati perché sostituisce l'output della migrazione esistente.
Errori Comuni da Evitare
- Eseguire la migrazione mentre il server legacy è attivo. Il database sorgente potrebbe essere bloccato o contenere scritture parziali. Ferma sempre prima il server legacy.
- Ignorare il campo Codifica. Eseguire con la codifica sbagliata corrompe i nomi dei membri e i messaggi di log. Correggere questo dopo il fatto richiede Annulla e Riesegui.
- Chiudere HandyCafe durante la migrazione. L'esecuzione viene interrotta e vengono scritti dati parziali. Il recupero richiede Annulla. Lascia sempre che la finestra di avanzamento si completi.
- Saltare il passo di controllo a campione. Fidarsi dei conteggi dei record senza verificare i dati di esempio può far perdere problemi sottili come discrepanze di locale o errori di arrotondamento.
- Eliminare l'installazione legacy troppo presto. Conserva i file sorgente per almeno un intero ciclo di pagamento dopo la migrazione. Se emerge una discrepanza su un rapporto mensile, puoi fare riferimento ai record originali.
- Migrare senza un backup. Copia la cartella dell'installazione legacy prima della prima migrazione. Anche se la fonte non viene modificata dalla migrazione, problemi al disco o incidenti possono accadere. Un backup è un'assicurazione economica.