【実務・中級編】【中級者向け】カスタムフィールドの数式に「IF文」をネストせず、VBAで計算結果を直接書き込む手法 – Project VBA解析バイブル

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

Formula Hellを脱却せよ:MS Projectのカスタムフィールドを「計算式」ではなく「VBA」で支配する設計思想

MS Projectを使って高度なプロジェクト管理ツールを構築しようとする際、多くのエンジニアが最初にぶち当たる壁がある。それは、「カスタムフィールドの計算式(Formula)の限界」だ。

「もし期間が〇〇日以上で、かつリソースのコストが××円を超えていたら、ステータスを『要警戒』にする」

このようなビジネスロジックを実装しようとしたとき、君たちはどうするだろうか?
おそらく、Projectのカスタムフィールド設定画面を開き、`IIf(IIf(…, …, …), …, …)` といった、目が眩むようなネスト(入れ子)構造のIF文を書き始めるはずだ。

止めてくれ。それは「設計」ではない。単なる「妥協」だ。

本記事では、中級者以上のエンジニアに向けて、Projectの計算式エンジンに頼らず、VBA側でロジックを完結させ、計算結果をカスタムフィールドへ「押し込む(Push)」プロフェッショナルな手法を伝授する。

1. なぜ「計算式(Formula)」は現場で牙を剥くのか

Projectのカスタムフィールドに直接数式を書き込む手法には、実務運用において3つの致命的な欠陥がある。

① 再計算コストによるパフォーマンスの劣化

Projectの計算式は、タスクの期間、日付、リソースの割り当てなど、プロジェクト内の何らかの属性が変更されるたびに、エンジンが全タスクに対して再計算を試みる。ネストが深く、複雑な条件式が大量に存在する場合、ユーザーが1つの日付を動かすだけで、アプリケーションが数秒間フリーズする事態を招く。これは、大規模プロジェクトにおいては致命的なUXの低下だ。

② デバッグと保守の不可能性

数式は「ブラックボックス」だ。VBAならステップ実行(F8)によって、どの条件分岐で計算が狂ったのかを一行ずつ追える。しかし、数式の中に潜むロジックのバグを見つけるには、延々と条件式を書き換え、プロジェクトを更新し続けるという、極めて非効率な作業を強いられることになる。

③ ロジックの拡張性欠如

「外部のExcelファイルからマスターデータを参照したい」「データベースのAPIを叩いて最新のレートを取得したい」といった要求に対し、カスタムフィールドの数式は無力だ。

2. 設計思想の転換:Pull型からPush型へ

プロフェッショナルなアーキテクトは、計算モデルを以下のように切り替える。

  • 従来のPull型(Formula方式):

Projectのセルが、計算式という「網」を投げ、その都度条件に合う値を「引き寄せる」。

  • 推奨されるPush型(VBA方式):

VBAがロジックという「エンジン」を回し、計算結果を確定させた上で、カスタムフィールドという「器」に値を「書き込む」。

この設計により、計算のタイミングを「ユーザーがボタンを押した時」や「特定の処理の直後」に完全に制御できる。計算コストは、必要な時に、必要な回数だけ発生する。

3. 実践:堅牢なプロダクションコードの実装

では、具体的にどのように実装すべきか。
以下の例では、「タスクの期間、コスト、優先度」に基づき、複雑なリスクスコアを算出し、`Text1` フィールドに書き込むロジックを実装する。

ここでは、「ロジック(計算)」と「実行(ループと書き込み)」を分離するという、保守性の高い設計パターンを採用する。

Option Explicit

