TextCompareÜberblick Dokumentation Preise Download Änderungsprotokoll

TextCompare Dokumentation

TextCompare startet im Modus Compare DWG; ein Compare DWG / Compare with Excel-Schalter in der Titelleiste wechselt zum Vergleich mit einer exportierten Excel-Arbeitsmappe statt einem zweiten DWG-Ordner. Beide Modi durchlaufen dann jeweils einen Bildschirm nach dem anderen: Select Files → Review Matches → einen kurzen Fortschrittsbildschirm Comparing… → Comparison Report. Die App liest ausschließlich DWGs — es gibt nirgends in der App einen Zurückschreib- oder Backup-Schritt, da Vergleichen und Exportieren ihr gesamter Funktionsumfang ist.

Erste Schritte

Die Screenshots stammen aus einer aktuelleren Version — optische Details können von Ihrer installierten Version abweichen.

Comparing files

Compare DWG vs. Compare with Excel

Ein Schalter in der Titelleiste zwischen dem normalen Zwei-Ordner-Workflow und dem Vergleich einer exportierten Excel-Arbeitsmappe mit einem DWG-Ordner.

Compare DWG (die Standardeinstellung) ist der Zwei-Ordner-Workflow, der im Rest dieser Seite beschrieben wird. Compare with Excel ersetzt die Folder A-Auswahl des Select Files-Bildschirms durch eine einzelne .xlsx-Arbeitsmappe — den Textdaten-Export des begleitenden Tools TextSync — während Folder B ein normaler Ordner voller DWGs bleibt.
Der Moduswechsel behält den eigenen Select Files-Zustand jedes Modus bei — zu Compare with Excel und zurück zu Compare DWG zu wechseln verliert nicht die Dateilisten oder Filterauswahlen von Folder A/B.

Compare with Excel — die Arbeitsmappe auswählen

Zur von TextSync exportierten Textdaten-Arbeitsmappe navigieren; Folder B bleibt ein normaler Ordner voller DWGs.

Browse… wählt die .xlsx-Arbeitsmappe. Einmal ausgewählt, meldet der Bildschirm, wie viele Texteinträge gefunden wurden und über wie viele ursprünglich darin erfasste Quelldateien — z. B. "Found 1023 text entry(ies) across 3 source file(s) in this workbook." — bevor überhaupt etwas gescannt wird.
Die bereits in der Arbeitsmappe vorhandenen Layernamen werden automatisch zum Vergleichsumfang; für diesen Modus gibt es keine separate Layers/Viewports-Checkliste, da die Arbeitsmappe selbst bereits widerspiegelt, was beim Export aus TextSync ausgewählt war.
Von dort an läuft derselbe Ablauf Review Matches → Comparing → Comparison Report wie bei Compare DWG, wobei die in der Arbeitsmappe erfassten Dateinamen mit den tatsächlichen Dateien von Folder B abgeglichen werden — Filename priority ist hier die Standard-Abgleichstrategie statt Hybrid, da die Arbeitsmappenseite keine eigenen Live-Handle-Daten besitzt, mit denen ein Hybrid-Abgleich gewichtet werden könnte.
Eine Excel-Arbeitsmappe besitzt keine aufgelöste Layerfarbe, daher wird Layer name weiterhin verglichen, LayerColor jedoch in diesem Modus aus dem Diff ausgelassen — sonst würde jede einzelne Zeile eine unechte Farbänderung anzeigen. Die Arbeitsmappe erfasst zudem nie die Texthöhe, daher wird auch TextHeight aus dem Diff ausgelassen.

Dateien hinzufügen (Folder A / Folder B)

Die 'Vorher'- und 'Nachher'-Revisionen des zu vergleichenden Zeichnungssatzes hinzufügen.

Add Files oder Add Folder baut Folder A (vorher) und Folder B (nachher) unabhängig voneinander auf. Add Folder durchsucht einen ganzen Ordner nach .dwg-Dateien — ob dabei auch Unterordner durchsucht werden, hängt von "Include subfolders when adding a folder" ab (Settings → AutoCAD, standardmäßig aus), was für beide Seiten gilt.
Die Free-Edition begrenzt dies auf 3 Dateien pro Seite (Folder A und Folder B getrennt gezählt) — das Überschreiten blockiert den gesamten Lauf, bevor überhaupt etwas gescannt wird, mit einer Meldung, die die Grenze benennt.

