【テクニカル・上級編】【中級者向け】添付ファイル名が重複した際に「(1), (2)…」と連番を付与して上書きを防止するループ処理 – Outlook VBA解析バイブル

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

衝突を制御せよ:Outlook VBAにおける決定論的な添付ファイル保存戦略

業務自動化の現場において、最も低俗で、かつ最も致命的なエラーは何か。それは「例外処理の欠如によるデータの消失」である。

特にOutlookの添付ファイルを自動保存する仕組みを構築する際、多くの開発者は「ファイルが存在しなければ保存する」という、あまりにナイーブ(素朴)なロジックを書き込む。しかし、実運用環境では、同一名のファイルが重複して送られてくることは日常茶飯事だ。単純な実装は、既存の重要ファイルを無慈悲に上書きし、数時間の作業を、あるいは数日分のログを、一瞬にしてゴミへと変える。

本稿では、単なる「連番付与」のコードを提示するのではない。ファイルシステムの競合をいかに制御し、メモリのリソースをいかに管理し、レガシーなCOMオブジェクトをいかにエレガントに解体するか。アーキテクトの視点から、堅牢な実装の真髄を解説する。

1. 凡庸な実装と、プロフェッショナルの設計思想

多くのエンジニアが書くコードは、以下のようなものだ。

' --- 避けるべき、脆弱な実装の例 ---
If Dir(targetPath) <> "" Then
    ' 名前を変えるロジックが不完全、あるいは存在しない
End If

この実装には、設計上の欠陥が3点ある。
1. 拡張子の分離が不適切: `file.pdf` を `file.pdf(1)` としてしまうミス。
2. 決定論の欠如: ループ内でファイル名が動的に変化する際、`Dir` 関数の内部状態を正しく管理できていない。
3. リソースの不適切な管理: Outlookの `Attachment` オブジェクトを使い捨てにし、メモリリークを誘発している。

我々が目指すべきは、「ファイル名、拡張子、連番」を完全に分離し、ファイルシステムに存在しない名前が確定するまで、決定論的に探索を繰り返すアルゴリズムである。

2. 実装:堅牢な連番付与アルゴリズム

以下に、実戦投入可能なコードを示す。ここでは、ファイル操作の信頼性を高めるために `FileSystemObject` を補助的に利用しつつ、高速な存在確認のために `Dir` 関数を組み合わせるハイブリッドなアプローチを採用する。

Option Explicit

