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

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

Project VBAを掌握する:カスタムフィールドの「計算嵐」を鎮めるバッチ処理アーキテクチャ

こんにちは。今日は、プロジェクト管理の現場で「マクロを動かした瞬間にProjectがフリーズして動かなくなる」という、多くのエンジニアが一度は直面する絶望的な問題について話をしましょう。

あなたが「マクロの記録」を卒業し、自分でコードを書き始めたとき、最初にぶつかる壁の一つが「パフォーマンス」です。特に、大量のタスクやリソースに対してカスタムフィールド(ユーザー定義フィールド)を更新しようとすると、Projectはまるで嵐に巻き込まれたかのように、計算処理の連鎖(Recalculation Storm)を引き起こします。

今日は、その嵐を鎮め、大規模プロジェクトでも軽快に動作する「計算の遅延実行(バッチ処理)アーキテクチャ」の設計思想を伝授します。ここをクリアすれば、あなたのProject VBAは「ただ動くツール」から「プロ仕様のシステム」へと進化しますよ。

1. なぜ、あなたのコードは重いのか?「再計算の嵐」の正体

まず、敵を知ることから始めましょう。なぜカスタムフィールドの更新が重いのか。それは、Microsoft Projectの「イベント駆動型」の性質に原因があります。

通常、Projectは「データが変わった」と検知するたびに、関連するすべての計算式を再評価しようとします。

【図解:再計算の連鎖(Recalculation Storm)】

1. VBAがTask Aのカスタムフィールドを更新
2. $\downarrow$ Projectが「あ、データが変わった!」と検知
3. $\downarrow$ 「関連するすべてのタスクとリソースの計算式を今すぐ計算しなきゃ!」と判断
4. $\downarrow$ 計算中に次のコード(Task Bの更新)が実行される
5. $\downarrow$ また計算が走る(無限ループに近い負荷)

これが、数千行のタスクに対してループ処理を行うと、PCのCPUが悲鳴を上げ、画面が「応答なし」になるメカニズムです。

2. 解決策:計算を「制御」下に置くアーキテクチャ

プロのエンジニアは、計算を「自動」に任せません。計算のタイミングを「データの入力中」と「計算の実行時」に明確に分離します。

これを実現するための戦略は、大きく分けて2つです。

戦略A:計算モードの切り替え(Manual Calculation)

計算エンジンを一時的に「手動モード」に切り替えます。これにより、ループ中の余計な再計算を完全にシャットアウトします。

戦略B:バッチ処理とDoEvents(Batching & UI Responsiveness)

一気に処理せず、一定件数ごとに制御をOSに戻すことで、画面のフリーズを防ぎ、ユーザーに「動いていること」を伝えます。

3. 実践:プロフェッショナルなバッチ更新コード

それでは、これらを組み合わせた「黄金のテンプレート」を見てみましょう。このコードは、単なる更新処理ではなく、エラーハンドリングとパフォーマンス最適化を両立させたものです。

Option Explicit

''' <summary>
''' 大量タスクのカスタムフィールドを一括更新するプロフェッショナル・ルーチン
''' </summary>
Sub BatchUpdateCustomFields()
    Dim t As Task
    Dim taskCount As Long
    Dim i As Long
    Dim batchSize As Long
    
    ' --- 設定値 ---
    batchSize = 500 ' 何件ごとにOSに制御を戻すか(調整可能)
    ' --------------

    ' 1. パフォーマンス最適化の準備
    ' 計算モードを手動に切り替え、再計算の嵐を防ぐ
    Application.Calculation = pjCalculationManual
    
    ' 画面更新を停止(描画負荷の軽減)
    ' ※Project VBAでは直接的なScreenUpdatingプロパティがない場合が多いが、
    ' 描画を伴う操作を避けることで同様の効果を得る
    
    On Error GoTo ErrorHandler
    
    taskCount = ActiveProject.Tasks.Count
    i = 0

    Debug.Print "処理開始: " & Now
    
    ' 2. メインループ
    For Each t In ActiveProject.Tasks
        ' 空のタスク(サマリータスクを除く等)のスキップ処理
        If Not t Is Nothing Then
            
            ' --- ここに更新ロジックを記述 ---
            ' 例: Text1フィールドに計算結果を代入する
            t.Text1 = "Updated_" & Format(Now, "hhmmss")
            ' ------------------------------
            
            i = i + 1
            
            ' 3. バッチ処理の肝:DoEvents
            ' 一定件数ごとにOSへ制御を戻し、フリーズを防ぐ
            If i Mod batchSize = 0 Then
                DoEvents ' これが「画面の応答なし」を防ぐ魔法の言葉
                Debug.Print i & " 件完了..."
            End If
        End If
    Next t

    ' 4. 後処理:計算の実行
    ' すべてのデータ入力が終わった「最後の一回」だけ、全力で計算させる
    Debug.Print "計算実行中..."
    Application.Calculate
    
    ' 計算モードを自動に戻す
    Application.Calculation = pjCalculationAutomatic
    
    MsgBox "完了しました!" & vbCrLf & "処理件数: " & i & " 件", vbInformation
    
    Exit Sub

ErrorHandler:
    ' エラーが発生しても、計算モードを自動に戻さないとProjectが壊れたようになるため、必ず通るようにする
    Application.Calculation = pjCalculationAutomatic
    MsgBox "エラーが発生しました: " & Err.Description, vbCritical
End Sub

コードの重要ポイント解説

1. `Application.Calculation = pjCalculationManual`
これが最も重要です。これ一行で、ループ中の「再計算の嵐」を完全に防げます。
2. `i Mod batchSize = 0`
「iをbatchSizeで割った余りが0のとき」という条件です。500件ごとに一度だけ、重い処理を中断して休憩を挟むイメージです。
3. `DoEvents`
これがないと、Windowsは「このアプリは固まっている」と判断してしまいます。`DoEvents`を呼ぶことで、マウス操作や画面の更新を受け付ける隙間を作ります。
4. `On Error GoTo ErrorHandler`
もし途中でエラーが起きても、`Calculation`を`Automatic`に戻さないと、ユーザーは「なぜかProjectが計算してくれない!」というパニックに陥ります。後始末(クリーンアップ)はエンジニアの責任です。

4. 陥りやすい罠(Pitfalls)

ここまで読んでくれたあなたに、現場でよく見る「失敗パターン」を教えておきましょう。

  • 「計算モードを戻し忘れる」

エラーでコードが止まった際、計算モードが`Manual`のままだと、その後手動で数値を入力しても一切計算されません。必ず`ErrorHandler`で戻す癖をつけましょう。

  • 「BatchSizeが小さすぎる」

`batchSize = 1`にすると、毎回`DoEvents`を呼ぶため、逆に処理が劇的に遅くなります。プロジェクトの規模に合わせて、500〜1000程度から調整するのがベストです。

  • 「オブジェクトのライフサイクルを無視する」

`For Each t In ActiveProject.Tasks` の中で、`t.Delete`(タスクの削除)を行うと、ループのインデックスが狂い、エラーになります。削除を行う場合は、後ろのタスクから逆順に回すのが鉄則です。

最後に

いかがでしたか?
「動けばいい」という段階から、「大量のデータでもスマートに動く」という段階へ。この設計思想を取り入れるだけで、あなたの作るツールは劇的にプロフェッショナルなものになります。

最初は難しく感じるかもしれませんが、「計算をコントロールする」という感覚さえ掴めれば、Project VBAはあなたの最強の武器になります。

ここをクリアすれば、Project VBAの基本はバッチリですよ。自信を持って、次のステップへ進んでくださいね!応援しています。

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