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

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

MS Projectの「孤島化」を打破せよ:Custom FieldをクラウドDBへ同期する極限のブリッジ設計

プロジェクト管理の現場において、Microsoft Projectは最強のエンジンだ。しかし、そのデータがローカルの`.mpp`ファイルの中に閉じ込められている限り、それは「情報の孤島」に過ぎない。

現代のエンタープライズ環境では、プロジェクトの進捗、リソース負荷、コストデータを、Power BIや独自のダッシュボード、あるいはERPへとリアルタイムに流し込むことが求められる。そこで必要となるのが、ProjectのカスタムフィールドをWeb API経由でクラウドデータベースと同期させるブリッジ開発だ。

多くの開発者が、VBAで「Taskをループして、一つずつHTTPリクエストを投げる」という、愚かで脆弱なコードを書く。そんなコードは、数千タスクあるプロジェクトではタイムアウトを招き、ネットワークの一時的な瞬断で全プロセスを停止させる。

今日は、プロフェッショナルとして、「バグを許さない」「スケーラブルな」「保守性の高い」同期エンジンの設計思想と実装を伝授する。

1. 思考の転換:逐次処理から「ステートフル・バッチ処理」へ

まず、設計の根本的な誤りを指摘しておこう。
初心者は、`For Each t In ActiveProject.Tasks` のループ内で直接 `WinHTTP.Post` を呼び出す。これは、ネットワークのレイテンシ(遅延)とサーバーの負荷を全く考慮していない、最悪の設計だ。

設計すべきは、以下の3層構造を持つ「ステートフル・ブリッジ」である。

1. Extraction Layer (抽出層): Projectのオブジェクトモデルから、同期が必要なデータ(Delta)のみをメモリ上のデータ構造(DictionaryやCollection)に集約する。
2. Transformation Layer (変換層): 抽出したデータを、APIが要求するJSON形式へとシリアライズする。
3. Transmission Layer (伝送層): 構築されたペイロードを、エラーハンドリングとリトライ戦略を備えたHTTPクライアントを通じて一括、あるいは制御されたブロック単位で送信する。

さらに、「何が変わったのか」を判断するための「同期用カスタムフィールド(例:`Text20`に最終同期日時を格納)」をProject側に持たせることを強く推奨する。これにより、全件同期ではなく、差分同期(Delta Sync)が可能になり、パフォーマンスは劇的に向上する。

2. 堅牢なアーキテクチャの実装

ここでは、保守性を高めるために、API通信をカプセル化したクラスモジュールを用いた実装例を示す。

A. API通信の心臓部:`clsApiClient`

直接 `WinHTTP` を叩くのではなく、クラス化してエラーハンドリングと認証を隠蔽せよ。

' Class Module: clsApiClient
Option Explicit

Private m_Endpoint As String
Private m_ApiKey As String
Private m_Http As Object

' 初期化
Private Sub Class_Initialize()
    Set m_Http = CreateObject("WinHttp.WinHttpRequest.5.1")
End Sub

' API接続設定
Public Sub Configure(ByVal endpoint As String, ByVal apiKey As String)
    m_Endpoint = endpoint
    m_ApiKey = apiKey
End Sub

' JSONデータをPOSTするメソッド
' @param jsonPayload: シリアライズ済みのJSON文字列
' @return: サーバーからのレスポンス文字列
Public Function PostJson(ByVal jsonPayload As String) As String
    On Error GoTo ErrorHandler

    With m_Http
        .Open "POST", m_Endpoint, False
        .SetRequestHeader "Content-Type", "application/json"
        .SetRequestHeader "X-API-KEY", m_ApiKey
        .Send jsonPayload
        
        ' HTTPステータスコードの検証
        Select Case .Status
            Case 200 To 299
                PostJson = .ResponseText
            Case 429 ' Too Many Requests
                Err.Raise 9999, "clsApiClient", "Rate limit exceeded. Implement retry logic."
            Case Else
                Err.Raise 9999, "clsApiClient", "HTTP Error: " & .Status & " - " & .ResponseText
        End Select
    End With
    Exit Function

ErrorHandler:
    ' ここにログ出力処理を組み込むのがプロの仕事だ
    Debug.Print "Critical Error in API Post: " & Err.Description
    Err.Raise Err.Number, "clsApiClient", Err.Description
End Function

B. データ抽出エンジン:`modSyncEngine`

次に、Projectのカスタムフィールドをスキャンし、差分を特定するロジックだ。ここでは、`VBA-JSON`(有名なオープンソースライブラリ)を使用している前提とする。

