【入門編】【上級者】プレゼンテーションの保存終了イベントをフックし、特定の命名規則に合致するファイルを検知した瞬間に社内TeamsチャネルへWebhook経由で保存完了通知を送信する連携マクロ – PowerPoint VBA解析バイブル

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

【極限の自動化】PowerPointの「保存・終了」を支配する――クラスモジュールによるTeams連携の実踐的アーキテクチャ

「マクロの記録」ボタンを押し、生成されたコードを見て「ふーん、これでいいのかな?」と思ったことはありませんか?

もしあなたが、単なる作業の自動化を超えて、「ユーザーが意識することなく、システムが勝手に裏側で業務を完結させる」という次元を目指すなら、今こそ「イベント駆動型プログラミング」の世界へ足を踏み入れる時です。

今回のテーマは、PowerPoint VBAにおける最高峰のテクニックの一つ。「クラスモジュールを用いたアプリケーションイベントのフック」です。

特定の命名規則(例:`報告書_2023.pptx`)に従ったファイルが保存された瞬間、それを検知してMicrosoft Teamsへ自動通知を飛ばす。この仕組みを構築できれば、ドキュメントの管理プロセスは劇的に進化します。

さあ、準備はいいですか? コードの裏側にある「オブジェクトの命(ライフサイクル)」を意識しながら、一緒に進んでいきましょう。

1. なぜ「クラスモジュール」が必要なのか?

通常の標準モジュールに書かれたマクロは、いわば「命令待ちの作業員」です。あなたが「実行」ボタンを押さない限り、一歩も動きません。

しかし、私たちが作りたいのは「見守り役」です。
「ファイルが保存された」「プレゼンテーションが閉じられた」といったイベント(出来事)を待ち構え、条件を満たした瞬間に即座に反応する。これを行うためには、オブジェクトの動きを監視できる「クラスモジュール」という特殊な領域が必要になります。

ここがポイント:イベント駆動の概念

  • 標準モジュール: 「これをやって」と言われたらやる(受動的)
  • クラスモジュール: 「何かが起きたら」自分から動く(能動的)

2. 実装の全体像:3つのコンポーネント

このシステムは、以下の3つのパーツで構成されます。

1. クラスモジュール (`clsAppEvent`): PowerPoint全体の動きを監視する「センサー」の役割。
2. 標準モジュール (`modMain`): センサーを起動し、全体を制御する「司令塔」の役割。
3. Teams Webhook: 通知を受け取る「通信窓口」。

3. 実装コード:魂を込めたアーキテクチャ

それでは、具体的なコードを見ていきましょう。

ステップ1:クラスモジュールを作成する

まず、VBAエディタで「挿入」→「クラスモジュール」を選択し、オブジェクト名を `clsAppEvent` に変更してください。

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

' Applicationオブジェクトのイベントを捕捉するための宣言
' WithEvents を使うことで、Applicationが起こすイベントを「待ち受ける」ことができます
Private WithEvents App As Application

' クラスを初期化する際に、Applicationインスタンスを受け取る
Public Sub Init(ByVal appInstance As Application)
    Set App = appInstance
End Sub

' PowerPointのプレゼンテーションが保存された時に発生するイベント
Private Sub App_PresentationSave(ByVal Pres As Presentation)
    Dim fileName As String
    Dim targetPattern As String
    
    ' 命名規則の設定(例: "報告書_" で始まるファイル)
    targetPattern = "報告書_*"
    
    ' 保存されたファイルのフルパスからファイル名を取得
    fileName = Pres.Name
    
    ' 【検知ロジック】命名規則に合致するかチェック
    ' Like演算子を使うことで、ワイルドカードによる柔軟な判定が可能です
    If fileName Like targetPattern Then
        ' 条件に合致した場合、通知処理へ飛ばす
        Debug.Print "検知成功: " & fileName
        Call SendTeamsNotification(Pres.FullName)
    End If
End Sub