Filtern mit Layers und Viewports

Den Vergleich auf bestimmte Layer oder Papierbereichs-Viewports eingrenzen — hier gibt es keinen Blocks-Tab.

Anders als bei BlockCompare gibt es keinen Blocks-Tab — Blocknamen sind in TextCompare kein nutzerseitiger Filter, da Blockreferenzen hier von vornherein nie verglichen werden (siehe Comparison Report unten).
Der Layers-Tab ist der eigentliche Filter: Nur DBText/MText-Entitäten auf einem markierten Layer werden überhaupt gelesen. Nichts zu markieren vergleicht wie gewohnt jeden Layer.
Der Viewports-Tab filtert über einen Positions-/Begrenzungsrahmen-Test, der nach dem Scannen angewendet wird und nur Entitäten behält, die tatsächlich innerhalb eines markierten Papierbereichs-Viewports liegen.
Blockreferenzen werden unabhängig von diesen Filtern weiterhin während des Scannens gelesen, aber ausschließlich, um dem Dateiabgleichs-Algorithmus einen Handle-Fingerabdruck zum Paaren von Dateien zu liefern — im Vergleich selbst tauchen sie nie auf.

Abgleichstrategie, Konfidenz und gespeicherte Profile

Wie TextCompare entscheidet, welche 'Vorher'-Datei zu welcher 'Nachher'-Datei gehört.

Match strategy — Filename priority, Handle priority oder Hybrid (Standard) — legt fest, wie stark eine vorgeschlagene Paarung die Dateinamensähnlichkeit gegenüber der Anzahl gemeinsamer Block-Handles zweier Dateien gewichtet (Hybrid gewichtet 40 % Dateiname / 60 % Handle). Hybrid hält einen Abgleich auch dann korrekt, wenn eine Revision die Datei zusätzlich umbenennt.
Der Confidence-Regler (0,00–1,00, Standard 0,15) ist die Schwelle, die der kombinierte Score einer vorgeschlagenen Paarung überschreiten muss, um automatisch akzeptiert zu werden; eine Paarung, die darunter liegt, bleibt stattdessen unabgeglichen, für die manuelle Zuordnung auf dem nächsten Bildschirm.
Save… / Load speichert die aktuelle Layers/Viewports-Auswahl unter einem Namen (nicht die Abgleichstrategie oder den Confidence-Wert). Die Free-Edition behält jeweils nur ein gespeichertes Profil — das Speichern eines zweiten zeigt statt eines stillen Überschreibens einen Upgrade-Hinweis.

Scan & Match

Liest beide Ordner ein und schlägt Datei-zu-Datei-Paarungen vor.

Scannt Folder A, dann Folder B, wobei pro Slot im Hintergrund jeweils eine Datei verarbeitet wird; die Parallelität ist für Free unabhängig vom Settings-Wert "Max Parallel AutoCAD Instances" auf 1 begrenzt. Auch der MD5-Hash jeder Datei wird hier berechnet und später genutzt, um ein byte-identisches Paar zu erkennen.
In diesem Schritt gibt es keine Cancel-Schaltfläche, aber jede Datei hat ein eigenes Zeitlimit von 10 Minuten – reagiert AutoCAD bei einer beschädigten oder ungewöhnlich großen DWG nicht mehr, wird sie abgebrochen und als fehlgeschlagen markiert. Eine nicht lesbare Datei wird vom Vergleich ausgeschlossen und im nächsten Bildschirm genannt, statt als vollständig hinzugefügt oder entfernt gemeldet zu werden.

Review Matches

Die vorgeschlagenen Vorher/Nachher-Dateipaarungen bestätigen oder korrigieren, bevor irgendetwas verglichen wird.

