【テクニカル・上級編】【上級者向け】大規模組織におけるカスタムフィールドの命名規則と定義を強制するガバナンスツール – Project VBA解析バイブル

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

【極限の知見】MS Projectにおけるカスタムフィールドの整合性維持:大規模組織を崩壊から救うガバナンス・アーキテクチャ

大規模な組織において、Microsoft Projectは単なるスケジュール管理ツールではない。それは、数千のタスクとリソースが交錯する、実質的な「構造化データベース」である。

しかし、多くのエンジニアが見落としている致命的な脆弱性がある。それは「カスタムフィールドの定義の脆弱性」だ。

あるプロジェクトマネージャーが、集計用の`Text1`フィールドの計算式を、自身の使い勝手の良さのために書き換えたとする。その瞬間、そのプロジェクトから抽出されるBIダッシュボード、コスト管理システム、そして全社的なリソース最適化アルゴリズムは、音を立てて崩壊する。メタデータの変更は、データの破壊と同義である。

本稿では、この「メタデータの熵(エントロピー)」を制御し、カスタムフィールドの定義を強制・監視するための、極限のガバナンス・エンジニアリングについて解説する。

1. アーキテクチャの設計思想:Golden Master Pattern

単なる「チェック機能」を作るのではない。我々が構築すべきは、「Golden Master(正解となる定義書)」と、現在のプロジェクト状態を比較・強制同期する「Governance Engine」である。

設計の要諦は以下の3点に集約される。

1. Declarative Definition(宣言的定義): フィールド名、データ型、計算式をコード内にハードコードせず、外部のJSONやXML、あるいは暗号化された設定ファイルから読み込む。
2. Idempotent Enforcement(冪等な強制力): 何度実行しても、定義が正しければ何もしない。定義が違えば、即座に正しい状態へロールバックする。
3. Zero-Trace Logging: 不正な変更を検知した際、誰が、いつ、どの定義を書き換えたかを(可能であれば)特定し、監査ログとして外部へ送出する。

2. 実装:Governance Engine の核心

以下に、大規模環境での動作を想定した、高パフォーマンスかつ堅牢なガバナンス・エンジンのプロトタイプを示す。ここでは、参照設定の依存を最小限に抑え、レガシー環境での互換性を維持するためにLate Binding(遅延結合)を多用し、メモリリークを防ぐためのオブジェクト管理を徹底している。

Core Module: `modGovernanceEngine`

Option Explicit

' Windows API: 実行時間の計測およびシステム状態の監視用
Private Declare PtrSafe Function GetTickCount Lib "kernel32" () As Long

' 定義の不整合を検知した際のログ出力用定数
Private Const LOG_LEVEL_CRITICAL As Integer = 1

' -----------------------------------------------------------------------------
' 構造体: フィールドの正解定義
' -----------------------------------------------------------------------------
Private Type FieldDefinition
    FieldNumber As Integer      ' Text1, Number1 等のインデックス
    ExpectedFormula As String   ' 期待される計算式
    FieldName As String         ' 表示名
End Type

' -----------------------------------------------------------------------------
' メインプロセス: プロジェクト起動時に呼び出される
' -----------------------------------------------------------------------------
Public Sub EnforceFieldGovernance()
    Dim startTime As Long
    startTime = GetTickCount()
    
    Dim app As Object ' MS Project.Application
    Set app = Application
    
    Dim proj As Object
    Set proj = app.ActiveProject
    
    ' 1. Golden Master のロード (本来は外部ファイルから読み込む)
    Dim masterList As Collection
    Set masterList = LoadGoldenMaster()
    
    ' 2. Task Custom Fields の検証
    Debug.Print "--- Starting Task Field Validation ---"
    ValidateCustomFields proj, masterList, "Task"
    
    ' 3. Resource Custom Fields の検証
    Debug.Print "--- Starting Resource Field Validation ---"
    ValidateCustomFields proj, masterList, "Resource"
    
    ' メモリの明示的解放
    Set masterList = Nothing
    Set proj = Nothing
    Set app = Nothing
    
    Debug.Print "Governance Check Completed in " & (GetTickCount() - startTime) & " ms"
End Sub

