【実務・中級編】【上級者向け】カスタムフィールドの計算負荷を最小化する「計算の遅延実行」アーキテクチャ – Project VBA解析バイブル

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

【極限の知見】MS Project VBAにおける「計算の嵐」を鎮める:カスタムフィールド更新のバッチ・アーキテクチャ

大規模なプロジェクト管理を行っている現場で、開発者が必ず直面する「壁」がある。

それは、「カスタムフィールドへの大量書き込みが、MS Projectの動作を致命的に重くする」という現象だ。

タスク数が数千、リソース数が数百を超えたとき、単純な `For Each` ループによるフィールド更新コードは、もはやツールではなく「システムをフリーズさせる攻撃コード」へと変貌する。なぜこれほどまでに重くなるのか? そして、プロフェッショナルはどう設計すべきか?

今日は、単なる「コードの書き方」ではなく、MS Projectのオブジェクトモデルの挙動を制御し、計算負荷を最小化するための「計算の遅延実行(Deferred Calculation)アーキテクチャ」について伝授する。

1. なぜあなたのコードは「重い」のか:Recalculation Stormの正体

多くの開発者が陥る罠は、MS Projectの「自動再計算エンジン」の性質を理解していないことにある。

MS Projectは、タスクの期間、依存関係、リソース割り当てが変更されるたびに、プロジェクト全体の整合性を保つために再計算を走らせる。カスタムフィールド(`Text1`, `Number1`, `Cost1` など)に値を代入する行為は、Projectにとっては「重要なデータの変更」だ。

もし、1,000個のタスクに対してループ内で一つずつ値を書き込んだ場合、内部では以下の事象が発生する。

1. タスク1の値を変更
2. Projectが「計算が必要だ」と判断し、プロジェクト全体の再計算を開始
3. タスク2の値を変更
4. 再びプロジェクト全体の再計算を開始
5. (これを1,000回繰り返す)

これが、私が呼ぶところの 「Recalculation Storm(再計算の嵐)」 だ。計算量は $O(N^2)$ に近づき、ユーザーの操作は完全にロックされる。

2. 解決策:バッチ・アーキテクチャによる「状態の分離」

この嵐を鎮めるには、「データの準備(Data Preparation)」と「データの反映(Data Application)」を完全に分離する設計が必要だ。

設計思想は以下の3ステップに集約される。

1. 計算モードの凍結 (State Freezing): Projectの自動計算を強制的に「手動モード」に切り替える。
2. メモリ上でのバッファリング (In-Memory Buffering): Projectのオブジェクトを直接触るのではなく、一旦 `Dictionary` などの高速なメモリ構造に書き込みデータを蓄積する。
3. 一括外科手術 (Surgical Batch Update): 計算を停止した状態で、メモリ上のデータを一気にフィールドへ流し込む。

3. プロダクション・グレードの設計実装

以下に、実務でそのまま利用可能な、堅牢性とパフォーマンスを両立させた実装例を示す。ここでは `Scripting.Dictionary` を活用し、タスクIDをキーとしたバッチ更新ロジックを構築する。

実装コード:BatchFieldUpdater モジュール

' ==============================================================================
' Module: BatchFieldUpdater
' Description: カスタムフィールド更新の計算負荷を最小化するバッチ処理エンジン
' Author: Chief Architect
' ==============================================================================

Option Explicit

' 更新データの格納用構造体(クラスモジュール化しても良い)
Private Type UpdateBuffer
    TaskID As Long
    NewValue As Variant
End Type

