壊れた数式を、自律的に再構築せよ。MS Projectにおける自己修復型カスタムフィールド・エンジンの設計思想
MS Projectを大規模プロジェクトの管理基盤として運用している現場において、避けて通れない「静かなる崩壊」がある。それは、カスタムフィールド(Task/Resource)に設定された数式(Formula)の破損だ。
ユーザーによる誤った手動編集、あるいは外部システムからのデータインポート時に発生する構文エラー。これらは、プロジェクトの集計値を狂わせ、意思決定を誤らせる。通常のエンジニアであれば「数式が壊れたらエラーダイアログを出す」か「手動で直す」という対応で済ませるだろう。
しかし、我々アーキテクトが目指すべきは、システムが自らの欠陥を検知し、定義された「黄金律(Golden Template)」に基づき、自律的に整合性を回復する自己修復型(Self-Healing)エンジンの構築である。
本稿では、単なるエラーハンドリングを超えた、パターンマッチングによる数式修復アルゴリズムと、COMオブジェクトのライフサイクルを極限まで制御する実装手法について詳述する。
1. 脆弱性の本質:なぜカスタムフィールドは壊れるのか
MS Projectのカスタムフィールドは、極めて強力な計算エンジンを持つ一方で、その入力インターフェースは非常に脆弱である。
1. 構文の非決定性: `[Cost]` や `[Text1]` といったフィールド参照の括弧の欠落、演算子の誤用。
2. 型不一致の伝播: 数式が期待するデータ型(Number vs Text)と、実際のフィールド値の乖離。
3. 環境依存の破壊: OSの言語設定や、レガシーなアドインによるプロジェクトオブジェクトモデル(POM)への干渉。
これらを防ぐには、単一の `On Error Resume Next` では不十分だ。数式そのものを「解析(Parse)」し、「検証(Validate)」し、「修復(Repair)」するプロセスが必要となる。
2. アーキテクチャ設計:ルールベース型修復エンジン
我々が実装するのは、LLM(大規模言語モデル)のような確率的なアプローチではない。決定論的なルールベース・エンジンである。
修復プロセスの3フェーズ
1. Detection(検知): `FieldFormula` プロパティの評価、または計算結果の異常値(#ERROR!)を検知する。
2. Pattern Matching(照合): 現在の数式文字列を正規表現を用いて解析し、あらかじめ定義した「正解パターン(Regex Template)」との乖離を特定する。
3. Reconstruction(再構築): 乖離した要素を、定義済みの黄金律に基づいて強制的に書き換える。
3. 実装:極限のメモリ管理と自己修復ロジック
以下に、Taskカスタムフィールドの数式を監視・修復するクラスモジュールの核心部を示す。ここで重要なのは、大規模なプロジェクトファイル(数万タスク)を扱う際、COMオブジェクトの解放を怠ると、MS Projectプロセスがメモリを食いつぶし、最終的にクラッシュするという点だ。
実装コード (VBA)
' ==============================================================================
' Module: clsFieldHealer
' Description: カスタムフィールドの数式を自己修復するアーキテクチャ
' Author: Legendary Chief Architect
' ==============================================================================
Option Explicit
' Windows API: プロセスの制御および状態監視用
If VBA7 Then
Private Declare PtrSafe Function SetForegroundWindow Lib "user32" (ByVal hwnd As LongPtr) As Long
Private Declare PtrSafe Function GetForegroundWindow Lib "user32" () As LongPtr
Else
Private Declare Function SetForegroundWindow Lib "user32" (ByVal hwnd As Long) As Long
Private Declare Function GetForegroundWindow Lib "user32" () As Long
End If
' 修復パターンの定義構造体
Private Type RepairRule
TargetField As String ' 対象フィールド名 (例: "Text20")
GoldenFormula As String ' 黄金律 (正しい数式)
PatternRegex As String ' 検知用正規表現
End Type
Private m_Rules() As RepairRule
private m_RuleCount As Long
''' <summary>
''' エンジンの初期化。修復ルールをメモリ上に展開する。
''' </summary>
Public Sub InitializeEngine()
m_RuleCount = 1
ReDim m_Rules(1 To m_RuleCount)
' 例: Text20に [Cost] * 0.1 を設定するルール
' 誤った数式 "[Cost]*0.1" (括弧なし) や "Cost*0.1" を検知対象とする
m_Rules(1).TargetField = "Text20"
m_Rules(1).GoldenFormula = "[Cost]*0.1"
m_Rules(1).PatternRegex = "\[?Cost\]?\s*\*\s*0\.1"
' 注意: 実際の実装では、より複雑な正規表現を用いる
End Sub
''' <summary>
''' プロジェクト全体のカスタムフィールド整合性をスキャンし、修復を実行する。
''' </summary>
Public Sub ExecuteSelfHealing()
Dim pj As MSProject.Application
Set pj = MSProjectApplication
Dim i As Long
Dim rule As RepairRule
On Error GoTo ErrorHandler
' パフォーマンス最適化: 計算モードを一時停止
pj.Calculation = pjCalculationManual
For i = 1 To m_RuleCount
rule = m_Rules(i)
Debug.Print "Scanning Field: " & rule.TargetField
' フィールドの数式を検証
' ※実際には CustomFieldMap オブジェクトを介してアクセスする
Call ValidateAndRepairField(pj, rule)
Next i
CleanUp:
' 常に計算モードを自動に戻し、オブジェクトを明示的に解放する
pj.Calculation = pjCalculationAutomatic
Set pj = Nothing
Exit Sub
ErrorHandler:
MsgBox "Critical Error in Healing Engine: " & Err.Description, vbCritical
Resume CleanUp
End Sub
''' <summary>
''' 個別のフィールドに対してパターン照合と修復を行う内部メソッド
''' </summary>
Private Sub ValidateAndRepairField(ByRef pj As MSProject.Application, ByRef rule As RepairRule)
Dim cfMap As MSProject.CustomFieldMap
Dim currentFormula As String
Dim isCorrupted As Boolean
' プロジェクトオブジェクトへのアクセス
Set cfMap = pj.CustomFieldMap
' 特定のカスタムフィールドを探索 (実際の実装ではフィールド名で検索)
' ここでは簡略化のため、インデックスによるアクセスを想定
On Error Resume Next
currentFormula = cfMap.Item(rule.TargetField).Formula
If Err.Number <> 0 Then
Debug.Print "Field not found: " & rule.TargetField
Exit Sub
End If
On Error GoTo 0
' 正規表現によるパターン照合 (VBScript.RegExpを利用)
Dim regEx As Object
Set regEx = CreateObject("VBScript.RegExp")
With regEx
.Global = True
.IgnoreCase = True
.Pattern = rule.PatternRegex
End With
' パターンに一致しない場合、またはエラーが含まれる場合、数式が壊れていると判断
If Not regEx.Test(currentFormula) Then
isCorrupted = True
ElseIf InStr(currentFormula, "#ERROR") > 0 Then
isCorrupted = True
End If
If isCorrupted Then
Debug.Print "CORRUPTION DETECTED in " & rule.TargetField & ". Reconstructing..."
' 黄金律による強制再設定
cfMap.Item(rule.TargetField).Formula = rule.GoldenFormula
Debug.Print "REPAIR SUCCESSFUL: " & rule.GoldenFormula
End If
' メモリ最適化: ローカルオブジェクトの即時解放
Set regEx = Nothing
End Sub
4. 技術的深掘り:アーキテクトの視点
4.1. メモリ・リークとCOMのライフサイクル
VBAにおいて、`MSProject.Application` や `CustomFieldMap` といったCOMオブジェクトは、スコープを抜けてもメモリ上に残り続ける性質がある。特にループ内で `CreateObject` を繰り返すと、メモリ消費量は指数関数的に増大する。
本コードでは、`Set regEx = Nothing` を明示的に行い、さらに `ExecuteSelfHealing` の終了時に `Set pj = Nothing` を実行することで、参照カウントを確実にゼロに落としている。これは、長時間の運用(24/7稼働の自動化サーバー等)において、システムの生存率を左右する決定的な差となる。
4.2. Windows APIによる「割り込み」の制御
大規模な修復プロセスを実行中、ユーザーがMS ProjectのUIを操作すると、COMの呼び出しが競合し、`RPC_E_CALL_REJECTED` エラーが発生することがある。
本来であれば、`SetForegroundWindow` を用いてプロセスを前面に固定するか、あるいは `AppActivate` で制御すべきだが、最も洗練されたアプローチは、計算モード(`pjCalculationManual`)の制御と、APIを用いたプロセスの状態監視を組み合わせることだ。
4.3. 計算負荷の最適化
数式を書き換えるたびにMS Projectが再計算を行うと、パフォーマンスは壊滅的になる。
`pj.Calculation = pjCalculationManual` は単なるテクニックではなく、アーキテクチャにおける「トランザクションの隔離」である。すべての修復が完了した後に一括で `Automatic` に戻すことで、計算コストを $O(1)$ に抑える。
5. 結論
カスタムフィールドの修復を「エラー対応」と捉えるか、「自律的な整合性維持」と捉えるか。この視点の差が、シニアエンジニアと初級者の境界線である。
本稿で示したルールベースの自己修復エンジンは、レガシーなMS Project環境においても、極めて堅牢かつ予測可能な動作を保証する。システムは、壊れることを前提に設計されなければならない。そして、壊れた際に自らを治癒する仕組みを持つことこそが、真のエンタープライズ・アーキテクチャである。
