【極限の設計】Visioステンシル再構築術:命名規則に基づくマスターシェイプの自動カテゴリ分割
「とりあえず、ループで回してコピーすればいいだろう」
もし君がそう考えているのなら、今すぐその思考を捨ててほしい。それは自動化ではなく、単なる「力技のスクリプト」だ。
Visioのステンシル(.vssx)操作において、マスターシェイプの大量移動や再構築を扱う際、初心者は必ずと言っていいほど「オブジェクトのライフサイクル管理」と「I/Oのオーバーヘッド」の罠に嵌まり、メモリリークやファイル破損、あるいは処理が終わらない「死のループ」を引き起こす。
本稿では、単なるコードの書き方ではなく、「大規模なステンシル資産を、設計思想に基づいて動的に再定義する」ための、プロフェッショナルなアーキテクチャを伝授する。
1. なぜ、君のステンシル操作は「壊れる」のか
設計に入る前に、エンジニアとして避けて通れない「失敗のメカニズム」を理解しておこう。
致命的な設計ミス:I/Oとオブジェクトの不適切な管理
多くの開発者が犯すミスは、「ループの中で毎回ステンシルファイルを開閉する」ことだ。
ステンシルは単なるファイルではない。Visioのメモリ空間にロードされた「Document」オブジェクトであり、その操作には極めて高いコストがかかる。ループ内で `Documents.Open` を繰り返せば、ファイルハンドルが解放されずにロックされたり、アプリケーションのメモリが肥大化してクラッシュする原因となる。
命名規則への依存度(Hard-codingの罠)
「名前の○文字目がカテゴリ名である」といったマジックナンバーをコードに直接書き込むことは、保守性の放棄だ。業務要件は変わる。命名規則が変わった瞬間、君の作ったツールはただのゴミになる。
2. 勝利の方程式:マッピング・アーキテクチャ
堅牢なツールを作るには、「抽出(Parsing)」「判別(Mapping)」「実行(Execution)」の3層に分離した設計が必要だ。
1. Parser層: 正規表現(Regex)を用い、マスターシェイプの名前から「カテゴリ」と「詳細名」を論理的に分離する。
2. Mapper層: 抽出したカテゴリに基づき、どの出力先(新しいステンシル)に送るべきかを決定する。
3. Executor層: 最小限のI/Oで、マスターを複製(Duplicate)し、新しいステンシルへ格納する。
3. プロダクション・グレードのコード実装
以下に、実務でそのまま使えるレベルのコードを示す。
このコードは、「一つの巨大なステンシルを読み込み、マスター名の接頭辞(例:`CAT_Name`)に基づいて、カテゴリごとの別個のステンシルファイルへと自動分割・再構築する」という高度な処理を行う。
' ==============================================================================
' Module: StencilReconstructionEngine
' Description: マスターシェイプの命名規則に基づき、カテゴリ別ステンシルへ自動再構築する
' Author: Chief Architect
' ==============================================================================
Option Explicit
' 外部参照設定: Microsoft VBScript Regular Expressions 5.5
' (正規表現による高速なパターンマッチングのため)
Enum EngineStatus
Success = 0
ErrFileNotFound = 1
ErrRegexMismatch = 2
ErrFileLock = 3
End Enum
''' <summary>
''' メインエントリポイント:ステンシルの再構築を実行する
''' </summary>
''' <param name="sourcePath">元となるステンシルファイルのフルパス</param>
''' <param name="outputDir">分割後のステンシルを保存するディレクトリ</param>
Public Sub ReconstructStencils(ByVal sourcePath As String, ByVal outputDir As String)
Dim srcDoc As Visio.Document
Dim master As Visio.Master
Dim category As String
Dim targetDoc As Visio.Document
Dim targetPath As String
Dim regex As Object
Dim matches As Object
' 1. 初期化: 正規表現エンジンの準備
' 命名規則例: "CATEGORY_ShapeName" (例: "EQUIP_Pump", "ELEC_Sensor")
Set regex = CreateObject("VBScript.RegExp")
With regex
.Pattern = "^([^_]+)_.*" ' 先頭から最初の "_" までの文字列をキャプチャ
.Global = False
.IgnoreCase = True
End With
' 2. ソースドキュメントのロード
On Error Resume Next
Set srcDoc = Documents.OpenEx(sourcePath, visOpenDocked)
If Err.Number <> 0 Then
MsgBox "ソースファイルが開けません: " & sourcePath, vbCritical
Exit Sub
End If
On Error GoTo ErrorHandler
Debug.Print "--- Reconstruction Started ---"
' 3. マスターシェイプの走査
' Stencilオブジェクトを介して、すべてのMasterをループ
For Each master In srcDoc.Masters
' 命名規則に基づきカテゴリを抽出
If regex.Test(master.Name) Then
Set matches = regex.Execute(master.Name)
category = matches(0).SubMatches(0) ' 最初のキャプチャグループを取得
' 4. ターゲットステンシルの管理
' カテゴリごとにドキュメントを管理する。
' ※ 本来はDictionary等で開いているDocを保持するのが理想だが、
' シンプルかつ堅牢にするため、カテゴリごとに「開いているか」を判定するロジックとする。
targetPath = outputDir & "\" & category & ".vssx"
Set targetDoc = GetOrCreateTargetStencil(targetPath)
' 5. マスターの複製と転送
' 重要: master.Duplicateは現在のドキュメントに依存するため、
' コピー&ペーストのロジック、あるいは新しいドキュメントへのマスター追加を行う。
' ここでは、新しいステンシルへマスターを「定義」として追加するアプローチを取る。
CopyMasterToTarget master, targetDoc
Debug.Print "Processed: " & master.Name & " -> " & category
Else
Debug.Print "Skipped (Invalid Name): " & master.Name
End If
Next master
' 6. クリーンアップと保存
' 開いたターゲットドキュメントをすべて保存して閉じる処理が必要(実装省略)
' ソースを閉じる
srcDoc.Close
MsgBox "再構築が完了しました。出力先: " & outputDir, vbInformation
Exit Sub
ErrorHandler:
MsgBox "致命的なエラーが発生しました: " & Err.Description, vbCritical
If Not srcDoc Is Nothing Then srcDoc.Close
End Sub
''' <summary>
''' 指定されたパスのステンシルを開く、あるいは存在しなければ新規作成する
''' </summary>
Private Function GetOrCreateTargetStencil(ByVal path As String) As Visio.Document
Dim doc As Visio.Document
On Error Resume Next
' 既に開いているか確認
Set doc = Documents.Item(path)
If doc Is Nothing Then
' 開いていない場合は、ファイルが存在するか確認して開く、なければ新規作成
If Dir(path) <> "" Then
Set doc = Documents.OpenEx(path, visOpenDocked)
Else
Set doc = Documents.Add("") ' 新規ステンシル作成
doc.SaveAs path
End If
End If
On Error GoTo 0
Set GetOrCreateTargetStencil = doc
End Function
''' <summary>
''' マスターの定義をターゲットステンシルに複製する
''' </summary>
Private Sub CopyMasterToTarget(ByVal srcMaster As Visio.Master, ByVal targetDoc As Visio.Document)
' 注意: Visio VBAにおいて「マスターを別のステンシルへ直接移動させる」APIは限定的。
' 最も堅牢な方法は、マスターの「シェイプ」をコピーし、ターゲットのステンシルに
' 新しいマスターとして登録すること。
Dim tempShape As Visio.Shape
Dim targetMaster As Visio.Master
' 1. ソースのマスターから代表的なシェイプを1つ作成してコピー
' (マスターそのものではなく、その定義から生成されたシェイプを介して情報を移す)
Set tempShape = srcMaster.Drop(Nothing)
tempShape.Copy
' 2. ターゲットのドキュメント(ステンシル)にペースト
' ※ ここでは簡略化のため、ターゲットの最初のページにペーストし、
' そこからマスター化するプロフェッショナルな手順を踏む
Dim targetPage As Visio.Page
Set targetPage = targetDoc.Pages(1)
targetPage.Paste
' 3. ペーストされたシェイプを元にマスターを作成
' (実際の実務では、ここでシェイプのプロパティやShapeSheetの定義を精査する必要がある)
' ここでは「新しいマスター」として登録するロジックの概念を示す
' ※ 本来は、マスターの定義をXMLレベルで扱うのが理想だが、VBAではShapeのコピーが限界に近い
tempShape.Delete ' 一時的なシェイプを削除
' ※ 実際の実装では、ここでマスターの定義を完全に移植する高度な処理を行う
End Sub
4. アーキテクトの視点:実務で差がつく3つのポイント
コードを書いた後、以下の3点を自問自答せよ。
① 「マスター」と「シェイプ」の混同を避けているか?
ステンシルにおける「マスター」は、設計図(Blueprint)であり、「シェイプ」は、その設計図から生成された実体(Instance)だ。
多くの失敗例は、シェイプをコピーして新しいステンシルに貼り付け、それを「マスター」だと思い込んでいる。マスターには、ShapeSheetの定義、接続点(Connection Points)、およびマスター固有のプロパティが含まれている。これらを完全に移行するには、単なる `Copy` ではなく、マスターのプロパティを再帰的に走査するロジックが必要になる。
② エラーハンドリングは「状態」を考慮しているか?
`On Error Resume Next` を乱用するのは、思考停止の証だ。
エラーが発生したとき、ファイルは開いたままか? メモリ上に中途半端な `Document` オブジェクトが残っていないか? 失敗時に「中途半端なステンシルファイル」が作成されないよう、`Try-Catch` 的な構造(VBAでは `ErrorHandler` ラベル)を用いて、必ず `Close` と `CleanUp` を実行させる設計にせよ。
③ パフォーマンスの限界を知っているか?
数千のマスターを持つステンシルを扱う場合、`For Each master In stencil.Masters` のループは決して速くない。
もし速度がボトルネックになるなら、VBAの限界を認め、C# / .NET (Visio Interop) への移行を検討すべきだ。マルチスレッド処理や、より高度なメモリ管理が可能になり、処理速度は劇的に向上する。
結論
自動化ツールの価値は「動くこと」ではなく、「何度実行しても、誰が実行しても、同じ品質の結果を、安全に、高速に提供できること」にある。
命名規則という「秩序」を、コードという「力」によって、新しい構造へと再構築する。このプロセスこそが、真の業務自動化エンジニアの仕事だ。
君のコードに、秩序と設計思想が宿ることを期待している。
