【テクニカル・上級編】【中級者向け】カスタムフィールドの定義をテンプレートファイルから読み込み、新規プロジェクトに適用する – Project VBA解析バイブル

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

[Deep Dive] カスタムフィールドの統治:テンプレート注入によるプロジェクト・メタデータの完全自動化

プロジェクト管理の規模が拡大し、組織的なガバナンスが求められるフェーズにおいて、エンジニアが最初に直面する壁は「データの不均一性」である。

MS Projectにおけるカスタムフィールド(Task/Resource Custom Fields)は、単なる計算用カラムではない。それはプロジェクトの「メタデータ・スキーマ」そのものである。しかし、多くの現場では、このスキーマ定義が個々のプロジェクト管理者の手作業や、脆弱なハードコードされたVBAスクリプトに依存している。その結果、計算式の乖離、データ型の不一致、そしてメンテナンスの破綻を招いている。

本稿では、カスタムフィールドの定義を「コード」としてではなく、「テンプレート(Source of Truth)」として管理し、それを動的に新規プロジェクトへ注入する、極めて堅牢なアーキテクチャについて解説する。

1. 設計思想:ハードコードからの脱却と「メタデータ・インジェクション」

中級者が陥る罠は、`CustomField1.Name = “工数単価”` といったプロパティを直接コードに書き込むことだ。これは、仕様変更(フィールド名の変更や計算式の修正)が発生した瞬間に、システム全体の再ビルドと再配布を強いる、極めてコストの高い設計である。

真のアーキテクトは、「定義(Definition)」と「実行(Execution)」を完全に分離する。

我々が構築すべきは、以下のプロセスを持つエンジンである。
1. Master Template (.mpp) を「定義のマスター」として保持する。
2. Injection Engine がテンプレート内のカスタムフィールド・オブジェクトを走査する。
3. Target Project に対して、定義を同期的かつ冪等(Idempotent)に適用する。

2. 実装:テンプレート駆動型インジェクション・エンジン

以下に、テンプレートファイルからカスタムフィールドの定義(名称、型、計算式)を抽出し、アクティブなプロジェクトへ適用するコア・ロジックを示す。

ここでは、メモリリークを防ぎ、COMオブジェクトのライフサイクルを厳格に管理するための実装パターンを採用している。

Option Explicit

' ==============================================================================
' Module: modFieldInjector
' Description: テンプレートからカスタムフィールドを抽出し、対象プロジェクトに適用する
' Architect: Legendary Chief Architect
' ==============================================================================

''' <summary>
''' テンプレートファイルからカスタムフィールド定義を読み込み、現在のプロジェクトに適用する。
''' </summary>
''' <param name="templatePath">マスターテンプレートのフルパス</param>
Public Sub InjectCustomFieldsFromTemplate(ByVal templatePath As String)
    Dim projTemplate As MSProject.Project
    Dim targetProj As MSProject.Project
    Dim tf As MSProject.TaskCustomField
    Dim rf As MSProject.ResourceCustomField
    Dim i As Integer
    
    ' 1. 環境の初期化
    Set targetProj = MSProject.ActiveProject
    
    ' ファイルの存在確認(Win32 APIを使用せずとも、VBA標準で堅牢に実装)
    If Dir(templatePath) = "" Then
        Err.Raise vbObjectError + 513, "Injector", "Template file not found: " & templatePath
    End If

    On Error GoTo ErrorHandler
    
    ' 高速化のための最適化
    Application.ScreenUpdating = False
    
    ' 2. テンプレートを非表示で開く(オブジェクトのライフサイクル管理が重要)
    ' ReadOnlyで開くことで、テンプレート自体の破損を防ぐ
    Set projTemplate = MSProject.Open(Name:=templatePath, ReadOnly:=True, Visibilty:=pjDoNotShow)
    
    Debug.Print "--- Starting Field Injection: " & Now & " ---"

    ' 3. Task Custom Fields の同期
    ' MS ProjectのCustomFieldコレクションは、インデックスによるアクセスが基本となる
    ' プロジェクトの仕様により、既存のフィールドを上書きするか、新規作成するかを判断する必要がある
    For i = 1 To 30 ' Task Custom Fields の最大範囲(仕様に合わせ調整)
        Set tf = projTemplate.TaskCustomFields(i)
        
        ' 定義が存在する場合のみ適用(空のフィールドはスキップ)
        If tf.Name <> "" Then
            ApplyTaskField targetProj, i, tf
        End If
    Next i

    ' 4. Resource Custom Fields の同期
    For i = 1 To 30
        Set rf = projTemplate.ResourceCustomFields(i)
        If rf.Name <> "" Then
            ApplyResourceField targetProj, i, rf
        End If
    Next i

    Debug.Print "--- Injection Completed Successfully ---"

