【Python開発記③】完結編：Outlookを自動操作！実用ツールへの仕上げと販売への挑戦

はじめに
ステップ④：format()：本文へのデータ差し込み処理の実装
■ ステップ⑤：pywin32：Outlookを操作してメールを送る
1. ここまでで出来ること（ブログ版の到達点
■ 販売版との主な違い
■ 最後に：エンジニアの挑戦
NINJIN Mailシリーズはこちら

はじめに

こんにちは、ニンジンです。

これまで全3回にわたってお届けしてきた「メール自動化開発記」ですが、いよいよ今回から実用フェーズに入ります。

前回までは、ファイルを選択して記憶させる仕組みを作り、操作のベースとなる部分を整えてきました。いわば「使いやすさの土台づくり」です。

そして今回は、その土台の上に中核機能を実装していきます。

具体的には、

メール本文を自動生成する「差し込み処理」.format()
Outlookを操作してメール送信まで行う「自動化処理」pywin32

この2つ――いわばシステムの“心臓部”を組み込んでいきます。

ステップ④：format()：本文へのデータ差し込み処理の実装

ここでは、GUIで入力したテンプレートに対して、Excelのデータを差し込む処理を作っていきます。

例えば、GUIで「{氏名} 様」という雛形を用意しておき、そこにExcelにある「山田太郎」といったデータを当てはめるイメージです。

このような「文字の差し込み」をシンプルに実現できるのが、Pythonの文字列操作メソッド .format() です。

テンプレートとデータを組み合わせることで、メール本文を自動生成できるようになります。

氏名、アドレス、会社名のデータは
第１回と同じExcelファイルを使用します。

サンプルコード mail-soft-test04.pyはこちらをクリック

import pandas as pd
import tkinter as tk
from tkinter import filedialog, scrolledtext, messagebox
import os
import json

CONFIG_FILE = "config.json"

# --- 設定ファイルの読み書き（前回パスの取得用） ---
def load_config():
    if os.path.exists(CONFIG_FILE):
        with open(CONFIG_FILE, "r", encoding="utf-8") as f:
            return json.load(f)
    return {"last_path": "", "last_file": "未選択"}

def save_config(file_path):
    with open(CONFIG_FILE, "w", encoding="utf-8") as f:
        json.dump({"last_path": os.path.dirname(file_path), "last_file": file_path}, f, ensure_ascii=False, indent=4)

# --- メインGUIクラス ---
class MailerApp:
    def __init__(self, root):
        self.root = root
        self.root.title("展示会メール作成ツール Pro")
        self.root.geometry("700x600")

        # 設定読み込み
        config = load_config()
        self.current_file_path = config.get("last_file", "未選択")

        # 1. ファイル選択エリア
        file_frame = tk.LabelFrame(self.root, text=" 1. 名簿ファイルの指定 ", padx=10, pady=10)
        file_frame.pack(padx=20, pady=10, fill="x")

        self.lbl_path = tk.Label(file_frame, text=f"現在のファイル: {self.current_file_path}", fg="blue", wraplength=500, justify="left")
        self.lbl_path.pack(side="left", padx=5)

        btn_select = tk.Button(file_frame, text="ファイル変更", command=self.select_file)
        btn_select.pack(side="right")

        # 2. 本文入力エリア
        body_frame = tk.LabelFrame(self.root, text=" 2. 本文雛形の作成 ", padx=10, pady=10)
        body_frame.pack(padx=20, pady=10, fill="both", expand=True)

        tk.Label(body_frame, text="{氏名} {会社名} が自動で置換されます").pack(anchor="w")
        self.txt_body = scrolledtext.ScrolledText(body_frame, font=("MS Gothic", 10), height=15, undo=True)
        self.txt_body.pack(fill="both", expand=True, pady=5)
        
        default_text = "{会社名}\n{氏名} 様\n\n昨日はありがとうございました。"
        self.txt_body.insert(tk.END, default_text)

        # 3. 操作ボタンエリア
        btn_frame = tk.Frame(self.root)
        btn_frame.pack(pady=20)

        self.btn_exec = tk.Button(btn_frame, text=" 一括作成（テスト出力） ", command=self.execute, bg="#0078d4", fg="white", width=25, height=2)
        self.btn_exec.pack(side="left", padx=10)

        self.btn_quit = tk.Button(btn_frame, text=" 終了 ", command=self.root.destroy, width=10, height=2)
        self.btn_quit.pack(side="left", padx=10)

    def select_file(self):
        config = load_config()
        initial_dir = config.get("last_path", os.path.expanduser("~"))
        
        file_path = filedialog.askopenfilename(title="Excelを選択", initialdir=initial_dir, filetypes=[("Excel", "*.xlsx")])
        
        if file_path:
            self.current_file_path = file_path
            self.lbl_path.config(text=f"現在のファイル: {file_path}")
            save_config(file_path)

    def execute(self):
        if not os.path.exists(self.current_file_path):
            messagebox.showerror("エラー", "Excelファイルが選択されていないか、存在しません。")
            return

        template = self.txt_body.get("1.0", tk.END).strip()
        
        try:
            df = pd.read_excel(self.current_file_path)
            print("\n" + "="*50 + "\n 送信プレビュー \n" + "="*50)
            for _, row in df.iterrows():
                print(f"TO: {row['アドレス']}")
                print(template.format(**row.to_dict()))
                print("-" * 30)
            messagebox.showinfo("完了", f"{len(df)}件のプレビューをターミナルに出力しました。")
        except Exception as e:
            messagebox.showerror("エラー", f"処理に失敗しました:\n{e}")

