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

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

Project VBAを掌握する極限の知見:差分更新による「爆速」インポート術

こんにちは。現場で数々の複雑なプロジェクト管理システムを設計してきた、あなたの頼れるシニアエンジニアです。

「マクロの記録」を使って、タスクの名前を変えたり、日付を入れたり……。そんな一歩を踏み出したあなたは、すでに素晴らしいスタートを切っています。でも、プロジェクトの規模が大きくなってくると、こんな壁にぶつかったことはありませんか?

「CSVからデータを流し込むマクロを作ったけれど、データが増えたら動きがめちゃくちゃ重い……」

実はこれ、Project VBAの「仕組み」を理解していない人が必ず通る道なんです。今日は、単なる「上書き」から脱却し、プロのエンジニアが実践する「差分のみを更新する」という、パフォーマンスを極限まで高める高度なテクニックを伝授します。

ここをクリアすれば、あなたの作るツールは「動くもの」から「実務に耐えうるプロフェッショナルな武器」へと進化しますよ。

1. なぜ「全データ上書き」はProjectを重くするのか?

まず、敵(原因)を知ることから始めましょう。なぜ、全てのタスクのカスタムフィールドをCSVの値で上書きすると、処理が遅くなるのでしょうか?

Projectの「再計算エンジン」の正体

ExcelとProjectの決定的な違いは、「セル同士の繋がり(依存関係)」にあります。

Projectは、一つのタスクの値を書き換えるたびに、「この変更によって、後続のタスクの日付はどう変わるか?」「リソースの負荷はどうなるか?」という再計算(Scheduling Engine)を裏側で走らせようとします。

1. 全上書き(暴力的な手法): 1,000個のタスクがあるとき、たとえ値が変わっていなくても1,000回「書き込み」が発生し、そのたびにProjectは「計算しなきゃ!」とフル回転します。
2. 差分更新(賢い手法): 1,000個のうち、本当に変わった5個だけを書き換えます。計算のトリガーは5回だけで済みます。

この「計算回数の差」が、数秒で終わる処理を数分に引き延ばしてしまう原因なのです。

2. 戦略:Dictionaryオブジェクトを使った「高速照合」

では、どうやって「変更があったかどうか」を瞬時に判断すればいいのでしょうか?

もっとも効率的なのは、「CSVのデータを一旦、メモリ上の辞書(Dictionary)に格納し、Projectのタスクと比較する」という手法です。

アルゴリズムの設計図

1. 準備: CSVファイルを読み込み、`Dictionary`オブジェクトに格納する。

  • Key(鍵): タスクを一意に特定できるID(例:タスク番号や、Text1に入れた管理番号)
  • Value(値): 更新したい新しい値

2. 走査: Projectの全タスクをループで回す。
3. 照合:

  • 「今見ているタスクのID」は、辞書にあるか?
  • 辞書にある場合、「現在の値」と「辞書の値」は違うか?

4. 実行: 「違う場合のみ」、値を書き換える。

3. 実装:極限の効率化コード

それでは、実際のコードを見ていきましょう。ここでは、`Text1`に「管理ID」が入っており、`Text2`に「CSVから持ってきた新しい値」を入れるというシナリオで記述します。

※このコードを使用するには、VBAエディタの [ツール] -> [参照設定] で 「Microsoft Scripting Runtime」 にチェックを入れてください(Dictionaryを使うため)。

Option Explicit

