Documentazione BlockCompare
BlockCompare si apre in modalità Compare DWG; un selettore Compare DWG / Compare with Excel nella barra del titolo passa al confronto con una cartella di lavoro Excel esportata invece che con una seconda cartella DWG. Entrambe le modalità procedono poi una schermata alla volta: Select Files → Review Matches → una breve schermata di avanzamento Comparing… → Comparison Report. Non c'è un indicatore di passo — ogni pulsante Back torna esattamente all'istanza della schermata precedente (così i suoi elenchi file, filtri e modifiche sono ancora lì), e Finish sul report salta indietro di due passi alla stessa istanza di Select Files (o Select Excel) anziché a Review Matches — anche i suoi elenchi file, filtri e profilo sono ancora lì, esattamente come li lascerebbe Back.
Per iniziare
Gli screenshot provengono da una versione recente — alcuni dettagli visivi potrebbero differire dalla versione installata.
Comparing files
Compare DWG rispetto a Compare with Excel
Un selettore nella barra del titolo tra il normale flusso a due cartelle e il confronto di una cartella di lavoro Excel esportata contro una cartella DWG.
- Compare DWG (il default) è il flusso a due cartelle descritto nel resto di questa pagina. Compare with Excel sostituisce il selettore Folder A della schermata Select Files con un'unica cartella di lavoro .xlsx — l'esportazione dei dati di blocco prodotta dallo strumento complementare BlockSync — mentre Folder B resta una normale cartella di DWG.
- Cambiare modalità mantiene intatto lo stato di Select Files di ciascuna modalità — passare a Compare with Excel e tornare a Compare DWG non fa perdere gli elenchi file o le selezioni di filtro di Folder A/B.
Compare with Excel — selezione della cartella di lavoro
Sfoglia fino alla cartella di lavoro dei dati di blocco esportata da BlockSync; Folder B resta una normale cartella di DWG.

- Browse… seleziona la cartella di lavoro .xlsx. Una volta scelta, la schermata riporta quante istanze di blocco ha trovato e in quanti file di origine erano state originariamente registrate al suo interno — ad es. "Found 13 block instance(s) across 2 source file(s) in this workbook." — prima che venga scansionato qualsiasi cosa.
- I nomi dei blocchi già presenti nella cartella di lavoro diventano automaticamente l'ambito del confronto; qui non c'è un elenco separato Blocks/Layers/Viewports per questa modalità, dato che la cartella di lavoro stessa riflette già quanto selezionato al momento dell'esportazione da BlockSync.
- Da lì è lo stesso flusso Review Matches → Comparing → Comparison Report di Compare DWG, abbinando i nomi file registrati nella cartella di lavoro con i file effettivi di Folder B — Filename priority è la strategia di abbinamento predefinita per questa modalità, anziché Hybrid, dato che il lato cartella di lavoro non ha dati di handle dal vivo propri con cui pesare un abbinamento Hybrid.
- Una cartella di lavoro Excel non ha un colore di livello risolto, quindi Layer name viene comunque confrontato ma LayerColor è escluso dalle differenze per questa modalità — altrimenti ogni singola riga mostrerebbe un falso cambio di colore.
Aggiunta dei file (Folder A / Folder B)
Aggiungi le revisioni 'prima' e 'dopo' del set di disegni da confrontare.

- Add Files o Add Folder costruisce Folder A (before) e Folder B (after) indipendentemente. Add Folder scansiona un'intera cartella alla ricerca di file .dwg — se scansiona anche le sottocartelle dipende da "Include subfolders when adding a folder" (Settings → AutoCAD, disattivato di default), che si applica a entrambi i lati. I percorsi duplicati vengono saltati silenziosamente.
- Aggiungere, rimuovere o svuotare i file in Folder A attiva automaticamente una pre-scansione leggera per popolare i tab Blocks/Layers/Viewports sotto — i pulsanti Add/Add Folder/Clear e l'elenco propri di Folder A sono disattivati mentre è in corso. Folder B non viene mai deliberatamente pre-scansionata, dato che il suo ruolo è solo fornire candidati per l'abbinamento, non guidare i tab di filtro.
- Ogni elenco mostra File Name e uno Status con codifica a colori, con un pulsante Remove per riga. Senza nulla ancora aggiunto, l'elenco mostra "No files yet — add a folder or files above." invece di una tabella vuota.
Filtro con Blocks, Layers e Viewports
Restringi cosa viene effettivamente confrontato, in base a cosa contiene Folder A.