Jede Zeile zeigt File A neben dem vorgeschlagenen File B (ein bearbeitbares Dropdown mit jeder Folder B-Datei), mit den Werten Filename %, Handle % und Combined %.
Rot markierte Zeilen sind Konflikte — der beste rein dateinamensbasierte Treffer und der beste rein handlebasierte Treffer für diese Datei stimmen nicht miteinander (oder mit der gewählten Paarung) überein — und benennen einen Conflict candidate, sodass der Zweitplatzierte vor der Entscheidung sichtbar ist.
Eine Folder A-Datei ohne zuverlässigen Treffer beginnt als eigene Zeile ohne ausgewähltes File B und bereits aktiviertem Exclude — sie wird vom Vergleich ausgeschlossen, sofern nicht selbst ein File B gewählt und Exclude deaktiviert wird.
Re-match führt den Abgleichalgorithmus erneut aus, rein gegen die bereits gescannten Snapshots — es werden keine DWGs erneut gelesen —, aber jede Zeile wird dabei ersetzt, wodurch manuelle File B-Überschreibungen oder Exclude-Änderungen seit dem letzten Scan verworfen werden.

Comparing (Fortschrittsbildschirm)

Ein kurzer Fortschrittsbildschirm zwischen der Bestätigung der Paarungen und dem Bericht — auch hier keine Cancel-Schaltfläche.

Dieser Schritt ist ein reiner Diff im Arbeitsspeicher der bereits gescannten Snapshots — es werden keine DWGs erneut geöffnet, sodass er auch bei einem großen Batch schnell abläuft.
Dieser Bildschirm hat kein Back und kein Cancel — er navigiert automatisch zum Comparison Report, sobald das letzte Paar fertig ist.

Comparison Report

Jede Wortlaut- oder Inhaltsänderung, Eintrag für Eintrag — ausschließlich Text, nie Blockreferenzen oder Attribute.

Es werden nur DBText/MText-Entitäten verglichen. Blockreferenzen werden ausschließlich gescannt, um Dateien einander zuzuordnen (siehe Filtern oben), und tauchen nie als Einträge im Bericht auf.
Ergebnisse sind pro abgeglichenem Paar gruppiert. Ein Paar, dessen Dateien byte-identisch hashen, wird als "Identical file — comparison skipped" gemeldet, ohne dass für dieses Paar ein entitätsweiser Diff läuft.
Jeder Eintrag zeigt Handle, Block Name (wörtlich "DBText" oder "MText"), Kind (Added/Removed/Modified) und den Textinhalt, plus wie viele Felder sich geändert haben — Details… zeigt jeden geänderten Feldwert alt und neu nebeneinander, einschließlich des Texts selbst, der Position, Höhe, Layer und Farbe.
Unveränderte Einträge werden auf dem Bildschirm überhaupt nicht aufgelistet, sodass ein stark annotiertes Blatt die Handvoll echter Wortlautänderungen nicht begräbt.

Exporting to Excel

Export to Excel

Derselbe Vergleich, geschrieben in eine Arbeitsmappe, die jeder ohne installiertes TextCompare öffnen kann.

Ein Arbeitsblatt pro Entitätsart (in der Praxis B_DBText / B_MText), plus ein Metadaten-Blatt mit den Dateinamen, MD5-Hashes jedes Paars und ob es als identisch übersprungen wurde.
Anders als der Bildschirmbericht enthält das exportierte Blatt Unchanged-Zeilen neben Added/Modified/Removed — nichts wird aus der Datei ausgelassen, nur aus der Bildschirmansicht.
Added-Zeilen sind grün gefüllt; Removed-Zeilen sind rot gefüllt mit durchgestrichenem Text; Modified-Zeilen tragen an jeder geänderten Zelle einen Kommentar mit ihrem alten Wert, mit separaten Spalten "TextContent A"/"TextContent B" für den Text selbst — dies ist das Standardlayout "eine Zeile pro Datensatz", das hier beschrieben wird; siehe nächster Abschnitt für die Alternative.
Die Status-Spalte im exportierten Blatt verwendet "Deleted"/"Altered", wo die Kind-Spalte auf dem Bildschirm "Removed"/"Modified" sagt — gleiche Bedeutung, unterschiedliche Bezeichnung zwischen den beiden Ansichten.
Es gibt keine Zeilenobergrenze oder Free/Pro-Sperre für den Export selbst — die einzige Free-Edition-Grenze in TextCompare ist die Obergrenze von 3 Dateien pro Seite bei Scan & Match.

