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

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

プロフェッショナルのためのMS Project VBA:ロジックを「資産」に変える、カスタムフィールド保護の極意

こんにちは。自動化の世界へようこそ。

「マクロの記録」を使って、なんとか作業を楽にできた。そんな喜びを感じているなら、あなたはすでに素晴らしい第一歩を踏み出しています。でも、もしあなたが「社内標準ツール」として、独自の計算ロジックや高度な分析手法を盛り込んだツールを配布しようと考えているなら、少しだけ立ち止まって、次のステージの話を聞いてほしいのです。

プロの開発者が直面する最大の課題の一つ。それは、「自分が心血を注いで作り上げた計算ロジック(アルゴリズム)を、いかにして守るか?」ということです。

MS Projectのカスタムフィールドに数式(Formula)を直接書き込む方法は非常に便利ですが、そのまま配布すると、中身は丸見えです。「あ、この計算式、こうなってるんだ」と簡単に解析されてしまう。これでは、あなたの技術は「秘伝のタレ」ではなく、ただの「レシピ公開」になってしまいます。

今日は、カスタムフィールドの計算ロジックを隠蔽し、ツールを「ブラックボックス化(保護)」して配布するための、プロフェッショナルなアーキテクチャについて解説します。

1. なぜカスタムフィールドの数式は「危うい」のか?

まず、基本をおさらいしましょう。MS Projectには、標準の列にはない独自の計算結果を表示するための「カスタムフィールド(Task/Resource)」があります。

通常、VBAで数式を設定する際は、以下のようなコードを書きます。

' 【初級編】カスタムフィールドに直接数式を書き込む例
Sub SetSimpleFormula()
    Dim t As Task
    ' Text1というカスタムフィールドに、簡単な数式をセットする
    ' これだと、ユーザーがフィールド設定を開くだけで中身が見えてしまう
    ActiveProject.Tasks(1).CustomField1 = "[Duration] / 480" 
    
    Debug.Print "数式を設定しました。"
End Sub

ここに潜む「脆弱性」

MS Projectの仕様上、カスタムフィールドの「数式(Formula)」プロパティに文字列として数式を書き込むと、それはプロジェクトファイル(.mpp)のメタデータとして保存されます。
ユーザーが「フィールドのカスタマイズ」画面を開けば、あなたの苦労して考えた計算ロジックが、テキストとしてそのまま表示されてしまうのです。

「コードをパスワードで保護したから大丈夫」と思うかもしれませんが、それはVBAプロジェクトを守るだけで、フィールドそのものに書き込まれた数式は守れません。

2. 守りの戦略:ロジックを「外部化」する

では、どうすればいいのか? 答えはシンプルです。
「カスタムフィールドには数式を書かない。計算はVBA、あるいはさらに強固なDLL(外部ライブラリ)に任せる」。

これには2つのステップがあります。

1. 数式(Formula)を使わず、値(Value)だけを書き込む。
2. 計算ロジック自体を、解析が困難な「コンパイル済みコード(DLL)」の中に隠す。

この構成にすることで、ユーザーには「計算結果」だけが見え、その「計算プロセス」はブラックボックスの中に閉じ込められます。

3. 実践:VB.NETで作る「計算エンジン(DLL)」

