PythonでExcelファイルにドキュメント・プロパティを追加する方法

# PythonでExcelファイルにドキュメントプロパティを追加する方法

Excelファイルにドキュメントプロパティを追加することは、スプレッドシートデータを専門的に整理および管理するための重要な手順です。タイトル、作成者、件名、キーワードなどのこれらのプロパティは、ファイルのメタデータを強化し、大規模なデータベースまたはファイルシステムでドキュメントを追跡、ソート、検索しやすくします。この情報を組み込むことで、ファイルの全体的なプロフェッショナリズムを向上させるだけでなく、より良いコラボレーションとアーカイブを促進します。Pythonは、このプロセスの自動化を可能にし、ワークフローを合理化し、複数のファイル間の一貫性を確保できます。この記事では、**Pythonを使用してドキュメントプロパティをExcelファイルに効率的に追加し**、スプレッドシートドキュメントの処理における生産性を向上させる手順について説明します。

- **[Pythonを使用してExcelファイルに組み込みドキュメントプロパティを追加する](#pythonを使用してexcelファイルに組み込みドキュメントプロパティを追加する)**
- **[Pythonを使用してExcelファイルにカスタムドキュメントプロパティを追加する](#pythonを使用してexcelファイルにカスタムドキュメントプロパティを追加する)**

この記事で使用する方法には[Spire.XLS for Python](https://www.e-iceblue.com/Download/Spire-XLS-Python.html)が必要で、これはPyPI経由でインストールできます： pip `isntall Spire.XLS`。

## Pythonを使用してExcelファイルに組み込みドキュメントプロパティを追加する
組み込みドキュメントプロパティは、タイトル、件名、作成者、カテゴリなどのドキュメントに関する基本情報です。これらのプロパティの名前は編集できない事前定義されていますが、これらのプロパティに特定の値を設定できます。手順は以下のとおりです。

1. 必要なモジュールをインポートします。
2. **Workbook**のオブジェクトを作成します。
3. **Workbook.LoadFromFile()** メソッドを使用してExcelドキュメントをロードします。
4. **Workbook.DocumentProperties**プロパティを使用してドキュメントの組み込みドキュメントプロパティを取得します。
5. **BuiltInDocumentProperties**クラスのプロパティを使用して、タイトル、作成者、キーワード、コメントなどの特定のドキュメントプロパティを設定します。
6. **Workbook.SaveToFile()** メソッドを使用して結果のドキュメントを保存します。
7. リソースを解放します。

**コードの例**
```python
from spire.xls import *
from spire.xls.common import *

# Workbookオブジェクトを作成します
workbook = Workbook()

# サンプルのExcelドキュメントを読み込みます
workbook.LoadFromFile("サンプル.xlsx")

# Excelワークブックの組み込みドキュメントプロパティを設定します
workbook.DocumentProperties.Author = "Jamie"
workbook.DocumentProperties.Title = "Excelに組み込みドキュメントプロパティを追加する"
workbook.DocumentProperties.Subject = "PythonでExcelを処理する"
workbook.DocumentProperties.Keywords = "Python, Excel, ドキュメントプロパティ, デモ"
workbook.DocumentProperties.Category = "Excelデモ"
workbook.DocumentProperties.Company = "Eea"
workbook.DocumentProperties.Comments = "ドキュメントプロパティは、ファイルに関する詳細情報や識別情報です。"

# 結果のドキュメントを保存します
workbook.SaveToFile("output/組み込みドキュメントプロパティ.xlsx", FileFormat.Version2016)
workbook.Dispose()
```

**結果ファイル**
![Excelファイルにドキュメントプロパティを追加](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/278784/168a6957-6a4d-5a09-2595-4cd62c5af9c6.png)

## Pythonを使用してExcelファイルにカスタムドキュメントプロパティを追加する
カスタムドキュメントプロパティは、Excelドキュメントに定義できる追加のプロパティです。**ICustomDocumentProperties.Add()** メソッドを使用して、指定された名前と値を持つカスタムプロパティを追加できます。手順は以下のとおりです。
1. 必要なモジュールをインポートします。
2. **Workbook**のオブジェクトを作成します。
3. **Workbook.LoadFromFile()** メソッドを使用してExcelドキュメントをロードします。
4. **Workbook.CustomDocumentProperties**プロパティを使用してドキュメントのカスタムドキュメントプロパティを取得します。
5. **ICustomDocumentProperties.Add()** メソッドを使用して、さまざまなデータタイプのカスタムドキュメントプロパティをドキュメントに追加します。
6. **Workbook.SaveToFile()** メソッドを使用して結果のドキュメントを保存します。
7. リソースを解放します。

**コードの例**
```python
from spire.xls import *
from spire.xls.common import *

# Workbookオブジェクトを作成します
workbook = Workbook()

# サンプルのExcelドキュメントを読み込みます
workbook.LoadFromFile("サンプル.xlsx")

# ドキュメントを「最終版」としてマークするためのカスタムプロパティを追加します
workbook.CustomDocumentProperties.Add("最終版にする", True)

# 他のカスタムプロパティをドキュメントに追加します
workbook.CustomDocumentProperties.Add("編集者", "シリオン")
workbook.CustomDocumentProperties.Add("電話番号", 81705109)
workbook.CustomDocumentProperties.Add("バージョン", 7.12)
workbook.CustomDocumentProperties.Add("改訂日", DateTime.get_Now())

# 結果のドキュメントを保存します
workbook.SaveToFile("output/カスタム ドキュメント プロパティ.xlsx", FileFormat.Version2016)
workbook.Dispose()
```

**結果ファイル**
![Excelファイルにカスタムドキュメントプロパティを追加](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/278784/8a5f4fe5-455d-ce6a-a308-e560f4fc4bde.png)

この記事では、Pythonを使用して組み込みおよびカスタムのドキュメントプロパティをExcelファイルに挿入する方法を示しました。

Excelファイル処理のスキルについては、[Spire.XLS for Pythonチュートリアル](https://www.e-iceblue.com/Tutorials/Python/Spire.XLS-for-Python/Program-Guide/Spire.XLS-for-Python-Program-Guide-Content.html)をご覧ください。