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

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

「数式の迷宮」を解き明かす:MS Projectカスタムフィールドの依存関係を可視化する静的解析術

こんにちは。プロジェクトの自動化という広大な海を渡る冒険者のみなさん。
マクロの記録機能を使って「あ、これ自動化できるかも!」と気づけたあなたは、すでにエンジニアとしての第一歩を力強く踏み出しています。

しかし、プロジェクトの規模が大きくなり、業務が複雑になってくると、ある「壁」にぶつかるはずです。それは、「カスタムフィールドの数式(Formula)がスパゲッティ状態になる」という問題です。

「Text1に数式を入れた。そのText1を、Text2が参照している。さらにText2は、Number1を計算に使っている……」

こうなると、どこか一つの数式を修正したとき、「どこまで影響が出るのか?」が誰にも分からなくなります。これを私たちは「依存関係のブラックボックス化」と呼びます。

今日は、そんな迷宮を攻略するための武器、「カスタムフィールドの数式を解析し、依存関係をツリー構造で書き出す静的解析ツール」の作り方を伝授しましょう。

「マクロの記録」の先にある、真のエンジニアリングの世界へようこそ。

1. なぜ「数式を解析する」必要があるのか?

多くのユーザーは、カスタムフィールドに直接数式を書き込みます。しかし、プロフェッショナルな現場では、以下のリスクを管理しなければなりません。

