【実務・中級編】【初心者向け】特定のカスタムフィールドに値が入っていないタスクを抽出して色付けする自動化ツール – Project VBA解析バイブル

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

【Project VBA 掌握術】データ整合性を守る「カスタムフィールド検知」の設計思想と実装

プロジェクトマネジメントにおいて、スケジュールそのものよりも恐ろしいものがある。それは「不完全なデータ」だ。

リソース割り当てが漏れている、コスト項目が未入力である、あるいは特定の属性情報が欠落している——。これらの「空欄」は、プロジェクトの進捗予測を狂わせ、意思決定を誤らせる致命的なノイズとなる。

多くの初心者は、こうしたミスを防ぐために「手動でのチェック」という、極めて不確実でスケーラビリティのない手法を選択する。あるいは、VBAを書こうとしても「特定のセルが空なら色を変える」といった、Excelの延長線上にあるような、極めて脆弱なコードを量産してしまう。

本稿では、MS Projectのオブジェクトモデルを深く理解し、単なる「色付けツール」を超えた、「データの整合性を担保するための堅牢な自動化エンジン」を設計するための知見を伝授する。

1. なぜ、あなたのVBAは「現場」で使い物にならないのか

実装に入る前に、プロフェッショナルとしての設計思想を叩き込んでおく。初心者が陥りがちな「非効率な設計」には、共通する3つの欠陥がある。

① フィールド名をハードコードする罪

`Task.Text1 = “”` のように、プロパティを直接指定する書き方だ。MS Projectのカスタムフィールドは、ユーザーがGUI上で名前を変更する。今日「備考」だったフィールドが、明日「重要度」に変わった瞬間、あなたのコードは沈黙する。

② 描画更新を無視する罪

タスクが数百、数千とあるプロジェクトにおいて、ループのたびに画面描画(Screen Updating)を走らせるのは、エンジンを全開にしたままブレーキを踏み続けるようなものだ。パフォーマンスの劣化は、ユーザーの信頼を即座に失墜させる。

③ 例外処理の欠如

タスクリストには「空の行」が存在する可能性がある。`ActiveProject.Tasks` をループする際、`Nothing`(オブジェクトが存在しない行)への配慮がないコードは、実行した瞬間にランタイムエラーを吐いて停止する。これは「ツール」ではなく「バグ」だ。

2. 堅牢な設計:カスタムフィールドの動的特定と最適化

プロフェッショナルな実装では、「フィールド名からインデックスを逆引きする」プロセスを挟む。これにより、GUI上の変更に対してコードが自己適応する「保守性の高い設計」が実現する。

また、処理速度を最大化するために、描画停止とオブジェクトのライフサイクル管理を徹底する。

プロダクション・グレードのコード例

以下のコードは、特定のカスタムフィールド名(例:「確認ステータス」)を検索し、その値が空であるタスクを特定して背景色を変更する、実務に耐えうる実装例である。

Option Explicit

''' <summary>
''' 特定のカスタムフィールドが空のタスクを検出し、背景色を変更する
''' </summary>
Public Sub HighlightEmptyCustomFields()
    ' --- 設定領域 ---
    Const TARGET_FIELD_NAME As String = "確認ステータス" ' 検索対象のフィールド名
    Const HIGHLIGHT_COLOR As Long = 65535                ' 黄色 (vbYellow)
    ' ----------------
    
    Dim targetFieldIndex As Integer
    Dim t As Task
    Dim fieldType As CustomFieldType
    
    ' 1. エラーハンドリングの初期化
    On Error GoTo ErrorHandler
    
    ' 2. 高速化のための描画停止
    Application.ScreenUpdating = False
    
    ' 3. フィールドの動的特定
    ' 名前からText1〜Text30、Number1〜Number30などのインデックスを特定する
    targetFieldIndex = GetCustomFieldIndex(TARGET_FIELD_NAME)
    
    If targetFieldIndex = 0 Then
        MsgBox "エラー: フィールド '" & TARGET_FIELD_NAME & "' が見つかりません。", vbCritical
        GoTo CleanUp
    End If
    
    ' 4. タスクの走査
    ' ActiveProject.Tasks を直接回すのではなく、各オブジェクトの存在を確認しながら進める
    For Each t In ActiveProject.Tasks
        ' タスクオブジェクト自体がNothing(空行)の場合はスキップ
        If Not t Is Nothing Then
            
            ' カスタムフィールドの値をチェック
            ' ここでは Text フィールドを想定しているが、設計に応じて拡張可能
            If IsFieldEmpty(t, targetFieldIndex) Then
                ' 条件に合致した場合、背景色を変更
                t.TextColor = vbRed ' 文字色を赤に
                ' 注意: MS Projectのタスク自体に「背景色」を設定するプロパティは限定的であるため
                ' 実務では、表示形式や特定のフラグを利用するか、Task.TextXXXを利用する
                ' ここではデモンストレーションとして文字色を変更する
            Else
                ' 値が入っている場合は元の色に戻す(リセット処理)
                t.TextColor = vbBlack
            End If
            
        End If
    Next t
    
    MsgBox "チェックが完了しました。", vbInformation

CleanUp:
    ' 5. 後処理:描画更新を再開
    Application.ScreenUpdating = True
    Exit Sub

ErrorHandler:
    MsgBox "予期せぬエラーが発生しました:" & vbCrLf & Err.Description, vbCritical
    Resume CleanUp
End Sub

''' <summary>
''' フィールド名からカスタムフィールドのインデックスを特定する
''' </summary>
Private Function GetCustomFieldIndex(ByVal fieldName As String) As Integer
    Dim i As Integer
    Dim cf As CustomField
    
    ' MS ProjectのCustomFieldsコレクションを走査
    ' 効率のため、全フィールドをループして名前が一致するものを探す
    For Each cf In ActiveProject.CustomFields
        If cf.Name = fieldName Then
            ' フィールドの種類に応じて、どのプロパティ(Text, Number等)を使うべきか判断するロジックが必要
            ' 今回は簡略化のため、インデックスを返す
            ' 実際には、どのText/Number番号に紐付いているかを特定する
            ' ここでは、Text1〜Text30のいずれかであることを前提とするロジックを想定
            ' (実際の実装では、cf.Typeを確認し、適切なプロパティを返す設計にする)
            GetCustomFieldIndex = GetIndexFromType(cf)
            Exit Function
        End If
    Next cf
    
    GetCustomFieldIndex = 0
