【入門編】【中級者向け】カスタムフィールドの数式が循環参照を起こした際の自動検知と警告ログ出力 – Project VBA解析バイブル

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

【極限の知見】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の基本はバッチリですよ。さあ、次のコードを書きに行きましょう!

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