
Pythonの win32com について
序章: COMとPythonの基礎
はじめに
Windows環境では、ExcelやWord、Outlookなどのアプリケーションを自動化して、定型作業の効率化を図ることができます。その技術基盤となるのがCOM (Component Object Model, コンポーネントオブジェクトモデル)です。COMは、Windows上でソフトウェアの機能を部品(コンポーネント)として提供し、プログラムからそれらを呼び出して利用するための仕組みです。たとえばExcelやWordといったOfficeアプリケーションをプログラム経由で操作し、GUIでは難しい一括処理やデータ連携を実現できます。
この書籍では、Pythonを使ってCOM技術を活用する方法を解説します。Pythonにはpywin32と呼ばれるライブラリがあり、その中のwin32comモジュールを利用することで、WindowsアプリケーションをPythonから操作できます。Excelのセル編集、Word文書の生成、Outlookメールの送受信など、これまで手動で行っていたWindows上の作業を自動化することが可能になります。
COMとは何か
COM (Component Object Model)は、Microsoftが策定したソフトウェアコンポーネント技術です。COMでは、各アプリケーションの機能がオブジェクトとして提供されます。このオブジェクトは、アプリケーション固有のクラスID (CLSID)やプログラムID (ProgID)によって識別されます。たとえばExcelアプリケーションはExcel.ApplicationというProgIDを持っており、この名前を指定して起動することでExcelのオブジェクトを取得できます。COMオブジェクトにはインターフェースと呼ばれる機能の窓口があり、プログラムはこのインターフェースを通じて操作を行います。
COMの特徴として、言語に依存しない(Language-Independent)点と、プロセス間通信(Inter-Process Communication, IPC)をサポートする点が挙げられます。たとえば、Pythonだけでなく、PowerShellやVBScript、C++など様々な言語からCOMオブジェクトを利用できます。また、Excelを背後で動かして計算させたり、Outlookを通じて別プロセスでメールを送ったりすることも容易です。
PythonでCOMを扱う方法
PythonでCOMオブジェクトを操作するには、pywin32というライブラリを利用します。PyWin32はWindowsに特化したPython拡張であり、その中でwin32com.clientを用いることで、COMオブジェクトを生成し操作できます。まずはこのライブラリをインストールしましょう。pipを使って簡単にインストールできます。
pip install pywin32
※PyWin32はPython環境にインストール後、内部で必要な登録作業を自動的に行います。最新版ではpip installするだけでほとんどのケースで利用可能です。
インストールが完了したら、PythonからCOMオブジェクトを呼び出せるようになります。最も基本となるのがwin32com.client.Dispatch関数です。この関数に先述のProgIDを渡すことで、該当するCOMオブジェクトを生成(インスタンス化)できます。たとえばExcelアプリケーションを起動するには以下のようにします。
import win32com.client
# Excelアプリケーションを起動
excel = win32com.client.Dispatch("Excel.Application")
# 画面に表示(Visible)するか設定
excel.Visible = True
ここで、Excel.ApplicationがExcelのCOMオブジェクトのProgIDです。Dispatchを呼ぶことでExcelがバックグラウンドで起動し、変数excelにその操作ハンドルが格納されます。excel.Visible = Trueとすることで、Excelの画面をユーザーに見えるようにします(Falseにするとバックグラウンドで非表示実行されます)。
同様に、WordやOutlookのアプリケーションオブジェクトも生成できます。
Wordアプリケーション: win32com.client.Dispatch("Word.Application")
Outlookアプリケーション: win32com.client.Dispatch("Outlook.Application")
このようにPythonとCOMを組み合わせることで、Officeアプリケーションの自動化が可能になります。本書では、これから具体的な例を交え、Excel、Word、Outlookといったアプリケーションの操作方法について、基礎から応用まで順を追って解説していきます。
本書の構成
この書籍は、入門 → 実践 → 応用という三段構成で、ステップバイステップで技術を習得できるようになっています。まず序章でCOMとPythonの基本を押さえました。続く第1章ではExcelの操作方法を学びます。Excelは表計算ソフトとしてデータ処理やレポート生成によく使われており、COMを用いた自動化のニーズが非常に高い分野です。
第2章ではWordの操作に焦点を当てます。文書生成や差し込み印刷的な処理など、Excelとは異なる自動化のポイントを学びます。第3章はOutlookの自動化です。メールの自動送受信や予定表操作など、日々のコミュニケーション業務を効率化する方法を紹介します。
第4章では、ActiveXや汎用的なCOMオブジェクトの操作について触れ、Office以外のCOM活用例や内部動作の理解を深めます。第5章の応用編では、複数のアプリケーションを組み合わせたワークフロー自動化や、実務で役立つスクリプト例をいくつか紹介します。最後に付録として、トラブルシューティングと参考情報をまとめています。エラーに遭遇した場合の対処法や、さらなる学習のためのリソースも参照できます。
それでは、具体的なCOMプログラミングの世界へ進んでいきましょう。次章から実際のコードを交えつつ、Excelの自動化について学んでいきます。
第1章: Excelの操作
1-1. Excelアプリケーションの起動と制御
まずはExcelをPythonから操作する基本を学びましょう。ExcelのCOMオブジェクトを取得し、ワークブックやワークシートの操作を行う流れを理解します。
Excelアプリケーションのインスタンス化
Excelを操作するためには、まずExcelアプリケーションのCOMオブジェクトを取得します。前章でも触れましたが、win32com.client.Dispatch("Excel.Application")を使います。試しにExcelを起動して終了するだけのコードを書いてみましょう。
import win32com.client
# Excelアプリケーションのインスタンスを生成
excel = win32com.client.Dispatch("Excel.Application")
excel.Visible = True # Excelを目に見える形で起動
# Excelのバージョンを取得して表示(動作確認を兼ねて)
print("Excel Version:", excel.Version)
# Excelを終了
excel.Quit()
上記のコードを実行すると、Excelが起動し、バージョン番号がコンソールに表示された後、自動的にExcelが終了します。Dispatchを呼び出した段階ではExcelはバックグラウンドで起動していますが、Visible属性をTrueに設定することで画面に表示されます。Excelのバージョン取得はexcel.Versionプロパティから行っています。これはExcelオブジェクトの属性として提供されており、簡単に情報を取得できます。
ワークブックとワークシートの基本
Excelを起動できたら、次はワークブック (Workbook)とワークシート (Worksheet)の操作です。ワークブックとはExcelファイルそのものであり、Excelアプリケーションオブジェクト (excel など) のWorkbooksコレクションを通じてアクセスします。一方、ワークシートは各ワークブックの中のシートで、ワークブックオブジェクト (workbook など) のWorksheetsコレクションとして扱われます。
Excelのワークブックを新規に作成するにはexcel.Workbooks.Add()を使います。また、既存のExcelファイルを開くにはexcel.Workbooks.Open(ファイルパス)を利用します。例を示します。
# 新規ワークブックを作成
workbook = excel.Workbooks.Add()
print("新規ワークブックを作成しました:", workbook.Name)
# 既存のExcelファイルを開く(読み取り専用)
file_path = r"C:\path\to\existing.xlsx"
workbook_existing = excel.Workbooks.Open(file_path, ReadOnly=True)
print("既存ワークブックを開きました:", workbook_existing.Name)
ここでは、新規にワークブックを1つ作成し、既存ファイルも開いてみせています。Workbooks.Add()は空のワークブックを返し、それをworkbook変数に格納しています。一方でWorkbooks.Openにはファイルパスを渡しますが、2番目の引数にReadOnly=Trueを指定することで読み取り専用で開いています。必要に応じてReadOnlyをFalseにすれば編集モードで開けます。
開いたワークブックに含まれるワークシートへは、workbook.Worksheetsコレクションを通じてアクセスできます。例えば最初のシートを取得するにはsheet1 = workbook.Worksheets(1)とします(1始まりでインデックス指定)。またはシート名で指定することも可能で、その場合はworkbook.Worksheets("Sheet1")のように名前を渡します。
# 新規ワークブックの先頭のシートを取得
sheet1 = workbook.Worksheets(1)
print("先頭のシート名:", sheet1.Name)
# シート名でシートを取得(既存ワークブックから)
sheet_named = workbook_existing.Worksheets("データ")
print("指定した名前のシート名:", sheet_named.Name)
セルへのアクセスとデータの読み書き
Excel自動化の核心は、セルへのアクセスです。セルには値や数式、書式などが設定できます。Pythonからセルを操作するにはWorksheetオブジェクトのCellsプロパティやRangeメソッドを利用します。
sheet.Cells(row, col): 指定した行(row)と列(col)のセルオブジェクトを取得します。
sheet.Range("A1:B3"): 指定した範囲のセルオブジェクトを取得します。
一つのセルを直接操作する場合はCellsを使うと簡単です。複数のセル範囲を一度に扱いたい場合はRangeを使います。例を通じて見てみましょう。
# セルへのアクセス例
sheet = sheet1 # 新規ワークブックのシート1を利用
cell_A1 = sheet.Cells(1, 1) # A1セル
cell_B1 = sheet.Cells(1, 2) # B1セル
# 値を書き込む
cell_A1.Value = "商品名"
cell_B1.Value = "価格"
# 複数セルにまたがる範囲にアクセスして値を書き込む
range_C1_D1 = sheet.Range("C1:D1")
range_C1_D1.Value = ["数量", "合計"] # 1行2列の範囲にリストで値を一括設定
# 値を読み取って表示
print("A1の値:", cell_A1.Value)
print("B1の値:", cell_B1.Value)
print("C1:D1の値:", range_C1_D1.Value)
上記コードでは、A1とB1セルにそれぞれ文字列を書き込み、その後C1:D1の範囲に対してリストを与えて値をまとめて設定しています。Rangeに対してリストやタプルを渡すと、それがセル範囲に展開されます。range_C1_D1.Valueを読み取ると、セル範囲の値がネストしたタプルで返ってきます。例えば、2列×1行の範囲であれば(('数量', '合計'), )のような形で取得できます(行列の二重タプル)。
セルの書式設定
値だけでなく、セルの書式(フォーマット)を制御することもできます。たとえば文字の太字、フォントサイズ、背景色、数値の表示形式などです。COMオブジェクトを通じて、Excel上で可能なフォーマット設定のほとんどを操作可能です。
簡単な例として、ヘッダー行を太字にして背景色を灰色にするコードを書いてみましょう。
# A1からD1をヘッダー行とみなして書式を設定
header_range = sheet.Range("A1:D1")
header_range.Font.Bold = True # 太字
header_range.Interior.ColorIndex = 15 # グレー (ColorIndex 15は灰色)
header_range.Font.Size = 12 # フォントサイズを12ptに変更
header_range.HorizontalAlignment = -4108 # 中央寄せ (xlCenterは-4108)
ここでInterior.ColorIndexを15に設定しています。ExcelのColorIndex 15番は灰色を指します。また、HorizontalAlignmentに-4108というマジックナンバーを入れていますが、これはExcel定数xlCenterに対応します。PyWin32ではExcel定数をwin32com.client.constantsから参照することもできますが、上記のように直接数値を使うこともできます。Pythonスクリプト中でExcelのVBA定数を使うには、以下のようにconstantsをインポートし、constants.xlCenterとするのが一般的です。
from win32com.client import constants
header_range.HorizontalAlignment = constants.xlCenter
このようにすると定数名で設定できるので可読性が上がります。なお、constantsにはExcelだけでなくWordやOutlookなど、様々なCOM定数が含まれている点に注意してください(オブジェクトによっては同名定数の値が違う場合もあるので、必要に応じて区別が必要です)。
ワークブックやシートの操作まとめ
以上、Excelの起動からワークブック・ワークシート・セルの基本操作を見てきました。ここまでのポイントをまとめます。
Excelアプリケーションの起動: excel = win32com.client.Dispatch("Excel.Application")でExcel COMオブジェクト取得。Visible属性で表示/非表示を切り替え。
ワークブックの操作: excel.Workbooks.Add()で新規作成、excel.Workbooks.Open(path)で既存ファイルを開く。workbook.Close()で閉じることも忘れずに。
ワークシートの操作: workbook.Worksheets(index or name)で取得。Addメソッドで新しいシートを追加することも可能。
セル/範囲の操作: sheet.Cells(row,col)またはsheet.Range("A1:B2")でセル取得。Valueプロパティで値の読み書き。FontやInteriorプロパティで書式設定。
Excel定数の利用: win32com.client.constantsをインポートすると、ExcelやOfficeの定数を名前で使える。
次のセクションでは、Excelのもう少し実践的な操作として、グラフやピボットテーブルの自動作成、さらにはマクロ (VBA) との連携についても触れてみましょう。
1-2. Excelでのグラフ作成とデータ分析の自動化
Excelといえば、データを集計・分析し、グラフにまとめて可視化する、といった用途でも頻繁に使われます。この節ではPythonからExcelのグラフを作成する方法や、ピボットテーブルを自動生成する方法について解説します。また、一部ではExcelマクロ(VBA)との連携にも触れ、Pythonでは難しい部分をExcel側に任せるテクニックも紹介します。
グラフの自動作成
ExcelのCOMを通じてグラフを作成するには、いくつかのステップを踏みます。大まかな手順は次のとおりです。
グラフにしたいデータをExcelのシート上に用意する。
ChartObjects.AddまたはShapes.AddChartメソッドでグラフオブジェクトをシート上に作成する。
グラフオブジェクトにデータ範囲を指定し、グラフの種類(タイプ)を設定する。
タイトルや軸ラベルなど、必要に応じて装飾を設定する。
具体的なコード例を示します。ここでは簡単な売上データを作って、その推移を棒グラフ(Clustered Column Chart)で描いてみます。
from win32com.client import Dispatch, constants
# Excel起動とデータの準備
excel = Dispatch("Excel.Application")
excel.Visible = True
wb = excel.Workbooks.Add()
ws = wb.Worksheets(1)
# データの入力(1月~6月の売上)
data = [("月", "売上"),
("1月", 50),
("2月", 40),
("3月", 60),
("4月", 80),
("5月", 70),
("6月", 90)]
for i, (month, sales) in enumerate(data, start=1):
ws.Cells(i, 1).Value = month
ws.Cells(i, 2).Value = sales
# データ範囲(A1:B7)を選択
data_range = ws.Range("A1:B7")
# グラフオブジェクトの追加(左100, 上50の位置に幅300,高さ200のサイズで配置)
chart_obj = ws.ChartObjects().Add(Left=100, Top=50, Width=300, Height=200)
chart = chart_obj.Chart
# グラフにデータソースを設定
chart.SetSourceData(Source=data_range)
# グラフの種類をクラスター縦棒 (Clustered Column) に設定
chart.ChartType = constants.xlColumnClustered
# グラフタイトルと軸ラベルの設定
chart.HasTitle = True
chart.ChartTitle.Text = "月別売上推移"
chart.Axes(constants.xlCategory).HasTitle = True
chart.Axes(constants.xlCategory).AxisTitle.Text = "月"
chart.Axes(constants.xlValue).HasTitle = True
chart.Axes(constants.xlValue).AxisTitle.Text = "売上 (万円)"
上記コードでは、まずA1セルからB7セルにかけてデータを入力しています。ChartObjects().Addを呼び出すことで、新しいグラフ領域をシート上に作成し、それをchart_objとして受け取っています。さらにchart_obj.Chartでグラフ本体のオブジェクトを取得します。
chart.SetSourceData(Source=data_range)によってグラフが参照するデータ範囲を設定しています。次にchart.ChartTypeでグラフの種類を指定します。ここではconstants.xlColumnClusteredを指定しましたが、これはExcelの定数で値は51に対応します。PyWin32では内部的にExcel定数をconstants経由で利用できるので、わかりやすく名前で指定できるようになっています。
最後に、グラフタイトルや軸タイトルなどを設定しました。chart.HasTitle = Trueでタイトル表示を有効にし、chart.ChartTitle.Textでタイトル文字列を設定します。同様に軸についてもAxesコレクションを通じてタイトルを操作できます。xlCategoryはカテゴリ軸(通常X軸)、xlValueは値軸(通常Y軸)を示すExcel定数です。
このコードを実行すると、Excel上に売上データの棒グラフが作成され、「月別売上推移」というタイトルがついたグラフが表示されます。Pythonスクリプト内でここまで操作できれば、グラフ作成を自動化してレポートを作成するのも難しくありません。
ピボットテーブルの自動作成
ピボットテーブルはExcelの強力な集計機能です。大量のデータから特定の軸で集計を行い、要約された表を生成できます。Pythonからピボットテーブルを作成することも可能ですが、VBAでも複雑なコードになるように、その操作には多くの手順があります。ここでは簡単な例として、小さなデータからピボットテーブルを作る流れを示します。
次のデータを例にします。
年 商品カテゴリー 売上 2021 書籍 120 2021 食品 200 2022 書籍 150 2022 食品 220
このデータから、年(行)×商品カテゴリー(列)で売上を集計したピボットテーブルを作ります(つまり行方向に年、列方向にカテゴリー、値は売上の合計)。
# サンプルデータの入力
ws.Cells(1,1).Value = "年"
ws.Cells(1,2).Value = "カテゴリー"
ws.Cells(1,3).Value = "売上"
data = [
(2021, "書籍", 120),
(2021, "食品", 200),
(2022, "書籍", 150),
(2022, "食品", 220),
]
for i, (year, category, sales) in enumerate(data, start=2):
ws.Cells(i, 1).Value = year
ws.Cells(i, 2).Value = category
ws.Cells(i, 3).Value = sales
# PivotCacheの作成
pivot_cache = wb.PivotCaches().Create(SourceType=constants.xlDatabase,
SourceData=ws.Range("A1:C5"))
# ピボットテーブル用の新しいシートを追加
pivot_sheet = wb.Worksheets.Add()
pivot_sheet.Name = "ピボット集計"
# ピボットテーブルの作成
pivot_table = pivot_cache.CreatePivotTable(TableDestination=pivot_sheet.Range("A1"),
TableName="SalesPivotTable")
# ピボットフィールドの配置
pivot_table.PivotFields("年").Orientation = constants.xlRowField # 行フィールドに設定
pivot_table.PivotFields("カテゴリー").Orientation = constants.xlColumnField # 列フィールドに設定
pivot_table.PivotFields("売上").Orientation = constants.xlDataField # データフィールドに設定
pivot_table.PivotFields("売上").Function = constants.xlSum # 集計関数を合計に
pivot_table.PivotFields("売上").NumberFormat = "#,##0" # 数値書式
このコードの解説をします。まずA1:C5にデータを入力しています。次にwb.PivotCaches().Createを使ってピボットキャッシュを作成します。PivotCacheとはピボットテーブルの元データを指すオブジェクトで、SourceType=xlDatabase(範囲指定)とし、SourceDataにデータ範囲(A1:C5)を渡しています。
PivotTableを作成する場所として、新しいシートを追加し、それをpivot_sheetとしています。Worksheets.Add()により新しいシートが現在のワークブックの先頭に追加されますので(Excelの仕様)、Nameプロパティで名前をわかりやすく変更しておきます。
続いてCreatePivotTableメソッドでピボットテーブルを作成します。引数TableDestinationにはピボットテーブルを配置するシートとセル位置を指定します(ここではピボット集計シートのA1)。TableNameはピボットテーブル自体の名前で、コード内から参照する際やExcelのリボンUIで名前が付けられるのに使われます。
ピボットテーブルが作成されたら、最後にフィールドの配置を行います。ピボットテーブルには複数のフィールド(今回の場合「年」「カテゴリー」「売上」)がありますが、これを行方向・列方向・値フィールドとして設定します。Orientationプロパティに、Excel定数xlRowField(値1)、xlColumnField(値2)、xlDataField(値4)を指定することで役割を設定できます。
さらに売上フィールドについては、デフォルトでは集計関数が「集計なし」か「Count」になることがあるため、FunctionプロパティでxlSumを指定し、数値の合計で集計するようにしています。また、数値の表示形式を#,##0(カンマ区切りの整数表示)に設定して見やすくしています。
このコードを実行すると、「ピボット集計」シートに年×カテゴリーの売上ピボットテーブルが作成されます。結果として次のような表が得られます。
書籍 食品 総計
2021 120 200 320
2022 150 220 370
総計 270 420 690
ピボットテーブル生成のコードは多くのステップがありますが、一度テンプレートを作ってしまえば様々なデータに応用が可能です。また、Excel側で一度マクロを記録してみて、それをPython用に読み替えるという方法も有用です。実際に複雑なピボット操作をPythonでする場合、Excelのマクロ記録機能でVBAコードを取得し、それを参考にPyWin32のコードに直すと良いでしょう。
マクロ(VBA)との連携
PyWin32を使うことで多くのExcel操作はPythonから実現できますが、場合によってはExcelのVBAマクロに任せたほうが簡単な処理もあります。例えば、Excelに埋め込まれた複雑なマクロ関数や、サードパーティーのExcelアドインの機能を呼び出す場合などです。
PythonからExcelマクロを呼び出すことも可能です。ExcelオブジェクトのRunメソッドを使ってマクロ名を指定すれば、そのマクロが実行されます。マクロがSubプロシージャの場合は戻り値はありませんが、Functionプロシージャの場合は戻り値を取得できます。
例えば、ExcelのVBAに以下のようなマクロが定義されているとします(Excelファイル内の標準モジュールなどに記述)。
' Excel内のVBAマクロ例
Sub Greeting(name As String)
MsgBox "Hello, " & name & "!"
End Sub
これをPythonから呼ぶ場合、次のようなコードになります。
# 既にExcelアプリケーション excel と ワークブック wb が開いている前提
excel.Application.Run("Greeting", "Pythonユーザー")
excel.Application.Runにマクロ名と引数(複数ある場合はカンマ区切りで指定)を渡すことで、Excel側でそのマクロが実行されます。この例では引数"Pythonユーザー"がVBAマクロに渡され、Excel上に"Hello, Pythonユーザー!"というメッセージボックスが表示されるでしょう。
マクロの戻り値を受け取りたい場合(Functionプロシージャを呼ぶ場合)は、result = excel.Application.Run("MacroName", arg1, arg2, ...)のようにすれば、result変数に戻り値が格納されます。
マクロとの連携は高度なトピックですが、既存のExcelマクロ資産を活用したり、Pythonから直接操作しにくい部分を補完するために役立ちます。
章末まとめ
第1章では、Excelの基本操作からグラフ作成、ピボットテーブル、そしてマクロ連携までを幅広く扱いました。これでExcel自動化の土台ができたと思います。Excelはビジネスでも科学計算でも使われており、その自動化スクリプトを作れると非常に重宝します。実際の開発では、Excel VBAの知識も参照しつつ、今回学んだPyWin32のコードを組み合わせていくと良いでしょう。
次章ではWordの操作に移ります。Excelとはまた違った自動化の観点がありますので、文書処理の自動化に興味のある方は引き続き読み進めてください。
第2章: Wordの操作
2-1. Wordアプリケーションの起動と制御
Wordは文書作成ソフトとして広く使われており、報告書や請求書の自動生成、テンプレートへの差し込み印刷など、Pythonで自動化すると便利なケースが多くあります。この章では、WordをPythonから操作して文章を作成・編集する方法を学びます。
Wordアプリケーションのインスタンス化
Excelと同様に、まずはWordのCOMオブジェクトを取得してみましょう。ProgIDはWord.Applicationとなります。
import win32com.client
# Wordアプリケーションのインスタンスを生成
word = win32com.client.Dispatch("Word.Application")
word.Visible = True # Wordを画面に表示
print("Word Version:", word.Version)
このコードでWordが起動し、バージョン番号が表示されます。WordもExcel同様、VisibleをTrueにしないとバックグラウンドで開いたままとなるため、開発中はTrueにして様子を見ると良いでしょう。
文書 (Document) の作成と保存
Wordにおけるドキュメント(文書)は、WordアプリケーションオブジェクトのDocumentsコレクションを通じて操作します。新規文書を作るにはword.Documents.Add()、既存文書を開くにはword.Documents.Open(ファイルパス)を使用します。
# 新しい文書を作成
doc = word.Documents.Add()
print("文書を新規作成しました:", doc.Name)
# 既存のWord文書を開く
file_path = r"C:\path\to\document.docx"
doc_existing = word.Documents.Open(file_path)
print("既存文書を開きました:", doc_existing.Name)
Documents.Add()で返ってくるdocが新規文書オブジェクトです。既存文書を開いたdoc_existingも文書オブジェクトとなります。これらの文書オブジェクトを通じてテキストを入力したり書式を変更したりといった操作を行います。
文書を保存する場合は、doc.SaveAs(ファイルパス)あるいはdoc.Save()を使います。SaveAsではファイル名や形式を指定でき、例えばPDFとして保存することも可能です。一方Saveは既存ファイルの場合上書き保存、新規文書の場合は一度ダイアログが開く(対話的に名前を付けて保存を要求する)ことがあります。自動化の文脈ではSaveAsで明示的に保存先を指定する方が確実です。
# 文書の保存(DOCX形式)
save_path = r"C:\path\to\new_document.docx"
doc.SaveAs(save_path)
print("文書を保存しました:", save_path)
# 文書の保存(PDF形式で別名保存)
pdf_path = r"C:\path\to\new_document.pdf"
doc.SaveAs(pdf_path, FileFormat=17) # 17はPDF形式の定数
print("PDFとして文書を保存しました:", pdf_path)
ここでFileFormatに17を渡していますが、これはWordの定数wdFormatPDFに該当します(PyWin32ではconstants.wdFormatPDFとして利用可能)。Officeの保存形式はExcel/Word/PowerPointそれぞれ別の定数体系ですが、代表的な値はMSDNドキュメントなどで公開されています。
文書の保存後、Wordを終了する際はword.Quit()を呼びます。Excelと違い、複数文書を開いている場合でもQuit()でアプリケーション全体が閉じますので、必要な文書は事前に全て保存しておくようにしましょう。
基本的なテキスト編集
Word文書にテキストを挿入したり編集するには、RangeオブジェクトやSelectionオブジェクトを使います。Wordではカーソル位置や特定の範囲をRangeとして扱い、そこに対してTextプロパティで文字列を設定できます。
新規文書に対してシンプルに文字列を入力してみます。
# 文書の先頭にテキストを挿入
range_start = doc.Range(0, 0) # 開始位置0、終了位置0は文書の先頭のRange
range_start.Text = "これはPythonから挿入したテキストです。\n"
doc.Range(0, 0)は文書の先頭位置(開始と終了が同じ位置)を示すRangeオブジェクトを取得します。ここに文字列を代入すると、その位置にテキストが挿入されます。上記では文章の末尾に改行文字\nも含めています。
では、もう少し複雑な操作として、段落を追加してフォーマットを適用してみましょう。
# 1つ目の段落の後ろに新しい段落を追加
range_end = doc.Range(doc.Content.End - 1, doc.Content.End - 1)
range_end.Text = "第2段落: 自動生成されたレポート\n"
# フォーマット設定: 第2段落を見出し2スタイルに
para2 = doc.Paragraphs(2) # 2つ目の段落を取得
para2.Range.Font.Bold = True # 太字
para2.Range.Font.Size = 14 # フォントサイズ14
para2.Range.Font.Name = "MS 明朝" # フォントをMS明朝に変更
doc.Content.Endは文書末尾の位置を示すので、doc.Content.End - 1を開始と終了にしてRangeを取得し、そこに新たな段落テキストを挿入しています。このやり方では常に文末に追加することになります。既存の段落間に挿入したい場合は別途目印となるRangeを取得する必要があります。
上記のコードで2つ目の段落を取得し、書式を設定しています。doc.Paragraphs(2)で2番目の段落オブジェクトが得られ、そのRangeプロパティからフォントの属性を操作しています。BoldをTrueに、Sizeを14ポイントに、Nameでフォント名を指定しています。
ポイント: 日本語フォント名を指定する際、環境によっては"MS Mincho"などローカライズされた名前で指定したほうが良い場合があります。上記の"MS 明朝"は全角スペースが含まれる点に注意してください。
テーブルや画像の挿入
Word文書では、表(テーブル)や画像の挿入も自動化できます。これらはDocument.Tables.AddメソッドやInlineShapes.AddPictureメソッドなどで実現します。
テーブルの挿入:
# 文書末尾に3行4列のテーブルを追加
range_end = doc.Range(doc.Content.End - 1, doc.Content.End - 1)
table = doc.Tables.Add(Range=range_end, NumRows=3, NumColumns=4)
# テーブルの1行目をヘッダーとして設定
headers = ["項目A", "項目B", "項目C", "項目D"]
for col, header in enumerate(headers, start=1):
table.Cell(1, col).Range.Text = header
table.Cell(1, col).Range.Font.Bold = True
# 2行目と3行目にデータを入力
data_row2 = ["データ1", "データ2", "データ3", "データ4"]
data_row3 = ["値1", "値2", "値3", "値4"]
for col, text in enumerate(data_row2, start=1):
table.Cell(2, col).Range.Text = text
for col, text in enumerate(data_row3, start=1):
table.Cell(3, col).Range.Text = text
このコードでは、文末に3行4列のテーブルを追加しています。doc.Tables.AddのRange引数にテーブルを挿入したい位置を指定し、行数と列数を渡します。戻り値のtableオブジェクトはTable型で、Cell(行, 列)メソッドで各セルのRangeが取得できます。セル内にテキストを設定するときは、常にCell(...).Range.Textを使います。ヘッダー行の文字を太字にするため、ヘッダーセルのRange.Font.BoldをTrueにしています。
画像の挿入:
# 指定した画像ファイルを文書末尾に挿入
image_path = r"C:\path\to\image.png"
range_end = doc.Range(doc.Content.End - 1, doc.Content.End - 1)
inline_shape = doc.InlineShapes.AddPicture(FileName=image_path, Range=range_end)
# 挿入した画像のサイズ調整(幅100ポイント、高さ自動調整)
inline_shape.Width = 100
inline_shape.LockAspectRatio = True # アスペクト比を保持
InlineShapes.AddPictureを使うと、文書の指定位置に画像を挿入できます。ここでは文末に挿入しています。LockAspectRatio = Trueとした上でWidthを100ポイントに設定することで、高さは自動的に比率維持で縮小されます(一般的に1ポイントは1/72インチなので、100ポイント ≒ 1.39インチ ≒ 3.53cm 程度の幅になります)。
なお、WordにはShapes.AddPictureというメソッドも存在し、こちらは文書内に「浮動配置オブジェクト」として画像を配置するものです。一般的な文書作成ではInlineShapes、つまり文字列と一体化したインライン画像のほうが扱いやすいため、本書ではInlineShapesでの挿入を紹介しました。
マクロとの連携 (Wordの場合)
WordもExcelと同様にマクロ(VBA)を持つことができます。必要に応じてword.Application.Run("MacroName", args...)でWordマクロを実行可能です。ただし、Excelに比べるとWordマクロを使わずに済むケースが多いかもしれません。それでも差し込み印刷機能(Mail Merge)の自動化など、Word独自の複雑な機能を使う場合は、Word側でマクロを組んでおきPythonからそれを呼び出すことも検討してください。
章末まとめ
第2章ではWord文書の自動生成について学びました。ExcelとはUIが違いますが、COMオブジェクトの操作という意味では共通しています。Wordの場合、文字列の操作が主体となるため、RangeやParagraphといったオブジェクトへの理解が重要でした。繰り返し試してみて、思い通りに文書が組み立てられるようになると、Pythonでレポートをテンプレートから自動作成するなど高度な自動化も可能になるでしょう。
次章ではOutlookの自動化に進みます。メール処理という別のドメインになりますが、Excel/Wordとは異なる視点でCOM自動化の例を見ていきます。
第3章: Outlookの自動化
3-1. Outlookアプリケーションの起動とメール送受信
Outlookはメールクライアントであり、予定表や連絡先なども管理するグループウェアです。PythonからOutlookを操作することで、メールの自動送信、受信メールの整理、スケジュール管理などをプログラムで実行できます。本章ではOutlookの基本操作からメール自動化までを扱います。
Outlookアプリケーションのインスタンス化
OutlookのCOMオブジェクトを取得するには、Outlook.ApplicationというProgIDを指定します。ただし、ExcelやWordとは異なり、Outlookは既に起動しているとDispatchで新しいインスタンスが作られず、既存のインスタンスを再利用しようとします。Outlookが未起動の場合は新規起動します。
import win32com.client
# Outlookアプリケーションのインスタンスを取得
outlook = win32com.client.Dispatch("Outlook.Application")
print("Outlook Version:", outlook.Application.Version)
OutlookはGUIアプリケーションでありながら、シングルトン(単一インスタンス)に近い振る舞いをします。そのため、Outlookを複数同時に起動することは通常ありません。Dispatchを呼ぶとOutlookが開き、outlook.ApplicationでOutlook全体のオブジェクトにアクセスできます。
メールの作成と送信
Outlookでメールを新規作成するにはoutlook.CreateItem(0)を使います。0はメールアイテム(olMailItem)を表す定数です。CreateItemの戻り値はMailItemオブジェクトになります。そこに対して件名や本文、宛先などを設定し、Send()メソッドを呼ぶと実際にメールが送信されます。
# 新規メールアイテムの作成
mail = outlook.CreateItem(0) # 0 = olMailItem (メール)
# メールのプロパティを設定
mail.To = "recipient@example.com" # 宛先(複数の場合は;で区切る)
mail.CC = "ccperson@example.com" # CC(必要なら)
mail.Subject = "Pythonからの自動送信メール"
mail.Body = "これはPythonのwin32com経由で送信されたメールです。"
# メールの送信
mail.Send()
print("メールを送信しました。")
mail.Toには宛先のメールアドレス文字列を入れます。複数の宛先がある場合は;(セミコロン)で区切って1つの文字列にします。mail.CCやmail.BCCも同様に設定できます。mail.Subjectは件名、mail.Bodyはメール本文です。上記ではテキストメールとして本文を設定していますが、mail.HTMLBodyを使えばHTML形式のリッチテキストメールを送信することも可能です。
また、mail.Attachments.Add(ファイルパス)で添付ファイルを追加できます。
# 添付ファイルの追加
attachment_path = r"C:\path\to\file.txt"
mail.Attachments.Add(Source=attachment_path)
Attachments.AddメソッドではSource引数にファイルパスを渡すだけで添付できます。実は他にもTypeやPosition、DisplayNameなどの引数がありますが、基本的なファイル添付であればSourceだけで十分です (Attachments.Add method (Outlook) | Microsoft Learn) (Attachments.Add method (Outlook) | Microsoft Learn)。Outlookのメール形式によっては若干動作が異なることもありますが、通常テキストまたはHTMLメールであれば問題なく添付され、ファイル名が表示されます。
受信メールの読み取り
Outlookの受信トレイ(Inbox)にアクセスしてメールを読み取ることもできます。Outlookでは、メールや予定表などを扱うフォルダの集まりをNameSpaceと呼びます。既定ではMAPIという名前空間を利用し、その中に受信トレイや送信済みアイテムなどのフォルダが存在します。
NameSpaceオブジェクトを取得し、そこから受信トレイフォルダを得る手順は次の通りです。
# NameSpaceの取得(MAPIを指定)
namespace = outlook.GetNamespace("MAPI")
inbox = namespace.GetDefaultFolder(6) # 6 = olFolderInbox (受信トレイ)
print("受信トレイ内のアイテム数:", inbox.Items.Count)
GetNamespace("MAPI")でNameSpaceを取得した後、GetDefaultFolder(6)を呼んでいます。6はOutlookの定数で受信トレイを意味します(olFolderInbox)。主なフォルダの定数番号は次の通りです。
6: 受信トレイ (olFolderInbox)
5: 送信済みアイテム (olFolderSentMail)
4: 下書き (olFolderDrafts)
3: 削除済みアイテム (olFolderDeletedItems)
9: 連絡先 (olFolderContacts)
10: カレンダー (olFolderCalendar)
これらはwin32com.client.constantsからも参照できますが、定数値を直接コードに書いてしまう例も多く見られます(Outlookオブジェクトのconstantsはインポートしても良いですがExcel等と混同しやすいため、本書では番号を直接使うシンプルな方法を紹介します)。
受信トレイのItemsコレクションにはメールアイテムや会議招待など、あらゆるアイテムが含まれます。メールのみ対象にする場合は、ItemsをループしながらMailItem型かどうかをチェックします。
import datetime
# 受信トレイ内の最新5件の件名と送信者を表示
messages = inbox.Items
messages.Sort("[ReceivedTime]", True) # 受信時刻でソート(Trueで降順=最新から)
for i in range(1, min(6, messages.Count+1)): # 1から始まるインデックスに注意
item = messages(i)
if item.Class == 43: # 43 = olMail (MailItemのClass)
received = item.ReceivedTime
sender = item.SenderName
subject = item.Subject
# Python側ではCOMの日時はpythoncomからdatetimeに変換可能
if isinstance(received, datetime.date):
received = received.strftime("%Y/%m/%d %H:%M")
print(f"{received} | {sender} | {subject}")
このコードでは、まずItemsをReceivedTimeで降順ソートしています(最新のメールから順)。Items.Sortを使うときは、フィールド名(ここでは[ReceivedTime])を指定し、第二引数にTrueを与えると降順となります。フィールド名を指定するときは必ず[]で囲む必要があります。Outlookのフィールド名はスペースが入っている場合もあるためこのような仕様になっています。
Itemsコレクションのアクセスには1からのインデックスを使います(ここ重要です!Excelのコレクションは0始まりと1始まりが混在していましたが、OutlookのItemsは1始まりです)。messages(i)でi番目のアイテムを取得できます。すべてのOutlookアイテムに共通する基本プロパティとして、Classがあります。これはアイテムの種類を表す数値で、43はメールアイテム (MailItem)を意味します。他に、会議アイテム(olAppointment=26)や連絡先(olContact=40)など様々な種類がありますが、受信トレイで大半はMailItemでしょう。
メールアイテムの場合、ReceivedTime(受信日時), SenderName(送信者名), Subject(件名)などのプロパティを取得しています。ReceivedTimeはCOMオブジェクト上ではPyTime(日時)型ですが、Pythonではdatetime型として扱えます。表示のためstrftimeでフォーマットしています。
添付ファイルの保存
受信メールの中に添付ファイルがある場合、それを保存することもできます。MailItemオブジェクトのAttachmentsコレクションにファイルが入っているので、繰り返し処理で取り出し、attachment.SaveAsFile(保存先パス)とします。
# 添付ファイルをすべてダウンロード(受信トレイの最新メール1件を例に)
latest_mail = messages(1) # ソート済みの最新
if latest_mail.Class == 43: # MailItem
attachments = latest_mail.Attachments
attachment_count = attachments.Count
for index in range(1, attachment_count+1):
attachment = attachments.Item(index)
save_path = rf"C:\temp\{attachment.FileName}"
attachment.SaveAsFile(save_path)
print(f"添付ファイルを保存しました: {save_path}")
attachments.Countで添付ファイルの数を取得し、1から順にattachments.Item(index)で各Attachmentオブジェクトを取得します(Outlookのコレクションは基本1始まりです)。AttachmentオブジェクトのプロパティとしてFileNameが取得できるので、それを使って保存パスを決めています。SaveAsFileにフルパスを渡すと、その場所にファイルが保存されます。
Outlookはセキュリティ上、自動化スクリプトからのメール読み書きに警告を出すことがありました(特に古いバージョン)。近年のOutlookではセキュリティポップアップが出ない設定や、管理者権限の確認などが強化されていますが、もし自動化で問題が生じる場合は「プログラムによるOutlookアクセスのセキュリティ設定」を見直す必要があるかもしれません。この辺りはOutlookのオプションやグループポリシーによって異なります。
3-2. 予定表や連絡先の操作
Outlookを使った自動化はメールだけでなく予定表(Calendar)や連絡先(Contacts)にも及びます。例えば、特定の日時に会議を自動登録したり、定期的な予定をPythonから書き込んだり、名刺管理システムから連絡先を自動追加する、というようなことも可能です。この節では予定表アイテムの作成と連絡先アイテムの作成について簡単に紹介します。
予定表アイテム(Appointment)の作成
Outlookの予定表はAppointmentItemと呼ばれるCOMオブジェクトで表現されます。OutlookのCreateItemメソッドで引数に1(olAppointmentItem)を指定すると新規の予定表アイテムが作成できます。以下は翌日の特定時刻に会議をセットするスクリプトの例です。
import pythoncom
import datetime
# 新規予定アイテムの作成
appointment = outlook.CreateItem(1) # 1 = olAppointmentItem (予定表)
appointment.Start = datetime.datetime.now() + datetime.timedelta(days=1, hours=1)
appointment.Duration = 60 # 60分間
appointment.Subject = "自動登録した会議"
appointment.Location = "会議室A"
appointment.Body = "これはPythonスクリプトによって自動登録された会議です。"
appointment.ReminderMinutesBeforeStart = 15 # 15分前にリマインダー
appointment.ReminderSet = True
# 予定を保存(Outlookの予定表に登録)
appointment.Save()
print("予定を1件登録しました。")
このコードでは、現在時刻から1日と1時間後(つまり翌日の同じ時刻より1時間後)に開始する1時間の予定を作成しています。appointment.Startにdatetimeオブジェクトを直接渡せます。PyWin32を使う場合、datetimeオブジェクトは自動的にCOMの日時(PyTime型)に変換されるのでそのままで問題ありません。Durationは予定の長さを分単位で指定しています。この予定には件名(Subject)、場所(Location)、本文(Body)を設定しました。また、15分前にリマインダーを出す設定もしています。
appointment.Save()を呼ぶと、Outlookの予定表にこの予定が保存されます。Outlookを起動して予定表を見ると、指定した日時に「自動登録した会議」という予定が追加されているはずです。もし他の人を招待する会議出席依頼を送りたい場合は、appointment.MeetingStatus = 1 (1 = olMeeting) としてからappointment.Recipients.Add("person@example.com")で参加者を追加し、最後にappointment.Send()を呼びます。このように、Outlookの予定はMeeting(会議)かAppointment(自身の予定)かで操作が変わりますが、基本的なプロパティは共通です。
連絡先アイテム(Contact)の作成
連絡先(ContactItem)の追加も可能です。CreateItemの引数に2(olContactItem)を指定すると新しい連絡先アイテムを作成できます。例えば連絡先フォルダに新しい連絡先を追加する例です。
# 新規連絡先アイテムの作成
contact = outlook.CreateItem(2) # 2 = olContactItem (連絡先)
contact.FirstName = "太郎"
contact.LastName = "山田"
contact.Email1Address = "taro.yamada@example.com"
contact.CompanyName = "テスト株式会社"
contact.JobTitle = "部長"
contact.MobileTelephoneNumber = "090-1234-5678"
# 連絡先を保存
contact.Save()
print(f"連絡先 {contact.FullName} を追加しました。")
このコードでは、新規の連絡先アイテムに対して、姓・名、メールアドレス、会社名、役職、携帯番号などのプロパティを設定しています。FullNameはOutlook側で用意される「氏名」のプロパティで、FirstNameとLastNameを組み合わせたものです。Save()を呼ぶと連絡先フォルダに保存されます。Outlookの連絡先を開いて確認すると「山田 太郎」という連絡先が追加され、各フィールドに値が入っていることでしょう。
Outlookの連絡先には非常に多くのフィールドが存在します。住所や誕生日、メモなど多数のプロパティがありますが、基本は上記のようにcontact.フィールド名 = 値で設定可能です。ドキュメントを参照して必要なフィールドに値を入れるようにします。
Outlook自動化の注意点
Outlookの自動化は強力ですが、一つ注意すべき点があります。それは、Outlookが起動していない状態でメール送信などを行おうとした場合です。OutlookはDispatchで起動できますが、Outlookの初回起動にはユーザーのメールボックスを開く処理があり、これがスクリプト中でタイムアウトを引き起こすことがあります。特にExchangeサーバーやOffice365に接続している場合、起動直後に大きな負荷がかかることもあるため、AutomationからOutlookを使う際は少し待ち時間を入れる、あるいはすでにOutlookを起動しておいてからスクリプトを動かす、などの工夫が必要になる場合があります。
もう一点、Outlookはセキュリティのため、自動化でのメール送信に対して警告を出す場合があります(昔のOutlookでよくあった「ウイルス対策のためプログラムが自動的にメールを送信しようとしています...許可しますか?」というダイアログです)。このダイアログは放置するとデフォルトで拒否されるので、サーバーサイドで無人実行する場合には問題となります。回避策としては、Outlookが提供する「プログラムによる送信を許可」チェックを事前にユーザーが有効にするか、サードパーティーのセキュリティ回避ツール(例えばOutlook Redemptionライブラリなど)を使うなどがあります。しかし、最近の環境では適切にOfficeが設定されていれば出ないケースも増えています。
以上、Outlookの基本操作からメール、予定、連絡先の自動化を紹介しました。
章末まとめ
第3章ではOutlookをPythonから操作する方法を学びました。ExcelやWordとは違って、Outlookにはメールや予定表という特有のドメインがあり、その操作にも少し癖がありました。しかし基本はCOMオブジェクトを取得し、プロパティを設定してメソッドを呼ぶ、という点で共通しています。
Outlook自動化は業務効率化の観点で非常に有用です。たとえば定型レポートをExcelで作成し、その結果を自動的にメール送信するといったワークフローは、Excel+Outlookの連携で実現できます。次章ではCOM全般の基礎知識に立ち返りつつ、ActiveXの操作やOffice以外のCOMオブジェクトについても触れてみます。
第4章: ActiveXとCOMオブジェクトの基礎
4-1. ActiveXとは何か
COMテクノロジーの応用として、ActiveXというものがあります。ActiveXはCOMの一形態で、ユーザーインターフェース部品(UIコンポーネント)として利用されることが多いです。例えばWebブラウザの中で動作するActiveXコントロールや、Excelシート上に埋め込まれたフォーム部品などがActiveXです。
簡単に言うと、ActiveX = UI向けのCOMコンポーネントと考えて差し支えありません。ただし、技術的にはCOMと同じ仕組みで動作しており、インターフェースを公開しProgIDで呼び出すことができます。PythonからActiveXを操作する場合も、基本的にはwin32com.client.DispatchでProgIDを指定すれば利用できます。ただしActiveXはGUI要素のため、デスクトップ上の座標やイベント処理などが絡むケースもあります。
ActiveXの例: Internet Explorerコンポーネント
WindowsにはInternet Explorer(IE)のエンジンをActiveXとして利用する仕組みがありました。InternetExplorer.ApplicationというProgIDで呼び出せるCOMオブジェクトは、Webブラウザを自動化するために使われました。現在ではIEのレガシー化によりあまり使われませんが、参考として紹介します。
# Internet Explorer ActiveXを使ってウェブページを開く例
ie = win32com.client.Dispatch("InternetExplorer.Application")
ie.Visible = True
ie.Navigate("https://www.example.com")
# ページがロードされるまで待機する(簡易的にbusyフラグで待つ)
while ie.Busy:
pythoncom.PumpWaitingMessages()
# ページのタイトルを取得して表示
print("ページタイトル:", ie.Document.Title)
# 終了
ie.Quit()
上記のように、IEをActiveXとして起動すると、PythonからナビゲーションやDOM操作が可能でした。ie.DocumentからHTMLドキュメントにアクセスし、DOMツリーを辿って操作することもできます。ただし現在はEdge WebDriver(Selenium等)やWebView2など新しい技術が使われるため、ActiveXを直接触る機会は少ないかもしれません。
ActiveXの例: Excelのフォームコントロール
ExcelやWordでは、フォームコントロール(ボタンやテキストボックス等)を配置して簡易なGUIを作ることができます。これらもCOMオブジェクトとして扱うことができます。例えばExcel上のボタン(ActiveXコントロールのCommandButton)をPythonから操作することも技術的には可能です。
# Excelシート上にActiveXボタンを配置してキャプションを設定する例
excel = win32com.client.Dispatch("Excel.Application")
excel.Visible = True
wb = excel.Workbooks.Add()
ws = wb.Worksheets(1)
# ボタンを追加(OLEObjects.AddでActiveXコントロールを追加)
button = ws.OLEObjects().Add(ClassType="Forms.CommandButton.1", Left=100, Top=50, Width=100, Height=30)
button.Object.Caption = "Click Me"
このスクリプトでは、Excelのシート上にActiveXボタン(ClassTypeでForms.CommandButton.1を指定)を追加し、そのCaption(表示文字列)を変更しています。button.Objectとすることで、そのOLEObject(ActiveXコントロール)の内部オブジェクトにアクセスできます。ActiveXコントロールはExcel側ではOLEObjectsコレクションに属します。例えばテキストボックスの場合Forms.TextBox.1をClassTypeに指定すると、テキストボックスを配置できます。
ActiveXコントロールにはイベント処理(ボタンがクリックされたときに何をするか等)が伴います。PyWin32ではCOMイベントを扱うこともできますが、少々難易度が高くなります。イベントを捉えるにはDispatchWithEventsという機能を使って、COMオブジェクトのイベントシンクにPythonのクラスを対応づけます。本書では詳細には触れませんが、興味があればPyWin32のドキュメントで「WithEvents」や「COMイベント」の項目を調べてみてください。
4-2. 外部アプリケーションとの連携
COMはMicrosoft Office以外にも様々なWindowsアプリケーションで採用されています。たとえばAdobe Acrobatの一部機能、AutoCADやPhotoshopのスクリプト機能、Windows組み込みの機能(Shell.Applicationなど)にもCOMインターフェースがあります。
Shell.Applicationを利用する
Windowsのエクスプローラーやシェル機能はShell.ApplicationというProgIDで利用できます。これはファイル操作やフォルダ情報の取得など、Windowsのシェル機能の自動化に使えます。
shell = win32com.client.Dispatch("Shell.Application")
# マイドキュメントフォルダを開く
folder = shell.Namespace(5) # 5 = My Documents (CSIDL constant)
print("マイドキュメント内の項目:")
for item in folder.Items():
print(item.Name)
shell.Namespaceに特殊フォルダのCSIDL番号を入れると、そのフォルダオブジェクトが得られます。5はMy Documents(ドキュメント)フォルダです。そのItemsを列挙することでフォルダ内のファイル名を取得しています。これ以外にもShell.Applicationでは、デスクトップ上の操作や、ファイルの右クリックメニュー項目を実行するといった高度なこともできますが、Pythonから行う機会は限定的かもしれません。
COMオブジェクトの探索
「Windowsのこの機能を自動化したいが、COMオブジェクトが用意されているかわからない」という場合は、Windowsのレジストリを調べるか、またはドキュメントを検索する必要があります。COMオブジェクトはレジストリのHKEY_CLASSES_ROOT配下にProgIDやCLSIDが登録されていますが、そのまま調べるのは大変です。
PyWin32にはwin32com.client.Dispatchする前に、利用可能なオブジェクトの情報を取得する仕組みもあります。例えば仮にProgIDを知っているなら、一度makepyというユーティリティを使って、そのタイプライブラリのラッパーを生成すると、よりPythonicに扱えることがあります。
python -m win32com.client.makepy "Microsoft Excel 16.0 Object Library"
上記はExcelの型ライブラリを生成する例です(Officeのバージョンによって数字は変わる)。これを実行するとExcelの全メソッドや定数がPythonから参照しやすくなり、IDEの補完も効くようになります。しかし、必須の手順ではありません。動的ディスパッチでも大抵のことはできます。
Office以外の具体例
ここでは簡単に、Office以外のCOM自動化例を挙げておきます。
Internet Explorer: 前述したようにIEを自動化して画面を操作(現在は非推奨)。
AutoCAD: AutoCAD.ApplicationというProgIDがあり、図面を自動生成したり編集できる(AutoCADインストール時にCOMサポートを含む)。
Photoshop: PhotoshopはCOMではなく独自のスクリプト機構(ExtendScript/JavaScriptベース)が主だが、Bridgeなど一部COM相当のインターフェースもある。
SAP GUI: 業務系ではSAPのGUI操作をCOM経由で行う例もある(SAP GUI Scripting APIがCOMとして提供されている)。
WScript.Shell: Windows Script HostのShellオブジェクト。WScript.ShellのSendKeysメソッドでキーボード操作を送信する等が可能。
最後のWScript.Shellについては、例えばキーボードのキー入力を自動発行するために使われることがあります。
wsh = win32com.client.Dispatch("WScript.Shell")
wsh.AppActivate("Untitled - Notepad") # メモ帳にフォーカスを移す
wsh.SendKeys("Hello, World!", 0) # キー入力を送る
このようにアプリ名を指定してフォーカスし、SendKeysで文字列をタイプさせることができます。完全自動化というより、RPAに近い方法ですが、COMを通じてこういったこともできます。
COMの内部動作のおさらい
ここで一度、COMオブジェクト取得の内部動作を振り返ってみましょう。
Python側でwin32com.client.Dispatch("Prog.ID")を呼ぶ。
Windowsはレジストリから"Prog.ID"に対応するCLSIDを検索する。
CLSIDに紐づくサーバー(EXEもしくはDLL)のパスを見つけ、COMオブジェクトを起動/ロードする。
指定のインターフェース(IDispatch)を取得し、そのポインタをPython側に返す。
Pythonのwin32comは、IDispatchインターフェースを経由してメソッド呼び出しやプロパティ取得を行う。
PyWin32は、その名の通りWin32 APIをPythonで使えるようにするものですが、COMの部分ではDispatch(IDispatch)インターフェースに依存しています。IDispatchは後述する早期バインディング・後期バインディングという観点では後期バインディング(Late Binding)と呼ばれるものです。要はメソッド名やプロパティ名を文字列として渡して呼び出す仕組みであり、これにより柔軟性が高まっています。
もし、より厳密なCOM操作をしたい場合は、comtypesやpythoncomを使って、IIDを指定してインターフェース取得することもできますが、通常のOffice自動化でそこまで必要になることは稀です。
以上、ActiveXやCOM一般についての基礎知識と、Office以外のCOM利用例を紹介しました。
第5章: 応用編 (業務自動化の実例)
ここまで、Excel・Word・Outlookと個別にPythonから操作する方法を見てきました。最終章では、これらを組み合わせた実践的な業務自動化の例を紹介します。現実のシナリオを想定し、Pythonスクリプトでどのように処理を組み合わせるかを解説します。
5-1. シナリオ1: Excel, Word, Outlookを連携したレポート作成&送信
シナリオ: 毎月の営業成績をExcelから集計し、Wordでレポート文書を作成して、Outlookメールで関係者に送信する。
例えば、Excelに各営業担当者の売上データが月次でまとまっているとします。これをPythonで集計し、Wordで報告書を生成して、最後にOutlookメールで自動送信するといった流れです。
ステップ:
Excelからデータを読み込む(win32comを使ってセル範囲を取得)。
Pythonでデータ集計を行う(例えば総売上や平均など計算)。
Wordでレポート文書をテンプレートから開く、もしくは新規作成して内容を差し込む。
Word文書をPDFに保存(オプション: PDF化して添付する場合)。
Outlookでメールを作成し、文書またはPDFを添付して送信。
この一連をPythonのみで自動実行できます。
import win32com.client
from win32com.client import constants
# Excelからデータ取得
excel = win32com.client.Dispatch("Excel.Application")
excel.Visible = False # 表示せず実行
wb = excel.Workbooks.Open(r"C:\data\sales_data.xlsx")
ws = wb.Worksheets("2025年01月") # 例えば1月シート
# 売上データの取得 (A2:A101に担当者名, B2:B101に売上額があると仮定)
names = ws.Range("A2:A101").Value
sales = ws.Range("B2:B101").Value
wb.Close(False)
excel.Quit()
# データ集計 (Python側で処理)
sales_values = [s[0] for s in sales if s[0] is not None] # タプルの中から値のみ抽出
total_sales = sum(sales_values)
avg_sales = total_sales / len(sales_values) if sales_values else 0
# Wordでレポート作成
word = win32com.client.Dispatch("Word.Application")
word.Visible = False
doc = word.Documents.Add() # 新規文書(テンプレートがあればOpenで開く)
range_start = doc.Range(0, 0)
range_start.Text = f"2025年1月 営業成績レポート\n"
range_start.InsertAfter(f"\n総売上: {total_sales:.2f}万円\n")
range_start.InsertAfter(f"平均売上: {avg_sales:.2f}万円\n")
range_start.InsertAfter("\n担当者別売上:\n")
# 担当者ごとの売上を表形式で挿入
table = doc.Tables.Add(doc.Range(doc.Content.End - 1, doc.Content.End - 1), len(sales_values)+1, 2)
table.Cell(1,1).Range.Text = "担当者"
table.Cell(1,2).Range.Text = "売上額"
table.Cell(1,1).Range.Font.Bold = True
table.Cell(1,2).Range.Font.Bold = True
for i, (name, sale) in enumerate(zip(names, sales), start=2):
if name[0] is None or sale[0] is None:
break # データが尽きたら終了
table.Cell(i, 1).Range.Text = str(name[0])
table.Cell(i, 2).Range.Text = f"{sale[0]}"
# 文書を保存
doc_path = r"C:\reports\sales_report_2025-01.docx"
pdf_path = r"C:\reports\sales_report_2025-01.pdf"
doc.SaveAs(doc_path)
doc.SaveAs(pdf_path, FileFormat=17) # PDF形式でも保存
doc.Close()
word.Quit()
# Outlookでメール送信
outlook = win32com.client.Dispatch("Outlook.Application")
mail = outlook.CreateItem(0)
mail.To = "boss@example.com; team@example.com"
mail.Subject = "2025年1月 営業成績レポート"
mail.Body = "お疲れ様です。\n\n2025年1月の営業成績レポートをお送りします。ご確認ください。\n\n--\n自動送信メール"
# 添付ファイルとしてPDFを添付
mail.Attachments.Add(Source=pdf_path)
mail.Send()
print("レポートを送信しました。")
このスクリプトは、各章で学んだ内容を組み合わせた総合的な例になっています。Excelからデータを読み込むところではRange.Valueを使っていますが、Excelが閉じられた後はPython側にデータが残っているため、その後はPython内で通常のリスト操作をしています。Wordでドキュメントを作成し、内容を埋めて最後にPDF保存しているのは、相手がWordを持っていなくても読めるようにする配慮です。Outlookで複数の宛先を;で区切って指定し、本文と添付を設定して送信しています。
業務自動化では、このように複数のアプリケーションを跨いで処理を行うことがしばしばあります。Pythonは各所で登場するCOM操作を1つの言語で記述できるため、Glue Code(糊付けするコード)として非常に優秀です。人間が手動でExcel集計してWord書類作ってメール送信...とやっていたら1時間以上かかる作業も、スクリプトなら数秒から数十秒で終わるでしょう。
5-2. シナリオ2: 大量ドキュメントの一括処理
シナリオ: フォルダ内に大量のWord文書があり、それぞれに特定のフォーマット(例えば社名や日付の記載)を追加で挿入する必要がある。
このような場合、Pythonを使って対象フォルダ内の全てのWord文書を開き、所定の処理を施し、上書き保存するようなスクリプトを組むことができます。
ステップ:
os.listdirなどを使ってフォルダ内の.docxファイル一覧を取得。
Wordを立ち上げ、Visible=Falseで非表示実行(大量処理なら画面は不要)。
ループで各ファイルをDocuments.Openで開く。
範囲を指定してテキスト挿入、もしくは置換処理(Find.Executeメソッドでの一括置換も可能)。
保存して閉じる。
ループ終わったらWordを終了。
コード例:
import os
import win32com.client
folder_path = r"C:\docs\contracts"
files = [f for f in os.listdir(folder_path) if f.endswith(".docx")]
word = win32com.client.Dispatch("Word.Application")
word.Visible = False
for filename in files:
file_path = os.path.join(folder_path, filename)
doc = word.Documents.Open(file_path)
# 文末に会社名と改行2つ挿入
end_range = doc.Range(doc.Content.End - 1, doc.Content.End - 1)
end_range.InsertAfter("\n\n株式会社Python自動化")
# 上書き保存
doc.Save()
doc.Close()
print(f"{filename} を処理しました。")
word.Quit()
print("全ての文書を処理しました。")
このコードでは単純に文末に社名を追加しています。もう少し高度な処理として、置換をするケースも考えられます。WordのCOMオブジェクトではFindオブジェクトを使用してテキスト置換ができます。例えばdoc.Content.Find.Execute(FindText="旧社名", ReplaceWith="新社名", Replace=2)のように実行すると、文書全体の"旧社名"を"新社名"に置換できます(Replace=2は常に全部置換の意味、定数wdReplaceAll)。
大量ファイル処理では、Officeアプリケーションのメモリ消費やリソースリークに注意しましょう。ループ内で確実にdoc.Close()すること、例外が起きてもWordが終了するようにtry...finally構文を使うなど工夫が必要です。また、あまりに大量のファイルを高速で処理しようとするとOffice側が追いつかない場合もあります。その場合は適度にpythoncom.PumpWaitingMessages()を呼んだり、時間待ちを入れることも検討してください。
5-3. シナリオ3: Outlookメールの一括整理
シナリオ: Outlookの受信トレイに大量のメールがあり、件名に特定のキーワードを含むものをフォルダに移動したい。
メールの整理も自動化可能です。PythonからOutlookを操作し、条件にマッチするメールを探して移動する例を示します。例えば、件名に"[自動応答]"と含まれるメールをすべて「自動応答フォルダ」に移動する、といった処理です。
ステップ:
Outlook起動、NameSpace取得、受信トレイ取得。
目的のフォルダ(例: "自動応答")を受信トレイ下に作成 or 取得。
Itemsを走査し、条件に合うMailItemを選定。
MailItem.Move(フォルダオブジェクト)で移動。
コード例:
import win32com.client
outlook = win32com.client.Dispatch("Outlook.Application")
namespace = outlook.GetNamespace("MAPI")
inbox = namespace.GetDefaultFolder(6) # 6=olFolderInbox 受信トレイ
# フォルダ取得(無ければ作成)
target_folder_name = "自動応答"
try:
target_folder = inbox.Folders(target_folder_name)
except Exception:
target_folder = inbox.Folders.Add(target_folder_name)
count = 0
# 受信トレイ内のアイテムをループ(逆順にループしないとコレクション変更に弱いので注意)
items = list(inbox.Items)
for item in items:
if item.Class == 43 and "[自動応答]" in item.Subject:
item.Move(target_folder)
count += 1
print(f"件名に[自動応答]を含むメールを{count}件、フォルダ'{target_folder_name}'に移動しました。")
注意点として、OutlookのItemsコレクションを直接forで回すと、コレクションを変更したときに問題が起こることがあります。上記ではitems = list(inbox.Items)として一度Pythonのリストに全アイテムを展開してからループしています。これにより、ループ中にitem.Moveで受信トレイからメールが取り除かれても、Python側のリストには影響しません。もう一つの方法として降順でループする方法もあります(最後のアイテムから順に移動する)。
フォルダの取得はinbox.Folders("自動応答")でできますが、存在しないとエラーになるためtryで囲い、無ければFolders.Addで作成しています。
このようにOutlookメールの整理も自動化でかなり柔軟にできます。特定プロジェクトのメールを案件フォルダに仕分けしたり、古いメールを年別フォルダにアーカイブするなども同じ考え方で実現できます。
5-4. その他の応用例
他にも実務で役立つ自動化シナリオはいろいろ考えられます。いくつかアイデアを紹介しておきます。
ExcelとWebAPI連携: PythonでWeb APIからデータを取得し、Excelに書き込んで報告書を作成。例えば為替レートをAPIから取得してExcelで計算、グラフ化。
PowerPointの自動化: 本書では扱いませんでしたが、PowerPointもCOMオブジェクトがあり、自動化できます。毎月の報告用スライドをExcelデータから自動生成してメール送信、なんてことも可能です。
Outlook予定表とExcelの組み合わせ: Excelに月次カレンダーを作っておき、そこからOutlookに予定を登録する。あるいはOutlook予定をExcelにエクスポートして勤務表を作るなど、予定表と表計算の連携も考えられます。
Word差し込み印刷の自動化: Outlookの連絡先やExcelのデータを使って、Wordの差し込み印刷(Mail Merge)をPythonから制御し、大量の宛名ラベルや案内文をPDFで出力する。WordのMail MergeはCOMからも利用可能です(Document.MailMergeオブジェクトを使用)。
実用にあたっては、単にAPIを知っているだけでなく、「どう組み合わせるか」の発想が重要です。Pythonは様々なライブラリがあるので、必要に応じてOpenPyXLやPython-Docxのようなファイル直接操作ライブラリと組み合わせても良いでしょう。しかし、COMを使う利点は「本物のOfficeアプリケーションの振る舞いを再利用できる」ことです。Excelの計算エンジンやグラフ描画、Wordのレイアウトエンジン、Outlookの通信機能など、COMだからこそ簡単に活用できる資産も多いのです。
付録: トラブルシューティングと参考情報
最後に、COM自動化(PyWin32)を行う上で直面しがちな問題とその対処法、そして学習を深めるための情報源を紹介します。
A-1. よくあるエラーと解決方法
1. Dispatchでエラーが出る(Invalid class string)
エラー例: pywintypes.com_error: (-2147221005, 'Invalid class string', None, None)
このエラーメッセージは、Dispatch("ProgID")で指定したProgIDが見つからない場合に出ます。原因としては:
ProgIDのスペルミス(例: "Excel.Application"を"Exce.Application"と書いてしまった)。
該当アプリケーションがインストールされていない、またはCOM登録されていない(Officeがインストールされていない環境など)。
対処: ProgIDを確認し、正しい名前を指定する。Office製品名の場合はバージョンによらず基本名で通るはずですが、例えばAccessなどはAccess.Applicationです(Excel, Word, PowerPoint, Outlook, Access, etc.)。また、64bit Pythonから32bit Officeを操作する場合、PyWin32では透明に動くはずですが、極稀に問題があるとの報告もあります。その場合はPythonとOfficeのビット数を揃えることも検討してください。
2. コード実行中にOfficeアプリがフリーズする/応答なしになる
これは、処理が早すぎたり大量すぎたりして、Office側が応答を返せていないときに起こりがちです。特にExcelで膨大なセルを一度に更新したりすると、描画が追いつかずGUIが固まることがあります。またOutlookで大量メールを処理するときも同様です。
対処: 適宜待ち時間を入れる。pythoncom.PumpWaitingMessages()をループ中に挟むと、COMメッセージの処理が進むことがあります。あるいはシンプルにtime.sleep(0.1)などで少し休止を入れ、GUIの処理時間を与えると改善することがあります。
3. Outlookのメール送信でセキュリティ警告が出る
前述しましたが、Outlookのバージョンによっては自動メール送信や連絡先アクセスで警告ダイアログが出ることがあります。無人実行ではこれが致命的です。
対処: 組織環境なら管理者に相談し、グループポリシーで「プログラムによるアクセスの許可」を適切に設定してもらう。個人環境ならばOutlookのオプション→トラストセンター→プログラムによるアクセスで設定変更を試みる(但しウイルス対策ソフトが管理していて変更できないことがあります)。どうしてもダメなら、Outlook以外のメール送信手段(SMTPライブラリなど)を使うことも検討します。
4. Excelのプロセスが残って終了しない
スクリプト実行後にタスクマネージャーを見るとEXCEL.EXEが残ってしまっているケースです。これは、excel.Quit()が呼ばれなかったり、WorkbookやRangeオブジェクトが生きているとExcelが終了しないことがあります。また、明示的にQuitしてもCOM参照カウントの関係で残る場合もあります。
対処: 原則として、Excelを開いたら必ずQuit()させるようにtry...finallyで囲むことを習慣づけましょう。また、WorkbookやWorksheetオブジェクトを変数に入れた場合、早めにdelで削除してしまうのも一つの手です(COMオブジェクトの参照カウントを減らすため)。最終手段として、プロセスキルをする方法もありますが、本来は避けるべきです。
5. 日本語パスや文字列に関するエンコーディングエラー
PyWin32自体はUnicode対応していますが、Windows APIに渡す文字列が想定外の場合エラーになることがあります。特にファイルパスが日本語で長すぎる場合など。
対処: パスは常にr"文字列"(raw string)で渡してエスケープシーケンスに注意する。長いパスはなるべく避ける(WindowsのMAX_PATH制限などに引っかかると面倒なので、可能なら260文字未満に)。必要があればWindows APIで長いパスを扱う方法もありますが、そこまでのケースは稀でしょう。
6. COMオブジェクトのメソッドやプロパティが見つからない
たとえばExcelの操作でsheet.Cellsは使えたのに、別のプロパティがどう書いても見つからない、といったことがあります。PyWin32では属性アクセスが通らない場合、invokeという内部メソッドを直接叩くこともできますが、まず確認すべきはプロパティかメソッドかです。ExcelのVBAリファレンスを見ると、Setters/Gettersで別れているものなどがあります。その場合、PyWin32ではobj.Propertyではなくobj.Property()のように関数呼び出しにする必要があったり、その逆もあります。
対処: ドキュメントやインターネットで該当オブジェクトの正確な使い方を調べる。Stack Overflowなどで同じ操作をしているPyWin32の例を探すと良いです。またdir(obj)を実行して利用可能な属性を確認するのも有効です。Excelの場合は_ApplyTypes_など内部用のものも見えますが、有用なヒントになることがあります。
A-2. 参考リンクやドキュメント
Microsoft公式ドキュメント (Office VBA リファレンス):
Excel, Word, Outlookそれぞれのオブジェクトモデルのリファレンスが役立ちます。PyWin32から使う場合も基本的にVBAオブジェクトモデルをなぞるので、VBAのコードサンプルをPythonに移植する形で実装できます。Excel VBA リファレンス: https://learn.microsoft.com/office/vba/api/excel.object-model
Word VBA リファレンス: https://learn.microsoft.com/office/vba/api/word.object-model
Outlook VBA リファレンス: https://learn.microsoft.com/office/vba/api/outlook.object-model
Python for Windows Extensions (PyWin32) ドキュメント:
https://github.com/mhammond/pywin32
GitHub上に基本的な使い方や、FAQなどがあります。ヘルプファイルも提供されています。PyWin32を使ったブログ記事やQiita記事:
実際のユースケースを知るには、開発者のブログ記事が参考になります。日本語ではQiitaや個人ブログにOffice自動化の記事が多くあります (PythonからExcelをwin32comで操作する #Python3 - Qiita)。英語ではStack Overflowに断片的なQ&Aが豊富です。Stack Overflow (英語):
特にハマりやすいポイント(PivotTableの操作、Chartの細かい設定、Outlookの予定表操作など)は、Stack Overflowで既出質問があることが多いです。検索キーワードに「win32com」「python outlook appointment」など入れて探すと良いでしょう。書籍:
PyWin32に特化した書籍は多くありませんが、「PythonでWindows自動化」といったテーマの書籍が出ている場合があります。また英語圏ではWin32comの章があるPython本もあります。どちらかというと、Office VBAの書籍を参照し、それをPythonで書き換える練習をするのが実践的です。
A-3. まとめと次のステップ
COMをPythonから操作する方法を一通り学びました。これはゴールではなく始まりです。身の回りのWindows作業で「これを自動化できないかな?」と思うものがあれば、ぜひPyWin32の活用を検討してください。おそらくOfficeに限らず色々なものが見えてくるはずです。
レジストリ操作もPyWin32でできます(win32apiやwin32conモジュール経由)。
WindowsのGUIテスト自動化にはpywinautoというライブラリもありますが、その下層でもCOM(UIAutomation)が使われています。
ExcelやWordを使わずに、オープンソースライブラリで同等のことをする選択肢もあります。例えばopenpyxlやpython-docxで直接ファイルを書き換える方法です。要件に応じて使い分けましょう。
最後に、Python以外でもPowerShellなどでCOMを操作できます。どの言語が最適かはケースバイケースですが、Pythonは総合力が高く、スクリプト言語の中でも人気です。本書の内容を活かして、ぜひ明日からの業務改善に役立てていただければ幸いです。
本書は以上です。お疲れさまでした。