【テクニカル・上級編】【初心者向け】カスタムフィールドのデータ型を誤った際の実行時エラーを回避する型チェック処理 – Project VBA解析バイブル

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

The Ironclad Integrity of Custom Fields: MS Project VBAにおける型不一致の絶対防御

MS Projectを用いた大規模なスケジューリング・システムの構築において、エンジニアが直面する最も忌まわしい事態の一つは、数万行に及ぶタスク・リソース・データのバッチ処理中に、突如として発生する「実行時エラー 13: 型が一致しません」である。

このエラーは、単なるコーディングミスではない。外部システム(ERPやWBS管理ツール)から流入する不完全なデータ、あるいはユーザーの不用意な入力によって、「数値型(Number)として定義されたカスタムフィールドに、文字列(String)が注入される」という、型契約(Type Contract)の破棄によって引き起こされるシステム崩壊の兆候である。

本稿では、レガシーなCOMオブジェクトの挙動を熟知し、極限の堅牢性を求めるシニアエンジニアのために、カスタムフィールドへの代入における「型ガード(Type Guard)」の設計思想と、メモリ管理を含めたアーキテクチャの最適化について詳述する。

1. 脆弱な設計:なぜ「IsNumeric」だけでは足りないのか

多くの開発者は、代入前に `IsNumeric()` 関数を使用することで、この問題を解決したつもりになる。しかし、それは極めて浅薄な防御に過ぎない。

MS Projectのカスタムフィールドは、一度定義されると、そのフィールドが持つ `Type` プロパティ(`pjTaskNumber`, `pjTaskText`, `pjTaskDate` 等)によって、受け入れ可能なデータの性質が厳格に規定されている。

' 脆弱な実装例:これではプロフェッショナルとは呼べない
If IsNumeric(inputValue) Then
    t.CustomFields(1) = inputValue
Else
    ' エラーハンドリングすら不完全
End If

この実装には、以下の致命的な欠陥がある。
1. 文脈の欠如: フィールド自体が「日付型」である場合、`IsNumeric` は無意味である。
2. 境界条件の無視: 空文字 `””` や `Null`、あるいは極端に巨大な数値が、COMインターフェースを介して渡された際の挙動が制御できていない。
3. パフォーマンスの欠如: 大規模ループ内での頻繁な型判定と、エラー発生時のスタックの巻き戻しは、スループットを著しく低下させる。

2. 防御的アーキテクチャ:Type-Safe Assignment パターン

真に堅牢なシステムでは、代入を行う前に「ターゲットとなるフィールドの定義」と「注入しようとするデータの型」を照合するロジックを、抽象化されたレイヤーとして実装する必要がある。

以下に、私が設計する「Type-Safe Assignment」のプロトタイプを示す。ここでは、MS Projectの内部定数に基づき、フィールドの型を判定し、不適合なデータに対しては「静かな失敗(Silent Failure)」ではなく、「構造化されたエラーログ」を生成する設計をとる。

実装:ProjectShield モジュール

Option Explicit

' MS Projectの内部定数を明示的に定義(参照設定がない環境への配慮)
Private Const pjTaskNumber As Long = 1
Private Const pjTaskText As Long = 2
Private Const pjTaskDate As Long = 3