- Il tab Blocks elenca ogni definizione di blocco trovata nella pre-scansione di Folder A: Block Name, References, In Files, i flag Dynamic e Has Attrs. Layers elenca ogni nome di livello con un campione di colore e un conteggio In Files. Viewports elenca ogni finestra di spazio carta per Layout, Layer, Width e Height.
- Ogni tab ha una propria casella Search; All / None / Invert agiscono solo su ciò che la ricerca corrente sta mostrando, non sull'intero elenco non filtrato.
- Non selezionare nulla su un tab confronta tutto, come di consueto; selezionare blocchi/livelli specifici restringe ciò che Scan & Match legge fin dall'inizio, mentre una selezione di Viewports viene applicata come filtro separato di riquadro di delimitazione dopo la scansione, mantenendo solo le istanze di blocco che ricadono effettivamente dentro una delle finestre selezionate.
- A differenza di alcuni degli altri strumenti CADXChange di confronto, qui c'è un unico profilo di filtro condiviso per tutti e tre i tab insieme (vedi la sezione successiva) anziché un profilo salvato separato per tab.
Strategia di abbinamento, affidabilità e profili salvati
Come BlockCompare decide quale file 'before' va abbinato a quale file 'after'.

- Match strategy — Filename priority, Handle priority, o Hybrid (default) — imposta quanto peso un abbinamento proposto dà alla somiglianza del nome file rispetto a quanti handle di blocco condividono due file. Hybrid pende verso il segnale dell'handle, che è ciò che mantiene corretto un abbinamento anche quando una revisione rinomina anche il file.
- Il cursore Confidence (0,00–1,00, default 0,15) è la soglia che il punteggio combinato di un abbinamento proposto deve superare per essere accettato automaticamente; un abbinamento che ottiene un punteggio inferiore viene lasciato non abbinato per un abbinamento manuale nella schermata successiva. Aumentare il cursore rende l'abbinamento più rigoroso; abbassarlo accetta automaticamente ipotesi più deboli.
- Filter profile Save… salva le selezioni correnti di Blocks/Layers/Viewports con un nome; Load riapplica una selezione salvata, selezionando qualsiasi riga che corrisponde per nome e lasciando il resto deselezionato. L'edizione gratuita mantiene un solo profilo salvato alla volta — salvare un secondo nome nuovo mostra un invito all'upgrade invece di sostituire silenziosamente quello esistente (sovrascrivere lo stesso nome è sempre consentito).
Scan & Match
Legge entrambe le cartelle e propone abbinamenti file-a-file — il passo che apre effettivamente ogni DWG.
- L'edizione gratuita limita questo a 3 file per lato (Folder A e Folder B conteggiati separatamente) — superarlo blocca l'intera esecuzione prima che venga scansionato qualsiasi cosa, con un messaggio che indica il limite, anziché scansionare un batch parziale.
- Scansiona Folder A, poi Folder B, elaborando un file alla volta in background per slot; il parallelismo è limitato a 1 per l'edizione gratuita indipendentemente dal valore "Max Parallel AutoCAD Instances" in Settings, quindi una scansione gratuita procede sempre un file alla volta. Anche l'hash MD5 di ogni file viene calcolato qui, usato in seguito per rilevare una coppia identica byte per byte.
- Un file fallito viene contrassegnato con il proprio errore e non interrompe la scansione del resto del batch; il fallimento si trasmette all'abbinamento come un file senza nulla con cui abbinarsi.
- L'abbinamento stesso è un'assegnazione ottimale globale su ogni coppia Folder A/Folder B (non un semplice abbinamento più vicino), quindi l'abbinamento dall'aspetto migliore di un file non può sottrarre il partner di cui un altro file aveva più bisogno.
- In questo passaggio non c'è un pulsante Cancel, ma ogni file ha un proprio limite di 10 minuti: se AutoCAD smette di rispondere su un DWG danneggiato o molto grande, il file viene abbandonato e segnato come non riuscito. Un file illeggibile viene escluso dal confronto e indicato nella schermata successiva, invece di risultare interamente aggiunto o rimosso.
Review Matches
Conferma o correggi gli abbinamenti file before/after proposti prima che venga confrontato qualsiasi cosa.

