【入門編】【初心者向け】カスタムフィールドの値をプロジェクトのプロパティとして保存・復元する – Project VBA解析バイブル

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

脱・マクロ記録!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の基本はバッチリですよ。応援しています!

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