単なる自動化を超えて:MS Project VBAにおける『自己修復型カスタムフィールド・エンジン』の設計思想
プロジェクト管理の現場において、Microsoft Projectのカスタムフィールド(数式)は、単なる「便利な計算列」ではない。それは、PMOが定義したビジネスロジック、リスク評価、コスト配分の根幹を成す「動的なデータ定義」そのものである。
しかし、現場のエンジニアが直面する現実は残酷だ。
「プロジェクトファイルをコピーした際に数式が壊れた」「リソース名を変更したせいで参照エラーになった」「誰かが手動で数式を書き換えてしまった」――。
これらに対し、「エラーが出たら手動で直す」あるいは「エラーを検知してメッセージを出すだけ」のコードを書いているとしたら、君の設計は未熟だと言わざるを得ない。我々が目指すべきは、「定義(Source of Truth)」と「実態(State)」を常時照合し、乖離を検知した瞬間に自律的に修復を行う、AIライクなルールベースエンジンである。
本稿では、堅牢なプロダクション環境に耐えうる、自己修復型カスタムフィールド管理エンジンの設計と実装について、その極限の知見を伝授する。
1. なぜ、君のVBAは「壊れやすい」のか
多くの開発者が陥る罠は、「数式(Formula)」を「データ(Data)」と同列に扱ってしまうことだ。
通常の自動化コードは、`Task.Text1 = “Value”` のように値を書き込む。しかし、カスタムフィールドの数式は、アプリケーション全体のメタデータとして存在する。数式は、プロジェクトの構造(タスク、リソース、カレンダー)に強く依存する「動的なロジック」であり、そのライフサイクルはプロジェクトの生存期間と密接に関わっている。
非効率な設計の典型例
- ハードコーディング: `FieldFormula = “ProjDateDiff([Start],[Finish])”` のように、ロジックを直接VBA内に散在させる。これでは、数式変更のたびに全コードを走査する必要がある。
- 場当たり的なエラーハンドリング: `On Error Resume Next` でエラーを握りつぶし、計算結果が「0」や「#ERROR!」になったことに後から気づく。これは「自動化」ではなく「放置」だ。
アーキテクトが採用すべき設計思想
我々が構築すべきは、「宣言的(Declarative)な設計」である。
「どう計算するか」をコードに書くのではない。「あるべき姿(Golden Schema)」を定義ファイルとして保持し、エンジンは常にその「あるべき姿」に向かって実態を強制的に同期させる。
2. 自己修復型エンジンのアーキテクチャ
設計の核となるのは、以下の3つのコンポーネントである。
1. The Registry (定義層): 正しい数式、データ型、適用対象(Task/Resource)を格納する「真実の源泉」。
2. The Inspector (検知層): 現在の `FieldDefinitions` をスキャンし、定義と実態の乖離(Drift)を検出する。
3. The Healer (修復層): 乖離を検知した際、定義に基づき `FieldDefinition.Formula` を再書き込みする。
3. プロダクションコード例:Self-Healing Formula Engine
以下に、実務でそのまま利用可能なレベルまで昇華させた、クラスモジュールベースの設計例を示す。ここでは、保守性を高めるために、数式定義を辞書形式(Dictionary)で管理する手法を採用する。
実装のポイント
- FieldDefinitionsへの直接アクセス: `Task` オブジェクトではなく、`Application.FieldDefinitions` を操作することで、プロジェクト全体の設定を制御する。
- 型安全な定義: どのフィールドが Task 用で、どれが Resource 用かを厳格に区別する。
'---------------------------------------------------------------------------------------
' Module: clsFormulaEngine
' Description: カスタムフィールドの整合性を監視・修復する自己修復エンジン
'---------------------------------------------------------------------------------------
Option Explicit
Public Enum FieldScope
ScopeTask ' Taskに関連するフィールド
ScopeResource ' Resourceに関連するフィールド
End Enum
Private Type FormulaDefinition
FieldID As Long
Formula As String
Scope As FieldScope
End Type
' 定義を格納するためのコレクション
Private m_Definitions As Collection
Private Sub Class_Initialize()
Set m_Definitions = New Collection
End Sub
''' <summary>
''' 修復すべき正しい数式の定義を登録する
''' </summary>
Public Sub RegisterDefinition(ByVal fieldID As Long, ByVal formula As String, ByVal scope As FieldScope)
Dim def As FormulaDefinition
def.FieldID = fieldID
def.Formula = formula
def.Scope = scope
' Collectionに格納(KeyとしてFieldIDを使用)
m_Definitions.Add def, CStr(fieldID)
End Sub
''' <summary>
''' 現在のフィールド状態を検査し、乖離があれば自動修復する
''' </summary>
Public Sub RunSelfHealing()
Dim app As MSProject.Application
Set app = MSProject.Application
Dim def As FormulaDefinition
Dim currentFormula As String
Dim driftDetected As Boolean
Dim repairCount As Integer
repairCount = 0
Debug.Print "--- Self-Healing Process Started ---"
' 登録されたすべての定義をループ
Dim key As Variant
For Each key In m_Definitions.Keys
' Collectionから定義を取得(内部的な構造上の制約を回避するため一度変数へ)
' ※VBAのCollectionは直接構造体を更新できないため、取得して比較
Dim idx As Long
idx = CLng(key)
' 現在のMS Project上の数式を取得
On Error Resume Next
currentFormula = app.FieldDefinitions(idx).Formula
If Err.Number <> 0 Then
Debug.Print "[Error] Field ID " & idx & " is not accessible."
Err.Clear
GoTo NextDefinition
End If
On Error GoTo 0
' 1. 乖離(Drift)の検知: 文字列比較によるパターンマッチング
' ※前後の空白や大文字小文字の揺らぎを考慮する場合は、TrimやUCaseを検討
If currentFormula <> m_Definitions(key).Formula Then
driftDetected = True
Debug.Print "[Drift Detected] ID: " & idx & " | Current: " & currentFormula & " | Target: " & m_Definitions(key).Formula
' 2. 修復(Healing)の実行
On Error Resume Next
app.FieldDefinitions(idx).Formula = m_Definitions(key).Formula
If Err.Number = 0 Then
Debug.Print "[Success] Field ID " & idx & " has been healed."
repairCount = repairCount + 1
Else
Debug.Print "[Critical] Failed to heal Field ID " & idx & ": " & Err.Description
End If
On Error GoTo 0
End If
NextDefinition:
Next key
Debug.Print "--- Process Completed. Repaired " & repairCount & " fields. ---"
If repairCount > 0 Then
MsgBox "数式の不整合を検知し、" & repairCount & "件のフィールドを自動修復しました。", vbInformation, "Self-Healing Engine"
End If
End Sub
実装・呼び出し側のコード(標準モジュール)
'---------------------------------------------------------------------------------------
' Module: MainModule
' Description: エンジンの初期化と実行
'---------------------------------------------------------------------------------------
Option Explicit
Sub ExecuteMaintenance()
Dim engine As New clsFormulaEngine
' --- Step 1: 正解(Golden Schema)の定義 ---
' 本来はここを外部ファイル(JSONやExcel)から読み込む設計にすべきである
' 例: Task.Text1 (ID: 20) に遅延日数を計算する数式を設定
engine.RegisterDefinition 20, "ProjDateDiff([Start],[Finish])", ScopeTask
' 例: Resource.Text1 (ID: 30) にコスト係数を設定
engine.RegisterDefinition 30, "[Cost]/[Work]", ScopeResource
' --- Step 2: 自己修復の実行 ---
engine.RunSelfHealing
End Sub
4. 伝説のアーキテクトからの警告:運用における注意点
このエンジンをプロダクション環境へ投入する際、君が絶対に忘れてはならない「重み」がある。
① 外部定義(Source of Truth)の分離
上記のコードでは、`RegisterDefinition` をVBA内に直接記述している。しかし、これはまだ「半自動」だ。真のプロフェッショナルは、数式定義を外部のマスターファイル(ExcelやJSON)に持たせる。
VBAはあくまで「実行エンジン」であり、ロジックの「定義」は、VBAコードをコンパイルし直すことなく変更可能な場所に配置せよ。これにより、数式変更が「デプロイ」ではなく「設定変更」へと昇華される。
② データベース連携時のトランザクション・リスク
もし、このエンジンを外部データベース(SQL Server等)と連携させ、プロジェクトのメタデータを一括管理する場合、「書き込みの原子性」に細心の注意を払え。
数式を書き換える際、MS Projectの再計算(Recalculation)が走る。大規模なプロジェクトでは、この再計算のコストは指数関数的に増大する。大量のフィールドを一度に修復するのではなく、変更があったフィールドのみを特定し、最小限の書き込みを行う「差分更新」を実装せよ。
③ オブジェクトのライフサイクルとメモリ管理
`FieldDefinitions` は、プロジェクトが開いている間、アプリケーションのメモリ上に常駐する。エンジンのインスタンス(`clsFormulaEngine`)は、処理が終わるたびに必ず `Set engine = Nothing` で破棄するか、スコープを限定させろ。メモリリークは、長時間稼働する自動化ツールの宿命的な死因である。
結論
優れたエンジニアは、バグが出ないようにコードを書く。
だが、偉大なアーキテクトは、バグが起きることを前提に、それを自律的に修復するシステムを設計する。
カスタムフィールドの数式を「単なる文字列」として扱うのを今日限りでやめよ。それは、プロジェクトの意志を決定する「プログラム」なのだ。
