【実務・中級編】【中級者】FSOを駆使し、指定フォルダ以下のサブフォルダ構造を完全に維持したまま、内部のすべてのPPTXファイルを一括でPDFへ変換・配置する階層維持エクスポートツール – PowerPoint VBA解析バイブル

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

階層構造を「完全複製」せよ。FSOを用いたPowerPoint PDF一括変換ツールの設計思想

業務自動化の現場において、「ファイルを一括変換する」というタスクは一見、初歩的なものに見える。しかし、現場の要求は常に「単なる変換」では済まない。

「元のフォルダ構造を、寸分違わぬ形で維持したまま、PDFとして出力してくれ」

これが、プロフェッショナルに課せられる真の要件だ。

単に指定フォルダ内のファイルをなめるだけのスクリプトは、階層が深くなった瞬間にその価値を失う。フォルダの文脈(コンテキスト)を失ったファイル群は、情報の断片に過ぎず、管理不能なゴミの山へと変貌するからだ。

本記事では、`FileSystemObject (FSO)` を駆使し、再帰的処理によってディレクトリツリーを走査しながら、フォルダ構造をミラーリング(複製)してPDF出力を行う、堅牢なアーキテクチャを伝授する。

1. なぜ `Dir` 関数ではなく `FSO` なのか

VBAにおけるファイル操作の古典的な手法として `Dir` 関数がある。しかし、複雑なディレクトリ構造を扱う設計において、`Dir` を選択するのは設計ミスと言わざるを得ない。

`Dir` 関数はステートフル(状態を持つ)であり、再帰処理(関数の中で自分自身を呼び出す処理)を行う際に、現在の検索状態を保持するのが極めて困難である。一方、`FileSystemObject` はオブジェクト指向に基づいたモデルであり、フォルダやファイルを「オブジェクト」として扱える。

「状態を管理するのではなく、構造をオブジェクトとして捉える」

このパラダイムシフトこそが、バグの起きない堅牢なツールを作る第一歩だ。

2. 設計の要諦:再帰的ディレクトリ・ミラーリング

本ツールの設計思想は、以下の3つのレイヤーで構成される。

1. Orchestrator (司令塔): ユーザーから入力を受け取り、処理の開始と終了、およびエラーの最終的な捕捉を行う。
2. Recursive Walker (再帰的走査器): FSOを用いてフォルダツリーを深さ優先探索(DFS)し、ファイルとサブフォルダを峻別する。
3. Transformer (変換エンジン): 個別のPPTXファイルを読み込み、ターゲットとなるディレクトリ構造を「事前に構築」した上で、PDFとして保存する。

ここで最も重要なのは、「保存先のフォルダが存在しない場合、その場で作成する」というロジックだ。これがないと、変換エンジンは書き込みエラーで即座にクラッシュする。

3. プロダクション・コード:階層維持型PDFエクスポートツール

以下のコードは、実務での利用を想定し、参照設定を必要としない「レイトバインディング(遅延結合)」を採用している。これにより、配布時の「参照設定が足りません」という初歩的なトラブルを回避している。

Option Explicit

' =================================================================
' 階層構造維持型 PowerPoint PDF 一括変換ツール
' 設計思想: FSOによる再帰的走査 + ディレクトリ・ミラーリング
' =================================================================

Sub ExecuteHierarchicalExport()
    Dim fso As Object
    Dim sourceRoot As String
    Dim targetRoot As String
    Dim sourceFolder As Object
    
    ' 1. 初期設定
    Set fso = CreateObject("Scripting.FileSystemObject")
    
    ' ユーザーにフォルダを選択させる(簡易実装)
    ' 実務では、設定ファイルや引数から取得するのが望ましい
    With Application.FileDialog(msoFileDialogFolderPicker)
        .Title = "変換元のルートフォルダを選択してください"
        If .Show = -1 Then sourceRoot = .SelectedItems(1) Else Exit Sub
    End With
    
    With Application.FileDialog(msoFileDialogFolderPicker)
        .Title = "保存先のルートフォルダを選択してください"
        If .Show = -1 Then targetRoot = .SelectedItems(1) Else Exit Sub
    End With

    ' 2. 実行環境の最適化(画面更新停止、警告停止)
    On Error GoTo ErrorHandler
    With Application
        .ScreenUpdating = False
        .DisplayAlerts = ppAlertsNone
    End With

    Debug.Print "--- Process Started: " & Now & " ---"

    ' 3. 再帰処理の開始
    Set sourceFolder = fso.GetFolder(sourceRoot)
    RecursiveProcess fso, sourceFolder, sourceRoot, targetRoot

    Debug.Print "--- Process Completed Successfully ---"
    MsgBox "変換が完了しました。", vbInformation

CleanUp:
    ' 4. 環境の復元
    With Application
        .ScreenUpdating = True
        .DisplayAlerts = ppAlertsAll
    End With
    Set fso = Nothing
    Exit Sub

ErrorHandler:
    MsgBox "致命的なエラーが発生しました: " & Err.Description, vbCritical
    Resume CleanUp
End Sub

