<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>自動化 &#8211; CFXLOG</title>
	<atom:link href="https://cfxlog.com/tag/automation/feed/index.xml" rel="self" type="application/rss+xml" />
	<link>https://cfxlog.com/</link>
	<description></description>
	<lastBuildDate>Thu, 19 Nov 2026 21:55:16 +0000</lastBuildDate>
	<language>ja</language>
	<sy:updatePeriod>
	hourly	</sy:updatePeriod>
	<sy:updateFrequency>
	1	</sy:updateFrequency>
	<generator>https://wordpress.org/?v=7.1.4</generator>

<image>
	<url>https://cfxlog.com/wp-content/uploads/2026/07/cfxlog-favicon-150x150.png</url>
	<title>自動化 &#8211; CFXLOG</title>
	<link>https://cfxlog.com/</link>
	<width>32</width>
	<height>32</height>
</image> 
	<item>
		<title>systemd timerの使い方｜cronの代わりに定期実行する設定と確認方法</title>
		<link>https://cfxlog.com/linux-systemd-timer/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Tue, 03 Nov 2026 00:00:00 +0000</pubDate>
				<category><![CDATA[VPS・サーバー運用]]></category>
		<category><![CDATA[サーバー運用]]></category>
		<category><![CDATA[自動化]]></category>
		<guid isPermaLink="false">https://cfxlog.com/linux-systemd-timer/</guid>

					<description><![CDATA[systemd timer は、.service（何をするか）と .timer（いつするか）の2つのファイルを組で作るだけで使えます。 この記事では、僕の VPS で実際に回している5つのタイマーを例に、書き方と確かめ方 [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>VPS で、証明書の更新やバックアップを決まった時間に自動で動かしたい</li>



<li>cron の代わりに systemd timer を使う方法を知りたい</li>



<li>タイマーがちゃんと動いたのか、結果をどこで見ればいいか分からない</li>
</ul>
</div></div>



<p class="wp-block-paragraph">systemd timer は、<strong>.service（何をするか）と .timer（いつするか）の2つのファイルを組で作る</strong>だけで使えます。</p>



<p class="wp-block-paragraph">この記事では、僕の VPS で実際に回している5つのタイマーを例に、書き方と確かめ方を紹介します。</p>



<p class="wp-block-paragraph">OnCalendar の書式、RandomizedDelaySec・Persistent の意味、cron との違いもまとめます。</p>



<figure class="wp-block-table"><table><thead><tr><th>項目</th><th>内容</th></tr></thead><tbody><tr><td>VPS</td><td>KAGOYA CLOUD VPS（2コア・メモリ2GB）</td></tr><tr><td>OS</td><td>Ubuntu 26.04.1 LTS</td></tr><tr><td>Docker</td><td>Docker Engine 29.9.3・Docker Compose 5.7.0</td></tr></tbody></table><figcaption class="wp-element-caption">この記事の環境（2026年11月19日に確認）</figcaption></figure>



<h2 class="wp-block-heading">僕の VPS で回しているタイマー</h2>



<p class="wp-block-paragraph">いま動かしているのは、次の5つです。中身はどれも、シェルスクリプトを1つ実行するだけです。</p>



<figure class="wp-block-table"><table><thead><tr><th>タイマー</th><th>すること</th><th>いつ</th></tr></thead><tbody><tr><td>証明書の更新</td><td>certbot renew を実行して nginx を reload</td><td><code>daily</code></td></tr><tr><td>Docker の掃除</td><td>72時間より古いビルドキャッシュを削除</td><td><code>weekly</code></td></tr><tr><td>nginx イメージの更新</td><td>固定したタグの修正版を pull し、変わっていたら作り直す</td><td>月3回（早朝）</td></tr><tr><td>ベースイメージの更新</td><td>certbot と PostgreSQL のイメージを pull する</td><td>月3回（早朝。nginx の更新の後）</td></tr><tr><td>DB のバックアップ</td><td>アプリの DB をバックアップし、3世代を残す</td><td>月1回（深夜）</td></tr></tbody></table><figcaption class="wp-element-caption">僕の VPS の systemd タイマー（2026年11月19日）</figcaption></figure>



<p class="wp-block-paragraph">nginx とベースイメージの更新は、同じ時刻に重ならないよう、時間をずらしています。</p>



<h3 class="wp-block-heading">Docker の掃除のスクリプトは1行だけ</h3>



<p class="wp-block-paragraph">たとえば Docker の掃除は、次の1行のスクリプトをタイマーで呼んでいるだけです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">ShellScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>#!/bin/sh
set -eu

docker builder prune -af --filter "until=72h"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955">#!/bin/sh</span></span>
<span class="line"><span style="color: #D4D4D4">set -eu</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">docker builder prune -af --filter "until=72h"</span></span></code></pre></div>



<p class="wp-block-paragraph">VPS でアプリのイメージをビルドしていると、ビルドキャッシュがたまってディスクを使います。これを週に1回消しています。</p>



<h2 class="wp-block-heading">.service と .timer を組で作る</h2>



<p class="wp-block-paragraph">ここからは、証明書の更新を例に、ファイルの書き方を見ていきます。</p>



<p class="wp-block-paragraph">ファイルは <code>/etc/systemd/system/</code> に置きます。<strong>.service と .timer の名前（拡張子の前）をそろえる</strong>と、タイマーが同じ名前のサービスを動かします。</p>



<h3 class="wp-block-heading">.service：何をするかを書く</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">INI</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># /etc/systemd/system/myserver-cert-renew.service
&#91;Unit&#93;
Description=Renew TLS certificates
Requires=docker.service
After=docker.service

&#91;Service&#93;
Type=oneshot
ExecStart=/srv/myserver/renew-certs.sh</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># /etc/systemd/system/myserver-cert-renew.service</span></span>
<span class="line"><span style="color: #D4D4D4">[Unit]</span></span>
<span class="line"><span style="color: #D4D4D4">Description=Renew TLS certificates</span></span>
<span class="line"><span style="color: #D4D4D4">Requires=docker.service</span></span>
<span class="line"><span style="color: #D4D4D4">After=docker.service</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">[Service]</span></span>
<span class="line"><span style="color: #D4D4D4">Type=oneshot</span></span>
<span class="line"><span style="color: #D4D4D4">ExecStart=/srv/myserver/renew-certs.sh</span></span></code></pre></div>



<figure class="wp-block-table"><table><thead><tr><th>項目</th><th>意味</th></tr></thead><tbody><tr><td><code>Requires=docker.service</code></td><td>Docker が動いていることが前提</td></tr><tr><td><code>After=docker.service</code></td><td>Docker が起動してから動かす</td></tr><tr><td><code>Type=oneshot</code></td><td>1回動いて終わる処理（常駐しない）</td></tr><tr><td><code>ExecStart</code></td><td>実行するコマンド（絶対パスで書く）</td></tr></tbody></table><figcaption class="wp-element-caption">.service の主な項目</figcaption></figure>



<p class="wp-block-paragraph">中で docker コマンドを使うので、Docker より先に動かないようにしています。</p>



<h3 class="wp-block-heading">.timer：いつ動かすかを書く</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">INI</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># /etc/systemd/system/myserver-cert-renew.timer
&#91;Unit&#93;
Description=Daily TLS certificate renewal check

&#91;Timer&#93;
OnCalendar=daily
RandomizedDelaySec=1h
Persistent=true

&#91;Install&#93;
WantedBy=timers.target</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># /etc/systemd/system/myserver-cert-renew.timer</span></span>
<span class="line"><span style="color: #D4D4D4">[Unit]</span></span>
<span class="line"><span style="color: #D4D4D4">Description=Daily TLS certificate renewal check</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">[Timer]</span></span>
<span class="line"><span style="color: #D4D4D4">OnCalendar=daily</span></span>
<span class="line"><span style="color: #D4D4D4">RandomizedDelaySec=1h</span></span>
<span class="line"><span style="color: #D4D4D4">Persistent=true</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">[Install]</span></span>
<span class="line"><span style="color: #D4D4D4">WantedBy=timers.target</span></span></code></pre></div>



<p class="wp-block-paragraph">[Timer] に動かす時刻を書き、[Install] の <code>WantedBy=timers.target</code> で、起動時にタイマーが有効になるようにします。</p>



<p class="is-style-icon_info wp-block-paragraph">有効にするのは .timer の方です。.service は enable しません。</p>



<h2 class="wp-block-heading">OnCalendar の書き方</h2>



<p class="wp-block-paragraph">OnCalendar は「<code>曜日 年-月-日 時:分:秒 タイムゾーン</code>」の形で書きます。</p>



<h3 class="wp-block-heading">daily・weekly などの短い書き方</h3>



<p class="wp-block-paragraph">よく使う間隔には、短い書き方があります。</p>



<figure class="wp-block-table"><table><thead><tr><th>書き方</th><th>意味</th></tr></thead><tbody><tr><td><code>daily</code></td><td>毎日 0時0分（<code>*-*-* 00:00:00</code>）</td></tr><tr><td><code>weekly</code></td><td>毎週月曜の 0時0分（<code>Mon *-*-* 00:00:00</code>）</td></tr><tr><td><code>monthly</code></td><td>毎月1日の 0時0分</td></tr></tbody></table><figcaption class="wp-element-caption">OnCalendar の短い書き方</figcaption></figure>



<h3 class="wp-block-heading">日と時刻を指定する</h3>



<p class="wp-block-paragraph">たとえば、毎月5・15・25日の 3時30分に動かすなら、次のように書きます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">INI</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>OnCalendar=*-*-05,15,25 03:30:00 Asia/Tokyo</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">OnCalendar=*-*-05,15,25 03:30:00 Asia/Tokyo</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>*</code> は「すべて」、<code>05,15,25</code> のようにカンマで並べると「そのどれか」です。</p>



<p class="wp-block-paragraph">末尾にタイムゾーンを書くと、サーバーのタイムゾーンの設定に関係なく、日本時間で動きます。</p>



<p class="wp-block-paragraph">月に3回なので、25日から翌月5日までだけは、月の長さによって 8〜11日の間隔になります。</p>



<h3 class="wp-block-heading">systemd-analyze calendar で書式を確かめる</h3>



<p class="wp-block-paragraph">書いた OnCalendar が正しいか、次にいつ動くかは、<code>systemd-analyze calendar</code> で確かめられます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">ShellScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>systemd-analyze calendar "*-*-05,15,25 03:30:00 Asia/Tokyo"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">systemd-analyze calendar "*-*-05,15,25 03:30:00 Asia/Tokyo"</span></span></code></pre></div>



<p class="wp-block-paragraph">正しく読めれば、正規化した書き方（Normalized form）と、次に動く日時（Next elapse）が表示されます。</p>



<p class="wp-block-paragraph">書き間違えていると、エラーになります。タイマーを置く前に確かめておくと安心です。</p>



<h3 class="wp-block-heading">RandomizedDelaySec：開始を少しずらす</h3>



<p class="wp-block-paragraph"><code>RandomizedDelaySec=1h</code> は、決めた時刻から最大1時間の範囲で、毎回ランダムに開始を遅らせる設定です。</p>



<p class="wp-block-paragraph">証明書の更新のように外のサービスへアクセスする処理は、みんなが同じ時刻にアクセスしないよう、ずらしておくのが向いています。</p>



<p class="wp-block-paragraph">僕の証明書の更新は daily で 1時間までずらしているので、11月19日は 0時37分に動いていました。</p>



<h3 class="wp-block-heading">Persistent=true：止まっていた間の分を起動後に動かす</h3>



<p class="wp-block-paragraph"><code>Persistent=true</code> にすると、予定の時刻にサーバーが止まっていた場合、次に起動したときにすぐ1回動きます。</p>



<p class="wp-block-paragraph">月に1回のバックアップのように間隔が長いものは、1回抜けると次まで長く空きます。僕は全部のタイマーに付けています。</p>



<h2 class="wp-block-heading">タイマーを有効にして、動いたか確かめる</h2>



<p class="wp-block-paragraph">ファイルを置いたら、読み込んで有効にします。</p>



<h3 class="wp-block-heading">読み込んで有効にする</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">ShellScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>sudo systemctl daemon-reload
sudo systemctl enable --now myserver-cert-renew.timer</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">sudo systemctl daemon-reload</span></span>
<span class="line"><span style="color: #D4D4D4">sudo systemctl enable --now myserver-cert-renew.timer</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>--now</code> を付けると、有効にするのと同時にタイマーを動かし始めます。</p>



<h3 class="wp-block-heading">systemctl list-timers で次の予定を見る</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">ShellScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>systemctl list-timers</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">systemctl list-timers</span></span></code></pre></div>



<p class="wp-block-paragraph">NEXT（次に動く日時）、LEFT（あとどれくらいか）、LAST（前に動いた日時）、PASSED（それからどれくらいか）が、タイマーごとに並びます。</p>



<p class="wp-block-paragraph">自分のタイマーが一覧にあり、NEXT に日時が入っていれば、予定どおり待っている状態です。</p>



<h3 class="wp-block-heading">手動で1回動かしてみる</h3>



<p class="wp-block-paragraph">タイマーを待たずに試すときは、<strong>.service の方を start</strong> します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">ShellScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>sudo systemctl start myserver-cert-renew.service</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">sudo systemctl start myserver-cert-renew.service</span></span></code></pre></div>



<p class="wp-block-paragraph">僕もタイマーを入れたときに、証明書の更新とバックアップのサービスを手動で動かし、成功することを確かめました。</p>



<h3 class="wp-block-heading">journalctl -u で結果を見る</h3>



<p class="wp-block-paragraph">スクリプトが出した表示は、systemd のログに残ります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">ShellScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>journalctl -u myserver-cert-renew.service -n 50
systemctl status myserver-cert-renew.service</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">journalctl -u myserver-cert-renew.service -n 50</span></span>
<span class="line"><span style="color: #D4D4D4">systemctl status myserver-cert-renew.service</span></span></code></pre></div>



<p class="wp-block-paragraph">スクリプトが 0 以外で終わると、サービスは failed になります。失敗したサービスは、まとめて一覧で見られます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">ShellScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>systemctl --failed</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">systemctl --failed</span></span></code></pre></div>



<p class="wp-block-paragraph">僕の nginx イメージの更新は、新しいイメージで nginx -t が通らなければ、古いイメージのまま動かし続けて 1 で終わるようにしています。</p>



<p class="wp-block-paragraph">こうしておくと、更新しなかったことが failed として残ります。</p>



<p class="is-style-big_icon_caution wp-block-paragraph">失敗したときにメールなどで知らせる仕組みは、まだ作っていません。ときどき list-timers と &#8211;failed を見るようにしてください。</p>



<p class="wp-block-paragraph">長いログを読むときは、less を使うと便利です。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/linux-less-command-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-less-command/">【Linux】lessコマンドでログファイルの中身を閲覧してみよう！</a>
						<span class="p-blogCard__excerpt">Linuxでファイルの中身を確認したい ログファイルを見たい ページごとに閲覧したい このような方に向けて書きました。 Linux でログファイルを閲覧しようと考えたとき、&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">cron との違い</h2>



<p class="wp-block-paragraph">同じことは cron でもできます。違いをまとめると、次のとおりです。</p>



<figure class="wp-block-table"><table><thead><tr><th></th><th>systemd timer</th><th>cron</th></tr></thead><tbody><tr><td>ファイル</td><td>.service と .timer の2つ</td><td>crontab に1行</td></tr><tr><td>ログ</td><td>journalctl -u で見られる</td><td>自分でファイルに出す必要がある</td></tr><tr><td>止まっていた間の分</td><td>Persistent=true で起動後に動く</td><td>動かない</td></tr><tr><td>開始をずらす</td><td>RandomizedDelaySec で書ける</td><td>自分で sleep などを入れる</td></tr><tr><td>前提の指定</td><td>After=docker.service などが書ける</td><td>書けない</td></tr><tr><td>手動で試す</td><td>systemctl start で同じ条件で動く</td><td>コマンドを手で打つ</td></tr></tbody></table><figcaption class="wp-element-caption">systemd timer と cron の違い</figcaption></figure>



<p class="wp-block-paragraph">書くファイルは増えますが、<strong>ログが残る</strong>のと、<strong>止まっていた間の分を取り戻せる</strong>のが大きいです。</p>



<p class="wp-block-paragraph">VPS の運用で、結果を後から確かめたい処理には systemd timer が向いていると思います。</p>



<h3 class="wp-block-heading">Docker の処理を回すときに便利な点</h3>



<p class="wp-block-paragraph">僕のタイマーは、どれも中で docker コマンドを使います。</p>



<p class="wp-block-paragraph"><code>After=docker.service</code> を書いておけば、再起動の直後に Docker より先に動いて失敗する、ということを避けられます。</p>



<p class="wp-block-paragraph">Docker Compose の基本的な使い方は、こちらの記事にまとめています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/docker-compose-guide/">Docker Composeの使い方｜compose.yamlの書き方とコマンド</a>
						<span class="p-blogCard__excerpt">docker run のオプションが長くなって、毎回打つのがつらい Web アプリと DB をまとめて起動・停止したい compose.yaml の depends_on や ports の書き方がよく分からな&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">よくある質問</h2>



<div class="swell-block-faq is-style-faq-border" data-q="fill-custom" data-a="fill-main">
<div class="swell-block-faq__item"><h3 class="faq_q">タイマーを止めたいときは？</h3><div class="faq_a">
<p class="wp-block-paragraph">sudo systemctl disable &#8211;now で、.timer の方を止めます。</p>



<p class="wp-block-paragraph">.service は、タイマーが止まれば呼ばれなくなります。</p>
</div></div>



<div class="swell-block-faq__item"><h3 class="faq_q">OnCalendar の時刻はどのタイムゾーンで動きますか？</h3><div class="faq_a">
<p class="wp-block-paragraph">タイムゾーンを書かなければ、サーバーのタイムゾーンで動きます。</p>



<p class="wp-block-paragraph">末尾に Asia/Tokyo のように書くと、その時刻で動きます。</p>
</div></div>
</div>



<h2 class="wp-block-heading">まとめ：.service と .timer を組で置き、list-timers と journalctl で確かめる</h2>



<p class="wp-block-paragraph">systemd timer は、何をするかを .service に、いつするかを .timer に書いて、.timer を enable すれば動きます。</p>



<p class="wp-block-paragraph">OnCalendar は systemd-analyze calendar で確かめ、動いた結果は list-timers と journalctl -u で見ておけば安心です。</p>



<p class="wp-block-paragraph">証明書の更新そのものの手順は、こちらの記事にあります。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-certbot-https-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-django-certbot-https/">【Django + Let’s Encrypt】CerbotでHTTPS化するための手順</a>
						<span class="p-blogCard__excerpt">ブラウザで警告が表示されてる 暗号化されていないので不安 ユーザー管理しているのでちゃんとしておきたい サイトを公開後にまず取り組むべきは、HTTPS化です。 HTTPS&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">VPS を借りてから Docker で運用するまでの流れは、こちらにまとめています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-vps-roadmap/">個人でVPSを構築する手順まとめ｜借りてからWebサイト公開・Docker運用まで5ステップ</a>
						<span class="p-blogCard__excerpt">個人で VPS を借りたいけど、何から始めればいいか分からない Web サーバーを立てて、自分のサイトを公開するまでの流れを知りたい HTTPS 化や Docker での運用まで、ど&#8230;</span>					</div>
				</div>
			</div>
		</div>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>VBAでOutlookメールを作成・送信する方法｜差し込みと添付を安全に確認</title>
		<link>https://cfxlog.com/vba-outlook-mail-send/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Mon, 26 Oct 2026 00:00:00 +0000</pubDate>
				<category><![CDATA[VBA]]></category>
		<category><![CDATA[Excel自動化]]></category>
		<category><![CDATA[自動化]]></category>
		<guid isPermaLink="false">https://cfxlog.com/vba-outlook-mail-send/</guid>

					<description><![CDATA[まずDisplayで下書きを開き、宛先と本文を目で確かめます。Sendは確認後に明示的に実行する操作として分けます。Windows版Outlookのデスクトップアプリを想定した未実行コードです。 VBA全体の学習順を確認 [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Excelの一覧からOutlookメールの下書きを作りたい</li>



<li>添付や差し込みを行い、送信前に内容を確認したい</li>
</ul>
</div></div>



<p class="wp-block-paragraph">まずDisplayで下書きを開き、宛先と本文を目で確かめます。Sendは確認後に明示的に実行する操作として分けます。Windows版Outlookのデスクトップアプリを想定した未実行コードです。</p>



<p class="wp-block-paragraph">VBA全体の学習順を確認したい場合は、<a href="https://cfxlog.com/vba-guide/">Excel VBA入門ガイド</a>から読めます。</p>



<h2 class="wp-block-heading">全体像：どの方法を使うか</h2>



<p class="wp-block-paragraph">ExcelからOutlookを操作するときは、1件のメールを組み立てる段階と、送信する段階を分けます。宛先を組み立てた後にDisplayで確認する流れを基本にします。</p>



<h3 class="wp-block-heading">目的から選ぶ</h3>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>1件の内容を確認：MailItemを作り、Displayで編集画面を開く</li>



<li>一覧から差し込み：各行を読み、メールを1件ずつ作る</li>



<li>参照設定を配布先ごとに揃えられる：早期バインディングを検討する</li>



<li>参照設定を置きたくない：CreateObjectによる遅延バインディングを使う</li>
</ul>
</div></div>



<h2 class="wp-block-heading">Outlookのメールを1件作る</h2>



<h3 class="wp-block-heading">CreateObjectで下書きを表示する</h3>



<p class="wp-block-paragraph">次は遅延バインディングの例です。Microsoft Outlook Object Libraryへの参照設定がなくてもコンパイルできます。Outlookのインストールと設定は必要です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Option Explicit

Public Sub PreviewOneMail()
    Dim outlookApp As Object
    Dim mail As Object
    Dim attachmentPath As String
    attachmentPath = ThisWorkbook.Path &amp; Application.PathSeparator &amp; "report.pdf"
    If Len(ThisWorkbook.Path) = 0 Then Exit Sub
    If Len(Dir(attachmentPath)) = 0 Then
        MsgBox "添付ファイルがありません"
        Exit Sub
    End If
    Set outlookApp = CreateObject("Outlook.Application")
    Set mail = outlookApp.CreateItem(0)
    With mail
        .To = "recipient@example.com"
        .CC = "copy@example.com"
        .Subject = "報告書の確認"
        .HTMLBody = "&lt;p>報告書をお送りします。&lt;/p>"
        .Attachments.Add attachmentPath
        .Display
    End With
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">Option Explicit</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">Public Sub </span><span style="color: #DCDCAA">PreviewOneMail</span><span style="color: #D4D4D4">()</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> outlookApp </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Object</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> mail </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Object</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> attachmentPath </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">attachmentPath</span><span style="color: #D4D4D4"> = ThisWorkbook.</span><span style="color: #9CDCFE">Path</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #4EC9B0">Application</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">PathSeparator</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #CE9178">&quot;report.pdf&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">Len</span><span style="color: #D4D4D4">(ThisWorkbook.</span><span style="color: #9CDCFE">Path</span><span style="color: #D4D4D4">) = </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Exit Sub</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">Len</span><span style="color: #D4D4D4">(</span><span style="color: #DCDCAA">Dir</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">attachmentPath</span><span style="color: #D4D4D4">)) = </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #DCDCAA">MsgBox</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;添付ファイルがありません&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">Exit Sub</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">End If</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Set </span><span style="color: #9CDCFE">outlookApp</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">CreateObject</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;Outlook.Application&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Set </span><span style="color: #9CDCFE">mail</span><span style="color: #D4D4D4"> = outlookApp.</span><span style="color: #DCDCAA">CreateItem</span><span style="color: #D4D4D4">(</span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">With</span><span style="color: #D4D4D4"> mail</span></span>
<span class="line"><span style="color: #D4D4D4">        .</span><span style="color: #C586C0">To</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;recipient@example.com&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">        .</span><span style="color: #9CDCFE">CC</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;copy@example.com&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">        .</span><span style="color: #9CDCFE">Subject</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;報告書の確認&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">        .</span><span style="color: #9CDCFE">HTMLBody</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;&lt;p&gt;報告書をお送りします。&lt;/p&gt;&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">        .Attachments.</span><span style="color: #DCDCAA">Add</span><span style="color: #D4D4D4"> attachmentPath</span></span>
<span class="line"><span style="color: #D4D4D4">        .Display</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">End</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">With</span></span>
<span class="line"><span style="color: #569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph">To・CCに宛先を設定し、HTMLBodyにはHTMLを書きます。本文に外部入力を埋め込む場合は、HTMLの特殊文字を適切にエスケープしてください。Displayは編集画面を開くだけで送信しません。</p>



<h3 class="wp-block-heading">参照設定と遅延バインディング</h3>



<p class="wp-block-paragraph">早期バインディングならVBEの［ツール］→［参照設定］でOutlookライブラリを選び、Outlook.Applicationなどの型を宣言できます。型の補完が使えますが、参照先の環境差に注意が必要です。上の例はObject型とCreateObjectを使っています。</p>



<h2 class="wp-block-heading">シートの一覧から下書きを作る</h2>



<h3 class="wp-block-heading">まずは全件をDisplayで確認する</h3>



<p class="wp-block-paragraph">Sheet1のA列を宛先、B列を名前、C列を添付ファイルの絶対パスとし、2行目から読みます。空の宛先や存在しない添付は飛ばします。大量行で実行する前に、数行のコピーで試してください。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Option Explicit

Public Sub PreviewMailList()
    Dim outlookApp As Object
    Dim mail As Object
    Dim rowNo As Long
    Dim lastRow As Long
    Dim address As String
    Dim personName As String
    Dim attachmentPath As String
    lastRow = Sheet1.Cells(Sheet1.Rows.Count, 1).End(xlUp).Row
    If lastRow &lt; 2 Then Exit Sub
    Set outlookApp = CreateObject("Outlook.Application")
    For rowNo = 2 To lastRow
        address = Trim(CStr(Sheet1.Cells(rowNo, 1).Value))
        personName = CStr(Sheet1.Cells(rowNo, 2).Value)
        attachmentPath = Trim(CStr(Sheet1.Cells(rowNo, 3).Value))
        If Len(address) > 0 And Len(attachmentPath) > 0 Then
            If Len(Dir(attachmentPath)) > 0 Then
                Set mail = outlookApp.CreateItem(0)
                With mail
                    .To = address
                    .Subject = "資料の送付"
                    .HTMLBody = "&lt;p>" &amp; HtmlEscape(personName) &amp; " 様&lt;/p>&lt;p>資料をご確認ください。&lt;/p>"
                    .Attachments.Add attachmentPath
                    .Display
                End With
            End If
        End If
    Next rowNo
End Sub

Private Function HtmlEscape(ByVal text As String) As String
    text = Replace(text, "&amp;", "&amp;")
    text = Replace(text, "&lt;", "&lt;")
    text = Replace(text, ">", "&gt;")
    text = Replace(text, """", "&quot;")
    HtmlEscape = text
End Function</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">Option Explicit</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">Public Sub </span><span style="color: #DCDCAA">PreviewMailList</span><span style="color: #D4D4D4">()</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> outlookApp </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Object</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> mail </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Object</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> rowNo </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Long</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> lastRow </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Long</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> address </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> personName </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> attachmentPath </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">lastRow</span><span style="color: #D4D4D4"> = Sheet1.</span><span style="color: #DCDCAA">Cells</span><span style="color: #D4D4D4">(Sheet1.Rows.Count, </span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">).</span><span style="color: #DCDCAA">End</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">xlUp</span><span style="color: #D4D4D4">).Row</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">lastRow</span><span style="color: #D4D4D4"> &lt; </span><span style="color: #B5CEA8">2</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Exit Sub</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Set </span><span style="color: #9CDCFE">outlookApp</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">CreateObject</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;Outlook.Application&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">For</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">rowNo</span><span style="color: #D4D4D4"> = </span><span style="color: #B5CEA8">2</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">To</span><span style="color: #D4D4D4"> lastRow</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">address</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">Trim</span><span style="color: #D4D4D4">(</span><span style="color: #DCDCAA">CStr</span><span style="color: #D4D4D4">(Sheet1.</span><span style="color: #DCDCAA">Cells</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">rowNo</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">).</span><span style="color: #9CDCFE">Value</span><span style="color: #D4D4D4">))</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">personName</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">CStr</span><span style="color: #D4D4D4">(Sheet1.</span><span style="color: #DCDCAA">Cells</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">rowNo</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">2</span><span style="color: #D4D4D4">).</span><span style="color: #9CDCFE">Value</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">attachmentPath</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">Trim</span><span style="color: #D4D4D4">(</span><span style="color: #DCDCAA">CStr</span><span style="color: #D4D4D4">(Sheet1.</span><span style="color: #DCDCAA">Cells</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">rowNo</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">3</span><span style="color: #D4D4D4">).</span><span style="color: #9CDCFE">Value</span><span style="color: #D4D4D4">))</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">Len</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">address</span><span style="color: #D4D4D4">) &gt; </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> And </span><span style="color: #DCDCAA">Len</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">attachmentPath</span><span style="color: #D4D4D4">) &gt; </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span></span>
<span class="line"><span style="color: #D4D4D4">            </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">Len</span><span style="color: #D4D4D4">(</span><span style="color: #DCDCAA">Dir</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">attachmentPath</span><span style="color: #D4D4D4">)) &gt; </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span></span>
<span class="line"><span style="color: #D4D4D4">                </span><span style="color: #569CD6">Set </span><span style="color: #9CDCFE">mail</span><span style="color: #D4D4D4"> = outlookApp.</span><span style="color: #DCDCAA">CreateItem</span><span style="color: #D4D4D4">(</span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">                </span><span style="color: #C586C0">With</span><span style="color: #D4D4D4"> mail</span></span>
<span class="line"><span style="color: #D4D4D4">                    .</span><span style="color: #C586C0">To</span><span style="color: #D4D4D4"> =</span><span style="color: #9CDCFE"> address</span></span>
<span class="line"><span style="color: #D4D4D4">                    .</span><span style="color: #9CDCFE">Subject</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;資料の送付&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">                    .</span><span style="color: #9CDCFE">HTMLBody</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;&lt;p&gt;&quot;</span><span style="color: #D4D4D4"> &amp; </span><span style="color: #DCDCAA">HtmlEscape</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">personName</span><span style="color: #D4D4D4">) &amp; </span><span style="color: #CE9178">&quot; 様&lt;/p&gt;&lt;p&gt;資料をご確認ください。&lt;/p&gt;&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">                    .Attachments.</span><span style="color: #DCDCAA">Add</span><span style="color: #D4D4D4"> attachmentPath</span></span>
<span class="line"><span style="color: #D4D4D4">                    .Display</span></span>
<span class="line"><span style="color: #D4D4D4">                </span><span style="color: #DCDCAA">End</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">With</span></span>
<span class="line"><span style="color: #D4D4D4">            </span><span style="color: #C586C0">End If</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">End If</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">Next</span><span style="color: #D4D4D4"> rowNo</span></span>
<span class="line"><span style="color: #569CD6">End Sub</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">Private Function </span><span style="color: #DCDCAA">HtmlEscape</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">ByVal</span><span style="color: #D4D4D4"> text As </span><span style="color: #4EC9B0">String</span><span style="color: #D4D4D4">) As </span><span style="color: #4EC9B0">String</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">text</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">Replace</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">text</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;&amp;&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;&amp;&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">text</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">Replace</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">text</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;&lt;&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;&lt;&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">text</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">Replace</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">text</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;&gt;&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;&gt;&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">text</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">Replace</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">text</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;&quot;&quot;&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;&quot;&quot;)</span></span>
<span class="line"><span style="color: #CE9178">    HtmlEscape = text</span></span>
<span class="line"><span style="color: #CE9178">End Function</span></span></code></pre></div>



<p class="wp-block-paragraph">表示したウィンドウごとに宛先・本文・添付を確認します。確認後に自動で送信する場合は、対象のmailに対してSendを呼びます。最初は手動で送信し、宛先と件数を確認してから切り替えてください。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">VB</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Option Explicit

Public Sub DisplayThenSendExample()
    Dim outlookApp As Object
    Dim mail As Object
    Set outlookApp = CreateObject("Outlook.Application")
    Set mail = outlookApp.CreateItem(0)
    With mail
        .To = "recipient@example.com"
        .Subject = "送信前の確認"
        .Body = "内容を確認してください。"
        .Display
        If MsgBox("宛先と本文を確認しましたか？", vbYesNo + vbQuestion) = vbYes Then
            .Send
        End If
    End With
End Sub</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">Option Explicit</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">Public Sub </span><span style="color: #DCDCAA">DisplayThenSendExample</span><span style="color: #D4D4D4">()</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> outlookApp </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Object</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Dim</span><span style="color: #9CDCFE"> mail </span><span style="color: #D4D4D4">As </span><span style="color: #4EC9B0">Object</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Set </span><span style="color: #9CDCFE">outlookApp</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">CreateObject</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;Outlook.Application&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">Set </span><span style="color: #9CDCFE">mail</span><span style="color: #D4D4D4"> = outlookApp.</span><span style="color: #DCDCAA">CreateItem</span><span style="color: #D4D4D4">(</span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">With</span><span style="color: #D4D4D4"> mail</span></span>
<span class="line"><span style="color: #D4D4D4">        .</span><span style="color: #C586C0">To</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;recipient@example.com&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">        .</span><span style="color: #9CDCFE">Subject</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;送信前の確認&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">        .</span><span style="color: #9CDCFE">Body</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;内容を確認してください。&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">        .Display</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">If</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">MsgBox</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;宛先と本文を確認しましたか？&quot;</span><span style="color: #D4D4D4">,</span><span style="color: #9CDCFE"> vbYesNo</span><span style="color: #D4D4D4"> +</span><span style="color: #9CDCFE"> vbQuestion</span><span style="color: #D4D4D4">) =</span><span style="color: #9CDCFE"> vbYes</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">Then</span></span>
<span class="line"><span style="color: #D4D4D4">            .Send</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">End If</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">End</span><span style="color: #D4D4D4"> </span><span style="color: #C586C0">With</span></span>
<span class="line"><span style="color: #569CD6">End Sub</span></span></code></pre></div>



<p class="wp-block-paragraph">このSubは確認ダイアログで［はい］を選ぶと実際に送信を試みます。送信環境ではテスト宛先で確認し、意図しない送信を避けてください。</p>



<h3 class="wp-block-heading">セキュリティ警告と誤送信</h3>



<p class="wp-block-paragraph">Outlookの設定や管理ポリシーにより、プログラムからのアクセス時に警告が出る場合があります。警告を無効化する前提にせず、宛先・添付・送信件数を確認してください。新しいOutlookではCOM自動化の対応状況が異なるため、利用環境も確認が必要です。</p>



<h2 class="wp-block-heading">実務例：一覧から送信前の下書きを作る</h2>



<h3 class="wp-block-heading">一覧の列と確認順</h3>



<p class="wp-block-paragraph">一覧から差し込む場合は、どの列が宛先、名前、添付なのかを固定します。例ではA列に宛先、B列に名前、C列に添付の絶対パスを置き、1行目を見出しとしています。</p>



<p class="wp-block-paragraph">宛先や添付を含む一覧データを1件ずつ整理したい場合は、<a href="https://cfxlog.com/vba-class-module-guide/">クラスモジュールで値と処理をまとめる方法</a>も参考になります。</p>



<p class="wp-block-paragraph">最初は数行だけをコピーしたテスト用シートで試します。宛先の列ずれや添付ファイルの取り違えは、1件の下書きで気付けば修正できますが、送信後には取り消しが難しくなります。</p>



<p class="wp-block-paragraph">PreviewMailListは空の宛先と存在しない添付を飛ばします。飛ばした行を業務上の失敗として記録したい場合は、行番号と理由を別列へ書く処理を追加してください。</p>



<h3 class="wp-block-heading">HTMLBodyへ名前を入れるとき</h3>



<p class="wp-block-paragraph">HTMLBodyに名前を差し込むとき、名前に<code>&lt;</code>や<code>&amp;</code>が含まれるとHTMLのタグや記号として解釈される可能性があります。例ではHtmlEscapeで特殊文字を置き換えてから本文へ入れます。</p>



<p class="wp-block-paragraph">HTMLを使う必要がなければBodyに普通の文字列を設定する方が簡単です。改行、署名、既存のテンプレートをどう扱うかは、作るメールの運用に合わせて決めます。</p>



<h3 class="wp-block-heading">DisplayからSendへ進む条件</h3>



<p class="wp-block-paragraph">Displayはメールの編集画面を開きます。宛先、CC、件名、本文、添付、送信元アカウントを確認し、誤りがあれば画面で直します。</p>



<p class="wp-block-paragraph">例のDisplayThenSendExampleは確認ダイアログで［はい］を選ぶとSendを呼びます。まずはテスト用メール環境で、どの内容が送られるかと、送信済みアイテムへの保存を確認してください。</p>



<p class="wp-block-paragraph">一覧を一括送信する場合でも、すぐにForループ内へSendを入れるべきではありません。行数を数え、テスト宛先で1件を確認し、必要なら送信前に確認者を置く運用を決めます。</p>



<p class="wp-block-paragraph">差し込み元の表では、空白行、重複した宛先、添付ファイルの取り違えを先に調べます。コードがエラーなく動いても、入力行が間違っていれば正しくない内容のメールを作ってしまいます。</p>



<h2 class="wp-block-heading">よくあるエラーと対処</h2>



<h3 class="wp-block-heading">Outlook.Applicationを作れない</h3>



<p class="wp-block-paragraph">CreateObjectでエラーになる場合は、対応するOutlookがインストールされ、起動やプロファイルの設定が済んでいるかを確認します。Excelのビット数だけで原因を決めつけず、利用しているOutlookの種類も調べます。</p>



<p class="wp-block-paragraph">新しいOutlookでは従来のCOM自動化との対応が異なる可能性があります。まず対象のPCで最小の下書き例を試し、対応状況を確認してから一覧処理へ進めます。</p>



<h3 class="wp-block-heading">添付ファイルが見つからない</h3>



<p class="wp-block-paragraph">パスが相対パスなのか絶対パスなのか、拡張子が正しいかを確認します。例ではDirで存在を調べますが、存在するだけで正しい相手向けのファイルとは限りません。</p>



<p class="wp-block-paragraph">個人ごとに異なる添付を付ける場合は、行の宛先とファイル名が対応しているかを表示したメールで目視します。ファイルの内容に個人情報があるなら、送信前の確認手順を明確にします。</p>



<h3 class="wp-block-heading">警告が表示される</h3>



<p class="wp-block-paragraph">Outlookのセキュリティ設定や管理者のポリシーによって、プログラムからのアクセス時に警告が出る場合があります。警告を回避する前提でコードを組まず、環境の設定と運用ルールを確認します。</p>



<p class="wp-block-paragraph">Displayでの下書き作成でも、端末やポリシーが違えば挙動は変わります。実行した環境、Outlookの種類、警告の文面を控え、必要なら管理者へ相談してください。</p>



<h3 class="wp-block-heading">送信元アカウントが想定と違う</h3>



<p class="wp-block-paragraph">Outlookに複数のアカウントを設定していると、既定の送信元が業務で使いたいアカウントとは限りません。Displayした画面で差出人を確認してください。</p>



<p class="wp-block-paragraph">送信元をコードで指定する場合は、組織のアカウント設定と権限に関わります。送信先だけでなく送信元も、テスト環境と実運用環境の両方で確認します。</p>



<h2 class="wp-block-heading">よくある質問</h2>



<h3 class="wp-block-heading">参照設定は必須ですか？</h3>



<p class="wp-block-paragraph">CreateObjectとObject型を使う遅延バインディングなら、Outlookライブラリの参照設定を追加せずにコンパイルできます。早期バインディングは型の補完が使えるので、開発する環境が揃っているときの選択肢です。</p>



<h3 class="wp-block-heading">DisplayとSendはどう違いますか？</h3>



<p class="wp-block-paragraph">Displayは編集画面を開き、送信しません。Sendはメールを送信処理へ渡します。誤送信を避けるには、最初にDisplayで内容を確かめる流れを使います。</p>



<h3 class="wp-block-heading">CCを複数人に指定できますか？</h3>



<p class="wp-block-paragraph">宛先の文字列へ複数のアドレスを指定できますが、区切り方や解決結果はOutlookで確認してください。複数人へ送るほど漏えいの影響が大きくなるため、CCとBCCの使い分けも確認します。</p>



<h3 class="wp-block-heading">新しいOutlookでも動きますか？</h3>



<p class="wp-block-paragraph">この記事は従来のWindows版Outlookを想定しています。新しいOutlookで同じCOMコードが動くかは未確認なので、利用環境を確かめるまでは適用しないでください。</p>



<h3 class="wp-block-heading">Pythonのwin32comとの違いは？</h3>



<p class="wp-block-paragraph">OutlookのCOMオブジェクトを操作する点は共通ですが、Excelシートから値を読む部分はVBAならExcelのオブジェクトを直接使えます。Pythonから操作する場合はwin32comの記事を参照してください。</p>



<h2 class="wp-block-heading">まとめ：表示して内容を確かめてから送る</h2>



<p class="wp-block-paragraph">Outlook.ApplicationからMailItemを作り、To、CC、Subject、HTMLBody、Attachmentsを設定できます。複数件の差し込みでは、行ごとの宛先と添付の対応を確認します。</p>



<p class="wp-block-paragraph">Displayで下書きを開く段階と、Sendで送る段階を分けてください。テスト用の環境で1件ずつ確認してから実務へ適用します。</p>



<h2 class="wp-block-heading">関連記事</h2>



<h3 class="wp-block-heading">あわせて読みたい記事</h3>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/vba-class-module-guide/">VBAクラスモジュールの使い方｜PropertyとCollectionの実例</a>
						<span class="p-blogCard__excerpt">クラスモジュールを作ったものの、標準モジュールとの違いが分からない Property と Set をどう使うか迷う 注文1件のデータと処理を一緒に扱う例で、クラスモジュールの&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/win32com_outlook_eyecatch-768x403-1-300x157.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-win32com-outlook/">【Python】win32comを使ったOutlook操作のすべて</a>
						<span class="p-blogCard__excerpt">Windows でメール自動化をしたい Python で Outlook を操作したい Windows 環境なら Outlook を操作することで間接的にメールの操作ができます。 とはいえ、Python から&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/vba-userform-dialog-guide/">VBAのMsgBox・InputBox・UserFormを使い分ける完全ガイド｜引数・戻り値・イベント処理まで</a>
						<span class="p-blogCard__excerpt">確認・通知のダイアログを表示したい ユーザーから1つの値を受け取りたい 複数の入力項目をまとめて受け取りたい この記事を読めば、目的に応じてMsgBox・InputBox・Use&#8230;</span>					</div>
				</div>
			</div>
		</div>

<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/vba-guide/">Excel VBA完全入門ガイド｜マクロの基礎から実践まで全ステップ解説</a>
						<span class="p-blogCard__excerpt">VBAって何？マクロとどう違うの？ VBAを始めたいけど、何から手をつければいいかわからない Excelの繰り返し作業を自動化して、残業を減らしたい このような疑問にお答&#8230;</span>					</div>
				</div>
			</div>
		</div>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Python ブラウザ自動化入門｜Selenium・Playwright のインストールと基本操作を解説</title>
		<link>https://cfxlog.com/python-browser-automation/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sat, 04 Apr 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Python]]></category>
		<category><![CDATA[自動化]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=5088</guid>

					<description><![CDATA[このような疑問にお答えします。 Python のブラウザ自動化といえば Selenium と Playwright の2択です。どちらもブラウザを Python から操作できますが、セットアップのしやすさや API の書 [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Python でブラウザを自動で操作したい！</li>



<li>Selenium と Playwright どちらを使えばいい？</li>



<li>インストールから動かすまでの手順を知りたい！</li>
</ul>
</div></div>



<p class="wp-block-paragraph">このような疑問にお答えします。</p>



<p class="wp-block-paragraph">Python のブラウザ自動化といえば <strong>Selenium</strong> と <strong>Playwright</strong> の2択です。どちらもブラウザを Python から操作できますが、セットアップのしやすさや API の書き心地に違いがあります。</p>



<p class="wp-block-paragraph">本記事では両方のインストール方法・基本操作コードを解説し、最後に「どちらを選ぶべきか」の判断軸も紹介します。</p>



<h2 class="wp-block-heading">ブラウザ自動化でできること</h2>



<p class="wp-block-paragraph">ブラウザ自動化とは、Python のコードでブラウザの操作（クリック・入力・スクロール・スクリーンショット取得など）を自動で行う技術です。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>Web スクレイピング</strong><br>JavaScript で動的に生成されるページのデータも取得できる</li>



<li><strong>フォームの自動入力・送信</strong><br>ログイン・検索・申し込みフォームなどを自動で操作</li>



<li><strong>E2E テスト</strong><br>ブラウザ上でのユーザー操作をテストとして実行・検証</li>



<li><strong>スクリーンショット取得</strong><br>ページの見た目をキャプチャして確認・比較</li>
</ul>
</div></div>



<p class="wp-block-paragraph">requests + BeautifulSoup の組み合わせでは取得できない「JavaScript 描画後のコンテンツ」にアクセスできる点が最大のメリットです。</p>



<h2 class="wp-block-heading">Selenium と Playwright の比較</h2>



<p class="wp-block-paragraph">まず2つのライブラリの特徴を整理します。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<figure class="wp-block-table"><table><thead><tr><th></th><th>Selenium</th><th>Playwright</th></tr></thead><tbody><tr><td>開発元</td><td>Selenium プロジェクト</td><td>Microsoft</td></tr><tr><td>初リリース</td><td>2004年</td><td>2020年</td></tr><tr><td>対応ブラウザ</td><td>Chrome / Firefox / Edge / Safari</td><td>Chromium / Firefox / WebKit</td></tr><tr><td>セットアップ</td><td>やや手間（4.x からは改善）</td><td>1コマンドで完結</td></tr><tr><td>待機処理</td><td>明示的な待機が必要になることが多い</td><td>自動待機機能が充実</td></tr><tr><td>実行速度</td><td>標準</td><td>速い</td></tr><tr><td>日本語情報量</td><td>多い（歴史が長い）</td><td>増加中</td></tr></tbody></table></figure>
</div></div>



<p class="wp-block-paragraph">どちらを選ぶかは「情報量の多い Selenium か、現代的な API の Playwright か」という選択です。詳しくは記事の最後で解説します。</p>



<h2 class="wp-block-heading">Selenium の使い方</h2>



<h3 class="wp-block-heading">インストール</h3>



<p class="wp-block-paragraph">pip でインストールします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pip install selenium</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">pip</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">selenium</span></span></code></pre></div>



<p class="wp-block-paragraph">uv を使っている場合はこちらです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>uv add selenium</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">uv</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">add</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">selenium</span></span></code></pre></div>



<p class="wp-block-paragraph">Selenium 4.6 以降は Chrome のドライバー（ChromeDriver）を別途インストールする必要がなくなりました。<code>webdriver.Chrome()</code> を呼ぶだけで自動的に適切なドライバーが取得されます。</p>



<h3 class="wp-block-heading">ページを開いてタイトルを取得する</h3>



<p class="wp-block-paragraph">まずは最もシンプルな例として、ページを開いてタイトルを表示してみます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from selenium import webdriver

# Chrome を起動
driver = webdriver.Chrome()

# ページを開く
driver.get("https://example.com/")

# タイトルを取得して表示
print(driver.title)  # Example Domain

# ブラウザを閉じる
driver.quit()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> selenium </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> webdriver</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># Chrome を起動</span></span>
<span class="line"><span style="color: #D4D4D4">driver = webdriver.Chrome()</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># ページを開く</span></span>
<span class="line"><span style="color: #D4D4D4">driver.get(</span><span style="color: #CE9178">&quot;https://example.com&quot;/</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># タイトルを取得して表示</span></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(driver.title)  </span><span style="color: #6A9955"># Example Domain</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># ブラウザを閉じる</span></span>
<span class="line"><span style="color: #D4D4D4">driver.quit()</span></span></code></pre></div>



<p class="wp-block-paragraph">実行すると Chrome が起動してページが表示されます。<code>driver.quit()</code> を忘れるとブラウザが開いたままになるので注意してください。</p>



<h3 class="wp-block-heading">要素を取得してクリックする</h3>



<p class="wp-block-paragraph">ページ上の要素（ボタン・リンクなど）を取得してクリックするには <code>find_element()</code> を使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from selenium import webdriver
from selenium.webdriver.common.by import By

driver = webdriver.Chrome()
driver.get("https://example.com/")

# CSS セレクタで要素を取得してクリック
link = driver.find_element(By.CSS_SELECTOR, "a")
link.click()

print(driver.current_url)

driver.quit()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> selenium </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> webdriver</span></span>
<span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> selenium.webdriver.common.by </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> By</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">driver = webdriver.Chrome()</span></span>
<span class="line"><span style="color: #D4D4D4">driver.get(</span><span style="color: #CE9178">&quot;https://example.com&quot;/</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># CSS セレクタで要素を取得してクリック</span></span>
<span class="line"><span style="color: #D4D4D4">link = driver.find_element(By.CSS_SELECTOR, </span><span style="color: #CE9178">&quot;a&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">link.click()</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(driver.current_url)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">driver.quit()</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>By.CSS_SELECTOR</code> 以外にも、<code>By.ID</code> / <code>By.CLASS_NAME</code> / <code>By.XPATH</code> などで要素を指定できます。</p>



<h3 class="wp-block-heading">テキストを入力してフォームを送信する</h3>



<p class="wp-block-paragraph">検索フォームやログインフォームへの入力は <code>send_keys()</code> で行います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.common.keys import Keys

driver = webdriver.Chrome()
driver.get("https://www.google.com/")

# 検索ボックスを取得してキーワードを入力
search_box = driver.find_element(By.NAME, "q")
search_box.send_keys("Python 自動化")

# Enter キーを送信
search_box.send_keys(Keys.RETURN)

# ページタイトルを表示
print(driver.title)

driver.quit()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> selenium </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> webdriver</span></span>
<span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> selenium.webdriver.common.by </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> By</span></span>
<span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> selenium.webdriver.common.keys </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> Keys</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">driver = webdriver.Chrome()</span></span>
<span class="line"><span style="color: #D4D4D4">driver.get(</span><span style="color: #CE9178">&quot;https://www.google.com&quot;/</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># 検索ボックスを取得してキーワードを入力</span></span>
<span class="line"><span style="color: #D4D4D4">search_box = driver.find_element(By.NAME, </span><span style="color: #CE9178">&quot;q&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">search_box.send_keys(</span><span style="color: #CE9178">&quot;Python 自動化&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># Enter キーを送信</span></span>
<span class="line"><span style="color: #D4D4D4">search_box.send_keys(Keys.RETURN)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># ページタイトルを表示</span></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(driver.title)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">driver.quit()</span></span></code></pre></div>



<h3 class="wp-block-heading">要素の待機（WebDriverWait）</h3>



<p class="wp-block-paragraph">JavaScript で動的にコンテンツが読み込まれるページでは、要素が存在するまで待機する処理が必要です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

driver = webdriver.Chrome()
driver.get("https://example.com/")

# 最大10秒待って要素が表示されるまで待機
wait = WebDriverWait(driver, 10)
element = wait.until(
    EC.presence_of_element_located((By.ID, "result"))
)

print(element.text)

driver.quit()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> selenium </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> webdriver</span></span>
<span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> selenium.webdriver.common.by </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> By</span></span>
<span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> selenium.webdriver.support.ui </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> WebDriverWait</span></span>
<span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> selenium.webdriver.support </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> expected_conditions </span><span style="color: #C586C0">as</span><span style="color: #D4D4D4"> EC</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">driver = webdriver.Chrome()</span></span>
<span class="line"><span style="color: #D4D4D4">driver.get(</span><span style="color: #CE9178">&quot;https://example.com&quot;/</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># 最大10秒待って要素が表示されるまで待機</span></span>
<span class="line"><span style="color: #D4D4D4">wait = WebDriverWait(driver, </span><span style="color: #B5CEA8">10</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">element = wait.until(</span></span>
<span class="line"><span style="color: #D4D4D4">    EC.presence_of_element_located((By.ID, </span><span style="color: #CE9178">&quot;result&quot;</span><span style="color: #D4D4D4">))</span></span>
<span class="line"><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(element.text)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">driver.quit()</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>time.sleep()</code> で固定秒数を待つ方法もありますが、無駄な待機が発生します。<code>WebDriverWait</code> を使って「要素が現れたら即座に次の処理へ」進む書き方が推奨です。</p>



<h2 class="wp-block-heading">Playwright の使い方</h2>



<h3 class="wp-block-heading">インストール</h3>



<p class="wp-block-paragraph">Playwright のインストールは2ステップです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pip install playwright
playwright install</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">pip</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">playwright</span></span>
<span class="line"><span style="color: #DCDCAA">playwright</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>playwright install</code> を実行すると Chromium・Firefox・WebKit の3ブラウザが一括でダウンロードされます。uv の場合は <code>uv add playwright</code> のあとに同じく <code>playwright install</code> を実行します。</p>



<h3 class="wp-block-heading">ページを開いてタイトルを取得する</h3>



<p class="wp-block-paragraph">Playwright には同期 API（<code>sync_playwright</code>）と非同期 API（<code>async_playwright</code>）があります。入門としては同期 API が書きやすいのでこちらを使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch()
    page = browser.new_page()

    # ページを開く
    page.goto("https://example.com/")

    # タイトルを取得して表示
    print(page.title())  # Example Domain

    browser.close()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> playwright.sync_api </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> sync_playwright</span></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">with</span><span style="color: #D4D4D4"> sync_playwright() </span><span style="color: #C586C0">as</span><span style="color: #D4D4D4"> p:</span></span>
<span class="line"><span style="color: #D4D4D4">    browser = p.chromium.launch()</span></span>
<span class="line"><span style="color: #D4D4D4">    page = browser.new_page()</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955"># ページを開く</span></span>
<span class="line"><span style="color: #D4D4D4">    page.goto(</span><span style="color: #CE9178">&quot;https://example.com&quot;/</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955"># タイトルを取得して表示</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(page.title())  </span><span style="color: #6A9955"># Example Domain</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    browser.close()</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>with</code> ブロックを使うことでブラウザの後片付けが確実に行われます。Selenium と比べてコードがすっきりしているのが特徴です。</p>



<h3 class="wp-block-heading">要素を取得してクリックする</h3>



<p class="wp-block-paragraph">Playwright では <code>page.locator()</code> で要素を指定します。Selenium の <code>find_element()</code> に相当する操作です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch()
    page = browser.new_page()

    page.goto("https://example.com/")

    # CSS セレクタで要素を取得してクリック
    page.locator("a").click()

    print(page.url)

    browser.close()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> playwright.sync_api </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> sync_playwright</span></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">with</span><span style="color: #D4D4D4"> sync_playwright() </span><span style="color: #C586C0">as</span><span style="color: #D4D4D4"> p:</span></span>
<span class="line"><span style="color: #D4D4D4">    browser = p.chromium.launch()</span></span>
<span class="line"><span style="color: #D4D4D4">    page = browser.new_page()</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    page.goto(</span><span style="color: #CE9178">&quot;https://example.com&quot;/</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955"># CSS セレクタで要素を取得してクリック</span></span>
<span class="line"><span style="color: #D4D4D4">    page.locator(</span><span style="color: #CE9178">&quot;a&quot;</span><span style="color: #D4D4D4">).click()</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(page.url)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    browser.close()</span></span></code></pre></div>



<h3 class="wp-block-heading">テキストを入力してフォームを送信する</h3>



<p class="wp-block-paragraph">Playwright ではテキスト入力に <code>page.fill()</code>、クリックに <code>page.click()</code> を使います。待機処理は自動で行われるので、Selenium のような明示的な <code>WebDriverWait</code> は不要です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch()
    page = browser.new_page()

    page.goto("https://www.google.com/")

    # 検索ボックスにテキストを入力
    page.fill("textarea&#91;name='q'&#93;", "Python 自動化")

    # ボタンをクリック
    page.keyboard.press("Enter")

    # 検索結果が表示されるまで自動待機
    page.wait_for_load_state("networkidle")

    print(page.title())

    browser.close()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> playwright.sync_api </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> sync_playwright</span></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">with</span><span style="color: #D4D4D4"> sync_playwright() </span><span style="color: #C586C0">as</span><span style="color: #D4D4D4"> p:</span></span>
<span class="line"><span style="color: #D4D4D4">    browser = p.chromium.launch()</span></span>
<span class="line"><span style="color: #D4D4D4">    page = browser.new_page()</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    page.goto(</span><span style="color: #CE9178">&quot;https://www.google.com&quot;/</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955"># 検索ボックスにテキストを入力</span></span>
<span class="line"><span style="color: #D4D4D4">    page.fill(</span><span style="color: #CE9178">&quot;textarea&#91;name=&apos;q&apos;&#93;&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;Python 自動化&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955"># ボタンをクリック</span></span>
<span class="line"><span style="color: #D4D4D4">    page.keyboard.press(</span><span style="color: #CE9178">&quot;Enter&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955"># 検索結果が表示されるまで自動待機</span></span>
<span class="line"><span style="color: #D4D4D4">    page.wait_for_load_state(</span><span style="color: #CE9178">&quot;networkidle&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(page.title())</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    browser.close()</span></span></code></pre></div>



<h3 class="wp-block-heading">スクリーンショットを取得する</h3>



<p class="wp-block-paragraph">Playwright ではスクリーンショット取得が1行で書けます。ページ全体を画像として保存したいときに便利です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch()
    page = browser.new_page()

    page.goto("https://example.com/")

    # ページ全体のスクリーンショットを保存
    page.screenshot(path="screenshot.png", full_page=True)

    browser.close()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> playwright.sync_api </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> sync_playwright</span></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">with</span><span style="color: #D4D4D4"> sync_playwright() </span><span style="color: #C586C0">as</span><span style="color: #D4D4D4"> p:</span></span>
<span class="line"><span style="color: #D4D4D4">    browser = p.chromium.launch()</span></span>
<span class="line"><span style="color: #D4D4D4">    page = browser.new_page()</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    page.goto(</span><span style="color: #CE9178">&quot;https://example.com&quot;/</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955"># ページ全体のスクリーンショットを保存</span></span>
<span class="line"><span style="color: #D4D4D4">    page.screenshot(</span><span style="color: #9CDCFE">path</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;screenshot.png&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">full_page</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">True</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    browser.close()</span></span></code></pre></div>



<h2 class="wp-block-heading">Selenium と Playwright どちらを選ぶべきか</h2>



<p class="wp-block-paragraph">用途と状況によって使い分けるのが現実的です。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>Selenium を選ぶ場合</strong><br>日本語情報が多く、既存の業務スクリプトとの互換性が必要なとき。ネット上のサンプルコードが Selenium ベースのものが多いため、初心者が躓いたときに情報を探しやすい</li>



<li><strong>Playwright を選ぶ場合</strong><br>新規プロジェクトで書き心地と速度を重視するとき。自動待機・スクリーンショット・マルチブラウザテストなど、モダンな機能が最初から揃っている</li>
</ul>
</div></div>



<p class="wp-block-paragraph">僕自身は業務自動化スクリプトで Selenium を長く使ってきましたが、最近の新規スクリプトは Playwright で書くことが増えました。待機処理を自分で書かなくていい点が特にラクです。</p>



<p class="wp-block-paragraph">「とりあえず動かしてみたい」という入門段階では、どちらを選んでも本記事のコードを試せます。まず動かしてみて、書き心地の合う方を選ぶのが一番です。</p>



<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">本記事では Python のブラウザ自動化ライブラリ Selenium と Playwright の基本操作を解説しました。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>Selenium</strong>：4.6 以降は ChromeDriver 不要・<code>webdriver.Chrome()</code> で即起動できる</li>



<li><strong>Playwright</strong>：<code>pip install playwright</code> + <code>playwright install</code> の2ステップで完結・自動待機が便利</li>



<li>どちらも「ページを開く→要素を取得→クリック・入力」の流れは同じ</li>



<li>新規プロジェクトなら Playwright・既存コードとの互換重視なら Selenium を選ぶとよい</li>
</ul>
</div></div>



<p class="wp-block-paragraph">ブラウザ自動化を覚えると、日常の繰り返し作業を大幅に削減できます。本記事のコードをそのまま実行してみるところから始めてみてください。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【完全ガイド】Python で Word を自動操作する【win32com 】</title>
		<link>https://cfxlog.com/python-win32com-word/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Tue, 30 Dec 2025 15:00:00 +0000</pubDate>
				<category><![CDATA[Python]]></category>
		<category><![CDATA[ファイル操作]]></category>
		<category><![CDATA[自動化]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=4902</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-win32com-word.jpg" class="webfeedsFeaturedVisual" /></p>Windows環境でWordがインストールされている方向けの記事です。 win32com を活用すれば、Word 文書（.docx / .doc / .rtf）を生成・編集・検索置換・表作成・画像挿入・PDF変換までフル [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-win32com-word.jpg" class="webfeedsFeaturedVisual" /></p>
<p class="wp-block-paragraph">Windows環境でWordがインストールされている方向けの記事です。</p>



<p class="wp-block-paragraph"><code>win32com</code> を活用すれば、Word 文書（.docx / .doc / .rtf）を<strong>生成・編集・検索置換・表作成・画像挿入・PDF変換</strong>までフルに自動化できます。</p>



<p class="wp-block-paragraph">本記事では、その方法をご紹介します。</p>



<h2 class="wp-block-heading">1. 事前準備（pywin32 インストール）</h2>



<h3 class="wp-block-heading">pywin32 のインストール</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pip install pywin32</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">pip install pywin32</span></span></code></pre></div>



<h3 class="wp-block-heading">Word を起動する基本コード</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from win32com.client import Dispatch, constants

word = Dispatch("Word.Application")
word.Visible = True</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> win32com.client </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> Dispatch, constants</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">word = Dispatch(</span><span style="color: #CE9178">&quot;Word.Application&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">word.Visible = </span><span style="color: #569CD6">True</span></span></code></pre></div>



<h3 class="wp-block-heading">Word を終了</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>word.Quit()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">word.Quit()</span></span></code></pre></div>



<h2 class="wp-block-heading">2. Word.Application・Documents 操作</h2>



<h3 class="wp-block-heading">文書を新規作成</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc = word.Documents.Add()
doc.Content.Text = "Hello from Python!"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc = word.Documents.Add()</span></span>
<span class="line"><span style="color: #D4D4D4">doc.Content.Text = </span><span style="color: #CE9178">&quot;Hello from Python!&quot;</span></span></code></pre></div>



<h3 class="wp-block-heading">既存文書を開く</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc = word.Documents.Open(r"C:\path\to\doc.docx")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc = word.Documents.Open(</span><span style="color: #569CD6">r</span><span style="color: #D16969">&quot;C:</span><span style="color: #D7BA7D">\p</span><span style="color: #D16969">ath</span><span style="color: #D7BA7D">\t</span><span style="color: #D16969">o\doc.docx&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h3 class="wp-block-heading">上書き保存 / 別名保存</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc.Save()  # 上書き

doc.SaveAs(r"C:\path\to\new.docx")  # 別名保存</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc.Save()  </span><span style="color: #6A9955"># 上書き</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">doc.SaveAs(</span><span style="color: #569CD6">r</span><span style="color: #D16969">&quot;C:</span><span style="color: #D7BA7D">\p</span><span style="color: #D16969">ath</span><span style="color: #D7BA7D">\t</span><span style="color: #D16969">o</span><span style="color: #D7BA7D">\n</span><span style="color: #D16969">ew.docx&quot;</span><span style="color: #D4D4D4">)  </span><span style="color: #6A9955"># 別名保存</span></span></code></pre></div>



<h3 class="wp-block-heading">PDF として保存</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>wdFormatPDF = 17
doc.SaveAs(r"C:\path\to\out.pdf", FileFormat=wdFormatPDF)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">wdFormatPDF = </span><span style="color: #B5CEA8">17</span></span>
<span class="line"><span style="color: #D4D4D4">doc.SaveAs(</span><span style="color: #569CD6">r</span><span style="color: #D16969">&quot;C:</span><span style="color: #D7BA7D">\p</span><span style="color: #D16969">ath</span><span style="color: #D7BA7D">\t</span><span style="color: #D16969">o</span><span style="color: #D7BA7D">\o</span><span style="color: #D16969">ut.pdf&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">FileFormat</span><span style="color: #D4D4D4">=wdFormatPDF)</span></span></code></pre></div>



<p class="wp-block-paragraph">変換したPDFから、今度は逆にテキストを抽出したり中身を操作したりしたい場合は、PyPDFを使うと便利です。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/python-pypdf-guide-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-pypdf-guide/">pypdfの使い方｜インストール・テキスト抽出・結合・分割を解説</a>
						<span class="p-blogCard__excerpt">Python で PDF を扱いたい！ テキスト抽出・結合・分割を自動化したい！ PyPDF と PyPDF2 の違いが知りたい！ PyPDF2 の古いコードを pypdf に書き換えたい！ このよう&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">文書を閉じる</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc.Close(SaveChanges=False)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc.Close(</span><span style="color: #9CDCFE">SaveChanges</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">False</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h2 class="wp-block-heading">3. Range / Selection の基本操作</h2>



<h3 class="wp-block-heading">文書全体のテキスト取得・書き込み</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>text = doc.Content.Text
doc.Content.Text = "上書き内容"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">text = doc.Content.Text</span></span>
<span class="line"><span style="color: #D4D4D4">doc.Content.Text = </span><span style="color: #CE9178">&quot;上書き内容&quot;</span></span></code></pre></div>



<h3 class="wp-block-heading">文末に追記する</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>end = doc.Content.End
doc.Range(end, end).InsertAfter("\n追記しました")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">end = doc.Content.End</span></span>
<span class="line"><span style="color: #D4D4D4">doc.Range(end, end).InsertAfter(</span><span style="color: #CE9178">&quot;</span><span style="color: #D7BA7D">\n</span><span style="color: #CE9178">追記しました&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h3 class="wp-block-heading">文頭に挿入</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc.Range(0, 0).InsertBefore("=== 先頭に追記 ===\n")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc.Range(</span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">).InsertBefore(</span><span style="color: #CE9178">&quot;=== 先頭に追記 ===</span><span style="color: #D7BA7D">\n</span><span style="color: #CE9178">&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h3 class="wp-block-heading">書式設定（太字・色・サイズ）</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>rng = doc.Range(0, 10)
rng.Font.Bold = True
rng.Font.Color = 255
rng.Font.Size = 16</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">rng = doc.Range(</span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">10</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">rng.Font.Bold = </span><span style="color: #569CD6">True</span></span>
<span class="line"><span style="color: #D4D4D4">rng.Font.Color = </span><span style="color: #B5CEA8">255</span></span>
<span class="line"><span style="color: #D4D4D4">rng.Font.Size = </span><span style="color: #B5CEA8">16</span></span></code></pre></div>



<h2 class="wp-block-heading">4. 検索・置換（Find / Replace）</h2>



<h3 class="wp-block-heading">単純置換（文書全体）</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>find = doc.Content.Find
find.Text = "旧社名"
find.Replacement.Text = "新社名"
find.Execute(Replace=constants.wdReplaceAll)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">find = doc.Content.Find</span></span>
<span class="line"><span style="color: #D4D4D4">find.Text = </span><span style="color: #CE9178">&quot;旧社名&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">find.Replacement.Text = </span><span style="color: #CE9178">&quot;新社名&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">find.Execute(</span><span style="color: #9CDCFE">Replace</span><span style="color: #D4D4D4">=constants.wdReplaceAll)</span></span></code></pre></div>



<h3 class="wp-block-heading">ワイルドカード（正規表現風）の利用</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>find = doc.Content.Find
find.Text = "&#91;0-9&#93;{4}/&#91;0-9&#93;{2}/&#91;0-9&#93;{2}"
find.MatchWildcards = True
find.Replacement.Text = "****/**/**"
find.Execute(Replace=constants.wdReplaceAll)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">find = doc.Content.Find</span></span>
<span class="line"><span style="color: #D4D4D4">find.Text = </span><span style="color: #CE9178">&quot;&#91;0-9&#93;</span><span style="color: #569CD6">{4}</span><span style="color: #CE9178">/&#91;0-9&#93;</span><span style="color: #569CD6">{2}</span><span style="color: #CE9178">/&#91;0-9&#93;</span><span style="color: #569CD6">{2}</span><span style="color: #CE9178">&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">find.MatchWildcards = </span><span style="color: #569CD6">True</span></span>
<span class="line"><span style="color: #D4D4D4">find.Replacement.Text = </span><span style="color: #CE9178">&quot;****/**/**&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">find.Execute(</span><span style="color: #9CDCFE">Replace</span><span style="color: #D4D4D4">=constants.wdReplaceAll)</span></span></code></pre></div>



<h2 class="wp-block-heading">5. 段落操作</h2>



<h3 class="wp-block-heading">段落を列挙する</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>for p in doc.Paragraphs:
    print(p.Range.Text)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">for</span><span style="color: #D4D4D4"> p </span><span style="color: #C586C0">in</span><span style="color: #D4D4D4"> doc.Paragraphs:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(p.Range.Text)</span></span></code></pre></div>



<h3 class="wp-block-heading">段落の書式設定</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>p = doc.Paragraphs(1)
p.Alignment = constants.wdAlignParagraphCenter
p.Range.Font.Bold = True
p.Range.Font.Size = 14</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">p = doc.Paragraphs(</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">p.Alignment = constants.wdAlignParagraphCenter</span></span>
<span class="line"><span style="color: #D4D4D4">p.Range.Font.Bold = </span><span style="color: #569CD6">True</span></span>
<span class="line"><span style="color: #D4D4D4">p.Range.Font.Size = </span><span style="color: #B5CEA8">14</span></span></code></pre></div>



<h3 class="wp-block-heading">改行を挿入</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc.Range().InsertParagraphAfter()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc.Range().InsertParagraphAfter()</span></span></code></pre></div>



<h2 class="wp-block-heading">6. 箇条書き・番号リスト</h2>



<h3 class="wp-block-heading">箇条書きにする</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>p = doc.Paragraphs.Add()
p.Range.Text = "箇条書き項目"
p.Range.ListFormat.ApplyBulletDefault()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">p = doc.Paragraphs.Add()</span></span>
<span class="line"><span style="color: #D4D4D4">p.Range.Text = </span><span style="color: #CE9178">&quot;箇条書き項目&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">p.Range.ListFormat.ApplyBulletDefault()</span></span></code></pre></div>



<h3 class="wp-block-heading">番号付きリストにする</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>p = doc.Paragraphs.Add()
p.Range.Text = "番号リスト項目"
p.Range.ListFormat.ApplyNumberDefault()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">p = doc.Paragraphs.Add()</span></span>
<span class="line"><span style="color: #D4D4D4">p.Range.Text = </span><span style="color: #CE9178">&quot;番号リスト項目&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">p.Range.ListFormat.ApplyNumberDefault()</span></span></code></pre></div>



<h2 class="wp-block-heading">7. 表（Table）操作</h2>



<h3 class="wp-block-heading">表を作成する</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>table = doc.Tables.Add(
    Range=doc.Range(0, 0),
    NumRows=3,
    NumColumns=3
)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">table = doc.Tables.Add(</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">Range</span><span style="color: #D4D4D4">=doc.Range(</span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">),</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">NumRows</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">3</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">NumColumns</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">3</span></span>
<span class="line"><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h3 class="wp-block-heading">セルへ値を設定</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>table.Cell(1, 1).Range.Text = "商品名"
table.Cell(1, 2).Range.Text = "数量"
table.Cell(1, 3).Range.Text = "金額"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">table.Cell(</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">).Range.Text = </span><span style="color: #CE9178">&quot;商品名&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">table.Cell(</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">2</span><span style="color: #D4D4D4">).Range.Text = </span><span style="color: #CE9178">&quot;数量&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">table.Cell(</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">3</span><span style="color: #D4D4D4">).Range.Text = </span><span style="color: #CE9178">&quot;金額&quot;</span></span></code></pre></div>



<h3 class="wp-block-heading">行・列を追加</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>table.Rows.Add()
table.Columns.Add()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">table.Rows.Add()</span></span>
<span class="line"><span style="color: #D4D4D4">table.Columns.Add()</span></span></code></pre></div>



<h3 class="wp-block-heading">ヘッダー行の書式設定</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>header = table.Rows(1)
header.Range.Font.Bold = True
header.Shading.BackgroundPatternColor = 12632256</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">header = table.Rows(</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">header.Range.Font.Bold = </span><span style="color: #569CD6">True</span></span>
<span class="line"><span style="color: #D4D4D4">header.Shading.BackgroundPatternColor = </span><span style="color: #B5CEA8">12632256</span></span></code></pre></div>



<h2 class="wp-block-heading">8. 画像・図形の挿入</h2>



<h3 class="wp-block-heading">画像を挿入</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>inline = doc.Range(0, 0).InlineShapes.AddPicture(
    FileName=r"C:\path\image.png",
    LinkToFile=False,
    SaveWithDocument=True
)
inline.Width = 300
inline.Height = 200</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">inline = doc.Range(</span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">).InlineShapes.AddPicture(</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">FileName</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">r</span><span style="color: #D16969">&quot;C:</span><span style="color: #D7BA7D">\p</span><span style="color: #D16969">ath</span><span style="color: #D7BA7D">\i</span><span style="color: #D16969">mage.png&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">LinkToFile</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">False</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">SaveWithDocument</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">True</span></span>
<span class="line"><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">inline.Width = </span><span style="color: #B5CEA8">300</span></span>
<span class="line"><span style="color: #D4D4D4">inline.Height = </span><span style="color: #B5CEA8">200</span></span></code></pre></div>



<h3 class="wp-block-heading">図形（シェイプ）を追加</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>shape = doc.Shapes.AddShape(
    Type=1,
    Left=50,
    Top=50,
    Width=200,
    Height=100
)
shape.TextFrame.TextRange.Text = "図形のテキスト"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">shape = doc.Shapes.AddShape(</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">Type</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">Left</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">50</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">Top</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">50</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">Width</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">200</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">Height</span><span style="color: #D4D4D4">=</span><span style="color: #B5CEA8">100</span></span>
<span class="line"><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">shape.TextFrame.TextRange.Text = </span><span style="color: #CE9178">&quot;図形のテキスト&quot;</span></span></code></pre></div>



<h2 class="wp-block-heading">9. ヘッダー・フッター操作</h2>



<h3 class="wp-block-heading">ヘッダーを編集する</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>section = doc.Sections(1)
header = section.Headers(constants.wdHeaderFooterPrimary)
header.Range.Text = "会社名：Python自動化株式会社"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">section = doc.Sections(</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">header = section.Headers(constants.wdHeaderFooterPrimary)</span></span>
<span class="line"><span style="color: #D4D4D4">header.Range.Text = </span><span style="color: #CE9178">&quot;会社名：Python自動化株式会社&quot;</span></span></code></pre></div>



<h3 class="wp-block-heading">フッター（ページ番号）</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>footer = section.Footers(constants.wdHeaderFooterPrimary)
footer.Range.Text = "Page "
footer.PageNumbers.Add(constants.wdAlignParagraphRight)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">footer = section.Footers(constants.wdHeaderFooterPrimary)</span></span>
<span class="line"><span style="color: #D4D4D4">footer.Range.Text = </span><span style="color: #CE9178">&quot;Page &quot;</span></span>
<span class="line"><span style="color: #D4D4D4">footer.PageNumbers.Add(constants.wdAlignParagraphRight)</span></span></code></pre></div>



<h2 class="wp-block-heading">10. スタイル操作</h2>



<h3 class="wp-block-heading">見出しスタイルを適用</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc.Range(0, 10).Style = "見出し 1"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc.Range(</span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">10</span><span style="color: #D4D4D4">).Style = </span><span style="color: #CE9178">&quot;見出し 1&quot;</span></span></code></pre></div>



<h3 class="wp-block-heading">カスタムスタイルの作成</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>styles = doc.Styles
st = styles.Add("PythonTitle", constants.wdStyleTypeParagraph)
st.Font.Size = 20
st.Font.Bold = True
st.ParagraphFormat.Alignment = constants.wdAlignParagraphCenter</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">styles = doc.Styles</span></span>
<span class="line"><span style="color: #D4D4D4">st = styles.Add(</span><span style="color: #CE9178">&quot;PythonTitle&quot;</span><span style="color: #D4D4D4">, constants.wdStyleTypeParagraph)</span></span>
<span class="line"><span style="color: #D4D4D4">st.Font.Size = </span><span style="color: #B5CEA8">20</span></span>
<span class="line"><span style="color: #D4D4D4">st.Font.Bold = </span><span style="color: #569CD6">True</span></span>
<span class="line"><span style="color: #D4D4D4">st.ParagraphFormat.Alignment = constants.wdAlignParagraphCenter</span></span></code></pre></div>



<h2 class="wp-block-heading">11. 差し込み文書（Mail Merge）</h2>



<h3 class="wp-block-heading">テンプレートとデータソースを紐付ける</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc = word.Documents.Open(r"C:\template.docx")
doc.MailMerge.OpenDataSource(
    Name=r"C:\data.xlsx",
    ConfirmConversions=False,
    ReadOnly=True
)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc = word.Documents.Open(</span><span style="color: #569CD6">r</span><span style="color: #D16969">&quot;C:</span><span style="color: #D7BA7D">\t</span><span style="color: #D16969">emplate.docx&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">doc.MailMerge.OpenDataSource(</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">Name</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">r</span><span style="color: #D16969">&quot;C:\data.xlsx&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">ConfirmConversions</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">False</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">ReadOnly</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">True</span></span>
<span class="line"><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h3 class="wp-block-heading">差し込み処理を実行</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc.MailMerge.Execute()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc.MailMerge.Execute()</span></span></code></pre></div>



<h2 class="wp-block-heading">12. コメント・変更履歴</h2>



<h3 class="wp-block-heading">コメントを追加</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc.Comments.Add(doc.Range(0, 10), "ここを修正")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc.Comments.Add(doc.Range(</span><span style="color: #B5CEA8">0</span><span style="color: #D4D4D4">, </span><span style="color: #B5CEA8">10</span><span style="color: #D4D4D4">), </span><span style="color: #CE9178">&quot;ここを修正&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h3 class="wp-block-heading">変更履歴をオンにする</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc.TrackRevisions = True</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc.TrackRevisions = </span><span style="color: #569CD6">True</span></span></code></pre></div>



<h3 class="wp-block-heading">履歴の一括承認／拒否</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc.AcceptAllRevisions()
# doc.RejectAllRevisions()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc.AcceptAllRevisions()</span></span>
<span class="line"><span style="color: #6A9955"># doc.RejectAllRevisions()</span></span></code></pre></div>



<h2 class="wp-block-heading">13. 文書比較（Compare）</h2>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>doc1 = word.Documents.Open(r"C:\old.docx")
doc2 = word.Documents.Open(r"C:\new.docx")

result = word.CompareDocuments(doc1, doc2)
result.SaveAs(r"C:\comparison.docx")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">doc1 = word.Documents.Open(</span><span style="color: #569CD6">r</span><span style="color: #D16969">&quot;C:</span><span style="color: #D7BA7D">\o</span><span style="color: #D16969">ld.docx&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">doc2 = word.Documents.Open(</span><span style="color: #569CD6">r</span><span style="color: #D16969">&quot;C:</span><span style="color: #D7BA7D">\n</span><span style="color: #D16969">ew.docx&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">result = word.CompareDocuments(doc1, doc2)</span></span>
<span class="line"><span style="color: #D4D4D4">result.SaveAs(</span><span style="color: #569CD6">r</span><span style="color: #D16969">&quot;C:</span><span style="color: #D7BA7D">\c</span><span style="color: #D16969">omparison.docx&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h2 class="wp-block-heading">14. その他：アプリケーション制御</h2>



<h3 class="wp-block-heading">警告を抑制</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>word.DisplayAlerts = False</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">word.DisplayAlerts = </span><span style="color: #569CD6">False</span></span></code></pre></div>



<h3 class="wp-block-heading">Word を安全に終了（finally）</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>try:
    word = Dispatch("Word.Application")
    doc = word.Documents.Open(r"C:\doc.docx")

finally:
    doc.Close(SaveChanges=False)
    word.Quit()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">try</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    word = Dispatch(</span><span style="color: #CE9178">&quot;Word.Application&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    doc = word.Documents.Open(</span><span style="color: #569CD6">r</span><span style="color: #D16969">&quot;C:\doc.docx&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">finally</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    doc.Close(</span><span style="color: #9CDCFE">SaveChanges</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">False</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    word.Quit()</span></span></code></pre></div>



<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">Word は Excel や Outlook と比べてもテンプレ書類が多く、<strong>自動化の効果が大きい分野</strong>です。</p>



<div class="wp-block-group has-border -border04"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>契約書テンプレへ自動差し込み</li>



<li>Word → PDF 自動生成</li>



<li>表・画像・図形・スタイル操作</li>



<li>変更履歴・コメント・文書比較</li>



<li>MailMerge（差し込み文書）</li>
</ul>
</div></div>



<p class="wp-block-paragraph">まで、<strong>業務用書類の自動生成</strong>を Python で完結できます。</p>



<p class="wp-block-paragraph">ぜひ、本記事の内容を参考に自動化に取り組んでみてください。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【Python】win32comを使ったOutlook操作のすべて</title>
		<link>https://cfxlog.com/python-win32com-outlook/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sat, 25 Feb 2023 15:00:00 +0000</pubDate>
				<category><![CDATA[Python]]></category>
		<category><![CDATA[自動化]]></category>
		<guid isPermaLink="false">https://www.cfxlog.com/?p=187</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/win32com_outlook_eyecatch-768x403-1.jpg" class="webfeedsFeaturedVisual" /></p>Windows 環境なら Outlook を操作することで間接的にメールの操作ができます。 とはいえ、Python から Outlook を直接触ることができないので、ここでは win32com というライブラリを使って [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/win32com_outlook_eyecatch-768x403-1.jpg" class="webfeedsFeaturedVisual" /></p>
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Windows でメール自動化をしたい</li>



<li>Python で Outlook を操作したい</li>
</ul>
</div></div>



<p class="wp-block-paragraph">Windows 環境なら <strong>Outlook を操作することで間接的にメールの操作ができます</strong>。</p>



<p class="wp-block-paragraph">とはいえ、Python から Outlook を直接触ることができないので、ここでは win32com というライブラリを使って操作していきます。</p>



<p class="wp-block-paragraph">本記事の内容は以下のとおりです。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>本記事の内容</span></div><div class="cap_box_content">
<ul class="wp-block-list">
<li>準備編</li>



<li>メールの作成と操作</li>



<li>メールから情報抽出</li>
</ul>
</div></div>



<p class="wp-block-paragraph">どの操作でも「準備編」の内容は必要になりますので、こちらは必ず目をお通しください。</p>



<p class="wp-block-paragraph">win32com で Excel を自動化する方法も興味がある方はどうぞ。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/AdobeStock_504301962-768x446-1-300x174.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-win32com-excel/">【Python × Excel自動化】openpyxlでグラフが消える問題を解決｜win32comで書式を保持して操作する方法</a>
						<span class="p-blogCard__excerpt">Python の Excel 系ライブラリは openpyxl が有名です。 ところが、openpyxl はグラフや罫線などが消えてしまう不具合があり、クライアントワークなどで安全に自動化し&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="is-style-icon_info wp-block-paragraph">Windows 環境のみ使える方法です。<br>他のOSをお使いの場合は別の方法をお試しください。</p>



<h2 class="wp-block-heading">【準備編】 Outlook でメール作業を自動化する</h2>



<p class="wp-block-paragraph">まずは、Python で Outlook を操作する準備をしましょう。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>準備の内容</span></div><div class="cap_box_content">
<ol class="wp-block-list is-style-num_circle">
<li>ライブラリのインストール</li>



<li>Outlook アプリケーションの呼出</li>



<li>メールフォルダの設定</li>
</ol>
</div></div>



<p class="wp-block-paragraph">① はコマンドライン上のお話なので、最初の一度だけ行います。</p>



<p class="wp-block-paragraph">一方、② と ③ は Python コード内のお話になりますので、Outlook を使いたい場合に毎回コードを書くことになります。</p>



<h3 class="wp-block-heading">1. ライブラリのインストール</h3>



<p class="wp-block-paragraph">まずはコマンドプロンプトで以下を実行してください。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pip install pywin32</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#DCDCAA">pip</span><span style="color:#CE9178"> install</span><span style="color:#CE9178"> pywin32</span></span></code></pre></div>



<p class="wp-block-paragraph">これにより、Python 上から Outlook が操作できるモジュール win32com が使えるようになります。</p>



<p class="wp-block-paragraph">なお、最近の開発では pip ではなく Poetry が使われることも増えてきました。<br>興味のある方はチャレンジしてみてください。</p>



<p class="wp-block-paragraph"><a href="https://cfxlog.com/python-poetry-guide/">» パッケージ管理ツール &#8220;Poetry&#8221; の使いかた</a></p>



<p class="is-style-icon_info wp-block-paragraph">ライブラリ名は win32com ではなく、pywin32 です。<br>間違いやすいのでご注意ください。</p>



<h3 class="wp-block-heading">2. Outlook アプリケーションの呼出</h3>



<p class="wp-block-paragraph">Python から Outlook を呼び出すコードは次の通りです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import win32com.client

# OutlookAPP のインスタンス化
outlook = win32com.client.Dispatch("Outlook.Application")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> win32com.client</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># OutlookAPP のインスタンス化</span></span>
<span class="line"><span style="color:#D4D4D4">outlook = win32com.client.Dispatch(</span><span style="color:#CE9178">"Outlook.Application"</span><span style="color:#D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">4行目の outlook が「Outlook アプリケーションの実態」です。</p>



<p class="wp-block-paragraph">この後の自動化コードはすべて、この Outlook アプリケーションに対して処理を加えていく流れになります。</p>



<h3 class="wp-block-heading">3. メールフォルダの設定</h3>



<p class="wp-block-paragraph">「受信トレイ」や「下書きフォルダ」など、Outlook 内のフォルダに対して処理を行いたい場合があると思います。</p>



<p class="wp-block-paragraph">その場合には、以下のような形でフォルダを定義します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import win32com.client

# OutlookAPP のインスタンス化
outlook = win32com.client.Dispatch("Outlook.Application")
namespace = outlook.GetNamespace("MAPI")
draft_folder = namespace.GetDefaultFolder(16)  # 16: 下書き</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> win32com.client</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># OutlookAPP のインスタンス化</span></span>
<span class="line"><span style="color:#D4D4D4">outlook = win32com.client.Dispatch(</span><span style="color:#CE9178">"Outlook.Application"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">namespace = outlook.GetNamespace(</span><span style="color:#CE9178">"MAPI"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">draft_folder = namespace.GetDefaultFolder(</span><span style="color:#B5CEA8">16</span><span style="color:#D4D4D4">)  </span><span style="color:#6A9955"># 16: 下書き</span></span></code></pre></div>



<p class="wp-block-paragraph">namespace は、<strong>Outlook 上に登録されているアカウントに関する情報が丸ごと格納されているオブジェクト</strong>と考えるとわかりやすいです。</p>



<p class="wp-block-paragraph">namespace を呼び出しておくと、今回のようなフォルダへのアクセス、アカウント情報の取得、カレンダー情報へのアクセスなども可能になります。</p>



<p class="wp-block-paragraph">ここでは<strong>GetDefaultFolder() メソッドを使ってフォルダオブジェクトを取得してきた</strong>というわけです。</p>



<p class="wp-block-paragraph">以下は、よく使うフォルダの番号です。</p>



<figure class="wp-block-table"><table><thead><tr><th>フォルダ名</th><th>番号</th></tr></thead><tbody><tr><td>受信トレイ</td><td>6</td></tr><tr><td>送信トレイ&nbsp;</td><td>4</td></tr><tr><td>送信済みアイテム</td><td>5</td></tr><tr><td>下書き</td><td>16</td></tr><tr><td>迷惑メール</td><td>23</td></tr></tbody></table><figcaption class="wp-element-caption">フォルダごとの番号</figcaption></figure>



<p class="wp-block-paragraph">そのほかにも様々なフォルダ番号が用意されていますので、公式ドキュメントの方も確認してみてください。</p>



<p class="is-style-icon_announce wp-block-paragraph"><a href="https://learn.microsoft.com/ja-jp/office/vba/api/outlook.oldefaultfolders">» Microsoft 公式ドキュメント:  OlDefaultFolders 列挙 (Outlook)</a></p>



<h2 class="wp-block-heading">【実践編 1】メールの作成と操作</h2>



<p class="wp-block-paragraph">これにて Python で Outlook を動かす準備が整いました。</p>



<p class="wp-block-paragraph">続いて、次の内容を解説します。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list is-style-check_list">
<li>メールを作成して下書きに保存する</li>



<li>メールを送信する</li>



<li>装飾つきのメールを送信する</li>
</ul>
</div></div>



<h3 class="wp-block-heading">メールを作成して下書きに保存する</h3>



<p class="wp-block-paragraph">「メールを作成して、下書きに保存する」という基本的なコードをお伝えします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import win32com.client

# OutlookAPP のインスタンス化
outlook = win32com.client.Dispatch("outlook.application")
mapi = outlook.GetNamespace("MAPI")
draft_folder = mapi.GetDefaultFolder(16)  # 16: 下書き

# メールオブジェクトの作成
mail = outlook.CreateItem(0)  # 0: メールアイテム
mail.To = "xxx@example.com"
mail.Subject = "件名"
mail.Body = "これはテストメールです。"
mail.Attachments.Add(r"C:\Users\username\somefile.csv")

# 下書きフォルダに保存
mail.Save()
mail.Move(draft_folder)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> win32com.client</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># OutlookAPP のインスタンス化</span></span>
<span class="line"><span style="color:#D4D4D4">outlook = win32com.client.Dispatch(</span><span style="color:#CE9178">"outlook.application"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">mapi = outlook.GetNamespace(</span><span style="color:#CE9178">"MAPI"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">draft_folder = mapi.GetDefaultFolder(</span><span style="color:#B5CEA8">16</span><span style="color:#D4D4D4">)  </span><span style="color:#6A9955"># 16: 下書き</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># メールオブジェクトの作成</span></span>
<span class="line"><span style="color:#D4D4D4">mail = outlook.CreateItem(</span><span style="color:#B5CEA8">0</span><span style="color:#D4D4D4">)  </span><span style="color:#6A9955"># 0: メールアイテム</span></span>
<span class="line"><span style="color:#D4D4D4">mail.To = </span><span style="color:#CE9178">"xxx@example.com"</span></span>
<span class="line"><span style="color:#D4D4D4">mail.Subject = </span><span style="color:#CE9178">"件名"</span></span>
<span class="line"><span style="color:#D4D4D4">mail.Body = </span><span style="color:#CE9178">"これはテストメールです。"</span></span>
<span class="line"><span style="color:#D4D4D4">mail.Attachments.Add(</span><span style="color:#569CD6">r</span><span style="color:#D16969">"C:</span><span style="color:#D7BA7D">\U</span><span style="color:#D16969">sers</span><span style="color:#D7BA7D">\u</span><span style="color:#D16969">sername\somefile.csv"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># 下書きフォルダに保存</span></span>
<span class="line"><span style="color:#D4D4D4">mail.Save()</span></span>
<span class="line"><span style="color:#D4D4D4">mail.Move(draft_folder)</span></span></code></pre></div>



<p class="wp-block-paragraph">メールの作成でキモになるのは outlook.CreateItem(0) の部分です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># メールオブジェクトの作成
mail = outlook.CreateItem(0)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># メールオブジェクトの作成</span></span>
<span class="line"><span style="color:#D4D4D4">mail = outlook.CreateItem(</span><span style="color:#B5CEA8">0</span><span style="color:#D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">これにより、一通のまっさらなメールが変数 mail の中に生成されます。</p>



<p class="wp-block-paragraph">もちろんこの段階では「宛先」「件名」「本文」「添付ファイル」などは設定されていません。</p>



<p class="wp-block-paragraph">そこで、この mail オブジェクトにプロパティを付加していきます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># プロパティを設定
mail.To = "xxx@example.com"
mail.Subject = "件名"
mail.Body = "これはテストメールです。"
mail.Attachments.Add(r"C:\Users\username\somefile.csv")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># プロパティを設定</span></span>
<span class="line"><span style="color:#D4D4D4">mail.To = </span><span style="color:#CE9178">"xxx@example.com"</span></span>
<span class="line"><span style="color:#D4D4D4">mail.Subject = </span><span style="color:#CE9178">"件名"</span></span>
<span class="line"><span style="color:#D4D4D4">mail.Body = </span><span style="color:#CE9178">"これはテストメールです。"</span></span>
<span class="line"><span style="color:#D4D4D4">mail.Attachments.Add(</span><span style="color:#569CD6">r</span><span style="color:#D16969">"C:</span><span style="color:#D7BA7D">\U</span><span style="color:#D16969">sers</span><span style="color:#D7BA7D">\u</span><span style="color:#D16969">sername\somefile.csv"</span><span style="color:#D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">ここまでくると mail オブジェクトには「宛先」「件名」「本文」「添付ファイル」が設定された状態になります。</p>



<p class="wp-block-paragraph">最後に下書きフォルダに保存します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 下書きフォルダに保存
mail.Save()
mail.Move(draft_folder)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># 下書きフォルダに保存</span></span>
<span class="line"><span style="color:#D4D4D4">mail.Save()</span></span>
<span class="line"><span style="color:#D4D4D4">mail.Move(draft_folder)</span></span></code></pre></div>



<p class="wp-block-paragraph">mail オブジェクトはまだ実体がないので、先に mail.Save() として保存をします。</p>



<p class="wp-block-paragraph">mail オブジェクトの実体が作られたところで、Move() メソッドにより下書きフォルダに移動しました。</p>



<h3 class="wp-block-heading">メールを送信する</h3>



<p class="wp-block-paragraph">下書き保存ができるようになれば、送信は簡単です。</p>



<p class="wp-block-paragraph">Excel VBAからOutlookを操作する場合は、<a href="https://cfxlog.com/vba-outlook-mail-send/">VBAでメールの下書きと添付を確認する方法</a>を参照してください。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import win32com.client

# OutlookAPP のインスタンス化
outlook = win32com.client.Dispatch("outlook.application")
mapi = outlook.GetNamespace("MAPI")

# メールオブジェクトの作成
mail = outlook.CreateItem(0)  # 0: メールアイテム
mail.To = "xxx@example.com"
mail.Subject = "件名"
mail.Body = "これはテストメールです。"
mail.Attachments.Add(r"C:\Users\username\somefile.csv")

# 送信
mail.Send()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> win32com.client</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># OutlookAPP のインスタンス化</span></span>
<span class="line"><span style="color:#D4D4D4">outlook = win32com.client.Dispatch(</span><span style="color:#CE9178">"outlook.application"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">mapi = outlook.GetNamespace(</span><span style="color:#CE9178">"MAPI"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># メールオブジェクトの作成</span></span>
<span class="line"><span style="color:#D4D4D4">mail = outlook.CreateItem(</span><span style="color:#B5CEA8">0</span><span style="color:#D4D4D4">)  </span><span style="color:#6A9955"># 0: メールアイテム</span></span>
<span class="line"><span style="color:#D4D4D4">mail.To = </span><span style="color:#CE9178">"xxx@example.com"</span></span>
<span class="line"><span style="color:#D4D4D4">mail.Subject = </span><span style="color:#CE9178">"件名"</span></span>
<span class="line"><span style="color:#D4D4D4">mail.Body = </span><span style="color:#CE9178">"これはテストメールです。"</span></span>
<span class="line"><span style="color:#D4D4D4">mail.Attachments.Add(</span><span style="color:#569CD6">r</span><span style="color:#D16969">"C:</span><span style="color:#D7BA7D">\U</span><span style="color:#D16969">sers</span><span style="color:#D7BA7D">\u</span><span style="color:#D16969">sername\somefile.csv"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># 送信</span></span>
<span class="line"><span style="color:#D4D4D4">mail.Send()</span></span></code></pre></div>



<p class="wp-block-paragraph">作成したメールオブジェクトに対して Send() メソッドで送信しましょう。</p>



<h3 class="wp-block-heading">装飾つきのメールを送信する</h3>



<p class="wp-block-paragraph">メール本文に装飾をつけたい場合には、HTML形式にします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import win32com.client

# OutlookAPP のインスタンス化
outlook = win32com.client.Dispatch("outlook.application")
mapi = outlook.GetNamespace("MAPI")

# メールオブジェクトの作成
mail = outlook.CreateItem(0)  # 0: メールアイテム
mail.bodyFormat = 2  # HTML形式
mail.To = "xxx@example.com"
mail.Subject = "件名"
mail.HTMLBody = """&lt;h1&gt;見出し&lt;/h1&gt;&lt;p style="color: red;"&gt;テキストが入ります。&lt;/p&gt;"""
mail.Attachments.Add(r"C:\Users\username\somefile.csv")

# 送信
mail.Send()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> win32com.client</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># OutlookAPP のインスタンス化</span></span>
<span class="line"><span style="color:#D4D4D4">outlook = win32com.client.Dispatch(</span><span style="color:#CE9178">"outlook.application"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">mapi = outlook.GetNamespace(</span><span style="color:#CE9178">"MAPI"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># メールオブジェクトの作成</span></span>
<span class="line"><span style="color:#D4D4D4">mail = outlook.CreateItem(</span><span style="color:#B5CEA8">0</span><span style="color:#D4D4D4">)  </span><span style="color:#6A9955"># 0: メールアイテム</span></span>
<span class="line"><span style="color:#D4D4D4">mail.bodyFormat = </span><span style="color:#B5CEA8">2</span><span style="color:#6A9955">  # HTML形式</span></span>
<span class="line"><span style="color:#D4D4D4">mail.To = </span><span style="color:#CE9178">"xxx@example.com"</span></span>
<span class="line"><span style="color:#D4D4D4">mail.Subject = </span><span style="color:#CE9178">"件名"</span></span>
<span class="line"><span style="color:#D4D4D4">mail.HTMLBody = </span><span style="color:#CE9178">"""&lt;h1>見出し&lt;/h1>&lt;p style="color: red;">テキストが入ります。&lt;/p>"""</span></span>
<span class="line"><span style="color:#D4D4D4">mail.Attachments.Add(</span><span style="color:#569CD6">r</span><span style="color:#D16969">"C:</span><span style="color:#D7BA7D">\U</span><span style="color:#D16969">sers</span><span style="color:#D7BA7D">\u</span><span style="color:#D16969">sername\somefile.csv"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># 送信</span></span>
<span class="line"><span style="color:#D4D4D4">mail.Send()</span></span></code></pre></div>



<p class="wp-block-paragraph">メールを HTML 形式にするポイントは次の2つです。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>HTML 形式にするポイント</span></div><div class="cap_box_content">
<ol class="wp-block-list is-style-num_circle">
<li>mail.bodyFormat を 2 にする</li>



<li>本文の指定は HTMLBody を使う</li>
</ol>
</div></div>



<p class="wp-block-paragraph">特に<strong>HTMLBody を使うことは忘れてしまいがち</strong>なので、特に注意しましょう。</p>



<p class="wp-block-paragraph">本文には HTML タグを使って記述すれば、色をつけたり見出しをつけたりなどリッチな表現ができます。</p>



<h3 class="wp-block-heading">メールに画像を埋め込む方法</h3>



<p class="wp-block-paragraph">本来「メール」というものはテキストデータのみを送受信する想定で作られているため、本文に画像を埋め込みたい場合には一手間が必要になります。</p>



<p class="wp-block-paragraph">結論として、<strong>画像データは base64 でバイナリ化して埋め込みます</strong>。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import base64
import win32com.client as win32

def image_file_to_base64(file_path):
    """画像 =&gt; base64"""
    with open(file_path, "rb") as image_file:
        base64_obj = base64.b64encode(image_file.read())
        base64_str = base64_obj.decode("utf-8")
        return base64_str

# OutlookAPP のインスタンス化
outlook = win32com.client.Dispatch("outlook.application")
mapi = outlook.GetNamespace("MAPI")

# メールオブジェクトの作成
mail = outlook.CreateItem(0)  # 0: メールアイテム
mail.bodyFormat = 2  # HTML形式
mail.To = "xxx@example.com"
mail.Subject = "件名"
picture = image_file_to_base64(r"C:\Users\username\image.jpg")
mail.HTMLBody = f"""&lt;img src="data:image/jpg;base64,{picture}" /&gt;"""

# 送信
mail.Send()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> base64</span></span>
<span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> win32com.client </span><span style="color:#C586C0">as</span><span style="color:#D4D4D4"> win32</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">def</span><span style="color:#DCDCAA"> image_file_to_base64</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">file_path</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#CE9178">    """画像 => base64"""</span></span>
<span class="line"><span style="color:#C586C0">    with</span><span style="color:#DCDCAA"> open</span><span style="color:#D4D4D4">(file_path, </span><span style="color:#CE9178">"rb"</span><span style="color:#D4D4D4">) </span><span style="color:#C586C0">as</span><span style="color:#D4D4D4"> image_file:</span></span>
<span class="line"><span style="color:#D4D4D4">        base64_obj = base64.b64encode(image_file.read())</span></span>
<span class="line"><span style="color:#D4D4D4">        base64_str = base64_obj.decode(</span><span style="color:#CE9178">"utf-8"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#C586C0">        return</span><span style="color:#D4D4D4"> base64_str</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># OutlookAPP のインスタンス化</span></span>
<span class="line"><span style="color:#D4D4D4">outlook = win32com.client.Dispatch(</span><span style="color:#CE9178">"outlook.application"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">mapi = outlook.GetNamespace(</span><span style="color:#CE9178">"MAPI"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># メールオブジェクトの作成</span></span>
<span class="line"><span style="color:#D4D4D4">mail = outlook.CreateItem(</span><span style="color:#B5CEA8">0</span><span style="color:#D4D4D4">)  </span><span style="color:#6A9955"># 0: メールアイテム</span></span>
<span class="line"><span style="color:#D4D4D4">mail.bodyFormat = </span><span style="color:#B5CEA8">2</span><span style="color:#6A9955">  # HTML形式</span></span>
<span class="line"><span style="color:#D4D4D4">mail.To = </span><span style="color:#CE9178">"xxx@example.com"</span></span>
<span class="line"><span style="color:#D4D4D4">mail.Subject = </span><span style="color:#CE9178">"件名"</span></span>
<span class="line"><span style="color:#D4D4D4">picture = image_file_to_base64(</span><span style="color:#569CD6">r</span><span style="color:#D16969">"C:</span><span style="color:#D7BA7D">\U</span><span style="color:#D16969">sers</span><span style="color:#D7BA7D">\u</span><span style="color:#D16969">sername</span><span style="color:#D7BA7D">\i</span><span style="color:#D16969">mage.jpg"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">mail.HTMLBody = </span><span style="color:#569CD6">f</span><span style="color:#CE9178">"""&lt;img src="data:image/jpg;base64,</span><span style="color:#569CD6">{</span><span style="color:#D4D4D4">picture</span><span style="color:#569CD6">}</span><span style="color:#CE9178">" />"""</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># 送信</span></span>
<span class="line"><span style="color:#D4D4D4">mail.Send()</span></span></code></pre></div>



<p class="wp-block-paragraph">HTML の &lt;img src&gt; タグに画像を指定する際、バイナリデータを直接指定しています。</p>



<h3 class="wp-block-heading">添付ファイルを付けて送信する</h3>



<p class="wp-block-paragraph">先ほどの装飾つきメールの例でも軽く登場していましたが、添付ファイルは Attachments.Add() にファイルパスを渡すだけで追加できます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import win32com.client

# OutlookAPP のインスタンス化
outlook = win32com.client.Dispatch("outlook.application")
mapi = outlook.GetNamespace("MAPI")

# メールオブジェクトの作成
mail = outlook.CreateItem(0)  # 0: メールアイテム
mail.To = "xxx@example.com"
mail.Subject = "件名"
mail.Body = "本文"

# 添付ファイルを追加
mail.Attachments.Add(r"C:\Users\username\report.xlsx")

# 送信
mail.Send()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> win32com.client</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># OutlookAPP のインスタンス化</span></span>
<span class="line"><span style="color:#D4D4D4">outlook = win32com.client.Dispatch(</span><span style="color:#CE9178">"outlook.application"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">mapi = outlook.GetNamespace(</span><span style="color:#CE9178">"MAPI"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># メールオブジェクトの作成</span></span>
<span class="line"><span style="color:#D4D4D4">mail = outlook.CreateItem(</span><span style="color:#B5CEA8">0</span><span style="color:#D4D4D4">)  </span><span style="color:#6A9955"># 0: メールアイテム</span></span>
<span class="line"><span style="color:#D4D4D4">mail.To = </span><span style="color:#CE9178">"xxx@example.com"</span></span>
<span class="line"><span style="color:#D4D4D4">mail.Subject = </span><span style="color:#CE9178">"件名"</span></span>
<span class="line"><span style="color:#D4D4D4">mail.Body = </span><span style="color:#CE9178">"本文"</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># 添付ファイルを追加</span></span>
<span class="line"><span style="color:#D4D4D4">mail.Attachments.Add(</span><span style="color:#569CD6">r</span><span style="color:#D16969">"C:</span><span style="color:#D7BA7D">\U</span><span style="color:#D16969">sers</span><span style="color:#D7BA7D">\u</span><span style="color:#D16969">sername</span><span style="color:#D7BA7D">\r</span><span style="color:#D16969">eport.xlsx"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># 送信</span></span>
<span class="line"><span style="color:#D4D4D4">mail.Send()</span></span></code></pre></div>



<p class="wp-block-paragraph">複数ファイルを添付したい場合は、Attachments.Add() を繰り返し呼び出します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>file_paths = [
    r"C:\Users\username\report.xlsx",
    r"C:\Users\username\summary.pdf",
]

for file_path in file_paths:
    mail.Attachments.Add(file_path)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">file_paths = [</span></span>
<span class="line"><span style="color:#569CD6">    r</span><span style="color:#D16969">"C:</span><span style="color:#D7BA7D">\U</span><span style="color:#D16969">sers</span><span style="color:#D7BA7D">\u</span><span style="color:#D16969">sername</span><span style="color:#D7BA7D">\r</span><span style="color:#D16969">eport.xlsx"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#569CD6">    r</span><span style="color:#D16969">"C:</span><span style="color:#D7BA7D">\U</span><span style="color:#D16969">sers</span><span style="color:#D7BA7D">\u</span><span style="color:#D16969">sername\summary.pdf"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span>
<span class="line"></span>
<span class="line"><span style="color:#C586C0">for</span><span style="color:#D4D4D4"> file_path </span><span style="color:#C586C0">in</span><span style="color:#D4D4D4"> file_paths:</span></span>
<span class="line"><span style="color:#D4D4D4">    mail.Attachments.Add(file_path)</span></span></code></pre></div>



<h3 class="wp-block-heading">メールを移動する</h3>



<p class="wp-block-paragraph">メールを移動する場合には、以下のように Move() メソッドを使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import win32com.client

# APPの初期化
outlook = win32com.client.Dispatch("Outlook.Application")
mapi = outlook.GetNamespace("MAPI")
account = "your_email_address"
destination_folder = "archive"

# 移動元と移動先のフォルダを指定
inbox = mapi.GetDefaultFolder(6)
archive = outlook.Folders[account].Folders[destination_folder]

# 件名に'Test'を含むメールをarchiveフォルダに移動
mails = inbox.Items
for mail in mails:
    if "Test" in mail.Subject:
        mail.Move(archive)
        print(f"Moved: {mail.Subject}")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> win32com.client</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># APPの初期化</span></span>
<span class="line"><span style="color:#D4D4D4">outlook = win32com.client.Dispatch(</span><span style="color:#CE9178">"Outlook.Application"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">mapi = outlook.GetNamespace(</span><span style="color:#CE9178">"MAPI"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">account = </span><span style="color:#CE9178">"your_email_address"</span></span>
<span class="line"><span style="color:#D4D4D4">destination_folder = </span><span style="color:#CE9178">"archive"</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># 移動元と移動先のフォルダを指定</span></span>
<span class="line"><span style="color:#D4D4D4">inbox = mapi.GetDefaultFolder(</span><span style="color:#B5CEA8">6</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">archive = outlook.Folders[account].Folders[destination_folder]</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># 件名に'Test'を含むメールをarchiveフォルダに移動</span></span>
<span class="line"><span style="color:#D4D4D4">mails = inbox.Items</span></span>
<span class="line"><span style="color:#C586C0">for</span><span style="color:#D4D4D4"> mail </span><span style="color:#C586C0">in</span><span style="color:#D4D4D4"> mails:</span></span>
<span class="line"><span style="color:#C586C0">    if</span><span style="color:#CE9178"> "Test"</span><span style="color:#569CD6"> in</span><span style="color:#D4D4D4"> mail.Subject:</span></span>
<span class="line"><span style="color:#D4D4D4">        mail.Move(archive)</span></span>
<span class="line"><span style="color:#DCDCAA">        print</span><span style="color:#D4D4D4">(</span><span style="color:#569CD6">f</span><span style="color:#CE9178">"Moved: </span><span style="color:#569CD6">{</span><span style="color:#D4D4D4">mail.Subject</span><span style="color:#569CD6">}</span><span style="color:#CE9178">"</span><span style="color:#D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">上記では、複数アカウントが存在する場合にアカウントを跨いで移動ができるようコードを組んでみました。</p>



<h2 class="wp-block-heading">【実践編 2】メールから情報抽出</h2>



<p class="wp-block-paragraph">メールの情報<span class="swl-fz u-fz-xs">（件名や本文など）</span>を抽出するには次の手順が必要です。</p>



<div class="wp-block-group has-border -border03"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ol class="wp-block-list is-style-num_circle">
<li>メールフォルダを取得する</li>



<li>フォルダ内の全メールを取得する</li>



<li>個々のメールの情報を取得する</li>
</ol>
</div></div>



<p class="wp-block-paragraph">ここまでご説明した内容を試していただいた方は、ほとんど苦労なく実装できると思います！</p>



<h3 class="wp-block-heading">1. メールフォルダを取得する</h3>



<p class="wp-block-paragraph">例えば受信トレイ内のメールを指定して、情報を取得する方法をご説明します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import win32com.client

# APPの初期化
outlook = win32com.client.Dispatch("outlook.application")
namespace = outlook.GetNamespace("MAPI")
inbox = namespace.GetDefaultFolder(6)  # 受信トレイ</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> win32com.client</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># APPの初期化</span></span>
<span class="line"><span style="color:#D4D4D4">outlook = win32com.client.Dispatch(</span><span style="color:#CE9178">"outlook.application"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">namespace = outlook.GetNamespace(</span><span style="color:#CE9178">"MAPI"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">inbox = namespace.GetDefaultFolder(</span><span style="color:#B5CEA8">6</span><span style="color:#D4D4D4">)  </span><span style="color:#6A9955"># 受信トレイ</span></span></code></pre></div>



<p class="wp-block-paragraph">namespace に対して GetDefaultFolder() を指定することでフォルダオブジェクトを丸ごと取得できます。受信トレイは 6 を指定してください。</p>



<p class="wp-block-paragraph">なお、よく使うフォルダ名と番号の対応関係は以下になります。</p>



<figure class="wp-block-table"><table><thead><tr><th>フォルダ名</th><th>番号</th></tr></thead><tbody><tr><td>受信トレイ</td><td>6</td></tr><tr><td>送信トレイ&nbsp;</td><td>4</td></tr><tr><td>送信済みアイテム</td><td>5</td></tr><tr><td>下書き</td><td>16</td></tr><tr><td>迷惑メール</td><td>23</td></tr></tbody></table><figcaption class="wp-element-caption">フォルダごとの番号</figcaption></figure>



<h3 class="wp-block-heading">2. フォルダ内の全メールを取得する</h3>



<p class="wp-block-paragraph">フォルダ内の全メールを取得するためには Items を使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import win32com.client

# APPの初期化
outlook = win32com.client.Dispatch("outlook.application")
namespace = outlook.GetNamespace("MAPI")
inbox = namespace.GetDefaultFolder(6)  # 受信トレイ

# フォルダ内の全メールを取得
inbox_mails = inbox.Items</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> win32com.client</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># APPの初期化</span></span>
<span class="line"><span style="color:#D4D4D4">outlook = win32com.client.Dispatch(</span><span style="color:#CE9178">"outlook.application"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">namespace = outlook.GetNamespace(</span><span style="color:#CE9178">"MAPI"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">inbox = namespace.GetDefaultFolder(</span><span style="color:#B5CEA8">6</span><span style="color:#D4D4D4">)  </span><span style="color:#6A9955"># 受信トレイ</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># フォルダ内の全メールを取得</span></span>
<span class="line"><span style="color:#D4D4D4">inbox_mails = inbox.Items</span></span></code></pre></div>



<h3 class="wp-block-heading">3. 個々のメールの情報を取得する</h3>



<p class="wp-block-paragraph">inbox.Items によって得られるのはリスト型のようなオブジェクトなので、ループで個々のメールオブジェクトにアクセスします。<br><span class="swl-fz u-fz-xs">※ 正確にはリスト型ではなくコレクションです</span></p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import win32com.client

# APPの初期化
outlook = win32com.client.Dispatch("outlook.application")
namespace = outlook.GetNamespace("MAPI")
inbox = namespace.GetDefaultFolder(6)  # 受信トレイ

# フォルダ内の全メールを取得
inbox_mails = inbox.Items

for mail in inbox_mails:
    print(mail.SenderEmailAddress)
    print(mail.Sender)
    print(mail.To)
    print(mail.Cc)
    print(mail.Bcc)
    print(mail.Body)
    print(mail.Attachments)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> win32com.client</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># APPの初期化</span></span>
<span class="line"><span style="color:#D4D4D4">outlook = win32com.client.Dispatch(</span><span style="color:#CE9178">"outlook.application"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">namespace = outlook.GetNamespace(</span><span style="color:#CE9178">"MAPI"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">inbox = namespace.GetDefaultFolder(</span><span style="color:#B5CEA8">6</span><span style="color:#D4D4D4">)  </span><span style="color:#6A9955"># 受信トレイ</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># フォルダ内の全メールを取得</span></span>
<span class="line"><span style="color:#D4D4D4">inbox_mails = inbox.Items</span></span>
<span class="line"></span>
<span class="line"><span style="color:#C586C0">for</span><span style="color:#D4D4D4"> mail </span><span style="color:#C586C0">in</span><span style="color:#D4D4D4"> inbox_mails:</span></span>
<span class="line"><span style="color:#DCDCAA">    print</span><span style="color:#D4D4D4">(mail.SenderEmailAddress)</span></span>
<span class="line"><span style="color:#DCDCAA">    print</span><span style="color:#D4D4D4">(mail.Sender)</span></span>
<span class="line"><span style="color:#DCDCAA">    print</span><span style="color:#D4D4D4">(mail.To)</span></span>
<span class="line"><span style="color:#DCDCAA">    print</span><span style="color:#D4D4D4">(mail.Cc)</span></span>
<span class="line"><span style="color:#DCDCAA">    print</span><span style="color:#D4D4D4">(mail.Bcc)</span></span>
<span class="line"><span style="color:#DCDCAA">    print</span><span style="color:#D4D4D4">(mail.Body)</span></span>
<span class="line"><span style="color:#DCDCAA">    print</span><span style="color:#D4D4D4">(mail.Attachments)</span></span></code></pre></div>



<p class="wp-block-paragraph">ここで、メールの情報がどのように呼び出せるかをまとめておきます。</p>



<figure class="wp-block-table"><table><thead><tr><th>項目名</th><th>プロパティ名</th></tr></thead><tbody><tr><td>Subject</td><td>メールの件名</td></tr><tr><td>Body</td><td>メールの本文</td></tr><tr><td>HTMLBody</td><td>HTML 形式のメールの本文</td></tr><tr><td>Sender</td><td>メールの送信者</td></tr><tr><td>SenderEmailAddress</td><td>送信者のメールアドレス</td></tr><tr><td>To</td><td>宛先のメールアドレス</td></tr><tr><td>Cc</td><td>CCのメールアドレス</td></tr><tr><td>Bcc</td><td>BCCのメールアドレス</td></tr><tr><td>Attachments</td><td>添付ファイルのコレクション</td></tr><tr><td>ReceivedTime</td><td>受信時刻</td></tr><tr><td>SentOn</td><td>送信時刻</td></tr><tr><td>UnRead</td><td>未読かどうかの真偽値</td></tr><tr><td>Importance</td><td>重要度</td></tr><tr><td>ReplyRecipients</td><td>返信先のアドレス</td></tr><tr><td>Recipients</td><td>受信者のコレクション</td></tr><tr><td>DisplayCc</td><td>表示用のCCアドレス</td></tr><tr><td>DisplayTo</td><td>表示用のToアドレス</td></tr></tbody></table><figcaption class="wp-element-caption">主なプロパティ一覧</figcaption></figure>



<h3 class="wp-block-heading">添付ファイルを保存する</h3>



<p class="wp-block-paragraph">上の表にある Attachments は添付ファイルのコレクションです。1件ずつ取り出して SaveAsFile() を呼べば、任意のフォルダに保存できます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import os
import win32com.client

# APPの初期化
outlook = win32com.client.Dispatch("outlook.application")
namespace = outlook.GetNamespace("MAPI")
inbox = namespace.GetDefaultFolder(6)  # 受信トレイ

save_dir = r"C:\Users\username\attachments"

for mail in inbox.Items:
    for attachment in mail.Attachments:
        save_path = os.path.join(save_dir, attachment.FileName)
        attachment.SaveAsFile(save_path)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> os</span></span>
<span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> win32com.client</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># APPの初期化</span></span>
<span class="line"><span style="color:#D4D4D4">outlook = win32com.client.Dispatch(</span><span style="color:#CE9178">"outlook.application"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">namespace = outlook.GetNamespace(</span><span style="color:#CE9178">"MAPI"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">inbox = namespace.GetDefaultFolder(</span><span style="color:#B5CEA8">6</span><span style="color:#D4D4D4">)  </span><span style="color:#6A9955"># 受信トレイ</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">save_dir = </span><span style="color:#569CD6">r</span><span style="color:#D16969">"C:</span><span style="color:#D7BA7D">\U</span><span style="color:#D16969">sers</span><span style="color:#D7BA7D">\u</span><span style="color:#D16969">sername</span><span style="color:#D7BA7D">\a</span><span style="color:#D16969">ttachments"</span></span>
<span class="line"></span>
<span class="line"><span style="color:#C586C0">for</span><span style="color:#D4D4D4"> mail </span><span style="color:#C586C0">in</span><span style="color:#D4D4D4"> inbox.Items:</span></span>
<span class="line"><span style="color:#C586C0">    for</span><span style="color:#D4D4D4"> attachment </span><span style="color:#C586C0">in</span><span style="color:#D4D4D4"> mail.Attachments:</span></span>
<span class="line"><span style="color:#D4D4D4">        save_path = os.path.join(save_dir, attachment.FileName)</span></span>
<span class="line"><span style="color:#D4D4D4">        attachment.SaveAsFile(save_path)</span></span></code></pre></div>



<p class="wp-block-paragraph">attachment.FileName で元のファイル名が取得できるので、そのままの名前で保存できます。特定の拡張子だけ保存したい場合は、FileName を条件分岐でフィルタリングしてください。</p>



<h2 class="wp-block-heading">エラーハンドリング</h2>



<p class="wp-block-paragraph">win32comを使っているとCOMエラーが表示されることがあります。これは<strong>Python・Outlook間の通信で何らかの問題がある場合に発生</strong>します。</p>



<p class="wp-block-paragraph">Outlookが適切にインストールされていない場合などたまに見かけるエラーなので、例外処理してエラーハンドリングしておきましょう。</p>



<p class="wp-block-paragraph">簡単な例としてOutlookインスタンスの生成に失敗した場合の例外に対して、printするだけのサンプルコードを提示します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import win32com.client

try:
    outlook = win32com.client.Dispatch("Outlook.Application")
except win32com.client.pywintypes.com_error as e:
    print("Outlookが見つかりませんでした。適切にインストールされているか確認してください。")
    print(f"エラーの詳細：{e}")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> win32com.client</span></span>
<span class="line"></span>
<span class="line"><span style="color:#C586C0">try</span><span style="color:#D4D4D4">:</span></span>
<span class="line"><span style="color:#D4D4D4">    outlook = win32com.client.Dispatch(</span><span style="color:#CE9178">"Outlook.Application"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#C586C0">except</span><span style="color:#D4D4D4"> win32com.client.pywintypes.com_error </span><span style="color:#C586C0">as</span><span style="color:#D4D4D4"> e:</span></span>
<span class="line"><span style="color:#DCDCAA">    print</span><span style="color:#D4D4D4">(</span><span style="color:#CE9178">"Outlookが見つかりませんでした。適切にインストールされているか確認してください。"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#DCDCAA">    print</span><span style="color:#D4D4D4">(</span><span style="color:#569CD6">f</span><span style="color:#CE9178">"エラーの詳細：</span><span style="color:#569CD6">{</span><span style="color:#D4D4D4">e</span><span style="color:#569CD6">}</span><span style="color:#CE9178">"</span><span style="color:#D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">実際にはloggingライブラリなどを用いてログ出力したりする必要はあります。</p>



<h2 class="wp-block-heading">サンプルコードで全体像を掴む</h2>



<p class="wp-block-paragraph">最後にサンプルコードを掲載します。</p>



<p class="wp-block-paragraph">断片的なコードでは見えないことも、一連の流れを眺めるだけで気づくことがあると思いますのでぜひ参考にしてみてください。</p>



<h3 class="wp-block-heading">受信トレイ内のメールをCSVに出力する例</h3>



<p class="wp-block-paragraph">受信トレイ内のメールを取得し、情報をCSVに書き出すサンプルプログラムです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import pandas as pd
import win32com.client

# OutlookAPPのインスタンス化
outlook = win32com.client.Dispatch("Outlook.Application").GetNamespace("MAPI")

inbox = outlook.GetDefaultFolder(6)
inbox_items = inbox.Items

inbox_mails = []
for mail in inbox_items:
    inbox_mails.append(
        {
            "sender_address": mail.SenderEmailAddress,
            "sender_name": mail.Sender,
            "to_address": mail.To,
            "cc_address": mail.Cc,
            "bcc_address": mail.Bcc,
            "body": mail.Body,
            "attachments": mail.Attachments,
        }
    )
df_inbox = pd.DataFrame.from_dict(inbox_mails, dtype=object)
df_inbox.to_csv("output_inbox.csv", encoding="utf-8_sig")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> pandas </span><span style="color:#C586C0">as</span><span style="color:#D4D4D4"> pd</span></span>
<span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> win32com.client</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># OutlookAPPのインスタンス化</span></span>
<span class="line"><span style="color:#D4D4D4">outlook = win32com.client.Dispatch(</span><span style="color:#CE9178">"Outlook.Application"</span><span style="color:#D4D4D4">).GetNamespace(</span><span style="color:#CE9178">"MAPI"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">inbox = outlook.GetDefaultFolder(</span><span style="color:#B5CEA8">6</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">inbox_items = inbox.Items</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">inbox_mails = []</span></span>
<span class="line"><span style="color:#C586C0">for</span><span style="color:#D4D4D4"> mail </span><span style="color:#C586C0">in</span><span style="color:#D4D4D4"> inbox_items:</span></span>
<span class="line"><span style="color:#D4D4D4">    inbox_mails.append(</span></span>
<span class="line"><span style="color:#D4D4D4">        {</span></span>
<span class="line"><span style="color:#CE9178">            "sender_address"</span><span style="color:#D4D4D4">: mail.SenderEmailAddress,</span></span>
<span class="line"><span style="color:#CE9178">            "sender_name"</span><span style="color:#D4D4D4">: mail.Sender,</span></span>
<span class="line"><span style="color:#CE9178">            "to_address"</span><span style="color:#D4D4D4">: mail.To,</span></span>
<span class="line"><span style="color:#CE9178">            "cc_address"</span><span style="color:#D4D4D4">: mail.Cc,</span></span>
<span class="line"><span style="color:#CE9178">            "bcc_address"</span><span style="color:#D4D4D4">: mail.Bcc,</span></span>
<span class="line"><span style="color:#CE9178">            "body"</span><span style="color:#D4D4D4">: mail.Body,</span></span>
<span class="line"><span style="color:#CE9178">            "attachments"</span><span style="color:#D4D4D4">: mail.Attachments,</span></span>
<span class="line"><span style="color:#D4D4D4">        }</span></span>
<span class="line"><span style="color:#D4D4D4">    )</span></span>
<span class="line"><span style="color:#D4D4D4">df_inbox = pd.DataFrame.from_dict(inbox_mails, </span><span style="color:#9CDCFE">dtype</span><span style="color:#D4D4D4">=</span><span style="color:#4EC9B0">object</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">df_inbox.to_csv(</span><span style="color:#CE9178">"output_inbox.csv"</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">encoding</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"utf-8_sig"</span><span style="color:#D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">最終的には読み込んだメールの内容をCSVとして書き出しています。</p>



<h3 class="wp-block-heading">メールを作成して送信する例</h3>



<p class="wp-block-paragraph">メールを送信する方法は以下です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import win32com.client

# OutlookAPPのインスタンス化
outlook = win32com.client.Dispatch("Outlook.Application")

# メールオブジェクトを作成
mail = outlook.CreateItem(0)

# メールオブジェクトのプロパティを設定
mail.to = "aaa@xxx.co.jp"
mail.cc = "aaa@xxx.co.jp"
mail.bcc = "aaa@xxx.co.jp"
mail.subject = "件名が入ります"
mail.bodyFormat = 1  # テキスト形式で作成
mail.body = "こんにちは。\nこれはテストメールです。"

mail.Send()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> win32com.client</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># OutlookAPPのインスタンス化</span></span>
<span class="line"><span style="color:#D4D4D4">outlook = win32com.client.Dispatch(</span><span style="color:#CE9178">"Outlook.Application"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># メールオブジェクトを作成</span></span>
<span class="line"><span style="color:#D4D4D4">mail = outlook.CreateItem(</span><span style="color:#B5CEA8">0</span><span style="color:#D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># メールオブジェクトのプロパティを設定</span></span>
<span class="line"><span style="color:#D4D4D4">mail.to = </span><span style="color:#CE9178">"aaa@xxx.co.jp"</span></span>
<span class="line"><span style="color:#D4D4D4">mail.cc = </span><span style="color:#CE9178">"aaa@xxx.co.jp"</span></span>
<span class="line"><span style="color:#D4D4D4">mail.bcc = </span><span style="color:#CE9178">"aaa@xxx.co.jp"</span></span>
<span class="line"><span style="color:#D4D4D4">mail.subject = </span><span style="color:#CE9178">"件名が入ります"</span></span>
<span class="line"><span style="color:#D4D4D4">mail.bodyFormat = </span><span style="color:#B5CEA8">1</span><span style="color:#6A9955">  # テキスト形式で作成</span></span>
<span class="line"><span style="color:#D4D4D4">mail.body = </span><span style="color:#CE9178">"こんにちは。</span><span style="color:#D7BA7D">\n</span><span style="color:#CE9178">これはテストメールです。"</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">mail.Send()</span></span></code></pre></div>



<h2 class="wp-block-heading">より実践的なコードにするための補足</h2>



<h3 class="wp-block-heading">関数を用意してテンプレート化する</h3>



<p class="wp-block-paragraph">以下のような形でテンプレート化しておくと、コードの見通しが良くなります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from win32com.client import Dispatch, constants

def open_outlook():
    outlook = Dispatch("Outlook.Application")
    namespace = outlook.GetNamespace("MAPI")
    return outlook, namespace

def quit_outlook(outlook):
    # Outlook 自体を終了させたくない場合は、通常ここは呼ばない
    # outlook.Quit() するとアプリ自体が閉じる
    outlook.Quit()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> win32com.client </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> Dispatch, constants</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">def</span><span style="color:#DCDCAA"> open_outlook</span><span style="color:#D4D4D4">():</span></span>
<span class="line"><span style="color:#D4D4D4">    outlook = Dispatch(</span><span style="color:#CE9178">"Outlook.Application"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">    namespace = outlook.GetNamespace(</span><span style="color:#CE9178">"MAPI"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#C586C0">    return</span><span style="color:#D4D4D4"> outlook, namespace</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">def</span><span style="color:#DCDCAA"> quit_outlook</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">outlook</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#6A9955">    # Outlook 自体を終了させたくない場合は、通常ここは呼ばない</span></span>
<span class="line"><span style="color:#6A9955">    # outlook.Quit() するとアプリ自体が閉じる</span></span>
<span class="line"><span style="color:#D4D4D4">    outlook.Quit()</span></span></code></pre></div>



<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">Windows 環境であれば Outlook を使った自動化はかなり簡単に実装できるはずです。</p>



<p class="wp-block-paragraph">もし Excel の操作もしてみたいという方は、以下の win32com を使った Excel 自動化の記事も目を通してみてください。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/AdobeStock_504301962-768x446-1-300x174.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/python-win32com-excel/">【Python × Excel自動化】openpyxlでグラフが消える問題を解決｜win32comで書式を保持して操作する方法</a>
						<span class="p-blogCard__excerpt">Python の Excel 系ライブラリは openpyxl が有名です。 ところが、openpyxl はグラフや罫線などが消えてしまう不具合があり、クライアントワークなどで安全に自動化し&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph"></p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【初心者でも簡単】Djangoカスタムコマンド入門</title>
		<link>https://cfxlog.com/python-django-custom-command/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Mon, 20 Feb 2023 13:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<category><![CDATA[自動化]]></category>
		<guid isPermaLink="false">https://www.cfxlog.com/?p=177</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-custom-command-1024x538.jpg" class="webfeedsFeaturedVisual" /></p>カスタムコマンドを使うと、あらかじめ書いたスクリプトを manage.py 経由で実行できます。 例えば、以下のような作業はカスタムコマンドと相性が良いです。 これらをカスタムコマンド以外で実現しようとすると、毎回新しい [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-custom-command-1024x538.jpg" class="webfeedsFeaturedVisual" /></p>
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>ルーティン作業を自動化したい</li>



<li>カスタムコマンドを実装したい</li>
</ul>
</div></div>



<p class="wp-block-paragraph">カスタムコマンドを使うと、あらかじめ書いたスクリプトを manage.py 経由で実行できます。</p>



<p class="wp-block-paragraph">例えば、以下のような作業はカスタムコマンドと相性が良いです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list is-style-check_list">
<li>定期的に発生するバッチ処理</li>



<li>データベースへマスタデータ登録</li>
</ul>
</div></div>



<p class="wp-block-paragraph">これらをカスタムコマンド以外で実現しようとすると、毎回新しいスクリプトを書くハメになりとても不便。</p>



<p class="wp-block-paragraph">実装方法はかなり定型的なので、本記事で詳しく解説していきます！</p>



<h2 class="wp-block-heading">【基本編】カスタムコマンドの作り方</h2>



<p class="wp-block-paragraph">実装の流れは次の通りです。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>カスタムコマンド実装までの流れ</span></div><div class="cap_box_content">
<ol class="wp-block-list is-style-num_circle">
<li>必要なディレクトリ・ファイルを作成</li>



<li>カスタムコマンド作成</li>
</ol>
</div></div>



<p class="wp-block-paragraph">まずはこのセクションでカスタムコマンドの基本をおさえましょう。</p>



<h3 class="wp-block-heading">1. 必要なディレクトリ・ファイルを作成</h3>



<p class="wp-block-paragraph">アプリディレクトリに、management 以下を追加してください。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Plaintext</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>./
├── my_project/
│   ├── __init__.py
│   ├── settings.py
│   ├── urls.py
│   └── asgi.py or wsgi.py
├── my_app/
│   ├── management/  # この配下を追加
│   │   ├── __init__.py
│   │   ├── commands/
│   │   │   ├── __init__.py
│   │   │   └── my_command.py
│   ├── models.py
│   ├── views.py
│   └── ...
├── manage.py
└── ...</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">./</span></span>
<span class="line"><span style="color: #D4D4D4">├── my_project/</span></span>
<span class="line"><span style="color: #D4D4D4">│   ├── __init__.py</span></span>
<span class="line"><span style="color: #D4D4D4">│   ├── settings.py</span></span>
<span class="line"><span style="color: #D4D4D4">│   ├── urls.py</span></span>
<span class="line"><span style="color: #D4D4D4">│   └── asgi.py or wsgi.py</span></span>
<span class="line"><span style="color: #D4D4D4">├── my_app/</span></span>
<span class="line"><span style="color: #D4D4D4">│   ├── management/  # この配下を追加</span></span>
<span class="line"><span style="color: #D4D4D4">│   │   ├── __init__.py</span></span>
<span class="line"><span style="color: #D4D4D4">│   │   ├── commands/</span></span>
<span class="line"><span style="color: #D4D4D4">│   │   │   ├── __init__.py</span></span>
<span class="line"><span style="color: #D4D4D4">│   │   │   └── my_command.py</span></span>
<span class="line"><span style="color: #D4D4D4">│   ├── models.py</span></span>
<span class="line"><span style="color: #D4D4D4">│   ├── views.py</span></span>
<span class="line"><span style="color: #D4D4D4">│   └── ...</span></span>
<span class="line"><span style="color: #D4D4D4">├── manage.py</span></span>
<span class="line"><span style="color: #D4D4D4">└── ...</span></span></code></pre></div>



<p class="wp-block-paragraph">カスタムコマンドを書く Python モジュール名がそのまま「コマンド名」になります。</p>



<p class="wp-block-paragraph">すなわち、今回の場合には my_command がコマンド名になります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>python manage.py my_command</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">python</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">manage.py</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">my_command</span></span></code></pre></div>



<p class="wp-block-paragraph">カスタムコマンドを実行したい場合には、上記をコマンドライン上で実行してください。</p>



<h3 class="wp-block-heading">2. カスタムコマンド作成</h3>



<p class="wp-block-paragraph">続いて実現したい内容を my_command.py に書き込みます。</p>



<p class="wp-block-paragraph">内容は定型的なので、まずは以下をコピペいただくとラクだと思います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.core.management.base import BaseCommand


class Command(BaseCommand):
    # python manage.py help &lt;カスタムコマンド名> を実行すると表示されるメッセージ
    help = "Help message"

    def add_arguments(self, parser):
        # オプションをつけたい場合のみ必要
        pass

    def handle(self, *args, **options):
        # 具体的な処理内容
        print("Hello, World!")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> django.core.management.base </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> BaseCommand</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">class</span><span style="color: #D4D4D4"> </span><span style="color: #4EC9B0">Command</span><span style="color: #D4D4D4">(</span><span style="color: #4EC9B0">BaseCommand</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955"># python manage.py help &lt;カスタムコマンド名&gt; を実行すると表示されるメッセージ</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">help</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;Help message&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">add_arguments</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">self</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">parser</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #6A9955"># オプションをつけたい場合のみ必要</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">pass</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">handle</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">self</span><span style="color: #D4D4D4">, *</span><span style="color: #9CDCFE">args</span><span style="color: #D4D4D4">, **</span><span style="color: #9CDCFE">options</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #6A9955"># 具体的な処理内容</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;Hello, World!&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">色々書いてありますが、実際に実行されるのは handle() メソッドです。</p>



<p class="wp-block-paragraph">つまり、上記を実行するとコンソール上に &#8220;Hello, World!&#8221; と表示されます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>python manage.py my_command</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">python</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">manage.py</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">my_command</span></span></code></pre></div>



<p class="wp-block-paragraph">カスタムコマンドを実行するには、上記をコマンドラインで実行ください。</p>



<p class="is-style-icon_announce wp-block-paragraph">基本的な使い方は以上になります！<br>オプションをつける方法などは、次のセクションで解説します。</p>



<h2 class="wp-block-heading">【中級編】オプションをつけて動的に呼び出す</h2>



<p class="wp-block-paragraph">ここからは add_arguments() メソッドについての解説です。</p>



<p class="wp-block-paragraph">おさらいになりますが、カスタムコマンドのコード例を再掲します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.core.management.base import BaseCommand


class Command(BaseCommand):
    # python manage.py help &lt;カスタムコマンド名> を実行すると表示されるメッセージ
    help = "Help message"

    def add_arguments(self, parser):
        # オプションをつけたい場合のみ必要
        pass

    def handle(self, *args, **options):
        # 具体的な処理内容
        print("Hello, World!")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> django.core.management.base </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> BaseCommand</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">class</span><span style="color: #D4D4D4"> </span><span style="color: #4EC9B0">Command</span><span style="color: #D4D4D4">(</span><span style="color: #4EC9B0">BaseCommand</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955"># python manage.py help &lt;カスタムコマンド名&gt; を実行すると表示されるメッセージ</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">help</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;Help message&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">add_arguments</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">self</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">parser</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #6A9955"># オプションをつけたい場合のみ必要</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">pass</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">handle</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">self</span><span style="color: #D4D4D4">, *</span><span style="color: #9CDCFE">args</span><span style="color: #D4D4D4">, **</span><span style="color: #9CDCFE">options</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #6A9955"># 具体的な処理内容</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;Hello, World!&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">add_arguments() メソッドを作り込むことにより、オプションをつけて動的にコマンドを呼び出すことができるようになります。</p>



<h3 class="wp-block-heading">オプションの設定と、値の受け取り</h3>



<p class="wp-block-paragraph">まず、オプションの設定には add_arguments() メソッドの中に parser.add_argument() メソッドを加えます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>class Command(BaseCommand):
    help = "Help message"

    def add_arguments(self, parser):
        # name というオプションを追加
        parser.add_argument("-n", "--name")

    def handle(self, *args, **options):
        name = options.get("name", None)
        print(name)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">class</span><span style="color: #D4D4D4"> </span><span style="color: #4EC9B0">Command</span><span style="color: #D4D4D4">(</span><span style="color: #4EC9B0">BaseCommand</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">help</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;Help message&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">add_arguments</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">self</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">parser</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #6A9955"># name というオプションを追加</span></span>
<span class="line"><span style="color: #D4D4D4">        parser.add_argument(</span><span style="color: #CE9178">&quot;-n&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;--name&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">handle</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">self</span><span style="color: #D4D4D4">, *</span><span style="color: #9CDCFE">args</span><span style="color: #D4D4D4">, **</span><span style="color: #9CDCFE">options</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">        name = options.get(</span><span style="color: #CE9178">&quot;name&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #569CD6">None</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(name)</span></span></code></pre></div>



<p class="wp-block-paragraph">ここでは、引数として &#8220;-n&#8221;, &#8220;&#8211;name&#8221; を指定しました。</p>



<p class="wp-block-paragraph">すると、コマンドラインで以下を実行するとオプション値を受け取れるようになります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 短いオプション名を使う場合
python manage.py my_command -n "John Lennon"

# 長いオプション名を使う場合（上と意味は同じ）
python manage.py my_command --name "John Lennon"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 短いオプション名を使う場合</span></span>
<span class="line"><span style="color: #DCDCAA">python</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">manage.py</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">my_command</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-n</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;John Lennon&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># 長いオプション名を使う場合（上と意味は同じ）</span></span>
<span class="line"><span style="color: #DCDCAA">python</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">manage.py</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">my_command</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--name</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;John Lennon&quot;</span></span></code></pre></div>



<p class="wp-block-paragraph">これでコマンドライン上から渡した &#8220;John Lennon&#8221; という文字列が handle() メソッドに渡されます。</p>



<p class="wp-block-paragraph">そして、handle() メソッド内で値を受け取るために options という辞書を使います。</p>



<p class="wp-block-paragraph">handle() メソッドだけを抜粋して示しますね。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>def handle(self, *args, **options):
    name = options.get("name", None)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">handle</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">self</span><span style="color: #D4D4D4">, *</span><span style="color: #9CDCFE">args</span><span style="color: #D4D4D4">, **</span><span style="color: #9CDCFE">options</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    name = options.get(</span><span style="color: #CE9178">&quot;name&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #569CD6">None</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">つまり、options という辞書の中に {&#8220;name&#8221;: &#8220;John Lennon&#8221;} が入っている状態ですね。</p>



<p class="wp-block-paragraph">今回は get() メソッドで辞書から値を取り出しましたが、他の方法を使っても構いません。</p>



<p class="wp-block-paragraph">以上で、オプション値を handle() メソッド内で取り出すことができました。</p>



<p class="is-style-icon_announce wp-block-paragraph">僕の場合は KeyError を避けるために、例のように get() メソッドで取り出すことが多いです。</p>



<h3 class="wp-block-heading">add_arguments() メソッドを極める</h3>



<p class="wp-block-paragraph">add_arguments()メソッドにはいくつかのオプションがあります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>def add_arguments(self, parser):
    parser.add_argument("-name", nargs="?", default=None, type=str)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">add_arguments</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">self</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">parser</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    parser.add_argument(</span><span style="color: #CE9178">&quot;-name&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">nargs</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;?&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">default</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">None</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">type</span><span style="color: #D4D4D4">=</span><span style="color: #4EC9B0">str</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">よく使うオプションは、以下の通りです。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>parser.add_argument() メソッドの引数</span></div><div class="cap_box_content">
<ul class="wp-block-list">
<li><strong>name_or_flags</strong>: コマンドラインから引数に設定する名前。</li>



<li><strong>nargs</strong>: 受け取ることができる引数の数。</li>



<li><strong>default</strong>: 引数が指定されなかった場合のデフォルト値。</li>



<li><strong>type</strong>: 引数の型を指定。指定した型に変換できない場合にはエラーが発生。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">このうち、name_or_flags と nargs は少し分かりづらいので以下で補足説明します。</p>



<p class="is-style-icon_info wp-block-paragraph">&#8220;name_or_flags&#8221; という引数名は存在しないようで、あくまで位置引数として指定します。name_or_flags=~ と書いてもエラーになりますのでご注意ください。</p>



<h4 class="wp-block-heading">name_or_flags</h4>



<p class="wp-block-paragraph">name_or_flags ではフラグの名前を定義します。実は、引数には2種類が設定可能です。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>設定できる引数の種類</span></div><div class="cap_box_content">
<ul class="wp-block-list is-style-good_list">
<li>位置引数: 順番に応じて呼び出される引数</li>



<li>名前付き引数: 名前に応じて呼び出される引数</li>
</ul>
</div></div>



<p class="wp-block-paragraph"><strong>位置引数について</strong></p>



<p class="wp-block-paragraph">以下のように<strong>引数名にハイフンをつけない<span class="swl-fz u-fz-xs">（ &#8220;-filename&#8221; ではない）</span>場合には、位置引数</strong>として扱われます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>parser.add_argument("filename")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">parser.add_argument(</span><span style="color: #CE9178">&quot;filename&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">位置引数では引数の順番だけが考慮されて値が渡されるので、名前付き引数のように複数のパターンを設定することができません。<span class="swl-fz u-fz-xs">（今回の例では、コマンド実行時に filename という文字列は使われない）</span></p>



<p class="wp-block-paragraph">位置引数に値を渡す場合には、コマンドラインで以下のように実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>python manage.py new_command "filename.csv"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">python</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">manage.py</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">new_command</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;filename.csv&quot;</span></span></code></pre></div>



<p class="wp-block-paragraph"><strong>名前付き引数について</strong></p>



<p class="wp-block-paragraph">一方で、以下のように引数名の前にハイフンをつけた場合には、名前付き引数として扱われます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>parser.add_argument("-f", "--filename")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">parser.add_argument(</span><span style="color: #CE9178">&quot;-f&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;--filename&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">名前付き引数に値を渡す場合には、コマンドライン上で以下のように実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 短いコマンドライン引数を使うなら・・・
python manage.py new_command -f "filename.csv"

# または、長いコマンドライン引数を使うなら・・・
python manage.py new_command --filename "filename.csv"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 短いコマンドライン引数を使うなら・・・</span></span>
<span class="line"><span style="color: #DCDCAA">python</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">manage.py</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">new_command</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-f</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;filename.csv&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># または、長いコマンドライン引数を使うなら・・・</span></span>
<span class="line"><span style="color: #DCDCAA">python</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">manage.py</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">new_command</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--filename</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;filename.csv&quot;</span></span></code></pre></div>



<p class="wp-block-paragraph"><strong>補足）ハイフンの数は1つ？それとも2つ？</strong></p>



<p class="wp-block-paragraph">考え方としては &#8220;-d&#8221; などの短い引数はハイフン1つを、&#8221;&#8211;directory&#8221; のように長い引数はハイフン2つで表します。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl2" data-colset="col1"><div class="cap_box_ttl"><span>複数のオプションを設定したい場合は？</span></div><div class="cap_box_content">
<p class="wp-block-paragraph">複数のオプションを設定したい場合には、parser.add_argument() を増やします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>def add_arguments(self, parser):
    parser.add_argument("-n", "--name")
    parser.add_argument("-f", "--filename")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">add_arguments</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">self</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">parser</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    parser.add_argument(</span><span style="color: #CE9178">&quot;-n&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;--name&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">    parser.add_argument(</span><span style="color: #CE9178">&quot;-f&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;--filename&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>
</div></div>



<h4 class="wp-block-heading">nargs</h4>



<p class="wp-block-paragraph">nargs は引数に取ることができる要素数を決められます。</p>



<figure class="wp-block-table"><table><thead><tr><th class="has-text-align-left" data-align="left">記号</th><th>意味</th></tr></thead><tbody><tr><td class="has-text-align-left" data-align="left">*</td><td>0個以上</td></tr><tr><td class="has-text-align-left" data-align="left">+</td><td>1個以上</td></tr><tr><td class="has-text-align-left" data-align="left">?</td><td>0個または1個</td></tr><tr><td class="has-text-align-left" data-align="left">具体的な数字</td><td>指定した数の引数を強制</td></tr></tbody></table><figcaption class="wp-element-caption">nargs に設定できる値</figcaption></figure>



<p class="wp-block-paragraph">正規表現に少し似ているので、考え方にはなじみやすいかもしれません。</p>



<h3 class="wp-block-heading">オプションが指定されたら True にする方法</h3>



<p class="wp-block-paragraph">オプションが指定されたら True にしたい場合には、action を使いましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>class Command(BaseCommand):
    help = "Help message"

    def add_arguments(self, parser):
        parser.add_argument("--skip", action="store_true")

    def handle(self, *args, **options):
        name = options.get("skip", None)
        if skip:
            print("Skipping the operation.")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">class</span><span style="color: #D4D4D4"> </span><span style="color: #4EC9B0">Command</span><span style="color: #D4D4D4">(</span><span style="color: #4EC9B0">BaseCommand</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">help</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;Help message&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">add_arguments</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">self</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">parser</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">        parser.add_argument(</span><span style="color: #CE9178">&quot;--skip&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">action</span><span style="color: #D4D4D4">=</span><span style="color: #CE9178">&quot;store_true&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">handle</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">self</span><span style="color: #D4D4D4">, *</span><span style="color: #9CDCFE">args</span><span style="color: #D4D4D4">, **</span><span style="color: #9CDCFE">options</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">        name = options.get(</span><span style="color: #CE9178">&quot;skip&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #569CD6">None</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> skip:</span></span>
<span class="line"><span style="color: #D4D4D4">            </span><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&quot;Skipping the operation.&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">逆にオプションが指定されたら False にしたい場合には、action=&#8221;store_false&#8221; を指定すれば OK です。</p>



<h2 class="wp-block-heading">【応用編】カスタムコマンドをさらに使いこなす</h2>



<p class="wp-block-paragraph">ここまで解説した内容を実践していただければ、カスタムコマンドの基本的な操作としては十分です。</p>



<p class="wp-block-paragraph">ここからはさらに一歩進んだ使い方をご紹介します。</p>



<h3 class="wp-block-heading">コマンドラインにメッセージを表示させる</h3>



<p class="wp-block-paragraph">print() 関数でも実現できますが、Djangoより細かい制御ができるstrdout, stderr オブジェクトが用意されています。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>class Command(BaseCommand):
    help = "Help message"

    def add_arguments(self, parser):
        parser.add_argument("-n", "--name")

    def handle(self, *args, **options):
        self.stdout.write("メッセージ")
        self.stderr.write("エラーメッセージ")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">class</span><span style="color: #D4D4D4"> </span><span style="color: #4EC9B0">Command</span><span style="color: #D4D4D4">(</span><span style="color: #4EC9B0">BaseCommand</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">help</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;Help message&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">add_arguments</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">self</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">parser</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">        parser.add_argument(</span><span style="color: #CE9178">&quot;-n&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;--name&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">handle</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">self</span><span style="color: #D4D4D4">, *</span><span style="color: #9CDCFE">args</span><span style="color: #D4D4D4">, **</span><span style="color: #9CDCFE">options</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #569CD6">self</span><span style="color: #D4D4D4">.stdout.write(</span><span style="color: #CE9178">&quot;メッセージ&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #569CD6">self</span><span style="color: #D4D4D4">.stderr.write(</span><span style="color: #CE9178">&quot;エラーメッセージ&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph">例えば style オブジェクトを使って文字色を変更できます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>class Command(BaseCommand):
    help = "Help message"

    def add_arguments(self, parser):
        parser.add_argument("-n", "--name")

    def handle(self, *args, **options):
        self.stdout.write(self.style.SUCCESS("Success!"))  # 緑色
        self.stdout.write(self.style.WARNING("Warning!"))  # 黄色
        self.stdout.write(self.style.NOTICE("Notice!"))  # 茶色
        self.stderr.write(self.style.ERROR("Error!"))  # 赤色</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">class</span><span style="color: #D4D4D4"> </span><span style="color: #4EC9B0">Command</span><span style="color: #D4D4D4">(</span><span style="color: #4EC9B0">BaseCommand</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">help</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&quot;Help message&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">add_arguments</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">self</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">parser</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">        parser.add_argument(</span><span style="color: #CE9178">&quot;-n&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&quot;--name&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">handle</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">self</span><span style="color: #D4D4D4">, *</span><span style="color: #9CDCFE">args</span><span style="color: #D4D4D4">, **</span><span style="color: #9CDCFE">options</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #569CD6">self</span><span style="color: #D4D4D4">.stdout.write(</span><span style="color: #569CD6">self</span><span style="color: #D4D4D4">.style.SUCCESS(</span><span style="color: #CE9178">&quot;Success!&quot;</span><span style="color: #D4D4D4">))  </span><span style="color: #6A9955"># 緑色</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #569CD6">self</span><span style="color: #D4D4D4">.stdout.write(</span><span style="color: #569CD6">self</span><span style="color: #D4D4D4">.style.WARNING(</span><span style="color: #CE9178">&quot;Warning!&quot;</span><span style="color: #D4D4D4">))  </span><span style="color: #6A9955"># 黄色</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #569CD6">self</span><span style="color: #D4D4D4">.stdout.write(</span><span style="color: #569CD6">self</span><span style="color: #D4D4D4">.style.NOTICE(</span><span style="color: #CE9178">&quot;Notice!&quot;</span><span style="color: #D4D4D4">))  </span><span style="color: #6A9955"># 茶色</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #569CD6">self</span><span style="color: #D4D4D4">.stderr.write(</span><span style="color: #569CD6">self</span><span style="color: #D4D4D4">.style.ERROR(</span><span style="color: #CE9178">&quot;Error!&quot;</span><span style="color: #D4D4D4">))  </span><span style="color: #6A9955"># 赤色</span></span></code></pre></div>



<p class="is-style-icon_announce wp-block-paragraph">stdout, stderr を使うことでテストが楽になります。<br>この点は後日追記予定です。</p>



<h3 class="wp-block-heading">エラーハンドリングの方法</h3>



<p class="wp-block-paragraph">エラーハンドリングには CommandError を活用します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.core.management.base import BaseCommand, CommandError

class Command(BaseCommand):
    model_id = 100  # 存在しないID
    def handle(self, *args, **options):
        try:
            instance = Model.objects.get(pk=model_id)
        except Model.DoesNotExist:
            raise CommandError(f"Model instance does not exists. pk={model_id}")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> django.core.management.base </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> BaseCommand, CommandError</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">class</span><span style="color: #D4D4D4"> </span><span style="color: #4EC9B0">Command</span><span style="color: #D4D4D4">(</span><span style="color: #4EC9B0">BaseCommand</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">    model_id = </span><span style="color: #B5CEA8">100</span><span style="color: #D4D4D4">  </span><span style="color: #6A9955"># 存在しないID</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">def</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">handle</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">self</span><span style="color: #D4D4D4">, *</span><span style="color: #9CDCFE">args</span><span style="color: #D4D4D4">, **</span><span style="color: #9CDCFE">options</span><span style="color: #D4D4D4">):</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">            instance = Model.objects.get(</span><span style="color: #9CDCFE">pk</span><span style="color: #D4D4D4">=model_id)</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #C586C0">except</span><span style="color: #D4D4D4"> Model.DoesNotExist:</span></span>
<span class="line"><span style="color: #D4D4D4">            </span><span style="color: #C586C0">raise</span><span style="color: #D4D4D4"> CommandError(</span><span style="color: #569CD6">f</span><span style="color: #CE9178">&quot;Model instance does not exists. pk=</span><span style="color: #569CD6">{</span><span style="color: #D4D4D4">model_id</span><span style="color: #569CD6">}</span><span style="color: #CE9178">&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<h2 class="wp-block-heading">参考サイト</h2>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><a href="https://docs.djangoproject.com/ja/4.1/howto/custom-management-commands/">How to create custom&nbsp;django-admin&nbsp;commands</a></li>



<li><a href="https://zenn.dev/wtkn25/articles/django-custom-command">[Django]カスタムコマンドを作る</a></li>
</ul>
</div></div>
]]></content:encoded>
					
		
		
			</item>
	</channel>
</rss>
