【MS Project VBA】「Text1」の正体を見極めろ:カスタムフィールド定義の自動抽出アーキテクチャ
「`Task.Text1` に値を書き込んでおいたから、後で確認してくれ」
もしあなたが、プロジェクトのリーダーやクライアントからこのような依頼を受け、あるいは自分自身でコードを書き始めたなら、その瞬間からあなたは「技術的負債」という名の地雷原に足を踏み入れている。
MS Projectにおけるカスタムフィールド(Text1, Number1, Date1…)は、極めて強力だが、同時に極めて「不透明」だ。ユーザーがGUI上で「プロジェクト責任者名」と名前を付けたとしても、VBAのオブジェクトモデル上では、それは依然として無機質な `Text1` でしかない。
この「名前(表示名)」と「インデックス(内部名)」の乖離を、設計書もなしに「勘」で解決しようとする者は、必ず開発の終盤で、どのフィールドが何を指しているのか分からなくなり、コードの全面的な書き直しという末期症状に陥る。
本記事では、プロフェッショナルとして、この問題を未然に防ぐための「カスタムフィールド・マッピング・ジェネレーター」の設計と実装を伝授する。
1. なぜ「手動確認」は悪なのか:設計思想の転換
初心者は、Projectの画面を開き、列を一つずつ右クリックして「フィールドの定義」を確認する。これは「作業」であって「エンジニアリング」ではない。
脆弱な設計(アンチパターン)
- マジックナンバーの乱用: `Task.Text1` が何を指すか、コメントすら書かずに実装する。
- 暗黙の前提: 「このプロジェクトではText1は必ず『部門名』である」という、環境に依存した前提でコードを書く。
- 保守性の欠如: ユーザーがフィールド名を変更した瞬間、プログラムの意図が完全に消失する。
堅牢な設計(アーキテクチャ)
- Discovery(発見)の自動化: フィールド定義を「コードの外部(Excel等)」にエクスポートし、それを「正解のマスターデータ」として扱う。
- Late Bindingの活用: 実行環境のExcelバージョンに依存せず、配布可能なツールにする。
- 単一責任の原則: 「情報を抽出する機能」と「ロジックを実行する機能」を分離する。
2. 実装:カスタムフィールド・マッピング・ジェネレーター
以下に、現在使用可能なすべてのカスタムフィールド(TaskおよびResource)のインデックス、表示名、データ型をExcelへ一括書き出しする、プロダクションレベルのコードを示す。
このコードは、単に値を出すだけではない。「エラーハンドリング」「Late Binding」「高速化のための描画停止」といった、実務で動かすための作法をすべて組み込んでいる。
Option Explicit
' ==============================================================================
' Module: modFieldDiscovery
' Description: MS Projectのカスタムフィールド定義をExcelへ書き出す
' Author: Legendary Chief Architect
' ==============================================================================
Public Sub ExportCustomFieldMapping()
Dim xlApp As Object
Dim xlWB As Object
Dim xlWS As Object
Dim pf As Object ' MS Project.CustomField
Dim rowIdx As Long
Dim startTime As Double
' 実行時間の計測(パフォーマンス意識)
startTime = Timer
On Error GoTo ErrorHandler
' 1. Excelの起動 (Late Binding: 参照設定なしで動作させる)
' 実行環境のExcelバージョンに依存しない堅牢な設計
Set xlApp = CreateObject("Excel.Application")
xlApp.Visible = True
Set xlWB = xlApp.Workbooks.Add
Set xlWS = xlWB.Sheets(1)
' 2. ヘッダーの作成
With xlWS
.Cells(1, 1).Value = "Field Index (Internal)"
.Cells(1, 2).Value = "Custom Field Name (Display)"
.Cells(1, 3).Value = "Field Type"
.Cells(1, 4).Value = "Usage (Task/Resource)"
.Range("A1:D1").Font.Bold = True
.Range("A1:D1").Interior.Color = RGB(220, 220, 220)
End With
rowIdx = 2
' 3. カスタムフィールドの反復処理
' Application.CustomFields コレクションを走査する
' これにより、GUIで定義された全てのカスタム設定を取得可能
For Each pf In Application.CustomFields
xlWS.Cells(rowIdx, 1).Value = pf.Name ' 例: "Text1"
xlWS.Cells(rowIdx, 2).Value = pf.CustomTypeName ' ユーザーが付けた名前
xlWS.Cells(rowIdx, 3).Value = GetFieldTypeString(pf.Type)
' Task用かResource用かを判定
Dim usage As String
usage = ""
If pf.TaskType Then usage = usage & "Task "
If pf.ResourceType Then usage = usage & "Resource"
xlWS.Cells(rowIdx, 4).Value = Trim(usage)
rowIdx = rowIdx + 1
Next pf
' 4. 書式設定の仕上げ
xlWS.Columns("A:D").AutoFit
MsgBox "抽出完了。" & vbCrLf & _
"処理時間: " & Round(Timer - startTime, 2) & " 秒", vbInformation
CleanUp:
Set pf = Nothing
Set xlWS = Nothing
Set xlWB = Nothing
Set xlApp = Nothing
Exit Sub
ErrorHandler:
MsgBox "致命的なエラーが発生しました。" & vbCrLf & _
"Error Number: " & Err.Number & vbCrLf & _
"Description: " & Err.Description, vbCritical
Resume CleanUp
End Sub
' ==============================================================================
' Function: GetFieldTypeString
' Description: 列挙型の数値を読みやすい文字列に変換する
' ==============================================================================
Private Function GetFieldTypeString(ByVal fieldType As Long) As String
' MS Projectの内部定数に基づいた変換
' ※ プロダクションコードでは、マジックナンバーを直接使わず、
' 意味のある文字列に変換して保守性を高める
Select Case fieldType
Case 0: GetFieldTypeString = "Text"
Case 1: GetFieldTypeString = "Number"
Case 2: GetFieldTypeString = "Flag"
Case 3: GetFieldTypeString = "Date"
Case 4: GetFieldTypeString = "Cost"
Case 5: GetFieldTypeString = "Duration"
Case Else: GetFieldTypeString = "Unknown (" & fieldType & ")"
End Select
End Function
3. プロフェッショナルが教える「コードの読み解き方」
このコードをただコピペするだけでは、あなたはエンジニアになれない。なぜこのように書いたのか、その意図を理解せよ。
① Late Binding(遅延結合)の徹底
`Dim xlApp As Excel.Application` と書けば、実行時に「Microsoft Excel Object Library が見つかりません」というエラーで死ぬ。これは、開発者のPCと利用者のPCでExcelのバージョンが異なる場合に起こる典型的な失敗だ。`CreateObject(“Excel.Application”)` を使うことで、実行環境に存在するExcelを動的に呼び出す。これが「配布可能なツール」の条件だ。
② データの「型」への配慮
`pf.Type` は整数値を返すが、そのままExcelに出力しても意味がない。`GetFieldTypeString` という専用の変換関数を介することで、人間が読める形式(Text, Number等)に変換している。これは、生成されたリストを後続のドキュメントや仕様書として再利用するための、データ品質へのこだわりだ。
③ 複雑な条件の正規化
カスタムフィールドは、Taskにしか使えないもの、Resourceにしか使えないもの、あるいは両方に使えるものがある。`pf.TaskType` と `pf.ResourceType` を判定し、一つのセルに集約して出力することで、開発者は「このフィールドをどのオブジェクトに対して操作すべきか」を一目で判断できる。
4. 実務への応用:このリストをどう使うか
生成されたExcelシートは、単なるメモではない。プロジェクトの「データ辞書(Data Dictionary)」として機能させるべきだ。
1. 開発用仕様書への組み込み:
VBAコード内で `Task.Text1` を使う場合、必ずコメント欄に `// Text1: [部門名] (Field Mapping Sheet Ref: Row 12)` と記述せよ。
2. バリデーションロジックの構築:
もし「Text1には必ず『株式会社』を含める」というルールがあるなら、このリストを元に、「どのフィールドが対象か」を動的に判別するコードを書くことも可能になる。
3. ユーザーへの説明責任:
「このツールは、Excelの〇行目に定義されている『コストセンター』フィールドを参照しています」と、根拠を持ってユーザーに説明できる。
結論
MS Project VBAにおけるカスタムフィールドの扱いは、「いかに不透明なものを、透明にするか」という戦いだ。
インデックス番号と名前の対応表を自動生成する。この一見小さな仕組みこそが、大規模プロジェクトにおけるバグを未然に防ぎ、保守コストを劇的に下げる「アーキテクチャの第一歩」となる。
「動けばいい」という考えを捨てろ。設計に魂を込めろ。
