【入門編】【上級者向け】カスタムフィールドの数式エラーを自動修復するAIライクなルールベースエンジン – Project VBA解析バイブル

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

Project VBAの深淵へようこそ:数式エラーを自動修復する「自己修復型エンジン」の設計思想

こんにちは。プロジェクトの自動化、その道のプロフェッショナルを目指す皆さん。

MS Projectを使っていて、「昨日まで動いていたカスタムフィールドの計算式が、なぜかエラーになって表示されない……」なんて経験はありませんか? あるいは、誰かが誤って数式を書き換えてしまい、プロジェクト全体の集計が狂ってしまう、といった恐怖。

マクロの記録から一歩踏み出したばかりの皆さんは、まず「動くコード」を書くことに必死になります。しかし、真のエンジニア、つまり「アーキテクト」を目指すなら、「壊れること」を前提とした設計を考える必要があります。

今日は、カスタムフィールドの数式エラーを検知し、あらかじめ定義した「正しい姿(ゴールデン・スタンダード)」へと自動的に引き戻す、AIライクなルールベース型自己修復エンジンの作り方を伝授します。

ここをクリアすれば、あなたの作るツールは「ただの便利ツール」から「プロが信頼する堅牢なシステム」へと進化しますよ。

1. なぜカスタムフィールドの数式は「壊れる」のか?

まず、敵を知ることから始めましょう。MS Projectのカスタムフィールド(TaskCustomFieldsやResourceCustomFields)の数式が壊れる主な原因は以下の3つです。

1. 手動による汚染: ユーザーがGUI上で誤って数式を書き換えてしまった。
2. 参照先の消失: 数式内で参照していた他のフィールド名が変更された、あるいは削除された。
3. 環境の不一致: プロジェクトのテンプレートが変わったり、言語設定が影響したりして、構文が認識されなくなった。

通常のVBAプログラムは、エラーが起きると「止まって」しまいます。しかし、私たちが作る自己修復エンジンは、「エラーに気づき、自ら治す」という振る舞いをします。

2. 自己修復エンジンの設計図(アーキテクチャ)

いきなり難しいコードを書くのではなく、まずは頭の中に「仕組み」を構築しましょう。今回のエンジンは、以下の3つのステップで動きます。

1. 定義フェーズ (Definition): 「正しい数式はこれである」というマスターデータを保持する。
2. 検知フェーズ (Detection): 現在のプロジェクトの数式をスキャンし、マスターデータと比較する。
3. 修復フェーズ (Repair): 差異(エラーや書き換え)を見つけたら、正しい数式を再注入する。

これを「ルールベース」と呼ぶのは、「もし数式がAでなければ、Aに書き換えろ」という明確なルールに従って動くからです。

3. 実装:自己修復型カスタムフィールド・マネージャー

それでは、実際に使えるコードを見ていきましょう。初心者の方でも理解しやすいよう、丁寧にコメントを添えています。

Option Explicit

''' <summary>
''' カスタムフィールドの整合性を保つための「自己修復エンジン」クラス的な実装
''' </summary>
Sub SelfHealingCustomFieldEngine()
    Dim targetProject As Project
    Set targetProject = ActiveProject
    
    Debug.Print "--- 自己修復プロセス開始 ---"
    
    ' 1. タスクカスタムフィールドの修復を実行
    RepairTaskFields targetProject
    
    ' 2. リソースカスタムフィールドの修復を実行
    RepairResourceFields targetProject
    
    Debug.Print "--- 自己修復プロセス完了 ---"
    MsgBox "カスタムフィールドの整合性チェックが完了しました。", vbInformation
End Sub

''' <summary>
''' タスクカスタムフィールドをスキャンし、不正があれば修復する
''' </summary>
Private Sub RepairTaskFields(proj As Project)
    Dim tf As TaskCustomField
    Dim expectedFormula As String
    Dim fieldID As Integer
    
    ' --- 【定義フェーズ】正しい数式をここで定義する ---
    ' 例: Text1 には [Duration] を文字に変換したものを入れる、といったルール
    ' ※実際には Dictionary オブジェクトなどを使うとよりスマートです
    
    ' ルール1: Text1 は必ずこの数式であるべき
    fieldID = 1 ' Text1 のインデックス(環境により調整が必要な場合があります)
    expectedFormula = "Format([Duration], ""#""")
    
    ' ルール2: Text2 は必ずこの数式であるべき
    ' fieldID = 2 ... など
    
    ' --- 【検知 & 修復フェーズ】 ---
    On Error Resume Next ' エラーが起きても止まらずに次のフィールドへ進むための「守り」
    
    For Each tf In proj.TaskCustomFields
        ' フィールドのインデックスが一致するか確認
        ' 注意: TaskCustomFieldsのコレクションの構造に注意
        If tf.FieldNumber = fieldID Then
            
            ' 現在の数式と、定義した「正解」を比較
            If tf.Formula <> expectedFormula Then
                Debug.Print "【検知】Task Text" & tf.FieldNumber & " に異常を検知。"
                Debug.Print "   現在の値: " & tf.Formula
                Debug.Print "   修復中..."
                
                ' 修復実行
                tf.Formula = expectedFormula
                
                If Err.Number <> 0 Then
                    Debug.Print "   【警告】修復に失敗しました。数式構文が不正な可能性があります。"
                    Err.Clear
                Else
                    Debug.Print "   【成功】正常に修復されました。"
                End If
            End If
        End If
    Next tf
    
    On Error GoTo 0 ' エラーハンドリングを通常に戻す
