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

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

Project VBAを掌握する:カスタムフィールドの「定義」をテンプレートから自動同期する極限の設計術

こんにちは。現場で数々の自動化プロジェクトを指揮してきた、あなたの少し先を行くエンジニアです。

「マクロの記録」を使って、なんとか業務を回している。そんな段階から一歩踏み出し、「もっとスマートに、ミスなく、標準化された仕組みを作りたい」と願うようになったあなた。その向上心こそが、エンジニアとして最も大切な資質です。

今日、私たちが挑むのは、MS Project運用における最大の「手作業の温床」を破壊することです。

それは、「カスタムフィールド(Task/Resource)の定義と計算式のセットアップ」です。

新しいプロジェクトを立ち上げるたびに、Text1に「進捗ステータス」と入れ、Number1に「重要度」と入れ、複雑な計算式をコピペする……。そんな作業は、今日で終わりにしましょう。

なぜ「マクロの記録」では足りないのか?

多くの人が陥る罠があります。それは、「値(Value)を書き換えること」と「定義(Definition)を設定すること」を混同してしまうことです。

「マクロの記録」でカスタムフィールドを操作すると、多くの場合「特定のタスクのText1に『完了』と書き込む」というコードが生成されます。しかし、私たちが自動化したいのは「Text1というフィールドの名前を『進捗状況』に変え、計算式を `[% Complete]*100` に設定する」という、フィールドそのものの設計図(メタデータ)の書き換えなのです。

この「設計図」を制御できるようになると、あなたのVBAは「単なる作業代行」から「システムの構築」へと昇華します。

設計思想:テンプレート・ドリブン・アプローチ

今回のゴールは、「マスターとなるテンプレートファイル(.mpp)に定義されたカスタムフィールドの情報を読み取り、現在開いているプロジェクトにその定義を流し込む」という仕組みを作ることです。

仕組みの全体像

1. Template Project: すべての「正しい定義(名前、計算式、型)」が格納されたマスターファイル。
2. Current Project: 今まさに作業している、設定が空っぽのプロジェクト。
3. Automation Engine: テンプレートの `CustomFields` コレクションを走査し、現在のプロジェクトの同名フィールドへ定義をコピーするVBA。

実装:カスタムフィールド・インポーター

それでは、魂を込めたコードを見ていきましょう。このコードは、単に動くだけでなく、エラーへの耐性とメンテナンス性を考慮した設計にしています。

Option Explicit

''' <summary>
''' テンプレートファイルからカスタムフィールドの定義を現在のプロジェクトに同期する
''' </summary>
''' <param name="templatePath">定義が格納されているテンプレートファイルのフルパス</param>
Public Sub SyncCustomFieldDefinitions(ByVal templatePath As String)
    Dim templateApp As MSProject.Application
    Dim templateProj As MSProject.Project
    Dim currentProj As MSProject.Project
    Dim cf As MSProject.CustomField
    Dim targetCF As MSProject.CustomField
    Dim fileNum As Integer
    
    ' 現在のプロジェクトをオブジェクトとして保持
    Set currentProj = ActiveProject
    
    ' 1. テンプレートファイルをバックグラウンドで開く
    ' ※ユーザーの画面を邪魔しないよう、Applicationオブジェクトを別途生成するのがプロの作法
    Set templateApp = New MSProject.Application
    On Error Resume Next
    Set templateProj = templateApp.FileOpen(templatePath, ReadOnly:=True)
    On Error GoTo 0
    
    If templateProj Is Nothing Then
        MsgBox "テンプレートファイルが見つかりません: " & templatePath, vbCritical
        templateApp.Quit
        Exit Sub
    End If
    
    Debug.Print "--- 同期プロセス開始 ---"

    ' 2. テンプレート内のカスタムフィールドを走査
    ' MS ProjectのCustomFieldsコレクションは、Task用とResource用が混在している
    For Each cf In templateProj.CustomFields
        
        ' フィールドが定義されている(名前や式が入っている)場合のみ処理
        If cf.Name <> "" Then
            
            ' 現在のプロジェクト内で、同じ「型」のフィールドを探す
            ' ※カスタムフィールドは「Text1」「Number1」といった物理名で管理される
            Set targetCF = FindTargetField(currentProj, cf.Type, cf.Name)
            
            ' 3. 定義の書き換え(ここがエンジニアの腕の見せ所)
            If Not targetCF Is Nothing Then
                On Error Resume Next
                ' 名前を設定
                targetCF.Name = cf.Name
                ' 計算式を設定(ここが最もエラーが起きやすい)
                targetCF.Formula = cf.Formula
                ' 表示形式(型)を合わせる
                ' 注意: 既存の物理名(Text1等)の型を直接変えるのはリスクがあるため、
                ' 基本的にはテンプレートと同じ構成であることを前提とする
                
                If Err.Number <> 0 Then
                    Debug.Print "エラー発生: フィールド [" & cf.Name & "] の適用に失敗しました。"
                    Err.Clear
                Else
                    Debug.Print "成功: [" & cf.Name & "] を適用しました。"
                End If
                On Error GoTo 0
            End If
        End If
    Next cf

    ' 4. 後片付け(リソースの解放はオブジェクトのライフサイクル管理の基本)
    templateProj.Close SaveChanges:=False
    templateApp.Quit
    
    Set templateProj = Nothing
    Set templateApp = Nothing
    
    MsgBox "カスタムフィールドの同期が完了しました。", vbInformation
    Debug.Print "--- 同期プロセス終了 ---"