''' <summary>
''' プロジェクト全体のカスタムフィールドを一括更新するメインルーチン
''' </summary>
Public Sub UpdateTaskRiskStatus()
    Dim t As Task
    Dim errorCount As Long
    
    ' パフォーマンス向上のための定石:画面更新と再計算の停止
    On Error GoTo ErrorHandler
    Application.ScreenUpdating = False
    
    Debug.Print "--- Risk Status Update Started ---"

    ' タスクのイテレーション
    For Each t In ActiveProject.Tasks
        ' 空のタスク(削除済みタスクなど)はスキップ
        If Not t Is Nothing Then
            If Not t.Summary Is True Then ' サマリータスクを除外する場合
                
                ' 1. ロジックの実行(計算結果を直接取得)
                ' 2. 結果をカスタムフィールド(Text1)へ書き込み
                t.Text1 = CalculateRiskScore(t)
                
            End If
        End If
    Next t

    Debug.Print "--- Update Completed Successfully ---"

CleanUp:
    Application.ScreenUpdating = True
    Exit Sub

ErrorHandler:
    errorCount = errorCount + 1
    Debug.Print "Error updating Task: " & t.Name & " - " & Err.Description
    Resume CleanUp
End Sub

''' <summary>
''' ビジネスロジックをカプセル化した関数
''' ここに「IF文のネスト」を恐れず、複雑なロジックを記述する
''' </summary>
''' <param name="targetTask">計算対象のタスクオブジェクト</param>
''' <returns>計算結果の文字列</returns>
Private Function CalculateRiskScore(ByVal targetTask As Task) As String
    Dim score As Integer
    Dim duration As Double
    Dim cost As Double
    
    ' データの抽出
    duration = targetTask.Duration / 480 ' 分単位を「日」に換算(8時間稼働想定)
    cost = targetTask.Cost
    
    ' --- 複雑なビジネスロジックの記述 ---
    ' 数式では困難な、多角的な条件分岐
    score = 0
    
    ' 条件1: 期間による重み付け
    If duration > 20 Then
        score = score + 30
    ElseIf duration > 10 Then
        score = score + 15
    End If
    
    ' 条件2: コストによる重み付け
    If cost > 1000000 Then
        score = score + 50
    ElseIf cost > 500000 Then
        score = score + 20
    End If
    
    ' 条件3: 優先度(Priority)との組み合わせ
    ' ProjectのPriorityは1〜1000の整数
    If targetTask.Priority > 500 And score > 40 Then
        score = score + 20
    End If
    
    ' --- 最終判定 ---
    Select Case score
        Case Is >= 80
            CalculateRiskScore = "【極めて高い】" & score & "pts"
        Case Is >= 50
            CalculateRiskScore = "【注意】" & score & "pts"
        Case Else
            CalculateRiskScore = "【正常】" & score & "pts"
    End Select
    
End Function

4. アーキテクトが教える、運用のための「鉄則」

この手法を実務に投入する際、以下の3点に留意せよ。これこそが、ツールを「動くコード」から「業務システム」へと昇華させる差だ。

① 外部データ連携のパターン

`CalculateRiskScore` 関数の中で、外部のExcelブックやCSV、あるいはSQL Serverなどのデータベースにアクセスするロジックを組み込むことが容易になる。
ただし、ループの中で毎回ファイルを開いてはならない。「最初に全データをメモリ上のDictionaryオブジェクトにロードし、ループ内ではそのメモリを参照する」。これが、プロフェッショナルが守るべきパフォーマンスの鉄則だ。

② エラーハンドリングの局所化

上記のコード例では、タスクごとのエラーをキャッチして処理を続行できるようにしている。プロジェクト全体がクラッシュしては意味がない。特定のタスクのデータが不正(例:コストが負の値など)であっても、ログを残して次のタスクへ進む「堅牢な継続性」を設計に組み込め。

③ ユーザーへの通知

計算結果を書き込んだ後、`MsgBox` で「〇件のタスクを更新しました」と表示するか、あるいは更新ログを専用のテキストファイルに書き出す仕組みを持たせると、ツールの信頼性は飛躍的に向上する。

結論

Project VBAにおけるカスタムフィールドの扱いは、単なる「値の入力」ではない。それは、プロジェクトの意思決定を支える「データエンジニアリング」の一環である。

数式のネストに逃げるのをやめ、ロジックをコードとして管理せよ。それが、バグを排除し、パフォーマンスを最大化し、真に価値のある業務自動化ツールを生み出す唯一の道である。

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