【実務・中級編】【初心者向け】カスタムフィールドのデータ型を「テキスト」から「数値」へ一括変換する際の安全な移行手順 – Project VBA解析バイブル

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

【極限の知見】MS Project VBAにおけるカスタムフィールド型移行の設計思想:データ整合性を死守する「スナップショット・マイグレーション」

MS Projectを用いた高度なプロジェクト管理ツールを構築していると、必ずと言っていいほど直面する「設計上の誤算」がある。それは、「カスタムフィールドのデータ型変更」だ。

「運用が始まってから、計算のためにテキスト型のフィールドを数値型に変えたい」
「数式(Formula)を使いたいが、現在のフィールドがテキスト型なのでエラーが出る」

こうした要求に対し、安易に `Val()` 関数を数式に埋め込んで誤魔化そうとする者は、いずれプロジェクトの崩壊を招く。型変換の不一致は、計算精度の低下、予期せぬゼロ値の混入、そして何より「データの意味が変わってしまう」という致命的なバグを引き起こすからだ。

本稿では、単なる「値のコピー」ではない。オブジェクトのライフサイクルとデータ整合性を完全に制御する、プロフェッショナルによる「スナップショット・マイグレーション」の手法を伝授する。

1. なぜ「その場しのぎの変換」はプロの仕事ではないのか

初心者は、テキスト型のフィールドに対して `[Text1] * 1.1` のような、暗黙の型変換に頼った数式を書きがちだ。しかし、これは設計として極めて脆弱である。

暗黙の型変換(Implicit Conversion)のリスク

1. 非決定的な挙動: `Text1` に `”100 “`(末尾にスペース)や `”1,000″`(カンマ入り)が入っていた場合、VBAの型変換エンジンが期待通りに動作する保証はない。
2. エラーの隠蔽: 数値として解釈できない文字列(例: `”TBD”`)が混入した場合、`Val()` はエラーを出さずに `0` を返す。これは「データがない」のか「値がゼロ」なのかの区別を失わせ、プロジェクトの進捗管理に致命的な誤認を生む。
3. パフォーマンスの低下: 大規模なプロジェクト(数千タスク)において、数式内での頻繁な型変換は、再計算エンジンに過剰な負荷をかける。

アーキテクトの結論:
データ型は「定義(Schema)」である。定義が間違っているなら、値を一度メモリ上に退避させ、フィールドの役割を再定義(別の数値型フィールドへ移行)した上で、厳格なバリデーションを経て値を戻すべきである。

2. 堅牢な移行戦略:スナップショット・マイグレーション

安全な移行には、以下の4つのフェーズが必要である。

1. Extraction(抽出): 現行のテキストデータを、タスクIDと紐付けてメモリ(Dictionaryオブジェクト)に格納する。
2. Validation(検証): 抽出したデータが、本当に数値として妥当かを厳密にチェックする。
3. Purge & Re-definition(浄化と再定義): 既存のテキストフィールドをクリアし、ターゲットとなる数値型フィールド(Number1など)へ移行する準備を整える。
4. Injection(注入): 検証済みの数値のみを、ターゲットフィールドへ書き戻す。

3. プロダクション・コード例

以下に、Taskカスタムフィールドの移行を実現する、実務レベルの堅牢なコードを示す。ここでは `Text1`(移行元)から `Number1`(移行先)への移行を想定している。

Option Explicit

