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

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

状態(State)を制御せよ:MS Projectにおけるカスタムフィールドの永続化設計

プロジェクト管理の現場において、VBAは単なる「作業の自動化ツール」ではない。それは、プロジェクトの「状態(State)」を定義し、制御するためのエンジニアリング・ツールである。

多くの開発者が陥る罠がある。それは、カスタムフィールドに計算した一時的な値を書き込み、それを「その場限り」のデータとして扱ってしまうことだ。しかし、真に堅牢な業務システムを構築する者は、その値を「いつ、どの時点の、どの状態か」というコンテキスト(文脈)と共に、プロジェクトの外部、あるいはプロジェクトのプロパティへと「永続化(Persistence)」させる。

本記事では、カスタムフィールドの値を、プロジェクトのプロパティと外部ファイルへスマートに保存・復元する、プロフェッショナルな設計手法を伝授する。

1. なぜ「単純なループ」では足りないのか

初心者が書くコードは、たいていこうだ。
「全てのタスクをループで回し、カスタムフィールドの値をテキストファイルに書き出す」

これでは不十分だ。なぜか? 理由は3つある。

1. データの整合性(Integrity)の欠如: タスク名(Name)をキーにして保存すると、ユーザーがタスク名を変更した瞬間に、復元時のマッピングが崩壊する。
2. メタデータの欠落: 保存されたデータが「いつの時点のものか」「どのプロジェクトのものか」という情報がなければ、それはただのゴミデータだ。
3. パフォーマンスの劣化: 大規模プロジェクト(数千タスク)において、不適切なI/O操作はプロジェクトの操作性を著しく損なう。

我々が目指すべきは、「タスクIDをプライマリキーとし、メタデータをプロジェクトプロパティに埋め込む」設計である。

2. アーキテクチャ設計:State Snapshot戦略

今回実装するのは、「State Snapshot(状態のスナップショット)」という概念だ。

  • Custom Properties (Project Object): スナップショットの「識別子(ID)」や「作成日時」を保存する。これにより、プロジェクトファイル自体が「どのスナップショットに関連付けられているか」を自覚できる。
  • External Flat File: カスタムフィールドの「実データ」を保存する。
  • Task ID: 復元時の唯一の信頼できるキー。

3. 実装:プロダクション・グレードのVBAコード

以下のコードは、単なるサンプルではない。エラーハンドリング、オブジェクトのライフサイクル、そして保守性を考慮した、実務に投入可能な設計に基づいている。

モジュール構成

`modStateManagement` という名前の標準モジュールを作成し、以下のコードを実装せよ。

Option Explicit

' ==============================================================================
' Module: modStateManagement
' Description: カスタムフィールドの状態を保存・復元するためのアーキテクチャ
' Author: Chief Architect
' ==============================================================================

Private Const DELIMITER As String = "|" ' データ区切り文字
Private Const PROP_SNAPSHOT_ID As String = "LastSnapshotID"
Private Const PROP_SNAPSHOT_DATE As String = "LastSnapshotDate"

''' <summary>
''' タスクのカスタムフィールド(Text1)の値をスナップショットとして保存する
''' </summary>
''' <param name="snapshotName">保存ファイル名(拡張子なし)</param>
Public Sub SaveTaskState(ByVal snapshotName As String)
    Dim pj As Project: Set pj = ActiveProject
    Dim t As Task
    Dim filePath As String
    Dim fileNum As Integer
    Dim snapshotID As String
    Dim timestamp As String
    
    ' 1. メタデータの準備
    snapshotID = snapshotName & "_" & Format(Now, "yyyymmddhhnnss")
    timestamp = Now
    filePath = pj.Path & "\" & snapshotName & ".dat"
    
    On Error GoTo ErrorHandler
    
    ' 2. ファイルオープン
    fileNum = FreeFile
    Open filePath For Output As #fileNum
    
    ' 3. データのシリアライズ(タスクID | カスタムフィールド値)
    ' 注: タスク名ではなくIDを使用することで、名前変更への耐性を持たせる
    For Each t In pj.Tasks
        If Not t Is Nothing Then
            If Not t.Summary Then ' サマリータスクを除外する場合(要件による)
                ' Text1に保存されている値を書き出す
                Print #fileNum, t.ID & DELIMITER & t.Text1
            End If
        End If
    Next t
    
    Close #fileNum
    
    ' 4. プロジェクトプロパティへのメタデータ書き込み
    ' これにより、プロジェクト自身が「最後にいつ保存したか」を記憶する
    UpdateProjectProperty pj, PROP_SNAPSHOT_ID, snapshotID
    UpdateProjectProperty pj, PROP_SNAPSHOT_DATE, timestamp
    
    MsgBox "スナップショットを正常に保存しました:" & vbCrLf & filePath, vbInformation
    Exit Sub

