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という巨大な重力に縛られている。計算をメモリという無重力空間へと解き放ち、最後に一撃で結果を叩き込む。
この「仮想化バッファ」の概念をマスターすれば、君が作るツールは、同僚が作成した「動けばいいだけのコード」とは一線を画す、プロフェッショナルな道具へと昇華するだろう。
