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

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

MS Projectの「孤島」を解き放て:WinHTTPとカスタムフィールドを同期させる極限のブリッジ設計

Microsoft Projectは、プロジェクト管理における計算エンジンとして比類なき性能を誇る。しかし、その強力な計算能力は、往々にして「ローカルファイル」という名の孤島に閉じ込められがちだ。

社内のダッシュボード、クラウド上のERP、あるいはリアルタイムなBIツール。これらとProjectのカスタムフィールドを同期させ、データを「動的な資産」へと昇華させる。これが現代のシステムアーキテクトに課せられたミッションである。

本稿では、単なる「APIを叩くコード」ではない。オブジェクトのライフサイクル、メモリ管理、そしてレガシーなVBA環境においていかにして堅牢なブリッジを構築するかという、実戦的な知見を共有する。

1. アーキテクチャの選定:なぜ `MSXML2.XMLHTTP` ではないのか

VBAでREST APIを扱う際、多くの開発者は `MSXML2.XMLHTTP` を選択する。しかし、プロフェッショナルはこれを選ばない。

我々が選ぶべきは `WinHttp.WinHttpRequest.5.1` である。

理由は明白だ。`WinHttp` は、タイムアウト設定の細かな制御、Cookieの管理、プロキシ設定の柔軟性において、`MSXML2` よりも一歩抜きん出ている。大規模なプロジェクトデータ、すなわち数千のタスクやリソースを同期させる際、ネットワークの遅延や不安定さは致命的なエラーを招く。リクエストのタイムアウトを適切に制御し、リトライ戦略を組み込める `WinHttp` こそが、エンタープライズ用途における標準である。

2. カスタムフィールドへのアクセスとマッピング戦略

Projectのカスタムフィールド(`Text1`〜`Text30`, `Number1`〜`Number30`等)は、単なる文字列や数値の格納領域ではない。それは、プロジェクト固有の「メタデータ」を定義する聖域だ。

同期ロジックを組む際、避けるべきは「`Text1` に何が入っているか」をコード内にハードコーディングすることだ。これは保守性を著しく低下させる。
理想的な設計は、「カスタムフィールドの定義(名前)」と「API側のスキーマ」を動的に紐付けるマッピング・レイヤーを設けることである。

3. 実装:高信頼性ブリッジ・クラスモジュール

以下に、メモリリークを極限まで抑え、オブジェクトのライフサイクルを厳格に管理した、`WinHTTP` ベースの同期クラスの設計例を示す。

Class Module: `clsCloudBridge`

Option Explicit

' WinHttpの参照設定を前提とする
' Microsoft WinHTTP Services, version 5.1

Private m_apiEndpoint As String
Private m_authToken As String
Private m_http As WinHttp.WinHttpRequest

' プロパティ: APIエンドポイント
Public Property Let ApiEndpoint(ByVal Value As String)
    m_apiEndpoint = Value
End Property

' プロパティ: 認証トークン
Public Property Let AuthToken(ByVal Value As String)
    m_authToken = Value
End Property

' クラス初期化時にHTTPオブジェクトを生成
Private Sub Class_Initialize()
    Set m_http = New WinHttp.WinHttpRequest
End Sub

' クラス終了時にオブジェクトを明示的に解放(重要)
' VBAのガベージコレクションに頼らず、メモリを即座に解放する
Private Sub Class_Terminate()
    Set m_http = Nothing
End Sub

