【入門編】【上級者向け】添付ファイル保存処理の「実行時間」を計測し、ログファイルに記録してパフォーマンスを可視化する – Outlook VBA解析バイブル

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

「動けばいい」を卒業しよう。Outlook VBAでパフォーマンスを可視化する「プロファイリング」の技術

こんにちは!業務自動化の世界へようこそ。

マクロの記録機能を使って、「あ、これ自動化できるかも!」と気づけたあなたは、すでに素晴らしい一歩を踏み出しています。最初は、自分が書いたコードが動いた瞬間に「魔法を使ったみたいだ!」と感動するものですよね。

しかし、エンジニアとして、そして「自動化のプロ」としてステップアップしていく過程で、必ず直面する壁があります。それは、「処理が重い。なぜ遅いのか、どこが原因なのか分からない」という問題です。

例えば、添付ファイルを10個保存する時は一瞬だったのに、100通のメールを処理しようとした途端、Outlookが固まったようになってしまう……。そんな経験はありませんか?

今日は、単に「動くコード」を書く段階から、「どこが遅いのかを特定し、最適化できるコード」を書く段階へ、あなたを導きます。キーワードは「プロファイリング(計測)」です。

1. なぜ「計測」が必要なのか?

多くの初学者は、処理が遅いとき「もっと速い書き方があるはずだ」と、根拠のない勘でコードを書き直してしまいます。しかし、これは非常に効率が悪い。

プロの仕事は、「ボトルネック(処理の詰まりどころ)」を特定することから始まります。

  • メールの件数を数えるのが遅いのか?
  • 添付ファイルをスキャンしているのが遅いのか?
  • それとも、ファイルをハードディスク(またはネットワークドライブ)に書き込む時間がかかっているのか?

これらを「感覚」ではなく「数字」で把握する。これが、プログラミングにおける「科学的なアプローチ」です。

2. VBAにおける計測の武器:`Timer` 関数

VBAで時間を計る最もシンプルで強力な武器は、`Timer` 関数です。

`Timer` 関数は、「今日の午前0時からの経過秒数」を `Single` 型(単精度浮動小数点数)で返してくれます。これを利用して、「処理の開始時」と「処理の終了時」の差分を取ることで、かかった時間を算出できるのです。

計測の基本ロジック

Dim startTime As Single
Dim endTime As Single
Dim duration As Single

startTime = Timer ' 開始時間を記録

' --- ここに計測したい処理を書く ---

endTime = Timer ' 終了時間を記録
duration = endTime - startTime ' 差分を計算

Debug.Print "処理時間は " & duration & " 秒でした。"

これだけです。非常にシンプルですよね?でも、これを「どの処理に対して」「どのように記録するか」が、プロの腕の見せ所です。

3. 実践:プロファイリング機能を備えた添付ファイル保存ツール

それでは、実際に使えるコードを見ていきましょう。
今回は、「受信トレイのメールから添付ファイルを保存し、その処理時間をログファイルに書き出す」という、実戦的なプログラムを作成します。

単に `Debug.Print` で表示するだけでなく、後から検証できるように テキストファイル(.log)へ出力する 仕様にしています。

Option Explicit

