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

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

【極限の知見】MS Projectの知的財産を守り抜け:カスタムフィールドのロジックを隠蔽するプロフェッショナル設計論

MS Projectを利用した業務自動化ツールを社内、あるいはクライアントへ配布する際、多くの開発者が陥る致命的な罠がある。それは、「自社独自の計算ロジック(アルゴリズム)を、MS Projectのカスタムフィールドの『数式(Formula)』として書き込んでしまうこと」だ。

MS ProjectのUIを開けば、カスタムフィールドに設定された数式は平文で誰にでも閲覧可能である。君が数千行のコードを費やして構築した複雑なクリティカルパス判定や、高度なリソース平準化ロジックが、たった一行の「数式コピー」で盗用される——。これが、プロフェッショナルなアーキテクトが最も忌むべき事態である。

本稿では、カスタムフィールドを「計算の場」としてではなく、単なる「結果の格納庫(Data Store)」として再定義し、ロジックを外部DLLに封じ込めることで、解析不能な堅牢なツールへと昇華させる設計手法を伝授する。

1. 脆弱な設計 vs 堅牢な設計:パラダイムシフト

まず、君が今書こうとしているコードがどちらに属するか、自問自答してほしい。

❌ 脆弱な設計(Formula-Driven Approach)

カスタムフィールドの `Formula` プロパティに直接ロジックを書き込む手法。

  • リスク: 数式がUI上で丸見え。VBAを難読化しても、MS Projectのフィールド設定画面を見ればロジックが露呈する。
  • 限界: 複雑な条件分岐(If-Then-Elseの入れ子)や、外部データベースとの照合、API連携といった高度な処理は、数式内では不可能。

✅ 堅牢な設計(Engine-Driven Approach)

カスタムフィールドは「値を表示するための器」に徹し、計算ロジックは「外部のコンパイル済みバイナリ(DLL)」に隠蔽する手法。

  • メリット: ロジックはDLL内に隠蔽され、逆コンパイルへの対策(難読化)も容易。
  • 拡張性: .NETの強力なライブラリや、外部DB、Web APIとの連携がシームレスに行える。

2. アーキテクチャの全体像

我々が構築するのは、以下の3層構造である。

