【実務・中級編】【中級者向け】カスタムフィールドの値を外部CSVからインポートし、差分のみを更新する効率化手法 – Project VBA解析バイブル

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

全上書きは「素人」の仕事だ。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マスターと呼べるだろう。

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