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

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

入力漏れは、コードで防げ。MS Project VBAでカスタムフィールドの空白を自動検出し、視覚化する極意

こんにちは。プロジェクトの自動化を愛するエンジニアの皆さん。
日々、膨大なタスクとリソースの管理、本当にお疲れ様です。

プロジェクト管理において、最も恐ろしいことの一つは何でしょうか?
それは「スケジュールの遅延」でも「コストの超過」でもありません。「誰かが入力すべき重要な情報(カスタムフィールド)が、空欄のまま放置されていること」です。

「このタスク、担当者のスキルレベルは入力したっけ?」「このコスト区分は設定済みかな?」
そんな不安を抱えながら、目視でガントチャートをスクロールする時間は、エンジニアリングの観点から見れば「排除すべき無駄」です。

今日は、マクロの記録から一歩踏み出し、「オブジェクトを操作して、プロジェクトの品質を自動で守る」ための第一歩を一緒に踏み出しましょう。

1. 「マクロの記録」を卒業するための思考法

多くの初学者が「マクロの記録」機能を使います。しかし、記録機能は「あなたがマウスで行った操作」を記録するだけで、「論理的な判断」はできません。

例えば、「空欄を見つける」という動作。
マクロの記録では「A1セルを見て、空だったら赤く塗る」という、特定の場所に対する命令しか記録できません。しかし、私たちが作りたいのは「プロジェクト全体をスキャンして、空欄を見つけたら色を変える」という、状況に応じた柔軟な仕組みです。

これを実現するには、「オブジェクト」という概念を理解する必要があります。

MS Projectにおける「オブジェクト」の正体

MS Projectの世界は、以下のような階層構造になっています。

1. Application(MS Projectというソフトそのもの)
2. Project(開いているプロジェクトファイル)
3. Task(プロジェクトを構成する個々のタスク)

私たちが今回操作するのは、この階層の底辺にある「Task(タスク)オブジェクト」です。各タスクは「名前」「期間」「開始日」といった属性(プロパティ)を持っており、その中にはユーザーが自由に使える「カスタムフィールド(Text1, Text2…など)」が含まれています。

2. 実践:カスタムフィールドの未入力タスクを検知する

それでは、具体的なコードを見ていきましょう。
今回のシナリオは、「Text1というカスタムフィールドに値が入っていないタスクを見つけ、そのタスク名を赤色にする」というものです。

以下のコードをVBAエディタに貼り付けてみてください。

Option Explicit

''' <summary>
''' カスタムフィールド(Text1)が空のタスクを検出し、タスク名を赤色に強調する
''' </summary>
Sub HighlightMissingCustomFields()
    Dim t As Task
    Dim targetField As String
    
    ' --- 設定エリア ---
    ' チェックしたいカスタムフィールド名を指定(Text1, Number1, Flag1など)
    targetField = "Text1"
    ' ------------------

    ' プロジェクト内のすべてのタスクを一つずつ確認していく(ループ処理)
    For Each t In ActiveProject.Tasks
        
        ' 【重要】プロジェクトには「空の行」が存在することがあるため、
        ' オブジェクトが存在するかどうか(Nothingでないか)を必ずチェックする
        If Not t Is Nothing Then
            
            ' タスクのText1プロパティが空文字列 ("") かどうかを判定
            ' ※ここがロジックの核心です
            If t.Text1 = "" Then
                ' 値が入っていない場合:タスク名を赤色に変更
                t.FontColor = pjRed
            Else
                ' 値が入っている場合:タスク名を黒色(標準)に戻す
                ' これを忘れると、一度赤くなったタスクが修正後も赤いままになってしまいます
                t.FontColor = pjBlack
            End If
            
        End If
    Next t

    MsgBox "チェックが完了しました。入力漏れを確認してください。", vbInformation, "完了"
End Sub

3. プロが教える「コードの裏側」と陥りやすい罠

このコードはシンプルですが、実は「現場で動かすための知恵」がいくつか詰まっています。ここを理解すれば、あなたはもう初心者ではありません。

① `If Not t Is Nothing` の重要性(オブジェクトの生存確認)

ここが、初心者と中級者を分ける最大の境界線です。
MS Projectのタスクリストには、見た目は空でも「データが存在しない幽霊のような行」が含まれることがあります。もしこのチェックをせずに `t.Text1` にアクセスしようとすると、「実行時エラー 91: オブジェクト変数または With ブロック変数が設定されていません」というエラーでプログラムが止まってしまいます。

「そのオブジェクトは本当にそこに存在するか?」を確認する。これは、あらゆるプログラミングにおける鉄則です。

② 「状態を戻す」という設計思想

コードの中に `Else` 文で `t.FontColor = pjBlack` と書いた理由を考えたことはありますか?
もしこれがないと、一度入力漏れで赤くなったタスクは、後から正しく入力しても赤いままになってしまいます。

自動化ツールを作る際は、「条件を満たさない場合に、状態を初期状態に戻す」という処理までセットで考える。これが、使い勝手の良い「道具」を作るためのプロの思考です。

③ カスタムフィールドの「名前」に注意

VBAから操作する場合、GUI上で「備考」や「管理区分」と名前を付けていても、プログラム上では `Text1`, `Text2`, `Number1` といったシステム的な名前で指定する必要があります。ここを間違えると、「そんなプロパティはありません」と突き放されてしまいます。

4. 次のステップへ:ここをクリアすれば、基本はバッチリ!

今回のスクリプトは「色を変える」という視覚的なものでした。
しかし、この「ループして、条件判定して、処理する」という基本構造さえマスターしてしまえば、応用は無限大です。

  • 応用例A: 「Text1が空だったら、そのタスクに自動で『要確認』というフラグを立てる」
  • 応用例B: 「特定の条件を満たすタスクだけを、新しいサブプロジェクトとして書き出す」
  • 応用例C: 「リソースの工数が予定を超えている場合に、警告ダイアログを出す」

これらはすべて、今回学んだ `For Each` と `If…Then` の組み合わせで実現できます。

最後に

プログラミングは、魔法ではありません。
「対象(Object)を特定し、その状態(Property)を調べ、望む姿(Method)へ変える」。
この一連のパズルを解いていく作業です。

一度にすべてを理解しようとしなくて大丈夫。エラーが出たら、それは「コンピュータがあなたに教えてくれているヒント」だと思って、楽しんでください。

さあ、次はどんな自動化に挑戦してみますか?
あなたの挑戦を、いつも応援していますよ。

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