''' <summary>
''' メイン処理:添付ファイルを保存し、パフォーマンスを計測する
''' </summary>
Sub ProfileAttachmentSaving()
    Dim outlookApp As Outlook.Application
    Dim ns As Outlook.NameSpace
    Dim inbox As Outlook.Folder
    Dim mailItem As Object
    Dim attachment As Outlook.Attachment
    Dim savePath As String
    Dim logFilePath As String
    
    ' --- 設定エリア ---
    savePath = "C:\Temp\SavedAttachments\" ' 保存先フォルダ(あらかじめ作成しておいてください)
    logFilePath = "C:\Temp\Automation_Log.txt" ' ログの出力先
    ' ------------------

    ' 保存先フォルダがない場合は作成(エラー回避のため)
    If Dir(savePath, vbDirectory) = "" Then MkDir savePath

    Set outlookApp = New Outlook.Application
    Set ns = outlookApp.GetNamespace("MAPI")
    Set inbox = ns.GetDefaultFolder(olFolderInbox)

    ' 全体の開始時間を記録
    Dim totalStartTime As Single
    totalStartTime = Timer

    Debug.Print "--- プロファイリング開始 ---"
    
    ' 受信トレイのメールをループ(例として最新の20件のみ)
    Dim i As Integer
    Dim count As Integer
    count = 0
    
    ' ※実際には条件に合わせてループ範囲を調整してください
    For i = inbox.Items.count To 1 Step -1
        If count >= 20 Then Exit For ' テスト用に20件で制限
        
        Set mailItem = inbox.Items(i)
        
        ' メールアイテムである場合のみ処理
        If TypeOf mailItem Is Outlook.MailItem Then
            If mailItem.Attachments.count > 0 Then
                
                ' --- 【重要】ここから個別の処理計測 ---
                Dim procStartTime As Single
                Dim procEndTime As Single
                Dim procDuration As Single
                
                procStartTime = Timer ' 添付ファイル処理の開始
                
                ' 添付ファイルの保存処理
                For Each attachment In mailItem.Attachments
                    ' ファイル名を取得して保存
                    attachment.SaveAsFile savePath & attachment.FileName
                Next attachment
                
                procEndTime = Timer ' 添付ファイル処理の終了
                procDuration = procEndTime - procStartTime
                ' --- 【重要】ここまで ---

                ' ログに記録(メール件名と処理時間)
                Call WriteLog(logFilePath, "Email: " & mailItem.Subject & " | Time: " & Format(procDuration, "0.000") & " sec")
                
                count = count + 1
            End If
        End If
    Next i

    ' 全体の終了時間を記録
    Dim totalEndTime As Single
    totalEndTime = Timer
    Dim totalDuration As Single
    totalDuration = totalEndTime - totalStartTime

    ' 全体結果のログ出力
    Call WriteLog(logFilePath, "========================================")
    Call WriteLog(logFilePath, "TOTAL PROCESS COMPLETED. Total Time: " & Format(totalDuration, "0.000") & " sec")
    Call WriteLog(logFilePath, "========================================")

    MsgBox "処理が完了しました。ログを確認してください。" & vbCrLf & logFilePath, vbInformation
End Sub

''' <summary>
''' ログファイルに文字列を追記する補助関数
''' </summary>
''' <param name="filePath">出力先のパス</param>
''' <param name="message">記録したいメッセージ</param>
Sub WriteLog(filePath As String, message As String)
    Dim fso As Object
    Dim logFile As Object
    Dim timestamp As String
    
    Set fso = CreateObject("Scripting.FileSystemObject")
    
    ' 現在の時刻を取得(ログのタイムスタンプ用)
    timestamp = Format(Now, "yyyy-mm-dd HH:mm:ss")
    
    ' ファイルを追記モード(8)で開く。ファイルがなければ作成する。
    ' 8 = ForAppending
    On Error Resume Next
    Set logFile = fso.OpenTextFile(filePath, 8, True)
    
    If Err.Number = 0 Then
        logFile.WriteLine "[" & timestamp & "] " & message
        logFile.Close
    Else
        Debug.Print "ログ書き込みエラー: " & Err.Description
    End If
    On Error GoTo 0
    
    Set logFile = Nothing
    Set fso = Nothing
End Sub

4. コードの解説と、プロの視点

このコードには、単なる「保存マクロ」とは異なる、重要な設計思想がいくつか含まれています。

① 粒度の異なる計測

コードの中に、`totalStartTime`(全体の時間)と `procStartTime`(添付ファイル処理単体の時間)の2種類を用意しています。
これにより、「プログラム全体の実行時間」と、「最も負荷がかかっている特定のパーツ(添付ファイル保存)の実行時間」を分けて把握できます。

② FileSystemObject (FSO) の活用

ログの書き込みに `WriteLog` という専用のサブルーチンを作りました。
ここで `Scripting.FileSystemObject` を使っています。これは、ファイル操作を非常に強力かつ安全に行うためのオブジェクトです。`OpenTextFile` メソッドの第2引数に `8` を指定することで、既存のログを消さずに「追記(Append)」していくことができます。

③ エラーへの配慮(堅牢性)

`On Error Resume Next` をログ書き込み部分に限定して使用しています。
もしログファイルが別のプログラムで開かれていて書き込みに失敗しても、メインの「添付ファイル保存」という重要な業務処理が止まってしまわないようにするためです。

5. ここをクリアすれば、次は「最適化」へ!

このコードを実行して、生成されたログを見てみてください。

もし、特定のメールで `Time: 5.000 sec` のように極端に大きな数値が出ていたら、そこが「犯人」です。

  • そのメールの添付ファイルは巨大ではないか?
  • その保存先のネットワークは遅延していないか?

原因がわかれば、次のような対策が打てます。

  • 「ファイルサイズが大きい場合は保存をスキップする」という条件分岐を追加する。
  • 「ネットワークドライブではなく、一度ローカルに保存してから移動する」という手順に変更する。

「計測できないものは、改善できない」

これは、ソフトウェアエンジニアリングにおける不変の真理です。
このプロファイリングの技術をマスターすれば、あなたはもう「なんとなく動くマクロ」を作る人ではなく、「根拠を持ってパフォーマンスを管理できるエンジニア」への道を歩み始めています。

一歩ずつ、確実に。頑張っていきましょう!

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