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

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

「動けばいい」は素人の思考だ。Outlook VBAにおけるプロファイリングと、ボトルネックを屠る設計思想

業務自動化の現場において、多くの開発者が陥る罠がある。それは「コードが正しく動くこと」をゴールにしてしまい、「コードが効率的に動いているか」を検証しないことだ。

添付ファイルの自動保存といった処理は、数通のメールであれば一瞬で終わる。しかし、運用が開始され、一日に数百、数千のメールが流れ込む環境では、その「わずかな遅延」が致命的なシステム遅延へと化ける。ループの回し方、ファイルI/Oの頻度、あるいはOutlook Object Modelへの過剰なアクセス。どこにボトルネックがあるのか、勘で探るような真似はするな。

本稿では、プロフェッショナルとして実装すべき「実行時間の計測(プロファイリング)」と「ログによるパフォーマンスの可視化」の手法を伝授する。

1. なぜ「Timer」による計測が必要なのか

VBAにおけるパフォーマンス計測の基本は、`Timer`関数を用いることだ。`Timer`は午前0時からの経過秒数を倍精度浮動小数点数で返す。これを利用することで、ミリ秒単位の精度で処理時間を算出できる。

我々が計測すべきは、関数全体の実行時間ではない。「どの工程に、どれだけのコストがかかっているか」という粒度の分解だ。

  • メールオブジェクトの走査(Iteration Cost)
  • 添付ファイルの判定ロジック(Logic Cost)
  • ディスクへの書き込み(I/O Cost)

これらを分離して計測することで、初めて「ファイル保存が遅いのか、それともOutlookのオブジェクト取得が遅いのか」という真実が見えてくる。

2. 堅牢なプロファイリング・アーキテクチャ

ログ出力処理自体がボトルネックになっては本末転倒だ。ログ出力は「非同期で行えない」VBAの制約を理解した上で、最小限のオーバーヘッドで設計する必要がある。

以下のコードは、実務レベルで耐えうる、エラーハンドリングと計測ロジックを統合したプロフェッショナルな実装例だ。

プロダクション・コード例:AttachmentProfiler

'---------------------------------------------------------------------------------------
' Module: modAttachmentProcessor
' Description: 添付ファイルの保存処理およびパフォーマンス計測ロジック
'---------------------------------------------------------------------------------------
Option Explicit

' ログ出力用の定数
Private Const LOG_FILE_PATH As String = "C:\Logs\OutlookAutomation_PerfLog.txt"