if __name__ == "__main__":
    root = tk.Tk()
    app = MailerApp(root)
    root.mainloop()

※VSCodeなどのエディターにてサンプルコードを実行して下さい

コードを実行すると、画像のGUIが立ち上がります。
右上の「ファイル変更」をクリック

Windowが立ち上がります。
対象のExcelファイルを選択し、「開く」をクリック

ファイルが選択されGUIへ戻ります。
一括作成(テスト出力)を押下すると、本文内に記載されている下記の表示箇所にExcelデータが差し込まれます。
{会社名}
{氏名}

出力に成功すると「完了」のダイアログが表示されます

VSCodeのターミナルにて出力されれば成功です！

ここが工夫：`row.to_dict()` の活用

差し込み処理を作っていると、こんな問題が出てきます。
「項目が増えるたびに、プログラムを書き直さないといけない…」
たとえば「役職」や「部署名」といった列をExcelに追加するたびに、コードを修正するのは手間ですよね。

そこで役立つのが、row.to_dict() という書き方です。

これを使うと、Excelの1行分のデータを「項目名＝値」のセットとしてまとめて扱うことができます。
その結果、テンプレート側に
{役職} や {部署名} と書くだけで、自動的に対応するデータが差し込まれるようになります。

つまり――
Excelの列を増やしても、プログラムはそのままでOK。

将来の拡張にも強い、メンテナンス性の高い設計になります。

■ ステップ⑤：pywin32：Outlookを操作してメールを送る

ここでは、いよいよメール送信の自動化を実装していきます。

使用するのは pywin32。
これを使うことで、PythonからOutlookを直接操作できるようになります。

今回のポイントは、これまで作ってきた execute メソッドの中身を、実際のOutlook操作に置き換えることです。

つまり――
今までの「処理の流れ」はそのままに、中身だけを“本物のメール送信”に差し替えるイメージです。

実際にやってみると分かるのですが、
Outlookの操作は驚くほどシンプルです。

「もっと複雑だと思っていたのに…」と感じるくらい、あっけなく動いてしまいます。

この手軽さこそが、pywin32を使う大きなメリットのひとつです。

サンプルコード mail-soft-test05.pyはこちらをクリック

import pandas as pd
import tkinter as tk
from tkinter import filedialog, scrolledtext, messagebox
import os
import json
import win32com.client  # Outlook操作用
import time

CONFIG_FILE = "config.json"

def load_config():
    if os.path.exists(CONFIG_FILE):
        with open(CONFIG_FILE, "r", encoding="utf-8") as f:
            return json.load(f)
    return {"last_path": "", "last_file": "未選択"}

def save_config(file_path):
    with open(CONFIG_FILE, "w", encoding="utf-8") as f:
        json.dump({"last_path": os.path.dirname(file_path), "last_file": file_path}, f, ensure_ascii=False, indent=4)