- Ogni riga mostra File A accanto al File B proposto (un menu a tendina modificabile che elenca ogni file di Folder B), con i punteggi Filename %, Handle % e Combined % — queste percentuali riflettono l'abbinamento originariamente proposto e non vengono ricalcolate se scegli manualmente un File B diverso dal menu a tendina.
- Le righe evidenziate in rosso sono conflitti — il miglior abbinamento solo per nome file e il miglior abbinamento solo per handle di quel file non sono d'accordo tra loro (o con l'abbinamento scelto) — e indicano un Conflict candidate così puoi vedere il secondo classificato prima di decidere.
- Un file di Folder A senza un abbinamento affidabile inizia come propria riga senza File B selezionato ed Exclude già selezionato — viene escluso dal confronto a meno che tu non scelga un File B e deselezioni Exclude tu stesso.
- Change Strategy e Re-match rieseguono l'algoritmo di abbinamento puramente sugli snapshot già scansionati — nessun DWG viene riletto, quindi è praticamente istantaneo, ma sostituisce ogni riga, scartando qualsiasi sovrascrittura manuale di File B o modifica di Exclude effettuata dall'ultima scansione.
- Compare diventa disponibile solo quando almeno una riga non è esclusa e ha un File B selezionato.
Comparing (schermata di avanzamento)
Una breve schermata di avanzamento tra la conferma degli abbinamenti e la visualizzazione del report — anche qui nessun pulsante Cancel.
- Le coppie confermate vengono confrontate una alla volta, in ordine, con la barra di avanzamento e lo stato "Comparing {n}/{total}: {File A} vs {File B}" che si aggiorna dopo ogni coppia terminata.
- Questa schermata non ha Back né Cancel — passa automaticamente al Comparison Report nel momento in cui termina l'ultima coppia.
Comparison Report
Ogni coppia abbinata, campo per campo — mai semplicemente contrassegnata come "diversa".

- I risultati sono raggruppati per coppia abbinata, ciascuna mostrata come propria sezione espandibile intitolata "{File A} → {File B}". Una coppia i cui file hanno un hash identico byte per byte viene segnalata come "Identical file — comparison skipped." senza alcun elenco di dettagli — per quella coppia non viene eseguito alcun confronto per singolo blocco.
- Le differenze vengono abbinate tramite l'handle dell'oggetto persistente proprio di AutoCAD, non per nome o posizione, quindi un blocco spostato o rinominato viene comunque riconosciuto come la stessa istanza anziché segnalato come un'eliminazione e un'aggiunta.
- Ogni voce mostra Handle, Block Name, Kind (Added/Removed/Modified) e quanti campi sono cambiati. Le istanze di blocco invariate sono lasciate fuori da questo elenco a schermo del tutto — vengono comunque conteggiate nella riga di riepilogo di ogni gruppo, solo non elencate riga per riga, così un disegno con migliaia di istanze non toccate non seppellisce la manciata che è effettivamente cambiata.
- Details… (abilitato solo quando almeno un campo è cambiato) apre un piccolo popup che elenca il valore vecchio e nuovo di ogni campo modificato fianco a fianco; fare clic sui Details di una riga diversa mentre uno è già aperto lo ridirige semplicemente, anziché richiedere di chiuderlo prima.
- La riga di riepilogo a livello di pagina omette deliberatamente il conteggio Unchanged, anche se il riepilogo di ogni singolo gruppo lo mostra.
Exporting to Excel
Export to Excel
Lo stesso confronto, scritto in una cartella di lavoro che chiunque può aprire senza avere BlockCompare installato — includendo tutto ciò che il report a schermo omette.

