【Project VBA 掌握術】数千行のカスタムフィールドを瞬時に制圧する:高速初期化の設計思想と実装の極意
現場で「業務効率化ツールを作ってくれ」と依頼されたとき、初心者はまず「動くコード」を書く。しかし、プロフェッショナルが書くのは「スケールし、壊れず、ユーザーを待たせないコード」だ。
MS Projectにおいて、数千、数万のタスクやリソースを扱うプロジェクトは珍しくない。その膨大なデータに対し、「カスタムフィールド(Text1やNumber1など)をリセットする」という、一見単純に見える操作。これを素人が書いた「単純なFor Eachループ」で実装してみろ。処理が終わるまでユーザーは数分間、フリーズした画面を眺め続けることになるだろう。それはツールではない。ただの「時間の浪費装置」だ。
本記事では、Project VBAにおいてカスタムフィールドを一括クリアする際、いかにして計算コストを最小化し、堅牢なプロダクションレベルのコードを設計すべきか、その極限の知見を伝授する。
1. なぜ「単純なループ」は遅いのか:COMインターフェースの代償
まず、君たちが陥りがちな「速度の罠」の正体を理解せよ。
MS Projectのオブジェクト(`Task` や `Resource`)にアクセスする行為は、VBAからMS Projectのコアエンジン(COMオブジェクト)に対して「命令を投げる」行為だ。
`Task.Text1 = “”` という一行を実行するたびに、VBAとProject本体の間で通信(オーバーヘッド)が発生する。これを数千回繰り返せば、通信コストだけで膨大な時間が溶けていく。
さらに、Projectには「再計算エンジン」が組み込まれている。カスタムフィールドの値を書き換えるたびに、Projectは「他のタスクや計算式への影響はないか?」と裏側で計算を試みる。この「書き換え」と「再計算」の無限ループこそが、速度低下の真犯人だ。
2. 高速化を実現する「三本の柱」
プロフェッショナルは、以下の3つの制御を必ずセットで行う。
1. ScreenUpdatingの停止: 画面描画の更新を止める。描画は極めて重い処理だ。
2. Calculationの制御: 自動計算を「手動」に切り替える。書き換えのたびに計算させるのは愚策だ。
3. オブジェクトアクセスの最適化: 可能な限り、無駄なプロパティ参照を避ける。
3. プロダクション・グレードの実装例
以下に、実務でそのまま使える「堅牢かつ高速な」初期化モジュールの設計例を示す。単なるループではなく、「環境の状態を管理する」という設計思想を取り入れている。
Option Explicit
' ==============================================================================
' Module: modCustomFieldManager
' Description: カスタムフィールドの一括操作を高速かつ安全に行うためのモジュール
' ==============================================================================
''' <summary>
''' タスクのカスタムフィールドを一括クリアする
''' </summary>
''' <param name="targetTextFields">クリアしたいTextフィールドの配列 (例: Array(pjText1, pjText2))</param>
Public Sub ClearTaskCustomFields(ByRef targetTextFields As Variant)
Dim t As Task
Dim field As Variant
' 1. 環境の最適化(高速化モードへ移行)
ToggleProjectEnvironment False
' エラーハンドリング:途中でエラーが起きても必ず環境を復元させる
On Error GoTo ErrorHandler
' 2. 高速ループ処理
' TaskCollectionを直接回す。大規模データではこのオーバーヘッドを意識せよ
For Each t In ActiveProject.Tasks
' 空白タスク(サマリータスク以外や削除済みタスク)をスキップするガード句
If Not t Is Nothing Then
' 指定されたフィールドのみをクリア
For Each field In targetTextFields
t.SetField field, ""
Next field
End If
Next t
MsgBox "タスクのカスタムフィールド初期化が完了しました。", vbInformation, "完了"
CleanExit:
' 3. 環境の復元(必ず実行される)
ToggleProjectEnvironment True
Exit Sub
ErrorHandler:
MsgBox "エラーが発生しました: " & Err.Description, vbCritical, "致命的エラー"
Resume CleanExit
End Sub
''' <summary>
''' Projectの描画および計算設定を制御する(環境のステート管理)
''' </summary>
''' <param name="isOptimized">Trueなら通常モード、Falseなら高速化モード</param>
Private Sub ToggleProjectEnvironment(ByVal isOptimized As Boolean)
With Application
If isOptimized Then
' 通常モードへ復元
.ScreenUpdating = True
.Calculation = pjCalculationAutomatic
Else
' 高速化モードへ移行
.ScreenUpdating = False
' 計算を「手動」にすることで、書き換えごとの再計算を阻止する
.Calculation = pjCalculationManual
End If
End With
End Sub
' ==============================================================================
' 実行用テストプロシージャ
' ==============================================================================
Sub Test_ClearFields()
' クリアしたいフィールドを列挙する(保守性を高めるため配列で渡す)
Dim fieldsToClear As Variant
fieldsToClear = Array(pjText1, pjText2, pjText3)
Call ClearTaskCustomFields(fieldsToClear)
End Sub
4. 設計のポイント:なぜこのコードは「強い」のか
① ステート管理の分離 (`ToggleProjectEnvironment`)
`ScreenUpdating` や `Calculation` の切り替えをメインロジックから切り離した。これにより、他の機能(リソースの更新など)を作る際も、この関数を呼ぶだけで「高速化の作法」を再利用できる。これは保守性の極みだ。
② ガード句による堅牢性
`If Not t Is Nothing Then`。これは初歩的だが、大規模プロジェクトでは必須だ。削除されたタスクや、参照が不安定なオブジェクトに触れた瞬間に実行時エラーで落ちるコードは、プロの仕事ではない。
③ エラーハンドリングの設計
`On Error GoTo ErrorHandler` と `CleanExit` の組み合わせ。
ここが重要だ。もしループの途中でエラーが起きたとき、`ScreenUpdating = False` のまま終了してしまったらどうなるか? ユーザーの画面は固まったように見え、パニックに陥る。「エラーが起きても、必ず環境を元の状態に戻して終了する」。これが、信頼されるエンジニアの鉄則だ。
5. 外部連携における「致命的な落とし穴」
もし君が、このカスタムフィールドの値を「外部のデータベース(SQL ServerやExcelファイル)」と同期させている場合、注意が必要だ。
カスタムフィールドをクリアする操作は、Project側から見れば「データの変更」である。もしアドインや外部連携ツールが「変更検知(Change Tracking)」を行っている場合、ループ内で一回ずつ同期が走ってしまう可能性がある。
- 対策:
- 同期プロセスがある場合は、まず「同期をオフ」にする。
- VBAで一括クリアを完了させた後に、一括で同期をかける。
「一括で処理する」とは、単にループを速くすることではない。「一連の作業工程(プロセス)全体を、最小のステップ数で完結させること」を指すのだ。
結論
数千行のデータを扱うとき、コードの書き方一つで、ツールは「魔法の杖」にも「使い物にならないゴミ」にもなる。
1. 環境(Screen/Calculation)を制御せよ。
2. 状態(State)を管理せよ。
3. エラー(Error)から逃げるな。
この3点を胸に刻んで、次の開発に臨んでほしい。健闘を祈る。
