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

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

Project VBA Governance: カスタムフィールドの「破壊」を防ぎ、データ整合性を死守する自己修復型アーキテクチャ

大規模なプロジェクト管理環境において、Microsoft Projectは単なるスケジュール管理ツールではない。それは、組織の意思決定を支える「構造化されたデータベース」である。

しかし、多くの現場で悲劇が起きている。
「誰かがカスタムフィールドの計算式を書き換えた」「誤ってデータ型を変更した」「命名規則を無視して新しいフィールドを作った」――。

これらの「些細な変更」は、プロジェクトファイル単体の問題に留まらない。その背後にあるPower BIによる自動集計、Excelによるポートフォリオ管理、ERPへのデータ連携といったデータパイプライン全体を、音を立てて崩壊させる。

本記事では、単なる「自動化スクリプト」の書き方を教えるのではない。複数ユーザーが共存する混沌とした環境において、カスタムフィールドの定義(スキーマ)を強制し、不正な変更を検知・自動修復する「ガバナンス・エンジン」の設計思想とその実装方法を伝授する。

1. 凡庸な設計と、プロフェッショナルな設計の境界線

まず、初心者が陥る「間違ったアプローチ」を指摘しておく。

❌ 失敗するアプローチ:VBAコード内に定義をハードコードする

' 悪い例:メンテナンス性が皆無
If Application.CustomFields("KPI_Status").Formula <> "IIf([% Complete]=100, ""Done"", ""In Progress"")" Then
    Application.CustomFields("KPI_Status").Formula = "IIf([% Complete]=100, ""Done"", ""In Progress"")"
End If

このようなコードは、フィールドが増えるたびにVBAを書き換え、再配布しなければならない。これは「自動化」ではなく、単なる「苦行の先送り」だ。

✅ 採用すべきアーキテクチャ:Single Source of Truth (SSOT)

プロフェッショナルは、「定義(Schema)」と「ロジック(Engine)」を完全に分離する。
定義は外部ファイル(CSV、JSON、あるいは管理用のマスターExcel)に保持し、VBAはそれを読み取って「現在の状態」と「あるべき状態」を比較する検疫(Quarantine)エンジンとして機能させるべきだ。

2. ガバナンスツールの設計要件

堅牢なガバナンスツールには、以下の3要素が不可欠である。

1. 宣言的定義 (Declarative Definition): 「どうあるべきか」を外部ファイルに記述する。
2. べき等性 (Idempotency): 何回実行しても、同じ正しい状態に収束すること。
3. 非破壊的検証 (Dry-run Capability): 修正前に「何が違反しているか」をログに出力し、管理者に通知できること。

3. 実装:自己修復型ガバナンス・エンジン

以下に、実務でそのままプロトタイプとして利用可能な、クラスモジュール設計を意識した堅牢なコード例を示す。ここでは、定義をCSVファイルから読み込む設計とする。

A. 定義ファイル (schema_definition.csv) の構成

CSVは以下のカラムを持つものとする。
`TargetType` (Task/Resource), `FieldName`, `FieldType` (Text/Number/etc), `Formula`

B. プロダクションコード (Standard Module)

Option Explicit

' ===============================================================================
' Project VBA Governance Engine
' 目的: カスタムフィールドの定義を外部定義ファイルに基づき検証・修復する
' ===============================================================================

Public Sub EnforceFieldGovernance()
    Dim schemaPath As String
    Dim isDryRun As Boolean
    
    ' 設定: 本番環境では False に設定
    ' True の場合は、変更を行わずログ出力のみを行う(検証モード)
    isDryRun = True 
    
    ' 定義ファイルのパス (実際には共有ネットワークパス等を指定)
    schemaPath = ThisWorkbook.Path & "\field_schema.csv"
    
    If Dir(schemaPath) = "" Then
        MsgBox "Error: Schema definition file not found at " & schemaPath, vbCritical
        Exit Sub
    End If

    On Error GoTo ErrorHandler
    
    Debug.Print "--- Governance Check Started: " & Now & " ---"
    
    ' 1. 定義ファイルの読み込みと検証ロジックの実行
    Call ProcessGovernance(schemaPath, isDryRun)
    
    Debug.Print "--- Governance Check Completed ---"
    MsgBox "ガバナンスチェックが完了しました。" & IIf(isDryRun, " (検証モード: 変更なし)", ""), vbInformation
    
    Exit Sub

ErrorHandler:
    MsgBox "致命的なエラーが発生しました: " & Err.Description, vbCritical
End Sub