- Un foglio per ogni nome di blocco distinto in tutte le coppie confrontate, più un foglio di metadati che elenca la versione dell'app/AutoCAD e i nomi file e gli hash MD5 propri di ogni coppia (così puoi confermare in modo indipendente quali coppie erano identiche).
- A differenza del report a schermo, il foglio esportato include le righe Unchanged insieme ad Added/Modified/Removed — nulla è escluso dal file, solo dalla schermata.
- Le righe Added sono riempite di verde; le righe Removed sono riempite di rosso con testo barrato; le righe Modified non hanno il riempimento della riga, ma ogni cella modificata porta un commento che registra il suo valore vecchio, così il nuovo valore resta visibile nella griglia mentre quello vecchio è a un passaggio del mouse di distanza — questo è il layout predefinito "una riga per record" descritto qui; vedi la sezione successiva per l'alternativa.
- La colonna Status nel foglio esportato usa una formulazione diversa dalla colonna Kind a schermo — "Deleted" e "Altered" in Excel contro "Removed" e "Modified" a schermo — utile saperlo se stai facendo riferimento incrociato tra i due.
- Non c'è un limite di righe né un blocco Free/Pro sull'esportazione stessa — l'edizione gratuita può esportare un report di qualsiasi dimensione; l'unico limite dell'edizione gratuita in BlockCompare è il limite di 3 file per lato su Scan & Match.
Scelta del layout del report
Export to Excel apre prima una piccola finestra, chiedendo quale dei due layout di riga usare per scrivere il report.

- One row per record (il default) è il layout descritto nella sezione precedente: un valore vecchio di un campo modificato viaggia insieme come commento di cella.
- Adjacent before/after rows espande invece ogni istanza Modified in due righe — vedi la sezione successiva per come appare.
- La scelta influisce solo su come sono disposte le istanze Modified; le righe Added, Removed e Unchanged vengono scritte allo stesso modo in entrambi i casi.
Layout a due righe before/after
Il layout alternativo: i valori vecchi e nuovi di un'istanza Modified si trovano su due righe adiacenti invece che una, con i campi modificati evidenziati su entrambe.