' -----------------------------------------------------------------------------
' 検証ロジック: 冪等性を担保するコア
' -----------------------------------------------------------------------------
Private Sub ValidateCustomFields(ByRef proj As Object, ByRef masterList As Collection, ByVal targetType As String)
    Dim item As Object
    Dim def As FieldDefinition
    Dim currentFormula As String
    Dim i As Integer
    
    ' targetType に応じて検証対象を切り替える
    ' TaskCustomFields または ResourceCustomFields をループ
    For Each item In masterList
        def = item ' Collectionから構造体を取得
        
        On Error Resume Next
        If targetType = "Task" Then
            ' Taskの計算式を取得
            currentFormula = proj.TaskCalculations.Item(def.FieldNumber).Formula
        Else
            currentFormula = proj.ResourceCalculations.Item(def.FieldNumber).Formula
        End If
        
        ' 比較ロジック: 余計な空白を除去して厳密に比較
        If Trim(currentFormula) <> Trim(def.ExpectedFormula) Then
            ' 不正検知:即座に修正(ロールバック)
            Debug.Print "[CRITICAL] Misconfiguration detected in " & targetType & " Field " & def.FieldNumber
            
            If targetType = "Task" Then
                proj.TaskCalculations.Item(def.FieldNumber).Formula = def.ExpectedFormula
            Else
                proj.ResourceCalculations.Item(def.FieldNumber).Formula = def.ExpectedFormula
            End If
            
            ' 監査ログの送出 (ここではデバッグ出力だが、実運用ではAPI経由でサーバーへ送信)
            LogViolation targetType, def.FieldNumber, currentFormula, def.ExpectedFormula
        End If
        On Error GoTo 0
    Next item
End Sub

' -----------------------------------------------------------------------------
' Golden Master ロード (モック実装)
' -----------------------------------------------------------------------------
Private Function LoadGoldenMaster() As Collection
    Dim col As New Collection
    Dim d1 As FieldDefinition, d2 As FieldDefinition
    
    ' Text1: プロジェクトコード (例: "P-" & [Project Name])
    d1.FieldNumber = 1
    d1.ExpectedFormula = """P-"" & [Project Name]"
    d1.FieldName = "Project Code"
    col.Add d1
    
    ' Number1: リスクスコア (例: [Cost] * 0.1)
    d2.FieldNumber = 1
    d2.ExpectedFormula = "[Cost] * 0.1"
    d2.FieldName = "Risk Score"
    col.Add d2
    
    Set LoadGoldenMaster = col
End Function

' -----------------------------------------------------------------------------
' 監査ログ送出
' -----------------------------------------------------------------------------
Private Sub LogViolation(target As String, fieldIdx As Integer, oldVal As String, newVal As String)
    ' ここで Windows API (WinHTTP等) を使用して、
    ' 社内のログ管理サーバーへ JSON 形式で POST 送信するのがプロフェッショナルな設計である。
    Dim logMsg As String
    logMsg = String(50, "=") & vbCrLf & _
             "TIMESTAMP: " & Now & vbCrLf & _
             "TARGET: " & target & " | FIELD_IDX: " & fieldIdx & vbCrLf & _
             "OLD_FORMULA: " & oldVal & vbCrLf & _
             "NEW_FORMULA: " & newVal & vbCrLf & _
             String(50, "=")
    
    ' 実際にはファイル出力、あるいはAPIコールを行う
    Debug.Print logMsg
End Sub

3. エンジニアが注視すべき「極限の知見」

このコードを実運用環境にデプロイする際、シニアエンジニアは以下の3点について、単なる実装以上の深い洞察を持たなければならない。

A. メモリ・ライフサイクルとオブジェクトの破棄

VBAにおいて、`Project.Application` や `Project.ActiveProject` といった重いオブジェクトをグローバル変数として保持し続けることは、メモリリークと、予期せぬタイミングでの `Object Required` エラーを招く。
本コードでは、`EnforceFieldGovernance` 内でプロシージャのスコープを限定し、終了時に明示的に `Set obj = Nothing` を実行している。これは、大規模プロジェクト(数万行のタスクを持つファイル)を扱う際の、スタックオーバーフローを防ぐための鉄則である。

B. パフォーマンスの重み:計算式の比較コスト

カスタムフィールドの数が増え、プロジェクトの規模が大きくなると、`ValidateCustomFields` のループは無視できないオーバーヘッドを生む。
計算式の比較において、`Trim` や `Replace` を過度に行うことは CPU サイクルを浪費する。大規模環境では、あらかじめ「正解の計算式」からハッシュ値を生成しておき、現在のプロジェクトの計算式から生成したハッシュ値と比較する手法を検討すべきである。これにより、文字列比較のコストを $O(n)$ から定数時間に近いレベルまで削減できる。

C. レガシー環境への配慮と Windows API

大規模組織では、最新の Office 365 だけでなく、依然として古いバージョンの MS Project が動いている可能性がある。
`Declare PtrSafe` を用いた API 呼び出しは、64bit/32bit 両対応を前提としなければならない。また、本稿で示した `GetTickCount` による計測は、ガバナンス・チェック自体がユーザーの作業を阻害していないか(UXの劣化)を定量的に評価するために不可欠なプロセスである。

結言

ガバナンスとは、制限することではない。「秩序を維持し、システムが意図した通りに振る舞う権利を保証すること」である。

カスタムフィールドの定義をコードによって強制するこのアーキテクチャは、一見すると過剰なまでの管理に見えるかもしれない。しかし、データの整合性が失われた後のリカバリーコストを考えれば、これこそが最も経済的で、最もプロフェッショナルなアプローチである。

エンジニアの仕事は、動くものを作ることではない。「壊れないシステム」を設計することである。

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