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

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

「記録」の先へ。PowerPoint VBAで「イベント」を支配し、チームの連携を自動化する極限の設計術

こんにちは。自動化の荒波を渡るエンジニアの皆さん。
今日は、皆さんが「マクロの記録」という殻を破り、真の「アプリケーション・オートメーション」へと足を踏み入れるための、非常にエキサイティングなテーマを用意しました。

「マクロを記録する」ことは、素晴らしい第一歩です。しかし、それはあくまで「決められた手順をなぞる」こと。プロのエンジニアが作るのは、「何かが起きた瞬間に、自律的に判断して動くシステム」です。

今回挑戦するのは、「特定の名前のプレゼンテーションが閉じられた瞬間、それを検知してTeamsに自動通知する」という仕組みです。

「えっ、閉じられた瞬間に何かをするなんて、どうやって検知するの?」と思ったあなた。その答えは、「クラスモジュールによるイベントハンドリング」にあります。

さあ、準備はいいですか? 伝説のアーキテクチャへの扉を開きましょう。

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

通常の標準モジュールに書いたコードは、あなたが「実行ボタン」を押したときにだけ動きます。しかし、今回やりたいことは「ユーザーがファイルを閉じる」という、プログラムの外側で起きる出来事をトリガーにすることです。

これを実現するには、PowerPointというアプリケーション全体を「監視」する「目(Observer)」が必要です。

  • 標準モジュール: 「命令」を実行する場所(例:スライドを作る)
  • クラスモジュール: 「出来事(イベント)」を待ち構える場所(例:ファイルが閉じられた!)

この「目」をアプリケーションに登録して、プログラムが動いている間ずっと維持させる。これが今回の設計の肝になります。

2. 実装の準備:参照設定の儀式

API(Teams)と通信するために、まずは「外部と会話するための道具」をVBAに教えてあげましょう。

1. PowerPointのVBAエディタを開く(`Alt + F11`)
2. メニューの [ツール] > [参照設定] をクリック
3. `Microsoft XML, v6.0` にチェックを入れて [OK] を押す

これを忘れると、後ほど「型が定義されていません」というエラーに泣かされることになります。

3. コードの実装:魂の設計図

実装は2つのステップで行います。

ステップ1:クラスモジュールで「監視者」を作る

まず、メニューの [挿入] > [クラスモジュール] を選択し、オブジェクト名を `clsAppEvent` に変更してください。

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

' PowerPointアプリケーション全体のイベントをキャッチするための宣言
' WithEvents を使うことで、アプリケーションの挙動を「監視」できるようになります
Private WithEvents App As Application

' クラスを初期化する際に、監視対象となるApplicationオブジェクトを受け取る
Public Sub Init(ByVal targetApp As Application)
    Set App = targetApp
End Sub

' プレゼンテーションが閉じられた時に自動的に呼び出されるイベント
Private Sub App_PresentationClose(ByVal Pres As Presentation)
    Dim targetName As String
    Dim userName As String
    
    ' 【命名規則の判定】
    ' ここでは、ファイル名が "Report_" で始まる場合のみ通知を送る設定にしています
    ' これにより、関係ないファイルまで通知が飛ぶのを防ぎます
    If Pres.Name Like "Report_*" Then
        
        ' 通知に必要な情報を取得
        targetName = Pres.Name
        userName = Application.UserName ' 現在操作しているユーザー名
        
        ' Teamsへ通知を送るメインルーチンを呼び出す
        ' ※後述の標準モジュールに定義します
        Call modMain.SendTeamsNotification(targetName, userName)
        
    End If
End Sub

ステップ2:標準モジュールで「司令塔」を作る

次に、[挿入] > [標準モジュール] を作成し、以下のコードを記述します。

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

' 【超重要】クラスモジュールのインスタンスを「パブリック変数」として保持する
' これを忘れると、マクロが動いた瞬間に監視者が消滅(ライフサイクル終了)してしまいます
Private AppHandler As clsAppEvent