- Un'istanza Modified ottiene due righe invece di una — la prima con i suoi valori vecchi, la seconda con i suoi valori nuovi — anziché ripiegare il valore vecchio in un commento su una singola riga.
- La colonna Status legge "┌ ALTERED" sulla prima riga e "└ ALTERED" sulla seconda, così la coppia si legge ancora come un'unica unità collegata anche dopo che il foglio viene filtrato o ordinato in modo separato, invece di affidarsi al fatto che le due righe restino vicine.
- Ogni campo effettivamente cambiato tra le due righe è evidenziato (non solo annotato in un commento), così un revisore può scorrere due righe intere fianco a fianco anziché passare il mouse su ogni cella contrassegnata una alla volta.
- Le istanze Added, Removed e Unchanged non sono influenzate da questa scelta e restano a riga singola in entrambi i casi, dato che non c'è un lato "before" o "after" mancante da abbinare per quelle.
Impostazioni
Si apre dall'icona a forma di ingranaggio nella barra del titolo. Ogni campo viene salvato immediatamente — non esiste un pulsante Salva separato.
Language
Settings → GeneralEnglish / 简体中文 / 繁體中文 / 日本語 / 한국어 / Deutsch / Français / Italiano / Español. Riavvia l'app perché un cambio di lingua abbia effetto.
Predefinito: EnglishTheme
Settings → GeneralSystem / Light / Dark. Riavvia l'app perché un cambio di tema abbia effetto.
Predefinito: Match systemAutoCAD version
Settings → AutoCADQuale versione di AutoCAD installata usare per prima. Se non si carica, l'app passa automaticamente a un'altra versione installata.
Predefinito: Auto (newest installed)Max parallel AutoCAD instances
Settings → AutoCADQuanti disegni AutoCAD può elaborare in background contemporaneamente (scelte: 1, 2, 4, 6, 8, 12, 16). Un valore più alto è più veloce ma usa più CPU e memoria — abbassalo su una macchina meno potente.
Predefinito: 8Include subfolders when adding a folder
Settings → AutoCADSi applica ad Add Folder nella schermata Select Files, sia per Folder A sia per Folder B.
Predefinito: OffLicenza
Lo stato della licenza è mostrato nella barra del titolo come Free, Pro, Pro (offline) o Expired, e per intero in Settings → License.
Per attivare: incolla la tua chiave di licenza in Settings → License → "License key" e fai clic su Activate. Per spostare una licenza su una nuova macchina, fai clic su "Deactivate this machine" su quella vecchia prima, poi attiva su quella nuova.
Se l'app non riesce a raggiungere il server delle licenze (nessuna connessione Internet o server temporaneamente non disponibile), una licenza Pro già attivata continua a funzionare per 14 giorni come "Pro (offline)". Riconnettiti entro quel periodo per riconvalidarla: dopo 14 giorni senza una verifica riuscita, dopo la data di scadenza dell'abbonamento o se l'orologio di sistema è stato portato indietro, la licenza risulta Expired finché non può essere riconvalidata.
Risoluzione dei problemi
"AutoCAD not found" o un errore di attendibilità del plugin quando l'app avvia un job
L'app guida AutoCAD in background per aprire ed elaborare ogni disegno, quindi richiede un'installazione completa e con licenza di AutoCAD 2021–2027 — AutoCAD LT non è supportato. Se AutoCAD è installato ma questo errore compare comunque, è probabile che quella versione di AutoCAD non sia mai stata avviata su questa macchina: aprila una volta (anche solo fino alla schermata del disegno), chiudila e riprova — AutoCAD considera attendibile una posizione di plugin solo dopo averla eseguita interattivamente almeno una volta.
Una riga è evidenziata in rosso in Review Matches
L'abbinamento solo per nome file e quello solo per handle non concordano su a quale file "after" appartiene questo file "before". Controlla la colonna Conflict candidate, poi accetta l'abbinamento proposto, scegli l'alternativa dal menu a tendina File B, oppure escludi la riga con Exclude.
La scansione sembra bloccarsi su una cartella grande
Durante Scan & Match ogni file ha un limite di 10 minuti: un processo AutoCAD in background bloccato (la causa più comune è un DWG danneggiato o molto grande) viene arrestato e il file segnato come non riuscito. I file illeggibili vengono esclusi dall'abbinamento ed elencati nella schermata Review matches. Controlla la cartella dei log per l'ultimo file letto.
Un file che ho aggiunto non compare nel Comparison Report
Un file di Folder A senza un abbinamento affidabile inizia pre-escluso nella schermata Review Matches (nessun File B scelto, Exclude selezionato) — viene lasciato silenziosamente fuori da Compare a meno che tu non torni indietro, scelga un File B per esso e deselezioni Exclude.
Il report Excel esportato usa etichette diverse da quelle del report a schermo
Questo è previsto — la colonna Status nella cartella di lavoro legge "Deleted"/"Altered" dove la colonna Kind a schermo dice "Removed"/"Modified". Stesso significato, formulazione diversa tra le due viste.
Re-match nella schermata Review Matches non sembra recepire i nuovi file
Re-match rieseguisce solo l'algoritmo di abbinamento sui dati di blocco/handle già scansionati — non rilegge mai alcun DWG. Per recepire file aggiunti o rimossi, torna indietro a Select Files ed esegui di nuovo Scan & Match.
File su disco
Settings → Diagnostics → Open Log Folder porta direttamente ai log in caso di problemi da risolvere.
| Impostazioni | %LocalAppData%\CADXChange\BlockCompare\settings.json |
| Log | %LocalAppData%\CADXChange\BlockCompare\Logs\ |
| Profili di filtro | %LocalAppData%\CADXChange\BlockCompare\Profiles\ |