【極限の知見】MS Project VBA:カスタムフィールドとメモ欄の「双方向同期」を設計する――二重管理を撲滅する堅牢なアーキテクチャ
業務自動化の現場において、最も恐ろしいのは「データの不整合」だ。
タスクの進捗詳細を「メモ」欄に書き、重要な管理項目を「カスタムフィールド」に入力する。一見、使い勝手が良さそうに見える。しかし、運用が始まれば必ず「メモには書いたが、カスタムフィールドに反映し忘れた」という事態が発生する。これがデータのドリフト(乖離)だ。
このドリフトを放置することは、プロジェクト管理における「情報の腐敗」を許容することと同義である。
本稿では、MS Project VBAを用いて、カスタムフィールドとメモ欄を「双方向」で同期させる手法を解説する。ただし、単に「動けばいい」というコードは書かない。イベントの連鎖による無限ループを回避し、大規模プロジェクトでもパフォーマンスを落とさない、プロダクションレベルの設計思想を伝授する。
1. 初心者が陥る「無限ループ」の罠
双方向同期(Aを書き換えたらBが変わる、Bを書き換えたらAが変わる)を実装しようとする際、初心者は必ず以下の設計ミスを犯す。
1. `Project_Calculate` イベント(再計算イベント)をトリガーにする。
2. カスタムフィールドの値をメモ欄にコピーするコードを書く。
3. メモ欄が更新されたため、再度 `Project_Calculate` が走る。
4. 再びカスタムフィールドを読み込み、メモ欄を更新しようとする……。
これがイベントの再帰呼び出し(無限ループ)だ。MS Projectはフリーズし、最悪の場合、保存されていないデータと共にクラッシュする。
プロフェッショナルは、「今、自分が同期処理を行っている最中かどうか」を管理する「状態フラグ」を導入することで、この連鎖を断ち切る。
2. 堅牢な設計:ステート管理(State Management)
実装の鍵は、`IsSyncing` という静的な(あるいはモジュールレベルの)Boolean変数である。
- 同期処理を開始する直前に `IsSyncing = True` にする。
- 同期処理が終わったら `IsSyncing = False` に戻す。
- イベントハンドラ内では、`If IsSyncing Then Exit Sub` と記述し、処理中の再入を防ぐ。
これだけで、設計の堅牢性は飛躍的に向上する。
3. プロダクションコード:双方向同期エンジン
以下に、カスタムフィールド(例:`Text1`)とタスクの「メモ」を同期させる実用的なコードを示す。このコードは、単なるコピーではなく、「どちらが最新のソースか」を判断するロジックを組み込むための雛形として設計している。
実装コード(Standard Module / ThisProject)
Option Explicit
' プロジェクト全体で同期中かどうかを保持するフラグ
' これにより、イベントの連鎖(無限ループ)を物理的に遮断する
Private IsSyncing As Boolean
''' <summary>
''' メインの同期エンジン
''' </summary>
''' <param name="targetTask">同期対象のタスクオブジェクト</param>
''' <param name="direction">1: フィールド→メモ, 2: メモ→フィールド</param>
Public Sub SyncTaskData(ByVal targetTask As MSProject.Task, ByVal direction As Integer)
' 再入防止チェック
If IsSyncing Then Exit Sub
On Error GoTo ErrorHandler
' 同期プロセス開始の宣言
IsSyncing = True
' 高速化のため、画面更新や計算を一時停止する設計思想(大規模データ向け)
' MS Projectでは厳密な制御が難しいため、エラーハンドリングを重視する
Select Case direction
Case 1 ' カスタムフィールド(Text1) -> メモ欄
Dim fieldVal As String
fieldVal = targetTask.Text1 ' Text1をカスタムフィールドとして使用
' メモ欄の内容と異なる場合のみ更新(無駄な書き込みによるイベント発生を抑止)
If targetTask.Notes <> fieldVal Then
targetTask.Notes = fieldVal
End If
Case 2 ' メモ欄 -> カスタムフィールド(Text1)
' メモ欄の1行目を取得するロジック(実務では正規表現等で抽出するのが理想)
' ここではシンプルにメモの全内容をフィールドに写す例とする
Dim noteVal As String
noteVal = targetTask.Notes
If targetTask.Text1 <> noteVal Then
targetTask.Text1 = noteVal
End If
End Select
CleanUp:
' 処理完了、またはエラー発生時も必ずフラグを戻す(重要!)
IsSyncing = False
Exit Sub
ErrorHandler:
' 実務ではログ出力やユーザーへの通知を行う
Debug.Print "Error in SyncTaskData: " & Err.Description
Resume CleanUp
End Sub
''' <summary>
''' プロジェクトの計算イベント(ThisProjectモジュールに配置)
''' </summary>
' ※注意: Project_Calculateは非常に頻繁に発生するため、
' 実際の運用では「特定のボタン押下時」や「特定のカスタムプロパティ変更時」に限定することを推奨。
Public Sub Project_Calculate()
' 既に同期中なら何もしない
If IsSyncing Then Exit Sub
' ここでは例として、選択されているタスクに対して実行する
' 本格的なツールでは、変更があったタスクを特定するロジックが必要
Dim t As MSProject.Task
On Error Resume Next
Set t = ActiveProject.SelectedTasks.Item(1)
On Error GoTo 0
If Not t Is Nothing Then
' 例として「フィールドからメモへ」の方向で同期
' 運用ルールに基づき、方向を制御すること
Call SyncTaskData(t, 1)
End If
End Sub
4. アーキテクトの視点:運用上の注意点
このコードを実戦投入するにあたり、以下の3点を必ず考慮せよ。
① 「Single Source of Truth(信頼できる唯一の情報源)」の定義
双方向同期は便利だが、「結局どちらが正しいのか?」という迷いを生む。
「基本はカスタムフィールドが正であり、メモは詳細な記述のための補助である」といったデータガバナンス(運用ルール)を明確に定義し、コードの `direction` をそれに基づいて制御せよ。
② パフォーマンスの重み
`Project_Calculate` は、タスクの期間を変えた、リソースを割り当てた、といったあらゆる操作で発生する。この中で重いループ処理を行うと、ユーザーの操作性は著しく低下する。
「変更が必要な時だけ動く」ロジック(例:変更されたタスクのIDを保持しておく、あるいは手動実行ボタンにする)へのアップグレードを常に検討せよ。
③ メモ欄の特殊性
MS Projectの `Notes` プロパティは、単なる文字列ではなく、リッチテキスト形式に近い挙動を示す。複雑な書式が含まれている場合、単純な文字列比較(`If targetTask.Notes <> fieldVal`)では、見た目が同じでも「不一致」と判定されるケースがある。
実務では、`Trim()` 関数を用いた空白除去や、特定のデリミタ(区切り文字)を用いた解析ロジックを組み込むことが、バグを防ぐ鉄則である。
結論
自動化エンジニアの仕事は、コードを書くことではない。「データの整合性を保証する仕組み」を設計することだ。
今回紹介した「状態フラグによる再入防止」と「方向制御」は、VBAに限らず、あらゆるシステム開発における基本中の基本である。この基礎を血肉とし、ユーザーが「データが違う!」と叫ばなくて済む、堅牢なツールを構築してほしい。
