【実務・中級編】【中級者向け】カスタムフィールドの数式に日付計算を組み込み、納期までの残日数を自動算出する – Project VBA解析バイブル

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

【Project VBA 掌握】カスタムフィールドの数式を「設計」せよ:納期残日数を計算する堅牢な自動化アーキテクチャ

多くの開発者が、MS Projectの自動化において「初歩的な罠」に陥る。

「タスクのText1フィールドに、VBAから計算結果を書き込む」――。
もし君がそう考えているなら、今すぐその設計思想を捨てろ。それは「自動化」ではなく、単なる「データの書き込み(Snapshot)」に過ぎない。

真の業務自動化エンジニアが目指すべきは、「プロジェクトのステータス変化に応じて、自律的に計算を行い続ける『数式(Formula)』を、VBAによって動的に定義・管理すること」だ。

本記事では、カスタムフィールドに日付計算式を組み込み、休日カレンダーを考慮した「納期までの残日数」を自動算出する、プロフェッショナル仕様の実装手法を伝授する。

1. 「値の書き込み」と「数式の定義」の決定的な違い

まず、設計の根幹となる概念を整理しよう。

非効率なアプローチ:値のインジェクション

毎朝、VBAを実行して `Task.Text1 = RemainingDays` と値を書き込む手法だ。
これは極めて脆弱である。なぜなら、一度書き込んだ値は「静的なデータ」であり、プロジェクトのスケジュールが数時間後に変更された瞬間、そのデータは「過去の遺物(嘘のデータ)」へと成り下がるからだ。

プロフェッショナルなアプローチ:数式のデプロイ

VBAの役割は、値を計算することではない。「MS Projectの計算エンジンに対し、どのようなロジックで計算すべきかの『命令(Formula)』をセットすること」である。
こうすることで、ユーザーがタスクの完了予定日を変更した瞬間に、MS Project自身のエンジンが即座に再計算を行う。これが「生きているデータ」を作る唯一の方法だ。

2. 休日カレンダーを考慮した数式ロジック

単純な日付の引き算 `[Finish] – Date()` では、土日や祝日が含まれてしまう。プロジェクト管理において、これは致命的な誤差を生む。

MS Projectの数式エンジンには、プロジェクトの作業カレンダーに基づいたネットワーク日数を算出する `ProjNetworkDays` 関数が存在する。これを利用するのが正解だ。

採用すべき数式ロジック:
`ProjNetworkDays([Finish], Date())`

この式は、「完了予定日」と「今日」の間に、プロジェクトで定義された作業日(非稼働日を除く)が何日あるかを返してくれる。

3. プロダクション・コード:CustomFieldManager

以下に、保守性と堅牢性を担保したコードを示す。単なるコピペ用ではない。エラーハンドリング、オブジェクトのライフサイクル、そして「数式の型」を意識した設計になっている。

Option Explicit

' ==============================================================================
' Module: CustomFieldManager
' Description: MS Projectのカスタムフィールドに動的な数式をデプロイする
' Author: Chief Architect
' ==============================================================================

Enum FieldType
    TaskField = 0
    ResourceField = 1
End Enum

