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

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

データの「聖域」を守り抜く:大規模組織のためのカスタムフィールド・ガバナンス・エンジニアリング

こんにちは。現場の荒波を乗り越えてきたエンジニアの皆さん、今日もコードを書いていますか?

MS Projectを使って大規模なプロジェクト管理をしていると、ある日突然、恐ろしい事態に遭遇することがあります。

「あれ? 先週まで自動計算されていた『進捗リスク値』の列が、ただのテキスト入力欄になってる……?」
「誰かがカスタムフィールドの計算式を書き換えたせいで、全社の集計レポートがめちゃくちゃだ!」

これは、複数ユーザーが同じプロジェクトファイル(またはテンプレート)を編集する環境において、「カスタムフィールドの定義(名前や計算式)」が、個人の裁量で書き換えられてしまうという、ガバナンス崩壊の典型的な症状です。

マクロの記録で「セルに値を入力する」ことはできても、「システムのルールを守らせる」ことはできません。今日は、一歩上のエンジニアを目指すあなたに、カスタムフィールドの定義を強制し、不正な変更を自動で検知・修復する「ガバナンス・ツール」の設計思想と実装方法を伝授します。

ここをクリアすれば、あなたは単なる「マクロ使い」から、「システム設計者」へと進化できるはずですよ。

1. なぜ「カスタムフィールド」は壊れるのか?

MS Projectのカスタムフィールド(Text1, Number1, Formulaなど)は、いわばデータの「器」です。

大規模組織では、この「器」に特定のルール(例:`Text1`には必ず「プロジェクトフェーズ」という名前を付け、計算式には`[Finish]-[Start]`を入れる)を設けます。しかし、MS Projectの仕様上、ユーザーは誰でもこの定義をダブルクリック一つで変更できてしまいます。

設計者としての視点:
「ユーザーが間違えないように注意しましょう」という教育は、エンジニアの仕事ではありません。「間違えたとしても、システムが自動的に正しい状態に戻す」。これこそが、堅牢な自動化の本質です。

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

今回構築するのは、プロジェクトファイルが開かれた瞬間に、あらかじめ定義した「正解の定義(マスター)」と「現在の設定」を照合し、もし差異があれば即座に書き戻すという仕組みです。

アーキテクチャの概念図

1. Master Definition (正解データ): プログラム内に保持する「正しい名前」と「正しい計算式」。
2. Inspection Engine (検査エンジン): `CustomFields` コレクションを走査し、現状を確認。
3. Auto-Correction (自動修復): 不一致を発見した場合、マスターの値を再代入。

3. 実装コード:CustomField Guard

それでは、魂を込めて書いたコードを見ていきましょう。このコードは、単に動くだけでなく、後からのメンテナンス性を考慮した構造にしています。

Option Explicit

' ===============================================================================
' Module: FieldGovernanceEngine
' Description: カスタムフィールドの定義を監視・強制するガバナンスツール
' ===============================================================================

' カスタムフィールドの定義を格納するためのユーザー定義型
Private Type FieldMaster
    FieldID As Integer      ' MS Projectの内部ID (Text1なら1, Text2なら2...)
    IsTaskField As Boolean  ' タスク用かリソース用か
    CorrectName As String   ' 正しい名前
    CorrectFormula As String ' 正しい計算式
End Type

' 監視対象のリストを保持する配列
Private MasterList() As FieldMaster

''' <summary>
''' プロジェクトが開いた時に実行されるメインルーチン
''' </summary>
Public Sub Auto_Open()
    InitializeMasterDefinitions
    RunGovernanceCheck
End Sub

''' <summary>
''' 正解となる定義をメモリ上に展開する
''' </summary>
Private Sub InitializeMasterDefinitions()
    ' ここで「あるべき姿」を定義します。
    ' 現場の運用ルールが変わったら、ここだけを修正すればOKです。
    
    ReDim MasterList(0 To 2) ' 例として3つ定義
    
    ' 定義1: Text1 を 「プロジェクトフェーズ」 に固定
    With MasterList(0)
        .FieldID = 1 ' Text1
        .IsTaskField = True
        .CorrectName = "プロジェクトフェーズ"
        .CorrectFormula = "" ' 数式なし
    End With
    
    ' 定義2: Number1 を 「進捗リスクスコア」 に固定し、計算式を強制
    With MasterList(1)
        .FieldID = 1 ' Number1
        .IsTaskField = True
        .CorrectName = "進捗リスクスコア"
        .CorrectFormula = "IIf([% Complete]<50, 1, 0)" ' 50%未満ならリスク1
    End With
    
    ' 定義3: ResourceのText1を固定(リソース管理用)
    With MasterList(2)
        .FieldID = 1 ' Resource Text1
        .IsTaskField = False
        .CorrectName = "スキルカテゴリ"
        .CorrectFormula = ""
    End With