1. Presentation Layer (MS Project UI): ユーザーが結果を確認する場所。カスタムフィールドには計算結果の「値」だけが格納される。
2. Orchestration Layer (VBA): MS Projectのオブジェクトモデルを走査し、計算エンジン(DLL)へデータを渡し、戻ってきた結果をフィールドに書き戻す「司令塔」。
3. Logic Layer (VB.NET/C# DLL): 知的財産の核心。計算ロジックがコンパイルされ、難読化ツール(Dotfuscator等)によって保護される。

3. 実装:知的財産を封印するエンジン(VB.NET)

まず、ロジックを格納するDLLを作成する。ここでは、MS Projectのタスク情報を受け取り、独自の重み付け計算を行うクラスを実装する。

注意点: COM参照を正しく設定し、`ComVisible` 属性を付与することが、VBAから呼び出すための絶対条件だ。

' ProjectLogicEngine.vb
Imports System
Imports System.Runtime.InteropServices
Imports Microsoft.Office.Interop.MSProject

<ComVisible(True)>
<Guid("YOUR-GUID-HERE-XXXX-XXXX-XXXX-XXXXXXXXXXXX")> ' 独自のGUIDを生成して設定
<InterfaceType(ComInterfaceType.InterfaceIsDual)>
Public Interface IProjectCalculator
    ''' <summary>
    ''' タスクの複雑性を計算する独自のアルゴリズム
    ''' </summary>
    ''' <param name="taskName">タスク名</param>
    ''' <param name="duration">期間</param>
    ''' <returns>計算されたリスクスコア</returns>
    Function CalculateRiskScore(ByVal taskName As String, ByVal duration As Double) As Double
End Interface

<ComVisible(True)>
<Guid("YOUR-GUID-HERE-YYYY-YYYY-YYYY-YYYYYYYYYYYY")>
<ClassInterface(ClassInterfaceType.None)>
Public Class ProjectCalculator
    Implements IProjectCalculator

    Public Function CalculateRiskScore(ByVal taskName As String, ByVal duration As Double) As Double Implements IProjectCalculator.CalculateRiskScore
        ' --- ここに秘匿すべきロジックを記述 ---
        ' 例: タスク名に特定のキーワードが含まれ、かつ期間が長い場合にリスクを指数関数的に増加させる
        Dim baseScore As Double = 10.0
        
        If taskName.Contains("Critical") OrElse taskName.Contains("重要") Then
            baseScore *= 2.5
        End If

        ' 複雑な非線形計算のシミュレーション
        Dim riskScore As Double = baseScore * Math.Log(duration + 1.1)
        
        Return Math.Round(riskScore, 2)
    End Function
End Class

*※ビルド後、`regasm /tlb /codebase ProjectLogicEngine.dll` を実行し、COMとして登録することを忘れないように。*

4. 実装:司令塔となるVBAコード(Orchestrator)

次に、VBA側からこのDLLを呼び出し、プロジェクト内の全タスクに対して「計算結果の注入」を行う。

ここでの設計の肝は、「エラーハンドリング」と「オブジェクトのライフサイクル管理」だ。DLLの呼び出しに失敗した際、プロジェクト全体をクラッシュさせるような未熟なコードは、プロダクション環境では許されない。

' Module1: LogicOrchestrator
Option Explicit

' DLLの参照設定(早期バインディング)を行うか、
' 配布の容易性を考慮して Late Binding を選択する。
' ここでは堅牢性のために、事前に参照設定を行った前提の Early Binding で記述する。
' ※参照設定: ProjectLogicEngine (作成したDLL)

Sub UpdateCustomFieldsWithEngine()
    Dim t As Task
    Dim calcEngine As ProjectLogicEngine.ProjectCalculator
    Dim riskScore As Double
    Dim startTime As Double
    
    ' パフォーマンス計測開始
    startTime = Timer
    
    On Error GoTo ErrorHandler
    
    ' 1. エンジンのインスタンス化
    Set calcEngine = New ProjectLogicEngine.ProjectCalculator
    
    ' 2. プロジェクト内のタスクを走査
    ' 大規模プロジェクトを想定し、画面更新を停止して高速化
    Application.ScreenUpdating = False
    
    For Each t In ActiveProject.Tasks
        If Not t Is Nothing Then
            ' 3. DLLへデータを渡し、計算結果を取得
            ' ロジックはDLL内に隠蔽されており、VBAからは「値」しか見えない
            riskScore = calcEngine.CalculateRiskScore(t.Name, t.Duration.Duration)
            
            ' 4. カスタムフィールド(例: Text1 または Number1)へ結果を書き戻す
            ' ここでは計算結果を「Number1」に格納すると仮定
            t.Number1 = riskScore
        End If
    Next t

    Application.ScreenUpdating = True
    MsgBox "計算完了: " & Format(Timer - startTime, "0.00") & " 秒", vbInformation
    
CleanUp:
    ' 5. 重要:オブジェクトの解放(メモリリーク防止)
    Set calcEngine = Nothing
    Application.ScreenUpdating = True
    Exit Sub

ErrorHandler:
    Application.ScreenUpdating = True
    MsgBox "致命的なエラーが発生しました。" & vbCrLf & _
           "Error No: " & Err.Number & vbCrLf & _
           "Description: " & Err.Description, vbCritical, "Engine Error"
    Resume CleanUp
End Sub

5. プロフェッショナルが守るべき「鉄の掟」

この設計を実務に投入するにあたり、以下の3点を必ず遵守せよ。

① メモリリークへの厳格な対処

COMオブジェクト(DLL)を扱う際、VBA側で `Set obj = Nothing` を怠ると、MS Projectを閉じても `MSProject.exe` プロセスがバックグラウンドで残り続ける「ゾンビプロセス」が発生する。これは、自動化ツールにおける最悪のバグの一つだ。必ず `ErrorHandler` を通じて確実に解放する構造にせよ。

② 難読化の二段構え

DLLを作成した後は、必ず Dotfuscator や ConfuserEx などの難読化ツールを通せ。型名、メソッド名、変数名を意味のない文字列(`a`, `b`, `c`…)に置き換えることで、リバースエンジニアリングのコストを劇的に跳ね上げることができる。

③ バージョン管理と互換性

DLLのインターフェース(メソッドの引数や戻り値)を変更した際、既存のVBAコードが壊れる可能性がある。インターフェース(`IProjectCalculator`)を定義し、実装(`ProjectCalculator`)を分離する設計にすることで、ロジックの更新時にもVBA側の修正を最小限に抑えることができる。

結論

カスタムフィールドの数式にロジックを書き込むのは、鍵をかけずに金庫を置くようなものだ。
真に価値のあるロジックは、コンパイルされたバイナリの深淵に隠し、VBAはそれを統制する「指揮者」に徹すること。この設計思想こそが、君の作ったツールを「単なる便利機能」から「プロフェッショナルな製品」へと昇華させる。

設計に妥協はない。コードに魂を込めろ。

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