【入門編】【初心者向け】カスタムフィールドの値を一括で初期化(クリア)する高速ループ処理の基礎 – Project VBA解析バイブル

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

Project VBAを掌握する:数千行のカスタムフィールドを一瞬でクリアする「高速化の極意」

こんにちは。現場の設計からAPIの深淵まで、自動化の最適解を追求し続けているチーフアーキテクトです。

「マクロの記録を使えば、何でも自動化できる」
そう思って一歩を踏み出したあなたは、素晴らしいセンスを持っています。しかし、記録されたコードをそのまま動かして、数千行のタスクがあるプロジェクトで「……あれ? 終わらないぞ?」と時計を見つめたことはありませんか?

マクロの記録は、あくまで「あなたの操作を忠実に再現しただけ」のものです。そこには、コンピュータが裏側で行っている「描画のコスト」や「オブジェクトのライフサイクル」といった、効率化のための重要な視点が欠けています。

今日は、初心者から一歩抜け出し、「使えるエンジニア」になるための第一歩として、カスタムフィールド(Text1など)の値を一括でクリアする高速ループ処理をマスターしましょう。ここをクリアすれば、Project VBAの基本はバッチリですよ。

なぜ「マクロの記録」は遅いのか?

まず、敵を知ることから始めましょう。なぜ、数千行のデータを処理する際に時間がかかるのでしょうか?

理由はシンプルです。「一回書き換えるたびに、Projectが画面を書き換えようとするから」です。

あなたがセルを一つ書き換えるたびに、Microsoft Projectは「あ、データが変わったな! 画面を更新しなきゃ! スケジュールも再計算しなきゃ!」と、律儀に反応します。これが数千回繰り返されると、膨大な「描画コスト」が積み重なり、処理が激重になるのです。

プロのエンジニアは、作業を始める前に「今は作業中だから、画面を見なくていいよ」とコンピュータに指示を出します。これが「高速化」の魔法です。

実践:カスタムフィールドを一括クリアするコード

それでは、実際にタスクのカスタムフィールド(例:`Text1`)をすべて空にする、安全で高速なコードを見てみましょう。

Sub ClearTaskCustomFields_Fast()
    ' ===========================================================
    ' 目的: すべてのタスクのカスタムフィールド(Text1)を高速にクリアする
    ' 対象: アクティブなプロジェクト内の全タスク
    ' ===========================================================
    
    Dim t As Task             ' タスクオブジェクトを格納する変数
    Dim proj As Project       ' プロジェクトオブジェクト
    
    ' 1. 処理の準備:対象となるプロジェクトをセット
    Set proj = ActiveProject
    
    ' エラーハンドリングの設定(万が一の停止時に画面更新を元に戻すため)
    On Error GoTo ErrorHandler

    ' -----------------------------------------------------------
    ' 【極意 1】描画の停止(高速化の要)
    ' -----------------------------------------------------------
    ' 画面更新を停止することで、書き換えごとの描画コストをゼロにします。
    ' これだけで、処理速度は劇的に(時には数十倍)変わります。
    Application.ScreenUpdating = False
    
    ' -----------------------------------------------------------
    ' 【極意 2】効率的なループ処理
    ' -----------------------------------------------------------
    ' For Each文を使い、プロジェクト内のタスクを一つずつ取り出します。
    For Each t In proj.Tasks
        
        ' 重要:タスクが「Nothing(空っぽ)」でないかを確認する
        ' プロジェクトの構成によっては、タスクリストに空の要素が含まれることがあるためです。
        If Not t Is Nothing Then
            
            ' カスタムフィールド Text1 を空文字 "" で初期化
            t.Text1 = ""
            
        End If
    Next t

    ' -----------------------------------------------------------
    ' 処理の完了:後始末
    ' -----------------------------------------------------------
    ' 最後に必ず画面更新を「True」に戻します。これを忘れると、
    ' プロジェクトの画面が固まったように見える原因になります。
    Application.ScreenUpdating = True
    
    MsgBox "完了しました!すべての Text1 をクリアしました。", vbInformation, "成功"
    
    Exit Sub

' エラーが発生した場合の処理
ErrorHandler:
    ' エラーが起きても、画面更新設定だけは必ず元に戻すのがプロの作法です。
    Application.ScreenUpdating = True
    MsgBox "エラーが発生しました: " & Err.Description, vbCritical, "エラー"
End Sub

コードの解説:ここが「プロ」の視点

このコードには、初心者が陥りやすい罠を回避するための「設計思想」が組み込まれています。

1. `Application.ScreenUpdating = False` の威力

これが今回の主役です。これを書くだけで、Projectは「裏側で黙々と計算」に集中できるようになります。ただし、「処理が終わったら必ず `True` に戻す」というルールを絶対に忘れないでください。これを忘れると、マクロ終了後に画面が全く動かない「フリーズ状態」に見えてしまいます。

2. `If Not t Is Nothing Then` という防波堤

Projectのタスクコレクション(`Tasks`)をループする際、稀に「実体のないタスク」が混じることがあります。これに対して直接「値をクリアしろ」と命令すると、「オブジェクト変数または With ブロック変数が設定されていません」というエラーで止まってしまいます。
`If Not t Is Nothing` と書くことで、「もしタスクがちゃんと存在していたら、処理を行う」という安全策を講じているのです。

3. エラーハンドリング(`On Error GoTo`)

プログラミングにおいて、エラーは必ず起こるものと考えておきます。もし途中でエラーが起きてマクロが強制終了してしまったら、`ScreenUpdating = False` のままになってしまいます。
`ErrorHandler` を用意しておくことで、「たとえ失敗しても、画面更新設定だけは元に戻して、ユーザーに状況を伝える」という、親切な設計(堅牢な設計)にしています。

次のステップへ:リソース(Resource)への応用

この考え方は、タスク(Task)だけでなく、リソース(Resource)に対しても全く同じように適用できます。

' リソースのカスタムフィールドをクリアする場合のイメージ
Dim r As Resource
For Each r In proj.Resources
    If Not r Is Nothing Then
        r.Text1 = ""
    End If
Next r

構造が同じであることに気づきましたか? これが「オブジェクトモデル」を理解するということの楽しさです。

まとめ

今回のポイントを振り返りましょう。

1. 描画コストを削る: `ScreenUpdating = False` で高速化。
2. 安全なループ: `If Not … Is Nothing` でエラーを未然に防ぐ。
3. 責任ある後始末: エラーが起きても `ScreenUpdating = True` に戻す。

これらを意識するだけで、あなたの書くコードは「記録されたマクロ」から「プロフェッショナルなツール」へと進化します。

一歩ずつ、着実に。コードの背後にある「動き」を感じながら、Project VBAの世界を楽しんでください。もし分からないことがあれば、いつでも聞いてくださいね。応援していますよ!

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