【入門編】ヘッダー内のテキストを読み取り、ファイル名を自動生成して保存するVBA – Word VBA解析バイブル

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

【Word VBAの極意】ヘッダーから「意志」を読み取る:ファイル名自動生成のアーキテクチャ

こんにちは。現場の自動化を設計するチーフアーキテクトです。

「マクロの記録」ボタンを押して、記録されたコードを眺めて「ふーん、こんな感じか」で終わっていませんか? もしそうなら、あなたはまだWord VBAの「表面」しか触れていません。

マクロの記録は、あくまで「操作の録画」です。しかし、私たちが作りたいのは「状況に応じて判断し、自律的に動くプログラム」ですよね。

今日は、実務で非常にニーズの高い「ヘッダー内に記載されたプロジェクトコードを読み取り、それをファイル名にして自動保存する」というテーマを扱います。これは、単なる書き換えのテクニックではありません。Wordの「オブジェクトモデル」という階層構造を理解するための、最高の演習になります。

ここをクリアすれば、あなたは「記録係」から「設計者」へとステップアップできるはずですよ。さあ、始めていきましょう。

1. なぜ「ヘッダー」の操作は難しいのか?

初学者が最初につまずくのが、ヘッダーやフッターの操作です。
「画面上には見えているのに、VBAから指定しようとするとエラーが出る」あるいは「書き換わらない」。これは、Wordが持つ階層構造(オブジェクトモデル)の複雑さが原因です。

Word文書は、単なるテキストの塊ではありません。以下のような階層で管理されています。

1. Document(文書全体)
2. Section(セクション:改ページや余白の設定単位)
3. Header/Footer(ヘッダー・フッター:セクションごとに存在)
4. Range(範囲:テキストそのもの)

「ヘッダーの文字を読み取る」ということは、「文書の中の、どのセクションの、どの種類のヘッダー(初めだけ? 奇数ページ? それとも標準?)の、どの範囲(Range)を指しているのか」を、厳密に指定しなければならないのです。

この「階層を一段ずつ降りていく感覚」を掴むことが、自動化エンジニアへの第一歩です。

2. 実践:プロジェクトコード抽出・自動保存マクロ

それでは、具体的なシナリオを想定しましょう。
「ヘッダーの冒頭に『Project: ABC-123』のように記載されている。この『ABC-123』の部分を抜き出して、その名前で保存したい」

以下のコードは、実務に耐えうるよう「エラーハンドリング」と「禁止文字の除去」を組み込んだ、プロ仕様の構成にしています。

Option Explicit

