IronXLとは？

IronXL for Python は、Iron Software によって開発された強力なライブラリであり、開発者が Python プロジェクトで Excel ファイル (XLS、XLSX、CSV) を作成、読み取り、編集できるようにします。 IronXL を使用する主な機能と利点は次のとおりです。

Python-docxとは何か

python-docxは、 .docxファイルなどの Microsoft Word ドキュメントを作成、変更、操作するための Python ライブラリです。 Word 文書を操作するためのシンプルな API を提供し、テキストの追加、書式設定、表や画像の挿入などのタスクを実行できます。

主要な特徴

前提条件

コードに進む前に、次の前提条件が満たされていることを確認してください。

1. Pythonのインストール：お使いのマシンにPythonがインストールされていることを確認してください。Pythonの公式サイトからダウンロードできます。
2. IronXL のインストール: IronXL パッケージをインストールする必要があります。 これは pip を使って実行できます。
3. python-docx のインストール: python-docx パッケージをインストールする必要があります。 これは pip を使って実行できます。
4. Excel ファイル: データを含むサンプル Excel ファイルを作成します。

ステップ1: excelToWord.pyという名前のPythonファイルを作成する

Visual Studio Code などのお気に入りの IDE を開き、 excelToWord.pyというファイルを作成します。

PythonでExcelデータからWord文書を生成する方法：図1 - Excel文書生成

ステップ2: IronXLとpython-docxパッケージを追加する

Pip を使用して IronXL および python-docx パッケージをインストールします。

pip install IronXL python-docx

pip install IronXL python-docx

ステップ3: Excelファイルを作成またはプロジェクトフォルダに追加する

サンプル Excel ファイルをコード フォルダーにコピーします。 ファイルには以下のデータが含まれています。

! PythonでExcelデータからWord文書を生成する方法: 図2 - サンプルExcel

ステップ4: IronXLを使用してExcelドキュメントを読み取る

IronXL を使用して Excel ドキュメントを読み込み、以下のコードを使用してすべてのセルを読み取ります。

import ironxl
# Import Document class from python-docx to work with Word documents
from docx import Document

# Set the License Key for IronXL (replace 'your license' with your actual license key)
ironxl.License.LicenseKey = "your license"

# Load the Excel workbook and select the first worksheet
workbook = ironxl.WorkBook.Load("sample.xlsx")
sheet = workbook.WorkSheets[0]

# Read data from the Excel sheet
data = []

# Iterate through rows and columns in the Excel sheet
for row in range(0, len(sheet.Rows)):
    row_data = []
    for col in range(0, len(sheet.Columns)):
        cell_value = sheet.GetCellAt(row, col)
        print(cell_value)  # Print each cell value
        row_data.append(cell_value)
    data.append(row_data)

import ironxl
# Import Document class from python-docx to work with Word documents
from docx import Document

# Set the License Key for IronXL (replace 'your license' with your actual license key)
ironxl.License.LicenseKey = "your license"

# Load the Excel workbook and select the first worksheet
workbook = ironxl.WorkBook.Load("sample.xlsx")
sheet = workbook.WorkSheets[0]

# Read data from the Excel sheet
data = []

# Iterate through rows and columns in the Excel sheet
for row in range(0, len(sheet.Rows)):
    row_data = []
    for col in range(0, len(sheet.Columns)):
        cell_value = sheet.GetCellAt(row, col)
        print(cell_value)  # Print each cell value
        row_data.append(cell_value)
    data.append(row_data)

ステップ5: Python-docxを使用してWord文書を作成し、Excelデータを挿入する

Word 文書生成プロセスには、Word 文書の作成と、Excel ファイルから読み取ったデータの挿入が含まれます。

# Create a new Word document
doc = Document()

# Add a title to the Word document
doc.add_heading('Excel Data Export Using Python Docx', 0)

# Create a table with headers (first row of Excel data)
table = doc.add_table(rows=1, cols=len(data[0]))
hdr_cells = table.rows[0].cells
# Populate header cells with data
for i, header in enumerate(data[0]):
    hdr_cells[i].text = str(header)

# Populate table with data from Excel
for row in data[1:]:
    row_cells = table.add_row().cells
    for i, cell in enumerate(row):
        row_cells[i].text = str(cell)

# Save the generated Word document
doc.save("sample.docx")

# Create a new Word document
doc = Document()

# Add a title to the Word document
doc.add_heading('Excel Data Export Using Python Docx', 0)

