【上級】Gitによるステンシル管理:VBAでコミット・プッシュを自動化する
こんにちは。設計自動化の世界へようこそ。
「マクロの記録」から一歩踏み出し、コードを書き始めたあなた。素晴らしい成長です。次は「書いたコードをどう運用するか」という、プロフェッショナルなエンジニアが直面する壁に挑む時が来ました。
今日のテーマは、少し刺激的ですよ。「Visioのステンシル(.vssx)を、Gitでバージョン管理する」。
「えっ、Gitってプログラムのソースコードを管理するものじゃないの? バイナリファイルであるステンシルを管理するなんて、無理があるんじゃない?」
そう思ったあなた、正解です。鋭いですね。
実は、`.vssx`ファイルはバイナリ形式です。Gitはテキストの差分(どの行が変わったか)を見るのは得意ですが、バイナリの中身を比較して「どこが書き換わったか」を理解することはできません。
しかし、チーム開発において「誰かがマスターシェイプを修正したのに、他のメンバーが古いステンシルを使い続けて、図面がバラバラになる」という事故は、現場で頻発します。これを防ぐには、ステンシルの更新を「コードのリリース」と同じプロセスに乗せる必要があるのです。
今回は、Visio VBAからGitコマンドを叩き、ステンシルの保存からリモートリポジトリへのプッシュまでをワンクリックで完結させる「管理ラッパー」の構築術を伝授します。
ここをクリアすれば、あなたは「単なるマクロ使い」から「開発基盤を設計できるエンジニア」へと進化できるはずですよ。
1. 全体像:なぜ「ラッパー」が必要なのか?
通常、Gitでの操作はコマンドプロンプトやGUIツール(SourceTreeなど)で行います。しかし、Visioで作業しているユーザーに「ステンシルを保存したら、Gitを開いて、addして、commitして、pushして……」なんて手間を強いては、誰もルールを守ってくれません。
そこで、「Visioのボタン一つで、裏側でGitを操作するVBAプログラム」を用意します。これが「ラッパー(包み込むもの)」です。
構築するワークフロー
1. Visio上でステンシルを編集
2. VBA実行
- ① ステンシルの保存(`Saved = True` を確認)
- ② `git add` (変更をステージング)
- ③ `git commit` (変更にメッセージを付けて記録)
- ④ `git push` (サーバーへ送信)
3. 完了報告
2. 実装:Git操作を司る魔法のコード
では、核心部分のコードを見ていきましょう。ここでは、Windowsの `WScript.Shell` というオブジェクトを使い、VBAからGitコマンドを呼び出します。
実装コード例
Option Explicit
' =================================================================
' 目的: 現在開いているステンシルをGitに同期する
' 注意: プロジェクトのルートディレクトリにGitリポジトリが設定されていること
' =================================================================
Sub SyncStencilToGit()
Dim stencil As Visio.Stencil
Dim repoPath As String
Dim commitMsg As String
Dim shell As Object
Dim execResult As String
' 1. 現在開いているステンシルを取得
' ※注意: ステンシルが開かれていないとエラーになるため、エラーハンドリングが重要
On Error Resume Next
Set stencil = ActiveDocument.Application.ActiveStencil
On Error GoTo 0
If stencil Is Nothing Then
MsgBox "ステンシルが開かれていません。管理対象のステンシルを開いてから実行してください。", vbCritical
Exit Sub
End If
' 2. リポジトリのパスを設定(あなたの環境に合わせて書き換えてください)
' 本来はステンシルのパスから動的に取得するのがスマートです
repoPath = "C:\Users\YourName\Documents\VisioProject\"
' 3. ユーザーにコミットメッセージを求める
commitMsg = InputBox("今回の変更内容を入力してください", "Git Commit", "Update master shapes")
If commitMsg = "" Then Exit Sub ' キャンセルされた場合は終了
' 4. ステンシルの保存
' 保存されていない変更がある場合、ここで物理ファイルに書き込む
If Not stencil.Saved Then
stencil.Save
Debug.Print "Stencil saved."
End If
' 5. Git操作の実行
Set shell = CreateObject("WScript.Shell")
' コマンドを組み立てる
' cd でリポジトリへ移動 -> add -> commit -> push
' ※ & はコマンドを連続実行する記号です
Dim cmd As String
cmd = "cmd /c cd /d """ & repoPath & """ && " & _
"git add """ & stencil.FullName & """ && " & _
"git commit -m """ & commitMsg & """ && " & _
"git push"
' 6. コマンドの実行と結果の待機
' 第2引数 0 はウィンドウを非表示にする設定
' 第3引数 True はコマンドが終わるまでVBAを待機させる設定
Debug.Print "Executing: " & cmd
execResult = shell.Run(cmd, 1, True) ' 1 にするとコマンドプロンプトが見えるのでデバッグに便利
' 7. 完了通知
MsgBox "Git同期プロセスが完了しました。" & vbCrLf & _
"ステンシル: " & stencil.Name, vbInformation
End Sub
3. 初学者が陥りやすい「3つの落とし穴」
このコードを動かそうとしたとき、多くの人が躓きます。伝説のアーキテクトとして、あらかじめ回避策を教えておきましょう。
① パスに「スペース」が含まれている問題
Windowsのファイルパスには `C:\Program Files\…` のようにスペースが含まれることがよくあります。
コマンドラインにそのまま渡すと、Gitは「`C:\Program` というコマンドを探せ」と勘違いしてエラーになります。
対策: 上記コードのように、パスを必ず `”””` (ダブルクォーテーション) で囲む癖をつけてください。
② `ActiveStencil` のライフサイクル
`ActiveDocument.Application.ActiveStencil` は、今まさにユーザーが触っているステンシルを指しますが、もしユーザーが「図面ファイル(.vsdx)」だけを開いていて「ステンシル」を開いていない場合、このオブジェクトは `Nothing` になります。
対策: `If stencil Is Nothing Then` によるチェックは、プロフェッショナルなコードには必須の「ガード句」です。
③ Gitの認証待ち(対話型プロンプト)
これが最大の難所です。`git push` をした際、もしGitが「ユーザー名とパスワードを入力してください」と画面に出してきたら、VBAの `shell.Run` はそこで永遠に止まってしまうか、エラーになります。
対策:
- Git Credential Manager を使い、一度PCに認証情報を保存しておく。
- または、SSH鍵(公開鍵認証)を使用するように設定しておく。
「自動化コードは、人間による入力待ちが発生しない状態にしておくこと」。これが鉄則です。
4. さらに高みを目指すあなたへ:設計の極意
この仕組みを導入すると、チーム開発のルールが変わります。
「ステンシルを更新したら、必ずこのマクロを実行して共有してください」
たったこれだけで、全員が常に最新のマスターシェイプを使える環境が整います。
さらに発展させるなら、以下のような機能を追加してみてください。
- 自動差分チェック: `git status` を実行して、変更がある場合のみプロセスを進める。
- 自動ブランチ作成: `git checkout -b feature/new-shape` を組み込み、作業用ブランチを自動で作る。
- エラーログの出力: 失敗したときに、なぜ失敗したのか(ネットワークエラーか、コンフリクトか)をテキストファイルに書き出す。
最後に
Visio VBAは、単に図形を描くための道具ではありません。「設計のルールを、コードによって強制し、守らせるための仕組み」を構築するための強力な武器です。
今回紹介したGit連携は、その第一歩に過ぎません。
「仕組み」を作れるようになれば、あなたの価値は劇的に高まります。
一歩ずつ、確実に。
もしエラーが出ても、それは新しい知識への入り口です。楽しんでコードを書いていきましょう!
応援していますよ。
