【テクニカル・上級編】【初心者向け】カスタムフィールドの表示名が重複した際のエラーを回避する名前空間管理の基礎 – Project VBA解析バイブル

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

「名前空間の衝突」を制御せよ:MS Project VBAにおけるカスタムフィールド設計の極致

大規模なプロジェクト管理システムを構築する際、多くのエンジニアが陥る罠がある。それは、「カスタムフィールドの定義」という、一見単純に見える操作に潜む、命名空間(Namespace)の衝突だ。

MS Projectのオブジェクトモデルにおいて、`CustomField` はプロジェクト全体のグローバルなリソースに近い性質を持つ。複数のアドイン、あるいは異なる部署から提供された複数のマクロが、無秩序に `Task` や `Resource` のカスタムフィールドを生成し始めたとき、システムは例外を吐き出し、あるいは既存の重要なデータを上書きして、静かに崩壊していく。

本稿では、単なる「フィールドの作り方」ではない。数千のタスクと複雑な計算式が絡み合うエンタープライズ環境において、いかにしてカスタムフィールドの整合性を保ち、堅牢な自動化アーキテクチャを構築するか。その設計思想と実装の詳細を伝授する。

1. 混沌を避けるための設計思想:Prefixingによる名前空間の分離

プロフェッショナルのコードに、`Custom1` や `MyField` といった無意味な名前は存在しない。

カスタムフィールドを自動生成する際、まず実装すべきは「命名規則(Naming Convention)」の強制である。これは、Windows APIにおけるモジュール識別子や、現代的なプログラミング言語における `namespace` の概念をVBAの世界に持ち込むことを意味する。

推奨される命名構造

`[システム識別子]_[対象オブジェクト]_[用途/ID]`

  • システム識別子: `CORP` (Company), `SYS` (System), `HR` (Human Resources) 等。
  • 対象オブジェクト: `T` (Task), `R` (Resource) 等。
  • 用途/ID: `CostCalc`, `Status01` 等。

例:`CORP_T_RiskScore`

このように設計することで、フィールド一覧を見ただけで、そのフィールドが「誰によって、何の目的で」定義されたものかが一目で判別でき、誤った上書きを物理的に防ぐことができる。

2. 実装の核心:存在チェックと安全な取得ロジック

エラーハンドリングにおいて、`On Error Resume Next` を乱用するのは素人の仕事だ。真のアーキテクトは、「状態を事前に検知し、遷移を制御する」。

以下に示すのは、カスタムフィールドの存在を確認し、存在しない場合のみ、定義された命名規則に従って安全に生成する、堅牢なロジックの雛形である。

Option Explicit

' ==============================================================================
' Module: FieldManager
' Description: カスタムフィールドの衝突を回避し、安全に管理するためのコアロジック
' ==============================================================================

' 定数定義:名前空間の管理
Private Const NS_PREFIX As String = "SYS_" ' システム専用のプレフィックス