''' <summary>
''' ヘッダーからプロジェクトコードを抽出し、ファイル名を変更して保存する
''' </summary>
Sub SaveDocumentByHeaderCode()
    Dim doc As Document
    Set doc = ActiveDocument
    
    Dim headerText As String
    Dim projectCode As String
    Dim targetFileName As String
    Dim savePath As String
    
    ' 1. 保存先のパスを指定(この文書と同じフォルダ)
    savePath = doc.Path & "\"
    If savePath = "\" Then
        MsgBox "先に文書を一度保存してください。", vbExclamation
        Exit Sub
    End If

    On Error GoTo ErrorHandler

    ' 2. ヘッダーのテキストを取得
    ' ここでは「最初のセクション」の「メインのヘッダー」を指定しています
    ' wdHeaderFooterPrimary = 標準のヘッダー
    headerText = doc.Sections(1).Headers(wdHeaderFooterPrimary).Range.Text
    
    ' 3. プロジェクトコードの抽出ロジック
    ' 今回は「Project: 」という文字列の後ろを抜き出す設計にします
    Dim searchStr As String
    searchStr = "Project: "
    
    Dim pos As Long
    pos = InStr(headerText, searchStr)
    
    If pos > 0 Then
        ' 「Project: 」の直後から、改行までの文字列を切り出す
        projectCode = Mid(headerText, pos + Len(searchStr))
        ' 改行コードが含まれる場合があるので、Trimで余白や制御文字を掃除する
        projectCode = Trim(Replace(projectCode, vbCr, ""))
        projectCode = Trim(Replace(projectCode, vbLf, ""))
    Else
        MsgBox "ヘッダー内に 'Project: ' が見つかりませんでした。", vbCritical
        Exit Sub
    End If

    ' 4. ファイル名に使えない禁止文字をクリーニング(重要!)
    ' Windowsのファイル名に使えない記号を空文字に置換します
    projectCode = CleanFileName(projectCode)
    
    If projectCode = "" Then
        MsgBox "有効なプロジェクトコードが抽出できませんでした。", vbCritical
        Exit Sub
    End If

    ' 5. 保存実行
    targetFileName = savePath & projectCode & ".docx"
    
    ' SaveAs2 は、現在のWordの標準的な保存メソッドです
    doc.SaveAs2 FileName:=targetFileName
    
    MsgBox "保存が完了しました!" & vbCrLf & "ファイル名: " & projectCode & ".docx", vbInformation

    Exit Sub

ErrorHandler:
    MsgBox "予期せぬエラーが発生しました。" & vbCrLf & _
           "エラー番号: " & Err.Number & vbCrLf & _
           "内容: " & Err.Description, vbCritical
End Sub

''' <summary>
''' ファイル名に使用できない禁止文字を除去するサブルーチン
''' </summary>
Function CleanFileName(ByVal text As String) As String
    Dim invalidChars As Variant
    Dim i As Integer
    
    ' Windowsでファイル名に使えない文字のリスト
    invalidChars = Array("\", "/", ":", "*", "?", """", "<", ">", "|")
    
    For i = LBound(invalidChars) To UBound(invalidChars)
        text = Replace(text, invalidChars(i), "")
    Next i
    
    CleanFileName = text
End Function

3. コードの深掘り:プロが意識している3つのポイント

このコードをただコピペするだけでは、あなたの成長は止まってしまいます。エンジニアとして、以下の3点に注目して読み解いてください。

① オブジェクトの特定(SectionsとHeaders)

`doc.Sections(1).Headers(wdHeaderFooterPrimary).Range.Text`
この一行が、このプログラムの心臓部です。

  • `Sections(1)`:文書の最初のセクションを指定。
  • `Headers(wdHeaderFooterPrimary)`:一番標準的なヘッダーを指定。

もし、文書が「最初のページのみ異なるヘッダー」という設定になっていたら、`wdHeaderFooterFirstPage` を指定する必要があります。「設定(プロパティ)がオブジェクトの挙動を決める」。これがWord VBAの鉄則です。

② データの「お掃除」(Sanitization)

ここが、初学者とプロの決定的な差です。
ヘッダーからテキストを読み取ると、目に見えない「改行コード(`vbCr`)」や「空白」が必ず混入します。これをそのままファイル名に使うと、`SaveAs2` メソッドは「ファイル名が不正です」と悲鳴を上げて停止します。
`Trim` 関数や `Replace` 関数を使って、「データを手に入れたら、まず綺麗にする」。この防衛的プログラミングが、堅牢なシステムを作ります。

③ 禁止文字への配慮(CleanFileName)

ユーザーがヘッダーに `Project: A/B` と書いてしまったらどうなるでしょうか?
`/` はファイル名に使えないため、保存時にエラーになります。`CleanFileName` という関数を別途用意して、記号を事前に排除しておく。この「例外的な入力への備え」こそが、設計者の視点です。

4. 陥りやすいエラーと対策

開発を進める中で、以下の現象に遭遇したら、落ち着いて対処してください。

  • 「実行時エラー ‘5’: プロシージャの呼び出し、または引数が不正です」
  • 原因: ファイル名に `/` や `:` などの禁止文字が入っている可能性が極めて高いです。
  • 対策: 先ほどの `CleanFileName` 関数が正しく機能しているか、デバッグ(F8キーでのステップ実行)で確認しましょう。
  • 「指定したオブジェクトが見つかりません」
  • 原因: セクションやヘッダーの指定が、実際の文書構造とズレています。
  • 対策: `doc.Sections.Count` をイミディエイトウィンドウで確認し、文書がどのような構造になっているか把握しましょう。

おわりに:次のステップへ

お疲れ様でした。これであなたは、「ヘッダーという特殊な領域から情報を抽出し、それをファイル名というシステム的な値へと変換する」という、高度な自動化の基礎をマスターしました。

「マクロの記録」は、あくまで便利な辞書です。しかし、今回のように「オブジェクトの階層を理解し、データの汚れを考慮し、エラーを予見する」。この思考プロセスこそが、真のエンジニアリングです。

次は、このコードを応用して「複数のセクションをループで回して、全てのヘッダーを確認する」といった拡張に挑戦してみてください。

一歩ずつ、確実に。あなたの自動化の旅を応援しています!

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