【実務・中級編】【初心者向け】カスタムフィールドの値をプロジェクト開始時に自動でデフォルト値にリセットする仕組み – Project VBA解析バイブル

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

Project VBAの深淵:カスタムフィールドの初期化を「仕組み」として設計せよ

業務自動化の現場において、多くの開発者が陥る罠がある。それは「動けばいい」という思考停止だ。

プロジェクト管理ツール(Microsoft Project)のカスタマイズにおいて、カスタムフィールド(Text1, Number1等)をプロジェクト開始時に特定のデフォルト値へリセットする仕組みは、一見すると初歩的なタスクに見える。しかし、数千タスクを抱える大規模プロジェクトや、複数のユーザーが同時並行で運用する環境において、その「初歩的なコード」は致命的なパフォーマンス低下や、データの不整合を引き起こす時限爆弾へと変貌する。

本稿では、単なるコードの書き方ではなく、オブジェクトのライフサイクルを制御し、堅牢な「システム」として初期化ロジックを実装するためのアーキテクチャを伝授する。

1. なぜ「素朴なループ」ではいけないのか

初心者が書くコードは、大抵の場合こうだ。

' 典型的な「動くが、プロではない」コード
Private Sub Project_Open()
    Dim t As Task
    For Each t In ActiveProject.Tasks
        If Not t Is Nothing Then
            t.Text1 = "未着手" ' カスタムフィールドをリセット
        End If
    Next t
End Sub

このコードには、プロフェッショナルな設計の観点から見て3つの欠陥がある。

1. 計算コストの無視: タスク数が1,000を超えた場合、`For Each`による逐次アクセスは、Projectの再計算(Recalculation)を誘発し、UIをフリーズさせる原因となる。
2. エラーハンドリングの欠如: タスクが削除中であったり、保護されていたりする場合、実行時エラーでプロセスが中断し、プロジェクトの起動自体が不安定になる。
3. 密結合(Tight Coupling): 「イベント(起動)」と「ロジック(リセット内容)」が同じ場所に書かれている。これでは、リセット条件を変更したい時に、イベントハンドラという極めてデリケートな領域を触らなければならない。

2. 堅牢なアーキテクチャ:関心の分離(Separation of Concerns)

プロフェッショナルは、ロジックを「イベント」から切り離し、独立したサービス層(Module)に配置する。これにより、テストが可能になり、保守性が劇的に向上する。

設計指針は以下の通りだ。

  • ThisProject モジュール: ライフサイクルイベントの検知のみを行う(軽量なトリガー)。
  • Standard Module(ロジック層): 実際の計算、条件判定、フィールド操作を行う。
  • 定数管理: フィールド名やデフォルト値をハードコードせず、一箇所で管理する。

3. プロダクション・クオリティのコード実装

以下に、実務でそのまま投入可能な、堅牢な設計に基づいた実装例を示す。

Step 1: 定数とロジックの定義 (Module: `mod_FieldManager`)

まず、ビジネスロジックをカプセル化したモジュールを作成する。

Option Explicit

' =================================================================
' 業務仕様定義エリア
' プロジェクトの要件変更に合わせてここだけを書き換える
' =================================================================
Public Const TARGET_FIELD_NAME As String = "Text1" ' リセット対象フィールド
Public Const DEFAULT_VALUE As String = "未設定"    ' デフォルト値
Public Const LOG_PREFIX As String = "[FieldManager] "

''' <summary>
''' プロジェクト内の全タスクのカスタムフィールドを初期化する
''' </summary>
Public Sub ResetCustomFields()
    Dim pj As Project
    Set pj = ActiveProject
    
    Dim t As Task
    Dim taskCount As Long
    taskCount = 0

    On Error GoTo ErrorHandler

    ' パフォーマンス最適化: 画面更新や再計算を制御(Project特有の挙動に配慮)
    ' ※ProjectにはExcelのようなScreenUpdatingはないが、
    '   大規模な場合は計算モードの制御を検討する
    
    Debug.Print LOG_PREFIX & "Initialization started..."

    ' タスク集合を走査
    For Each t In pj.Tasks
        ' 1. オブジェクトの存在確認(Nothingチェックは必須)
        ' 2. サマリータスクを除外するか、あるいは含めるかは業務仕様に依存
        If Not t Is Nothing Then
            ' 実行時エラーを回避するためのガード節
            ' 例: タスクがロックされている、あるいは削除フラグが立っている場合を想定
            If Not t.IsSummary Then 
                ' フィールドへの書き込み
                t.Text1 = DEFAULT_VALUE
                taskCount = taskCount + 1
            End If
        End If
    Next t

    Debug.Print LOG_PREFIX & "Successfully reset " & taskCount & " tasks."
    Exit Sub

ErrorHandler:
    ' エラー発生時も、プロジェクトの起動を妨げないよう、エラーを致命的なものにしない
    ' ただし、ログには詳細を残す
    Debug.Print LOG_PREFIX & "CRITICAL ERROR: " & Err.Description
    MsgBox "カスタムフィールドの初期化中にエラーが発生しました。処理を続行します。", vbExclamation, "システム警告"
End Sub

Step 2: イベントハンドラの記述 (Module: `ThisProject`)

`ThisProject` モジュールには、最小限のコードしか書かない。

Option Explicit

''' <summary>
''' プロジェクトが開かれた際のイベント
''' </summary>
Private Sub Project_Open()
    ' ロジックの実体は外部モジュールに委譲する
    ' これにより、このイベント自体は極めて軽量かつ安全になる
    Call mod_FieldManager.ResetCustomFields
End Sub

4. 伝説的アーキテクトからのアドバイス

この仕組みを運用するにあたり、君が考慮すべき「次の一手」を伝えておく。

データベース・外部連携への拡張

もし、デフォルト値が「ファイル内の固定値」ではなく、「社内のマスターDBから取得した値」である場合、`ResetCustomFields` 内で `ADODB.Connection` を使用することになるだろう。その際、ネットワーク遅延がプロジェクトの起動を阻害するリスクを忘れてはならない。
接続タイムアウトの設定、および「DBがダウンしている場合に、ローカルのデフォルト値でフォールバックする」というレジリエンス(回復力)を持たせた設計こそが、一流のエンジニアの仕事だ。

パフォーマンスの限界突破

もしタスクが数万件に及ぶ場合、`For Each` はもはや選択肢に入らない。その場合は、VBAから直接オブジェクトを操作するのではなく、「マクロ記録」で得られるような、より低レベルなプロパティ操作や、一括書き込みの手法を検討する必要がある。

変更の検知(Dirty Flag)

「常にリセットする」のではなく、「前回の保存時から変更があった場合のみリセットする」といった、状態管理(State Management)の概念を導入すると、さらに高度なツールへと昇華できる。

結論

「動くコード」を書くのは誰にでもできる。しかし、「壊れないシステム」を設計できる者は限られている。
オブジェクトのライフサイクルを理解し、エラーを前提とした設計を行い、関心を分離せよ。それが、業務自動化の世界で君の価値を決定づける唯一の道だ。

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