脱・マクロ記録!Project VBAで「データの状態」を自在に操る、カスタムプロパティの魔法
こんにちは。現場で数々の自動化プロジェクトを設計してきた、あなたの「技術的な先輩」です。
MS Projectを使っていて、こんな風に思ったことはありませんか?
「計算した結果を、一時的にどこかにメモしておきたい」
「特定の条件下でのタスクの値を、バックアップとしてプロジェクト自体に刻み込んでおきたい」
マクロの記録機能を使っている段階では、画面上の操作をなぞることはできても、「データそのものを、プロジェクトの裏側に隠して保存する」といった、設計思想に基づいた動きを作ることはできません。
今日は、一歩上のエンジニアへとステップアップするために、カスタムフィールドの値をプロジェクトの「プロパティ(CustomProperties)」として保存・復元する方法を伝授します。
ここをマスターすれば、あなたはもう「操作を記録する人」ではなく、「システムを設計する人」になれますよ。さあ、一緒に始めていきましょう!
1. なぜ「カスタムフィールド」に直接書くだけではダメなのか?
まず、設計の考え方(アーキテクチャ)を整理しましょう。
MS Projectには、タスクごとに自由に使える「カスタムフィールド(Text1やNumber1など)」があります。しかし、これらには弱点があります。
- データの混同: 「計算中の作業用データ」と「確定したデータ」が同じフィールドに混ざってしまう。
- 上書きのリスク: プロジェクトの計算式(Formula)を設定している場合、VBAで書き込んでも、プロジェクトが再計算された瞬間に値が消えてしまうことがある。
そこで登場するのが、`Project.CustomProperties` です。
これは、タスクやリソースといった「個々のデータ」ではなく、「プロジェクトというファイルそのもの」に付随するメタデータ(属性情報)を格納する場所です。
| 格納場所 | イメージ | 主な用途 |
|---|---|---|
| カスタムフィールド | ホワイトボードに書かれたメモ | 各タスクの属性、計算結果、ステータス |
| プロジェクトプロパティ | ファイルの背表紙に貼ったラベル | バージョン情報、計算のバックアップ、実行ログ |
「ホワイトボード(タスク)の内容を、一旦ファイル(プロジェクト)の背表紙にメモしておく」――この動きができるようになると、自動化の幅は劇的に広がります。
2. 実装してみよう:計算結果の保存と復元
では、具体的なコードを見ていきましょう。
今回は、「タスクの『Text1』に入っている値を、プロジェクトのプロパティにバックアップし、後から元に戻す」というシンプルな仕組みを作ります。
実装コード
以下のコードを、VBAエディタの標準モジュールに貼り付けてみてください。
Option Explicit
' ============================================================
' プロジェクトのプロパティにカスタムフィールドの値を保存する
' ============================================================
Sub SaveCustomFieldToProperties()
Dim t As Task
Dim propName As String
Dim propValue As String
' 保存するプロパティの名前(プロジェクトの背表紙に貼るラベル名)
propName = "Backup_Text1_Value"
' 今回は例として、最初のタスクの Text1 の値を保存してみます
' 本来はループで全タスクを処理したり、特定の条件で抽出したりします
If ActiveProject.Tasks.Count > 0 Then
Set t = ActiveProject.Tasks(1) ' 最初のタスクを対象
propValue = t.Text1 ' Text1の中身を取得
' --- プロパティへの書き込み処理 ---
On Error Resume Next
' すでに同じ名前のプロパティがあるか確認
ActiveProject.CustomProperties.Item(propName).Value = propValue
' もしエラーが出たら(プロパティが存在しなければ)、新しく作成する
If Err.Number <> 0 Then
ActiveProject.CustomProperties.Add Name:=propName, Value:=propValue
Err.Clear
End If
On Error GoTo 0
MsgBox "タスク '" & t.Name & "' の Text1 の値をプロパティ [" & propName & "] に保存しました。", vbInformation
Else
MsgMsgBox "タスクが見つかりません。", vbExclamation
End If
End Sub
' ============================================================
' プロジェクトのプロパティから値を読み取り、カスタムフィールドへ復元する
' ============================================================
Sub RestoreCustomFieldFromProperties()
Dim t As Task
Dim propName As String
Dim savedValue As String
propName = "Backup_Text1_Value"
On Error Resume Next
' プロパティから値を取り出す
savedValue = ActiveProject.CustomProperties.Item(propName).Value
' プロパティが存在しない(値が取れない)場合のハンドリング
If Err.Number <> 0 Then
MsgBox "保存されたプロパティ [" & propName & "] が見つかりません。先に保存を実行してください。", vbCritical
Err.Clear
Exit Sub
End If
On Error GoTo 0
' --- 復元処理 ---
If ActiveProject.Tasks.Count > 0 Then
Set t = ActiveProject.Tasks(1)
t.Text1 = savedValue ' プロパティの値をタスクのフィールドに戻す
MsgBox "プロパティから値を復元し、タスク '" & t.Name & "' の Text1 に適用しました。", vbInformation
End If
End Sub
3. プロの視点:ここが「ハマりどころ」だ!
コードを動かしてみて、「あれ?」と思う部分はありませんか?
実は、初心者の方が必ずと言っていいほど躓くポイントが2つあります。ここを理解しておけば、あなたはもう立派なエンジニアです。
① 「プロパティがない!」というエラー(存在チェック)
`ActiveProject.CustomProperties.Item(“名前”)` と書いたとき、もしその名前のプロパティがまだ一度も作成されていなかったら、VBAは「そんなものはない!」と怒って停止してしまいます。
上記のコードでは、`On Error Resume Next` を使ってエラーを一時的に無視し、「エラーが出た(=存在しない)なら `Add` で新しく作る」という、現場でもよく使われる「存在確認&作成」のテクニックを使っています。
② オブジェクトのライフサイクル
カスタムフィールドに書き込んだ値は、タスクが削除されると消えます。しかし、`CustomProperties` に書き込んだ値は、そのプロジェクトファイル(.mpp)が消えない限り、ずっとファイルの中に残り続けます。
これは「バックアップ」として非常に強力ですが、裏を返せば「古いデータが残り続けて、新しい作業の邪魔をする」というリスクもあります。運用ルールとして、「プロジェクトを新しく作り直すときは、プロパティもクリアする」といった設計が必要になることも覚えておいてくださいね。
まとめ:一歩先へ進むあなたへ
今回のコードで学んだことは、単なる「値のコピー」ではありません。
1. データの役割を分ける(作業用データ vs メタデータ)
2. エラーハンドリングを行う(プロパティの有無を確認する)
3. 状態を保存する(プロジェクトの状態をファイルに刻む)
これらは、複雑な業務システムを構築する際にも共通する、非常に重要な概念です。
「マクロの記録」は、あくまで「操作の録画」です。
これからは、今回のように「データの流れ」をデザインする、エンジニアとしての視点を持ってコードを書いてみてください。
もしエラーが出ても大丈夫。エラーメッセージは、あなたがより良い設計にたどり着くための、大切なガイドです。
ここをクリアすれば、Project VBAの基本はバッチリですよ。応援しています!