''' <summary>
''' メインエントリポイント:指定したフォルダ内のメールから添付ファイルを抽出・保存する
''' </summary>
Public Sub ProcessAttachmentsWithProfiling()
    Dim startTime As Double
    Dim totalStart As Double
    Dim mailItem As Object
    Dim folder As Outlook.MAPIFolder
    Dim attachment As Outlook.Attachment
    Dim saveFolder As String
    Dim loopStart As Double
    Dim saveStart As Double
    
    ' 計測開始
    totalStart = Timer
    saveFolder = "C:\SavedAttachments\"
    
    ' 保存先ディレクトリの存在確認(実務では必須)
    If Dir(saveFolder, vbDirectory) = "" Then
        MsgBox "保存先フォルダが存在しません。", vbCritical
        Exit Sub
    End If

    On Error GoTo ErrorHandler

    ' Outlookフォルダの指定(受信トレイを想定)
    Set folder = Application.GetNamespace("MAPI").GetDefaultFolder(olFolderInbox)
    
    WriteLog "--- Process Started ---"
    
    ' 1. メール走査フェーズの計測開始
    loopStart = Timer
    
    For Each mailItem In folder.Items
        ' メールアイテム以外はスキップ
        If TypeName(mailItem) = "MailItem" Then
            
            ' 2. 添付ファイル保存フェーズの計測開始
            saveStart = Timer
            
            If mailItem.Attachments.Count > 0 Then
                For Each attachment In mailItem.Attachments
                    ' 添付ファイルの保存実行
                    attachment.SaveAsFile saveFolder & attachment.FileName
                Next attachment
                
                ' 保存にかかった時間を記録
                WriteLog StringFormat("MailID: %s | SaveTime: %.4f sec", _
                                     mailItem.EntryID, Timer - saveStart)
            End If
            
        End If
    Next mailItem

    ' 走査全体の時間を記録
    WriteLog StringFormat("Total Iteration Time: %.4f sec", Timer - loopStart)
    WriteLog StringFormat("Total Execution Time: %.4f sec", Timer - totalStart)
    WriteLog "--- Process Completed ---"

    Exit Sub

ErrorHandler:
    WriteLog "ERROR: " & Err.Description
    MsgBox "予期せぬエラーが発生しました。ログを確認してください。", vbCritical
End Sub

''' <summary>
''' ログファイルへメッセージを追記する。
''' ファイルI/Oのオーバーヘッドを考慮し、Appendモードを使用。
''' </summary>
Private Sub WriteLog(ByVal message As String)
    Dim fileNo As Integer
    Dim timestamp As String
    
    On Error Resume Next ' ログ出力失敗がメイン処理を止めないためのガード
    timestamp = Format(Now, "yyyy-mm-dd hh:nn:ss")
    fileNo = FreeFile
    
    Open LOG_FILE_PATH For Append As #fileNo
    Print #fileNo, "[" & timestamp & "] " & message
    Close #fileNo
    On Error GoTo 0
End Sub

''' <summary>
''' 簡易的な文字列フォーマット関数(VBAにはString.Formatがないため)
''' </summary>
Private Function StringFormat(ByVal format As String, ParamArray args() As Variant) As String
    Dim i As Integer
    Dim result As String
    result = format
    
    For i = LBound(args) To UBound(args)
        ' %s や %.4f を引数で置換(簡易実装)
        ' 実務ではより高度な置換ロジックを検討すること
        result = Replace(result, "%s", CStr(args(i)))
        result = Replace(result, "%.4f", Format(args(i), "0.0000"))
    Next i
    
    StringFormat = result
End Function

3. アーキテクトの視点:設計の急所

このコードを単なる「コピペ用ツール」として終わらせてはいけない。以下の設計思想を理解し、自分のプロジェクトに昇華させろ。

① エラーハンドリングの分離

`WriteLog` 内で `On Error Resume Next` を使用している理由を考えたことがあるか?
ログ出力中にディスクフルやアクセス権限エラーが発生した際、そのエラーによって「本来実行されるべきメインの業務処理」が中断されることは、あってはならない。 ログはあくまで補助手段だ。メインロジックの堅牢性をログ出力が損なうことは、設計ミスである。

② コストの高い「COMオブジェクト」への意識

`For Each mailItem In folder.Items` のループ内で行っている操作は、すべてOutlook(外部プロセス)へのCOM呼び出しだ。
`mailItem.EntryID` や `mailItem.Attachments.Count` を呼び出すたびに、メモリ空間を越えた通信コストが発生している。もしパフォーマンスが極端に悪い場合は、一度すべての `EntryID` を配列に格納してから処理を行うなど、「通信回数を減らす設計」への転換が必要になる。

③ ファイルI/Oの戦略

上記のコードでは、毎回 `Open … For Append` を行っている。これはログの確実性を担保するためだ。しかし、もし数万件のメールを処理する場合、この「開いて閉じる」動作自体がボトルネックになる。
その場合は、「メモリ上のバッファ(String変数)にログを溜め込み、最後に一括で書き出す」という戦略をとるべきだ。トレードオフ(確実性 vs 速度)を常に意識せよ。

結論

パフォーマンスの可視化は、エンジニアの「誠実さ」の現れだ。
「たぶん大丈夫だろう」という予測でコードを書くのは今日で終わりにしろ。`Timer` を使い、ボトルネックを数値化し、ログとして残す。このプロセスをルーチン化することこそが、プロフェッショナルな自動化エンジニアへの第一歩である。

計測できないものは、改善できない。 これを肝に銘じておけ。

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