【実務・中級編】【上級者向け】カスタムフィールドの値をメモリ上で高速処理し、最後に一括反映させる仮想化バッファの実装 – Project VBA解析バイブル

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

Project VBAの限界を突破せよ:COMアクセスを最小化する「仮想化バッファ」設計論

MS Projectを操作するVBAエンジニアの多くは、ある「壁」にぶつかる。
タスク数が数千、リソースが数百を超えたあたりで、プログラムの実行速度が指数関数的に低下し、まるで泥沼を歩いているかのような鈍重さに襲われるのだ。

もし君が、`For Each t In ActiveProject.Tasks` のループの中で、直接 `t.Text1 = “Calculated Value”` のようにカスタムフィールドへ値を書き込んでいるとしたら……。
断言しよう。君の設計は、極めて非効率だ。

なぜなら、MS Projectのオブジェクトモデルへのアクセスは、VBAの内部メモリ操作とは比較にならないほど重い「COMインターフェースを介したプロセス間通信」を伴うからだ。1回の書き込みごとに、Projectエンジンは再計算やUIの更新、内部的な整合性チェックを走らせる。これを数千回繰り返すのは、一軒の家を建てるたびに、資材を一度市役所まで運び、承認を得てから現場に戻るような愚行である。

本稿では、プロフェッショナルとして到達すべき、「メモリ上で計算を完結させ、最後に一括反映させる」仮想化バッファ(Virtual Buffer)の実装手法を伝授する。

1. 敗北の設計 vs 勝利の設計

まず、君が現在書いているコードを、鏡に照らして見てほしい。

【敗北の設計】Direct Write Pattern

' 典型的な、低速なコード
Sub SlowProcess()
    Dim t As Task
    For Each t In ActiveProject.Tasks
        If Not t Is Nothing Then
            ' 毎回、COMオブジェクト経由で読み取り、書き込みを行う
            ' これが「死のループ」の正体だ
            t.Text1 = t.Duration * 0.1 
        End If
    Next t
End Sub

このコードの致命的な問題は、「読み取り」と「書き込み」が交互に、かつ大量に発生している点にある。Projectエンジンは、1行書き込まれるごとに「プロジェクト全体の整合性が変わったか?」を疑い、その都度オーバーヘッドを発生させる。

【勝利の設計】Virtual Buffer Pattern

我々が目指すべきは、以下の3ステップに分離されたアーキテクチャだ。
1. Snapshot Phase: 全ての必要なデータを、高速なメモリ上のデータ構造(DictionaryやUser Defined Type)に一括で吸い出す。
2. Computation Phase: Projectのオブジェクトには一切触れず、メモリ上のデータだけで複雑な計算を完結させる。
3. Commit Phase: 計算結果を、極力最小限の回数で、一括してProjectのカスタムフィールドへ書き戻す。

2. 実装の極意:堅牢な仮想化バッファの構築

それでは、実際にプロダクション環境で耐えうる、保守性の高いコードを実装していこう。
ここでは、タスクの「工数(Duration)」に基づいた独自の「重み付け係数」をカスタムフィールド(Text1)に計算して格納するロジックを例にする。

プロダクション・グレードのコード例

Option Explicit

' --- 1. データ構造の定義 ---
' 必要なプロパティだけを保持する軽量な構造体。
' これが「仮想化バッファ」の最小単位となる。
Private Type TaskBuffer
    ID As Long
    Name As String
    Duration As Double
    CalculatedValue As String ' 書き込み用の計算結果
End Type

' --- 2. メインロジック ---
Sub ExecuteHighSpeedCalculation()
    Dim taskMap As Object
    Set taskMap = CreateObject("Scripting.Dictionary")
    
    Dim startTime As Double
    startTime = Timer

    On Error GoTo ErrorHandler

    ' プロジェクトの状態を固定(高速化の定石)
    Application.DisplayAlerts = False
    
    ' STEP 1: Snapshot Phase (読み取りの集約)
    Debug.Print "Snapshot Phase: Starting..."
    Call SnapshotTasks(taskMap)
    
    ' STEP 2: Computation Phase (メモリ上での計算)
    ' ここではProjectオブジェクトに一切触れない。純粋な数学的演算のみ。
    Debug.Print "Computation Phase: Starting..."
    Call ComputeLogic(taskMap)
    
    ' STEP 3: Commit Phase (書き込みの集約)
    ' 計算が終わった後、一気に書き戻す。
    Debug.Print "Commit Phase: Starting..."
    Call CommitTasks(taskMap)

    Application.DisplayAlerts = True
    Debug.Print "Total Execution Time: " & Format(Timer - startTime, "0.00") & " sec"
    MsgBox "処理が完了しました。", vbInformation
    Exit Sub

ErrorHandler:
    Application.DisplayAlerts = True
    MsgBox "致命的なエラーが発生しました: " & Err.Description, vbCritical
End Sub

' --- 3. 各フェーズの具体的実装 ---