1. 連鎖的な計算エラー: 元となるフィールドの型を変えただけで、末端のフィールドがすべてエラー(#ERROR!)になる。
2. 計算コストの増大: 複雑な数式が何重にも重なると、プロジェクトを開くたびに計算が走り、動作が重くなる。
3. 保守性の欠如: 「このフィールド、何のために計算してるんだっけ?」という問いに誰も答えられなくなる。

これらを防ぐには、数式を「単なる文字列」として扱うのではなく、「どのフィールドが、どのフィールドを必要としているか」という構造(グラフ構造)として捉え直す必要があるのです。

2. 解析のアルゴリズム:どうやって「依存」を見つけるか

数式は、例えば `[Text1] * [Number1]` のような文字列です。
ここから `Text1` と `Number1` を抜き出すには、「正規表現(Regular Expression)」という技術を使うのが最もスマートで確実です。

解析のステップ

1. フィールド情報の取得: Projectのオブジェクトモデルから、各カスタムフィールドの `Formula` プロパティを取得する。
2. パターンマッチング: 正規表現を用いて、`[…]` で囲まれた文字列を抽出する。
3. 依存関係の構築: 抽出したフィールド名をキーにして、親子関係を整理する。

3. 実装:依存関係解析ツール(VBA)

それでは、実際に動くコードを見ていきましょう。このコードは、タスクのカスタムフィールドをスキャンし、どのフィールドが何に依存しているかをイミディエイトウィンドウにツリー形式で出力します。

【準備】
VBAエディタのメニューから `ツール` -> `参照設定` を開き、「Microsoft VBScript Regular Expressions 5.5」にチェックを入れてください。これがないと、高度な文字列解析ができません。

Option Explicit

' ==============================================================================
' Project Custom Field Dependency Analyzer
' ------------------------------------------------------------------------------
' 目的: カスタムフィールドの数式を解析し、依存関係をツリー構造で出力する
' 使い方: 標準モジュールに貼り付け、Run(F5)
' 注意: 「Microsoft VBScript Regular Expressions 5.5」への参照設定が必要
' ==============================================================================

Sub AnalyzeCustomFieldDependencies()
    Dim regEx As New RegExp
    Dim matches As MatchCollection
    Dim match As match
    Dim tf As TaskCustomField
    Dim dict As Object
    Dim fieldName As String
    Dim formula As String
    
    ' 依存関係を格納する連想配列(Dictionary)の初期化
    ' ※参照設定で "Microsoft Scripting Runtime" を追加するとより高速ですが、
    '   今回は汎用性を考え Late Binding で実装します。
    Set dict = CreateObject("Scripting.Dictionary")
    
    ' 正規表現の設定: [フィールド名] の形式を抽出するパターン
    ' \[ : 開始ブラケット
    ' ([^\]]+) : ] 以外の文字をキャプチャ
    ' \] : 終了ブラケット
    With regEx
        .Pattern = "\[([^\]]+)\]"
        .Global = True
        .IgnoreCase = True
    End With
    
    Debug.Print "--- Custom Field Dependency Analysis Start ---"
    Debug.Print "Time: " & Now
    Debug.Print "----------------------------------------------"

    ' 1. 全てのタスクカスタムフィールドを走査
    For Each tf In ActiveProject.TaskCustomFields
        formula = tf.Formula
        
        ' 数式が空でない場合のみ解析
        If Len(Trim(formula)) > 0 Then
            ' 依存しているフィールドを格納するリストを作成
            Dim dependencies As Collection
            Set dependencies = New Collection
            
            ' 正規表現で数式内の [Field] を抽出
            Set matches = regEx.Execute(formula)
            
            For Each match In matches
                ' match.SubMatches(0) は括弧内のテキスト(フィールド名)を取得
                fieldName = match.SubMatches(0)
                dependencies.Add fieldName
            Next match
            
            ' Dictionaryに「自身のフィールド名」と「依存先リスト」を保存
            ' キー: フィールドの表示名(または内部名), 値: 依存先コレクション
            dict.Add tf.FieldName, dependencies
        End If
    Next tf

    ' 2. ツリー構造の出力(再帰的な表示は複雑なため、ここでは階層的なリスト形式で出力)
    Dim key As Variant
    For Each key In dict.Keys
        PrintDependencyLine CStr(key), dict, 0
    Next key
    
    Debug.Print "----------------------------------------------"
    Debug.Print "--- Analysis Complete ---"
End Sub

' ------------------------------------------------------------------------------
' 関数: PrintDependencyLine
' 目的: 再帰的に依存関係をツリー形式でデバッグ出力する
' ------------------------------------------------------------------------------
Sub PrintDependencyLine(currentField As String, ByRef dict As Object, ByVal level As Integer)
    Dim indent As String
    Dim i As Integer
    
    ' インデントを作成して階層を可視化
    indent = String(level * 4, " ")
    
    ' 現在のフィールドを出力
    Debug.Print indent & "┗ " & currentField
    
    ' そのフィールドが他のフィールドに依存しているか確認
    If dict.Exists(currentField) Then
        Dim deps As Collection
        Set deps = dict(currentField)
        
        ' 依存先を一つずつ辿る(再帰呼び出し)
        For i = 1 To deps.Count
            ' 無限ループ(循環参照)を防ぐための簡易チェックが必要な場合はここに実装
            ' 今回は基本ロジックに集中するため省略
            PrintDependencyLine CStr(deps(i)), dict, level + 1
        Next i
    End If
End Sub

コードの解説:ここがプロの設計です

1. 正規表現の活用 (`RegExp`):
単に `InStr` 関数で検索するのではなく、`\[([^\]]+)\]` というパターンを使うことで、「ブラケットに囲まれた中身」を正確に、かつ一括で抽出しています。これが「解析ツール」としての心臓部です。
2. 再帰呼び出し (`Recursion`):
`PrintDependencyLine` 関数の中で自分自身を呼び出しています。これにより、`A -> B -> C` という深い階層があっても、自動的にインデントを深くしてツリー状に表示できます。
3. 遅延バインディング (`Late Binding`):
`CreateObject(“Scripting.Dictionary”)` を使うことで、配布先のPCで参照設定が漏れていてもエラーになりにくい、堅牢な設計にしています。

4. 実行結果のイメージ

もし、あなたのプロジェクトに以下のような設定があった場合:

  • `Text1` = “基本データ”
  • `Text2` = `[Text1] & ” – 拡張”`
  • `Text3` = `[Text2] & ” (確定)”`

イミディエイトウィンドウには次のように表示されます。

--- Custom Field Dependency Analysis Start ---
----------------------------------------------
┗ Text1
┗ Text2
    ┗ Text1
┗ Text3
    ┗ Text2
        ┗ Text1
----------------------------------------------
--- Analysis Complete ---

これを見れば、「Text1を直すと、Text2とText3の両方に影響が出るな」ということが一目で分かります。

5. 陥りやすいエラーと回避策

このツールを運用する上で、初心者が躓きやすいポイントを挙げておきます。

  • 「参照設定が足りない!」エラー:

`User-defined type not defined` というエラーが出たら、迷わず `Tools -> References` を確認してください。`Microsoft VBScript Regular Expressions 5.5` が必須です。

  • 循環参照の罠:

もし `Text1` が `Text2` を参照し、`Text2` が `Text1` を参照している場合、再帰呼び出しが止まらなくなり、`Stack Overflow`(スタックオーバーフロー)で強制終了します。
*(プロの対策:一度通ったフィールドを記録しておく「履歴リスト」を引数に渡すことで回避できます)*

  • フィールド名の不一致:

Project内部での「フィールド名」と、ユーザーが見ている「表示名」が異なる場合があります。解析の際は、どちらのプロパティを参照しているかを意識しましょう。

最後に:一歩先のエンジニアへ

「動けばいいマクロ」を作る段階から、「構造を理解し、管理できるツール」を作る段階へ。
今回紹介した静的解析という考え方は、VBAに限らず、大規模なシステム開発において極めて重要な概念です。

コードの裏側にある「依存関係」を見抜く目を持つことができれば、あなたはもう、単なるマクロ使いではありません。プロジェクトの設計図を描ける、真のエンジニアです。

ここをクリアすれば、Project VBAの基本はバッチリですよ。
さあ、次はもっと複雑な、大規模プロジェクトの自動化に挑戦してみましょう!

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