' WebhookのURL(Teamsのチャネルから取得したものに書き換えてください)
Private Const TEAMS_WEBHOOK_URL As String = "https://your-org.webhook.office.com/..."

' 監視を開始するプロシージャ
Sub StartMonitoring()
    ' 監視者(クラスインスタンス)を生成
    Set AppHandler = New clsAppEvent
    
    ' 監視者にPowerPoint自身を登録
    AppHandler.Init Application
    
    MsgBox "プレゼンテーションの監視を開始しました。" & vbCrLf & _
           "ファイル名が 'Report_' で始まるものを検知します。", vbInformation
End Sub

' 監視を停止するプロシージャ
Sub StopMonitoring()
    Set AppHandler = Nothing
    MsgBox "監視を終了しました。", vbExclamation
End Sub

' TeamsへHTTP POSTリクエストを送信するプロシージャ
Sub SendTeamsNotification(fileName As String, user As String)
    Dim http As MSXML2.XMLHTTP60
    Dim jsonPayload As String
    Dim message As String
    
    ' 送信するメッセージの組み立て
    message = "📢 成果物が更新されました" & vbCrLf & _
              "👤 担当者: " & user & vbCrLf & _
              "📄 ファイル名: " & fileName & vbCrLf & _
              "⏰ 時刻: " & Now()
    
    ' Teams Webhookが受け取れるJSON形式を作成
    ' ※JSON内のダブルクォーテーションは "" と2つ重ねるのがVBAのルールです
    jsonPayload = "{""text"": """ & message & """}"
    
    On Error GoTo ErrorHandler
    
    ' HTTP通信の開始
    Set http = New MSXML2.XMLHTTP60
    With http
        .Open "POST", TEAMS_WEBHOOK_URL, False
        .SetRequestHeader "Content-Type", "application/json"
        .Send jsonPayload
        
        ' ステータスコードが200系(成功)であることを確認
        If .Status < 200 Or .Status >= 300 Then
            Debug.Print "Error: " & .Status & " - " & .ResponseText
        End If
    End With
    
    Set http = Nothing
    Exit Sub

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

4. プロフェッショナルの視点:陥りやすい「3つの罠」

このコードを動かす際、初心者が必ずと言っていいほどハマるポイントがあります。ここを理解しているかどうかが、初級者と上級者の分かれ道です。

罠その1:変数の寿命(ライフサイクル)

標準モジュールで `AppHandler` を `Dim`(ローカル変数)で宣言してしまうと、`StartMonitoring` プロシージャが終わった瞬間に、監視役のオブジェクトがメモリから消えてしまいます。
必ず `Private` または `Public` でモジュールレベル変数として宣言してください。

罠その2:命名規則の厳密さ

`If Pres.Name Like “Report_*”` の部分は、組織のルールに合わせて柔軟に変更してください。もし「特定のフォルダにある時だけ」という条件を加えたければ、`Pres.Path` をチェックするロジックを追加するのがスマートです。

罠その3:ネットワークの壁

社内環境によっては、VBAからの外部通信(HTTP POST)がプロキシサーバーやファイアウォールでブロックされることがあります。もし動かない場合は、まず `Debug.Print` を活用して、コードのどこまで進んでいるかを確認する「デバッグの習慣」を身につけましょう。

5. まとめ:自動化の先にある景色

お疲れ様でした。これであなたは、単に「作業を自動化する人」から、「チームのワークフローを設計する人」へと進化しました。

今回作った仕組みは、以下のような価値を生みます。
1. 報告コストの削減: 「保存しました!」というチャットを送る手間がゼロになる。
2. 情報の同期: 誰がいつ更新したかが、自動的にログとして残る。
3. ミスの防止: 報告忘れによる情報の遅延を防ぐ。

プログラミングの本質は、コードを書くことではなく、「人間が介在することで発生する摩擦を、技術で解決すること」にあります。

このコードをベースに、自分なりのアレンジを加えてみてください。それが、あなたのエンジニアとしての血肉となります。

Happy Coding!

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