''' <summary>
''' Outlookの受信アイテムから添付ファイルを安全に保存する。
''' </summary>
Public Sub ProcessAttachmentsRobustly(ByRef olItem As Object)
    Dim olAttachment As Object ' Outlook.Attachment
    Dim fso As Object          ' Scripting.FileSystemObject
    Dim saveFolder As String
    Dim targetPath As String
    Dim uniquePath As String
    
    ' 保存先ディレクトリの定義(環境変数等から取得するのが望ましい)
    saveFolder = CreateObject("WScript.Shell").SpecialFolders("Desktop") & "\AttachedFiles\"
    
    ' ディレクトリの存在確認と作成
    Set fso = CreateObject("Scripting.FileSystemObject")
    If Not fso.FolderExists(saveFolder) Then
        fso.CreateFolder (saveFolder)
    End If

    On Error GoTo ErrorHandler

    ' 添付ファイルのループ処理
    For Each olAttachment In olItem.Attachments
        ' 1. 初期パスの構築
        targetPath = saveFolder & olAttachment.FileName
        
        ' 2. 重複回避アルゴリズムの呼び出し
        uniquePath = GetUniqueFilePath(targetPath)
        
        ' 3. 保存の実行
        olAttachment.SaveAsFile uniquePath
        
        ' --- メモリ最適化 ---
        ' 大規模な添付ファイルを扱う場合、オブジェクトの明示的解放が重要
        Set olAttachment = Nothing
    Next olAttachment

CleanUp:
    Set fso = Nothing
    Exit Sub

ErrorHandler:
    ' ログ出力等の実運用に即したエラーハンドリング
    Debug.Print "Error in ProcessAttachmentsRobustly: " & Err.Description
    Resume CleanUp
End Sub

''' <summary>
''' ファイル名の重複を検知し、(1), (2)... と連番を付与した一意のパスを返す。
''' </summary>
''' <param name="basePath">重複確認を行う元のフルパス</param>
Private Function GetUniqueFilePath(ByVal basePath As String) As String
    Dim fso As Object
    Dim fileExt As String
    Dim baseName As String
    Dim folderPath As String
    Dim candidatePath As String
    Dim counter As Integer
    
    Set fso = CreateObject("Scripting.FileSystemObject")
    
    ' パス要素の分解
    folderPath = fso.GetParentFolderName(basePath) & "\"
    baseName = fso.GetBaseName(basePath)
    fileExt = fso.GetExtensionName(basePath)
    
    ' 拡張子がある場合はドットを付与
    If fileExt <> "" Then
        fileExt = "." & fileExt
    End If
    
    candidatePath = basePath
    counter = 1
    
    ' Dir関数を用いた決定論的な存在確認ループ
    ' Dir関数はファイルが存在しない場合に空文字を返す特性を利用
    Do While Dir(candidatePath) <> ""
        ' 新しいファイル名の構築: BaseName(n).ext
        candidatePath = folderPath & baseName & "(" & counter & ")" & fileExt
        counter = counter + 1
        
        ' 無限ループ防止のための安全装置(実運用では必須)
        If counter > 1000 Then
            Err.Raise 9999, , "Too many filename collisions."
        End If
    Loop
    
    GetUniqueFilePath = candidatePath
    Set fso = Nothing
End Function

3. アーキテクトの深淵:メモリとオブジェクトのライフサイクル

このコードを単なる「動くコード」で終わらせてはならない。シニアエンジニアとして意識すべきは、COM(Component Object Model)のライフサイクルである。

オブジェクトの明示的解放

VBAにおける `Set obj = Nothing` は、単なるマナーではない。Outlookのような巨大なアプリケーションのプロセス内で動くVBAは、適切に参照カウントを減らさなければ、メモリリークを引き起こし、最終的にOutlookのクラッシュ(`outlook.exe` の異常終了)を招く。特に `For Each` ループ内で `Attachment` オブジェクトを扱う際は、ループの終端で明示的に参照を切り離す習慣を付けるべきだ。

Windows APIへの昇華(高度な知見)

上記のコードでは `Dir` 関数を使用している。これは十分に高速であり、標準的な用途には最適だ。しかし、ネットワークドライブ(UNCパス)上のファイルに対して、極めて高い頻度でアクセスを行う場合、`Dir` 関数はネットワークのレイテンシやファイルシステムのキャッシュ挙動に影響を受け、稀に不正確な挙動を示すことがある。

もし、ミッションクリティカルなシステム(数万件のファイルを数分で処理するようなバッチ処理)を構築するのであれば、`Dir` を捨て、Windows APIの `GetFileAttributes` を直接呼び出す実装に切り替えるべきだ。

' Windows APIによるファイル存在確認の例
Private Declare PtrSafe Function GetFileAttributes Lib "kernel32" Alias "GetFileAttributesA" (ByVal lpFileName As String) As Long
Private Const INVALID_FILE_ATTRIBUTES As Long = &HFFFFFFFF

Public Function FileExistsAPI(ByVal filePath As String) As Boolean
    FileExistsAPI = (GetFileAttributes(filePath) <> INVALID_FILE_ATTRIBUTES)
End Function

APIを直接叩くことで、VBAランタイムのオーバーヘッドを最小化し、OSレベルの決定論的な結果を得ることができる。

4. 結論

堅牢な自動化システムとは、「起こりうる最悪のシナリオ(ファイル重複、ネットワーク断絶、メモリ不足)を、設計段階で計算に入れたもの」である。

今回提示した `GetUniqueFilePath` のロジックは、その一歩目に過ぎない。しかし、ファイル名の衝突を「エラー」としてではなく、「制御可能な事象」として扱うその姿勢こそが、プロフェッショナルなエンジニアと、単なるスクリプト作成者を分かつ境界線である。

実装においては、常に「このコードが、100万回のループに耐えられるか?」を自問自答せよ。

Author: *Legendary Chief Architect*
Category: *Automation Engineering / Outlook VBA / Robust Design*

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