【入門編】【上級者】PowerPointアドイン(.ppam)として実装し、ファイル保存時に社内Web APIを叩いて「文書管理番号」を自動取得してプロパティに埋め込んで保存するエンタープライズマクロ – PowerPoint VBA解析バイブル

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

マクロ記録から「システム開発」へ。PowerPointアドインで実現する、API連携型・自動文書管理システム構築術

こんにちは。今日もコードの海を、美しく、そして効率的に航海していますか?

皆さんは、PowerPoint VBAを使うとき、どんなイメージを持っていますか?
「ボタンを押したら図形を並べる」「決まったフォーマットの資料を作る」……。もちろん、それも素晴らしい自動化です。しかし、もしあなたが「プロフェッショナルなエンジニア」を目指すなら、その視点を一段階、上に引き上げる必要があります。

今日お話しするのは、単なる「便利なマクロ」の話ではありません。
「PowerPointというアプリケーションを、企業の基幹システムの一部として機能させる」という、極めてエンタープライズ(企業向け)な設計思想のお話です。

具体的には、「アドイン(.ppam)形式」を用いて、ユーザーが「保存」ボタンを押した瞬間に、「裏側で社内APIを叩き、発行された文書管理番号をプロパティに自動で書き込む」という、高度な仕組みを構築していきます。

「マクロの記録」を卒業し、オブジェクトのライフサイクルを支配するエンジニアへの第一歩。準備はいいですか?

1. なぜ「マクロ」ではなく「アドイン」なのか?

まず、設計思想(アーキテクチャ)から整理しましょう。

通常、マクロを `.pptm` 形式で保存すると、そのマクロはそのファイルの中に閉じ込められます。しかし、今回のような「全社共通のルール(文書管理番号の付与)」を実装する場合、ファイルごとにマクロを配布するのは非効率ですし、ユーザーが誤ってマクロを消してしまうリスクもあります。

そこで登場するのが PowerPointアドイン (.ppam) です。

アドインの圧倒的なメリット

  • 常駐性: PowerPointを起動している間、常にバックグラウンドで「見守り」を続けることができます。
  • イベントの捕捉: 「保存ボタンが押された」というイベントを、どのファイルに対しても検知できます。
  • 隠蔽性: コードがユーザーから見えにくくなり、誤操作を防げます。

今回のゴールは、「ユーザーが意識することなく、保存時に勝手に番号が振られる魔法の仕組み」を作ることです。

2. 設計図:システムの動きをイメージしよう

プログラミングを始める前に、頭の中に「設計図」を描いてください。

1. ユーザー操作: ユーザーが `Ctrl + S` または「保存」をクリック。
2. イベント検知: アドインが「あ、今保存しようとしたな!」と検知(`PresentationSave` イベント)。
3. 条件判定: 「このファイルには既に管理番号があるか?」を確認。
4. 外部連携 (API通信): 番号がなければ、`MSXML2.XMLHTTP` を使って社内のWeb APIへ「新しい番号をください」とリクエストを送る。
5. プロパティ書き込み: APIから返ってきた番号を、ファイルの CustomDocumentProperties(カスタムプロパティ) に格納。
6. 完了: ユーザーには何も見せず、裏側で全てを完結させる。

3. 実装:魂のコード・エッセンス

それでは、実際のコードを見ていきましょう。
この実装には、「クラスモジュール」という、少し高度なテクニックを使います。なぜなら、PowerPoint全体の動き(Applicationレベルのイベント)を監視するには、専用の「監視役」が必要だからです。

Step 1: 監視役を作る(クラスモジュール)

まず、プロジェクトに新しい「クラスモジュール」を追加し、名前を `AppEventClass` に変更してください。

' --- クラスモジュール: AppEventClass ---
Option Explicit

' PowerPointのApplicationオブジェクトを監視するための宣言
' WithEvents を使うことで、Applicationのイベント(保存など)を受け取れるようになります
Public WithEvents App As Application

' プレゼンテーションが保存される直前に発生するイベント
Private Sub App_PresentationSave(ByVal Pres As Presentation)
    Dim docID As String
    
    ' すでに管理番号が埋め込まれている場合は、二重取得を防ぐためにスキップ
    If HasManagementNumber(Pres) Then
        Debug.Print "管理番号は既に存在します: " & GetManagementNumber(Pres)
        Exit Sub
    End If
    
    ' --- ここからが本番:API連携 ---
    On Error GoTo ErrorHandler
    
    ' 1. APIから新しい番号を取得する(後述の関数を呼び出し)
    docID = FetchNewDocumentIDFromAPI()
    
    If docID <> "" Then
        ' 2. 取得した番号をカスタムプロパティに書き込む
        WriteManagementNumber Pres, docID
        MsgBox "文書管理番号 [" & docID & "] を自動発行し、プロパティに記録しました。", vbInformation, "システム通知"
    Else
        MsgBox "APIとの通信に失敗したため、番号を取得できませんでした。", vbExclamation, "エラー"
    End If
    
    Exit Sub

ErrorHandler:
    MsgBox "エラーが発生しました: " & Err.Description, vbCritical, "システムエラー"
