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

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

データの「器」を乗り換える技術:カスタムフィールドの型変換を安全に行うプロフェッショナルな手法

こんにちは。Project VBAの世界へようこそ。

マクロの記録機能を使って「あ、これ自動化できそうだな」と感じ始めたあなた。素晴らしい一歩を踏み出しましたね。しかし、プロジェクトが複雑になり、データの管理が本格的になってくると、必ずと言っていいほど一つの「壁」にぶつかります。

それが、「カスタムフィールドのデータ型」の問題です。

「テキスト形式で作ったカスタムフィールドに数字を入れていたけれど、計算に使いたいから数値型に変えたい……」

そう思ったとき、単純に値を書き換えようとしても、Projectは「型が違います」とエラーを吐いたり、あるいは計算式が全く動かなかったりします。実は、Projectにおけるカスタムフィールドの「型」は、一度決まると後から魔法のように変えることはできない「固定された器」なのです。

今日は、そんな「器の不一致」をスマートに、かつ安全に解決するための「データ移行(マイグレーション)戦略」を伝授します。ここをマスターすれば、あなたのVBAスキルは「記録レベル」から「設計レベル」へと一気に駆け上がりますよ。

なぜ、単純な書き換えでは失敗するのか?

まず、エンジニアとしての視点を持っておきましょう。なぜエラーが起きるのか。

Microsoft Projectにおいて、カスタムフィールド(`Text1` や `Number1` など)は、メモリ上に確保されるデータの種類が最初から決まっています。

  • Text型: 文字列として保存される。 `”100″` は「100という文字」であり、「百」という量ではない。
  • Number型: 数値として保存される。 `100` は計算可能な「量」である。

「テキスト型のフィールドに数字を入れても計算できない」のは、プログラムが `”100″` を「数」ではなく「記号の並び」として扱っているからです。また、既存のテキスト型フィールドを、プログラムから無理やり数値型として定義し直すことはできません。

そこで必要になるのが、「新しい器(数値型フィールド)を用意し、古い器から中身を丁寧に移し替える」という手順です。

安全な移行のための3ステップ・プロトコル

データの移行を行う際、最も恐ろしいのは「データの消失」です。書き換えの途中でエラーが起きて、元のデータが消えてしまったら……。そんな事態を防ぐために、以下の3ステップで行います。

1. 退避 (Backup): 現在のテキスト型フィールドの値を、メモリ上(配列やコレクション)に一時的に保存する。
2. 準備 (Prepare): 移行先となる「数値型」のカスタムフィールドが空であることを確認する。
3. 復元 (Restore): メモリに保存した値を、型を変換しながら新しいフィールドへ流し込む。

実践:カスタムフィールド移行スクリプト

それでは、具体的なコードを見ていきましょう。
今回は、「Text1(テキスト型)に入っている数値を、Number1(数値型)へ安全に移行する」というシナリオで作成しました。

Option Explicit

