【Project VBA】カスタムフィールドの変更を逃さない!イベントハンドラによる監査ログ実装の極意
「あれ、このカスタムフィールドの値、いつ誰が変えたんだろう……?」
Microsoft Projectでプロジェクト管理を行っていると、必ず一度は直面する問題です。特に、コストや重要度、あるいは独自のステータス管理を「カスタムフィールド」で行っている場合、その数値がいつの間にか書き換わっていると、スケジュールの整合性が崩れる原因になります。
Excelの「変更履歴」のような機能は、残念ながらProjectの標準機能には備わっていません。
そこで登場するのが、VBAの「イベントハンドラ」です。
今日は、単なる「マクロの記録」の枠を超え、アプリケーションの挙動を監視する「守護神」のようなコード――カスタムフィールドの変更を自動的に別シートへ記録する監査ログ機能の作り方を、徹底的に解説します。
ここをクリアすれば、あなたのProject VBAスキルは「作業の自動化」から「システムの構築」へと一気にステップアップしますよ。
1. なぜ「マクロの記録」では足りないのか?
多くの初学者は、「ボタンを押したら実行される」コードを書くことから始めます。これは「命令型」のプログラミングです。
しかし、今回のような「誰かが値を変えた瞬間に記録する」という動作は、ユーザーの操作を待機し、変化を察知しなければなりません。これは「イベント駆動型」と呼ばれる設計思想です。
「いつ、誰が、どのタスクの、どの項目を、どう変えたか」
これを実現するには、Projectというアプリケーション自体に「変化が起きたら、この関数を呼び出してね」という予約を入れておく必要があるのです。
2. 設計図:監査ログのメカニズム
実装に入る前に、全体の構造(アーキテクチャ)を理解しましょう。
1. 監視のトリガー: `Project_Change` イベント。タスクやリソースの値が変わった瞬間に発火します。
2. 情報の抽出: `Change` オブジェクトから、「対象のオブジェクト名」「変更されたプロパティ名」「古い値」「新しい値」を抜き出します。
3. 記録先: プロジェクトファイル内の「AuditLog」という名前のワークシート。
4. ユーザー特定: `Environ(“Username”)` を使い、Windowsのログインユーザー名を特定します。
3. 実装コード:魂を込めた監査ログ・エンジン
それでは、具体的なコードを見ていきましょう。このコードは、標準モジュールではなく、`ThisProject` モジュールに記述する必要があります。ここが、イベントをキャッチするための「司令塔」になるからです。
ステップ1:ログ記録用シートの準備
あらかじめ、プロジェクト内に「AuditLog」という名前のシートを作成しておいてください。
列構成は以下のように想定します:
`[日時] | [ユーザー] | [対象(Task/Resource)] | [名前] | [項目名] | [旧値] | [新値]`
ステップ2:`ThisProject` モジュールへの記述
'-------------------------------------------------------------------------
' Module: ThisProject
' Description: プロジェクト全体の変更を監視し、カスタムフィールドの
' 変更をログシートに記録する。
'-------------------------------------------------------------------------
Option Explicit
' プロジェクト内で変更が発生したときに自動的に実行されるイベント
Private Sub Project_Change(ByVal Change As Change)
On Error GoTo ErrorHandler
Dim logSheet As Worksheet
Dim nextRow As Long
Dim targetName As String
Dim fieldName As String
Dim oldValue As String
Dim newValue As String
Dim objName As String
' 1. ログを記録するシートの指定(シートがない場合はエラー処理へ)
On Error Resume Next
Set logSheet = ActiveProject.Sheets("AuditLog")
On Error GoTo ErrorHandler
If logSheet Is Nothing Then
' ログシートがない場合は、ログを取る必要がない(またはエラー)
Exit Sub
End If
' 2. 変更された対象が「カスタムフィールド」かどうかを判定
' ここでは例として、Text1, Text2, Number1 などのプロパティを監視対象とする
' ※実際の運用に合わせて、監視したいプロパティ名を絞り込むのがパフォーマンスのコツです
fieldName = Change.PropertyName
If IsCustomField(fieldName) Then
' 3. 変更情報の取得
' 対象がタスクかリソースかを判別
Select Case Change.ObjectName
Case "Task"
objName = "Task"
' タスクの名前(Task.Name)を取得
targetName = Change.Object.Name
Case "Resource"
objName = "Resource"
' リソースの名前(Resource.Name)を取得
targetName = Change.Object.Name
Case Else
' カスタムフィールド以外のオブジェクト変更は無視
Exit Sub
End Select
' 値の取得(古い値と新しい値)
' ※Changeオブジェクトから直接値を取得できない場合があるため、
' プロパティ名を介して慎重に取得します。
oldValue = "N/A" ' 本来は変更前の値を保持する仕組みが必要(高度な実装)
newValue = Change.Value
' 4. ログシートの最終行を取得して書き込み
nextRow = logSheet.Cells(logSheet.Rows.Count, 1).End(xlUp).Row + 1
With logSheet
.Cells(nextRow, 1).Value = Now ' 日時
.Cells(nextRow, 2).Value = Environ("Username") ' ユーザー名
.Cells(nextRow, 3).Value = objName ' Task or Resource
.Cells(nextRow, 4).Value = targetName ' タスク名/リソース名
.Cells(nextRow, 5).Value = fieldName ' 変更された項目名
.Cells(nextRow, 6).Value = oldValue ' 旧値(簡易版)
.Cells(nextRow, 7).Value = newValue ' 新値
End With
End If
Exit Sub
ErrorHandler:
' ログ記録中のエラーが、ユーザーの本来の作業を止めてはいけない
' エラーが発生した場合は、イミディエイトウィンドウに通知するのみに留める
Debug.Print "AuditLog Error: " & Err.Description
End Sub
'-------------------------------------------------------------------------
' Function: IsCustomField
' Description: 変更されたプロパティが、監視対象のカスタムフィールドかどうかを判定
'-------------------------------------------------------------------------
Private Function IsCustomField(ByVal propName As String) As Boolean
' 監視したいプロパティ名をここに列挙します
' 例: Text1~Text30, Number1~Number30, Cost1~Cost10 など
Select Case propName
Case "Text1", "Text2", "Text3", "Number1", "Number2", "Cost1"
IsCustomField = True
Case Else
IsCustomField = False
End Select
End Function
4. 伝説のエンジニアが教える「陥りやすい罠」
コードを書いただけで満足してはいけません。実戦では、以下の3つのポイントがあなたのコードの品質を左右します。
① パフォーマンスの重み(イベントの連鎖)
`Project_Change` イベントは、ユーザーが何かを動かすたびに、ものすごい頻度で呼び出されます。
もし、この中で「重い計算」や「複雑なループ」を行ってしまうと、Projectの動作が目に見えて重くなります。
対策: `IsCustomField` 関数のように、「本当に記録する必要がある変更か?」を、コードの冒頭で極めて高速に判定すること。これがプロの設計です。
② 「旧値」の取得という難問
実は、`Change` オブジェクトは「何が変わったか」は教えてくれますが、「何から何へ変わったか」という履歴を完璧に保持しているわけではありません(プロパティによります)。
完璧な監査ログを作るには、変更が起きる前に現在の値をどこかに一時保存しておく高度なテクニックが必要になります。まずは「新値」を確実に記録することから始めましょう。
③ エラーハンドリングの哲学
ここが最も重要です。「ログを取るためのコードが原因で、ユーザーの作業が中断される」ことは、絶対に避けなければなりません。
もしログシートが保護されていて書き込めなかったとき、エラーでマクロが止まると、ユーザーは「Projectがおかしい!」とパニックになります。
`On Error GoTo ErrorHandler` を使い、エラーが起きても「そっと無視して、作業を続けさせる」のが、真のエンジニアの優しさです。
5. まとめ:ここをクリアすれば、基本はバッチリ!
今回実装した「イベントハンドラによる監査ログ」は、単なる便利ツールではありません。「アプリケーションの状態を監視し、制御する」という、業務システム開発における極めて重要な概念の入り口です。
1. イベント(きっかけ)を捉える
2. 対象をフィルタリングする(不要なものは無視する)
3. 安全に(エラーハンドリング)記録する
この3ステップをマスターすれば、あなたはもう「マクロの記録」の先にある、真の自動化エンジニアへの道を歩み始めています。
さあ、このコードを自分のプロジェクトに組み込んで、データの変化をコントロールする感覚を掴んでみてください。応援していますよ!