Ein Berichtslayout wählen

Export to Excel öffnet zunächst einen kleinen Dialog, der fragt, in welchem von zwei Zeilenlayouts der Bericht geschrieben werden soll.

One row per record (die Standardeinstellung) ist das im vorigen Abschnitt beschriebene Layout: Der alte Wert eines geänderten Felds fährt als Zellenkommentar mit, und TextContent erhält ein eigenes A/B-Spaltenpaar.
Adjacent before/after rows dehnt stattdessen jeden Modified-Eintrag auf zwei Zeilen aus, die sich eine einzige TextContent-Spalte teilen — siehe nächster Abschnitt, wie das aussieht.
Die Wahl wirkt sich nur darauf aus, wie Modified-Einträge angeordnet werden; Added-, Removed- und Unchanged-Zeilen werden in beiden Fällen gleich geschrieben.

Zweizeiliges Vorher/Nachher-Layout

Das alternative Layout: Der alte und der neue Wert eines Modified-Eintrags stehen in zwei benachbarten Zeilen statt in einer, mit auf beiden hervorgehobenen geänderten Feldern.

Ein Modified-Eintrag erhält zwei Zeilen statt einer — die erste mit ihren alten Werten, die zweite mit ihren neuen —, wobei sich beide eine Spalte "TextContent" teilen statt des separaten Paars "TextContent A"/"TextContent B" im Standardlayout.
Die Status-Spalte liest in der ersten Zeile "┌ ALTERED" und in der zweiten "└ ALTERED", sodass das Paar auch nach dem Filtern oder Sortieren des Blatts als eine verbundene Einheit lesbar bleibt, statt sich darauf zu verlassen, dass die beiden Zeilen nebeneinander bleiben.
Jedes Feld, das sich zwischen den beiden Zeilen tatsächlich geändert hat, wird hervorgehoben (nicht nur in einem Kommentar vermerkt), sodass ein Prüfer zwei vollständige Zeilen nebeneinander überfliegen kann, statt jede markierte Zelle einzeln per Mouseover zu prüfen.
Added-, Removed- und Unchanged-Einträge sind von dieser Wahl unberührt und bleiben in jedem Fall einzeilig, da es für sie keine fehlende "Vorher"- oder "Nachher"-Seite zum Paaren gibt.

Einstellungen

Wird über das Zahnrad-Symbol in der Titelleiste geöffnet. Jedes Feld wird sofort gespeichert — es gibt keine separate Speichern-Schaltfläche.

Language

Settings → General

Englisch / 简体中文 / 繁體中文 / 日本語 / 한국어 / Deutsch / Français / Italiano / Español. Für die Wirksamkeit eines Sprachwechsels ist ein Neustart der App erforderlich.

Standard: English

Theme

Settings → General

System / Light / Dark. Für die Wirksamkeit eines Themenwechsels ist ein Neustart der App erforderlich.

Standard: Match system

AutoCAD version

Settings → AutoCAD

Welche installierte AutoCAD-Version zuerst verwendet werden soll. Schlägt das Laden fehl, greift die App automatisch auf eine andere installierte Version zurück.

Standard: Auto (newest installed)

Max parallel AutoCAD instances

Settings → AutoCAD

Wie viele Zeichnungen AutoCAD gleichzeitig im Hintergrund verarbeiten kann (Auswahl: 1, 2, 4, 6, 8, 12, 16). Höher ist schneller, verbraucht aber mehr CPU und Arbeitsspeicher — auf einem schwächeren Rechner diesen Wert reduzieren.

Standard: 8

Include subfolders when adding a folder

Settings → AutoCAD

Gilt für Add Folder auf dem Bildschirm Select Files, sowohl für Folder A als auch für Folder B.