# Create a table with headers (first row of Excel data)
table = doc.add_table(rows=1, cols=len(data[0]))
hdr_cells = table.rows[0].cells
# Populate header cells with data
for i, header in enumerate(data[0]):
    hdr_cells[i].text = str(header)

# Populate table with data from Excel
for row in data[1:]:
    row_cells = table.add_row().cells
    for i, cell in enumerate(row):
        row_cells[i].text = str(cell)

# Save the generated Word document
doc.save("sample.docx")

Word文書を生成するための完全なコード

# Import required libraries
import ironxl
from docx import Document

# Set the License Key for IronXL
ironxl.License.LicenseKey = "your license"

# Load the Excel workbook
workbook = ironxl.WorkBook.Load("sample.xlsx")
sheet = workbook.WorkSheets[0]

# Read data from the Excel sheet
data = []
# Iterate through rows and columns in the Excel sheet
for row in range(0, len(sheet.Rows)):
    row_data = []
    for col in range(0, len(sheet.Columns)):
        cell_value = sheet.GetCellAt(row, col)
        print(cell_value)  # Print each cell value
        row_data.append(cell_value)
    data.append(row_data)

# Document generation process
# Create a new Word document
doc = Document()
# Add a title to the Word document
doc.add_heading('Excel Data Export Using Python Docx', 0)

# Create a table in the Word document
table = doc.add_table(rows=1, cols=len(data[0]))
hdr_cells = table.rows[0].cells
for i, header in enumerate(data[0]):
    hdr_cells[i].text = str(header)  # Add header cells

for row in data[1:]:
    row_cells = table.add_row().cells
    for i, cell in enumerate(row):
        row_cells[i].text = str(cell)

# Save the Word document
doc.save("sample.docx")

# Import required libraries
import ironxl
from docx import Document

# Set the License Key for IronXL
ironxl.License.LicenseKey = "your license"

# Load the Excel workbook
workbook = ironxl.WorkBook.Load("sample.xlsx")
sheet = workbook.WorkSheets[0]

# Read data from the Excel sheet
data = []
# Iterate through rows and columns in the Excel sheet
for row in range(0, len(sheet.Rows)):
    row_data = []
    for col in range(0, len(sheet.Columns)):
        cell_value = sheet.GetCellAt(row, col)
        print(cell_value)  # Print each cell value
        row_data.append(cell_value)
    data.append(row_data)

# Document generation process
# Create a new Word document
doc = Document()
# Add a title to the Word document
doc.add_heading('Excel Data Export Using Python Docx', 0)

# Create a table in the Word document
table = doc.add_table(rows=1, cols=len(data[0]))
hdr_cells = table.rows[0].cells
for i, header in enumerate(data[0]):
    hdr_cells[i].text = str(header)  # Add header cells

for row in data[1:]:
    row_cells = table.add_row().cells
    for i, cell in enumerate(row):
        row_cells[i].text = str(cell)

# Save the Word document
doc.save("sample.docx")

IronXL ライセンス（試用版あり）

IronXL は、コードに添付された有効なライセンス ファイルで動作します。 ユーザーはライセンス ページから簡単に試用ライセンスを取得できます。

ライセンスを使用するには、IronXL ライブラリを使用する前に、以下のようにコードのどこかにライセンス キーを配置します。

ironxl.License.LicenseKey = "Your License Key"

ironxl.License.LicenseKey = "Your License Key"

結論

サンプル コードは、 IronXLを使用してExcel ファイルからデータを読み取り、 python-docxを使用してそのデータをWord 文書にエクスポートする効果的な方法を示しています。 プロセスには主に2つのステップがあります：

1. Excel からのデータの抽出: スクリプトは Excel ファイルを読み込み、最初のワークシートからデータを抽出します。 行と列を反復処理してセルの値をリストに収集し、簡単に操作したり保存したりできるようになります。
2. Word 文書の作成と入力: python-docx ライブラリを使用して、スクリプトは新しい Word 文書を作成し、タイトルを追加し、抽出された Excel データを Word 文書内の表にフォーマットします。 Excel データの最初の行をヘッダーとして、残りの行をテーブル データとして自動的に配置します。

このアプローチにより、Excel から Word へのシームレスなデータ転送が可能になり、レポートの生成、データのエクスポート、ドキュメントの自動化などのタスクに役立ちます。 Excel 処理用のIronXLと Word 文書作成用のpython-docxを組み合わせることで、Python でこれらのファイル形式を操作するための強力なソリューションが提供されます。