TextSyncPanoramica Documentazione Prezzi Download Registro modifiche

Documentazione TextSync

TextSync ha tre modalità, selezionabili dalla pillola nella barra del titolo: Text → Excel (esportazione), Excel → Text (riscrittura) e Batch Edit Styles. Text → Excel è un'unica schermata; Excel → Text è una breve sequenza — scegli una cartella di lavoro e una cartella, scrivi, poi una schermata separata di report; Batch Edit Styles è una propria schermata singola con una griglia condivisa.

Per iniziare

Gli screenshot provengono da una versione recente — alcuni dettagli visivi potrebbero differire dalla versione installata.

Text → Excel (export)

Aggiunta dei file (Text → Excel)

Costruisci il batch di disegni da cui esportare il testo.

Add Files… seleziona singoli file .dwg (multi-selezione); 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). Entrambi eliminano i duplicati rispetto ai file già nell'elenco, senza distinzione tra maiuscole e minuscole.
Clear All svuota l'elenco. Remove Selected rimuove le righe evidenziate — è un semplice pulsante, non una scorciatoia da tastiera; su questa schermata non c'è gestione del tasto Delete, a differenza degli elenchi file di alcuni altri strumenti CADXChange.
L'elenco file mostra nome e percorso, ordinabile facendo clic sull'intestazione di una delle due colonne. Senza file ancora aggiunti, l'elenco mostra un suggerimento di stato vuoto invece di una tabella vuota.
Qui non c'è un filtro per tipo di entità tra DBText e MText — ogni entità DBText e MText del batch viene sempre letta.

Options e Export to Excel

Cosa viene esportato insieme al testo semplice, e i limiti dell'edizione gratuita applicabili a un'esecuzione.