Standard: Off

Lizenzierung

Ihr Lizenzstatus wird in der Titelleiste als Free, Pro, Pro (offline) oder Expired angezeigt, und vollständig unter Settings → License.

Zum Aktivieren: Fügen Sie Ihren Lizenzschlüssel bei Settings → License → "License key" ein und klicken Sie auf Activate. Um eine Lizenz auf einen neuen Rechner zu übertragen, klicken Sie auf dem alten zuerst auf "Deactivate this machine" und aktivieren dann auf dem neuen.

Kann die App den Lizenzserver nicht erreichen (kein Internet oder Server vorübergehend nicht verfügbar), funktioniert eine zuvor aktivierte Pro-Lizenz 14 Tage lang als „Pro (offline)“ weiter. Stellen Sie innerhalb dieses Zeitraums eine Verbindung her, um sie erneut zu prüfen – nach 14 Tagen ohne erfolgreiche Prüfung, nach dem Enddatum des Abonnements oder wenn die Systemuhr zurückgestellt wurde, wird die Lizenz als Expired angezeigt, bis sie erneut geprüft werden kann.

Fehlerbehebung

"AutoCAD not found" oder ein Plugin-Vertrauensfehler beim Starten eines Auftrags

Die App steuert AutoCAD im Hintergrund, um jede Zeichnung zu öffnen und zu verarbeiten, und benötigt daher eine vollständige, lizenzierte AutoCAD-Installation (2021–2027) — AutoCAD LT wird nicht unterstützt. Ist AutoCAD installiert und dieser Fehler tritt trotzdem auf, wurde diese AutoCAD-Version auf diesem Rechner wahrscheinlich noch nie gestartet: Öffnen Sie sie einmal (auch nur bis zum Zeichnungsbildschirm), schließen Sie sie und versuchen Sie es erneut — AutoCAD vertraut einem Plugin-Speicherort erst, nachdem es mindestens einmal interaktiv ausgeführt wurde.

Eine Zeile ist in Review Matches rot markiert

Der rein dateinamensbasierte und der rein handlebasierte Treffer sind sich uneinig, zu welcher "Nachher"-Datei diese gehört. Prüfen Sie die Spalte Conflict candidate, und bestätigen, überschreiben oder schließen Sie die Zeile dann mit Exclude aus.

Das Scannen scheint zu hängen

Während Scan & Match hat jede Datei ein Zeitlimit von 10 Minuten – ein hängender AutoCAD-Hintergrundprozess (häufigste Ursache ist eine beschädigte oder ungewöhnlich große DWG) wird beendet und die Datei als fehlgeschlagen markiert. Nicht lesbare Dateien werden vom Abgleich ausgeschlossen und im Bildschirm Review matches aufgeführt. Die zuletzt gelesene Datei steht im Protokollordner.

Eine hinzugefügte Datei erscheint nicht im Comparison Report

Eine Folder A-Datei ohne zuverlässigen Treffer beginnt auf dem Bildschirm Review Matches vorab ausgeschlossen (kein File B gewählt, Exclude aktiviert) — sie wird stillschweigend vom Vergleich ausgeschlossen, sofern Sie nicht zurückgehen, ein File B dafür wählen und Exclude deaktivieren.

Re-match scheint gerade hinzugefügte oder entfernte Dateien nicht zu berücksichtigen

Re-match führt den Abgleichalgorithmus nur erneut gegen die bereits gescannten Daten aus — es liest nie erneut eine DWG. Um hinzugefügte oder entfernte Dateien zu erfassen, gehen Sie zurück zu Select Files und führen Scan & Match erneut aus.

Dateien auf der Festplatte

Über Settings → Diagnostics → Open Log Folder gelangen Sie direkt zu den Protokollen, falls eine Fehlerbehebung nötig ist.

Einstellungen	%LocalAppData%\CADXChange\TextCompare\settings.json
Protokolle	%LocalAppData%\CADXChange\TextCompare\Logs\
Filterprofile	%LocalAppData%\CADXChange\TextCompare\Profiles\