ここからは少し高度な内容になります。VBAの限界を超えるために、.NET環境(VB.NETやC#)で計算ロジックを書き、それをDLLとして書き出します。

ステップ1:VB.NETでのロジック作成

Visual Studioを使用し、「クラスライブラリ」プロジェクトを作成します。ここで、絶対に知られたくない複雑な計算を行います。

' 【VB.NET】計算エンジン(DLL)のイメージ
Imports System.Runtime.InteropServices

' COM参照を可能にするための属性
<ComVisible(True)>
<Guid("YOUR-GUID-HERE-0000-0000-0000-000000000000")> ' 独自のGUIDを生成
<ClassInterface(ClassInterfaceType.AutoDual)>
Public Class ProjectLogicEngine

    ''' <summary>
    ''' 独自の複雑なリスク係数を算出するメソッド
    ''' </summary>
    ''' <param name="duration">工期</param>
    ''' <param name="work">作業量</param>
    ''' <returns>計算されたリスク値</returns>
    Public Function CalculateRiskFactor(ByVal duration As Double, ByVal work As Double) As Double
        ' ここに秘伝のロジックを記述
        ' 例: 複雑な非線形計算など
        Dim result As Double = (duration * 0.15) + (work / 100)
        Return result
    End Function

End Class

ステップ2:VBAからDLLを呼び出す

次に、MS ProjectのVBA側から、このDLLを呼び出して計算結果をカスタムフィールドに流し込みます。

' 【上級編】DLLを呼び出してカスタムフィールドに値を書き込む
Option Explicit

' DLLのオブジェクトを宣言
Private engine As Object

Sub InitializeEngine()
    ' DLLをインスタンス化(事前にRegasm等で登録が必要)
    ' 本来はエラーハンドリングを丁寧に行う
    On Error Resume Next
    Set engine = CreateObject("ProjectLogicEngine.ProjectLogicEngine")
    
    If engine Is Nothing Then
        MsgBox "計算エンジンがロードできませんでした。インストールを確認してください。", vbCritical
    End If
End Sub

Sub RunProtectedCalculation()
    Dim t As Task
    
    ' エンジンの初期化
    Call InitializeEngine
    
    If engine Is Nothing Then Exit Sub

    ' 全タスクをループして計算結果をカスタムフィールド(Number1)に格納
    For Each t In ActiveProject.Tasks
        If Not t Is Nothing Then
            ' カスタムフィールドの数式は空にしておく
            ' 計算ロジックはすべてDLL側にあるため、ここは「値」の受け皿にするだけ
            
            ' DLLのメソッドを呼び出し、結果をNumber1に代入
            ' 引数としてDurationとWorkを渡す
            t.Number1 = engine.CalculateRiskFactor(t.Duration, t.Work)
        End If
    Next t

    MsgBox "計算が完了しました。ロジックは保護されています。", vbInformation
End Sub

4. 陥りやすいエラーと、プロの回避策

この手法は強力ですが、いくつか「落とし穴」があります。ここをクリアすれば、あなたはもう初心者ではありません。

① 「型」の不一致(Type Mismatch)

VBAの`Duration`は、内部的には「分」単位の数値です。一方、VB.NET側で`Double`として受け取る際、単位の解釈がズレると計算結果が狂います。

  • 対策: DLLのメソッドに渡す前に、VBA側で単位を明示的に変換するか、DLL側で「これは分単位である」という仕様を徹底してください。

② DLLの登録問題(Registration)

作成したDLLは、そのままではVBAから見えません。`Regasm.exe`(.NET Frameworkの場合)を使用して、Windowsのレジストリに登録する必要があります。

  • 対策: 配布時には、インストーラー(Setup Projectなど)を作成し、インストールプロセスの中で自動的に`Regasm`が走るように設計するのがプロの仕事です。

③ パフォーマンスの重み

すべてのタスクに対して、ループ内で毎回DLLを呼び出すと、タスク数が数千件ある場合に動作が重くなります。

  • 対策:
  • 「変更があったタスクだけ」を計算対象にする。
  • あるいは、タスクの情報を一度配列(Array)にまとめ、DLL側で一括計算して、まとめてVBAに戻す「バッチ処理」を検討してください。

まとめ:技術を「資産」として守るために

「動けばいい」という段階から、「安全に、広く、プロフェッショナルとして使ってもらう」段階へ。

カスタムフィールドのロジックをDLL化して隠蔽する手法は、単なる「隠し事」ではありません。それは、あなたの知的な成果物を、正当な価値を持つ「製品(プロダクト)」へと昇華させるプロセスなのです。

最初は難しく感じるかもしれません。DLLの登録やCOM参照の設定は、初心者には高い壁です。でも、ここを一つずつ乗り越えていくことで、あなたは「マクロが書ける人」から、「業務システムを設計できるエンジニア」へと進化していくのです。

さあ、準備はいいですか? あなたの最強のロジックを、世界(あるいは社内)へ送り出しましょう!

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