【実務・中級編】【上級者向け】カスタムフィールドの数式構文を解析し、依存関係をツリー構造で出力する静的解析ツール – Project VBA解析バイブル

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

【極限の知見】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)$ に落とす工夫が必要だ。

結論

カスタムフィールドの数式解析は、プロジェクト管理の「可視化」における最重要課題の一つだ。
「なんとなく動く」コードを書くのではなく、「データの構造をどう定義し、どう走査するか」 という計算機科学の原則に基づいた設計を行うこと。それこそが、現場の混乱を鎮め、信頼されるエンジニアへと昇華するための唯一の道である。

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