ErrorHandler:
    If fileNum > 0 Then Close #fileNum
    MsgBox "保存中に致命的なエラーが発生しました。" & vbCrLf & Err.Description, vbCritical
End Sub

''' <summary>
''' 保存されたスナップショットを現在のプロジェクトに復元する
''' </summary>
''' <param name="snapshotName">読み込むファイル名(拡張子なし)</param>
Public Sub RestoreTaskState(ByVal snapshotName As String)
    Dim pj As Project: Set pj = ActiveProject
    Dim filePath As String
    Dim fileNum As Integer
    Dim lineData As String
    Dim dataParts() As String
    Dim targetID As Long
    Dim targetValue As String
    Dim t As Task
    Dim foundCount As Long: foundCount = 0
    
    filePath = pj.Path & "\" & snapshotName & ".dat"
    
    ' 1. ファイルの存在確認
    If Dir(filePath) = "" Then
        MsgBox "指定されたスナップショットファイルが見つかりません。" & vbCrLf & filePath, vbExclamation
        Exit Sub
    End If
    
    On Error GoTo ErrorHandler
    
    ' 2. ファイルの読み込みと値の注入
    fileNum = FreeFile
    Open filePath For Input As #fileNum
    
    Do While Not EOF(fileNum)
        Line Input #fileNum, lineData
        If InStr(lineData, DELIMITER) > 0 Then
            dataParts = Split(lineData, DELIMITER)
            targetID = CLng(dataParts(0))
            targetValue = dataParts(1)
            
            ' IDをキーにタスクを特定
            Set t = GetTaskByID(pj, targetID)
            
            If Not t Is Nothing Then
                t.Text1 = targetValue
                foundCount = foundCount + 1
            End If
        End If
    Loop
    
    Close #fileNum
    
    ' 3. 復元完了の通知
    MsgBox "復元が完了しました。" & vbCrLf & _
           "復元されたタスク数: " & foundCount & vbCrLf & _
           "実行日時: " & Now, vbInformation
    Exit Sub

ErrorHandler:
    If fileNum > 0 Then Close #fileNum
    MsgBox "復元中にエラーが発生しました。" & vbCrLf & Err.Description, vbCritical
End Sub

' --- Private Helper Methods ---

''' <summary>
''' プロジェクトプロパティを安全に更新する
''' </summary>
Private Sub UpdateProjectProperty(ByRef pj As Project, ByVal propName As String, ByVal propValue As String)
    Dim cp As CustomProperty
    On Error Resume Next
    Set cp = pj.CustomProperties(propName)
    On Error GoTo 0
    
    If cp Is Nothing Then
        pj.CustomProperties.Add propName, propValue
    Else
        cp.Value = propValue
    End If
End Sub

''' <summary>
''' IDからタスクオブジェクトを高速に取得する
''' </summary>
Private Function GetTaskByID(ByRef pj As Project, ByVal taskID As Long) As Task
    Dim t As Task
    ' MS ProjectのTaskコレクションはIDで直接アクセスできないためループが必要
    ' ただし、大規模な場合はDictionaryオブジェクト等を利用したキャッシュ化を検討すべき
    For Each t In pj.Tasks
        If Not t Is Nothing Then
            If t.ID = taskID Then
                Set GetTaskByID = t
                Exit Function
            End If
        End If
    Next t
    Set GetTaskByID = Nothing
End Function

4. エンジニアとしての知見:運用のための「鉄則」

このコードを実務に適用する際、以下の3点を必ず念頭に置いておいてほしい。

① ID(Primary Key)の絶対性

コード内で `GetTaskByID` を実装した理由は明確だ。ユーザーはタスク名を「設計フェーズ」から「設計・レビュー」へと容易に変更する。もし名前をキーにしていたら、復元時にそのタスクを見失い、データは虚空へ消える。「名前は変わるが、IDは変わらない」。これがデータベース設計の基本原則だ。

② ファイルパスの管理

`pj.Path` を使用している。これは、プロジェクトファイルが保存されているディレクトリを基準にするためだ。ただし、プロジェクトが一度も保存されていない(新規作成直後)場合、`pj.Path` は空文字を返し、エラーを引き起こす。本番環境では、必ず「プロジェクトが保存されていること」をバリデーションせよ。

③ エラーハンドリングの重み

`On Error GoTo ErrorHandler` を惜しまないこと。特にファイルI/O(読み書き)を伴う処理において、ファイルが他のプロセスによってロックされていたり、書き込み権限がなかったりする場合、適切にハンドルしなければ、MS Project自体がクラッシュしたり、不完全なデータが書き込まれたりするリスクがある。

結びに代えて

カスタムフィールドの値を保存する。それは単なる「データのバックアップ」ではない。プロジェクトの特定の瞬間を凍結し、後で呼び出すための「時間の制御」である。

このコードを基盤として、君たちの業務自動化ツールを、単なるスクリプトから「信頼に足るシステム」へと昇華させてほしい。

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