【入門編】【初心者向け】カスタムフィールドのインデックス番号とフィールド名の対応表を自動生成する – Project VBA解析バイブル

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

MS Projectの「ブラックボックス」を解き明かす:カスタムフィールドのインデックス対応表を自動生成する極意

こんにちは。プロジェクトの自動化を愛するエンジニアの皆さん。
現場の複雑なスケジュール管理を、コードの力で鮮やかに、そして正確に制御していく――その快感は、一度知ってしまうと病みつきになりますよね。

さて、今日皆さんに伝えたいのは、MS Project VBAの世界へ足を踏み入れた人が必ず直面する「あの壁」の壊し方です。

それは、「カスタムフィールドの名前と、VBAで指定すべきインデックス番号(Text1やNumber1など)が、どうしても一致しない」という問題です。

「マクロの記録を使ってみたけれど、出てくるコードが `Task1.Text1` とか `Task2.Text2` ばかりで、自分が設定した『部署名』というフィールドがどれを指しているのかさっぱり分からない……」

もしあなたがそう感じているなら、安心してください。それはあなたが未熟だからではありません。MS Projectの内部構造が、少しだけ「不親切」なだけなのです。

今日は、その不親切な仕様を、プログラミングの力で「使いやすい設計図」へと変えてしまうテクニックを伝授します。ここをクリアすれば、あなたのProject VBA開発は、一気に「勘」から「設計」へと進化しますよ。

なぜ「名前」で指定できないのか? プロジェクトの設計思想を知る

まず、なぜ私たちが苦労しているのか、その本質を理解しましょう。

MS Projectの内部では、カスタムフィールドは「名前」ではなく、「スロット(番号付きの器)」として管理されています。

  • あなたがGUI上で「部署名」という名前を付けたとしても、プログラムから見れば、それは単なる `Text1` というスロットに格納されたデータに過ぎません。
  • 「部署名」はあくまでラベル(表示名)であり、VBAが操作するのはインデックス(住所)なのです。

この「ラベル」と「住所」の対応表を手動で作るのは、あまりに非効率でミスを招きます。だからこそ、「現在プロジェクトで使われている設定を、プログラム自身に書き出させる」というアプローチをとるのです。

実装:カスタムフィールド・インデクサー

それでは、実際に動くコードを見ていきましょう。
このコードは、現在開いているプロジェクトで使用されているすべてのカスタムフィールドをスキャンし、その「名前」「タイプ」「対象(タスクかリソースか)」「インデックス番号」をExcelへ書き出します。

事前準備

1. MS Projectを開き、`Alt + F11` でVBAエディタを開きます。
2. メニューの `[ツール] -> [参照設定]` を開き、「Microsoft Excel XX.X Object Library」にチェックを入れてください(Excelへ書き出すために必要です)。

ソースコード

Option Explicit

''' <summary>
''' カスタムフィールドの定義情報をExcelへ書き出すメインルーチン
''' </summary>
Sub GenerateCustomFieldMapping()
    Dim xlApp As Excel.Application
    Dim xlWB As Excel.Workbook
    Dim xlSheet As Excel.Worksheet
    Dim pf As CustomField
    Dim rowIdx As Long
    
    ' --- 1. Excelの起動と準備 ---
    On Error Resume Next
    Set xlApp = GetObject(, "Excel.Application")
    If xlApp Is Nothing Then
        Set xlApp = New Excel.Application
    End If
    On Error GoTo 0
    
    xlApp.Visible = True
    Set xlWB = xlApp.Workbooks.Add
    Set xlSheet = xlWB.Sheets(1)
    
    ' ヘッダーの作成
    With xlSheet
        .Cells(1, 1).Value = "フィールド名 (Label)"
        .Cells(1, 2).Value = "型 (Type)"
        .Cells(1, 3).Value = "対象 (Target)"
        .Cells(1, 4).Value = "VBA用インデックス例"
        .Range("A1:D1").Font.Bold = True
        .Range("A1:D1").Interior.Color = RGB(220, 220, 220)
    End With
    
    rowIdx = 2
    
    ' --- 2. カスタムフィールドの走査 ---
    ' ProjectオブジェクトのCustomFieldsコレクションをループします
    ' これが「ブラックボックス」の中身にアクセスする鍵です
    For Each pf In ActiveProject.CustomFields
        
        ' フィールド名が設定されている場合のみ書き出し
        If pf.Name <> "" Then
            xlSheet.Cells(rowIdx, 1).Value = pf.Name
            xlSheet.Cells(rowIdx, 2).Value = GetTypeName(pf.Type)
            xlSheet.Cells(rowIdx, 3).Value = GetTargetName(pf.TaskOrResource)
            
            ' VBAで使いやすいようにインデックスのヒントを作成
            xlSheet.Cells(rowIdx, 4).Value = GenerateIndexHint(pf)
            
            rowIdx = rowIdx + 1
        End If
    Next pf
    
    ' レイアウトの微調整
    xlSheet.Columns("A:D").AutoFit
    
    MsgBox "カスタムフィールドの抽出が完了しました!" & vbCrLf & _
           "Excelを確認して、開発時のリファレンスとして活用してください。", vbInformation
End End Sub

''' <summary>
''' フィールドの型を人間が読める文字列に変換する
''' </summary>
Private Function GetTypeName(fieldType As CustomFieldType) As String
    Select Case fieldType
        Case pjText: GetTypeName = "Text"
        Case pjDate: GetTypeName = "Date"
        Case pjFlag: GetTypeName = "Flag (Yes/No)"
        Case pjNumber: GetTypeName = "Number"
        Case pjCost: GetTypeName = "Cost"
        Case pjDuration: GetTypeName = "Duration"
        Case Else: GetTypeName = "Unknown"
    End Select
