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の基本はバッチリですよ。自信を持って、次の自動化に挑んでくださいね!
