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