【極限の知見】Project VBAの「循環参照」を制する:カスタムフィールドの計算エラーを自動検知するデバッグ術
こんにちは。プロジェクトの自動化という広大な海へ漕ぎ出した皆さん、ようこそ。
「マクロの記録」ボタンを卒業し、自分の手でコードを書き始めた皆さんは、今、非常にエキサイティングなフェーズにいます。変数を定義し、ループを回し、プロジェクトのデータを自在に操る……。その快感は、エンジニアとしての扉が開いた証です。
しかし、MS Projectの「カスタムフィールド」という領域に足を踏み入れたとき、皆さんは一度は「底なし沼」に足を取られることになるでしょう。
それが、「循環参照(Circular Reference)」です。
「Aという項目の計算にBを使い、Bの計算にAを使う」――。
一見、シンプルな数式に見えても、このループが発生した瞬間、プロジェクトの計算エンジンは悲鳴を上げ、あなたの作った自動化ツールは音もなく沈黙します。
今日は、中級者への階段を登るために避けては通れないこの「循環参照」を、VBAの力でスマートに検知し、エラー箇所を特定する「デバッグ・アーキテクチャ」の構築方法を伝授しましょう。
1. なぜ「循環参照」は牙を剥くのか?
MS Projectのカスタムフィールドは、単なる「箱」ではありません。それは、プロジェクトのスケジュールが更新されるたびに、背後で常に動き続ける「生きた計算式(数式)」です。
循環参照のメカニズム
例えば、以下のような設定を考えてみてください。
- Number1(コスト係数): `[Number2] * 1.1`
- Number2(調整値): `[Number1] / 1.1`
これらが設定された瞬間、計算エンジンは無限ループに陥ります。「Number1を出すにはNumber2が必要だ。でもNumber2を出すにはNumber1が必要だ……」という終わりのない連鎖です。
MS Projectは賢いため、完全にフリーズする前に計算を停止させますが、その際、「どのタスクの、どのフィールドが、なぜ壊れたのか」をユーザーに親切に教えてくれることは稀です。ただ、数式の結果が `#ERROR` と表示されるだけ。大規模なプロジェクトで、数千のタスクがある中でこれを見つけ出すのは、砂漠で一本の針を探すようなものです。
2. 戦略的アプローチ:検知のロジック
プロのエンジニアは、闇雲にコードを書きません。まず「どうやってエラーを炙り出すか」という戦略を立てます。
今回のデバッグツールの戦略はこうです。
1. フィールドの走査: プロジェクト内のすべてのタスクを巡回する。
2. 強制評価: 各タスクのカスタムフィールドの値を、VBAから「あえて」読み取りに行く。
3. エラーキャッチ: 値を読み取ろうとした際に、計算エラーが発生したら、その瞬間に「タスク名」「フィールド名」「エラー内容」をログに記録する。
これこそが、「エラーをエラーとして捉え、構造化して出力する」という、実務におけるデバッグの鉄則です。
3. 実装:循環参照・自動検知エンジン
それでは、魂を込めたコードを見ていきましょう。このコードは、単に動くだけでなく、後からメンテナンスしやすいように設計しています。
Option Explicit
''' <summary>
''' カスタムフィールドの計算エラー(循環参照含む)を検知し、ログを出力する
''' </summary>
Sub DetectCustomFieldErrors()
Dim t As Task
Dim pf As Property
Dim errorCount As Integer
Dim logSheet As Worksheet
Dim logRow As Long
' --- 設定エリア ---
' チェックしたいカスタムフィールドの型を指定(例: pjNumber, pjText, pjDate)
' ここではデバッグの汎用性を高めるため、主要なNumberフィールドを対象とする例を示します
Const CHECK_TYPE As Long = pjNumber
' ------------------
errorCount = 0
' ログ出力用のワークシートを準備(既存のログがあればクリア)
On Error Resume Next
Set logSheet = ThisWorkbook.Worksheets("ErrorLog")
If logSheet Is Nothing Then
Set logSheet = ThisWorkbook.Worksheets.Add
logSheet.Name = "ErrorLog"
End If
On Error GoTo 0
logSheet.Cells.Clear
logSheet.Range("A1:D1").Value = Array("検知時刻", "タスク名", "タスクID", "エラー詳細")
logSheet.Range("A1:D1").Font.Bold = True
logRow = 2
Debug.Print "--- 検知プロセス開始 ---"
' 全タスクをループ
For Each t In ActiveProject.Tasks
' 空白タスク(サマリータスク以外など)はスキップ
If Not t Is Nothing Then
' ここでは例として Number1 から Number5 までのカスタムフィールドをチェック
' プロジェクトの設計に合わせて拡張してください
Dim i As Integer
For i = 1 To 5
' --- ここがエンジニアの腕の見せ所:エラーハンドリング ---
' 計算エラーが発生すると、値を取得しようとした瞬間にランタイムエラーが発生するため
' On Error Resume Next で一時的にエラーをトラップします
On Error Resume Next
Dim val As Variant
' カスタムフィールドの値を取得(例: t.Number1)
' プロパティ名を動的に指定するために CallByName 等を使う手法もありますが、
' ここでは分かりやすさを優先し、直接的な評価を行います
Select Case i
Case 1: val = t.Number1
Case 2: val = t.Number2
Case 3: val = t.Number3
Case 4: val = t.Number4
Case 5: val = t.Number5
End Select
' エラーが発生したか判定
If Err.Number <> 0 Then
' エラーが発生した場合、ログに記録
logSheet.Cells(logRow, 1).Value = Now
logSheet.Cells(logRow, 2).Value = t.Name
logSheet.Cells(logRow, 3).Value = t.ID
logSheet.Cells(logRow, 4).Value = "Field Number" & i & ": " & Err.Description
logRow = logRow + 1
errorCount = errorCount + 1
' エラーをクリアして次のフィールドへ
Err.Clear
End If
On Error GoTo 0 ' エラーハンドリングを通常状態に戻す
Next i
End If
Next t
' --- 終了処理 ---
Debug.Print "--- 検知プロセス完了 ---"
Debug.Print "検出されたエラー数: " & errorCount
If errorCount > 0 Then
MsgBox errorCount & " 件の計算エラーを検知しました。" & vbCrLf & _
"「ErrorLog」シートを確認してください。", vbExclamation, "警告"
Else
MsgBox "エラーは検知されませんでした。計算式は健全です。", vbInformation, "完了"
End If
logSheet.Columns("A:D").AutoFit
End Sub
コードの解説:ここが「プロ」のポイント
1. `On Error Resume Next` の戦略的使用:
通常、エラーハンドリングは「エラーを防ぐ」ために使いますが、デバッグツールにおいては「エラーを捕まえる(Catch)」ために使います。エラーが起きた瞬間にプログラムを止めず、そのエラー情報を吸い上げるための「網」として機能させています。
2. 動的なログ出力:
`Debug.Print` だけでなく、Excelのワークシート(`ErrorLog`)に書き出すことで、非エンジニアのユーザーでも「どこを直すべきか」を一目で理解できるようにしています。これが「業務で使えるツール」と「ただのスクリプト」の差です。
3. 計算コストへの配慮:
`For Each t In ActiveProject.Tasks` で全タスクを回すのは、プロジェクト規模によっては重くなります。しかし、カスタムフィールドの整合性を保証するためには、この「全件走査」という重みを引き受ける覚悟が必要です。
4. さらなる高みへ:オブジェクトのライフサイクルを知る
このツールを使いこなしたあなたに、最後に「アーキテクトの視点」を授けましょう。
カスタムフィールドの計算式を設定する際、VBAで `t.Number1 = “…”` と数式を書き込むと、MS Projectは即座に再計算を開始しようとします。この「書き込みと計算の同期」が、予期せぬ動作を引き起こす原因になります。
もし、大量のカスタムフィールドを一括設定するツールを作るなら、以下の手順を検討してください。
1. 計算モードを「手動」にする: `ActiveProject.Calculation = pjManual`
2. 数式をすべて流し込む: ループ内で数式をセット
3. 最後に一括で「自動」に戻す: `ActiveProject.Calculation = pjAutomatic`
これにより、一回一回の書き込みごとに発生する「再計算のオーバーヘッド」と「中間的なエラー」を劇的に減らすことができます。
まとめ
循環参照は、複雑なプロジェクト管理における「バグの温床」です。しかし、それを恐れる必要はありません。
- エラーを恐れず、構造的に捉える。
- ログを出力し、可視化する。
- 計算エンジンの動きをコントロールする。
これらをマスターすれば、あなたの作る自動化ツールは、単なる「マクロ」から、プロジェクトの信頼性を支える「システム」へと進化します。
ここをクリアすれば、Project VBAの基本はバッチリですよ。さあ、次のコードを書きに行きましょう!
