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

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

マクロ記録から脱却する第一歩:Project VBAで「特定のタスクだけ」を狙い撃ちしてカスタムフィールドを操る技術

こんにちは。プロジェクトの複雑性が増すにつれ、「手作業でフィールドを埋めるのはもう限界だ」と感じることはありませんか?

「マクロの記録」を使えば、確かに操作を自動化することはできます。しかし、記録されたコードは「今、目の前にあるもの」をなぞるだけの、いわば「ビデオの再生」に過ぎません。現場で本当に求められるのは、「もし〜だったら、この値を書き込む」という、状況に応じた判断ができるインテリジェントな自動化です。

今日は、Project VBAの真髄の一つである「条件分岐(If文)を用いた、カスタムフィールドへのピンポイントな値の代入」について解説します。ここをマスターすれば、あなたは「記録されたマクロを使う人」から「業務プロセスを設計するエンジニア」へと進化できます。

1. なぜ「全タスク更新」ではいけないのか?

例えば、「重要度」というカスタムフィールド(Text1)があり、特定のフラグ(Flag1)が立っているタスクにだけ「要確認」という文字を入れたいとします。

もし、すべてのタスクに対して無条件に値を書き込むコードを書いてしまうと、どうなるでしょうか?
プロジェクト全体のデータが書き換わり、本来「要確認」である必要のないタスクまで汚染されてしまいます。これは、データの整合性を破壊する行為です。

私たちが目指すのは、「膨大なタスクの中から、条件に合致するターゲットだけを正確に見つけ出し、外科手術のようにピンポイントで値を書き込む」ことです。

2. 核心となるコードの構造:ループと条件分岐のコンビネーション

特定のタスクを狙い撃ちするには、「全員を順番に確認する(Loop)」ことと、「条件に合うか判定する(If)」ことの2つを組み合わせます。

まずは、最も基本的かつ強力なテンプレートを見てみましょう。

実践コード:Flag1が「Yes」のタスクにだけText1を代入する

Sub UpdateSpecificTasks()
    ' 変数の宣言:オブジェクト指向の基本です
    Dim t As Task
    
    ' プロジェクト内のすべてのタスクに対してループを開始
    ' ActiveProject.Tasks はプロジェクト内のタスクの集合体(コレクション)です
    For Each t In ActiveProject.Tasks
        
        ' 【重要】エラー回避のプロの作法
        ' タスクの中に空の行(Nothing)があると、エラーで止まってしまいます。
        ' 必ず「タスクが存在するか」を確認するのが、堅牢なコードへの第一歩です。
        If Not t Is Nothing Then
            
            ' --- ここからが「条件分岐」のメインディッシュ ---
            
            ' 条件:もし Flag1(カスタムフラグ)が True (Yes) だったら
            If t.Flag1 = True Then
                
                ' 条件に合致した場合のみ、Text1(カスタムテキスト)に値を代入
                t.Text1 = "★要確認"
                
            Else
                ' 条件に合致しない場合は、値をクリアするか、別の処理を行う
                ' ここでは、条件に合わない場合は空にする設定にしています
                t.Text1 = ""
                
            End If
            ' ----------------------------------------------
            
        End If
    Next t

    MsgBox "特定のタスクの更新が完了しました!", vbInformation
End Sub

3. エンジニアが教える「陥りやすい3つの罠」

このコードを動かす前に、私が現場で何度も見てきた「初心者がハマる落とし穴」を共有しておきます。これを知っているだけで、デバッグの時間は劇的に減ります。

① 「Nothing」の恐怖

`For Each t In ActiveProject.Tasks` でループを回す際、プロジェクト内に削除された跡や空の行があると、`t` は「何も指していない状態(Nothing)」になります。これに対して「値を入れて」と命令すると、VBAは「オブジェクト変数または With ブロック変数が設定されていません」という無情なエラーを吐いて止まります。
必ず `If Not t Is Nothing Then` を挟む癖をつけてください。これは「安全装置」です。

② サマリータスクへの干渉

Projectには「まとめタスク(サマリータスク)」があります。個別の作業タスクだけに値を書き込みたいのに、サマリータスクまで書き換わってしまうことがあります。
もし作業タスクだけに限定したいなら、条件式に以下を追加しましょう。
`If t.Summary = False Then` (サマリータスクではない、という意味)

③ カスタムフィールドの「型」の違い

  • `Flag1` ~ `Flag21` は Boolean型(True または False)です。
  • `Text1` ~ `Text30` は String型(文字列)です。
  • `Number1` ~ `Number20` は Double型(数値)です。

`If t.Text1 = True Then` のように、型が違うもの同士を比較しようとすると、予期せぬ挙動やエラーの原因になります。

4. さらに高度な条件分岐へのステップアップ

「FlagがTrueの時」だけでなく、もっと複雑な条件で狙い撃ちしたい場面もありますよね。いくつか応用パターンを紹介します。

パターンA:タスク名で判定する

「タスク名に『設計』という言葉が含まれているものだけ」を対象にする場合です。

' Like演算子を使うと、ワイルドカード(*)を使った曖昧検索が可能です
If t.Name Like "*設計*" Then
    t.Text1 = "設計工程"
End If

パターンB:複数の条件を組み合わせる(AND / OR)

「Flag1がTrue」かつ「残余期間が5日以上」という、より実務的な条件です。

' And を使って複数の条件を結合します
If t.Flag1 = True And t.RemainingDuration > 480 Then ' 480分 = 8時間(Projectの単位に注意)
    t.Text1 = "長期懸念タスク"
End If

結びに:コードは「意思」である

いかがでしたでしょうか?
単に「マクロを記録して再生する」のと、「条件を定義して、特定のオブジェクトに働きかける」のとでは、できることの次元が全く異なります。

プログラミングとは、コンピュータに対して「あなたの意思(ロジック)」を伝える作業です。「この条件の時だけ、こうしてほしい」というあなたのロジックが、正確に記述されたとき、VBAはあなたの強力な右腕になります。

最初はエラーが出て当たり前です。エラーメッセージは、あなたがプログラムを正しく導くための「ヒント」に過ぎません。一歩ずつ、この美しいオブジェクトの世界を楽しんでください。

ここをクリアすれば、Project VBAの基本はバッチリですよ。次は、リソース(人員)の自動割り当てに挑戦してみましょう!

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