【テクニカル・上級編】【上級者向け】カスタムフィールドの定義と数式を暗号化・難読化して配布するライブラリ作成 – Project VBA解析バイブル

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

聖域の防衛: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は単なる「データの橋渡し」に徹する。この分離こそが、エンタープライズ・レベルの自動化システムにおける、堅牢性と機密性を両立させる唯一の解である。

技術の深淵へ、さらなる探求を。

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