class MailerApp:
    def __init__(self, root):
        self.root = root
        self.root.title("展示会メール作成ツール Pro")
        self.root.geometry("700x600")

        config = load_config()
        self.current_file_path = config.get("last_file", "未選択")

        # 1. ファイル選択
        file_frame = tk.LabelFrame(self.root, text=" 1. 名簿ファイルの指定 ", padx=10, pady=10)
        file_frame.pack(padx=20, pady=10, fill="x")
        self.lbl_path = tk.Label(file_frame, text=f"現在のファイル: {self.current_file_path}", fg="blue", wraplength=500, justify="left")
        self.lbl_path.pack(side="left", padx=5)
        btn_select = tk.Button(file_frame, text="ファイル変更", command=self.select_file)
        btn_select.pack(side="right")
        
        # 2. 件名入力エリア
        subject_frame = tk.LabelFrame(self.root, text=" 2. 件名の入力 ", padx=10, pady=10)
        subject_frame.pack(padx=20, pady=10, fill="x")

        tk.Label(subject_frame, text="件名を入力してください").pack(anchor="w")
        self.txt_subject = tk.Entry(subject_frame, font=("MS Gothic", 10), width=50)
        self.txt_subject.pack(side="left", padx=5)

        # 3. 本文入力エリア
        body_frame = tk.LabelFrame(self.root, text=" 3. 本文雛形の作成 ", padx=10, pady=10)
        body_frame.pack(padx=20, pady=10, fill="both", expand=True)
        tk.Label(body_frame, text="{氏名} {会社名} が自動で置換されます").pack(anchor="w")
        self.txt_body = scrolledtext.ScrolledText(body_frame, font=("MS Gothic", 10), height=15, undo=True)
        self.txt_body.pack(fill="both", expand=True, pady=5)
        
        default_text = "{会社名}\n{氏名} 様\n\n昨日はありがとうございました。"
        self.txt_body.insert(tk.END, default_text)

        # 4. 操作ボタン
        btn_frame = tk.Frame(self.root)
        btn_frame.pack(pady=20)
        # 初期状態は青
        self.btn_exec = tk.Button(btn_frame, text=" 一括作成（実行） ", command=self.execute, bg="#0078d4", fg="white", width=25, height=2)
        self.btn_exec.pack(side="left", padx=10)
        self.btn_quit = tk.Button(btn_frame, text=" 終了 ", command=self.root.destroy, width=10, height=2)
        self.btn_quit.pack(side="left", padx=10)

    def select_file(self):
        config = load_config()
        initial_dir = config.get("last_path", os.path.expanduser("~"))
        file_path = filedialog.askopenfilename(title="Excelを選択", initialdir=initial_dir, filetypes=[("Excel", "*.xlsx")])
        if file_path:
            self.current_file_path = file_path
            self.lbl_path.config(text=f"現在のファイル: {file_path}")
            save_config(file_path)
            # ファイルを変えたらボタンの色を戻す
            self.reset_button()

    def reset_button(self):
        self.btn_exec.config(text=" 一括作成（実行） ", state="normal", bg="#0078d4", fg="white")

    def execute(self):
        if not os.path.exists(self.current_file_path):
            messagebox.showerror("エラー", "Excelファイルが選択されていません。")
            return

        # ボタンを「送信中」状態にする（黄色・無効化）
        self.btn_exec.config(text="送信中...", state="disabled", bg="#ffc107", fg="black")
        self.root.update()

        template = self.txt_body.get("1.0", tk.END).strip()
        
        try:
            # Outlookの起動
            outlook = win32com.client.Dispatch("Outlook.Application")
            df = pd.read_excel(self.current_file_path)
            
            count = 0
            for _, row in df.iterrows():
                # メール作成
                mail = outlook.CreateItem(0)
                mail.to = row['アドレス']
                mail.Subject = self.txt_subject.get().strip() or "（件名なし）"
                
                # 差し込み処理
                mail.Body = template.format(**row.to_dict())
                
                # 送信（テスト時は .Display() に変えると画面が立ち上がるだけで止まる）
                mail.Send() 
                count += 1
                time.sleep(0.5) # 連続送信による負荷軽減

            # 完了状態にする（緑色）
            self.btn_exec.config(text=f"送信完了（{count}件）", state="normal", bg="#28a745", fg="white")
            messagebox.showinfo("完了", f"全 {count} 件の送信を完了しました。\nOutlookの送信済みアイテムを確認してください。")

        except Exception as e:
            self.reset_button()
            messagebox.showerror("エラー", f"処理に失敗しました:\n{e}")

if __name__ == "__main__":
    root = tk.Tk()
    app = MailerApp(root)
    root.mainloop()