【実務・中級編】【初心者向け】特定のタスクにのみカスタムフィールドの値を代入する条件分岐の書き方 – Project VBA解析バイブル

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

【Project VBA 掌握術】特定のタスクのみを射抜く:カスタムフィールド更新における「条件分岐」の極意

業務自動化の現場において、MS Projectのカスタムフィールド(Text1, Number1, Flag1など)を操作するコードは、避けては通れない道だ。しかし、多くの開発者がここで「動けばいい」という甘い設計思想に陥り、後に大規模なプロジェクトで致命的なパフォーマンス低下やランダムなエラーを招くことになる。

今回のテーマは、「全タスクではなく、特定の条件(フラグやID)に合致するタスクのみを抽出し、カスタムフィールドを更新する」という、一見シンプルに見えて実は奥が深い実装技術だ。

初心者が陥る「素人コード」と、プロフェッショナルが書く「プロダクションコード」の違いを、設計思想の観点から解き明かしていこう。

1. 初心者が陥る「死のループ」:なぜそのコードは壊れるのか

まず、よくある失敗例を見てほしい。多くの学習者が最初に書くのは、以下のようなコードだ。

' --- 危険なコード例(アンチパターン) ---
Sub BadUpdateExample()
    Dim t As Task
    For Each t In ActiveProject.Tasks
        ' 特定のテキストが入っているタスクに、フラグを立てる
        If t.Text1 = "重要" Then
            t.Flag1 = True
        End If
    Next t
End Sub

一見、完璧に見える。しかし、このコードには「設計上の欠陥」が2つ存在する。

欠陥①:`Nothing` オブジェクトの無視(致命的バグ)

MS Projectの `Tasks` コレクションには、削除されたタスクや、構造上の理由で「実体を持たないタスク」が含まれることがある。その場合、変数 `t` は `Nothing` を指す。`Nothing` に対して `.Text1` というプロパティを呼び出した瞬間、「実行時エラー 91: オブジェクト変数または With ブロック変数が設定されていません」が発生し、処理は強制終了する。

欠陥②:計算量の増大とスケーラビリティの欠如

タスク数が数百程度なら問題ない。しかし、数千、数万のタスクを扱う大規模プロジェクトで、この「全件スキャン型」のロジックを多用すると、Projectの再計算エンジンが走り続け、ツール全体のレスポンスが極端に悪化する。

2. プロフェッショナルが採用する「堅牢な設計思想」

プロのエンジニアは、コードを書く前に「対象の絞り込み(フィルタリング)」と「例外処理(エラーハンドリング)」を設計に組み込む。

設計の3原則

1. Null/Nothingチェックの徹底: オブジェクトが存在することを確認してからプロパティにアクセスする。
2. 条件分岐の多層化: `If` 文だけでなく、条件が増えた場合に備えて `Select Case` を検討し、可読性と保守性を高める。
3. 副作用の制御: カスタムフィールドを書き換える際、Projectの再計算(Recalculate)が走る。これを制御し、ユーザーへのフィードバック(ステータスバーへの表示)を行う。

3. 実践:プロダクションレディな実装例

以下に、実務でそのまま利用できるレベルの、堅牢なコード例を提示する。このコードは、特定のID範囲、あるいは特定のフラグを持つタスクのみを対象にカスタムフィールドを更新する設計になっている。

Option Explicit

