【極限の知見】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における真のプロフェッショナルとは、単に機能を実装する者ではない。「アプリケーションのエンジンがどのように回っているか」を理解し、そのエンジンに過度な負荷をかけないよう、計算のタイミングを制御できる者を指す。
「計算の遅延実行」アーキテクチャをマスターし、大規模プロジェクトにおいても、ユーザーを待たせない、ストレスを与えない、極めて堅牢な自動化ツールを構築せよ。
コードを書く前に、まず「計算」を止めろ。それが、マスターへの第一歩だ。
