【入門編】【上級者向け】ProjectのカスタムフィールドをWeb API経由でクラウドDBと同期させるブリッジ開発 – Project VBA解析バイブル

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

マクロの記録を卒業しよう:Project VBAとクラウドDBを繋ぐ「ブリッジ開発」への招待

こんにちは。プロジェクト管理の自動化、その深淵へようこそ。

これまであなたは、マクロの記録機能を使って「ボタンを押したら特定のセルに値を書き込む」といった、目の前の作業を楽にするための術を学んできたかもしれません。それは素晴らしい第一歩です。しかし、もしあなたが「Projectのデータを、社内の共通データベースやクラウド上のシステムとリアルタイムで同期させたい」と願うなら、そこには「マクロの記録」では決して到達できない領域があります。

それは、Projectを単なる「スケジュール作成ツール」としてではなく、「全社的なデータエコシステムの一端(クライアント)」として機能させる設計思想です。

今日は、Projectのカスタムフィールドを使い、WinHTTP経由でWeb APIを叩いてクラウドDBと同期させる、いわゆる「ブリッジ開発」の極意を伝授しましょう。ここをクリアすれば、あなたのエンジニアとしての視座は一段高く引き上げられるはずですよ。

1. なぜ「カスタムフィールド」が鍵を握るのか

MS Projectには、標準の「期間」や「開始日」以外に、ユーザーが自由に定義できる「カスタムフィールド(Text1, Number1, Date1など)」が存在します。

実務において、プロジェクト管理は単なる日付の管理ではありません。「予算コード」「承認ステータス」「外部システムID」といった、Projectの標準項目にはない独自のデータが必要です。

これらをカスタムフィールドに格納し、VBAでその値を読み取ってAPIに投げる。これが、クラウドとProjectを同期させるための「データ・コンテナ(運び役)」になるのです。

オブジェクトモデルの理解

VBAからこれらにアクセスする際、基本となるのは以下のオブジェクトです。

  • Taskオブジェクト: タスクごとのカスタムフィールド(`Task.Text1` など)
  • Resourceオブジェクト: リソース(人員)ごとのカスタムフィールド(`Resource.Text1` など)

2. ブリッジの心臓部:WinHTTPによるREST API通信

クラウド上のデータベース(Azure, AWS, または自社開発のAPIサーバー)と通信するためには、HTTPプロトコルを用いる必要があります。VBAにおいて最も信頼性が高く、プロフェッショナルな選択肢は `WinHTTP` です。

「マクロの記録」では、外部サーバーとの通信を記録することはできません。私たちは、自らの手で「リクエスト」という手紙を書き、それを「API」という郵便局へ届けるコードを書く必要があるのです。

準備:参照設定の魔法

コードを書く前に、VBAエディタのメニューから [ツール] -> [参照設定] を開き、以下にチェックを入れてください。

  • `Microsoft WinHTTP Services, version 5.1`

これによって、VBAがインターネットを通じて「HTTPリクエスト」を送る能力を手に入れます。

3. 実践:カスタムフィールドをクラウドへ同期するコード

それでは、実際に「タスクのカスタムフィールド(Text1)に入力された値を、API経由でクラウドへ飛ばす」ためのコードを見ていきましょう。

ここでは、初心者の方でも構造が理解しやすいよう、シンプルかつ堅牢な設計にしています。

Option Explicit