' --- Teamsへの通知ロジック (プライベート関数) ---
' 本来は別モジュールでも良いですが、分かりやすさのためここに記述します
Private Sub SendTeamsNotification(ByVal filePath As String)
    Dim strWebhookURL As String
    Dim strPayload As String
    Dim http As Object
    
    ' 【設定】ここにTeamsのWebhook URLを入力してください
    strWebhookURL = "https://your-org.webhook.office.com/webhookb2/..."
    
    ' JSON形式のメッセージを作成(Teamsの仕様に合わせる)
    ' ファイルパスをメッセージに含めて通知
    strPayload = "{""text"": ""✅ ドキュメント更新通知\n\n新しい報告書が保存されました。\n\nパス: " & filePath & """}"
    
    ' HTTP通信オブジェクトの生成 (Microsoft XML, v6.0 を使用)
    ' 参照設定なしでも動くよう、Late Binding(遅延結合)を採用しています
    On Error GoTo ErrorHandler
    Set http = CreateObject("MSXML2.XMLHTTP.6.0")
    
    With http
        .Open "POST", strWebhookURL, False
        .SetRequestHeader "Content-Type", "application/json"
        .Send strPayload
    End With
    
    If http.Status <> 200 Then
        Debug.Print "通知失敗: HTTP Status " & http.Status
    Else
        Debug.Print "通知成功: Teamsへ送信完了"
    End If
    
    Set http = Nothing
    Exit Sub

ErrorHandler:
    Debug.Print "通信エラー発生: " & Err.Description
    Set http = Nothing
End Sub

ステップ2:標準モジュールで「起動」させる

次に、標準モジュールを作成し、以下のコードを記述します。ここが「センサー」を起動させるスイッチになります。

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

' クラスのインスタンスを「モジュールレベル」で保持することが極めて重要!
' プロシージャ内(Subの中)でDimしてしまうと、処理が終わった瞬間に
' インスタンスが破棄され、イベントの監視が止まってしまいます(重要!)
Private AppEventTracker As clsAppEvent

' システムを起動するマクロ
Sub StartMonitoring()
    ' クラスのインスタンスを生成
    Set AppEventTracker = New clsAppEvent
    
    ' Applicationオブジェクトをクラスに渡して、監視を開始
    AppEventTracker.Init Application
    
    MsgBox "監視を開始しました。" & vbCrLf & _
           "命名規則「報告書_*」に合致するファイルが保存されると、Teamsへ通知します。", vbInformation
End Sub

' 監視を停止するマクロ
Sub StopMonitoring()
    Set AppEventTracker = Nothing
    MsgBox "監視を停止しました。", vbExclamation
End Sub

4. 陥りやすい「落とし穴」とプロの知見

このコードを動かす際、初心者が必ずと言っていいほど躓くポイントが2つあります。

① インスタンスの寿命(ライフサイクル)問題

標準モジュールの `StartMonitoring` 内で `Dim AppEventTracker As clsAppEvent` と書いてしまうと、マクロが終了した瞬間に `AppEventTracker` はメモリから消え去ります。
「マクロは終わったのに、イベントが反応しない!」というトラブルの9割は、この「変数のスコープ(有効範囲)」が原因です。必ずモジュールレベル(Subの外)で宣言してください。

② 通信の同期・非同期問題

上記のコードでは `http.Send` を行っていますが、これは「同期通信」です。つまり、Teamsへの送信が終わるまで、PowerPointの操作が一時的に固まります。
もし、より高度なツールを作るなら、通信エラーでPowerPoint自体がクラッシュしないよう、`On Error GoTo` による堅牢なエラーハンドリングが不可欠です。今回のコードには、そのための「守り」を組み込んであります。

5. まとめ:一歩先のエンジニアへ

今回の仕組みをマスターすれば、あなたは単なる「Excel/PowerPoint使い」ではなく、「業務プロセスを設計するエンジニア」へと進化しています。

1. クラスモジュールでアプリケーションの挙動を「フック」する。
2. Like演算子で特定の条件を「検知」する。
3. HTTP通信で外部サービス(Teams)と「連携」する。

この3つのステップは、VBAに限らず、あらゆるプログラミング言語に通ずる「自動化の黄金律」です。

まずは、ご自身のTeams Webhook URLを取得して、このコードを動かしてみてください。自分の書いたコードが、物理的な距離を超えてチャットツールにメッセージを飛ばした瞬間、プログラミングの真の楽しさに気づくはずです。

「ここをクリアすれば、PowerPoint VBAの基本はバッチリですよ。さあ、次はもっと複雑な仕組みに挑戦しましょう!」

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