【実務・中級編】【上級者】PowerPointの「PresentationClose」イベントをフックし、閉じようとしているファイルが特定の命名規則に合致する場合、自動的に社内共有のTeamsチャネル(Webhook)に保存完了通知を送信する連携マクロ – PowerPoint VBA解析バイブル

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

プレゼンテーションを「孤立したファイル」から「動的な情報源」へ変える:PowerPoint ApplicationイベントによるTeams連携の極意

多くの開発者が陥る罠がある。それは、「マクロをファイルの中に閉じ込めてしまう」ことだ。

単一のファイルに `Workbook_Open` や `Document_Close` のようなイベントを書くのは、小規模な自動化としては正解かもしれない。しかし、組織全体のワークフローを設計するアーキテクトの視点に立てば、それは極めて脆弱で、メンテナンス性の低い設計と言わざるを得ない。

今回我々が構築するのは、ファイル単体の挙動に依存するのではない。PowerPointアプリケーションそのものを監視し、特定の条件を満たした瞬間に、外部のコラボレーションツール(Teams)へと情報をブロードキャストする「システム」である。

本稿では、クラスモジュールを用いたアプリケーションイベントのフック、およびHTTPリクエストによるWebhook連携を、プロダクションレベルの堅牢性を持って実装する方法を伝授する。

1. 設計思想:なぜ「クラスモジュール」でなければならないのか

初心者は `ThisPresentation` モジュールにコードを書こうとする。しかし、これでは「そのファイルが開いている間」しかイベントを捕捉できない。

我々が目指すのは、「ユーザーがどのファイルを開こうとも、特定の命名規則(例:`ProjectA_Report_*.pptx`)に従ったファイルが閉じられた瞬間、自動的に通知が飛ぶ」という、アプリケーションレベルの監視である。

これを実現するには、`Application` オブジェクトのイベントを捕捉するためのクラスモジュールが必要となる。オブジェクトのライフサイクルを制御し、アプリケーションの生存期間中、イベントリスナーをメモリ上に保持させる。これが、プロフェッショナルな設計の第一歩だ。

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

実装は以下の3つのコンポーネントで構成される。

1. `clsAppMonitor` (クラスモジュール): `Application` オブジェクトを `WithEvents` で保持し、イベントを検知する心臓部。
2. `modMain` (標準モジュール): モニタリングを開始するエントリーポイントと、Teamsへの通信ロジック。
3. 命名規則フィルタ: 無関係なファイル(個人のメモや一時的なスライド)で通知が飛ばないためのガードロジック。

3. プロダクションコード例

それでは、実戦投入可能なコードを提示する。

① クラスモジュール: `clsAppMonitor`

まず、クラスモジュールを新規作成し、名前を `clsAppMonitor` に変更せよ。

Option Explicit

' Applicationオブジェクトのイベントを捕捉するための宣言
Private WithEvents App As Application

' モニタリングを開始するためのプロシージャ
Public Sub Initialize(ByRef appInstance As Application)
    Set App = appInstance
End Sub

' PresentationCloseイベントのフック
' ユーザーがプレゼンテーションを閉じた瞬間に発火する
Private Sub App_PresentationClose(ByVal Pres As Presentation)
    On Error GoTo ErrorHandler
    
    ' 1. 命名規則のチェック (例: "Report_" で始まるファイルのみ対象)
    ' ここを組織のルールに合わせてカスタマイズする
    Const TARGET_PATTERN As String = "Report_*"
    
    If Pres.Name Like TARGET_PATTERN Then
        ' 2. 通知ロジックの呼び出し
        ' プレゼンテーションの情報を標準モジュールの関数に渡す
        Call modMain.SendTeamsNotification(Pres.Name, Application.UserName)
    End If

ExitSub:
    Exit Sub

ErrorHandler:
    ' 本番環境では、エラーをユーザーに表示させてはいけない。
    ' 業務を妨げないよう、エラーログを記録するか、静かに終了させるのが鉄則。
    Debug.Print "Error in App_PresentationClose: " & Err.Description
    Resume ExitSub
End Sub

② 標準モジュール: `modMain`

次に、標準モジュールを作成し、以下のコードを記述する。

Option Explicit

' クラスインスタンスを保持するための変数
' これをモジュールレベルで宣言しないと、プロシージャ終了時にインスタンスが破棄され、イベントが検知できなくなる
Private AppMonitor As clsAppMonitor

