【実務・中級編】【初心者向け】カスタムフィールドの値をタスクの「メモ」欄と同期させる双方向更新の基本 – Project VBA解析バイブル

スポンサーリンク
スポンサーリンク

【極限の知見】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に限らず、あらゆるシステム開発における基本中の基本である。この基礎を血肉とし、ユーザーが「データが違う!」と叫ばなくて済む、堅牢なツールを構築してほしい。

タイトルとURLをコピーしました