「型」の不一致でツールを死なせるな。MS Project VBAにおける堅牢なカスタムフィールド制御術
業務自動化の現場において、ツールが「動く」ことと「信頼に足る」ことの間には、深くて暗い川が流れている。
MS Projectのカスタマイズにおいて、TaskやResourceのカスタムフィールド(`Number1`〜`Number30`、`Text1`〜`Text30`など)を操作するコードを書く際、多くの開発者が陥る罠がある。それは、「外部データ(ExcelやCSV、DB)から取得した値を、検証なしにそのままカスタムフィールドへ流し込む」という、あまりにも無防備な設計だ。
もし、数値型(Number)として定義したフィールドに、たった一行「N/A」という文字列が混入しただけで、君の書いた数千行の自動化プログラムは即座に停止し、実行時エラー(Type Mismatch)を吐いて絶命する。
今日は、そんな「素人レベルのコード」を脱却し、プロフェッショナルとして、どのようなデータが来ようとも沈黙を守り、正確に処理を完遂させるための「型安全なカスタムフィールド制御」の極意を伝授する。
1. なぜ、君のコードは「脆い」のか
まず、設計思想の欠如を指摘しておこう。
一般的なExcel VBAの感覚で、「セルの中身をそのままTask.Number1に代入する」というコードを書くのは、地雷原を全速力で走るようなものだ。MS Projectのカスタムフィールドは、Excelのような「なんでも入る柔軟なセル」ではない。厳格なデータベース・スキーマに近い性質を持っている。
エラーの発生メカニズム
1. データソースの不純物: ExcelやCSVでは、数値列に「未定」や「空文字(””)」、あるいは「1,000(カンマ付き文字列)」が混入することが日常茶飯事だ。
2. 暗黙の型変換の失敗: VBAは柔軟な言語だが、MS Projectのオブジェクトモデルへ値を渡す際、期待される型と異なるデータが渡されると、VBAエンジンは即座に処理を中断する。
3. エラーハンドリングの誤用: `On Error Resume Next` で無理やりエラーを無視して進める手法があるが、これは最悪の選択だ。データの欠落に気づけず、間違ったプロジェクト管理データが生成される原因となる。
「エラーを無視する」のではなく、「エラーが起きないようにデータを浄化(Sanitize)してから渡す」。これがアーキテクトの思考だ。
2. 堅牢な設計思想:Sanitization Layer(浄化層)の導入
プロフェッショナルのコードには、必ず「入力値の検証」と「変換」を担う専用のレイヤーが存在する。
カスタムフィールドへの代入を直接行うのではなく、「安全な代入用ラッパー関数」を介して操作する設計に切り替えろ。これにより、ロジック部分(何を計算するか)と、データ整合性部分(どう型を守るか)を分離できる。
実装すべき3つの原則
1. Pre-validation(事前検証): 代入前に、その値がターゲットの型として妥当かを判定する。
2. Default Value Strategy(デフォルト値戦略): 型が不適合だった場合、エラーにするのではなく、あらかじめ定義した「安全な値(0や空文字)」に置換する。
3. Logging(ログ記録): どのタスクのどの値が原因で変換が行われたかを記録し、後から調査可能にする。
3. プロダクション・レディな実装例
以下に、実務でそのまま使えるレベルの、堅牢な型チェック付き代入モジュールを示す。これをプロジェクトの共通モジュールとして組み込め。
Option Explicit
' ==============================================================================
' Module: CustomFieldManager
' Description: MS Projectのカスタムフィールドへの安全なデータ書き込みを行う
' ==============================================================================
''' <summary>
''' 数値型カスタムフィールドへ安全に値を代入する
''' </summary>
''' <param name="targetTask">対象のTaskオブジェクト</param>
''' <param name="fieldIndex">Number1〜Number30のインデックス</param>
''' <param name="rawValue">代入したい生データ(Variant型)</param>
Public Sub SafeAssignNumber(ByRef targetTask As MSProject.Task, _
ByVal fieldIndex As Integer, _
ByVal rawValue As Variant)
Dim cleanValue As Double
Dim fieldName As String
' フィールド名の動的生成 (例: Number1, Number2...)
fieldName = "Number" & fieldIndex
' 1. 型チェックと浄化
' IsNumericで数値として解釈可能か判定。NullやEmpty、文字列もここで弾く。
If IsNumeric(rawValue) Then
cleanValue = CDbl(rawValue)
Else
' 数値でない場合は、ログを出力(Debug.Printは実務ではログファイル出力に置き換え)
Debug.Print "[WARNING] Type Mismatch: Task '" & targetTask.Name & _
"' | Field: " & fieldName & " | Invalid Value: " & CStr(rawValue) & _
" | Defaulting to 0"
cleanValue = 0 ' 業務ルールに基づいたデフォルト値を設定
End If
' 2. 安全な代入
' CallByNameを使用することで、フィールド名を文字列で動的に指定可能にする
On Error GoTo ErrorHandler
CallByName targetTask, fieldName, VbLet, cleanValue
Exit Sub
ErrorHandler:
Debug.Print "[CRITICAL] Assignment Failed: Task '" & targetTask.Name & _
"' | Field: " & fieldName & " | Error: " & Err.Description
End Sub
''' <summary>
''' 日付型カスタムフィールドへ安全に値を代入する
''' </summary>
''' <param name="targetTask">対象のTaskオブジェクト</param>
''' <param name="fieldIndex">Date1〜Date30のインデックス</param>
''' <param name="rawValue">代入したい生データ</param>
Public Sub SafeAssignDate(ByRef targetTask As MSProject.Task, _
ByVal fieldIndex As Integer, _
ByVal rawValue As Variant)
Dim cleanDate As Variant
Dim fieldName As String
fieldName = "Date" & fieldIndex
' 1. 日付としての妥当性を検証
If IsDate(rawValue) Then
cleanDate = CDate(rawValue)
Else
Debug.Print "[WARNING] Date Mismatch: Task '" & targetTask.Name & _
"' | Field: " & fieldName & " | Invalid Value: " & CStr(rawValue) & _
" | Defaulting to Empty"
cleanDate = Empty ' 日付型の場合はEmptyを代入して「未入力」状態にする
End If
' 2. 代入
On Error GoTo ErrorHandler
CallByName targetTask, fieldName, VbLet, cleanDate
Exit Sub
ErrorHandler:
Debug.Print "[CRITICAL] Date Assignment Failed: Task '" & targetTask.Name & _
"' | Field: " & fieldName & " | Error: " & Err.Description
End Sub
' ==============================================================================
' メイン実行ルーチン(使用例)
' ==============================================================================
Sub Sample_RobustProcess()
Dim t As MSProject.Task
Dim mockData As Variant
Dim i As Integer
' テスト用の汚れたデータセット(Excelから読み込んだと想定)
' 1:正常, 2:文字列混入, 3:空文字, 4:日付不正
mockData = Array(150, "Error_Value", "", "Invalid_Date")
For Each t In ActiveProject.Tasks
If Not t Is Nothing Then
' Number1 フィールドへの安全な代入
' ループのインデックスに合わせてテストデータを流し込む
i = (i Mod 4)
SafeAssignNumber t, 1, mockData(i)
' Date1 フィールドへの安全な代入
SafeAssignDate t, 1, mockData(i)
i = i + 1
End If
Next t
MsgBox "処理が完了しました。詳細はイミディエイトウィンドウを確認してください。", vbInformation
End Sub
4. アーキテクトの視点:パフォーマンスと拡張性
このコードを単なる「エラー回避術」だと思ったら大間違いだ。ここには高度な設計判断が組み込まれている。
CallByName の活用
`targetTask.Number1 = value` と直接書くのではなく、`CallByName` を使用している。これは、フィールド番号を引数(`fieldIndex`)として受け取り、動的にプロパティへアクセスするためだ。これにより、コードの重複を排除し、メンテナンス性を劇的に向上させている。
外部連携時の注意点(Database/CSV)
CSVやデータベースからデータを読み込む際、多くのライブラリは値を `String` として返してくる。
「数値が入っているはずだから `CDbl()` すればいい」という考えは捨てろ。
必ず、上記のような 「検証(IsNumeric/IsDate)→ 浄化(Default Value)→ 代入(CallByName)」 というパイプラインを通す設計にしろ。
パフォーマンスへの影響
「型チェックをループ内で行うと遅くなるのでは?」という懸念を持つ者がいる。
確かに、単純な代入に比べればオーバーヘッドはある。しかし、「エラーが発生してプロセスが止まるコスト」や「間違ったデータでプロジェクト管理が崩壊するコスト」に比べれば、微々たるものだ。 堅牢性を優先すべき局面では、この程度のコストは「保険料」として正当化される。
結論
優れたエンジニアは、コードが「正しく動く時」のことだけを考えていない。「データが汚れている時」にどう振る舞うかを設計している。
カスタムフィールドへの代入は、一見単純な作業に見える。しかし、そこに「型」という概念を正しく組み込むことで、君のツールは「ただのスクリプト」から、プロフェッショナルが安心して使える「業務基盤」へと昇華するのだ。
諸君のコードが、いかなる不純物にも屈しない堅牢なものであることを期待している。
