【入門編】【中級者向け】カスタムフィールドの値をExcelのピボットテーブルで分析するためのデータ整形ツール – Project VBA解析バイブル

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

Projectデータを「武器」に変える。カスタムフィールドをExcelピボット分析へ繋ぐ究極のデータ整形術

こんにちは。現場の自動化を支えるアーキテクトです。

「マクロの記録」で一歩を踏み出し、なんとか基本的な操作ができるようになった。そんなあなたに、今日はお祝いと、少しだけ背筋が伸びるような「本質的な話」をしに来ました。

Projectで苦労して設定した「カスタムフィールド(数式やフラグ)」。せっかく作ったのに、「Excelに書き出してみると、データの形がバラバラでピボットテーブルが組めない……」と頭を抱えていませんか?

Projectのデータ構造は「階層構造(ツリー形式)」です。一方で、Excelのピボットテーブルが求めているのは「フラットな表(1行1データ)」です。この「構造のギャップ」を埋めることこそが、プロの自動化エンジニアへの登竜門です。

今日は、Projectのカスタムフィールドを美しく、分析しやすい形式でExcelへ叩き出す「データ整形モジュール」の作り方を伝授します。ここをクリアすれば、あなたのProject活用術は一段上のステージへ上がりますよ。

1. なぜ「そのままコピー」ではいけないのか?

まず、多くの初心者が陥る罠について話しておきましょう。

ProjectのタスクリストをそのままコピーしてExcelに貼り付けると、以下のような問題が発生します。

  • 階層の壁: サブタスクがインデント(字下げ)されているだけで、Excel上では「どの親タスクに属しているか」が判別できない。
  • カスタムフィールドの混在: `Text1` や `Number1` といったフィールドは、プロジェクトの構成によって「何が入っているか」がバラバラになりがち。
  • データの欠落: 完了したタスクやリソース割り当てが、単純なコピーでは「行」として正しく紐付かない。

ピボットテーブルで「部門別」「プロジェクトフェーズ別」の進捗を瞬時に見たいなら、「1行の中に、タスク名、親タスク名、カスタムフィールドの値、すべてが揃っている」状態を作らなければなりません。

2. 設計思想:配列(Array)を使った高速エクスポート

ここで、伝説的なアーキテクトが必ず守る「鉄則」を教えましょう。

> 「Excelのセルへ、ループの中で1セルずつ書き込むな」

これは初級者が最もやりがちな、パフォーマンスを破壊する行為です。`Cells(i, j).Value = …` を数千回繰り返すと、Excelとの通信(COM通信)のオーバーヘッドで処理が劇的に遅くなります。

正解は、「メモリ上の配列(Variant型)にすべてのデータを溜め込み、最後に一気にシートへ流し込む」ことです。 これだけで、処理速度は数十倍変わります。

3. 実装:フラットデータ・エクスポート・モジュール

それでは、実際に使えるコードを見ていきましょう。このコードは、Projectのタスクを走査し、カスタムフィールドを含めた情報を「フラットな形式」でExcelへ出力します。

Option Explicit

