【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のエンジンを最大限に活用し、「数式をデプロイする」という設計思想を持つこと。それが、バグを寄せ付けず、変化に強い、プロフェッショナルの業務ツールを構築するための唯一の道である。