End Sub

''' <summary>
''' リソースカスタムフィールドをスキャンし、不正があれば修復する
''' </summary>
Private Sub RepairResourceFields(proj As Project)
    ' タスク側と同様のロジックを ResourceCustomFields に対して適用します
    ' (構造はほぼ同じですが、対象オブジェクトが異なる点に注意してください)
    Dim rf As ResourceCustomField
    Dim expectedFormula As String
    
    ' 例: Resource Text1 の定義
    expectedFormula = "[Cost] * 0.1"
    
    On Error Resume Next
    For Each rf In proj.ResourceCustomFields
        ' ここに判定ロジックを記述
        ' ... (Task側と同様のロジック)
    Next rf
    On Error GoTo 0
End Sub

4. コードの深淵:ここがプロの技術ポイント

このコードをただコピーするだけでは、あなたはまだ「マクロ利用者」です。ここからが「エンジニア」へのステップアップです。

① `On Error Resume Next` の「正しい」使い方

初心者の方は、エラーが出たらとりあえずこれを使いたくなります。しかし、これは「エラーを無視する」のではなく、「エラーが起きてもプロセスを継続し、後で適切に処理するための戦略」として使ってください。
今回のコードでは、数式が壊れていて `tf.Formula` にアクセスした瞬間にエラーが出る可能性があります。それを回避しつつ、`Err.Number` を見て「修復に失敗したこと」をログに残す。これがプロの作法です。

② オブジェクトのライフサイクルとインデックス

`TaskCustomFields` コレクションを回す際、`FieldNumber` を使って特定のフィールドを特定しています。MS Projectでは、ユーザーがフィールドを非表示にしたり、順番を入れ替えたりすることがありますが、`FieldNumber` はその「論理的な番号」を指し示します。これを利用することで、見た目の順番に左右されない堅牢なコードになります。

③ パフォーマンスの重み

もしプロジェクトが数万行のタスクを持つ巨大なものだった場合、全てのカスタムフィールドを毎回ループで回すのは重くなる可能性があります。実務では、「変更があった時だけ実行する」、あるいは「特定のフラグが立っている時だけ実行する」といった、実行タイミングの制御(トリガー設計)も重要になります。

5. まとめ:次に進むあなたへ

今回の「自己修復エンジン」は、非常にシンプルですが、ソフトウェア工学における「自己修復(Self-healing)」という極めて高度な概念の入り口です。

「コードは書いたら終わり」ではありません。
「コードが動いている環境を、いかに健全に保ち続けるか」。

この視点を持てたあなたは、もう単なるマクロ作成者ではありません。システムを設計するエンジニアの仲間入りを果たしています。

ここをクリアすれば、Project VBAの基本はバッチリですよ。次は、このエンジンに「外部設定ファイル(CSVやExcel)からルールを読み込む機能」を付けてみてください。そうすれば、コードを書き換えずにルールを変更できる、さらに強力なツールになります。

応援していますよ。さあ、次のコードを書きに行きましょう!

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