CleanUp:
    ' 5. 厳格なリソース解放(メモリリーク防止の要)
    ' COMオブジェクトは Nothing を明示的に代入し、参照カウントをゼロにする
    On Error Resume Next
    If Not projTemplate Is Nothing Then
        projTemplate.Close SaveChanges:=pjDoNotSaveChanges
        Set projTemplate = Nothing
    End If
    Application.ScreenUpdating = True
    Exit Sub

ErrorHandler:
    MsgBox "Critical Error during Injection: " & Err.Description, vbCritical, "System Error"
    Resume CleanUp
End Sub

''' <summary>
''' Taskフィールドを対象プロジェクトに適用する内部メソッド
''' </summary>
Private Sub ApplyTaskField(ByRef target As MSProject.Project, ByVal idx As Integer, ByRef source As MSProject.TaskCustomField)
    Dim targetFld As MSProject.TaskCustomField
    Set targetFld = target.TaskCustomFields(idx)
    
    ' 冪等性を確保するため、既存の定義を上書きする
    ' ※計算式(Formula)の適用は、文字列として注入される
    targetFld.Name = source.Name
    targetFld.Formula = source.Formula
    ' Typeの同期は、MS Projectの内部的な列挙型に依存する
    ' 必要に応じて、Typeプロパティの整合性をチェックするロジックを追加
End Sub

''' <summary>
''' Resourceフィールドを対象プロジェクトに適用する内部メソッド
''' </summary>
Private Sub ApplyResourceField(ByRef target As MSProject.Project, ByVal idx As Integer, ByRef source As MSProject.ResourceCustomField)
    Dim targetFld As MSProject.ResourceCustomField
    Set targetFld = target.ResourceCustomFields(idx)
    
    targetFld.Name = source.Name
    targetFld.Formula = source.Formula
End Sub

3. 究極の知見:メモリ管理とCOMオブジェクトのライフサイクル

このコードを単なる「動くスクリプト」から「プロフェッショナルなツール」へと昇華させているのは、オブジェクトのライフサイクル管理である。

3.1. 参照カウントの制御

MS ProjectのようなCOM(Component Object Model)ベースのアプリケーションにおいて、`Project`オブジェクトを操作する際、最も恐ろしいのは「ゾンビプロセス」である。
`projTemplate.Close` を呼び出したとしても、変数 `projTemplate` がメモリ上に残っている限り、MS Projectのプロセスはバックグラウンドで残り続け、メモリを食いつぶす。
`Set projTemplate = Nothing` は単なる作法ではなく、システム全体の安定性を担保するための必須の儀式である。

3.2. 冪等性(Idempotency)の確保

インジェクション・エンジンにおいて、`ApplyTaskField` 内で行っている処理は「現在の状態に関わらず、期待する状態にする」という冪等性の原則に基づいている。
もし、既存のフィールド名と衝突した場合の挙動(エラーにするのか、上書きするのか、スキップするのか)を、ビジネスロジックに基づいて設計せよ。本実装では、マスターを正とする「上書き戦略」を採用している。

3.3. パフォーマンスへの配慮

大規模なプロジェクト(数万タスク規模)において、カスタムフィールドの定義変更は、プロジェクト全体の再計算(Recalculation)を誘発する。
`Application.ScreenUpdating = False` は基本だが、さらに高度な制御を行うならば、フィールド適用後に一度だけ `Application.Calculate` を明示的に呼び出し、計算のタイミングをエンジニアが完全に掌握すべきである。

4. 結論:アーキテクトとしての責務

カスタムフィールドの自動化は、単なる時短テクニックではない。それは、「プロジェクト・データ・ガバナンス」の基盤を構築する行為である。

テンプレートから定義を流し込む仕組みを構築することで、あなたは「個別のプロジェクト」というミクロな視点から、「組織全体のデータ構造」というマクロな視点へと昇華することができる。

コードを書くのではない。システムを設計せよ。
メモリの一滴、オブジェクトの一個に至るまで、その挙動を支配下に置け。それこそが、真のエンジニアリングである。

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