入力漏れは、コードで防げ。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)へ変える」。
この一連のパズルを解いていく作業です。
一度にすべてを理解しようとしなくて大丈夫。エラーが出たら、それは「コンピュータがあなたに教えてくれているヒント」だと思って、楽しんでください。
さあ、次はどんな自動化に挑戦してみますか?
あなたの挑戦を、いつも応援していますよ。
