BlockCompare ドキュメント

BlockCompareはCompare DWGモードで起動します。タイトルバーのCompare DWG / Compare with Excelスイッチで、2つ目のDWGフォルダの代わりにエクスポート済みのExcelワークブックと比較するモードに切り替えられます。どちらのモードでも、Select Files → Review Matches → 短いComparing…進捗画面 → Comparison Reportという流れで、一度に1画面ずつ進みます。ステップインジケーターはありません — 各Backボタンは、そのファイルリスト・フィルタ・編集内容がまだ残っている正確に1つ前の画面インスタンスに戻ります。レポート上のFinishは、Review Matchesではなく2ステップ前の同じSelect Files（またはSelect Excel）画面インスタンスに直接ジャンプします — そのファイルリスト、フィルタ、プロファイルも、Backをたどった場合とまったく同じ状態のまま残っています。

はじめに

スクリーンショットは比較的新しいリリースのものです —— お使いのバージョンとは見た目が多少異なる場合があります。

Comparing files

Compare DWG と Compare with Excel

通常の2フォルダワークフローと、エクスポート済みのExcelワークブックを1つのDWGフォルダと比較するモードとを切り替えるタイトルバースイッチです。

• Compare DWG（デフォルト）は、このページの残りで説明する2フォルダワークフローです。Compare with Excelは、Select Files画面のFolder AピッカーをFolder BのDWGフォルダはそのままに、単一の.xlsxワークブック — 姉妹ツールBlockSyncが生成するブロックデータのエクスポート — に置き換えます。
• モードを切り替えても、各モード自身のSelect Files状態は保持されます — Compare with Excelに切り替えてからCompare DWGに戻しても、Folder A/Bのファイルリストやフィルタ選択は失われません。

Compare with Excel — ワークブックの選択

BlockSyncがエクスポートしたブロックデータのワークブックを参照します。Folder Bは通常どおりDWGのフォルダのままです。

• Browse…で.xlsxワークブックを選びます。選択すると、画面には何もスキャンされる前に、そのワークブック内でもともと何個のブロックインスタンスが、いくつのソースファイルにまたがって記録されていたかが表示されます — 例: 「Found 13 block instance(s) across 2 source file(s) in this workbook.」
• ワークブックにすでに含まれているブロック名が、自動的に比較の対象範囲になります — このモードには別途のBlocks/Layers/Viewportsのチェックリストはありません。ワークブック自体が、BlockSyncからエクスポートされた時点で何が選択されていたかをすでに反映しているためです。
• そこから先は、Compare DWGと同じReview Matches → Comparing → Comparison Reportの流れになり、ワークブックに記録されたファイル名とFolder Bの実際のファイルとを突き合わせます — このモードでは、ワークブック側に重み付けに使えるライブなハンドルデータがないため、デフォルトの一致戦略はHybridではなくFilename priorityになります。
• Excelワークブックには解決済みのレイヤー色がないため、Layer nameは比較されますが、このモードではLayerColorは差分から除外されます — そうしなければ、すべての行に見せかけの色変更が表示されてしまうためです。

ファイルの追加（Folder A / Folder B）

比較する図面セットの「before」と「after」のリビジョンを追加します。

• Add FilesまたはAdd Folderで、Folder A（before）とFolder B（after）をそれぞれ独立に構築します。Add Folderはフォルダ全体を.dwgファイルについてスキャンしますが、サブフォルダも対象にするかどうかは「Include subfolders when adding a folder」（Settings → AutoCAD、デフォルトはオフ）で決まり、両側に適用されます。重複するパスは黙ってスキップされます。
• Folder Aでファイルを追加、削除、または全消去すると、下のBlocks/Layers/Viewportsタブに反映するための軽量な事前スキャンが自動的にトリガーされます — その間、Folder A自身のAdd/Add Folder/Clearボタンとリストは無効になります。Folder Bは、その役割が単に一致候補を提供するだけでフィルタタブを駆動するものではないため、意図的に事前スキャンされません。
• 各リストにはFile Nameと色分けされたStatus、行ごとのRemoveボタンが表示されます。まだ何も追加されていない場合、リストには空のテーブルの代わりに「No files yet — add a folder or files above.」と表示されます。

Blocks、Layers、Viewportsによるフィルタリング

Folder Aの内容に基づいて、実際に比較対象になるものを絞り込みます。

• Blocksタブは、Folder Aの事前スキャンで見つかったすべてのブロック定義を一覧表示します: Block Name、References、In Files、DynamicおよびHas Attrsのフラグ。Layersは、すべてのレイヤー名を色スウォッチとIn Files数付きで一覧表示します。Viewportsは、すべてのペーパースペースのビューポートをLayout、Layer、Width、Heightで一覧表示します。
• 各タブには独自のSearchボックスがあります。All / None / Invertは、現在の検索結果に表示されているものだけに作用し、フィルタされていない全リストには作用しません。
• タブで何もチェックしなければ通常どおりすべてを比較します。特定のブロック/レイヤーをチェックすると、そもそもScan & Matchが読み取る対象が制限されます。一方Viewportsの選択は、スキャン後に別途の境界ボックスフィルタとして適用され、実際にチェックされたビューポートのいずれかに収まるブロックインスタンスのみが残されます。
• 他のCADXChange比較ツールの一部とは異なり、タブごとに別々の保存プロファイルを持つのではなく、3つのタブすべてに共通の単一のFilterプロファイルがあります（次のセクションを参照）。