''' <summary>
''' タスクのカスタムフィールドをクラウドDBへ同期するメインルーチン
''' </summary>
Sub SyncTaskCustomFieldsToCloud()
    Dim t As Task
    Dim apiURL As String
    Dim jsonData As String
    Dim http As WinHttp.WinHttpRequest
    
    ' --- 設定エリア ---
    ' 同期先のAPIエンドポイント(実際には自社のURLに置き換えてください)
    apiURL = "https://api.your-company.com/v1/sync-task"
    
    ' WinHTTPオブジェクトの生成
    Set http = New WinHttp.WinHttpRequest
    
    On Error GoTo ErrorHandler
    
    ' Project内の全タスクをループ処理
    For Each t In ActiveProject.Tasks
        ' 空のタスク(サマリータスク等)はスキップ
        If Not t Is Nothing Then
            If t.Name <> "" Then
                
                ' 1. 送信するデータの構築 (JSON形式を想定)
                ' ここでは Text1 に「外部システムID」が入っていると仮定します
                ' 本来は、より厳格なJSON構築ライブラリを使うのが理想ですが、
                ' 学習用として文字列結合でシンプルに記述します
                jsonData = "{" & _
                            """taskId"": """ & t.ID & """," & _
                            """taskName"": """ & Replace(t.Name, """", "'") & """," & _
                            """externalId"": """ & t.Text1 & """," & _
                            """status"": """ & t.Text2 & """" & _
                            "}"
                
                ' 2. APIへのリクエスト送信 (POSTメソッド)
                Debug.Print "Syncing Task ID: " & t.ID & " with Data: " & jsonData
                
                With http
                    .Open "POST", apiURL, False ' Falseは同期通信(レスポンスを待つ)
                    .SetRequestHeader "Content-Type", "application/json"
                    .SetRequestHeader "Authorization", "Bearer YOUR_ACCESS_TOKEN" ' 認証トークン
                    
                    ' リクエストの実行
                    .Send jsonData
                    
                    ' 3. レスポンスの確認
                    If .Status = 200 Or .Status = 201 Then
                        ' 成功した場合、Project側のカスタムフィールドに「同期完了」を記録
                        t.Text3 = "Synced: " & Now()
                    Else
                        ' 失敗した場合、エラー内容を記録
                        t.Text3 = "Error: " & .Status & " " & .ResponseText
                    End If
                End With
                
            End If
        End If
    Next t

    MsgBox "同期処理が完了しました。", vbInformation
    Exit Sub

ErrorHandler:
    MsgBox "致命的なエラーが発生しました:" & vbCrLf & Err.Description, vbCritical
End Sub

コードの解説:ここがプロの視点

1. `Replace(t.Name, “”””, “‘”)`:
ここ、非常に重要です。タスク名に `”`(ダブルクォーテーション)が含まれていると、JSONの構造が壊れてAPI側でエラーになります。これをシングルクォートに置換するのは、実務における「データクレンジング」の基本です。
2. `SetRequestHeader`:
クラウドAPIは、誰がアクセスしているかを厳格にチェックします。`Authorization` ヘッダーでトークンを渡す、あるいは `Content-Type` を指定する。これは「礼儀正しい通信」のために不可欠です。
3. `t.Text3` へのフィードバック:
同期が終わった後に、その結果をProject側に書き戻しています。これにより、ユーザーは「どのタスクが同期済みで、どれがエラーなのか」をProject画面上で一目で確認できます。これが「ユーザー体験(UX)」を考慮した設計です。

4. 陥りやすい罠:パフォーマンスとエラーハンドリング

この手法をマスターする上で、避けては通れない「壁」が2つあります。

① 「N+1問題」によるパフォーマンス低下

上記のコードは、タスクごとにAPIを叩いています。もしタスクが1,000個あったら、1,000回の通信が発生します。これでは、通信待ちの時間だけで数分かかってしまいます。

【プロの解決策】
大量のデータを扱う場合は、ループの中で毎回 `Send` するのではなく、「一度メモリ上の配列や文字列にデータを溜め込み、1回のリクエストでまとめて送る(バルクアップロード)」設計に切り替えましょう。

② ネットワークの不安定さ

社内LANからインターネットへ抜ける際、通信は必ず失敗する可能性があります。

  • サーバーがダウンしている
  • 認証トークンが期限切れになった
  • インターネットが切断された

これらを考慮し、`On Error GoTo` を使ったエラーハンドリングや、リトライ処理(失敗した時に数回やり直す)を組み込むことが、プロのブリッジ開発には求められます。

最後に:一歩先へ進むあなたへ

「Project VBAでAPIを叩く」という技術は、単なる自動化の枠を超え、「業務プロセスをシステム統合する」という高度な領域への入り口です。

最初はエラーの山にぶつかるかもしれません。しかし、HTTPステータスコード(200, 404, 500…)の意味を理解し、データの型を意識し、ユーザーが使いやすいフィードバックを設計できるようになれば、あなたはもう「マクロを記録する人」ではなく、「システムを構築するアーキテクト」です。

ここをクリアすれば、Project VBAの基本はバッチリですよ。
さあ、自信を持って、次のコードを書き始めましょう!

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