LoginSignup
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

@iceblue(リー ニック)

Pythonを使用してExcel表をWord文書に挿入する

Posted at

日常業務において、Pythonスクリプトを使用してExcelのデータをWord文書に自動統合することで、表のスマートな移行を実現し、さまざまなシナリオでのデータ表示の専門的な要件を満たすことができます。表の内容を直接Wordに挿入することで、重要なデータを素早く伝達でき、情報を正確に届けることが可能です。また、表のスタイルやフォーマットを完全にコピーすることで、元のデータの視覚的な表現を保持し、公式なレポートの厳格なレイアウト基準を満たすことができます。さらに、OLEオブジェクトとして表を埋め込むことで、ドキュメントの動的な更新が可能になり、元のデータが変更された場合でも、オブジェクトをダブルクリックすることで直接Excelを開いて編集できます。このインタラクティブな設計は、長期的に維持するコラボレーションファイルに特に適しています。

本記事では、以下の3つの方法でPythonを使用してExcel表をWord文書に挿入する方法を紹介します。

本記事で使用するWord文書の操作には、Free Spire.Doc for Python（PyPI：pip install spire.doc.free）が必要です。また、Excelワークシートのデータを読み取るには、Free Spire.XLS for Python（PyPI：pip install spire.xls.free）を使用します。

ExcelワークシートのデータをWord文書に挿入する

Excelワークシートのデータを直接読み取り、Word文書内に表を作成してデータを挿入することで、Excelの表をWord文書に組み込むことができます。以下の手順で操作を行います。

  1. Excelファイルを読み込む

    • Workbook インスタンスを作成し、LoadFromFile() を使用してExcelファイルを読み込む。
    • Worksheets.get_Item(0) を使用して最初のワークシートを取得する。
    • AllocatedRange を使用して使用済みのセル範囲を取得する。

  2. Word文書を作成し、表を追加する

    • Document インスタンスを作成し、AddSection() を使用してセクションを追加する。
    • AddTable() を使用して表を追加する。

  3. ExcelのヘッダーをWordにコピーする

    • AddRow() を使用してヘッダー行を追加する。
    • AddCell().AddParagraph().AppendText() を使用してヘッダーテキストを挿入する。

  4. Excelのデータ行をWordにコピーする

    • Excelのデータ行をループ処理し、AddRow() を使用してデータ行を追加する。
    • Cells.get_Item(col).AddParagraph().AppendText() を使用してセルの内容を挿入する。
    • セルに数式が含まれる場合は、FormulaValue を使用し、それ以外は Value を使用する。

  5. 表のスタイルを調整し、Word文書を保存する

    • AutoFit(AutoFitBehaviorType.AutoFitToWindow) を使用して表をウィンドウに合わせる。
    • ApplyStyle(DefaultTableStyle.GridTable1LightAccent6) を使用して表のスタイルを設定する。
    • SaveToFile(path, FileFormat.Docx2019) を使用してWord文書を保存する。

コード例

from spire.doc import Document, AutoFitBehaviorType, FileFormat, DefaultTableStyle
from spire.xls import Workbook

# 指定されたExcelファイルパスと出力先Word文書パス
excel_file = "Sample.xlsx"
word_file = "output/ExcelDataToWord.docx"

# Excelを読み込む
with Workbook() as workbook:
    workbook.LoadFromFile(excel_file)
    worksheet = workbook.Worksheets.get_Item(0)
    allocated_range = worksheet.AllocatedRange

    # Word文書を作成する
    with Document() as doc:
        section = doc.AddSection()
        table = section.AddTable()

        # ヘッダー行を追加する
        header_row = table.AddRow()
        for col in range(allocated_range.ColumnCount):
            cell = header_row.AddCell()
            paragraph = cell.AddParagraph()
            paragraph.AppendText(allocated_range.get_Item(1, col + 1).Text)

        # データ行を追加する
        for row in range(1, allocated_range.RowCount):
            data_row = table.AddRow()
            for col in range(allocated_range.ColumnCount):
                cell = data_row.Cells.get_Item(col)
                paragraph = cell.AddParagraph()
                cell_value = allocated_range.get_Item(row + 1, col + 1)
                text = cell_value.FormulaValue if cell_value.HasFormula else cell_value.Value
                paragraph.AppendText(text)

        # 表の自動調整とスタイルの適用
        table.AutoFit(AutoFitBehaviorType.AutoFitToWindow)
        table.ApplyStyle(DefaultTableStyle.GridTable1LightAccent6)

        # Word文書を保存する
        doc.SaveToFile(word_file, FileFormat.Docx2019)