''' <summary>
''' 特定の条件に合致するタスクに対してカスタムフィールドを更新する
''' </summary>
Sub RobustCustomFieldUpdate()
    Dim t As Task
    Dim targetCount As Long
    Dim updateCount As Long
    Dim startTime As Double
    
    ' パフォーマンス計測用
    startTime = Timer
    
    ' 画面更新や再計算の負荷を考慮し、エラーハンドリングを準備
    On Error GoTo ErrorHandler
    
    ' 処理の高速化(MS ProjectではExcelほど劇的ではないが、作法として重要)
    Application.ScreenUpdating = False
    
    targetCount = 0
    updateCount = 0

    ' --- メインループ ---
    For Each t In ActiveProject.Tasks
        
        ' 【重要】1. オブジェクトの存在確認(Nothingチェック)
        ' これを行わないと、削除済みタスクなどで即座にクラッシュする
        If t Is Nothing Then GoTo NextIteration
        
        ' 【重要】2. 処理対象の判定(フィルタリング)
        ' ここでは「Text1が"対象"」かつ「Flag2がFalse」のタスクのみを狙い撃つ
        If IsTargetTask(t) Then
            targetCount = targetCount + 1
            
            ' --- 更新ロジック ---
            ' 実際の業務ではここに複雑な計算式や外部DB連携が入る
            t.Flag1 = True
            t.Text2 = "更新済み_" & Format(Now, "yyyymmdd_hhnn")
            
            updateCount = updateCount + 1
        End If

NextIteration:
    Next t

    ' 終了処理
    Application.ScreenUpdating = True
    MsgBox "処理が完了しました。" & vbCrLf & _
           "対象タスク数: " & targetCount & vbCrLf & _
           "更新成功数: " & updateCount & vbCrLf & _
           "実行時間: " & Round(Timer - startTime, 2) & "秒", vbInformation, "完了"
    
    Exit Sub

ErrorHandler:
    Application.ScreenUpdating = True
    MsgBox "予期せぬエラーが発生しました。" & vbCrLf & _
           "エラー番号: " & Err.Number & vbCrLf & _
           "エラー内容: " & Err.Description, vbCritical, "システムエラー"
End Sub

''' <summary>
''' タスクが更新対象かどうかを判定する分離されたロジック
''' </summary>
''' <param name="targetTask">判定対象のタスクオブジェクト</param>
''' <returns>対象であればTrue</returns>
Private Function IsTargetTask(ByVal targetTask As Task) As Boolean
    ' 条件をここに集約することで、保守性を劇的に高める
    ' 例:Text1が"対象"、かつ、IDが10より大きい
    If targetTask.Text1 = "対象" And targetTask.ID > 10 Then
        IsTargetTask = True
    Else
        IsTargetTask = False
    End If
End Function

このコードの「凄み」を解説する

1. ロジックの分離(Single Responsibility Principle):
`IsTargetTask` という判定専用の関数を切り出した。これにより、「どんな条件の時に更新するか」という業務ルールが変わった際、メインのループ処理を触らずに、この関数を修正するだけで済む。これは保守性の観点で極めて重要だ。
2. `GoTo NextIteration` の戦略的利用:
`Nothing` の場合や、エラーが発生した場合に、スマートに次のタスクへスキップさせる構造にしている。
3. プロフェッショナルなフィードバック:
処理件数と実行時間をメッセージボックスで返す。これは、ユーザー(あるいは管理職)に対して「このツールがどれだけの規模を処理したか」というエビデンスを与える、実務的な配慮だ。

4. 外部データ(Excel/DB)連携時の「鉄の掟」

もし君が、このカスタムフィールドの値を「Excelから読み取った値」や「SQL Serverから取得した値」で更新しようとしているなら、さらに一段上の注意が必要だ。

  • データ型の不一致を恐れろ:

Excelのセルから取得した値は、VBA上では `Variant` 型として扱われることが多い。`t.Number1 = ExcelValue` とした際、`ExcelValue` が空文字 `””` や文字列であれば、即座に型不一致エラーで落ちる。必ず `IsNumeric()` 等で型チェックを行え。

  • トランザクションの概念を持て:

1,000件中500件目でエラーが起きたとき、それまでの500件の更新をどうするか?「すべてロールバック(元に戻す)」か「そこまでで止めてログを出す」か。設計段階でこれを決めておかないと、データの整合性が崩壊する。

結論:コードは「動く」だけでは足りない

「特定の条件でカスタムフィールドを更新する」という行為は、単なるプログラミングの練習ではない。それは、プロジェクトのマスターデータを操作するという、極めて責任の重い業務だ。

`If t Is Nothing Then` という一行。
`IsTargetTask` という関数の分離。
これら一つ一つの積み重ねが、現場で「信頼されるツール」と「ゴミ同然のツール」を分ける。

次からコードを書くときは、自分に問いかけてほしい。
「このコードは、1万件のデータが入り、かつ、想定外のデータが混入しても、最後まで走り抜ける設計になっているか?」と。

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