【極限の知見】MS Projectカスタムフィールドの「依存関係」を解剖せよ:数式解析による静的解析ツールの設計論
MS Projectを用いた大規模プロジェクト管理において、カスタムフィールド(Task/Resource)は、プロジェクトの「脳」となる。計算式によって自動化されたKPI、進捗率、コスト予測……。これらが複雑に絡み合ったとき、現場には「ブラックボックス化した数式」という名の負債が蓄積される。
「Text1の数式を変えたら、なぜか全く関係ないはずのCost指標が壊れた」
このような事態に直面したとき、あなたは「数式を一つずつ目視で確認する」という、エンジニアとして最も忌むべき、非効率極まりない作業を選択するのか?
本記事では、カスタムフィールドの数式構文を解析し、どのフィールドがどのフィールドに依存しているかを「ツリー構造」として可視化する、静的解析ツールの設計と実装について解説する。これは単なるスクリプト作成ではない。システムの複雑性を制御するための「アーキテクチャ」の話だ。
1. なぜ「単純な文字列置換」では失敗するのか
多くの初級者は、数式に含まれるフィールド名を抽出するために、単純な `Replace` 関数や、場当たり的な正規表現(RegExp)を使い、特定の文字列を探そうとする。
これは設計思想として致命的な誤りだ。
MS Projectの数式は、単なる文字列の羅列ではない。
- `IIf([Text1]=”OK”, [Number1], 0)` のような条件分岐
- `DateDiff` などの関数
- 括弧 `()` による演算の優先順位
- フィールド名に似た定数や、サブストリングの混入
これらを考慮せずに「特定のパターンを探す」だけのロジックを組むと、誤検知(False Positive)と検知漏れ(False Negative)が必ず発生する。実務で使えるツールに求められるのは、「数式をトークン(最小単位)として解釈し、意味のある識別子(Identifier)のみを抽出する」 という、コンパイラに近いアプローチである。
2. 解析エンジンのアーキテクチャ:依存関係のグラフ化
依存関係を可視化するためには、データを有向非巡回グラフ(DAG: Directed Acyclic Graph)として捉える必要がある。
設計の3ステップ
1. Lexical Analysis(字句解析):
数式文字列を走査し、`[Field Name]` の形式を持つトークンを正確に抽出する。ここでは、正規表現を使用するが、単なる検索ではなく「フィールド識別子」というコンテキストを持たせる。
2. Dependency Mapping(依存関係の構築):
抽出した識別子を基に、`Map
3. Tree Traversal(木構造の走査):
構築したマップを再帰的に走査し、階層構造(インデント表示やツリー形式)で出力する。
3. プロダクション・クオリティのコード実装
以下に、VBAを用いてカスタムフィールドの依存関係を解析し、イミディエイトウィンドウにツリー構造で出力する、堅牢な実装例を示す。
このコードは、単なるコピペ用ではない。エラーハンドリング、オブジェクトのライフサイクル、そして拡張性を考慮した設計にしている。
Option Explicit
' ==============================================================================
' Module: DependencyAnalyzer
' Description: MS Project Custom Field Dependency Analyzer
' Author: Legendary Chief Architect
' ==============================================================================
' 依存関係を保持するための辞書型オブジェクト
Private dictDependencyMap As Object
' すでに走査したフィールドを記録(無限ループ防止)
Private dictVisited As Object
''' <summary>
''' 解析のメインエントリポイント
''' </summary>
Public Sub AnalyzeCustomFieldDependencies()
Dim t As Task
Dim r As Resource
Dim f As CustomField
Dim formula As String
Dim fieldName As String
' オブジェクトの初期化
Set dictDependencyMap = CreateObject("Scripting.Dictionary")
Set dictVisited = CreateObject("Scripting.Dictionary")
On Error GoTo ErrorHandler
Debug.Print "--- Dependency Analysis Start ---"
Debug.Print "Timestamp: " & Now
Debug.Print "---------------------------------"
' 1. Task Custom Fields の解析
' MS ProjectのCustomFieldsコレクションから、数式を持つものを抽出
For Each f In ActiveProject.CustomFields
' 数式が空でないかチェック(Text1, Number1等、すべてのカスタムフィールドを対象)
' ここではTaskフィールドを想定。Resourceも同様にループ可能。
formula = f.Formula
If Len(Trim(formula)) > 0 Then
fieldName = f.Name
' 依存するフィールドを抽出してマップに登録
Dim deps As Collection
Set deps = ExtractDependencies(formula)
If deps.Count > 0 Then
dictDependencyMap.Add fieldName, deps
Else
' 依存先がない場合も、ノードとして登録しておく
dictDependencyMap.Add fieldName, New Collection
End If
End If
Next f
' 2. ツリー構造の出力(再帰的走査)
' 依存の起点となるフィールド(他のフィールドから参照されていないもの)を探す
Dim rootFields As Collection
Set rootFields = GetRootFields()
Dim rootField As Variant
For Each rootField In rootFields
PrintTree rootField, 0
Next rootField
Debug.Print "---------------------------------"
Debug.Print "--- Analysis Completed ---"
Exit Sub
ErrorHandler:
Debug.Print "CRITICAL ERROR: " & Err.Description
MsgBox "解析中に致命的なエラーが発生しました: " & Err.Description, vbCritical
End Sub
''' <summary>
''' 数式文字列から [Field] 形式の識別子を抽出する(字句解析フェーズ)
''' </summary>
Private Function ExtractDependencies(ByVal formula As String) As Collection
Dim deps As New Collection
Dim regEx As Object
Dim matches As Object
Dim m As Object
Dim fieldName As String
Set regEx = CreateObject("VBScript.RegExp")
With regEx
.Global = True
.IgnoreCase = True
' MS Projectのフィールド参照形式 [FieldName] にマッチするパターン
.Pattern = "\[([A-Za-z0-9\s]+)\]"
End With
Set matches = regEx.Execute(formula)
For Each m In matches
' マッチしたグループ1(括弧の中身)を取得
fieldName = m.SubMatches(0)
' 重複排除してコレクションに追加
If Not IsInCollection(deps, fieldName) Then
deps.Add fieldName
End If
Next m
Set ExtractDependencies = deps
End Function
''' <summary>
''' 再帰的に依存ツリーをインデント付きで出力する
''' </summary>
Private Sub PrintTree(ByVal currentField As Variant, ByVal level As Integer)
Dim indent As String
Dim i As Integer
Dim childField As Variant
indent = String(level * 4, " ") ' 4スペースによるインデント
' 現在のノードを表示
Debug.Print indent & "└── " & currentField
' 循環参照防止
If dictVisited.Exists(currentField) Then Exit Sub
dictVisited.Add currentField, True
' 子ノード(依存先)の走査
If dictDependencyMap.Exists(currentField) Then
Dim deps As Collection
Set deps = dictDependencyMap(currentField)
For Each childField In deps
PrintTree childField, level + 1
Next childField
End If
' 訪問済みリストから削除(同じ枝の別のパスからの探索を許可するため)
dictVisited.Remove currentField
End Sub
''' <summary>
''' 依存の起点(ルート)となるフィールドを特定する
''' </summary>
Private Function GetRootFields() As Collection
Dim roots As New Collection
Dim allFields As Variant
Dim i As Long, j As Long
Dim isChild As Boolean
allFields = dictDependencyMap.Keys
For i = LBound(allFields) To UBound(allFields)
isChild = False
' 全ての依存関係をチェックし、他のフィールドの「子」になっていないか確認
For j = LBound(allFields) To UBound(allFields)
If i <> j Then
If IsInCollection(dictDependencyMap(allFields(j)), allFields(i)) Then
isChild = True
Exit For
End If
End If
Next j
If Not isChild Then
roots.Add allFields(i)
End If
Next i
Set GetRootFields = roots
End Function
''' <summary>
''' コレクション内に特定の値が存在するか判定するヘルパー
''' </summary>
Private Function IsInCollection(col As Collection, val As Variant) As Boolean
Dim item As Variant
For Each item In col
If item = val Then
IsInCollection = True
Exit Function
End If
Next item
IsInCollection = False
End Function
4. プロフェッショナルが意識すべき「堅牢性」の要諦
このコードを実務に投入する際、単なる「動くコード」以上の価値を生むための注意点を伝授する。
① 循環参照(Circular Dependency)への耐性
カスタムフィールドの数式で `[Text1]` が `[Text2]` を参照し、`[Text2]` が `[Text1]` を参照するような設定は、MS Project側でエラーになるが、解析ツール側では無限ループを引き起こす。上記のコードでは `dictVisited`(訪問済みリスト)を用いることで、再帰処理がスタックオーバーフローを起こさないよう設計している。
② データの整合性と外部連携
解析結果を `Debug.Print` だけで終わらせては、プロの仕事ではない。
実務では、この解析結果を Excel や JSON 形式で出力し、BIツールや構成管理ドキュメントとして保存すべきだ。
- Excel連携の場合: `Worksheets.Add` を行い、`Level`(階層)、`Parent`(親)、`Child`(子)の3カラムを持つテーブル形式で書き出す設計にせよ。
③ パフォーマンスの重み
大規模プロジェクト(タスク数万件、カスタムフィールド数十個)では、`GetRootFields` のような $O(N^2)$ のアルゴリズムは無視できないコストになる。フィールド数が増大する場合は、ハッシュマップ(Dictionary)を活用し、あらかじめ「すべての依存されているフィールド」を集合(Set)として保持しておくことで、計算量を $O(N)$ に落とす工夫が必要だ。
結論
カスタムフィールドの数式解析は、プロジェクト管理の「可視化」における最重要課題の一つだ。
「なんとなく動く」コードを書くのではなく、「データの構造をどう定義し、どう走査するか」 という計算機科学の原則に基づいた設計を行うこと。それこそが、現場の混乱を鎮め、信頼されるエンジニアへと昇華するための唯一の道である。