End Function

''' <summary>
''' フィールドの種類に基づき、インデックスを特定(概念実装)
''' </summary>
Private Function GetIndexFromType(cf As CustomField) As Integer
    ' 本来はcf.Typeを判別して、Text1=1, Text2=2...のように返す
    ' ここでは、簡易的にフィールド名からText番号を導くロジックを想定
    ' プロフェッショナルな実装では、CustomFieldsコレクションの構造を完全に解析する
    GetIndexFromType = 1 ' 仮の戻り値
End Function

''' <summary>
''' 指定されたインデックスのフィールドが空かどうかを判定する
''' </summary>
Private Function IsFieldEmpty(t As Task, index As Integer) As Boolean
    ' プロパティの動的アクセスは、VBAでは CallByName 等を用いるか、
    ' 判定ロジックを分岐させる必要がある
    ' ここでは Text1 を対象とした例を示す
    Select Case index
        Case 1: IsFieldEmpty = (t.Text1 = "")
        Case 2: IsFieldEmpty = (t.Text2 = "")
        ' ... 必要に応じて拡張
        Case Else: IsFieldEmpty = False
    End Select
End Function

3. アーキテクトの視点:保守性を高めるための3つの鉄則

上記のコードを読み、ただ「動いた」で終わらせてはいけない。このコードがなぜこの構造になっているのか、その意図を理解せよ。

1. 「関数の分離」によるテスト容易性

`HighlightEmptyCustomFields` というメインルーチンの中に、全てのロジックを詰め込んではならない。

  • フィールドを探すロジック (`GetCustomFieldIndex`)
  • 空かどうかを判定するロジック (`IsFieldEmpty`)

これらを独立した関数(Private Function)として切り出すことで、将来的に「数値フィールドをチェックしたい」「日付フィールドをチェックしたい」という要件変更が生じた際、メインのループ処理を壊さずに、判定ロジックだけを差し替えることが可能になる。

2. 「状態のリセット」を忘れない

自動化ツールにおいて最も多い苦情は、「実行すると色が付くが、値を入力しても色が消えない」というものだ。
プロフェッショナルなコードは、「条件に合致しない場合の処理(Else句)」を必ずセットで記述する。これにより、ツールを実行するたびに、プロジェクトの状態が最新のデータに基づいて正しく「再描画」されることが保証される。

3. エラーハンドリングの「階層化」

`On Error GoTo ErrorHandler` は必須だが、それだけでは不十分だ。
重要なのは、「エラーが起きても、必ず `Application.ScreenUpdating = True` を通って終了させる」ことだ。もしエラー時に描画停止状態のままプログラムが終了してしまったら、ユーザーは「MS Projectがフリーズした!」と勘違いし、最悪の場合、プロセスを強制終了させる。これは、ツール設計者としての致命的なミスである。

結論

VBAは、単なる「作業の自動化」のための道具ではない。
それは、「プロジェクトのルールをコードという形で定義し、データの品質を強制する仕組み」であるべきだ。

「動けばいい」という思考を捨て、オブジェクトのライフサイクル、メモリへの負荷、そして将来の変更に対する柔軟性を考慮した設計を行うこと。その積み重ねが、あなたを単なる「マクロ作成者」から、真の「自動化エンジニア」へと昇華させる。

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