【入門編】【中級者向け】カスタムフィールドの数式を動的に書き換える際の正規表現活用術 – Project VBA解析バイブル

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

Project VBAを掌握する極限の知見:カスタムフィールドの数式を「正規表現」で動的に支配する

こんにちは。現場の設計から実装の深淵まで、数々のプロジェクトを救ってきたアーキテクトです。

マクロの記録ボタンを卒業し、VBAで「自律的なツール」を作ろうとし始めたあなた。素晴らしい一歩を踏み出しましたね。しかし、ここで一つの壁にぶつかる人が多い。それが「プロジェクト設定の動的な変更」です。

例えば、プロジェクト管理の中で「消費税率が10%から12%に変わった」「目標値(Target)の計算ロジックを一部変更したい」という場面。これを一つひとつカスタムフィールドの数式を書き換えて回る……なんて、プロの仕事ではありませんよね。

今日は、カスタムフィールドの中に埋め込まれた「数式(Formula)」という文字列を、正規表現(Regular Expression)という精密なメスを使って、狙い撃ちで書き換える極限のテクニックを伝授します。

ここをクリアすれば、あなたの作るツールは「ただの計算機」から「プロジェクトの意思決定を支えるインテリジェントなエンジン」へと進化しますよ。

1. なぜ「単純な置換」では失敗するのか?

多くの初学者が陥る罠があります。それは、`Replace` 関数を使った単純な文字列置換です。

' ⚠️ 初心者がやりがちな危険なコード例
newFormula = Replace(oldFormula, "10", "12")

これでは、数式の中に「10」という数字が別の意味(例えば、係数や日付の一部など)で含まれていた場合、それらもすべて「12」に変わってしまいます。これは、プロジェクト全体の計算ロジックを破壊する「爆弾」を埋め込む行為です。

私たちが求めているのは、「`TaxRate = 10` というパターンを見つけたら、その数字の部分だけを `12` に変える」という、文脈を理解した置換です。これこそが、正規表現の出番です。

2. 武器の準備:VBScript Regular Expressions

VBAで正規表現を扱うには、`VBScript.RegExp` というオブジェクトを使用します。これは、複雑な文字列のパターンを定義し、検索・抽出・置換を行うための強力なエンジンです。

正規表現の考え方(イメージ図)

図解すると、このようなプロセスになります。

[元の数式文字列]
"([Cost] * TaxRate) / 1.1"
      ↑
[正規表現パターン] 
"TaxRate\s*=\s*(\d+(\.\d+)?)"  <-- 「TaxRate = 数字」という形を特定
      ↓
[置換エンジン]
"TaxRate = 1.12"               <-- 特定した部分だけを書き換え
      ↓
[新しい数式文字列]
"([Cost] * 1.12) / 1.1"

3. 実戦コード:カスタムフィールドの数式をスマートに更新する

では、実際に動くコードを見ていきましょう。今回は「タスク(Task)」のカスタムフィールドにある「目標値(TargetValue)」の数値を一括で書き換える関数を実装します。

※事前に「ツール」→「参照設定」から「Microsoft VBScript Regular Expressions 5.5」にチェックを入れておくと、入力補完が効いて開発が捗ります。

Option Explicit

''' <summary>
''' カスタムフィールド内の特定のパラメータ値を正規表現で置換する
''' </summary>
''' <param name="targetFieldNum">対象のカスタムフィールド番号 (1-30)</param>
''' <param name="paramName">置換したいパラメータ名 (例: "TargetValue")</param>
''' <param name="newValue">新しい値 (例: "5000")</param>
Sub UpdateProjectFormula()
    Dim targetFieldNum As Integer
    Dim paramName As String
    Dim newValue As String
    
    ' --- 設定エリア ---
    targetFieldNum = 1  ' Text1 など、対象のフィールド番号
    paramName = "TargetValue" ' 数式内のキーワード
    newValue = "5000"      ' 新しい値
    ' ------------------

    On Error GoTo ErrorHandler
    
    ' MS Projectのカスタムフィールドオブジェクトにアクセス
    ' TaskCustomFieldを使用(Resourceの場合は ResourceCustomField)
    Dim cf As CustomField
    Set cf = ActiveProject.TaskCustomFields(targetFieldNum)
    
    Dim currentFormula As String
    currentFormula = cf.Formula
    
    If currentFormula = "" Then
        MsgBox "指定されたフィールドに数式が設定されていません。", vbExclamation
        Exit Sub
    End If

    ' 正規表現による置換実行
    Dim newFormula As String
    newFormula = ReplaceFormulaWithRegex(currentFormula, paramName, newValue)

    ' 結果の反映
    If currentFormula <> newFormula Then
        cf.Formula = newFormula
        MsgBox "数式を更新しました。" & vbCrLf & "New: " & newFormula, vbInformation
    Else
        MsgBox "一致するパターンが見つからなかったため、更新は行いませんでした。", vbInformation
    End If

    Exit Sub