''' <summary>
''' タスクデータをクラウドへ送信する
''' </summary>
''' <param name="taskId">Project上のタスクID</param>
''' <param name="jsonData">JSON形式のペイロード</param>
Public Function SyncTaskData(ByVal taskId As Long, ByVal jsonData As String) As Boolean
    On Error GoTo ErrorHandler

    With m_http
        .Open "POST", m_apiEndpoint & "/tasks/" & taskId, False
        
        ' ヘッダーの構築
        .SetRequestHeader "Content-Type", "application/json"
        .SetRequestHeader "Authorization", "Bearer " & m_authToken
        
        ' タイムアウト設定 (Resolve, Connect, Send, Receive)
        ' ネットワークの不安定さを考慮し、秒単位で制御
        .SetTimeouts 5000, 5000, 10000, 10000
        
        .Send jsonData
        
        ' HTTPステータスコードの検証
        If .Status >= 200 And .Status < 300 Then
            SyncTaskData = True
        Else
            ' エラーログの記録(実務ではログファイルへ出力)
            Debug.Print "API Error: Status " & .Status & " - " & .ResponseText
            SyncTaskData = False
        End If
    End With
    
    Exit Function

ErrorHandler:
    Debug.Print "Critical Error in SyncTaskData: " & Err.Description
    SyncTaskData = False
End Function

Standard Module: 同期実行エンジン

次に、Projectのオブジェクトモデルを走査し、カスタムフィールドの値を抽出するメインロジックだ。ここで重要なのは、大量のタスクをループさせる際のメモリ消費の最適化である。

Option Explicit

Sub ExecuteProjectSync()
    Dim proj As MSProject.Application
    Dim t As MSProject.Task
    Dim bridge As clsCloudBridge
    Dim jsonPayload As String
    Dim successCount As Long
    Dim failCount As Long
    
    Set proj = MSProject.Application
    
    ' ブリッジオブジェクトの生成
    Set bridge = New clsCloudBridge
    With bridge
        .ApiEndpoint = "https://api.your-cloud-db.com/v1"
        .AuthToken = "YOUR_SECURE_JWT_TOKEN"
    End With
    
    ' 高速化のための画面更新停止(Projectの描画負荷軽減)
    ' ただし、Project VBAではExcelほど劇的な効果はないが、作法として重要
    
    On Error Resume Next ' 個別のタスクエラーでループを止めないための防衛策
    
    For Each t In proj.ActiveProject.Tasks
        ' 空のタスク行(サマリー行等)のスキップ判定
        If Not t Is Nothing Then
            If Not t.ExternalTask Then ' 外部タスクでないことを確認
                
                ' カスタムフィールド (Text1) を JSON ペイロードに変換
                ' 本来はJSONライブラリを使用すべきだが、ここでは構造を簡略化
                ' 実務では Dictionary オブジェクト等を用いて構築する
                jsonPayload = "{""task_id"":" & t.ID & _
                              ",""custom_field_val"":""" & t.Text1 & """" & _
                              ",""completion_pct"":" & t.PercentComplete & "}"
                
                ' 同期実行
                If bridge.SyncTaskData(t.ID, jsonPayload) Then
                    successCount = successCount + 1
                Else
                    failCount = failCount + 1
                End If
                
            End If
        End If
    Next t
    
    On Error GoTo 0
    
    ' オブジェクトの明示的解放
    Set bridge = Nothing
    
    MsgBox "同期完了" & vbCrLf & _
           "成功: " & successCount & " 件" & vbCrLf & _
           "失敗: " & failCount & " 件", vbInformation
End Sub

4. 極限の知見:パフォーマンスと安定性のための「三原則」

この実装を実戦投入するにあたり、以下の三点を肝に銘じてほしい。

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

VBAはCOM(Component Object Model)上で動作している。`Set obj = Nothing` を怠ることは、メモリリークを許容することと同義だ。特に `WinHttp` オブジェクトや、ループ内で生成されるカスタムクラスは、必ずスコープの終わりで明示的に解放せよ。数千件のループにおいて、この差はアプリケーションのクラッシュか、安定稼働かの境界線となる。

② エラーハンドリングの粒度

ネットワーク通信は、常に「失敗する可能性がある」という前提で設計せよ。APIのタイムアウト、429 Too Many Requests(レート制限)、500 Internal Server Error。これらを一括りにせず、リトライ可能なエラー(ネットワーク一時断)と、リトライ不可能なエラー(認証エラー、スキーマ不一致)を切り分けて処理するロジックが、真のプロフェッショナルの仕事だ。

③ データの原子性(Atomicity)

Projectのデータを送る際、一度に全タスクを送るのではなく、タスク単位、あるいは小規模なバッチ単位で送信することを推奨する。万が一通信が途絶した際、どこまで同期が完了したかを特定しやすくするためだ。また、送信後に「同期済みフラグ」をProject側のカスタムフィールド(例:`Text2`)に書き戻す設計にすることで、二重送信を防ぎ、データの整合性を担保できる。

結びに代えて

VBAはレガシーな技術と揶揄されることもある。しかし、その本質は「既存の資産をいかにして現代のワークフローに組み込むか」という、エンジニアリングの根源的な問いに対する回答の一つである。

Projectという強力な計算機を、APIという血管を通じてクラウドへと繋ぐ。そのブリッジを設計する時、君は単なるコーダーではなく、データの流れを司るアーキテクトとなるのだ。

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