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

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

「型違い」の恐怖を克服せよ:Project VBAでカスタムフィールドを安全に操作する極意

「マクロの記録」を使って、一歩ずつ自動化の階段を登っている皆さん、こんにちは。

マクロの記録は、素晴らしい第一歩です。しかし、記録されたコードを眺めていると、ふと「このコード、もし入力データが空っぽだったら?」「もし数字を入れるべき場所に『未定』なんて文字が入っていたら?」と不安になることはありませんか?

実は、そこが「マクロの記録レベル」から「エンジニアリングレベル」へと脱皮する最大の分岐点なのです。

今日は、多くの初学者が必ずと言っていいほどぶつかる壁、「実行時エラー ’13’: 型が一致しません (Type Mismatch)」を、スマートに、そしてエレガントに回避する方法を伝授します。ここをクリアすれば、あなたのProject VBAは、格段に「壊れにくい、プロの道具」へと進化しますよ。

1. なぜ、MS Projectは「型」に厳しいのか?

Excelを触っていると、セルに数字を書いても文字を書いても、なんとなく動いてしまいますよね。しかし、Microsoft Projectの世界は少し違います。Projectは「厳格なデータベース」のような性質を持っています。

特にカスタムフィールド(TaskやResourceに自分で追加した項目)には、あらかじめ「設計図(データ型)」が決まっています。

  • Text1 ~ Text30: 文字列を入れるための箱
  • Number1 ~ Number30: 数値(整数や小数)を入れるための箱
  • Date1 ~ Date30: 日付を入れるための箱

ここで、致命的なミスが起こります。
「Number1(数値型)という箱に、『未定』という文字列を放り込もうとする」。

この瞬間、VBAはパニックを起こし、「型が違う!どうすればいいんだ!」と叫んで処理を停止します。これが、あの忌々しい「実行時エラー ’13’」の正体です。

2. エラーを防ぐための「防衛的プログラミング」

プロのエンジニアは、エラーが起きてから対処するのではなく、「エラーが起きる前に、データの正体を確かめる」という手法をとります。これを防衛的プログラミング(Defensive Programming)と呼びます。

具体的には、代入を行う前に、その値が「本当に数値として扱えるものか?」をチェックする処理を挟みます。

失敗するコードの典型例(マクロ記録スタイル)

まずは、エラーが発生してしまう、危ういコードを見てみましょう。

Sub BadExample()
    Dim t As Task
    Set t = ActiveProject.Tasks(1)
    
    Dim inputValue As Variant
    inputValue = "未定" ' 本来は数値が欲しいが、間違って文字列が入ってきたとする
    
    ' ここでエラーが発生! 
    ' Number1は数値型なので、文字列 "未定" を受け入れることができない
    t.Number1 = inputValue 
    
    MsgBox "処理が完了しました"
End Sub

このコードを実行すると、`t.Number1 = inputValue` の行でプログラムが強制終了してしまいます。これでは、大規模なプロジェクトを自動処理している最中に止まってしまったら、大変なことになりますよね。

3. 【実践】安全な代入を実現する「型チェック関数」

では、どうすればいいのか。解決策はシンプルです。`IsNumeric` 関数という、VBAの頼れる味方を使います。

以下に、現場でそのまま使える、安全性を高めた実装例を示します。

''' <summary>
''' タスクの数値型カスタムフィールドに、安全に値を代入するプロシージャ
''' </summary>
''' <param name="targetTask">対象となるタスクオブジェクト</param>
''' <param name="targetField">代入先のフィールド名 (例: "Number1")</param>
''' <param name="value">代入したい値</param>
Sub SafeAssignNumber(targetTask As Task, targetField As String, value As Variant)
    
    ' --- ステップ1: 値が数値として妥当かチェック ---
    ' IsNumeric関数は、値が数値として解釈できる場合に True を返します
    If IsNumeric(value) Then
        
        ' 数値として扱える場合のみ、代入を実行
        ' 文字列の "100" も数値の 100 として扱ってくれる賢い性質があります
        targetTask.VarProperty(targetField).Value = CDbl(value)
        
    Else
        ' --- ステップ2: 数値でない場合の「逃げ道」を作る ---
        ' ここがプロの仕事。エラーで止めるのではなく、ログに残すか、0を代入するなどの処理を行います
        Debug.Print "【警告】タスク: " & targetTask.Name & " に対して、数値ではない値 '" & value & "' をスキップしました。"
        
        ' 必要に応じて、デフォルト値(0など)を入れることも検討してください
        ' targetTask.VarProperty(targetField).Value = 0
    End If
    
End Sub

''' <summary>
''' メイン処理:安全な代入のテスト
''' </summary>
Sub TestSafeAssignment()
    Dim t As Task
    ' 最初のタスクを対象にする
    If ActiveProject.Tasks.Count = 0 Then Exit Sub
    Set t = ActiveProject.Tasks(1)

    ' パターンA: 正しい数値の場合
    Call SafeAssignNumber(t, "Number1", 150.5)
    
    ' パターンB: 数値に見える文字列の場合(これも安全に処理できる)
    Call SafeAssignNumber(t, "Number1", "500")
    
    ' パターンC: エラーの原因となる文字列の場合(エラーにならず、警告が出るだけ)
    Call SafeAssignNumber(t, "Number1", "未定")
    
    ' パターンD: 空っぽ(Empty)の場合
    Call SafeAssignNumber(t, "Number1", Empty)

    MsgBox "処理が終了しました。イミディエイトウィンドウを確認してください。"
End Sub

コードの解説:ここがポイント!

1. `IsNumeric(value)`: これが今回の主役です。値が「数字として扱えるか」を判定します。`”100″`(文字列)のようなケースも `True` と判定してくれるので、非常に強力です。
2. `CDbl(value)`: `IsNumeric` で合格した値を、明示的に「Double型(倍精度浮動小数点数型)」に変換しています。型を明示的に指定することで、プログラムの動作がより安定します。
3. `Debug.Print`: エラーで止める代わりに、VBAエディタの「イミディエイトウィンドウ」に警告を出しています。これにより、どのタスクで問題が起きたのかを後から調査できます。これが「止まらないツール」を作るコツです。

4. まとめ:エンジニアへの第一歩

いかがでしたか?

「エラーが出るから修正する」のではなく、「エラーが起きないように、あらかじめデータの形を整えておく」。この考え方を持つだけで、あなたの書くコードの品質は劇的に向上します。

今回のポイントを復習しましょう:

  • MS Projectのカスタムフィールドは「型」に対して非常に厳格である。
  • 数値型フィールドに文字列を入れようとすると「型違い」エラーで止まる。
  • `IsNumeric` 関数を使って、代入前にデータの正体を必ず確認する。

最初は少しコードが長くなったように感じるかもしれません。でも、この「一歩踏み込んだ確認」こそが、大規模なプロジェクトを支える自動化ツールの信頼性を生むのです。

ここをクリアすれば、Project VBAの基本はバッチリですよ。自信を持って、次のステップへ進んでくださいね。応援しています!

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