【上級】ステンシル配布時の「ライセンス認証」:VBAでマスターシェイプの使用を制限する
こんにちは。現場の最前線でアーキテクチャを設計している、あなたの「少し先を行く先輩」です。
Visioで独自の図形集(ステンシル)を作り上げ、業務効率化のツールとして完成させたとき、ふとこんな不安がよぎることはありませんか?
「この素晴らしい図形セットをクライアントに渡したとき、勝手に他の図面にもコピーして使い回されたらどうしよう……」
あなたが心血を注いで作り上げたマスターシェイプは、立派な知的財産です。単に「ファイルを渡す」だけでは、その価値を守ることはできません。
今日は、マクロの記録レベルを卒業し、「オブジェクトの挙動を制御する」という、プロフェッショナルな領域への第一歩を踏み出しましょう。テーマは「VBAによるステンシル使用のライセンス制限」です。
1. なぜ「ファイル名チェック」では足りないのか?
初学者の皆さんが最初に思いつく制限方法は、おそらくこうです。
「もしファイル名が『契約書.vsdx』じゃなかったら、エラーを出す」
' 💡 惜しい!これでは不十分な理由
If ActiveDocument.Name <> "Contract.vsdx" Then
MsgBox "許可されていないドキュメントです。"
End If
しかし、これでは不十分です。ユーザーがファイル名を「Contract_backup.vsdx」と書き換えた瞬間に、あなたのセキュリティは無力化されます。
プロのエンジニアは、ファイル名のような「表面的な属性」ではなく、「ドキュメントのアイデンティティ(一意のID)」や「ドロップというイベントの発生」に着目します。
今回は、「図形がページにドロップされた瞬間を検知し、許可されたドキュメント以外なら即座に消去する」という、より強固なガードマン(イベントハンドラ)を実装する方法を学びます。
2. アーキテクチャの設計図:イベントハンドラの仕組み
Visio VBAで「何かが起きたとき(ドロップされたときなど)」に自動で処理を走らせるには、「イベントハンドラ」という仕組みを使います。
ここが最大の難所です。通常のモジュールにコードを書くだけでは、Visioは「ドロップされた」という通知をあなたに送ってくれません。
実装の全体像
1. クラスモジュール: 「ドロップされた」というイベントを待ち構える「耳」の役割。
2. 標準モジュール: プログラムを開始し、「耳」を起動させる「スイッチ」の役割。
3. 認証ロジック: 許可されたドキュメントかどうかを判定する「脳」の役割。
3. 実装コード:鉄壁のガードマンを作る
では、実際にコードを書いていきましょう。以下の手順通りに進めてください。
Step 1: クラスモジュールの作成
まず、VBAエディタのメニューから `挿入` -> `クラスモジュール` を選択してください。
作成されたクラスの名前を、プロパティウィンドウから `clsDocumentEvent` に変更してください。
' --- クラスモジュール: clsDocumentEvent ---
Option Explicit
' Visioのドキュメントイベントをキャッチするための宣言
' WithEvents を使うことで、イベントを監視できるようになります
Public WithEvents Doc As Visio.Document
' ドキュメントに図形がドロップ(貼り付け)されたときに発生するイベント
Private Sub Doc_Drop(ByVal DropEvent As Visio.DropEvent)
Dim targetShape As Visio.Shape
' ドロップされた対象(シェイプ)を取得
Set targetShape = DropEvent.Shape
' 🛡️ 【ライセンス認証ロジック】
' ここでは例として、ドキュメントの「GUID(一意のID)」をチェックします
' ファイル名ではなく、ドキュメントそのものの固有IDを見るのがプロの技です
If Not IsAuthorized(Doc) Then
' 許可されていない場合、ドロップされた図形を即座に削除
targetShape.Delete
' ユーザーに警告を表示
MsgBox "【警告】このマスターシェイプは、ライセンス認証された" & vbCrLf & _
"特定のドキュメント以外では使用できません。", vbCritical, "アクセス拒否"
End If
End Sub
' 認証判定関数(ここをカスタマイズしてセキュリティを高める)
Private Function IsAuthorized(ByVal targetDoc As Visio.Document) As Boolean
' 本来はここに、許可されたドキュメントのGUIDや、
' 外部サーバーへ問い合わせるAPI通信などを記述します。
' 今回はデモとして「特定の名前のドキュメント」を許可対象とします。
Const AUTHORIZED_NAME As String = "Master_Project_2024"
If targetDoc.Name = AUTHORIZED_NAME Then
IsAuthorized = True
Else
IsAuthorized = False
End If
End Function
Step 2: 標準モジュールの作成
次に、`挿入` -> `標準モジュール` を選択し、以下のコードを記述します。これがプログラムの起動スイッチになります。
' --- 標準モジュール ---
Option Explicit
' クラスのインスタンスを保持するための変数
' ここで宣言しないと、マクロ終了時に「耳」が消えてしまいます
Dim myDocHandler As clsDocumentEvent
' プログラムを開始するメインルーチン
Sub InitializeSecurity()
' クラスをインスタンス化(実体化)
Set myDocHandler = New clsDocumentEvent
' 現在開いているドキュメントに対して、イベントの監視を開始
Set myDocHandler.Doc = ActiveDocument
MsgBox "セキュリティ・ガードマンが起動しました。", vbInformation
End Sub
' 監視を停止する場合
Sub StopSecurity()
Set myDocHandler = Nothing
MsgBox "ガードマンは退勤しました。", vbInformation
End Sub
4. ここがポイント!陥りやすいエラーと回避策
この実装を進める上で、皆さんが必ずと言っていいほどぶつかる壁が2つあります。
① 「ガードマンが動かない!」問題
一番多いのが、「`InitializeSecurity` を実行し忘れている」ケースです。
VBAのイベント監視は、プログラムが動いている間だけ有効です。ファイルを閉じたり、マクロを終了したりすると、クラスのインスタンス(`myDocHandler`)がメモリから消えてしまい、監視が止まります。
プロのアドバイス:
実際の業務ツールでは、`ThisDocument` モジュールの `Document_Open` イベントの中に `InitializeSecurity` を記述します。これにより、ファイルを開いた瞬間に自動でガードマンが配備されるようになります。
② 「図形が消えすぎて困る」問題
今回のコードは「ドロップされた瞬間に消す」という非常に強力なものです。もし認証ロジックにミスがあると、ユーザーは何も描けない地獄のような状況になります。
プロのアドバイス:
開発中は、`targetShape.Delete` の代わりに `Debug.Print “Unauthorized drop detected”` と記述して、イミディエイトウィンドウにログを出すだけに留めましょう。「破壊的な操作」は、テストが完了するまで絶対に本番コードに混ぜてはいけません。
5. 次のステップへ:さらなる高みを目指すなら
今回実装したのは、あくまで「クライアントサイド(Visio内)」での制限です。非常に強力ですが、VBAのコード自体を解析されると突破されるリスクはゼロではありません。
真のプロフェッショナルを目指すなら、以下の技術を組み合わせてみてください。
1. GUIDによる認証: `ActiveDocument.Application.Version` などの情報を利用し、ファイル名に依存しないチェックを行う。
2. 外部APIとの連携: VBAからHTTPリクエストを送り、サーバー上のデータベースに「このユーザーは利用権限があるか?」を問い合わせる。
3. コードの難読化: VBAプロジェクトにパスワードをかけることは基本ですが、それだけでなく、ロジックを複雑にして解析を困難にする。
まとめ
「ただ図形を並べる」フェーズから、「仕組みを制御する」フェーズへ。
今回学んだクラスモジュールを使ったイベントハンドリングは、Visio VBAにおける最も強力な武器の一つです。
オブジェクトのライフサイクル(生成→イベント発生→破棄)を意識できるようになれば、あなたの書くコードは単なる「自動化」を超え、一つの「システム」へと進化します。
ここをクリアすれば、Visio VBAの基本はバッチリですよ。自信を持って、次の開発に挑んでくださいね!