Parallel processing (attivo di default) legge più file contemporaneamente invece che uno alla volta. L'edizione gratuita è limitata fisso a un file alla volta indipendentemente da questa casella o dal valore "Max parallel AutoCAD instances" in Settings — l'accelerazione ha effetto solo su Pro.
L'edizione gratuita limita un'esecuzione a 3 file DWG — superarlo blocca del tutto l'esportazione prima che qualcosa venga eseguito, con un messaggio che indica il limite, anziché esportare un batch parziale. Pro rimuove il limite. Per TextSync non c'è un limite separato di righe sulla cartella di lavoro esportata stessa.
Export to Excel scrive sempre un'unica cartella di lavoro con timestamp — TextSync_Export_{yyyyMMdd_HHmmss}.xlsx — con file, handle, tipo di entità, livello e contenuto per ogni entità corrispondente; il nome non è legato ai nomi dei file di input stessi.
La cartella di output ha come default la cartella padre condivisa di tutti i file aggiunti; se i file sono sparsi su più di una cartella, si passa invece a una cartella fissa Documents\TextSync\Exports.
Dopo la scrittura, un messaggio propone di aprire subito la cartella di lavoro. Cancel (durante l'esportazione) si ferma dopo il file in corso. Un file su cui AutoCAD smette di rispondere viene abbandonato dopo 10 minuti e segnalato come non riuscito, e il resto del batch prosegue.

Excel → Text (write back)

Scelta della cartella di lavoro e della cartella DWG (Excel → Text)

Indica a TextSync un'esportazione modificata e i disegni a cui si applica, oltre a dove vengono scritti i backup.

Passo 1: Excel Workbook sfoglia fino al file .xlsx esportato (e da allora modificato).
Passo 2: DWG Folder. "Use the Excel file's folder" (selezionata di default) deriva automaticamente la cartella dalla posizione della cartella di lavoro stessa; sfogliare a mano una cartella deseleziona quella casella, così non torna silenziosamente alla cartella derivata automaticamente in seguito.
L'abbinamento di una riga della cartella di lavoro a un disegno avviene solo per nome file esatto, dentro quell'unica cartella — a differenza di Add Folder sul lato Text → Excel, questa cartella non viene mai scansionata ricorsivamente, indipendentemente dall'impostazione "Include subfolders".
Automatic backup (attivo di default) copia ogni file che sta per essere scritto nella cartella di backup prima, senza modifiche, prima che venga apportata qualsiasi modifica. La cartella di backup ha come default una cartella _TextSyncBackup creata accanto alla cartella DWG la prima volta che ne viene scelta una.
Restore Backup… apre una finestra separata e autonoma (vedi sotto), precompilata con la cartella di backup corrente — legge gli archivi di backup direttamente dal disco, quindi continua a funzionare anche dopo che l'app è stata riavviata, a differenza del Rollback All nella sessione sulla schermata del report.

Matched Files e Unmatched

Cosa ha trovato TextSync prima che venga scritto qualsiasi cosa — un conteggio di corrispondenze, non un confronto campo per campo.

Scegliere una cartella di lavoro e una cartella con almeno una corrispondenza esegue automaticamente il confronto. A differenza di alcuni degli altri strumenti CADXChange di riscrittura, qui non c'è un passo di anteprima/diff di prova — il tab Matched Files mostra solo ogni file abbinato e quante entità al suo interno stanno per cambiare, non una tabella di valori prima/dopo.
Una riga della cartella di lavoro il cui nome file non ha una corrispondenza esatta nella cartella DWG compare invece nel tab Unmatched, senza far fallire l'intera esecuzione — l'intestazione del suo tab mostra il conteggio corrente di non corrispondenti.
Se la cartella di lavoro stessa non può essere letta (file sbagliato, corrotto, formato sbagliato), il messaggio di stato indica l'errore anziché mostrare un elenco di corrispondenze vuoto o obsoleto.

Write Back

Conferma l'ambito di una scrittura prima che accada qualsiasi cosa — non c'è un passo di verifica successiva.

La finestra di conferma indica esattamente quanti file e quante entità stanno per cambiare, e nomina la cartella di backup — oppure, se il backup è disattivato, avverte esplicitamente che la modifica non può essere annullata.
Anche qui si applica il limite dell'edizione gratuita di 3 file per esecuzione, conteggiato sui file abbinati che stanno per essere scritti.
I file vengono scritti uno alla volta, non in parallelo, dato che un vero file di backup viene creato su disco per file prima della sua scrittura. Se il backup di un file fallisce, la sua scrittura viene saltata interamente — TextSync non scrive mai un file il cui backup è appena fallito.
A differenza dell'equivalente riscrittura di BlockSync, TextSync non rilegge ogni file dopo la scrittura per verificare che la modifica sia effettivamente avvenuta — il risultato per file riflette solo ciò che il comando di scrittura di AutoCAD stesso ha riportato come riuscito o fallito al momento della scrittura. Vengono scritti solo i valori effettivamente diversi dal disegno: un MText il cui testo non è cambiato mantiene tutta la formattazione (font, colori, impilamenti), un testo il cui valore proviene da un campo non viene mai sovrascritto (viene segnalato come non riuscito, con il motivo) e un file senza modifiche non viene salvato affatto.
Cancel lascia terminare il file attualmente in scrittura prima di fermarsi, anziché interrompere a metà scrittura — abbandonare a metà file rischierebbe di lasciare quel DWG scritto solo a metà.

Write-Back Report

Cosa è successo a ogni file dell'esecuzione, una volta terminata la scrittura.

Una riga per file: stato complessivo, quante entità sono riuscite e quante hanno fallito, e dove è finito il suo backup (o perché non ce n'è uno).
Il conteggio Fail di un file è cliccabile quando diverso da zero, aprendo un popup Write Errors con i motivi specifici per entità anziché solo un numero.
Export Report salva lo stesso dettaglio per file in una cartella di lavoro.
Rollback All ripristina ogni file di questa esecuzione dal proprio backup pre-scrittura con un solo clic — ma solo finché questa schermata di report resta aperta, dato che funziona a partire dai risultati in memoria di questa esecuzione. Una volta fatto clic su Finish o riavviata l'app, usa invece la finestra autonoma Restore Backup…, che legge gli archivi di backup direttamente dal disco.
Finish torna a una schermata Excel → Text vuota e scarta i risultati di questa esecuzione — esporta prima il report se ti serve una traccia.

Batch Edit Styles

Lettura e filtro degli stili (Batch Edit Styles)

Aggiungi file e ogni TextStyle al loro interno viene letto automaticamente in un'unica griglia condivisa.

Add Files seleziona file .dwg (multi-selezione); non appena i file sono aggiunti, TextSync legge automaticamente ogni TextStyle da ciascuno di essi — non c'è un passo di "caricamento" separato. Clear All svuota la griglia.
La griglia elenca File, Style Name, Font, Big Font, Width Factor, Fixed Height e Current (un segno di spunta per lo stile attivo del file), più un pulsante Make Current per riga — facendo clic su di esso quella riga diventa corrente e viene deselezionata qualsiasi altra riga di stile appartenente allo stesso file, così ogni file ha sempre un solo stile corrente.
"Name contains:" filtra la griglia in tempo reale per nome dello stile; restringe ciò su cui agiscono Apply to All e i campi di modifica in blocco sotto (vedi la sezione successiva).
Automatic backup qui ha come default la propria cartella accanto al primo file aggiunto (una sottocartella _TextSyncBackup); se una cartella di backup non viene mai impostata, TextSync ripiega al momento della scrittura su una cartella accanto all'applicazione stessa — un fallback diverso da quello di Excel → Text, utile saperlo se i backup finiscono in un posto inaspettato.

Batch edit e Create Text Style

Modifica un campo su molte righe in una volta, oppure aggiungi uno stile nuovo di zecca a ogni file caricato.

Quattro coppie casella+campo indipendenti — Font, Big Font, Width Factor, Fixed Height — ciascuna si applica solo se la propria casella è selezionata; i campi non selezionati vengono lasciati invariati anche se vi viene digitato un valore.
Apply to Selected applica i campi selezionati solo alle righe della griglia evidenziate; Apply to All li applica a ogni riga attualmente mostrata dal filtro "Name contains", selezionata o no — restringere prima il filtro è il modo per limitare una modifica in blocco a stili specifici.
Per Width Factor/Fixed Height, un valore digitato che non viene interpretato come numero viene silenziosamente ignorato per quel campo anziché mostrare un errore — se una modifica in blocco non sembra avere effetto, controlla che il valore digitato sia effettivamente numerico.
Create Text Style richiede un nome e i suoi Font/Big Font/Width Factor/Fixed Height, poi lo aggiunge a ogni DWG attualmente caricato che non ha già uno stile con esattamente quel nome (senza distinzione tra maiuscole e minuscole) — i file che ce l'hanno già vengono saltati e segnalati separatamente, non sovrascritti. Le nuove righe vengono aggiunte alla griglia e portate in vista con lo scorrimento.

Write Styles Back

Scrive le definizioni di stile, poi aggiorna il testo esistente per farlo corrispondere — non solo lo stile, anche la geometria.

La finestra di conferma indica quanti file stanno per essere scritti e, se il backup è attivo, dove; se il backup è disattivato, avverte che la modifica non può essere annullata. Batch Edit Styles non ha un limite di file dell'edizione gratuita — a differenza delle altre due modalità, un'esecuzione qui non è limitata a 3 file.
Per uno stile già esistente in un file, Write Styles Back aggiorna il suo Font, Big Font, Width Factor e Fixed Height sulla definizione esistente (e lo imposta come stile corrente del file, se contrassegnato Current) anziché creare un duplicato.
Poi trova ogni DBText che usa quello stile, tra lo spazio modello e ogni layout di spazio carta, e imposta incondizionatamente il suo Width Factor per farlo corrispondere — ma aggiorna la sua altezza per farla corrispondere a Fixed Height solo quando Fixed Height è maggiore di zero; una Fixed Height di 0 (o vuota) lascia invariata l'altezza del testo esistente anziché azzerarla.
Stessa regola del backup come blocco rigido di Write Back: se il backup di un file fallisce, la scrittura del suo stile viene saltata interamente anziché procedere senza una copia di sicurezza.

Restore Backup

Restore Backup (finestra autonoma)

Ripristina qualsiasi archivio di backup passato, indipendentemente da quale esecuzione sia o non sia attualmente a schermo.

Si apre come propria finestra anziché come tab nell'app principale — disponibile sia da Excel → Text sia da Batch Edit Styles — così continua a funzionare anche dopo che TextSync è stato riavviato e la sessione originale non esiste più.
Indica una cartella di backup: vengono elencati tutti i backup presenti, uno per esecuzione, dal più recente. I backup attuali sono cartelle Backup_{timestamp}; vengono elencati anche gli archivi Backup_*.zip creati dalle versioni precedenti.
Selezionare un archivio elenca i singoli DWG al suo interno con una casella ciascuno; Select All / Deselect All commutano l'intero elenco in una volta.
Restore copia i file selezionati dall'archivio nella cartella di destinazione scelta (predefinita alla cartella padre di quella di backup), sovrascrivendo qualsiasi cosa già presente con lo stesso nome.

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 → General

English / 简体中文 / 繁體中文 / 日本語 / 한국어 / Deutsch / Français / Italiano / Español. Riavvia l'app perché un cambio di lingua abbia effetto.

Predefinito: English

Theme

Settings → General

System / Light / Dark. Riavvia l'app perché un cambio di tema abbia effetto.

Predefinito: Match system

AutoCAD version

Settings → AutoCAD

Quale 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 → AutoCAD

Quanti 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: 8

Include subfolders when adding a folder

Settings → AutoCAD

Si applica solo ad Add Folder… nella schermata Text → Excel — non ha effetto sull'abbinamento della cartella DWG di Excel → Text (sempre solo al livello principale) né su Batch Edit Styles (che non ha un selettore di cartella).

Predefinito: Off

Licenza

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.

Un'esecuzione sembra bloccata su un file

Ogni file ha un proprio limite di 10 minuti: se AutoCAD resta bloccato su un file così a lungo, TextSync arresta il processo in background che lo elabora, segnala il file come scaduto e passa al successivo. Puoi anche fare clic su Cancel in qualsiasi momento; controlla la cartella dei log per sapere cosa stava facendo AutoCAD quando si è bloccato.

Un file compare in "Unmatched" durante Excel → Text

L'abbinamento avviene per nome file esatto dentro la cartella DWG scelta, senza ricorsione nelle sottocartelle — controlla il nome file nella cartella di lavoro rispetto a ciò che è effettivamente in quella cartella di primo livello (non una sua sottocartella), e che non sia stato rinominato dopo l'esportazione.

Le modifiche di stile non sembrano riflettersi sul testo stesso

Assicurati di aver usato Write Styles Back, non solo modificato la griglia — quello è il passo che riapplica Width Factor / Fixed Height a ogni DBText che già usa quello stile. Controlla anche il valore di Fixed Height: una Fixed Height di 0 o vuota lascia deliberatamente invariata l'altezza del testo esistente anziché azzerarla, quindi il testo non cambierà visibilmente dimensione anche se il record di stile è stato aggiornato.

Una modifica in blocco in Batch Edit Styles non sembra applicarsi

La casella di un campo deve essere selezionata perché si applichi del tutto — un campo non selezionato viene ignorato anche se vi viene digitato un valore. Per Width Factor/Fixed Height in particolare, un valore che non viene interpretato come numero viene silenziosamente saltato per quel campo anziché essere mostrato come errore, quindi verifica che sia un numero semplice.

La scrittura o la scrittura di stile di un file viene saltata anche se il backup è abilitato

Se la copia di backup di quello specifico file fallisce (ad esempio la cartella di backup non è scrivibile), TextSync salta del tutto la scrittura di quel file anziché procedere senza una copia di sicurezza. Controlla la colonna Backup del report per l'errore di quel file, correggilo (permessi della cartella, spazio su disco), e riesegui.

"Rollback All" è assente o non fa nulla

Funziona solo finché i risultati di quell'esecuzione sono ancora nella schermata Write-Back Report: dopo Finish o un riavvio dell'app, usa invece la finestra autonoma Restore Backup… (aperta da Excel → Text o Batch Edit Styles), che legge qualsiasi backup ancora su disco, compresi gli archivi Backup_*.zip delle versioni precedenti.

File su disco

Settings → Diagnostics → Open Log Folder porta direttamente ai log in caso di problemi da risolvere.

Impostazioni	%LocalAppData%\CADXChange\TextSync\settings.json
Log	%LocalAppData%\CADXChange\TextSync\Logs\
Cartella di backup predefinita	{DWG folder}\_TextSyncBackup
Cartella di esportazione predefinita	Documents\TextSync\Exports