''' <summary>
''' 全タスクのデータをメモリへ吸い出す
''' </summary>
Private Sub SnapshotTasks(ByRef taskMap As Object)
    Dim t As Task
    Dim buf As TaskBuffer
    
    ' Projectの全タスクを走査
    For Each t In ActiveProject.Tasks
        If Not t Is Nothing Then
            buf.ID = t.ID
            buf.Name = t.Name
            buf.Duration = t.Duration
            ' 辞書に格納(Keyは一意であるIDを使用)
            taskMap.Add t.ID, buf
        End If
    Next t
End Sub

''' <summary>
''' メモリ上のデータのみを用いて計算を行う(非破壊的)
''' </summary>
Private Sub ComputeLogic(ByRef taskMap As Object)
    Dim key As Variant
    Dim buf As TaskBuffer
    
    For Each key In taskMap.Keys
        buf = taskMap(key)
        
        ' --- ここに複雑なビジネスロジックを記述 ---
        ' 例: 工数が10日以上なら "High", そうでなければ "Low"
        If buf.Duration >= 80 Then ' 80 = 10days (assuming 8h/day)
            buf.CalculatedValue = "High Priority"
        Else
            buf.CalculatedValue = "Standard"
        End If
        ' --------------------------------------
        
        ' 更新した構造体を辞書に戻す
        taskMap(key) = buf
    Next key
End Sub

''' <summary>
''' 計算結果をProjectのカスタムフィールドへ一括反映する
''' </summary>
Private Sub CommitTasks(ByRef taskMap As Object)
    Dim key As Variant
    Dim buf As TaskBuffer
    Dim t As Task
    
    ' 書き戻し時には、再度タスクを特定する必要がある。
    ' IDをキーにすることで、高速にオブジェクトへアクセスする。
    For Each key In taskMap.Keys
        buf = taskMap(key)
        
        ' 特定のタスクをIDから直接取得(Indexによるアクセスより堅牢)
        ' ※大規模データの場合、ここも最適化の余地があるが、
        ' 書き込み回数を減らすことが最大の目的である。
        Set t = GetTaskByID(CLng(key))
        
        If Not t Is Nothing Then
            ' ここで初めてCOMオブジェクトへの書き込みが発生する
            t.Text1 = buf.CalculatedValue
        End If
    Next key
End Sub

''' <summary>
''' IDからTaskオブジェクトを特定するヘルパー関数
''' </summary>
Private Function GetTaskByID(targetID As Long) As Task
    On Error Resume Next
    ' Task.IDは一意なので、これを利用して特定する
    ' ただし、Projectのコレクション構造上、直接IDで引けない場合は
    ' 全走査が必要になる。その場合は、Snapshot時にオブジェクト自体を
    ' 辞書に保持しておく手法(後述)を検討せよ。
    Dim t As Task
    For Each t In ActiveProject.Tasks
        If t.ID = targetID Then
            Set GetTaskByID = t
            Exit Function
        End If
    Next t
End Function

3. リーダーからの技術的補足:堅牢性を高めるための「罠」

この設計を実戦投入するにあたり、君が陥りやすい罠が3つある。これを回避して初めて「シニア」を名乗れる。

① オブジェクト参照の保持(メモリ vs 速度のトレードオフ)

上記のコードでは、`CommitPhase` で `GetTaskByID` という走査関数を使っている。これは「メモリ消費を抑える」観点では正しいが、タスク数が数万件になるとここがボトルネックになる。
もしメモリに余裕があるなら、`TaskBuffer` 構造体に `Task Object` そのものを保持させておく(`ByRef t As Task`)という選択肢もある。ただし、これを行うと、計算中にプロジェクトの構造(タスクの削除など)が変わった場合に、参照が壊れるリスクを負う。「データ(値)」を保持するのか、「参照(オブジェクト)」を保持するのか。この設計判断を常に意識せよ。

② エラーハンドリングとトランザクションの欠如

VBAには標準的なデータベースのような「Rollback」機能はない。`CommitPhase` の途中でエラーが起きた場合、プロジェクトのカスタムフィールドは「半分だけ更新された」という、極めて不安定な状態に陥る。
実務レベルでは、`CommitPhase` の前に、現在のカスタムフィールドの値を別の場所にバックアップしておく、あるいは「一括更新用のフラグ」を設けるといった、アプリケーション層でのトランザクション管理を実装すべきだ。

③ カスタムフィールドのデータ型

`Text1`(文字列型)に数値を書き込むのか、`Number1`(数値型)に書き込むのか。これを混同すると、後続のProject標準計算式がすべて壊れる。バッファに格納する段階で、型チェックを厳格に行うこと。

結論

Project VBAの高速化の本質は、「Projectのオブジェクトモデルを、いかに『忘れる』か」にある。
オブジェクトに触れている間、君のプログラムはProjectという巨大な重力に縛られている。計算をメモリという無重力空間へと解き放ち、最後に一撃で結果を叩き込む。

この「仮想化バッファ」の概念をマスターすれば、君が作るツールは、同僚が作成した「動けばいいだけのコード」とは一線を画す、プロフェッショナルな道具へと昇華するだろう。

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