Project VBAを掌握する:カスタムフィールドに「魂」を吹き込み、動的な納期管理を実現する
「マクロの記録」から一歩踏み出し、自分の手でロジックを組み立てたい……。そう願うようになったあなたは、今、エンジニアとして非常に重要な転換点に立っています。
こんにちは。今日は、Microsoft Project VBAの世界において、多くのユーザーが「壁」にぶつかる領域――「カスタムフィールドを用いた、高度な日付計算と自動化」についてお話ししましょう。
単に数値を書き換えるだけのマクロは、いわば「作業の代行」です。しかし、プロジェクトの状況(カレンダーや休日)を読み解き、動的に値を算出するコードを書くことは、いわば「意思を持ったシステムの構築」です。
ここをクリアすれば、Project VBAの基本はバッチリですよ。さあ、一緒に深淵を覗いてみましょう。
1. なぜ「単純な引き算」ではプロジェクト管理に勝てないのか?
初心者の方が最初に挑戦する日付計算は、おそらくこのようなものです。
`残日数 = 終了日 – 今日`
Excelならこれで十分かもしれません。しかし、プロジェクト管理の現場において、これは「不正確な情報」です。
なぜなら、プロジェクトには「休日(土日や祝日)」があるからです。
例えば、納期が来週の月曜日で、今日が金曜日だとしましょう。単純な計算では「3日」となりますが、プロジェクトの実態としては「稼働日は1日(金曜日のみ)」であるはずです。
この「カレンダー(休日)を考慮した計算」をVBAで自動化することこそが、中級者への登竜門となります。
2. アーキテクチャの理解:カスタムフィールドの「型」と「性質」
コードを書く前に、Project VBAのオブジェクト構造を整理しておきましょう。ここを曖昧にすると、実行時に「型が一致しません」というエラーの荒波に揉まれることになります。
カスタムフィールドの2つのアプローチ
Projectのカスタムフィールドには、大きく分けて2つの設定方法があります。
1. 数式(Formula)として設定する方法:
Projectの標準機能(数式エディタ)に計算式を書き込む方法です。動作は高速ですが、VBAで複雑な条件分岐(If文の入れ子など)を行うには限界があります。
2. VBAで値を「書き込む」方法:
VBAのロジックで計算を行い、その結果をカスタムフィールドに代入する方法です。今回私たちが目指すのはこちらです。 VBAなら、プロジェクト独自の休日カレンダーを読み込み、複雑なロジックを自由に組むことができます。
使用するフィールドの選択
日付を扱う場合は、必ず「日付型(Date)」のカスタムフィールド(例:`Date1`)を使用してください。テキスト型に日付を入れると、後で計算に使いたい時に再び型変換の手間が発生し、パフォーマンスを低下させます。
3. 実装:休日を考慮した「残稼働日数」算出ロジック
それでは、実際に「タスクの終了予定日」から「今日」までの「稼働日数」を算出し、カスタムフィールドに格納するコードを見ていきましょう。
Option Explicit
''' <summary>
''' 全タスクを走査し、終了日までの残り稼働日数をカスタムフィールドに書き込む
''' </summary>
Sub UpdateRemainingWorkingDays()
Dim t As Task
Dim targetField As Field
Dim startDate As Date
Dim endDate As Date
Dim workingDays As Long
' --- 設定エリア ---
' 結果を書き込むカスタムフィールドを指定(Date1を使用)
' ※事前にProject側で Date1 を「日付」型として定義しておいてください
Set targetField = FieldNameToField("Date1")
' ------------------
' パフォーマンス向上のため、画面更新を停止
Application.ScreenUpdating = False
On Error GoTo ErrorHandler
' プロジェクト内の全タスクをループ
For Each t In ActiveProject.Tasks
' タスクが空(削除済みなど)でないことを確認
If Not t Is Nothing Then
' タスクに「終了日」が設定されているかチェック
If t.Finish > Date Then
startDate = Date ' 今日からカウント開始
endDate = t.Finish
' 【核心部】稼働日数を計算する関数を呼び出し
workingDays = GetWorkingDaysBetween(startDate, endDate)
' カスタムフィールドに値を書き込む
' ※Date型フィールドに数値を書き込む際は、日付として解釈されないよう注意が必要ですが、
' ここでは「残り日数」を可視化するため、便宜上「今日 + 残日数」を書き込むか、
' もしくはテキスト型フィールド(Text1等)への書き込みを推奨します。
' 今回は「Text1」に「〇日」という形式で書き込む例とします。
t.Text1 = workingDays & " 日"
Else
' 納期が過ぎている、または今日以前の場合はリセット
t.Text1 = "期限超過"
End If
End If
Next t
Application.ScreenUpdating = True
MsgBox "更新が完了しました!", vbInformation
Exit Sub
ErrorHandler:
Application.ScreenUpdating = True
MsgBox "エラーが発生しました: " & Err.Description, vbCritical
End Sub
''' <summary>
''' 2つの日付間の稼働日数を計算する(土日を除外)
''' </summary>
''' <param name="start">開始日</param>
''' <param name="end">終了日</param>
''' <returns>稼働日数</returns>
Function GetWorkingDaysBetween(start As Date, end As Date) As Long
Dim d As Date
Dim count As Long
count = 0
' 開始日から終了日まで1日ずつループして判定
For d = start To end
' Weekday関数で土日(1=日曜, 7=土曜)を除外
' ※プロジェクト独自の祝日設定を考慮する場合は、ここに条件を追加します
If Weekday(d) <> vbSunday And Weekday(d) <> vbSaturday Then
count = count + 1
End If
Next d
GetWorkingDaysBetween = count
End Function
4. プロフェッショナルの視点:陥りやすい罠と最適化
このコードを実戦投入する前に、設計者として知っておくべき「重み」があります。
① 「Nothing」オブジェクトの恐怖
`For Each t In ActiveProject.Tasks` でループを回す際、タスクを削除した直後のプロジェクトでは、コレクションの中に「中身が空(Nothing)」の要素が混じることがあります。これを無視して `t.Finish` にアクセスすると、即座に実行時エラーで止まります。必ず `If Not t Is Nothing Then` でガードを固めてください。
② 計算コストのコントロール
上記の `GetWorkingDaysBetween` 関数は、日付を1日ずつループして判定しています。タスク数が数百程度なら一瞬ですが、数万タスクある大規模プロジェクトでは、このループが積み重なり、マクロの実行が非常に重くなります。
大規模プロジェクト向けのアドバイス:
もし速度が問題になるなら、ループではなく、数学的な計算(1週間あたりの稼働日数を掛ける方法)に切り替えるか、あらかじめ祝日リストを配列に読み込んでおき、高速に照合する設計にアップグレードしましょう。
③ フィールド型のミスマッチ
コード例では、分かりやすさを優先して `Text1`(テキスト型)に「〇日」という文字列を書き込みました。もしあなたが `Date1`(日付型)に書き込みたいなら、計算結果は「日付」である必要があります。
「残り日数」そのものを日付型に入れることは論理的に矛盾するため、「残日数はText1、納期はDate1」というように、データの性質に応じたフィールド設計を意識してください。これこそが、アーキテクトの仕事です。
結びに代えて
いかがでしたでしょうか?
単なる「引き算」を「カレンダーを考慮したロジック」へと昇華させる。このプロセスこそが、プログラミングの本質です。
最初はエラーが出るかもしれません。型が合わなかったり、意図しない日付が返ってきたりすることもあるでしょう。しかし、そのエラーこそが、オブジェクトのライフサイクルやデータの性質を教えてくれる最高の教師です。
一歩ずつ、確実に。
コードに魂を込め、プロジェクトを支える強力なツールを作り上げてください。応援していますよ。
