【テクニカル・上級編】【上級】Gitによるステンシル管理:VBAでコミット・プッシュを自動化する – Visio VBA解析バイブル

スポンサーリンク
スポンサーリンク

ステンシルの「腐敗」を防げ: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で自動化するということは、単に作業を楽にすることではない。「設計変更が発生したならば、必ずリポジトリに記録される」というエンジニアリングの規律を、物理的に強制する仕組みを作ることである。

オブジェクトの解放、同期実行、エラーの捕捉。これら一つ一つの低レイヤーな作法を疎かにしないことが、数年後に「誰がこの図面を変えたのかわからない」という混沌(カオス)を回避する唯一の道である。

設計資産を、単なる絵としてではなく、管理された「コード」として扱え。そこに、真の自動化エンジニアの矜持がある。

タイトルとURLをコピーしました