''' <summary>
''' 納期までの残日数を算出する数式を、指定したカスタムフィールドに設定する。
''' </summary>
''' <param name="fType">TaskまたはResource</param>
''' <param name="fIndex">フィールドのインデックス (pjTaskDate1 等の定数)</param>
Public Sub DeployDeadlineCountdownFormula(ByVal fType As FieldType, ByVal fIndex As Long)
    Dim proj As Project
    Set proj = ActiveProject
    
    On Error GoTo ErrorHandler

    ' 1. フィールドの存在確認と設定の初期化
    ' カスタムフィールドの定義は、タスク単位ではなくプロジェクト全体の「定義」に対して行う
    Debug.Print "Deploying formula to Field Index: " & fIndex
    
    ' 2. 数式の構築
    ' MS Projectの内部関数 ProjNetworkDays を使用。
    ' [Finish] はタスクの完了予定日を指す。
    ' Date() は実行時の日付を指す。
    Dim formulaString As String
    formulaString = "ProjNetworkDays([Finish], Date())"

    ' 3. カスタムフィールドへのデプロイ
    ' 既存の数式や値をクリアしてから、新しい数式を注入する
    With proj.CustomFields(fType, fIndex)
        .Formula = formulaString
        .Title = "残り作業日数"
        ' 数式が設定されている場合、値は自動的に計算されるため、手動での値代入は不要
    End With

    MsgBox "数式のデプロイが完了しました。プロジェクトのカレンダーに基づき自動計算されます。", vbInformation
    Exit Sub

ErrorHandler:
    MsgBox "致命的なエラーが発生しました。" & vbCrLf & _
           "Error Number: " & Err.Number & vbCrLf & _
           "Description: " & Err.Description, vbCritical, "Deployment Failed"
    ' ここでログ出力や、DBへのエラーログ記録などの処理を検討せよ
End Sub

''' <summary>
''' 実行エントリーポイント
''' </summary>
Public Sub Main()
    ' 実務での使用例: 
    ' タスクのカスタム日付フィールド(pjTaskDate1)に、残日数を算出する数式をセットする。
    ' ※日付型フィールドに数値を入れると型エラーになる場合があるため、
    ' 本来は Textフィールド(pjTaskText1) へのデプロイを推奨する。
    
    ' 数値として扱いたい場合は Text フィールドを使用すること
    Call DeployDeadlineCountdownFormula(FieldType.TaskField, 1) ' pjTaskText1 を想定
End Sub

アーキテクトの視点:実装の勘所

1. `CustomFields` コレクションの操作:
タスクをループして `Task.Text1 = …` とするのではなく、`Project.CustomFields` を直接操作している点に注目せよ。これにより、数万行のタスクがあっても、処理時間は一瞬で終わる。計算の重みは「設定時」ではなく「プロジェクト表示時」に分散されるのが正しい設計だ。
2. 型(Type)の整合性:
上記のコードでは `pjTaskText1`(テキスト型)への注入を想定している。`ProjNetworkDays` の戻り値は数値だ。日付型フィールド(`pjTaskDate1`など)に数値を無理やり流し込むと、MS Projectの型変換エンジンが予期せぬ挙動を示すリスクがある。実務では、表示用にはテキスト型、計算用には日付型と使い分けるのが定石だ。
3. 冪等性(Idempotency)の確保:
この関数は何度実行しても、同じ状態に収束する。既存の値を消去し、新しい数式を上書きする設計にすることで、「二重に計算される」あるいは「古い数式が残る」といったバグを排除している。

4. 外部連携(DB/Excel)における注意点

このツールを、さらに上位のシステム(SQL ServerやExcel BIツール)と連携させる場合、エンジニアとして以下のリスクを予見しておかなければならない。

  • 数式の消失:

MS Projectファイルを `.mpp` 形式ではなく、`.csv` や `.xml` でエクスポートした場合、「数式」は失われ、「計算結果の静的な値」のみが書き出される。
もし、エクスポート後のデータでも動的な計算を維持したいのであれば、MS Project側ではなく、受け側のDBやExcel側で同様の `NETWORKDAYS` 関数を実装する設計(ロジックの二重化)が必要になる。

  • カレンダーの同期:

`ProjNetworkDays` は MS Project 内のカレンダーを参照する。外部システム側で「休日」のマスターデータを持っている場合、両者のカレンダー定義が一致していないと、算出される「残日数」に乖離が生じる。これはシステム統合における古典的かつ最大の失敗要因だ。

結論

優れた自動化エンジニアは、コードを書く前に「データのライフサイクル」を考える。

単に値を書き込むだけのスクリプトは、メンテナンスコストを増大させるだけの負債だ。MS Projectのエンジンを最大限に活用し、「数式をデプロイする」という設計思想を持つこと。それが、バグを寄せ付けず、変化に強い、プロフェッショナルの業務ツールを構築するための唯一の道である。

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