マクロを超え、システムを構築せよ:MS Projectにおける「監査ログ機能」の極限設計
多くの開発者が、MS ProjectのVBAを「手作業を自動化する便利な道具」としてしか見ていない。もし君がそう考えているなら、残念ながら君はまだ「自動化エンジニア」ではなく、単なる「マクロ職人」だ。
業務の現場、特に大規模なプロジェクト管理において、カスタムフィールド(Text1〜Text30やNumber1〜Number20)は、単なるメモ書きではない。それは予算、リスクレベル、承認ステータスといった、プロジェクトの命運を握る「ビジネスロジックの器」だ。
もし、誰かが重要なリスクレベルを書き換えた際、その痕跡が残っていないとしたらどうなるか? プロジェクトの信頼性は崩壊する。そこで必要になるのが、「誰が、いつ、どのフィールドを、どう変えたか」を記録する監査ログ(Audit Log)機能だ。
本稿では、単に「動くコード」を書くのではない。イベントハンドラのライフサイクルを制御し、再帰呼び出しによるスタックオーバーフローを防ぎ、パフォーマンスを犠牲にしない、プロダクションレベルの堅牢な設計思想を伝授する。
1. 設計思想:なぜ「Event Handler」は牙を剥くのか
MS Projectのイベント駆動型プログラミングにおいて、初心者が必ず陥る罠がある。それは「イベントの連鎖(Event Recursion)」だ。
例えば、タスクの値を変更したことを検知してログを記録しようとする。その「ログを記録する(セルに書き込む)」という動作自体が、再び「プロジェクトの変更イベント」を発生させてしまう。これが無限ループを招き、MS Projectを強制終了させる。
これを回避するための設計原則は以下の3点だ。
1. 状態管理(State Management): 現在「ログ記録中」であるかどうかを判定するフラグを導入し、イベントの再入を阻止する。
2. 差分検知のロジック: 「変更後」のイベント(`TaskChange`)だけでは、変更前の値がわからない。変更前の値を保持する仕組み、あるいは「変更直前」のイベントを捉える設計が必要だ。
3. 疎結合な実装: ログの記録ロジックをイベントハンドラの中に直接書き込まない。記録処理は独立したクラスまたはモジュールに分離し、保守性を高める。
2. 実装アーキテクチャ:Class Moduleによるカプセル化
堅牢なシステムを作るには、イベントを監視する「リスナー」をクラスモジュールとして独立させるのが定石だ。これにより、`ThisProject` モジュールを汚さず、ライフサイクルを明示的に管理できる。
A. 準備:参照設定
この実装では、高速な状態管理のために `Microsoft Scripting Runtime` を使用する。
VBAエディタの [ツール] > [参照設定] から “Microsoft Scripting Runtime” にチェックを入れておいてほしい。
B. クラスモジュール:`clsProjectAuditListener`
ここが心臓部だ。タスクの変更を監視し、変更前後の値を比較する。
' Class Module: clsProjectAuditListener
Option Explicit
' 変更中であることを示すフラグ(再帰呼び出し防止)
Private mIsLogging As Boolean
Private mOldValues As Scripting.Dictionary ' 変更前の値を一時保持
' ログ出力用のイベント(標準モジュールで受け取る)
Public Event OnAuditLogged(ByVal TaskName As String, ByVal FieldName As String, _
ByVal OldVal As Variant, ByVal NewVal As Variant)
Private WithEvents mApp As MSProject.Application
' 初期化メソッド
Public Sub Initialize(ByRef app As MSProject.Application)
Set mApp = app
Set mOldValues = New Scripting.Dictionary
mIsLogging = False
End Sub
' タスクが変更される「前」に呼び出される(変更前の値をキャプチャするため)
' 注: Project VBAのイベント仕様に基づき、タスクのプロパティ変更を捕捉する
Private Sub mApp_ProjectBeforeChange(ByVal Name As String)
' ログ記録中なら何もしない
If mIsLogging Then Exit Sub
' ここでは、変更される「前」の状態をスナップショットとしてDictionaryに格納する設計をとる
' 本来はより高度なプロパティ監視が必要だが、実務上は特定フィールドの変更を狙い撃つ
End Sub
' タスクの変更を検知するメインイベント
' 実務的には TaskChange イベントを利用する
Private Sub mApp_TaskChange(ByVal Task As MSProject.Task)
If mIsLogging Then Exit Sub
On Error GoTo ErrorHandler
' 変更を検知した際、特定のカスタムフィールド(例: Text1)を監視
' 本来は全フィールドをループするが、パフォーマンスのため対象を絞るのがプロの判断
Dim targetField As String
targetField = "Text1" ' 監視対象フィールド名
Dim currentVal As Variant
currentVal = Task.Text1
' --- 差分検知ロジック ---
' 簡易的な実装として、Dictionaryを用いて「直前の値」を管理する手法をとる
Dim dictKey As String
dictKey = Task.ID & "_" & targetField
If mOldValues.Exists(dictKey) Then
Dim oldVal As Variant
oldVal = mOldValues(dictKey)
' 値が実際に変わっているかチェック
If CStr(oldVal) <> CStr(currentVal) Then
' ログ記録プロセス開始
mIsLogging = True
' イベントを発火させて標準モジュールへ通知
RaiseEvent OnAuditLogged(Task.Name, targetField, oldVal, currentVal)
mIsLogging = False
End If
End If
' 現在の値を「前回の値」として保存
mOldValues(dictKey) = currentVal
Exit Sub
ErrorHandler:
mIsLogging = False
Debug.Print "Error in Audit Listener: " & Err.Description
End Sub
' 解放処理
Public Sub Terminate()
Set mOldValues = Nothing
Set mApp = Nothing
End Sub
C. 標準モジュール:`modAuditManager`
リスナーを起動し、実際にログをシートへ書き込む「実行部」だ。
' Standard Module: modAuditManager
Option Explicit
Private mListener As clsProjectAuditListener
Private mLogSheet As Worksheet
' 監査ログシステムの起動
Public Sub StartAuditSystem()
Dim ws As Worksheet
On Error Resume Next
Set mLogSheet = ThisWorkbook.Worksheets("AuditLog")
On Error GoTo 0
' ログシートがなければ作成
If mLogSheet Is Nothing Then
Set mLogSheet = ThisWorkbook.Worksheets.Add
mLogSheet.Name = "AuditLog"
mLogSheet.Range("A1:E1").Value = Array("Timestamp", "User", "Task Name", "Field", "Old Value", "New Value")
mLogSheet.Range("A1:E1").Font.Bold = True
End If
' リスナーの初期化
Set mListener = New clsProjectAuditListener
mListener.Initialize Application
' イベントハンドラへの紐付け
AddHandler mListener, "OnAuditLogged" ' ※注:VBAには標準のAddHandlerはないため、
' 実際にはクラス内のイベントをThisProject等で受ける
' ここでは概念的な設計を示す
' --- 【重要】VBAの実装上の制約への対策 ---
' VBAには .NETのようなAddHandlerがない。
' そのため、実務では ThisProject モジュール内で
' mListener をグローバル変数として保持し、
' クラス内のイベントを ThisProject が受け取る構造にする。
MsgBox "監査ログシステムが稼働しました。", vbInformation
End Sub
' ログの書き込み処理(堅牢な書き込み)
Public Sub WriteLog(ByVal tName As String, ByVal fName As String, ByVal oldV As Variant, ByVal newV As Variant)
Dim nextRow As Long
' 画面更新を止めてパフォーマンスを確保
Application.ScreenUpdating = False
nextRow = mLogSheet.Cells(mLogSheet.Rows.Count, 1).End(xlUp).Row + 1
With mLogSheet
.Cells(nextRow, 1).Value = Now()
.Cells(nextRow, 2).Value = Environ("Username") ' 実行ユーザー名
.Cells(nextRow, 3).Value = tName
.Cells(nextRow, 4).Value = fName
.Cells(nextRow, 5).Value = oldV
.Cells(nextRow, 6).Value = newV
End With
Application.ScreenUpdating = True
End Sub
' システムの停止
Public Sub StopAuditSystem()
If Not mListener Is Nothing Then
mListener.Terminate
Set mListener = Nothing
End If
MsgBox "監査ログシステムを停止しました。", vbExclamation
End Sub
3. プロフェッショナルのための極意:運用上の注意点
このコードをプロダクション環境に投入する前に、以下の3点を必ず検討せよ。
① パフォーマンスの重み
`TaskChange` イベントは、ユーザーが値を入力するたびに、あるいはガントチャート上でドラッグ&ドロップを行うたびに頻繁に発生する。
ログの書き込み先を「別ファイル(ExcelやAccess)」にする場合、I/O(入出力)のオーバーヘッドが無視できなくなる。大規模プロジェクト(タスク数数千件)では、「変更のたびに即書き込み」ではなく、「メモリ上のDictionaryに溜めておき、プロジェクト保存時に一括書き出し」するバッチ処理への転換を検討すべきだ。
② データの整合性とセキュリティ
ログをプロジェクトファイル内のシートに保存する場合、ユーザーがそのシートを消去したり、ログを書き換えることができてしまう。
真に厳格な監査が必要な場合は、ログの書き出し先を読み取り専用のネットワーク共有フォルダ上のCSV、あるいはSQL Serverなどの外部データベースにするのが、エンジニアとしての正しい設計だ。
③ エラーハンドリングの徹底
イベントハンドラ内でエラーが発生し、それが適切にトラップ(捕捉)されない場合、MS Project自体がクラッシュする。
`On Error GoTo ErrorHandler` は、単なる「お作法」ではない。ユーザーの作業環境を守るための「防波堤」だ。
結びに代えて
「動けばいい」という思考は、ツールを「負債」に変える。
「なぜこのイベントが走るのか」「なぜこの変数はクラスに隠蔽されているのか」を論理的に説明できる設計こそが、プロフェッショナルの仕事だ。
今回紹介した設計思想を武器に、単なる自動化を超えた、「信頼されるシステム」を構築してほしい。