一致戦略、確信度、保存プロファイル

BlockCompareがどの「before」ファイルとどの「after」ファイルを組み合わせるかを決める仕組みです。

• Match strategy — Filename priority、Handle priority、またはHybrid（デフォルト）— は、提案されるペアリングがファイル名の類似性と2つのファイルが共有するブロックハンドルの数のどちらをどれだけ重視するかを設定します。Hybridはハンドルの手がかりを重視し、これがリビジョンでファイル名も変更された場合でも一致を正しく保つ要因になります。
• Confidenceスライダー（0.00〜1.00、デフォルト0.15）は、提案されたペアリングの合算スコアが自動的に受理されるために超える必要がある基準値です。この値を下回るペアリングは代わりに未一致のまま残され、次の画面で手動でペアリングします。スライダーを上げるとマッチングが厳しくなり、下げると弱い推測でも自動的に受理されます。
• Filter profileのSave…は、現在のBlocks/Layers/Viewportsの選択に名前を付けて保存します。Loadは保存済みの選択を適用し、名前が一致する行はチェックし、残りはチェックなしのままにします。Freeプランは一度に1つのプロファイルしか保存できません — 2つ目の新しい名前を保存しようとすると、既存のものを黙って置き換える代わりにアップグレードの案内が表示されます（同じ名前での再上書きは常に許可されます）。

Scan & Match

両方のフォルダを読み取り、ファイル同士のペアリングを提案します — 実際にすべてのDWGを開くステップです。

• Freeプランはこれを片側あたり3ファイルまでに制限します（Folder AとFolder Bは別々にカウントされます）— 超えると、何もスキャンされる前に、上限を名指ししたメッセージとともに実行全体がブロックされ、部分的なバッチがスキャンされることはありません。
• Folder A、続いてFolder Bをスキャンし、1スロットあたり1ファイルずつバックグラウンドで処理します。並列数はSettingsの「Max Parallel AutoCAD Instances」の値にかかわらずFreeでは1に制限されるため、Freeのスキャンは常に1ファイルずつ実行されます。各ファイル自身のMD5ハッシュもここで計算され、後でバイト単位で同一のペアを検出するために使われます。
• スキャンに失敗したファイルはエラー内容とともにマークされ、バッチの残りのスキャンを止めることはありません。その失敗は、突き合わせる相手がないファイルとしてマッチングにも引き継がれます。
• マッチング自体は（単純な最近傍一致ではなく）Folder A/Folder Bのすべてのペアにわたるグローバルな最適割り当てであるため、あるファイルにとって見た目上ベストなペアリングが、別のファイルがより必要としていたパートナーを奪うことはありません。
• このステップにCancelボタンはありませんが、各ファイルには10分の制限があります。破損した、または非常に大きなDWGでAutoCADが応答しなくなった場合は打ち切られ、失敗として表示されます。読み取れなかったファイルは比較から除外されて次の画面に表示され、「すべて追加/削除」として報告されることはありません。

Review Matches

何かが比較される前に、提案されたbefore/afterファイルのペアリングを確認または修正します。

• 各行は、提案されたFile B（Folder Bのすべてのファイルを一覧表示する編集可能なドロップダウン）と並べてFile Aを表示し、Filename %、Handle %、Combined %のスコアが付きます — これらのパーセンテージは元々提案されたペアリングを反映したものであり、ドロップダウンから手動で別のFile Bを選んでも再計算されません。
• 赤くハイライトされた行はコンフリクトです — そのファイルについて、ファイル名のみによる最良一致とハンドルのみによる最良一致が互いに（または選択されたペアリングと）食い違っています — Conflict candidateが示されるので、決定する前に次点候補を確認できます。
• 確信度の高い一致がないFolder Aのファイルは、File Bが選択されておらずExcludeがすでにチェックされた独自の行として始まります — File Bを選んで自分でExcludeのチェックを外さない限り、比較から除外されたままです。
• Change StrategyとRe-matchは、すでにスキャン済みのスナップショットに対してのみマッチングアルゴリズムを再実行します — DWGは再読み込みされないため実質的に瞬時ですが、すべての行を置き換えるため、前回のスキャン以降に行った手動のFile Bの上書きやExcludeの変更は破棄されます。
• Compareは、少なくとも1行が除外されておらず、かつFile Bが選択されている場合にのみ有効になります。

Comparing（進捗画面）

マッチの確認からレポート表示までの短い進捗画面です — ここにもCancelボタンはありません。