''' <summary>
''' Projectのタスク情報をExcelへフラット形式でエクスポートする
''' </summary>
Sub ExportTasksToFlatExcel()
    Dim pj As Project
    Dim t As Task
    Dim xlApp As Object ' Excel.Application
    Dim xlWB As Object  ' Excel.Workbook
    Dim xlWS As Object  ' Excel.Worksheet
    Dim dataArray() As Variant
    Dim rowCount As Long
    Dim colCount As Integer
    Dim i As Long
    
    Set pj = ActiveProject
    
    ' --- 1. 設定:エクスポートしたい列の定義 ---
    ' ここにカスタムフィールド(Text1, Number1等)を自由に組み込んでください
    ' 0: ID, 1: タスク名, 2: 親タスク名, 3: Text1(カスタム), 4: Text2(カスタム)
    colCount = 5 
    
    ' データの最大行数を多めに見積もる(動的にリサイズも可能)
    ReDim dataArray(1 To pj.Tasks.Count + 1, 1 To colCount)
    
    ' ヘッダーの作成
    dataArray(1, 1) = "Task ID"
    dataArray(1, 2) = "Task Name"
    dataArray(1, 3) = "Parent Task"
    dataArray(1, 4) = "Custom Field A (Text1)"
    dataArray(1, 5) = "Custom Field B (Text2)"
    
    rowCount = 1
    
    ' --- 2. データ収集フェーズ(高速なメモリ処理) ---
    On Error Resume Next ' タスクがNull(削除済み)の場合の対策
    For Each t In pj.Tasks
        If Not t Is Nothing Then
            rowCount = rowCount + 1
            
            ' 配列にデータを格納していく
            dataArray(rowCount, 1) = t.ID
            dataArray(rowCount, 2) = t.Name
            
            ' 【重要】親タスク名をフラット化して取得
            ' これにより、Excelで「親タスク」を軸に集計可能になる
            If Not t.Parent Is Nothing Then
                dataArray(rowCount, 3) = t.Parent.Name
            Else
                dataArray(rowCount, 3) = "Root"
            End If
            
            ' カスタムフィールドの取得
            dataArray(rowCount, 4) = t.Text1
            dataArray(rowCount, 5) = t.Text2
        End If
    Next t
    On Error GoTo 0
    
    ' --- 3. Excelへの出力フェーズ ---
    ' Excelアプリケーションを起動(既に開いている場合はそれを使う設計も可能)
    On Error Resume Next
    Set xlApp = GetObject(, "Excel.Application")
    If xlApp Is Nothing Then
        Set xlApp = CreateObject("Excel.Application")
    End If
    On Error GoTo 0
    
    xlApp.Visible = True
    Set xlWB = xlApp.Workbooks.Add
    Set xlWS = xlWB.Sheets(1)
    
    ' 配列を一気にセル範囲へ流し込む(これが高速化の鍵!)
    xlWS.Range(xlWS.Cells(1, 1), xlWS.Cells(rowCount, colCount)).Value = dataArray
    
    ' 見栄えの調整
    xlWS.Columns.AutoFit
    
    MsgBox "エクスポートが完了しました!" & vbCrLf & _
           "このデータを元にピボットテーブルを作成してください。", vbInformation
           
    ' オブジェクトの解放
    Set xlWS = Nothing
    Set xlWB = Nothing
    Set xlApp = Nothing
End Sub

4. コードの深掘り:ここがプロの視点

このコードには、単なる「記録」にはない、3つの重要な設計思想が組み込まれています。

① 親タスクの「平坦化(Flattening)」

`dataArray(rowCount, 3) = t.Parent.Name` の部分に注目してください。
Projectの画面上では「インデント」で階層を表現しますが、Excelでは「親タスク名」という列を持たせることで、ピボットテーブルの「行」や「フィルター」に親タスクを指定できるようになります。これが「分析できるデータ」にするための最大のコツです。

② 実行時エラーへの耐性

`If Not t Is Nothing Then` という判定を入れています。Projectでは、タスクを削除しても内部的なインデックスに「空の要素」が残ることがあり、そのままプロパティにアクセスするとエラーで止まってしまいます。この一文が、堅牢なツールを作るための守りになります。

③ オブジェクトのライフサイクル管理

コードの最後で `Set … = Nothing` を行っています。これは、メモリ上に残ったExcelやProjectの制御権を、OSに正しく返却するための作法です。大規模な自動化を繰り返す場合、これを怠ると「マクロは終わったのにExcelが裏で残り続けて重い」という現象に悩まされることになります。

5. 次のステップ:ピボットテーブルへの展開

このツールで出力されたExcelシートができたら、あとは簡単です。

1. 出力されたデータ範囲を選択。
2. [挿入] > [ピボットテーブル] をクリック。
3. 「行」に `Parent Task` を入れ、「列」に `Custom Field A` を入れ、「値」に `Task ID`(個数)を入れる。

これだけで、「どの親タスクが、どの属性(カスタムフィールド)にいくつ存在するか」という集計表が、一瞬で完成します。

おわりに

いかがでしたか?
「マクロの記録」は、いわば「決まった手順をなぞる」ものです。しかし、今回学んだ「データの構造を理解し、メモリ上で整形して、一気に流し込む」という手法は、「仕組みを構築する」エンジニアリングそのものです。

最初は、配列の扱いやオブジェクトの概念に戸惑うかもしれません。でも大丈夫。一つずつ、自分の手でコードを書き換え、エラーにぶつかりながら進んでいってください。その経験こそが、あなたを「伝説のエンジニア」へと近づける唯一の道なのですから。

ここをクリアすれば、Project VBAの基本はバッチリですよ。応援しています!

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