MS Project VBAを掌握する:スキルベース・リソースマッチングエンジンの設計思想
プロジェクトの規模が拡大し、タスク数とリソース数が指数関数的に増大する局面において、「誰をアサインすべきか」という判断は、もはや人間の直感に頼るべきではない。それは計算可能なロジックであるべきだ。
多くの開発者が、MS Projectのカスタムフィールドを単なる「メモ書き」として使い、VBAで「なんとなく」ループを回して値を読み取る。そのような「スクリプト」レベルのコードは、プロジェクトが複雑化した瞬間に、計算速度の低下、予期せぬ型エラー、そしてデータの不整合という形で牙を剥く。
本稿では、カスタムフィールドを「構造化データ」として扱い、リソースのスキルレベルに基づいた高精度なマッチングエンジンを構築するための、プロフェッショナルな設計手法と実装を伝授する。
1. データスキーマの定義:カスタムフィールドを「DB」として扱う
エンジニアが陥る最大の罠は、MS Projectのカスタムフィールド(`Text1`, `Number1`など)を、単なる変数として扱うことだ。これでは保守性は皆無だ。
まず、アプリケーション(プロジェクト)全体で共有されるデータスキーマを定義せよ。リソースとタスクの間に「共通の言語」を持たせる必要がある。
設計例:スキル管理スキーマ
| オブジェクト | フィールド名 (プロパティ) | 役割 | 例 |
|---|---|---|---|
| Task | `Text1` (RequiredSkill) | 要求されるスキル種別 | “VBA”, “Python”, “PM” |
| Task | `Number1` (MinSkillLevel) | 要求される最小レベル | 3 |
| Resource | `Text2` (SkillType) | 保有スキル種別 | “VBA” |
| Resource | `Number2` (SkillLevel) | 保有スキルレベル | 5 |
このように、タスク側には「要求(Requirement)」、リソース側には「能力(Capability)」を定義する。この定義が揺らぐと、マッチングエンジンはゴミ(Garbage In, Garbage Out)を生成する。
2. アルゴリズムの最適化:$O(n^2)$ の地獄を回避せよ
初心者は、タスクのループの中で、毎回リソースの全件をループする。
' 非効率な設計(アンチパターン)
For Each t In ActiveProject.Tasks
For Each r In ActiveProject.Resources
' 照合ロジック
Next
Next
タスクが1,000、リソースが100ある場合、10万回の比較が発生する。これは「動く」が「実用的ではない」コードだ。
プロフェッショナルは、Dictionaryオブジェクト(連想配列)を用いて、リソースを事前にインデックス化(ハッシュマップ化)する。これにより、検索コストを劇的に下げ、計算量を $O(n \times m)$ から $O(n + m)$ に近づけることが可能になる。
3. プロダクションコード:堅牢なマッチングエンジンの実装
以下に、実務でそのまま利用可能な、エラーハンドリングとパフォーマンスを考慮した実装例を示す。このコードは、単に割り当てるだけでなく、「最適な(レベルが最も近い、または条件を満たす)リソース」を特定するロジックの雛形である。
Option Explicit
' ==============================================================================
' Module: ResourceMatchingEngine
' Description: スキルレベルに基づくリソースの自動割当エンジン
' ==============================================================================
' カスタムフィールドのインデックス定義(保守性を高めるため定数化)
Private Const TASK_REQ_SKILL_IDX As Integer = 1 ' Text1: 要求スキル
Private Const TASK_MIN_LEVEL_IDX As Integer = 1 ' Number1: 最小レベル
Private Const RES_SKILL_TYPE_IDX As Integer = 2 ' Text2: 保有スキル
Private Const RES_SKILL_LEVEL_IDX As Integer = 2 ' Number2: 保有レベル
Public Sub ExecuteAutoAssignment()
Dim proj As MSProject.Project
Set proj = ActiveProject
' 1. リソース情報のインデックス化 (Dictionaryを使用)
' Key: SkillType, Value: Collection of Resource Objects
Dim resMap As Object
Set resMap = CreateObject("Scripting.Dictionary")
On Error GoTo ErrorHandler
' 高速化のための設定
Application.Calculation = pjManualCalculation
' --- リソースのスキャン ---
Dim res As MSProject.Resource
For Each res In proj.Resources
If Not res Is Nothing Then
' スキルが定義されているリソースのみを対象とする
Dim sType As String
sType = res.Text(RES_SKILL_TYPE_IDX)
If sType <> "" Then
If Not resMap.Exists(sType) Then
Set resMap(sType) = New Collection
End If
resMap(sType).Add res
End If
End If
Next res
' --- タスクのマッチング実行 ---
Dim t As MSProject.Task
Dim bestRes As MSProject.Resource
Dim matchedCount As Long: matchedCount = 0
For Each t In proj.Tasks
' 空のタスクや、要件が未定義のタスクはスキップ
If Not t Is Nothing Then
If t.Text(TASK_REQ_SKILL_IDX) <> "" And t.Number(TASK_MIN_LEVEL_IDX) > 0 Then
' 最適なリソースを探索
Set bestRes = FindBestResource(resMap, t.Text(TASK_REQ_SKILL_IDX), t.Number(TASK_MIN_LEVEL_IDX))
If Not bestRes Is Nothing Then
' 割り当て実行
t.AssignResource bestRes
matchedCount = matchedCount + 1
End If
End If
End If
Next t
MsgBox "マッチング完了: " & matchedCount & " 件のタスクを割り当てました。", vbInformation
CleanUp:
Application.Calculation = pjAutomaticCalculation
Exit Sub
ErrorHandler:
MsgBox "致命的なエラーが発生しました: " & Err.Description, vbCritical
Resume CleanUp
End Sub
''' <summary>
''' 指定されたスキル要件を満たす最適なリソースを検索する
''' </summary>
Private Function FindBestResource(ByRef resMap As Object, _
ByVal reqSkill As String, _
ByVal minLevel As Double) As MSProject.Resource
Dim res As MSProject.Resource
Dim currentBest As MSProject.Resource
Dim maxLevel As Double: maxLevel = -1
' 指定スキルを持つリソース群が存在するか確認
If Not resMap.Exists(reqSkill) Then
Set FindBestResource = Nothing
Exit Function
End If
' コレクション内をループして、条件を満たす中で「最もレベルが高い」リソースを探す
' (単なる一致ではなく、最適化のロジック)
For Each res In resMap(reqSkill)
Dim resLevel As Double
resLevel = res.Number(RES_SKILL_LEVEL_IDX)
If resLevel >= minLevel Then
If resLevel > maxLevel Then
maxLevel = resLevel
Set currentBest = res
End If
End If
Next res
Set FindBestResource = currentBest
End Function
4. アーキテクトの視点:設計上の注意点
このコードをプロダクション環境に投入する際、以下の3点を必ず考慮せよ。
① データの整合性(Data Integrity)
VBAは、`Text1`に文字列を入れるべきところに、ユーザーが誤って数字を入れてもエラーを出しにくい。実務ツールでは、マッチング前に「カスタムフィールドのバリデーション(入力チェック)」を行う関数を組み込むべきだ。
② ライフサイクルと再実行の設計
このエンジンを「何度も実行する」場合、既存の割り当てをどう扱うかを決めておく必要がある。
- 上書き型: 常に最新のスキルに基づき、既存のアサインを解除して再割り当てする。
- 追加型: 未割り当てのタスクのみを対象とする。
本コードは「追加型」に近い動きをするが、実務では「一度割り当てたリソースを固定するフラグ」を検討すべきだ。
③ 計算負荷の制御
`Application.Calculation = pjManualCalculation` は必須だ。リソースを割り当てるたびにMS Projectがスケジュールの再計算を行うと、タスク数が多い場合に処理が数分単位で止まる。エンジンの外側で計算制御を行うのが、プロの作法である。
結論
カスタムフィールドを活用した自動化は、単なる「作業の短縮」ではない。それは、プロジェクトの意思決定プロセスを、属人的な経験から、客観的なデータへと昇華させるプロセスである。
コードを書く前に、まずデータ構造(スキーマ)を設計せよ。そして、計算量を意識したアルゴリズムを選べ。それが、バグのない、そして信頼されるツールを生む唯一の道である。