''' <summary>
''' タスクのカスタムフィールドをバッチ更新するメインルーチン
''' </summary>
''' <param name="fieldIndex">更新対象のフィールド番号 (例: Text1なら1)</param>
''' <param name="fieldType">フィールドの種類 (pjText, pjNumber, etc...)</param>
Public Sub ExecuteBatchUpdate(ByVal fieldIndex As Integer, ByVal fieldType As Long)
    Dim app As MSProject.Application
    Set app = MSProject.Application
    
    Dim dict As Object
    Set dict = CreateObject("Scripting.Dictionary")
    
    Dim t As MSProject.Task
    Dim currentCalculationMode As MSProject.Calculation
    
    On Error GoTo ErrorHandler

    ' --- STEP 1: データ収集フェーズ (Projectオブジェクトへのアクセスを最小限にする) ---
    ' ここでは例として、特定の条件(例:%完了が100%)のタスクを対象とする
    ' 本来は外部DBやExcelから取得したデータをここに格納する設計が理想的
    For Each t In app.ActiveProject.Tasks
        If Not t Is Nothing Then
            If t.PercentComplete = 100 Then
                ' メモリ上のDictionaryに「TaskID -> 新しい値」を格納
                ' Projectのオブジェクトを直接操作せず、メモリに逃がすのが肝
                dict.Add t.ID, "COMPLETED_" & Format(Now, "yyyyMMdd")
            End If
        End If
    Next t

    If dict.Count = 0 Then
        MsgBox "更新対象のタスクが見つかりませんでした。", vbInformation
        Exit Sub
    End If

    ' --- STEP 2: 反映フェーズ (計算を止めて一気に書き込む) ---
    Debug.Print "Batch Update Start: " & dict.Count & " items."
    
    ' 現在の計算設定を退避
    currentCalculationMode = app.Calculation
    
    ' 計算を「手動」に強制変更(Recalculation Stormの阻止)
    app.Calculation = pjManual
    
    ' 高速化のための画面更新停止(COM操作のオーバーヘッド削減)
    app.ScreenUpdating = False

    Dim key As Variant
    Dim targetTask As MSProject.Task
    
    ' Dictionaryから一括適用
    ' Projectのタスクを再走査するが、計算が止まっているため爆速で終わる
    For Each key In dict.Keys
        Set targetTask = app.ActiveProject.Tasks(CLng(key))
        
        ' フィールド種別に応じた書き込み(リフレクション的な処理)
        Select Case fieldType
            Case pjText
                targetTask.Text(fieldIndex) = dict(key)
            Case pjNumber
                targetTask.Number(fieldIndex) = CLng(dict(key))
            ' 必要に応じて他の型を追加
        End Select
    Next key

    ' --- STEP 3: 復元フェーズ ---
    ' 計算モードを元の状態に戻し、最後に一度だけ再計算を実行させる
    app.Calculation = currentCalculationMode
    app.ScreenUpdating = True
    
    ' 最後に一度だけ、全ての変更を整合させる
    app.Calculate
    
    MsgBox "バッチ更新が完了しました。更新件数: " & dict.Count, vbInformation

CleanUp:
    Set dict = Nothing
    Set app = Nothing
    Exit Sub

ErrorHandler:
    ' 異常終了時も計算モードを復元しないと、ユーザーが「Projectが動かない!」と混乱する
    app.Calculation = pjAutomatic
    app.ScreenUpdating = True
    MsgBox "致命的なエラーが発生しました: " & Err.Description, vbCritical
    Resume CleanUp
End Sub

4. アーキテクトの視点:堅牢性を高めるための注意点

このコードをプロダクション環境へ投入する際、以下の3点に留意せよ。

① エラーハンドリングの「責任」

`app.Calculation = pjManual` を実行した後、コードがエラーで停止すると、ユーザーのProjectは「手動計算モード」のまま放置される。これはユーザー体験(UX)において致命的なバグだ。必ず `ErrorHandler` 内で `pjAutomatic` へ戻す処理を実装すること。これは「親切心」ではなく「設計責任」である。

② 外部データ(DB/Excel)との連携

もし更新データが外部SQL ServerやExcelにある場合、「Projectのループの中でExcelを開いて値を探す」という愚行は絶対に避けること。
1. まずExcel/DBから全データを `Dictionary` に読み込む。
2. その `Dictionary` を使って、Projectのタスクを更新する。
この「データの局所化」が、パフォーマンスの差を生む。

③ オブジェクトのライフサイクル

`MSProject.Task` オブジェクトは、プロジェクトの構造が変わると無効化(Invalidate)されることがある。大量の更新を行う際は、Taskオブジェクトを保持し続けるのではなく、`TaskID`(Long型)をキーとして管理することを強く推奨する。IDは不変の識別子であり、最も安全なポインタとなる。

結論

MS Project VBAにおける真のプロフェッショナルとは、単に機能を実装する者ではない。「アプリケーションのエンジンがどのように回っているか」を理解し、そのエンジンに過度な負荷をかけないよう、計算のタイミングを制御できる者を指す。

「計算の遅延実行」アーキテクチャをマスターし、大規模プロジェクトにおいても、ユーザーを待たせない、ストレスを与えない、極めて堅牢な自動化ツールを構築せよ。

コードを書く前に、まず「計算」を止めろ。それが、マスターへの第一歩だ。

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