''' <summary>
''' Text1フィールドの数値をNumber1フィールドへ安全に移行する
''' </summary>
Sub SafeMigrateTextToNumber()
    Dim t As Task
    Dim taskCount As Long
    Dim dataStorage As Object
    Set dataStorage = CreateObject("Scripting.Dictionary") ' 値を一時保管する辞書オブジェクト
    
    ' --- STEP 1: データの退避 (Backup) ---
    ' プロジェクト内の全タスクを走査し、Text1の値をメモリに保存します
    On Error Resume Next ' エラーが発生しても中断せず次に進む(空行対策)
    For Each t In ActiveProject.Tasks
        If Not t Is Nothing Then
            ' タスクIDをキーにして、Text1の値を保存
            ' Dictionaryを使うことで、タスクの並び順が変わっても正確に復元できます
            dataStorage.Add t.ID, t.Text1
        End If
    Next t
    On Error GoTo 0 ' エラーハンドリングを元に戻す

    Debug.Print "退避完了: " & dataStorage.Count & " 件のデータを保持しています。"

    ' --- STEP 2: 移行の実行 (Restore & Convert) ---
    ' ここからが本番です。メモリから値を取り出し、型を変換してNumber1へ入れます
    
    Dim currentID As Variant
    Dim rawValue As Variant
    Dim convertedValue As Double
    
    For Each currentID In dataStorage.Keys
        ' タスクオブジェクトを特定
        Set t = ActiveProject.Tasks(currentID)
        
        If Not t Is Nothing Then
            rawValue = dataStorage(currentID)
            
            ' 文字列が空でないか、かつ数値として認識できるかチェック
            If rawValue <> "" And IsNumeric(rawValue) Then
                ' 文字列を数値(Double型)に変換
                convertedValue = CDbl(rawValue)
                
                ' 数値型フィールド(Number1)へ代入
                t.Number1 = convertedValue
                
                ' (オプション) 移行が終わった古いフィールドをクリアする場合
                ' t.Text1 = "" 
            Else
                ' 数値に変換できないデータ(「未定」などの文字)が入っていた場合の処理
                Debug.Print "警告: タスクID " & currentID & " の値 '" & rawValue & "' は数値ではありません。スキップします。"
            End If
        End If
    Next currentID

    MsgBox "移行プロセスが完了しました!" & vbCrLf & _
           "数値に変換できたデータは Number1 に格納されました。", vbInformation, "完了"
End Sub

プロの視点:コードの解説と「落とし穴」

このコードには、単なる「コピペ」以上の、実務で生き残るための知恵を詰め込んでいます。

1. なぜ `Dictionary` を使うのか?

初心者の方は `Collection` を使いがちですが、私は `Scripting.Dictionary` を推奨します。
理由は、「キー(Task.ID)」による管理です。Projectのタスクは、ユーザーが削除したり並べ替えたりすることで、インデックス(番号)がズレることがあります。`ID` をキーにしておけば、どれだけタスクが動いても、正確に「そのタスクのデータ」を戻すことができます。

2. `IsNumeric` 関数による防波堤

ここが最も重要です。テキスト型フィールドには、必ずと言っていいほど `”N/A”` や `”未定”`、あるいは単なる `” “`(スペース)が混入しています。これらを無理に数値に変換しようとすると、VBAは `Type Mismatch` エラーで停止してしまいます。
`IsNumeric` で「これは本当に数字として扱えるか?」を事前に判定することで、プログラムの堅牢性(壊れにくさ)を劇的に高めています。

3. `CDbl` による型変換

`Text1` から取り出した値は、見た目が数字でもプログラム上は `String(文字列)` です。これを `Number1` に入れる際、明示的に `CDbl` (Convert to Double) を使って数値型へキャスト(型変換)しています。これは「型を意識する」というエンジニアの基本動作です。

陥りやすいエラーと対策

最後に、この作業を行う際の注意点をまとめておきます。

  • 空行の存在: Projectのシートには、タスクが存在しない「空の行」が含まれることがあります。`If Not t Is Nothing Then` という一文は、この空行によるエラーを防ぐための、プロの「おまじない」です。
  • バックアップの徹底: スクリプトを実行する前には、必ずプロジェクトファイル自体のコピーを取っておいてください。自動化は強力ですが、一度実行してしまった操作を「Ctrl+Z」で完全に元に戻すことは難しい場合があります。

おわりに

「テキストから数値へ」という一見小さな作業。しかし、その裏側にある「データのライフサイクルを管理する」という考え方は、大規模なシステム開発でも全く同じです。

「ただ動くコード」を書く段階から、「例外(エラー)を想定し、安全にデータを扱うコード」を書く段階へ。
この一歩を踏み出したあなたは、もう立派なProject VBAエンジニアの仲間入りです。

ここをクリアすれば、Project VBAの基本はバッチリですよ。
さあ、次の自動化へ進みましょう!

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