Guida Rapida
Inizia a usare NumiSync Wizard in 5 minuti. Questa guida ti accompagna passo dopo passo nel flusso di lavoro di base per arricchire la tua collezione di monete.
Nota sulle piattaforme: Questa guida è valida per Windows, macOS e Linux. Le scorciatoie da tastiera sono indicate per tutte le piattaforme dove differiscono.
Prerequisiti
Prima di iniziare, assicurati di avere:
- NumiSync Wizard installato (Guida all’Installazione)
- Collezione di OpenNumismat (file .db con alcune monete)
- Chiave API di Numista (gratuita da numista.com)
Passaggio 1: Avvio e Configurazione
Apri NumiSync Wizard
- Avvia NumiSync Wizard:
- Windows: Menu Start o collegamento sul desktop
- macOS: Cartella Applicazioni o Launchpad
- Linux: Menu delle applicazioni o esegui
numisync-wizard(se installato tramite .deb/.rpm)
- Il primo avvio creerà automaticamente una directory cache
Aggiungi la Tua Chiave API
- Clicca su Settings (icona dell’ingranaggio) o premi:
- Windows/Linux:
Ctrl+, - macOS:
Cmd+,
- Windows/Linux:
- Vai alla scheda API Settings
- Incolla la tua chiave API di Numista
- Clicca su Save
Non hai una chiave API? Ottienila gratuitamente su numista.com → Profilo → Accesso API
Passaggio 2: Apri la Tua Collezione
- Clicca su File → Open Collection o premi:
- Windows/Linux:
Ctrl+O - macOS:
Cmd+O
- Windows/Linux:
- Naviga fino al tuo file
.dbdi OpenNumismat - Clicca su Open
- Le tue monete verranno caricate nella finestra principale
Suggerimento: NumiSync ricorda le collezioni recenti. Usa File → Recent Collections per un accesso rapido.
Passaggio 3: Cerca le Corrispondenze
Seleziona le Monete da Arricchire
Puoi arricchire le monete una alla volta o in gruppi:
- Moneta singola: Clicca su una riga per selezionarla
- Più monete: Tieni premuto il tasto modificatore e clicca su più righe
- Windows/Linux:
Ctrl+Clic - macOS:
Cmd+Clic
- Windows/Linux:
- Intervallo: Clicca sulla prima moneta, tieni premuto
Shift, clicca sull’ultima - Tutte le monete: Seleziona tutto
- Windows/Linux:
Ctrl+A - macOS:
Cmd+A
- Windows/Linux:
Avvia la Ricerca
- Clicca sul pulsante Search & Enrich (o premi
F2) - NumiSync cercherà su Numista ogni moneta selezionata
- L’indicatore di avanzamento mostra lo stato corrente
Cosa succede:
- Cerca usando denominazione, paese, anno e segno di zecca
- Gestisce le variazioni (es. “Cent” vs “Cents”, “Italia” vs “Italy”)
- Supporta calendari non gregoriani (anni Meiji, anni Hijri, ecc.)
- Usa risultati in cache quando disponibili (più veloce!)
Passaggio 4: Esamina le Corrispondenze
Capire i Risultati della Ricerca
Dopo la ricerca, ogni moneta mostra uno di tre stati:
- Match Found - Trovata una voce nel catalogo di Numista
- Multiple Matches - Diverse possibilità (è necessaria la selezione manuale)
- No Match - Nessuna voce trovata (prova la ricerca manuale)
Visualizza il Confronto dei Campi
- Clicca su una moneta con corrispondenza
- Il Field Comparison Panel mostra:
- Colonna sinistra: I tuoi dati esistenti
- Colonna destra: Dati del catalogo di Numista
- Differenze evidenziate a colori
- Esamina cosa verrà modificato
Passaggio 5: Accetta o Affina le Corrispondenze
Accetta Tutte le Modifiche
Se la corrispondenza sembra corretta:
- Clicca sul pulsante Accept Match (o premi
Enter) - Tutti i dati di Numista aggiornano immediatamente la tua moneta
- La moneta viene contrassegnata come arricchita
Selezione dei Campi Individuali
Per aggiornare solo campi specifici:
- Nel Field Comparison Panel, deseleziona i campi che non vuoi aggiornare
- Clicca su Accept Match
- Verranno aggiornati solo i campi selezionati
Scegli un’Emissione Diversa
Molte monete hanno più emissioni (anni, segni di zecca, tipi):
- Clicca sul pulsante Choose Issue
- La finestra Issue Picker Dialog mostra tutte le varianti
- Seleziona l’emissione corretta per la tua moneta
- Il confronto dei campi si aggiorna con i dati di quell’emissione
- Clicca su Accept Match
Ricerca Manuale
Se non è stata trovata nessuna corrispondenza automaticamente:
- Clicca sul pulsante Manual Search o premi:
- Windows/Linux:
Ctrl+F - macOS:
Cmd+F
- Windows/Linux:
- Modifica i parametri di ricerca (denominazione, anno, paese)
- Clicca su Search
- Sfoglia i risultati e seleziona la voce corretta
- Clicca su Accept Match
Passaggio 6: Scarica le Immagini (Opzionale)
Download Automatico delle Immagini
Se Data Settings → Images è abilitato:
- Le immagini vengono scaricate automaticamente quando accetti una corrispondenza
- Immagini di dritto, rovescio e taglio (se disponibili)
- Memorizzate nella directory immagini di OpenNumismat
Download Manuale delle Immagini
- Seleziona una moneta arricchita
- Clicca sul pulsante Download Images
- Scegli quali immagini scaricare (dritto, rovescio, taglio)
- Clicca su Download
Suggerimento: Usa Image Comparison per l’anteprima prima di accettare
Flussi di Lavoro Comuni
Flusso 1: Arricchire una Nuova Collezione
- Apri la collezione con molte monete non arricchite
- Seleziona tutte le monete (
Ctrl+A) - Clicca su Search & Enrich (o premi
F2) - Esamina le corrispondenze una per una
- Accetta le corrispondenze man mano che procedi
- Usa la ricerca manuale per le monete senza corrispondenza
Risparmio di tempo: da 2-3 minuti per moneta a 10-15 secondi per moneta
Flusso 2: Aggiornare Solo i Prezzi
- Vai su Settings → Data Settings
- Deseleziona Basic e Issue (lascia Pricing selezionato)
- Seleziona le monete da aggiornare
- Clicca su Search & Enrich
- Accetta le corrispondenze (vengono aggiornati solo i prezzi)
Consiglio Pro: Ottieni una Licenza Supporter per usare Fast Pricing Mode — aggiorna tutte le monete abbinate istantaneamente!
Flusso 3: Correggere Corrispondenze Errate
- Seleziona una moneta con dati errati
- Clicca su Manual Search
- Trova la voce corretta del catalogo
- Accetta la corrispondenza
- I vecchi dati vengono sovrascritti
Suggerimento: Usa Field Comparison per verificare prima di accettare
Consigli per i Migliori Risultati
Consigli per la Ricerca
Buone pratiche:
- Inizia con monete che hanno informazioni complete (anno, paese, denominazione)
- Usa abbreviazioni di denominazione standard (“1 Cent” non “1c”)
- Lascia che NumiSync normalizzi le denominazioni automaticamente
Evita:
- Cercare monete con campi critici mancanti (paese, denominazione)
- Modificare manualmente le query di ricerca a meno che non sia necessario
- Dare per scontato che la prima corrispondenza sia corretta — verifica sempre!
Qualità dei Dati
Buone pratiche:
- Esamina il confronto dei campi prima di accettare
- Usa l’Issue Picker quando esistono più varianti
- Verifica che le immagini corrispondano alla tua moneta fisica
Evita:
- Accettare ciecamente tutte le corrispondenze
- Sovrascrivere buoni dati con dati incompleti del catalogo
- Dimenticare di fare un backup della tua collezione prima!
Prestazioni
Buone pratiche:
- Abilita la cache (Settings → General → Cache)
- Lavora in gruppi di 10-20 monete
- Usa Fast Pricing Mode per aggiornamenti di grandi dimensioni (Licenza Supporter)
Evita:
- Cercare più di 1000 monete in una volta (rispetta i limiti di velocità, ma è lento)
- Disabilitare la cache (spreca chiamate API)
- Cercare la stessa moneta ripetutamente (usa la cache)
Scorciatoie da Tastiera
Windows/Linux:
Ctrl+O- Apri collezioneF2- Search & Enrich delle monete selezionateCtrl+F- Ricerca manualeEnter- Accetta corrispondenzaEscape- Annulla/Chiudi finestra di dialogoCtrl+A- Seleziona tutte le moneteCtrl+,- Apri impostazioniF1- Apri guida
macOS:
Cmd+O- Apri collezioneF2- Search & Enrich delle monete selezionateCmd+F- Ricerca manualeEnter- Accetta corrispondenzaEscape- Annulla/Chiudi finestra di dialogoCmd+A- Seleziona tutte le moneteCmd+,- Apri impostazioniF1- Apri guida
Cosa fare dopo?
Esplora le Funzioni Premium
Ottieni una Licenza Supporter ($10) per sbloccare:
- Fast Pricing Mode - Aggiornamento massivo dei prezzi per tutte le monete abbinate
- Auto-Propagate - Applica i dati di tipo alle monete corrispondenti automaticamente
- Niente più notifiche fastidiose!
Funzioni Avanzate
- Field Mapping - Personalizza come i dati di Numista vengono mappati sui tuoi campi
- Operazioni massive - Elabora centinaia di monete in modo efficiente
- Supporto multi-macchina - Condividi la cache tra i dispositivi
- Posizione cache personalizzata - Salva la cache su un’unità di rete
Scopri di più
- Manuale utente - Documentazione completa delle funzioni
- FAQ - Risposte alle domande frequenti
- Video Tutorial - Prossimamente!
Hai Bisogno di Aiuto?
Problemi Comuni
D: Perché la mia moneta non ha trovato corrispondenze?
- R: Il paese o la denominazione potrebbero richiedere normalizzazione. Prova la ricerca manuale con variazioni.
D: Perché alcuni campi non si aggiornano?
- R: Controlla Data Settings — alcune categorie di dati potrebbero essere disabilitate.
D: Posso annullare una corrispondenza accettata?
- R: Non automaticamente. Ripristina da un backup o ripristina manualmente i dati.
D: Come aggiorno i prezzi senza cambiare altri campi?
- R: Settings → Data Settings → Deseleziona Basic e Issue, lascia Pricing selezionato.
D: Cosa succede se cerco una moneta due volte?
- R: NumiSync usa i risultati in cache (immediato) a meno che tu non clicchi su “Refresh from API”.
Ottieni Supporto
- Problemi: Segnala su GitHub
- Discussioni: Chiedi alla comunità
- Documentazione: Documentazione completa