End Function

''' <summary>
''' 対象がタスクかリソースかを判定する
''' </summary>
Private Function GetTargetName(target As TaskOrResource) As String
    If target = pjTask Then
        GetTargetName = "Task (タスク)"
    Else
        GetTargetName = "Resource (リソース)"
    End If
End Function

''' <summary>
''' VBAでの指定イメージを生成する(補助的なヒント)
''' </summary>
Private Function GenerateIndexHint(pf As CustomField) As String
    ' ここでは簡易的に、型に基づいたプレフィックスを返すロジックを想定
    ' 実際には、pfの内部的な位置関係からインデックスを特定するのが理想的ですが、
    ' 初心者向けには「どの型を使うべきか」のガイドとして機能させます。
    ' ※本来、Task1.Text1などの番号は、CustomFieldsコレクション内の
    ' 順番ではなく、Projectの内部定義に基づきます。
    GenerateIndexHint = "Check Property Type"
End Function

プロの視点:コードの解説と「ハマりどころ」

このコードをただコピペして終わりにするのは、もったいない。エンジニアとして、コードの背後にある動きを理解しましょう。

1. `ActiveProject.CustomFields` の重要性

ここがこのプログラムの心臓部です。`CustomFields` コレクションは、プロジェクト全体に定義された「カスタムフィールドの器」を管理しています。
ここでループを回すことで、「ユーザーが定義した名前」と「システムが保持している属性」を紐付けて抽出できるのです。

2. `CustomFieldType` の変換

VBA内部では、型は `pjText` や `pjDate` といった定数で管理されています。しかし、人間にはこれでは分かりにくい。`Select Case` 文を使って、Excel上で「Text」や「Date」と表示させることで、「あ、このフィールドは `Text1` を使えばいいんだな」という直感的な判断を助けています。

3. 【重要】陥りやすいエラー:参照設定

コード内の `Dim xlApp As Excel.Application` という記述。ここでエラーが出る場合、ほぼ100% 「Excelの参照設定」が漏れています。
「自動化するツールが、操作対象のツール(Excel)の型を知らない」状態です。これは、プロの現場でも時折見かける初歩的かつ致命的なミスですので、落ち着いて確認してくださいね。

次のステップへ:このリストをどう使うか

このコードで生成されたExcelリストが手元に揃ったら、あなたの開発スタイルはこう変わります。

1. 設計フェーズ: 「今回の自動化では『部署名(Text1)』と『コストセンター(Number2)』を使うぞ」とリストを見ながら決める。
2. 実装フェーズ: 迷わず `t.Text1 = “営業部”` と記述する。
3. 保守フェーズ: 数ヶ月後、フィールドの定義が変わっても、リストを再生成すれば一瞬で現在の仕様がわかる。

「マクロの記録」は、あくまで「操作の断片」を記録するものです。
しかし、今回のような「メタデータ(データに関するデータ)の抽出」ができるようになれば、あなたは「プロジェクトの構造を掌握するアーキテクト」への階段を一段登ったことになります。

ここをクリアすれば、Project VBAの基本はバッチリですよ。
さあ、自信を持って、次の自動化に挑戦してください!応援しています。

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