ErrorHandler:
    MsgBox "エラーが発生しました: " & Err.Description, vbCritical
End Sub

''' <summary>
''' 正規表現エンジンを用いて、特定のパターンを置換するコアロジック
''' </summary>
Private Function ReplaceFormulaWithRegex(ByVal formula As String, ByVal key As String, ByVal val As String) As String
    Dim regEx As Object
    Set regEx = CreateObject("VBScript.RegExp")
    
    With regEx
        .Global = True          ' 全ての該当箇所を対象にする
        .IgnoreCase = True      ' 大文字小文字を区別しない
        
        ' 【重要】正規表現パターン
        ' キーワードの後に「=」があり、その後に「数字または小数」が続くパターンをキャプチャ
        ' 例: TargetValue=1000 や TargetValue = 1000.5 を捕捉
        .Pattern = "(" & key & "\s*=\s*)(\d+(\.\d+)?)"
    End With
    
    ' 置換の実行
    ' $1 は、パターン内の最初のカッコ ( ) で囲まれた部分(つまり "TargetValue =" の部分)を保持することを意味します
    ReplaceFormulaWithRegex = regEx.Replace(formula, "$1" & val)
End Function

4. プロの視点:陥りやすいエラーと「守り」の設計

このコードを現場で使う際、アーキテクトとしてあなたが意識すべき「急所」が3つあります。

① 数式の構文エラー(Syntax Error)

MS Projectのカスタムフィールドは、`cf.Formula = “…”` と代入した瞬間に、その数式が正しいかどうかをチェックします。もし正規表現のミスで `TargetValue = 5000 /` のように、数式の末尾に不正な記号が残るような置換をしてしまうと、実行時エラーが発生します。
対策: 置換後の文字列をログに出力するか、`Debug.Print` で確認する癖をつけましょう。

② オブジェクトのライフサイクルとメモリ

上記のコードでは `CreateObject(“VBScript.RegExp”)` を使い、実行のたびにインスタンスを生成しています。大量のフィールドをループで処理する場合、毎回生成するとパフォーマンスが低下します。
対策: 大量処理を行う場合は、`regEx` オブジェクトを関数の外(モジュールレベル)で一度だけ生成し、使い回すのが定石です。

③ パターンの「甘さ」

`.Pattern = “(” & key & “\s*=\s*)(\d+(\.\d+)?)”`
このパターンは非常に強力ですが、もし数式内で `TargetValue` が単体で使われている場合(例:`[Cost] * TargetValue`)には反応しません。
対策: 「何を書き換えたいのか」を定義するときは、必ず「その値がどのような文脈(イコールで結ばれているのか、等価演算子なのか)で現れるか」を厳密に設計してください。

まとめ:一歩先の自動化へ

いかがでしたか?
単純な `Replace` から、正規表現を用いた「文脈を汲み取った置換」へ。この違いが、ツールの堅牢性(壊れにくさ)を決定づけます。

「マクロが動いた」だけで満足しないでください。「どんな入力が来ても、プロジェクトの整合性を壊さずに、正確に目的を遂行できるか」を考えること。それが、エンジニアからアーキテクトへと脱皮するための唯一の道です。

ここをクリアすれば、Project VBAの基本はバッチリですよ。自信を持って、次の自動化に挑んでくださいね!

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