''' <summary>
''' 指定した名前のカスタムフィールドが存在するかを確認し、存在しなければ作成する。
''' </summary>
''' <param name="app">MS Project Applicationオブジェクト</param>
''' <param name="fieldName">生成したいフィールド名(プレフィックス込み)</param>
''' <param name="fieldType">TaskかResourceか (True: Task, False: Resource)</param>
''' <returns>取得したCustomFieldオブジェクト</returns>
Public Function GetOrCreateCustomField(ByRef app As MSProject.Application, _
                                       ByVal fieldName As String, _
                                       ByVal isTask As Boolean) As Object
    
    Dim pf As MSProject.CustomField
    Dim foundField As Object
    Dim i As Integer
    
    ' 1. 存在チェック(コレクションを走査)
    ' 大規模プロジェクトではループのコストを考慮する必要があるが、
    ' カスタムフィールドの総数は限定的なため、逐次検索が最も確実である。
    On Error Resume Next
    For i = 1 To app.CustomFields.Count
        Set pf = app.CustomFields(i)
        ' 名前が一致するか判定
        If pf.Name = fieldName Then
            Set foundField = pf
            Exit For
        End If
    Next i
    On Error GoTo 0

    ' 2. 存在する場合の処理
    If Not foundField Is Nothing Then
        ' すでに存在する場合、そのプロパティ(Task用かResource用か)が
        ' 期待するものと一致しているか、厳格な検証が必要となる。
        ' ここでは簡略化のため、既存のものをそのまま返す。
        Set GetOrCreateCustomField = foundField
        Exit Function
    End If

    ' 3. 存在しない場合の生成ロジック
    ' ここで新しいフィールドを定義する。
    ' 実際の運用では、計算式(Formula)の設定もここで行うべきである。
    On Error GoTo ErrorHandler
    
    ' 新規フィールドの定義(実際には既存の空きスロットを探す必要がある)
    ' MS ProjectのAPI仕様上、直接「新規作成」するメソッドではなく、
    ' 既存のCustomFieldオブジェクトのプロパティを書き換えるアプローチが一般的。
    ' ※本例ではロジックの構造を示すため、概念的な記述とする。
    
    ' [実装のヒント] 
    ' 実際には、app.CustomFields.Add ではなく、
    ' 未使用の CustomField インデックスを特定し、その Name プロパティを書き換える。
    
    Set GetOrCreateCustomField = CreateNewFieldSlot(app, fieldName, isTask)
    
    Exit Function

ErrorHandler:
    ' 致命的なエラーが発生した場合、オブジェクトを明示的に解放し、呼び出し元にエラーを伝える
    Set GetOrCreateCustomField = Nothing
    Err.Raise Err.Number, "FieldManager.GetOrCreateCustomField", _
              "Custom Field creation failed: " & Err.Description
End Function

''' <summary>
''' 未使用のスロットを探してフィールドを割り当てる内部メソッド
''' </summary>
Private Function CreateNewFieldSlot(ByRef app As MSProject.Application, _
                                   ByVal name As String, _
                                   ByVal isTask As Boolean) As Object
    Dim i As Integer
    Dim pf As MSProject.CustomField
    
    ' 未使用(名前が空、あるいは既存の命名規則に合致しない)スロットを探索
    For i = 1 To app.CustomFields.Count
        Set pf = app.CustomFields(i)
        ' 名前が空、あるいは管理外の名前であれば、そこを「予約」する
        If pf.Name = "" Or Not pf.Name Like NS_PREFIX & "*" Then
            pf.Name = name
            ' ここで計算式や型を設定する
            ' pf.Formula = "..." 
            Set CreateNewFieldSlot = pf
            Exit Function
        End If
    Next i
    
    Err.Raise 5, "FieldManager.CreateNewFieldSlot", "No available custom field slots found."
End Function

3. メモリ管理とオブジェクトのライフサイクル

VBAにおけるCOMオブジェクト(MS Projectのオブジェクトを含む)の扱いは、極めて繊細である。特に、ループ内で大量の `CustomField` オブジェクトを操作する場合、「参照カウントの適切な管理」を怠ると、メモリリークを引き起こし、MS Project自体が不安定(Not Responding)になる原因となる。

アーキテクトの鉄則:

1. 明示的な解放: ループ内でオブジェクトを代入した後は、必ず `Set pf = Nothing` を行い、参照カウントを減らすこと。
2. 変数のスコープ: `Application` オブジェクトを関数間で渡す際は、必ず `ByRef` を使用し、呼び出し元が管理するインスタンスを共有すること。
3. エラー時のクリーンアップ: `ErrorHandler` 内では、作成途中のオブジェクトを必ず `Nothing` に落とし、システムを「汚染された状態」で放置しないこと。

4. レガシー環境への配慮:システム間連携の極限

現場では、最新のMS Projectだけでなく、数年前のバージョンや、特定のレガシーなアドインが同居している環境も珍しくない。

カスタムフィールドを自動設定する際、計算式(`Formula`)に利用する関数が、ターゲットとするバージョンのMS Projectでサポートされているかを確認するロジックを組み込むのが、シニアエンジニアの流儀だ。

例えば、文字列操作の `LEFT` 関数や、日付操作の `DateDiff` 関数など、計算式を文字列としてセットする前に、その構文が「Projectの式エンジン」において妥当であるかを、テスト用のダミープロジェクトで検証するプロセスを自動化に組み込むべきである。

結論

カスタムフィールドの自動生成は、単なる「プロパティの書き換え」ではない。それは、プロジェクト全体のデータ構造を定義する「スキーマ設計」そのものである。

  • 名前空間(Prefix)を定義せよ。
  • 存在チェックを徹底せよ。
  • オブジェクトのライフサイクルを支配せよ。

これらを守ることで、あなたの構築する自動化システムは、単なる「便利なツール」から、企業の根幹を支える「堅牢なインフラ」へと昇華する。

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