' Standard Module: modSyncEngine
Option Explicit

' 同期実行のメインルーチン
Public Sub ExecuteCloudSync()
    Dim apiClient As New clsApiClient
    Dim taskData As Object ' Scripting.Dictionary
    Dim jsonPayload As String
    Dim t As Task
    Dim syncFlagField As String
    
    ' 設定(本来は外部設定ファイルや定数から読み込む)
    Const API_URL As String = "https://api.your-cloud-db.com/v1/project/sync"
    Const API_KEY As String = "your_secure_token_here"
    syncFlagField = "Text20" ' 最終同期日時を格納するカスタムフィールド
    
    ' 1. APIクライアントのセットアップ
    apiClient.Configure API_URL, API_KEY
    
    ' 2. 差分データの抽出 (Extraction Layer)
    Set taskData = CreateObject("Scripting.Dictionary")
    
    For Each t In ActiveProject.Tasks
        If Not t Is Nothing Then
            ' 更新があったタスクのみを抽出(Text20が空、もしくは特定条件を満たす場合)
            ' ここでは例として「Text20が空なら同期対象」とする
            If t.Text20 = "" Then
                ' 抽出したいカスタムフィールドを辞書に格納
                ' 本来はここでTask IDや各種CustomFieldsを取得
                Dim item As Object
                Set item = CreateObject("Scripting.Dictionary")
                item.Add "id", t.ID
                item.Add "name", t.Name
                item.Add "start", t.Start
                item.Add "cost", t.Cost
                ' カスタムフィールド Text1 (例: プロジェクトコード) を取得
                item.Add "projectCode", t.Text1 
                
                taskData.Add t.ID, item
            End If
        End If
    Next t

    ' 3. 送信処理 (Transmission Layer)
    If taskData.Count > 0 Then
        ' JSONへの変換 (VBA-JSONライブラリを使用)
        ' JsonConverter.ConvertToJson(taskData) を想定
        jsonPayload = "{ ""tasks"": [ ... ] }" ' 実際には変換ロジックを入れる
        
        Debug.Print "Syncing " & taskData.Count & " tasks..."
        
        Dim response As String
        response = apiClient.PostJson(jsonPayload)
        
        ' 4. 同期完了後のステータス更新 (State Update)
        ' APIが成功したことを確認してから、Project側の同期フラグを更新する
        ' これを忘れると、次回実行時にまた同じデータを送ることになる(二重送信)
        On Error Resume Next
        For Each t In ActiveProject.Tasks
            If taskData.Exists(t.ID) Then
                t.Text20 = Now ' 同期完了日時を記録
            End If
        Next t
        On Error GoTo 0
        
        MsgBox "Synchronization successful.", vbInformation
    Else
        MsgBox "No changes detected.", vbInformation
    End If
End Sub

3. 伝説のアーキテクトが教える「失敗しないための鉄則」

コードを書いただけで満足してはいけない。実務でこのツールを運用する際、以下の3点に留意せよ。

① トランザクションの整合性

VBAからAPIを叩く場合、Project側の更新(`t.Text20 = Now`)とAPI側の書き込みは、一つのデータベーストランザクションではない。
「APIは成功したが、Project側の更新に失敗した」という事態が必ず起こる。この場合、次回の同期で同じデータが再度送られることになる。API側が「冪等性(Idempotency)」、つまり「同じデータを二度送っても結果が変わらない」設計になっていることを必ず確認せよ。

② リソースのライフサイクル管理

`WinHTTP` オブジェクトや `Dictionary` オブジェクトは、ループ内で頻繁に `New` してはいけない。オブジェクトの生成と破棄はコストが高い。可能な限り、クラスのプロパティとして保持し、再利用すること。

③ エラーの「沈黙」を許すな

`On Error Resume Next` を乱用するな。それはバグを隠蔽し、将来の君を苦しめる毒薬だ。エラーが発生した場合は、必ず適切なログ(ファイルまたはイベントログ)に詳細なコンテキスト(どのTask IDで、どのプロパティが、どのようなHTTPエラーで失敗したか)を記録する設計にせよ。

結論

MS Projectを単なる「スケジュール管理ツール」から「エンタープライズ・データソース」へと昇華させるのは、君が書くコードの品質にかかっている。

単なる自動化(Automation)を目指すな。システムの統合(Integration)を目指せ。
それが、真のエンジニアリングだ。

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