• 確定したペアは順番に1組ずつ比較され、各ペアが完了するたびに進捗バーと「Comparing {n}/{total}: {File A} vs {File B}」のステータスが更新されます。
• この画面にはBackもCancelもありません — 最後のペアが完了した瞬間に、自動的にComparison Reportへ遷移します。

Comparison Report

一致した各ペアを、単に「異なる」とフラグを立てるのではなく、フィールドごとに示します。

• 結果は一致したペアごとにグループ化され、それぞれ「{File A} → {File B}」を見出しとする独自の展開可能なセクションとして表示されます。ファイルのハッシュがバイト単位で同一のペアは「Identical file — comparison skipped.」として報告され、詳細リストは一切ありません — そのペアについてはブロックごとの差分処理は実行されません。
• 差分は名前や位置ではなく、AutoCAD自身の永続オブジェクトハンドルで突き合わされるため、移動または名前変更されたブロックも、1件の削除と1件の追加として報告されるのではなく、同じインスタンスとして正しく認識されます。
• 各エントリはHandle、Block Name、Kind（Added/Removed/Modified）、変更されたフィールド数を表示します。変更されていないブロックインスタンスはこの画面上のリストから完全に除外されます — 各グループのサマリー行には引き続きカウントされますが、行単位では表示されません。これにより、数千の変更されていないインスタンスを含む図面でも、実際に変更されたわずかな件数が埋もれることはありません。
• Details…（少なくとも1つのフィールドが変更されている場合のみ有効）は、変更されたすべてのフィールドの新旧の値を並べて示す小さなポップアップを開きます。すでに開いている状態で別の行のDetailsをクリックすると、先に閉じる必要なく対象が切り替わるだけです。
• ページ全体のサマリー行は、各グループ自身のサマリーにはUnchanged件数が表示されているにもかかわらず、意図的にそれを省いています。

Exporting to Excel

Export to Excel

同じ比較結果を、BlockCompareがインストールされていなくても誰でも開けるワークブックに書き出します — 画面上のレポートが省略している内容もすべて含まれます。

• 比較されたすべてのペアにまたがる、区別されるブロック名ごとに1シート、加えてアプリ/AutoCADのバージョンと各ペア自身のファイル名およびMD5ハッシュを一覧表示するメタデータシートが1枚あります（これにより、どのペアが同一だったかを独立して確認できます）。
• 画面上のレポートとは異なり、エクスポートされたシートにはAdded/Modified/Removedと並んでUnchangedの行も含まれます — 画面から省かれているだけで、ファイルからは何も省かれません。
• Added行は緑で塗りつぶされます。Removed行は赤で塗りつぶされ、取り消し線付きのテキストになります。Modified行は行全体は塗りつぶされませんが、変更されたすべてのセルにその古い値を記録するコメントが付き、グリッド上には新しい値が表示されたまま、古い値はホバーで確認できます — これはここで説明したデフォルトの「1レコードにつき1行」レイアウトです。代替レイアウトについては次のセクションを参照してください。
• エクスポートされたシートのStatus列は、画面上のKind列とは異なる表記を使います — Excelでは「Removed」「Modified」ではなく「Deleted」「Altered」です。両者を突き合わせる際には知っておく価値があります。
• エクスポート自体には行数の上限もFree/Proのゲートもありません — Freeでも任意のサイズのレポートをエクスポートできます。BlockCompareにおけるFreeプランの唯一の制限は、Scan & Matchの片側あたり3ファイルまでの上限です。

レポートレイアウトの選択

Export to Excelは、まず2種類の行レイアウトのどちらでレポートを書き出すかを尋ねる小さなダイアログを開きます。

• One row per record（デフォルト）は前のセクションで説明したレイアウトです。変更されたフィールドの古い値がセルコメントとして添えられます。
• Adjacent before/after rowsは代わりに、すべてのModifiedインスタンスを2行に展開します — どのように見えるかは次のセクションを参照してください。
• この選択はModifiedインスタンスのレイアウトにのみ影響します。Added、Removed、Unchangedの行はどちらを選んでも同じように書き込まれます。

2行のbefore/afterレイアウト

代替レイアウト: Modifiedインスタンスの新旧の値が、1行ではなく隣接する2行に並び、両方の行で変更されたフィールドがハイライトされます。

• Modifiedインスタンスは1行ではなく2行になります — 1行目に古い値、2行目に新しい値です。古い値を1行のコメントに折りたたむのではなく、このようにします。
• Status列は1行目に「┌ ALTERED」、2行目に「└ ALTERED」と表示されます。これにより、シートがフィルタや並べ替えでばらばらになっても、2行が隣り合っていることに頼ることなく、そのペアが1つのつながった単位として読み取れます。
• 2行の間で実際に変更されたすべてのフィールドが（コメントで注記するだけでなく）ハイライトされるため、レビュー担当者はフラグの付いたセルを1つずつホバーする代わりに、2つの完全な行を並べて確認できます。
• Added、Removed、Unchangedのインスタンスはこの選択の影響を受けず、どちらの場合でも単一行のままです。これらにはペアにする「before」や「after」側が存在しないためです。