結果
ExcelワークシートのデータをWord文書に挿入する

ExcelワークシートのデータとフォーマットをWord文書にコピーする

ExcelのデータをWord文書にコピーすると同時に、セルのフォーマットやテキストのスタイルも維持することで、高い再現度でExcel表をWord文書に挿入できます。以下の手順で操作を行います。

  1. Excelファイルを読み込む

    • Workbook インスタンスを作成し、LoadFromFile() を使用してExcelファイルを読み込む。
    • 最初のワークシート sheet を取得する。

  2. Word文書を作成し、ページの向きを設定する

    • Document インスタンスを作成し、AddSection() を追加する。
    • section.PageSetup.Orientation = PageOrientation.Landscape を設定する。

  3. Word表を作成する

    • AddTable(True) を使用して表を作成する。
    • ResetCells(sheet.LastRow, sheet.LastColumn) で行数と列数を設定する。

  4. セルの結合を実行する

    • merge_cells(sheet, table) を使用して、Excelの結合セルをWordに反映させる。

  5. ExcelのデータとスタイルをWord表にコピーする

    • Excelの各セルをループ処理し、AddParagraph().AppendText() でデータを挿入する。
    • copy_style(text_range, x_cell, w_cell) でExcelのスタイルを適用する。

  6. Word文書を保存する

    • SaveToFile("output/CopyExcelDataStyleToWord.docx", FileFormat.Docx2019) で保存する。

  7. リソースを解放する

    • doc.Dispose() と workbook.Dispose() を呼び出す。

コード例

from spire.xls import *
from spire.doc import *


def merge_cells(sheet, table):
    """Excelの結合セル情報に基づき、Word表に対応する結合操作を実行します。"""
    if not sheet.HasMergedCells:
        return

    for cell_range in sheet.MergedCells:
        start_row, start_col = cell_range.Row, cell_range.Column
        row_count, col_count = cell_range.RowCount, cell_range.ColumnCount

        # 横方向の結合処理
        if col_count > 1:
            for row in range(start_row, start_row + row_count):
                table.ApplyHorizontalMerge(row - 1, start_col - 1, start_col - 1 + col_count - 1)

        # 縦方向の結合処理
        if row_count > 1:
            table.ApplyVerticalMerge(start_col - 1, start_row - 1, start_row - 1 + row_count - 1)


def copy_style(text_range, excel_cell, word_cell):
    """ExcelのセルのスタイルをWordセルにコピーします。"""
    font = excel_cell.Style.Font
    text_range.CharacterFormat.TextColor = Color.FromRgb(font.Color.R, font.Color.G, font.Color.B)
    text_range.CharacterFormat.FontSize = float(font.Size)
    text_range.CharacterFormat.FontName = font.FontName
    text_range.CharacterFormat.Bold = font.IsBold
    text_range.CharacterFormat.Italic = font.IsItalic

    # セルの背景色を設定
    if excel_cell.Style.FillPattern != ExcelPatternType.none:
        word_cell.CellFormat.BackColor = Color.FromRgb(excel_cell.Style.Color.R, excel_cell.Style.Color.G,
                                                       excel_cell.Style.Color.B)

    # 水平配置を設定
    align_map = {
        HorizontalAlignType.Left: HorizontalAlignment.Left,
        HorizontalAlignType.Center: HorizontalAlignment.Center,
        HorizontalAlignType.Right: HorizontalAlignment.Right
    }
    if excel_cell.HorizontalAlignment in align_map:
        text_range.OwnerParagraph.Format.HorizontalAlignment = align_map[excel_cell.HorizontalAlignment]

    # 垂直配置を設定
    valign_map = {
        VerticalAlignType.Top: VerticalAlignment.Top,
        VerticalAlignType.Center: VerticalAlignment.Middle,
        VerticalAlignType.Bottom: VerticalAlignment.Bottom
    }
    if excel_cell.VerticalAlignment in valign_map:
        word_cell.CellFormat.VerticalAlignment = valign_map[excel_cell.VerticalAlignment]


# Excelファイルを読み込む
workbook = Workbook()
workbook.LoadFromFile("Sample.xlsx")

# 最初のシートを取得
sheet = workbook.Worksheets[0]

