PythonでWord文書を処理する際、ドキュメントプロパティの操作は重要な作業です。ドキュメントプロパティには、タイトルや作成者などの組み込みプロパティと、ユーザーが独自に定義できるユーザー設定プロパティの2種類があります。これらを適切に管理することで、文書管理の効率を向上させ、情報検索を最適化し、文書データの正確性と安全性を確保できます。本記事では、Pythonを使用してWord文書のドキュメントプロパティを追加、読み取り、削除する方法について解説します。
本記事で紹介する方法は、無料のFree Spire.Doc for Pythonライブラリを使用します。PyPIからインストールするには、次のコマンドを実行してください：pip install spire.doc.free。
PythonでWord文書にドキュメントプロパティを追加する
ライブラリのクラスとメソッドを使用すると、ファイルやストリームからWord文書を直接読み込んで処理できます。組み込みプロパティを追加するには、Document.BuiltinDocumentPropertiesを使用して該当プロパティにアクセスし、値を設定します。ユーザー設定プロパティを追加するには、CustomDocumentProperties.Add()メソッドを使用します。具体的な手順は以下のとおりです：
- 必要なモジュール（
Document、String、Int32、DateTime、Boolean）をインポートします。 -
Documentクラスのインスタンスを作成します。 -
Document.LoadFromFile()メソッドでWord文書を読み込みます。 -
組み込みプロパティを設定する場合は、
Document.BuiltinDocumentPropertiesを使用して該当プロパティの値を変更します。 -
ユーザー設定プロパティを追加する場合は、
Document.CustomDocumentPropertiesを使用し、Add()メソッドで異なるデータ型のプロパティを追加します。 -
Document.SaveToFile()メソッドを使用して変更を保存します。
コード例
from spire.doc import Document, String, Int32, DateTime, Boolean
# Documentオブジェクトの作成
doc = Document()
# Word文書をロード
doc.LoadFromFile("Sample.docx")
# 組み込みプロパティの追加
builtin_prop = doc.BuiltinDocumentProperties
builtin_prop.Title = "Pythonによる文書プロパティ操作"
builtin_prop.Author = "コード開発者"
builtin_prop.Category = "技術チュートリアル"
builtin_prop.Keywords = "Python,Word,プロパティ操作"
# カスタムプロパティの追加
custom_prop = doc.CustomDocumentProperties
custom_prop.Add("プロジェクトID", String("PRJ001"))
custom_prop.Add("進捗", Int32(80))
custom_prop.Add("締切日", DateTime(2024, 12, 31, 0, 0, 0, 0))
custom_prop.Add("重要かどうか", Boolean(True))
# 文書の保存
doc.SaveToFile("output/プロパティ追加後の文書.docx")
doc.Close()
結果
PythonでWord文書のドキュメントプロパティを読み取る
BuiltinDocumentPropertiesクラスのプロパティを使用すると、組み込みプロパティを取得できます。また、ユーザー設定プロパティを読み取るには、CustomDocumentProperty.NameおよびCustomDocumentProperty.Value（またはCustomDocumentProperty.ToString()で文字列として取得）を使用します。具体的な手順は以下のとおりです：
- 必要なモジュール（
Document）をインポートします。 -
Documentクラスのインスタンスを作成します。 -
Document.LoadFromFile()メソッドで、プロパティが設定されたWord文書を読み込みます。 -
組み込みプロパティを取得する場合は、
Document.BuiltinDocumentPropertiesを使用します。 -
ユーザー設定プロパティを取得する場合は、
Document.CustomDocumentPropertiesを使用し、各プロパティの名前と値を取得します。 - 取得したプロパティ値を出力またはさらに処理します。
コード例
from spire.doc import Document
# Documentオブジェクトの作成
doc = Document()
# Word文書をロード
doc.LoadFromFile("output/プロパティ追加後の文書.docx")
# 組み込みプロパティの読み取り
builtin_prop = doc.BuiltinDocumentProperties
print("組み込みプロパティ:")
print(f"タイトル: {builtin_prop.Title}")
print(f"作者: {builtin_prop.Author}")
print(f"カテゴリ: {builtin_prop.Category}")
print(f"キーワード: {builtin_prop.Keywords}")
# カスタムプロパティの読み取り
custom_prop = doc.CustomDocumentProperties
print("\nカスタムプロパティ:")
for i in range(custom_prop.Count):
prop_name = custom_prop.get_Item(i).Name
prop_value = custom_prop.get_Item(i).ToString()
print(f"{prop_name}: {prop_value}")
doc.Close()
結果
PythonでWord文書のドキュメントプロパティを削除する
組み込みプロパティを削除するには、その値をNoneに設定します。ユーザー設定プロパティを削除するには、DocumentProperties.Remove()メソッドを使用します。具体的な手順は以下のとおりです：
- 必要なモジュール（
Document）をインポートします。 -
Documentクラスのインスタンスを作成します。 -
Document.LoadFromFile()メソッドで、削除対象のプロパティを含むWord文書を読み込みます。 -
組み込みプロパティを削除する場合は、
Document.BuiltinDocumentPropertiesを使用し、削除するプロパティの値をNoneに設定します。 -
ユーザー設定プロパティを削除する場合は、
Document.CustomDocumentPropertiesを使用し、Remove()メソッドで不要なプロパティを削除します。 -
Document.SaveToFile()メソッドを使用して変更を保存します。
コード例
from spire.doc import Document
# Documentオブジェクトの作成
doc = Document()
# Word文書をロード
doc.LoadFromFile("output/プロパティ追加後の文書.docx")
# 組み込みプロパティの削除
builtin_prop = doc.BuiltinDocumentProperties
builtin_prop.Title = None
builtin_prop.Author = None
builtin_prop.Category = None
builtin_prop.Keywords = None
# カスタムプロパティの削除
custom_prop = doc.CustomDocumentProperties
for i in range(custom_prop.Count - 1, -1, -1):
custom_prop.Remove(custom_prop[i].Name)
# 文書の保存
doc.SaveToFile("output/属性削除後の文書.docx")
doc.Close()
本記事では、Pythonを使用してWord文書の組み込みプロパティおよびユーザー設定プロパティを追加、読み取り、削除する方法について解説しました。