' Teams Webhook URL (実際には環境変数や外部設定ファイルから取得するのが理想)
Private Const TEAMS_WEBHOOK_URL As String = "https://your-org.webhook.office.com/webhookb2/..."

' --- エントリーポイント ---
' PowerPointの起動時(アドインとして動作させる場合など)に実行する
Public Sub StartMonitoring()
    Set AppMonitor = New clsAppMonitor
    AppMonitor.Initialize Application
    MsgBox "Presentation Monitoring System is now ACTIVE.", vbInformation
End Sub

' --- 通知ロジック ---
Public Sub SendTeamsNotification(ByVal fileName As String, ByVal userName As String)
    Dim http As Object
    Dim payload As String
    Dim timestamp As String
    
    ' JSONペイロードの構築
    ' 注意: VBAには標準のJSONライブラリがないため、単純な構造なら文字列結合で構築する
    ' 複雑な構造が必要な場合は、JsonConverter等の外部ライブラリを検討せよ
    timestamp = Format(Now, "yyyy/mm/dd HH:mm:ss")
    
    payload = "{" & _
                """text"": ""### 📢 成果物更新通知""" & _
                """, ""sections"": [{" & _
                    """activityTitle"": ""ファイルが閉じられました""," & _
                    """activitySubtitle"": ""更新者: " & userName & """," & _
                    """facts"": [" & _
                        "{""name"": ""ファイル名"", ""value"": """ & fileName & """}," & _
                        "{""name"": ""更新日時"", ""value"": """ & timestamp & """}" & _
                    "]," & _
                    """markdown"": true" & _
                "}]" & _
              "}"

    ' HTTPリクエストの送信 (MSXML2.XMLHTTP を使用)
    On Error Resume Next ' ネットワークエラーでマクロが落ちるのを防ぐ
    Set http = CreateObject("MSXML2.XMLHTTP")
    
    With http
        .Open "POST", TEAMS_WEBHOOK_URL, False
        .SetRequestHeader "Content-Type", "application/json"
        .Send payload
        
        ' レスポンスの確認(デバッグ用)
        If .Status <> 200 Then
            Debug.Print "Teams Notification Failed. Status: " & .Status & " Response: " & .ResponseText
        End If
    End With
    
    If Err.Number <> 0 Then
        Debug.Print "HTTP Error: " & Err.Description
    End If
    On Error GoTo 0
    
    Set http = Nothing
End Sub

4. アーキテクトの視点:堅牢性を高めるための3つの鉄則

このコードをそのまま配布して終わるようでは、二流だ。実務で運用するには、以下の設計的配慮を忘れてはならない。

I. ユーザー体験(UX)を破壊しない

マクロの目的は「業務の支援」であり、「業務の妨げ」ではない。
`SendTeamsNotification` 内で `MsgBox` を表示したり、ネットワークのタイムアウト待ちでPowerPointがフリーズしたりすることは、絶対に避けるべきだ。`On Error Resume Next` を戦略的に使い、「通知が失敗しても、ユーザーの作業は一切止めない」という設計思想を貫け。

II. インスタンスの生存期間を制御せよ

標準モジュールの冒頭で `Private AppMonitor As clsAppMonitor` と宣言している理由を理解しているか?
もしこれを `StartMonitoring` プロシージャ内のローカル変数として宣言した場合、そのプロシージャが終了した瞬間にオブジェクトはメモリから解放され、イベント監視は即座に停止する。「オブジェクトのライフサイクル」を制御することは、イベント駆動型プログラミングの命である。

III. セキュリティとスケーラビリティ

Webhook URLをコード内にハードコードするのは、プロトタイプレベルの話だ。
実運用では、Webhook URLは社内の設定用Excelや、レジストリ、あるいは暗号化された設定ファイルから取得するように設計せよ。また、命名規則も `Like` 演算子だけでなく、正規表現(`VBScript.RegExp`)を用いることで、より複雑で厳格なパターンマッチングが可能になる。

結びに代えて

PowerPoint VBAは、単なる「自動操作ツール」ではない。適切に設計されたイベントハンドラを組み込むことで、プレゼンテーション作成という「個人の作業」を、組織の「情報共有プロセス」へと昇華させる強力な武器となる。

「動けばいい」という考えを捨て、「どうすれば壊れず、静かに、確実に価値を提供できるか」を考えろ。それが、エンジニアとアーキテクトを分かつ境界線である。

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