''' <summary>
''' カスタムフィールドへの安全な代入を行う。
''' 型不一致による実行時エラーを未然に防ぎ、ログを記録する。
''' </summary>
''' <param name="targetObj">TaskまたはResourceオブジェクト</param>
''' <param name="fieldIndex">カスタムフィールドのインデックス</param>
''' <param name="value">注入する値</param>
Public Sub SafeAssignCustomField(ByRef targetObj As Object, ByVal fieldIndex As Integer, ByVal value As Variant)
    On Error GoTo ErrorHandler

    Dim targetFieldType As Long
    
    ' 1. フィールドの型を特定(COMオブジェクトのプロパティへのアクセス)
    ' 注意: CustomFields(i) は Variant を返すため、型判定には慎重を期す
    targetFieldType = targetObj.CustomFields(fieldIndex).Type

    ' 2. 型ガード・ロジック
    Select Case targetFieldType
        Case pjTaskNumber
            If IsNumeric(value) And Not IsEmpty(value) Then
                targetObj.CustomFields(fieldIndex) = CDbl(value)
            Else
                RaiseTypeMismatchError fieldIndex, "Numeric", value
            End If

        Case pjTaskText
            ' 文字列型には何でも(空文字含む)代入可能だが、オブジェクト型混入を防ぐ
            If IsError(value) Then
                RaiseTypeMismatchError fieldIndex, "Text", "Error Value"
            Else
                targetObj.CustomFields(fieldIndex) = CStr(value)
            End If

        Case pjTaskDate
            If IsDate(value) Then
                targetObj.CustomFields(fieldIndex) = CDate(value)
            Else
                RaiseTypeMismatchError fieldIndex, "Date", value
            End If

        Case Else
            ' 未知の型、あるいは未定義のフィールドへの対処
            Err.Raise vbObjectError + 513, "SafeAssign", "Unsupported Custom Field Type"
    End Select

    Exit Sub

ErrorHandler:
    ' システム全体の停止を避け、エラーを捕捉してログへ流す
    ' 実際の運用では、ここからDBやテキストファイルへエラーを書き出す
    Debug.Print "Critical Error in Field [" & fieldIndex & "]: " & Err.Description
    ' 必要に応じて、呼び出し元にエラーを再スローするか、継続するかを決定する
End Sub

Private Sub RaiseTypeMismatchError(idx As Integer, expected As String, actual As Variant)
    Dim msg As String
    msg = "Type Mismatch in Field " & idx & ". Expected: " & expected & ", Got: " & CStr(actual)
    Err.Raise vbObjectError + 514, "SafeAssign", msg
End Sub

3. 極限の知見:メモリ管理とWindows APIによる安定化

大規模なデータ処理(数万タスクの更新)を行う際、VBAの最大の敵は「COMオブジェクトの参照カウントの不備によるメモリリーク」である。

`targetObj.CustomFields(fieldIndex)` のようなプロパティへのアクセスは、内部的に新しいオブジェクトのインスタンスを生成し、それを返している場合がある。ループ内でこれらを適切に解放しないと、MS Projectのメモリ使用量は指数関数的に増大し、最終的には `Out of Memory` でクラッシュする。

オブジェクトのライフサイクル管理

ループ内では、必ず明示的にオブジェクトの参照を切り離す(`Set = Nothing`)習慣を徹底せよ。

Dim t As Task
For Each t In ActiveProject.Tasks
    If Not t Is Nothing Then
        ' 処理
        SafeAssignCustomField t, 1, "123.45"
        
        ' 循環参照やメモリ蓄積を防ぐため、ループの終端で明示的に解放
        ' ただし、ActiveProject.Tasksのイテレータを壊さないよう注意が必要
    End If
Next t

Windows APIによるプロセス監視

システム間連携(例えば、外部のC#アプリケーションからMS Projectを操作する場合)において、VBA側がフリーズした際、外部プロセスからその状態を検知するための知見が必要となる。

メモリ使用量の急激な変動を監視するために、Windows APIを用いてプロセスのワーキングセット(Working Set)を取得し、閾値を超えた場合に処理を中断する「セーフティ・ブレーカー」の実装は、エンタープライズ級の自動化ツールには必須の機能である。

' Windows APIの宣言

If VBA7 Then

Declare PtrSafe Function GetProcessMemoryInfo Lib "psapi.dll" ( _ ByVal hProcess As LongPtr, _ lpWorkingSetX As PROCESS_MEMORY_COUNTERS, _ ByVal cb As Long) As Long Type PROCESS_MEMORY_COUNTERS cb As Long PageFaultCount As Long PeakWorkingSetSize As LongPtr WorkingSetSize As LongPtr ' ... (以下略) End Type

Else

' レガシー環境用の宣言

End If

結論:アーキテクトの責務

カスタムフィールドの操作は、一見すると単純な代入作業に見える。しかし、その背後にはCOMインターフェースの複雑な挙動と、データの整合性という重い責任が隠れている。

1. 型契約を疑え: 入力値が正しいと信じるな。常に `Type` プロパティに基づいた検証を行え。
2. 防御層を分離せよ: ビジネスロジックの中に型チェックを混ぜるな。`SafeAssign` のような専用のガード層を構築せよ。
3. リソースを統治せよ: 大規模処理においては、メモリのライフサイクルを完全に制御下に置け。

これらを守ることで初めて、あなたの構築したシステムは、レガシーな環境においても、過酷な運用フェーズにおいても、揺るぎない信頼性を獲得するのだ。

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