聖域の防衛:MS Project カスタムフィールドのロジックを隠蔽する「分離型アーキテクチャ」の極意
業務自動化の最前線に立つエンジニアにとって、最大のジレンマは「高度な計算ロジック(知的財産)」と「配布の容易性」のトレードオフである。
MS Projectを用いた大規模プロジェクト管理において、カスタムフィールド(Task/Resource)に複雑なビジネスロジックを組み込むことは常套手段だ。しかし、VBAの`.Formula`プロパティに直接数式を書き込む手法は、素人に対する公開文書を配布しているに等しい。ユーザーが「カスタムフィールド」ダイアログを開いた瞬間、貴殿が血の滲むような思いで構築したアルゴリズムは、無防備に白日の下にさらされる。
本稿では、VBAの難読化という「小手先の術」を捨て、ロジックをコンパイル済みの外部バイナリへと封印し、MS Projectのオブジェクトモデルと高度に連携させる「分離型アーキテクチャ」の構築手法を解説する。
1. 脆弱な設計:なぜ `.Formula` ではいけないのか
一般的な開発者は、以下のようなコードを書く。
' --- 避けるべきアンチパターン ---
Sub SetFormulaBad()
Dim t As Task
' ロジックが文字列としてそのまま露出する
ActiveProject.Tasks(1).CustomFields("ComplexityIndex").Formula = _
"([Cost]/[Duration]) * [ResourceLevel] * 1.25"
End Sub
この手法には致命的な欠陥が2つある。
1. ロジックの露出: `CustomFields` プロパティにセットした数式は、MS ProjectのUI上で誰でも閲覧可能である。
2. 保守性の欠如: 数式が複雑になればなるほど、デバッグは困難になり、型定義の不整合によるランタイムエラーが頻発する。
真のアーキテクトは、「数式(Formula)を計算させるのではなく、計算結果(Value)を注入する」というパラダイムシフトを選択する。
2. 堅牢な設計:.NETによるロジックの外部化とCOMインターフェース
ロジックを保護する唯一の確実な方法は、計算エンジンをVBAの外、すなわちコンパイルされたDLL(Managed Code)へと隔離することである。ここでは、C#を用いたCOM Exposed Libraryの構築プロセスを辿る。
Step 1: C# による計算エンジンの実装
ロジックを隠蔽し、かつMS Projectから呼び出し可能にするため、`ComVisible` 属性を付与したクラスライブラリを作成する。
using System;
using System.Runtime.InteropServices;
namespace ProjectLogicEngine
{
// COMインターフェースの定義:VBAから見える窓口を最小限にする
[Guid("YOUR-GUID-HERE-0001")] // 実際には生成したGUIDを使用
[InterfaceType(ComInterfaceType.InterfaceIsDual)]
public interface IComplexityCalculator
{
// ロジックをブラックボックス化
double CalculateIndex(double cost, double duration, int resourceLevel);
}
[Guid("YOUR-GUID-HERE-0002")]
[ClassInterface(ClassInterfaceType.None)]
[ComVisible(true)]
public class ComplexityCalculator : IComplexityCalculator
{
public double CalculateIndex(double cost, double duration, int resourceLevel)
{
// ここに極めて複雑な、秘匿すべきビジネスロジックを記述する
// 数式を直接見せることは不可能である
if (duration <= 0) return 0;
double baseValue = (cost / duration) * resourceLevel;
double multiplier = Math.Log(baseValue + 1) * 1.42; // 秘匿された係数
return Math.Round(multiplier, 2);
}
}
}
Step 2: DLLの登録と難読化
ビルドしたDLLは、`RegAsm.exe` を用いてCOMに登録する。この際、商用環境であれば Dotfuscator 等の難読化ツールを適用し、中間言語(MSIL)を解析不能な状態に追い込む。これにより、リバースエンジニアリングによるロジックの奪取を極限まで困難にする。
3. 統合:VBAによるオーケストレーションとメモリ管理
次に、MS Project側のVBAが、この「ブラックボックス」をどのように制御するかを定義する。ここで重要なのは、オブジェクトのライフサイクル管理である。COMオブジェクトを適切に解放しなければ、MS Projectプロセスがメモリに居座り続け、システム全体のパフォーマンスを毀損する。
' --- 伝説的アーキテクトによる実装例 ---
Option Explicit
' 外部DLLのインターフェースを定義
' ※本来は参照設定またはLate Bindingを用いる
Private Sub CalculateAllTaskComplexity()
Dim engine As Object
Dim t As Task
Dim cost As Double
Dim duration As Double
Dim resLevel As Integer
Dim result As Double
On Error GoTo ErrorHandler
' 1. COMオブジェクトの生成 (Late Bindingによる柔軟な運用)
' 実行環境にDLLが登録されていることが前提
Set engine = CreateObject("ProjectLogicEngine.ComplexityCalculator")
' 2. プロジェクト内のタスクを走査
For Each t In ActiveProject.Tasks
If Not t Is Nothing Then
' プロパティの抽出
cost = t.Cost
duration = t.Duration / 480 ' 分単位を日単位に変換(環境依存に注意)
resLevel = t.ResourceLevel ' 仮のプロパティ
' 3. 外部エンジンによる計算 (ロジックはここには存在しない)
result = engine.CalculateIndex(cost, duration, resLevel)
' 4. 計算結果をカスタムフィールドへ直接書き込み
' Formulaは空にしておき、Valueのみを操作する
t.CustomFields("ComplexityIndex").Value = result
End If
Next t
CleanUp:
' 5. 極めて重要なメモリ解放プロセス
' オブジェクトの参照を明示的に切り離し、COM参照カウントを減らす
Set engine = Nothing
Exit Sub
ErrorHandler:
MsgBox "Critical Error in Calculation Engine: " & Err.Description, vbCritical
Resume CleanUp
End Sub
アーキテクトの視点:なぜ `Value` への注入なのか
この設計の肝は、`CustomFields(“Name”).Formula` を一切触らないことにある。
ユーザーがカスタムフィールドの設定画面を開いても、そこには「数式」は存在せず、ただ「計算された値」が表示されるだけだ。ロジックは、実行時にのみメモリ上で展開される。これが、知的財産を保護するための「物理的な隔離」である。
4. パフォーマンスと堅牢性の極限
大規模プロジェクト(数万タスク規模)において、このプロセスを走らせる場合、以下の2点に留意せよ。
1. 計算のトリガー制御:
`Project_Calculate` イベント内でこのロジックを動かすのは愚策だ。計算のたびにCOM呼び出しが発生し、UIのレスポンスが死ぬ。計算が必要なタイミング(特定のボタン押下時や、プロジェクト保存時など)に限定的に実行する「オンデマンド型」を採用せよ。
2. Windows APIによる最適化:
もし、タスクの走査自体がボトルネックになるほど巨大なプロジェクトを扱うならば、VBAの `For Each` を捨て、Windows APIを用いたメモリ操作や、より低レイヤーなプロセス制御を検討する余地がある。しかし、通常は「COM呼び出しの回数を最小化する(バッチ処理化)」ことで解決できる。
結論
VBAは優れたオーケストレーター(指揮者)であるが、重厚なロジックを担うべき演奏者(楽器)ではない。
ロジックをコンパイルされたDLLへと移譲し、VBAは単なる「データの橋渡し」に徹する。この分離こそが、エンタープライズ・レベルの自動化システムにおける、堅牢性と機密性を両立させる唯一の解である。
技術の深淵へ、さらなる探求を。
