【入門編】【中級者向け】複数のカスタムフィールドを連動させ、階層的な選択肢を構築するロジック – Project VBA解析バイブル

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

Project VBAの極致:カスタムフィールドの階層的連動ロジックを実装する

「マクロの記録は卒業したけれど、やりたいことを実現するにはどうコードを書けばいいのか分からない……」
「親フィールドで『部門』を選んだら、子フィールドの『担当者』の選択肢をその部門のものだけに制限したい。でも、Projectにはそんな機能がない……」

もしあなたが今、そんな壁にぶつかっているとしたら、おめでとうございます。あなたは今、「単なる自動化」から「システムの構築」へとステップアップする境界線に立っています。

こんにちは。今日は、Microsoft Project VBAにおけるカスタムフィールドの高度な運用テクニック、「階層的な選択肢の動的制御」についてお話ししましょう。

これは、Excelのデータの入力規則のように「親の選択によってリストが変わる」という挙動を、Projectのカスタムフィールドで擬似的に実現する方法です。一見難しそうに見えますが、オブジェクトの動きを理解すれば、決して恐れることはありません。

さあ、一緒に極限の知見へと踏み込んでいきましょう。

1. なぜ「標準機能」だけでは足りないのか?

Microsoft Projectのカスタムフィールドは非常に強力ですが、一つ大きな弱点があります。それは、「フィールド間の相互作用を持たない」ということです。

例えば、以下のような運用をしたい場合を考えてみてください。

1. カスタムフィールド1(親): 「プロジェクト種別」(例:開発、運用、保守)を選択
2. カスタムフィールド2(子): 「作業区分」(例:設計、実装、テスト / または、監視、トラブル対応)

標準機能では、ユーザーは「開発」を選んだ後に、誤って「監視」という作業区分を入力できてしまいます。これではデータの整合性が崩れ、後で集計する際に地獄を見ることになります。

これを防ぐには、「親の値が変わったら、子の値をチェックし、不適切な場合はクリアまたは警告を出す」というロジックを、VBAでイベント駆動型に実装する必要があるのです。

2. アーキテクチャの設計:イベント駆動型の思考

ここで重要になるのが、`Project_Calculate` イベントの活用です。

Project VBAにおいて、セル(タスク)の値が書き換わったことを検知できる最も確実なタイミングは、プロジェクトの再計算が行われる瞬間です。

実装の戦略

1. トリガー: `Project_Calculate` イベントが発生。
2. ループ: 全てのタスク(またはリソース)を走査。
3. 判定: 「親フィールド」の値を確認。
4. 検証: 「子フィールド」の値が、親の値に対して「許可されたリスト」に含まれているか照合。
5. アクション: 不一致なら、値をクリアするか、エラーメッセージを表示する。

【ここでプロの警告!】
`Calculate` イベント内でフィールドの値を書き換えると、再び `Calculate` イベントが呼び出されます。 これを制御しないと、プログラムが自分自身を無限に呼び出し続ける「無限ループ」に陥り、Projectがフリーズします。これを防ぐために「フラグ(Flag)」というテクニックを使います。

3. 実装コード:階層的バリデーション・エンジン

それでは、実際に動くコードを見ていきましょう。今回は「タスク」に対して、カスタムフィールド(Text1を親、Text2を子と仮定)を制御する例を作成します。

以下のコードを、VBAエディタの `ThisProject` モジュールに貼り付けてください。

Option Explicit

' 無限ループを防ぐためのフラグ
Private IsProcessing As Boolean