''' <summary>
''' CSVから差分のみをカスタムフィールドにインポートする
''' </summary>
Sub ImportCustomFields_DeltaOnly()
    Dim dict As New Scripting.Dictionary
    Dim filePath As String
    Dim fileNo As Integer
    Dim lineData As String
    Dim arrData As Variant
    Dim taskKey As String
    Dim newValue As String
    
    Dim t As Task
    Dim updateCount As Long
    Dim skipCount As Long
    
    ' --- 設定エリア ---
    filePath = "C:\Temp\update_data.csv" ' CSVのパス
    ' ------------------

    On Error GoTo ErrorHandler

    ' 1. CSVの読み込み(メモリ上の辞書に格納)
    ' CSV形式想定: 管理ID,更新したい値
    fileNo = FreeFile
    Open filePath For Input As #fileNo
    Do While Not EOF(fileNo)
        Line Input #fileNo, lineData
        arrData = Split(lineData, ",") ' カンマ区切り
        
        If UBound(arrData) >= 1 Then
            taskKey = Trim(arrData(0))
            newValue = Trim(arrData(1))
            ' 辞書に格納 (Key: 管理ID, Value: 新しい値)
            dict(taskKey) = newValue
        End If
    Loop
    Close #fileNo

    ' 2. Projectの計算設定を一時的に「手動」にする(重要!)
    ' これにより、書き換えのたびに再計算が走るのを防ぎます
    Application.Calculation = pjManual
    
    ' 3. Projectタスクのループと差分更新
    updateCount = 0
    skipCount = 0
    
    For Each t In ActiveProject.Tasks
        ' 空のタスク(サマリータスク以外や削除済み)をスキップ
        If Not t Is Nothing Then
            ' Text1に管理IDが入っていると想定
            taskKey = Trim(t.Text1)
            
            ' 辞書にこのタスクのIDが存在するか確認
            If dict.Exists(taskKey) Then
                ' 【ここが肝!】現在の値と、辞書の値が「異なる場合のみ」書き換える
                If t.Text2 <> dict(taskKey) Then
                    t.Text2 = dict(taskKey)
                    updateCount = updateCount + 1
                Else
                    skipCount = skipCount + 1
                End If
            End If
        End If
    Next t

    ' 4. 計算設定を「自動」に戻す
    Application.Calculation = pjAutomatic
    
    MsgBox "インポート完了!" & vbCrLf & _
           "更新件数: " & updateCount & " 件" & vbCrLf & _
           "変更なし: " & skipCount & " 件", vbInformation

    Exit Sub

ErrorHandler:
    ' エラーが起きても計算設定を戻すようにする
    Application.Calculation = pjAutomatic
    MsgBox "エラーが発生しました: " & Err.Description, vbCritical
    If fileNo > 0 Then Close #fileNo
End Sub

4. 伝説のエンジニアが教える「落とし穴」回避術

このコードを使いこなすために、以下の3つのポイントを必ず覚えておいてください。

① `Application.Calculation = pjManual` は魔法の言葉

コード内で使っているこの一行。これこそが、大量データ処理における最大のパフォーマンス・ブースターです。書き込み中の「おせっかいな再計算」を一時的に止めることで、処理速度は劇的に向上します。ただし、必ず最後に `pjAutomatic` に戻すこと。これを忘れると、ユーザーが手動で計算しなければならないプロジェクトになってしまいます。

② 「一意のキー」を死守せよ

`Task.ID`(タスク番号)をキーに使うのは、実は少し危険です。タスクの並べ替えや削除を行うと、IDが変わってしまうことがあるからです。
実務では、`Text1` などのカスタムフィールドに、システムから発行された「不変の管理番号(ユニークID)」を格納しておくのが、アーキテクトとしての定石です。

③ 型の不一致に注意

CSVから読み込んだ値はすべて「文字列(String)」として扱われます。もしカスタムフィールドに数値を入れたい場合でも、比較の際は `t.Text2 <> dict(taskKey)` のように、型を意識した比較を行うか、必要に応じて `Val()` 関数などで変換してください。

まとめ:一歩上のエンジニアへ

「動けばいい」という段階から、「効率的に、安全に、速く動く」という段階へ。
今回学んだ「メモリ上での照合(Dictionary)」と「計算エンジンの制御(Calculation Mode)」、そして「差分更新(Delta Update)」という考え方は、Project VBAに限らず、あらゆるプログラミングに応用できる一生モノの技術です。

最初はエラーが出ることもあるでしょう。でも、そのエラーを一つずつ潰していくプロセスこそが、あなたを本物のエンジニアへと育ててくれます。

ここをクリアすれば、Project VBAの基本はバッチリですよ。さあ、自信を持って次のコードを書き始めましょう!

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