Private Sub ProcessGovernance(ByVal filePath As String, ByVal dryRun As Boolean)
    Dim fso As Object
    Dim ts As Object
    Dim line As String
    Dim parts() As String
    
    ' CSVのパース(簡易版。実務ではカンマ・クォート処理を厳密に行うこと)
    Set fso = CreateObject("Scripting.FileSystemObject")
    Set ts = fso.OpenTextFile(filePath, 1)
    
    ' ヘッダーをスキップ
    If Not ts.AtEndOfStream Then ts.ReadLine
    
    Do While Not ts.AtEndOfStream
        line = ts.ReadLine
        If Trim(line) <> "" Then
            parts = Split(line, ",")
            ' parts(0): TargetType (Task/Resource)
            ' parts(1): FieldName
            ' parts(2): FieldType (Text/Number/Date/etc)
            ' parts(3): Formula
            
            Call ValidateAndFixField(parts(0), parts(1), parts(2), parts(3), dryRun)
        End If
    Loop
    
    ts.Close
End Sub

Private Sub ValidateAndFixField(targetType As String, fName As String, fType As String, fFormula As String, dryRun As Boolean)
    Dim targetField As Object
    Dim fieldFound As Boolean
    Dim currentFormula As String
    Dim currentType As String
    
    fieldFound = False
    
    ' 1. フィールドの存在確認と取得
    ' 注意: Application.CustomFields は Task と Resource で共通だが、
    ' 実際には使い分けが必要な場合があるため、型判定ロジックを慎重に行う
    On Error Resume Next
    Set targetField = Application.CustomFields(fName)
    If Err.Number = 0 Then fieldFound = True
    On Error GoTo 0
    
    If Not fieldFound Then
        ' 未定義のフィールドが発見された場合、組織のポリシーにより「削除」か「無視」かを選択
        Debug.Print "[WARNING] Unauthorized field detected: " & fName
        Exit Sub
    End If

    ' 2. 状態の比較
    currentFormula = targetField.Formula
    ' 注: FieldTypeの比較は、MS Projectの内部定数(Enum)に変換して比較する必要がある
    ' ここでは簡略化のため、文字列比較の概念を示す
    
    Dim needsFix As Boolean
    needsFix = False
    
    ' 計算式の不一致チェック
    If currentFormula <> fFormula Then
        Debug.Print "[MISMATCH] Formula error in '" & fName & "'. Expected: " & fFormula & " | Actual: " & currentFormula
        needsFix = True
    End If
    
    ' 3. 修復アクション
    If needsFix Then
        If dryRun Then
            Debug.Print "[DRY-RUN] Would fix field: " & fName
        Else
            Debug.Print "[FIXING] Applying correct formula to: " & fName
            targetField.Formula = fFormula
            ' ここで計算式適用後の整合性チェックを再度行うのが理想的
        End If
    Else
        Debug.Print "[OK] Field '" & fName & "' is compliant."
    End If
End Sub

4. アーキテクトの視点:運用における落とし穴

このツールをプロダクション環境にデプロイする際、以下の3点に留意せよ。

① 実行タイミングの制御

`Auto_Open` や `Workbook_Open` で実行するのは一般的だが、大規模なプロジェクトファイルでは、起動時のカスタムフィールドのスキャンに数秒の遅延が発生する。ユーザー体験を損なわないよう、「起動時にチェックし、不整合があれば通知して、ユーザーに修正の適用を許可する」という非同期的なアプローチが望ましい。

② 権限管理とファイルロック

定義ファイル(CSV/Excel)自体が書き換えられてしまっては意味がない。定義ファイルは、書き込み権限をシステム管理者のみに制限した共有フォルダ、あるいはデータベースに配置せよ。

③ エラーハンドリングの深さ

カスタムフィールドの計算式を書き換える際、もし新しい式が構文エラー(Syntax Error)を含んでいた場合、`targetField.Formula = fFormula` の瞬間にランタイムエラーが発生し、プロジェクト全体の操作がロックされる可能性がある。
必ず、「新しい式を一時的な変数にセットし、それが有効かどうかを事前に検証する」、あるいは「エラー発生時に即座に以前の定義にロールバックする」仕組みを組み込め。

結論

カスタムフィールドの管理は、単なる「便利機能の追加」ではない。それは、組織のデータガバナンスにおける「スキーマ管理」そのものである。

VBAを単なるマクロとして扱うのではなく、システムエンジニアリングの観点から「定義」と「実行」を分離し、自己修復能力を持たせること。この一歩が、あなたの構築する自動化ソリューションを、単なる「ツール」から「信頼に足るインフラ」へと昇華させる。

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