ステンシルの「腐敗」を防げ:Visio VBAによるGit連携と、バイナリ資産の完全同期アーキテクチャ
図面設計の世界において、ステンシル(.vssx)は単なる「部品集」ではない。それは、組織の設計思想をコード化した「設計資産のDNA」である。
しかし、多くの現場では、このDNAが「管理の不在」によって変質している。誰かがマスターシェイプを修正し、それを共有サーバーに上書きする。あるいは、古いバージョンを使い続けて設計ミスを誘発する。Gitのような強力なバージョン管理システムがあるにもかかわらず、バイナリファイルであるステンシルは、コンフリクト(衝突)が発生した瞬間に解決不能なゴミと化す。
我々シニアエンジニアが構築すべきは、「Visioを開きながら、Gitのライフサイクルを透過的に実行する」という、エンジニアリングの規律そのものである。本稿では、VBAを単なるマクロとしてではなく、Gitという外部プロセスを制御する「オーケストレーター」として昇華させる極限の知見を共有する。
1. 抽象化の壁:なぜ `Shell` 関数では不十分なのか
初学者は `Shell` 関数を使い、`git commit` を呼び出そうとする。しかし、それはプロフェッショナルの仕事ではない。`Shell` は非同期でプロセスを投げっぱなしにするため、Gitの実行完了を待機できず、次の処理(例えばプッシュ)が失敗する。
我々が必要としているのは、プロセスの終了コード(Exit Code)を厳密に捕捉し、標準出力(stdout/stderr)を解析して、失敗時に正確なコンテキストを返せる制御機構である。
ここでは、`WScript.Shell` を用いた同期実行、あるいはより高度な制御が必要な場合には Windows API によるプロセスハンドリングを検討する必要がある。
2. 実装:Git Wrapper クラスの設計思想
ステンシル管理を自動化するためには、以下の3つの責務を分離した設計が求められる。
1. File Integrity (整合性): ステンシルが現在ロックされていないか、書き込み可能か。
2. Git Orchestration (実行): Gitコマンドの同期実行とエラーハンドリング。
3. State Management (状態管理): コミットメッセージの生成と、変更の有無の判定。
以下に、その中核となる実装例を示す。
高度なGit制御の実装例 (VBA)
'---------------------------------------------------------------------------------------
' Module: GitOrchestrator
' Description: Git操作を同期的に実行し、エラーハンドリングを行う低レイヤーラッパー
'---------------------------------------------------------------------------------------
Option Explicit
' Windows APIを利用してプロセスをより詳細に制御する場合の準備(必要に応じて拡張)
' Declare PtrSafe Function ...
Public Class GitManager
Private pShell As Object
Private pRepoPath As String
Private Sub Class_Initialize()
Set pShell = CreateObject("WScript.Shell")
End Sub
' リポジトリのパスを設定
Public Sub Initialize(ByVal repoPath As String)
pRepoPath = repoPath
If Dir(pRepoPath, vbDirectory) = "" Then
Err.Raise 5, "GitManager", "指定されたパスはディレクトリではありません: " & repoPath
End If
End Sub
' Gitコマンドを同期実行するコアメソッド
' @param command: 実行するGitコマンド(例: "commit -m ""update""")
' @return: 実行結果の真偽値
Public Function ExecuteGitCommand(ByVal command As String) As Boolean
Dim fullCommand As String
Dim exitCode As Long
' 作業ディレクトリをリポジトリに移動させるための実行コマンド構築
' /c はコマンド実行後に終了、/k は終了せずに残す。ここでは /c を使用
fullCommand = "cmd.exe /c cd /d """ & pRepoPath & """ && git " & command
On Error GoTo ErrorHandler
' WindowStyle 0: 非表示で実行
' bWaitOnReturn: True (同期実行。これが極めて重要)
exitCode = pShell.Run(fullCommand, 0, True)
If exitCode = 0 Then
ExecuteGitCommand = True
Else
Debug.Print "Git Error: Exit Code " & exitCode & " | Command: " & command
ExecuteGitCommand = False
End If
Exit Function
ErrorHandler:
Debug.Print "System Error: " & Err.Description
ExecuteGitCommand = False
End Function
' ステンシルをコミットしてプッシュする一連のワークフロー
' @param stencilPath: 対象のステンシルファイルパス
' @param message: コミットメッセージ
Public Function CommitAndPush(ByVal stencilPath As String, ByVal message As String) As Boolean
' 1. ステージング (git add)
If Not ExecuteGitCommand("add """ & stencilPath & """") Then GoTo Fail
' 2. コミット (git commit)
If Not ExecuteGitCommand("commit -m """ & message & """") Then GoTo Fail
' 3. プッシュ (git push)
If Not ExecuteGitCommand("push") Then GoTo Fail
CommitAndPush = True
Exit Function
Fail:
CommitAndPush = False
End Function
Private Sub Class_Terminate()
' オブジェクトの明示的な解放。メモリリークを防ぐための鉄則
Set pShell = Nothing
End Sub
End Class
3. 極限の知見:COMオブジェクトのライフサイクルとファイルロック
ここで、シニアエンジニアが直面する「真の障壁」について触れておく。
Visioでステンシルを開いている間、そのファイルは `Application.Stencils` コレクションによって、OSレベルで共有モード(または排他的モード)のロックがかかっている。この状態でGitが `git add` を実行しようとすると、ファイルアクセス拒否(Access Denied)が発生する。
解決策としての「保存と明示的解放」
VBAからGitを叩く前に、必ず以下のシーケンスを遵守すること。
1. `Stencil.Save` を実行し、メモリ上の変更をディスクへフラッシュする。
2. `Stencil.Close` を実行し、Visioのオブジェクトモデルからステンシルを切り離す。
3. 重要: `Set stencilObj = Nothing` により、COMの参照カウントを減らし、OSへのロック解放を確実にする。
4. その後に Git コマンドを実行する。
この「解放」のステップを怠ると、Gitプロセスが「ファイルが使用中」としてエラーを吐き、自動化パイプラインが停止する。
' 運用レベルのワークフロー例
Sub SyncStencilToGit()
Dim git As New GitManager
Dim vsoStencil As Visio.Stencil
Dim targetPath As String: targetPath = "C:\Repo\Standard.vssx"
On Error GoTo FatalError
' 1. ステンシルの操作
Set vsoStencil = Application.Stencils("Standard.vssx")
' ... ここでマスターシェイプの更新処理を行う ...
' 2. ライフサイクルの厳格な管理
vsoStencil.Save
vsoStencil.Close
Set vsoStencil = Nothing ' これがなければロックは解除されない
' 3. Git連携
git.Initialize "C:\Repo"
If git.CommitAndPush targetPath, "Automated update: " & Now
MsgBox "Sync Successful", vbInformation
Else
MsgBox "Sync Failed. Check Git logs.", vbCritical
End If
Set git = Nothing
Exit Sub
FatalError:
MsgBox "Unexpected Error: " & Err.Description, vbCritical
Set git = Nothing
End Sub
4. レガシー環境への配慮と保守性
大規模なエンタープライズ環境では、Gitクライアントのパスが標準的でない、あるいは `git` コマンドにパスが通っていない(環境変数 `PATH` の欠如)といった事象が頻発する。
プロフェッショナルな実装においては、`git` というコマンドを直接叩くのではなく、`git.exe` のフルパスを構成ファイル(INIファイルやレジストリ)から読み込む設計にすべきである。これは、システムのポータビリティと、レガシーなワークステーション環境における堅牢性を担保するための「守り」の技術である。
結論:自動化とは「規律」の強制である
ステンシルのGit管理をVBAで自動化するということは、単に作業を楽にすることではない。「設計変更が発生したならば、必ずリポジトリに記録される」というエンジニアリングの規律を、物理的に強制する仕組みを作ることである。
オブジェクトの解放、同期実行、エラーの捕捉。これら一つ一つの低レイヤーな作法を疎かにしないことが、数年後に「誰がこの図面を変えたのかわからない」という混沌(カオス)を回避する唯一の道である。
設計資産を、単なる絵としてではなく、管理された「コード」として扱え。そこに、真の自動化エンジニアの矜持がある。
