「記録」の先へ。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!