End Sub

''' <summary>
''' 定義のチェックと自動修復を実行する
''' </summary>
Private Sub RunGovernanceCheck()
    Dim i As Integer
    Dim currentField As Object
    Dim targetFieldID As Integer
    Dim isTask As Boolean
    Dim mismatchCount As Integer
    
    mismatchCount = 0
    
    On Error GoTo ErrorHandler
    
    ' MS Projectの画面更新を止めてパフォーマンスを向上させる
    Application.ScreenUpdating = False
    
    For i = LBound(MasterList) To UBound(MasterList)
        ' ターゲットとなるフィールドの取得
        ' Task用かResource用かで参照先を切り替える
        If MasterList(i).IsTaskField Then
            Set currentField = Application.CustomFields(MasterList(i).FieldID, True)
        Else
            Set currentField = Application.CustomFields(MasterList(i).FieldID, False)
        End If
        
        ' --- 検証プロセス ---
        
        ' 1. 名前が正しいか?
        If currentField.Name <> MasterList(i).CorrectName Then
            Debug.Print "Name Mismatch: " & MasterList(i).CorrectName & " を適用します。"
            currentField.Name = MasterList(i).CorrectName
            mismatchCount = mismatchCount + 1
        End If
        
        ' 2. 計算式が正しいか?
        ' 数式がある場合のみチェック(空文字の扱いに注意)
        If currentField.Formula <> MasterList(i).CorrectFormula Then
            Debug.Print "Formula Mismatch: 式を修復します。"
            currentField.Formula = MasterList(i).CorrectFormula
            mismatchCount = mismatchCount + 1
        End If
    Next i
    
    ' 完了報告
    If mismatchCount > 0 Then
        MsgBox mismatchCount & " 件の不正な定義を検知し、自動的に修復しました。" & vbCrLf & _
               "管理者に報告してください。", vbExclamation, "ガバナンス警告"
    Else
        Debug.Print "All custom fields are compliant."
    End If

CleanUp:
    Application.ScreenUpdating = True
    Exit Sub

ErrorHandler:
    MsgBox "ガバナンスチェック中にエラーが発生しました: " & Err.Description, vbCritical
    Resume CleanUp
End Sub

4. プロの視点:ここが「脱・初学者」のポイント

このコードをただコピペするだけでは不十分です。なぜこのような書き方をしているのか、その「重み」を理解してください。

① オブジェクトのライフサイクルと `Application.ScreenUpdating`

大規模なプロジェクトでは、カスタムフィールドの数も膨大です。一つずつ書き換えるたびに画面が再描画されると、ユーザーは「ファイルが開くのが遅い!」と不満を抱きます。
`Application.ScreenUpdating = False` を使うのは、単なるテクニックではなく、「ユーザー体験(UX)への配慮」です。

② `CustomFields` コレクションの第2引数

コード内の `Application.CustomFields(ID, True)` の `True` という部分に注目してください。これは「Task用か、それともResource用か」を指定する極めて重要なフラグです。これを間違えると、タスクのフィールドを書き換えたつもりが、リソースのフィールドを破壊するという、最悪の事故を招きます。

③ エラーハンドリングの重要性

もし、ユーザーが「計算式が壊れた状態(例:存在しないフィールドを参照している式)」を保存していた場合、VBAがその式を読み取ろうとした瞬間にランタイムエラーで停止します。
`On Error GoTo ErrorHandler` を配置しておくことで、システムがクラッシュしてプロジェクト自体が使い物にならなくなる事態を防いでいます。

5. 陥りやすい落とし穴(Pitfalls)

実装する際に、以下の点に注意してください。

1. 計算式の構文エラー:
`CorrectFormula` に記述する式は、MS Projectの数式エディタでそのまま使える文字列である必要があります。括弧の閉じ忘れなどは致命的です。
2. 権限の問題:
このマクロは、ユーザーが「読み取り専用」でファイルを開いている場合には動作しません。ガバナンスを効かせるには、適切な共有設定と、マクロの実行許可が必要です。
3. 循環参照:
カスタムフィールド同士で互いに計算式を参照し合っている場合、修復プロセスが無限ループしたり、エラーを吐いたりすることがあります。設計段階で「データの流れ(データの依存関係)」を整理しておきましょう。

最後に:エンジニアとしての誇り

「ただ動くもの」を作るのは簡単です。しかし、「誰がどう使っても、常に正しい状態を保つもの」を作るには、一歩踏み込んだ設計思想が必要です。

今回紹介したガバナンスツールは、大規模な組織において「データの信頼性」という、プロジェクトの根幹を支えるインフラになります。

「マクロの記録」の先にある、この「守るための設計」という世界。ぜひ、あなたのプロジェクトでも体感してみてください。応援していますよ!

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