全上書きは「素人」の仕事だ。Project VBAにおける差分更新(Delta Update)の極意
MS Projectの自動化ツールを開発しているとき、君はどのように外部データをインポートしているだろうか?
もし、「CSVを読み込み、全タスクをループして、カスタムフィールドの値をそのまま流し込む」という実装をしているのなら、今すぐそのコードを書き直すべきだ。
プロジェクトの規模が数百、数千タスクに膨らんだとき、その「単純なコード」は牙を剥く。プロパティへの書き込みが発生するたびにMS Projectの再計算エンジンが走り、UIの描画が走り、メモリが断続的に消費される。結果として、ユーザーは「ツールが固まった」と感じ、君の設計への信頼は失墜する。
本稿では、プロフェッショナルが実践する「差分のみを特定して更新する(Delta Update)」手法について、その設計思想から実装レベルのアーキテクチャまでを徹底的に解説する。
1. なぜ「全上書き」は致命的なのか
MS Projectは単なるスプレッドシートではない。複雑な依存関係、リソース制約、カレンダー計算を持つ「スケジューリング・エンジン」だ。
カスタムフィールド(`Text1`, `Number1`, `Cost1` など)の値を書き換えるという行為は、単にメモリ上の値を変更するだけではない。Projectのオブジェクトモデルにおいては、以下のコストが裏側で発生している。
1. 再計算トリガー: カスタムフィールドが計算式(Formula)を持っている場合、その変更がプロジェクト全体の再計算を誘発する可能性がある。
2. オブジェクトの通知: プロパティの変更は、ViewやUIへの通知を伴う。
3. Undoスタックの肥大化: 大量の書き込みはUndo(元に戻す)情報のメモリ消費を爆発させる。
したがって、「値が変わっていないなら、書き込まない」。これが、大規模プロジェクトを扱うエンジニアにとっての鉄則である。
2. 最速の差分判定アルゴリズム:Dictionaryによる $O(1)$ ルックアップ
効率的な差分更新を実現するためには、以下の2ステップの戦略をとる。
1. CSVデータを「検索可能な状態」でメモリに展開する
CSVの行を1行ずつProjectのタスクと比較しながら探す(二重ループ)のは、$O(N \times M)$ の計算量がかかり、極めて低速だ。代わりに、`Scripting.Dictionary` を使い、`UniqueID` をキーとしたハッシュマップを構築する。これにより、検索コストを定数時間 $O(1)$ に抑える。
2. Projectオブジェクト側を主軸にループする
Projectのタスクを走査し、Dictionary内に該当する `UniqueID` が存在するか、かつ「値が異なるか」を判定する。
⚠️ 重要:IDではなく「UniqueID」を使え
ここが初心者が最も陥りやすい罠だ。`Task.ID` は行番号であり、タスクの並び替えや削除によって変動する。一方、`Task.UniqueID` はデータベース内で不変の識別子だ。外部データとの紐付けには、必ず `UniqueID` を使用せよ。
3. プロダクション・クオリティのコード実装
以下に、実務でそのまま使えるレベルの堅牢なコードを示す。このコードは、`Microsoft Scripting Runtime` への参照設定が必要だ。
' ==============================================================================
' Module: modDeltaUpdate
' Description: CSVデータを用いたカスタムフィールドの差分更新エンジン
' Requirement: Microsoft Scripting Runtime (Dictionary用)
' ==============================================================================
Option Explicit
' CSVから読み込んだデータを保持するための構造体
Private Type TaskData
CustomFieldValue As String
End Type
''' <summary>
''' メインエントリーポイント:CSVからProjectタスクのカスタムフィールドを差分更新する
''' </summary>
Public Sub ExecuteDeltaUpdate()
Dim csvPath As String
csvPath = "C:\temp\task_updates.csv" ' 実運用ではダイアログ等で取得
On Error GoTo ErrorHandler
' 1. パフォーマンス最適化:計算と描画を停止
ToggleProjectPerformance False
' 2. CSVデータをDictionaryにロード (Key: UniqueID, Value: TaskData)
Dim dictUpdates As Object
Set dictUpdates = LoadCSVToDictionary(csvPath)
If dictUpdates Is Nothing Then
MsgBox "CSVの読み込みに失敗しました。", vbCritical
GoTo CleanUp
End If
' 3. 差分更新の実行
Dim updateCount As Long
updateCount = PerformDeltaUpdate(dictUpdates)
MsgBox "更新完了。" & vbCrLf & "更新件数: " & updateCount & " 件", vbInformation
CleanUp:
ToggleProjectPerformance True
Exit Sub
ErrorHandler:
MsgBox "予期せぬエラーが発生しました: " & Err.Description, vbCritical
Resume CleanUp
End Sub
''' <summary>
''' CSVを読み込み、UniqueIDをキーとしたDictionaryを構築する
''' </summary>
Private Function LoadCSVToDictionary(ByVal filePath As String) As Object
Dim dict As Object
Set dict = CreateObject("Scripting.Dictionary")
Dim fileNum As Integer
Dim lineData As String
Dim parts() As String
Dim targetUID As Long
Dim targetVal As String
fileNum = FreeFile
Open filePath For Input As #fileNum
' ヘッダー行をスキップする場合
If Not EOF(fileNum) Then Line Input #fileNum, lineData
Do While Not EOF(fileNum)
Line Input #fileNum, lineData
If Trim(lineData) <> "" Then
' CSVの形式を想定: UniqueID, CustomFieldValue
parts = Split(lineData, ",")
If UBound(parts) >= 1 Then
targetUID = CLng(parts(0))
targetVal = parts(1)
' Dictionaryに格納
dict(targetUID) = targetVal
End If
End If
Loop
Close #fileNum
Set LoadCSVToDictionary = dict
End Function
''' <summary>
''' Projectのタスクを走査し、値が異なる場合のみ更新する
''' </summary>
Private Function PerformDeltaUpdate(ByRef dictUpdates As Object) As Long
Dim t As Task
Dim currentVal As String
Dim newVal As String
Dim updateCount As Long
updateCount = 0
' Project内の全タスクを走査
For Each t In ActiveProject.Tasks
' 空のタスク(削除済み等)はスキップ
If Not t Is Nothing Then
' Dictionary内に該当するUniqueIDがあるか確認
If dictUpdates.Exists(t.UniqueID) Then
' 現在の値を取得(Text1を対象とする例)
currentVal = t.Text1
' CSV側の値を取得
newVal = dictUpdates(t.UniqueID)
' 【核心】値が異なる場合のみ書き込みを実行
If currentVal <> newVal Then
t.Text1 = newVal
updateCount = updateCount + 1
End If
End If
End If
Next t
PerformDeltaUpdate = updateCount
End Function
''' <summary>
''' Projectの描画・計算負荷を制御する
''' </summary>
Private Sub ToggleProjectPerformance(ByVal isEnabled As Boolean)
On Error Resume Next
If isEnabled Then
Application.Calculation = xlCalculationAutomatic
Application.ScreenUpdating = True
Else
Application.Calculation = xlCalculationManual
Application.ScreenUpdating = False
End If
' ※Project VBAにおけるScreenUpdating等の挙動は環境に依存するため
' 実務ではApplicationオブジェクトのプロパティを慎重に制御すること
End Sub
4. 設計のポイント:なぜこのコードは「堅牢」なのか
1. 計算量の最適化
`PerformDeltaUpdate` 内のループは $O(N)$ だ。辞書引き(`Exists`)は $O(1)$ なので、全体の計算量はタスク数 $N$ に比例するだけで済む。CSVの行数 $M$ がいくら増えても、プロジェクトのタスク数に対して劇的な速度低下は起こらない。
2. 状態の分離
CSVの読み込み(I/O処理)と、Projectの更新(オブジェクト操作)を明確に分離している。これにより、ファイルがロックされている場合や、フォーマットが不正な場合のデバッグが容易になる。
3. エラーハンドリングとクリーンアップ
`ToggleProjectPerformance` を用いて、処理開始時に計算を停止し、終了時に必ず元の状態に戻す。これを怠ると、エラーでプログラムが止まった際に「Projectの計算が止まったまま」という、ユーザーにとって最悪の体験を招くことになる。
5. さらなる高みへ:実務での注意点
この手法をさらに洗練させるなら、以下の要素を検討せよ。
- データ型の厳密な管理: 上記例では `Text1`(文字列型)を扱っているが、`Number1` や `Date1` を扱う場合は、`CStr` や `CDate` による型変換と、変換失敗時のエラーハンドリングが必須だ。
- Resource(リソース)への拡張: `Task` ではなく `Resource` オブジェクトをループさせるだけで、リソース側のカスタムフィールド更新にもこのロジックは転用できる。
- ログ出力: どの `UniqueID` が更新されたか、あるいはCSVに存在するのにProjectに存在しなかったUIDはどれか、をログファイルに出力する機能を持たせると、運用フェーズでの信頼性が跳ね上がる。
結論
「動けばいい」という考えは、小規模なスクリプトでは許される。しかし、業務を支えるシステムを構築するエンジニアにとって、パフォーマンスと堅牢性は品質そのものだ。
オブジェクトのライフサイクルを理解し、計算コストを最小化する。この「差分更新」の思想をマスターしてこそ、真のProject VBAマスターと呼べるだろう。