' -----------------------------------------------------------------
' 再帰的処理エンジン
' -----------------------------------------------------------------
Private Sub RecursiveProcess(ByRef fso As Object, ByRef currentFolder As Object, _
                             ByVal sourceRoot As String, ByVal targetRoot As String)
    Dim subFolder As Object
    Dim file As Object
    Dim relativePath As String
    Dim targetDirPath As String
    
    ' 現在のフォルダの相対パスを計算
    ' 例: C:\Src\A\B -> \A\B
    relativePath = Replace(currentFolder.Path, sourceRoot, "")
    If relativePath = "" Then relativePath = "\"
    
    ' 保存先のディレクトリパスを決定
    targetDirPath = targetRoot & relativePath
    
    ' 保存先フォルダが存在しなければ作成する(ミラーリングの核心)
    If Not fso.FolderExists(targetDirPath) Then
        CreateFolderTree fso, targetDirPath
    End If

    ' --- ファイルの処理 ---
    For Each file In currentFolder.Files
        ' PPTXファイルのみを対象とする(一時ファイル ~$ は除外)
        If (LCase(fso.GetExtensionName(file.Name)) = "pptx" Or _
            LCase(fso.GetExtensionName(file.Name)) = "ppt") And _
            Left(file.Name, 2) <> "~$" Then
            
            Call ConvertToPDF(file.Path, targetDirPath, fso)
        End If
    Next file

    ' --- サブフォルダの再帰処理 ---
    For Each subFolder In currentFolder.SubFolders
        RecursiveProcess fso, subFolder, sourceRoot, targetRoot
    Next subFolder
End Sub

' -----------------------------------------------------------------
' PDF変換エンジン
' -----------------------------------------------------------------
Private Sub ConvertToPDF(ByVal filePath As String, ByVal targetDir As String, ByRef fso As Object)
    Dim pres As Presentation
    Dim targetFileName As String
    Dim targetFilePath As String
    
    On Error Resume Next ' 個別のファイルエラーで全体を止めない
    
    ' 保存ファイル名の生成 (.pptx -> .pdf)
    targetFileName = fso.GetBaseName(filePath) & ".pdf"
    targetFilePath = targetDir & "\" & targetFileName
    
    ' ファイルを開く
    Set pres = Presentations.Open(filePath, WithWindow:=msoFalse)
    
    If Not pres Is Nothing Then
        ' PDFとして保存
        pres.ExportAsFixedFormat Path:=targetFilePath, _
                                 FixedFormatType:=ppFixedFormatTypePDF
        
        ' リソースの解放(重要:メモリリーク防止)
        pres.Close
        Set pres = Nothing
        Debug.Print "Converted: " & targetFileName
    Else
        Debug.Print "Failed to open: " & filePath
    End If
    
    If Err.Number <> 0 Then
        Debug.Print "Error processing " & filePath & ": " & Err.Description
        Err.Clear
    End If
    On Error GoTo 0
End Sub

' -----------------------------------------------------------------
' ディレクトリツリー作成補助(再帰的にフォルダを作成)
' -----------------------------------------------------------------
Private Sub CreateFolderTree(ByRef fso As Object, ByVal path As String)
    If fso.FolderExists(path) Then Exit Sub
    
    Dim parentPath As String
    parentPath = fso.GetParentFolderName(path)
    
    ' 親フォルダがなければ、親を先に作る(再帰的作成)
    If Not fso.FolderExists(parentPath) Then
        CreateFolderTree fso, parentPath
    End If
    
    fso.CreateFolder path
End Sub

4. アーキテクトの視点:なぜこのコードは「壊れない」のか

このコードを単なる「動くコード」として見てはいけない。プロフェッショナルが注視すべきは、以下の3点だ。

① メモリ管理とオブジェクトのライフサイクル

`Presentations.Open` で開いたオブジェクトを `pres.Close` せずに放置するのは、自動化エンジニアとして致命的なミスだ。大量のファイルを処理する場合、PowerPointのプロセスがメモリを食いつぶし、最終的にOSごと不安定になる。本コードでは、各ファイル処理の直後に必ず `pres.Close` と `Set pres = Nothing` を実行し、リソースを確実に解放している。

② `CreateFolderTree` による階層の担保

標準的な `MkDir` 関数は、親ディレクトリが存在しない場合にエラーを吐く。本コードでは、`CreateFolderTree` という補助関数を実装し、ターゲットパスを構成する全階層を再帰的に遡って作成する設計にしている。これにより、どれほど深いディレクトリ構造であっても、確実に「ミラーリング」が可能になる。

③ エラーハンドリングの階層化

全体を制御する `ErrorHandler` と、個別のファイル処理を司る `On Error Resume Next` を使い分けている。

  • 全体エラー: フォルダアクセス権限がない等の「継続不能な問題」を検知。
  • 個別エラー: 「特定のファイルが破損している」などの「単発的な問題」を検知し、ログに残しつつ、他のファイルの処理を止めない。

この「全滅させない設計」こそが、業務ツールに求められる堅牢性である。

結論

自動化ツールを構築する際、目先の「変換ができるか」という問いに答えを出すのは容易だ。しかし、真のプロフェッショナルは「構造を維持できるか」「リソースを枯渇させないか」「例外に対してどれだけ寛容か」を問う。

FSOによる再帰的アプローチと、徹底したリソース管理。この原則を胸に、次なる自動化の領域へと踏み出してほしい。

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