「名前空間の衝突」を制御せよ: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)を定義せよ。
- 存在チェックを徹底せよ。
- オブジェクトのライフサイクルを支配せよ。
これらを守ることで、あなたの構築する自動化システムは、単なる「便利なツール」から、企業の根幹を支える「堅牢なインフラ」へと昇華する。
