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)からルールを読み込む機能」を付けてみてください。そうすれば、コードを書き換えずにルールを変更できる、さらに強力なツールになります。
応援していますよ。さあ、次のコードを書きに行きましょう!