# Word文書を作成する
doc = Document()
section = doc.AddSection()
section.PageSetup.Orientation = PageOrientation.Landscape

# Word表を作成する
table = section.AddTable(True)
table.ResetCells(sheet.LastRow, sheet.LastColumn)

# セルの結合を実行する
merge_cells(sheet, table)

# ExcelのデータとスタイルをWord表にコピーする
for r in range(1, sheet.LastRow + 1):
    table.Rows[r - 1].Height = float(sheet.Rows[r - 1].RowHeight)

    for c in range(1, sheet.LastColumn + 1):
        x_cell = sheet.Range[r, c]
        w_cell = table.Rows[r - 1].Cells[c - 1]

        # テキストを追加し、スタイルをコピーする
        text_range = w_cell.AddParagraph().AppendText(x_cell.NumberText)
        copy_style(text_range, x_cell, w_cell)

# Word文書を保存する
doc.SaveToFile("output/CopyExcelDataStyleToWord.docx", FileFormat.Docx2019)
doc.Dispose()
workbook.Dispose()

結果
ExcelワークシートのデータとフォーマットをWord文書にコピーする

ExcelワークシートをOLEオブジェクトとしてWord文書に埋め込む

OLEオブジェクトとしてExcelワークシートをWord文書に埋め込むことで、Word文書内で表を表示しながら、Excelの高度な機能も利用できます。以下の手順で操作を行います。

  1. ファイルパスを定義する

    • Excelファイルのパス excel_path と、出力するWordファイルのパス output_doc_path を定義する。
    • 画像の保存パス image_path を定義する。

  2. Word文書を作成し、ページの向きを設定する

    • Document インスタンスを作成し、AddSection() を追加する。
    • section.PageSetup.Orientation = PageOrientation.Landscape を設定する。

  3. Excelファイルを読み込み、ワークシートを取得する

    • Workbook インスタンスを作成し、LoadFromFile() を使用してExcelファイルを読み込む。
    • Worksheets.get_Item(0) を使用して最初のワークシートを取得する。

  4. Excel表を画像に変換し、保存する

    • sheet.ToImage() を使用してワークシートを画像に変換し、image_path に保存する。

  5. ワークシート画像を作成して読み込む

    • DocPicture インスタンスを作成し、LoadImage() を使用して画像を読み込む。

  6. ExcelワークシートをOLEオブジェクトとしてWordに挿入する

    • paragraph.AppendOleObject() を使用してExcelワークシートをOLEオブジェクトとして挿入する。
    • OleObjectType.ExcelWorksheet を設定し、ole.DisplayAsIcon = False にする。

  7. Word文書を保存する

    • SaveToFile(output_doc_path, FileFormat.Docx2019) で保存する。

コード例

import os
from spire.doc import Document, DocPicture, FileFormat, OleObjectType, PageOrientation
from spire.xls import Workbook

# ファイルパスの定義
excel_path = "Sample.xlsx"
output_doc_path = os.path.join("output", "InsertExcelOleToWord.docx")
image_path = "SheetImage.png"

# Word文書を作成し、ページ方向を設定
with Document() as doc:
    section = doc.AddSection()
    section.PageSetup.Orientation = PageOrientation.Landscape
    paragraph = section.AddParagraph()

    # Excelファイルを読み込み、最初のシートを取得
    with Workbook() as workbook:
        workbook.LoadFromFile(excel_path)
        sheet = workbook.Worksheets.get_Item(0)

        # Excelシートを画像に変換して保存
        image_stream = sheet.ToImage(0, 0, sheet.AllocatedRange.RowCount, sheet.AllocatedRange.ColumnCount)
        image_stream.Save(image_path)

        # DocPictureオブジェクトを作成し、シート画像をロード
        pic = DocPicture(doc)
        pic.LoadImage(image_path)

        # OLEオブジェクト（Excelシート）をWord文書に挿入
        ole = paragraph.AppendOleObject(excel_path, pic, OleObjectType.ExcelWorksheet)
        # OLEオブジェクトをアイコンとして表示しない設定
        ole.DisplayAsIcon = False

    # Word文書を保存
    doc.SaveToFile(output_doc_path, FileFormat.Docx2019)

結果
ExcelワークシートをOLEオブジェクトとしてWord文書に埋め込む

本記事では、Pythonを使用してExcel表をWord文書に挿入する3つの方法（データの挿入、データとフォーマットのコピー、OLEオブジェクトの埋め込み）について解説しました。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?