End Sub

''' <summary>
''' 指定されたタイプ(Task/Resource)から、物理的なフィールド名(Text1等)を特定するための補助関数
''' </summary>
Private Function FindTargetField(ByRef proj As MSProject.Project, ByVal fieldType As MSProject.CustomFieldType, ByVal fieldName As String) As MSProject.CustomField
    ' 注意: 実務上は、テンプレート側で「Text1」などの物理名が何に使われているかを
    ' 判別するロジックが必要。ここでは簡易的に、テンプレートの物理名(Name)を
    ' 直接現在のプロジェクトのフィールドにマッピングするアプローチをとる。
    ' 実際には、CustomFieldsコレクションのインデックスや物理名を制御する。
    
    ' 本来、CustomFieldsコレクションの要素は「Text1」などの属性を持っている
    ' ここでは、テンプレートの「フィールド定義そのもの」を現在のプロジェクトの
    ' 対応するインデックスに適用するロジックへ昇華させる必要がある。
    ' (中略: 実装の詳細はプロジェクトの設計に依存)
    
    ' 今回は概念を示すため、直接的なマッチングを行う
    ' 実際にはプロジェクトのCustomFieldsコレクションをループして、
    ' テンプレートと同じ「物理的な位置」に書き込むのが最も安全です。
    
    ' ※簡略化のため、ここでは「テンプレートの構造を現在のプロジェクトに強制適用する」
    ' という高度なロジックの入り口としています。
End Function

プロが教える、陥りやすい「3つの地雷」

このコードを動かす前に、必ず覚えておいてほしいことがあります。ここをクリアすれば、あなたはもう「初心者」ではありません。

1. 「計算式(Formula)」の引用符地獄

VBAの中で計算式(文字列)を扱うとき、ダブルクォーテーションの扱いで必ず躓きます。
例えば、計算式が `[Cost] * 0.1` なら問題ありませんが、`IIf([Text1]=”Done”, 1, 0)` のように式の中に文字列が含まれる場合、VBAの文字列として記述するには `””Done””` とエスケープする必要があります。
対策: テンプレート側で数式を完成させておき、VBAではそれを「そのまま文字列として吸い上げる」のが最も安全です。

2. オブジェクトの解放(メモリリーク)

`New MSProject.Application` で新しいインスタンスを作った場合、最後に必ず `.Quit` し、オブジェクトを `Nothing` にしなければなりません。これを怠ると、バックグラウンドで「目に見えないMS Project」が大量に立ち上がり、PCのメモリを食いつぶすゾンビプロセスとなります。

3. 型の不一致(Type Mismatch)

`Text1`(テキスト型)に、計算結果として数値が入りすぎるような式を無理やり設定しようとすると、実行時エラーが発生します。テンプレートを作成する際は、必ず「どの物理フィールド(Text, Number, Date, Flag)に何を割り当てるか」の設計書(マッピング表)を頭の中に持っておいてください。

まとめ:自動化の先にあるもの

今回紹介した手法は、単に「作業を楽にする」ためのものではありません。
プロジェクト全体における「データの整合性を担保する」ための強力な武器です。

誰がプロジェクトを始めても、同じカスタムフィールド、同じ計算ロジック、同じデータ構造が保証される。これこそが、組織としてのPMO(Project Management Office)の強さの源泉です。

「マクロの記録」のボタンを押す手は、もう止めましょう。
これからは、オブジェクトの構造を理解し、設計図を描く。そんな「アーキテクト」としての道を、共に歩んでいきましょう。

ここをクリアすれば、Project VBAの基本はバッチリですよ。応援しています!

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