''' <summary>
''' カスタムフィールドのデータ型移行(Text -> Number)を安全に実行する
''' </summary>
''' <param name="sourceField">移行元のフィールド名 (例: "Text1")</param>
''' <param name="targetField">移行先のフィールド名 (例: "Number1")</param>
Public Sub MigrateTextToNumberField(ByVal sourceField As String, ByVal targetField As String)
    Dim t As Task
    Dim dict As Object
    Set dict = CreateObject("Scripting.Dictionary")
    
    Dim errCount As Long: errCount = 0
    Dim successCount As Long: successCount = 0
    Dim invalidValue As String
    
    ' 1. 高速化のための設定
    On Error GoTo ErrorHandler
    Application.ScreenUpdating = False
    Application.Calculation = pjCalculationManual ' 再計算を停止してパフォーマンスを確保
    
    Debug.Print "--- Migration Started ---"

    ' 2. Extraction & Validation (抽出と検証)
    ' タスクIDをキー、数値を値としてDictionaryに格納する
    For Each t In ActiveProject.Tasks
        If Not t Is Nothing Then
            ' フィールドの値を取得
            Dim rawValue As String
            rawValue = t.GetField(sourceField)
            
            If rawValue <> "" Then
                ' 数値として妥当か厳格にチェック
                If IsNumeric(rawValue) Then
                    ' DictionaryにタスクIDと数値を保持
                    dict.Add t.ID, CDbl(rawValue)
                Else
                    ' 不正な値はログに記録し、スキップ
                    Debug.Print "Validation Error: TaskID=" & t.ID & " Value='" & rawValue & "' is not numeric."
                    errCount = errCount + 1
                End If
            End If
        End If
    Next t

    ' 3. Purge (既存データのクリア)
    ' 移行ミスを防ぐため、移行先に古いデータが残らないよう一旦クリアする設計思想
    For Each t In ActiveProject.Tasks
        If Not t Is Nothing Then
            t.SetField targetField, 0
        End If
    Next t

    ' 4. Injection (注入)
    ' メモリ上のDictionaryから、検証済みの値を一括注入
    Dim key As Variant
    For Each key In dict.Keys
        Set t = GetTaskByID(CLng(key))
        If Not t Is Nothing Then
            t.SetField targetField, dict(key)
            successCount = successCount + 1
        End If
    Next key

    ' 5. Cleanup & Reporting
    Application.Calculation = pjCalculationAutomatic
    Application.ScreenUpdating = True
    
    MsgBox "移行完了" & vbCrLf & _
           "成功: " & successCount & " 件" & vbCrLf & _
           "エラー(スキップ): " & errCount & " 件" & vbCrLf & _
           "※エラー値はImmedate Windowを確認してください。", vbInformation

    Debug.Print "--- Migration Completed ---"
    Debug.Print "Success: " & successCount
    Debug.Print "Errors: " & errCount
    Exit Sub

ErrorHandler:
    Application.Calculation = pjCalculationAutomatic
    Application.ScreenUpdating = True
    MsgBox "致命的なエラーが発生しました: " & Err.Description, vbCritical
    Debug.Print "Critical Error: " & Err.Description
End Sub

''' <summary>
''' タスクIDからTaskオブジェクトを高速に取得するためのヘルパー
''' </summary>
Private Function GetTaskByID(ByVal taskID As Long) As Task
    On Error Resume Next
    Set GetTaskByID = ActiveProject.Tasks(taskID)
    On Error GoTo 0
End Function

4. アーキテクトによる設計の要諦

このコードが、なぜ「単なるコピペ」を超えたのか。その設計思想を解説する。

① 処理の原子性(Atomicity)への配慮

`Application.Calculation = pjCalculationManual` を冒頭で宣言している。これは単なる高速化ではない。データ移行中に、不完全な状態のデータに対して数式が走り、プロジェクト全体の計算結果が汚染されるのを防ぐための「隔離」である。

② Dictionaryオブジェクトによるメモリ管理

タスクオブジェクトをループの中で何度も検索するのは、計算量 $O(n^2)$ の罠に陥る。本コードでは、最初に `Dictionary` に `TaskID` をキーとして値を格納することで、注入フェーズの探索コストを最小化している。

③ 厳格なバリデーション(IsNumericの重要性)

`Val()` 関数を使わず、`IsNumeric()` を用いて「数値として解釈可能か」を事前に判定している。これにより、”100円” や “N/A” といったゴミデータが数値フィールドに混入して、後続の計算プロセスを破壊することを防いでいる。

④ 外部連携(DB/ファイル)への拡張性

もしこのデータをExcelやSQL Serverから読み込む場合、この構造はそのまま転用できる。

  • `Extraction` フェーズを `Excel.Application` からの読み込みに置き換える。
  • `Validation` をSQLのデータ型チェックに置き換える。

この「分離された設計」こそが、保守性の高いツールの条件である。

結論

カスタムフィールドの型変更は、単なる「見た目の変更」ではなく、「データモデルの再定義」である。

エンジニアとして、常に「もしここに不正なデータが入ってきたら、システムはどう振る舞うべきか?」を自問し続けなさい。妥協した型変換は、いつか必ず、プロジェクトの信頼性を損なう形で牙を剥く。この「スナップショット・マイグレーション」の手法を、あなたの武器として加えてほしい。

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