''' <summary>
''' プロジェクトの再計算時に自動実行されるイベント
''' </summary>
Private Sub Project_Calculate()
    Dim t As Task
    
    ' すでに処理中であれば、再帰呼び出しを防止して抜ける
    If IsProcessing Then Exit Sub
    
    ' 処理開始フラグを立てる
    IsProcessing = True
    
    On Error GoTo ErrorHandler
    
    ' 全てのタスクをループしてチェック
    For Each t In ActiveProject.Tasks
        ' 空のタスクはスキップ
        If Not t Is Nothing Then
            ' 階層ロジックの実行
            Call ValidateHierarchy(t)
        End If
    Next t

CleanUp:
    ' 処理終了フラグを戻す
    IsProcessing = False
    Exit Sub

ErrorHandler:
    MsgBox "エラーが発生しました: " & Err.Description, vbCritical
    Resume CleanUp
End Sub

''' <summary>
''' 親フィールドの値に基づいて、子フィールドの整合性を検証するコアロジック
''' </summary>
''' <param name="targetTask">検証対象のタスク</param>
Private Sub ValidateHierarchy(targetTask As Task)
    Dim parentVal As String
    Dim childVal As String
    
    ' カスタムフィールドの取得 (Text1=親, Text2=子)
    parentVal = targetTask.Text1
    childVal = targetTask.Text2
    
    ' 親が空の場合は子もクリアして終了
    If parentVal = "" Then
        If childVal <> "" Then targetTask.Text2 = ""
        Exit Sub
    End If
    
    ' --- ルックアップテーブル(階層定義) ---
    ' ここで「どの親に対して、どの子が許可されるか」を定義します
    Select Case parentVal
        Case "開発"
            ' 「開発」の時は「設計」「実装」「テスト」のみ許可
            If childVal <> "" And Not IsInList(childVal, Array("設計", "実装", "テスト")) Then
                targetTask.Text2 = "" ' 不適合ならクリア
                ' ユーザーに知らせる場合は、ここをコメントアウトして警告を出すことも可能
                ' MsgBox "タスク [" & targetTask.Name & "] の作業区分が不正です。", vbExclamation
            End If
            
        Case "運用"
            ' 「運用」の時は「監視」「保守」のみ許可
            If childVal <> "" And Not IsInList(childVal, Array("監視", "保守")) Then
                targetTask.Text2 = ""
            End If
            
        Case "保守"
            ' 「保守」の時は「部品交換」「修理」のみ許可
            If childVal <> "" And Not IsInList(childVal, Array("部品交換", "修理")) Then
                targetTask.Text2 = ""
            End If
            
    End Select
End Sub

''' <summary>
''' 値が配列(許可リスト)に含まれているか判定するヘルパー関数
''' </summary>
Private Function IsInList(val As String, list As Variant) As Boolean
    Dim item As Variant
    For Each item In list
        If item = val Then
            IsInList = True
            Exit Function
        End If
    Next item
    IsInList = False
End Function

4. コードの深層解剖:なぜこう書くのか?

このコードには、実務で通用する「プロの作法」が詰まっています。

① `IsProcessing` フラグによる再帰防止

ここが最大のポイントです。`targetTask.Text2 = “”` と値を書き換えた瞬間、Projectは「あ、データが変わった!再計算しなきゃ!」と判断し、再び `Project_Calculate` を呼び出します。
もしフラグがなければ、`Calculate` $\rightarrow$ `書き換え` $\rightarrow$ `Calculate` $\rightarrow$ `書き換え`……と無限に続き、PCのメモリを食いつぶします。`IsProcessing` は、この連鎖を断ち切るための「防波堤」です。

② `Select Case` によるルックアップテーブル

`If…ElseIf` を羅列するのではなく、`Select Case` を使うことで、ロジックの可読性を高めています。将来的に「プロジェクト種別」が増えたとしても、`Case` 文を追加するだけで対応できるため、メンテナンス性が非常に高い設計です。

③ ヘルパー関数 `IsInList` の分離

「値がリストに含まれているか?」という判定ロジックを独立した関数に切り出しています。これにより、メインのロジック(`ValidateHierarchy`)が「何をしているか」に集中でき、コードがスッキリします。これは、複雑なシステムを構築する際の鉄則です。

5. 陥りやすいエラーと回避策

この実装を進めるにあたって、以下の点に注意してください。

1. パフォーマンスの低下:
タスク数が数千件規模になると、全てのタスクを毎回ループするのは重くなります。その場合は、`Calculate` イベントではなく、特定の操作(ボタンクリック等)で行うか、変更があったタスクのみを特定するロジックを検討する必要があります。
2. ユーザーへの通知:
上記のコードでは、不適切な値が入った場合に「黙って消す」設定にしています。しかし、ユーザーからすれば「なぜか入力が消える!」と混乱を招く可能性があります。実務では、`MsgBox` で警告を出すか、あるいは別のカスタムフィールド(Text3など)に「エラー:入力値が不正です」と表示させるのが親切な設計です。

まとめ:ここをクリアすれば、Project VBAの基本はバッチリですよ

いかがでしたでしょうか?

単に「値を書き換えるマクロ」を作るだけなら、マクロの記録でも可能です。しかし、「データの整合性を保ち、ユーザーの誤操作を防ぐ仕組み」を作るには、今回のようなイベント制御とロジックの設計が必要になります。

  • イベントの特性を知る
  • 無限ループを制御する(フラグ管理)
  • ロジックを構造化する(Select Case / ヘルパー関数)

この3点をマスターすれば、あなたの作るProjectツールは、単なる便利ツールから「信頼される業務システム」へと進化します。

一歩ずつ、確実に。プロフェッショナルの道を楽しんで進んでいきましょう!

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