End Sub

' --- 補助関数群 (プロパティ操作) ---

' 管理番号が既に存在するかチェック
Private Function HasManagementNumber(ByVal Pres As Presentation) As Boolean
    On Error Resume Next
    Dim prop As CustomDocumentProperty
    Set prop = Pres.CustomDocumentProperties("DocMgmtID")
    HasManagementNumber = (Err.Number = 0)
    On Error GoTo 0
End Function

' 管理番号を取得
Private Function GetManagementNumber(ByVal Pres As Presentation) As String
    GetManagementNumber = Pres.CustomDocumentProperties("DocMgmtID").Value
End Function

' 管理番号を書き込み
Private Sub WriteManagementNumber(ByVal Pres As Presentation, ByVal ID As String)
    ' すでにある場合は上書き、ない場合は新規作成
    On Error Resume Next
    Pres.CustomDocumentProperties.Add Name:="DocMgmtID", _
                                     LinkToContent:=False, _
                                     Type:=msoPropertyTypeString, _
                                     Value:=ID
    If Err.Number <> 0 Then
        ' 既存のプロパティを更新
        Pres.CustomDocumentProperties("DocMgmtID").Value = ID
    End If
    On Error GoTo 0
End Sub

' --- API通信エンジン ---
Private Function FetchNewDocumentIDFromAPI() As String
    ' ここでは MSXML2.XMLHTTP を使用します
    ' 参照設定: "Microsoft XML, v6.0" が必要です
    Dim http As Object
    Set http = CreateObject("MSXML2.XMLHTTP.6.0")
    
    Dim url As String
    url = "https://your-company-api.com/v1/generate-id" ' 社内APIのURLに置き換え
    
    On Error GoTo ApiError
    With http
        .Open "GET", url, False ' 同期通信(応答を待つ)
        .Send
        
        If .Status = 200 Then
            ' 本来はJSONをパースしますが、今回は簡略化のため
            ' APIがテキストでIDを直接返す想定とします
            FetchNewDocumentIDFromAPI = Trim(.ResponseText)
        Else
            FetchNewDocumentIDFromAPI = ""
        End If
    End With
    Exit Function

ApiError:
    FetchNewDocumentIDFromAPI = ""
End Function

Step 2: 監視役を起動する(標準モジュール)

クラスを作っただけでは、監視役は眠ったままです。標準モジュールから「起動」してあげる必要があります。

' --- 標準モジュール ---
Option Explicit

Dim myAppEvent As AppEventClass

' アドインが読み込まれた時に実行される初期化ルーチン
Sub Auto_Open()
    ' 監視役のインスタンスを作成
    Set myAppEvent = New AppEventClass
    ' PowerPointアプリケーションを監視対象としてセット
    Set myAppEvent.App = Application
    
    Debug.Print "Document Management Add-in is now active."
End Sub

4. エンジニアとしての「極限の知見」:陥りやすい罠

このコードを動かす際、初心者が必ずと言っていいほど躓くポイントが3つあります。ここを理解していれば、あなたはもう「マクロ記録」のレベルではありません。

① 同期通信のジレンマ(UIのフリーズ)

上記のコードでは `.Open “GET”, url, False` と、`False`(同期通信)を指定しています。これは「APIの返事が来るまで、VBAは次の行に行かない」という意味です。
APIの応答が遅いと、ユーザーのPowerPointが一瞬フリーズします。
実務では、APIのタイムアウト設定を厳格に行うか、あるいは「非同期通信」を検討する必要があります(ただし、VBAでの完全な非同期実装は非常に難易度が高いため、まずは「タイムアウトを短く設定する」ことから始めましょう)。

② カスタムプロパティの「存在確認」

`CustomDocumentProperties(“DocMgmtID”)` をいきなり参照すると、そのプロパティが存在しない場合にランタイムエラーで即死します。
必ず `On Error Resume Next` を使ってエラーを回避するか、存在チェックのロジックを挟むこと。これが「壊れないシステム」を作る鉄則です。

③ アドインとしての保存

コードが完成したら、通常の `.pptm` として保存してはいけません。
[ファイル] > [名前を付けて保存] > ファイルの種類を 「PowerPoint アドイン (*.ppam)」 にして保存してください。
その後、保存した `.ppam` ファイルをダブルクリックして読み込むことで、初めて「常駐型システム」として機能します。

まとめ:君は「道具を作る人」になった

お疲れ様でした。
今日実装したのは、単なる自動化ではありません。「業務プロセスを、アプリケーションの挙動レベルで制御する」という、システムエンジニアリングそのものです。

1. クラスモジュールでイベントを待ち構える。
2. APIで外部の世界と繋がる。
3. カスタムプロパティでデータを永続化する。

この3つの柱をマスターすれば、PowerPointに限らず、ExcelやWord、あるいはあらゆるWindowsアプリケーションの自動化において、あなたは「最強の武器」を手に入れたことになります。

さあ、次はどんな仕組みを作りますか?
世界は、自動化されるのを待っている素晴らしい業務で溢れています。

Keep Coding, Keep Architecting!

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