0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

提出前の Word・Excel の「書き忘れ欄」を80行の Python で見つける

0
Posted at

はじめに

申請書・応募票・届出の書式など、「配られた Word や Excel の欄を埋めて送る」作業は開発の外にもたくさんあります。私は最近、この記入を AI エージェントに任せて人は確認だけする運用にしているのですが、一度 宣誓欄が 1 つ空いたまま提出してしまい、書類不備で受け付けてもらえませんでした。

本文は何度も読み返していたのに、表の右端にある小さな「生成AIの利用:」の欄だけ見落としていました。人の目も AI の目も「読む」ことには強い一方、「空いている所を探す」ことには弱いと痛感しました。

そこで、提出の直前に必ず流す空欄チェッカーを書きました。python-docx と openpyxl だけで、80 行ほどです。

何を「空欄」とみなすか

書式の空欄には、だいたい次の 3 つの形があります。

形 例 判定
ラベルの後ろが空 生成AIの利用: 全角・半角のコロンの後ろが空白や _ だけ
表の右隣が空 ` 電話番号
Excel の見出しの右が空 B3: メール / C3: 空 見出しセルの右 3 列が全部空

コードの中心は 1 本の正規表現です。

import re
BLANK = re.compile(r"[::]\s*[\s __]*$")

全角スペース   と全角アンダーバー _ を入れておくのがポイントです。日本の書式は「氏名:____」のように下線で欄を描いていることが多く、半角だけ見ていると素通りします。

Word(docx): 段落と表を両方見る

from docx import Document

def check_docx(path):
    d = Document(path)
    hits = []
    for i, p in enumerate(d.paragraphs):
        t = p.text.strip()
        # 長い文はコロンで終わる本文(「次のとおりです:」など)なので除く
        if t and len(t) <= 40 and BLANK.search(t):
            hits.append((f"段落{i}", t))
    for ti, tbl in enumerate(d.tables):
        for ri, row in enumerate(tbl.rows):
            cells = [c.text.strip() for c in row.cells]
            for ci, c in enumerate(cells):
                if c and BLANK.search(c):
                    hits.append((f"表{ti}行{ri}", c))
                if c and ci + 1 < len(cells) and cells[ci + 1] == "" and len(c) <= 20:
                    hits.append((f"表{ti}行{ri}", c + " →(右が空)"))
    return hits

document.paragraphs には 表の中の文字が含まれません。応募票の大半は表なので、document.tables も必ず回します。また「40 字以下」「20 字以下」という長さの条件は、本文の文章を欄と誤認しないための足切りです。これが無いと「以下のとおり報告します:」のような本文が大量に引っかかります。

Excel(xlsx): 結合セルの右端から数える

import openpyxl

def check_xlsx(path):
    wb = openpyxl.load_workbook(path)
    hits = []
    for ws in wb.worksheets:
        merged = {(r.min_row, r.min_col): r.max_col for r in ws.merged_cells.ranges}
        for row in ws.iter_rows():
            for c in row:
                v = c.value
                if not (isinstance(v, str) and v.strip() and len(v) <= 20 and c.column < ws.max_column):
                    continue
                left = ws.cell(row=c.row, column=c.column - 1).value if c.column > 1 else None
                if left not in (None, ""):
                    continue  # 左に文字があるセルは「値」の側
                end = merged.get((c.row, c.column), c.column)
                rights = [ws.cell(row=c.row, column=k).value
                          for k in range(end + 1, min(end + 4, ws.max_column + 1))]
                if rights and all(x in (None, "") for x in rights) and not v.strip().startswith(("※", "(", "(")):
                    hits.append((f"{ws.title}!{c.coordinate}", v.strip() + " →(右が空)"))
    return hits

Excel の書式は見出しが B3:D3 のように 結合セル になっていることがよくあります。単純に「右隣」を見ると結合の中の空セルを拾ってしまうので、merged_cells.ranges から結合の右端の列を引き、そこから右を見ます。「左に文字があるセルは値の側」という条件で、記入済みの値そのものを見出しと誤認するのも防いでいます。

任意の欄は「報告するが失敗にしない」

「※該当する場合のみ」「任意」の欄まで失敗にすると、毎回止まって使われなくなります。そこで別の正規表現で弱い扱いにしました。

SKIP = re.compile(r"(該当する場合|任意|※)")
...
soft = bool(SKIP.search(t))
print(f"[{'任意' if soft else '空欄'}] {f.name} {where}: {t}")

最後に空欄の数を出し、1 件でもあれば終了コード 1 で終えます。

$ python -I tools/blank_fields.py sample.docx sample.xlsx
[空欄] sample.docx 段落1: 生成AIの利用:
[空欄] sample.docx 表0行1: 電話番号 →(右が空)
[空欄] sample.xlsx Sheet!B3: メール →(右が空)
空欄 3 件
$ echo $?
1

終了コードで返すので、AI エージェントの手順書に「提出前に blank_fields.py を流し、空欄 0 件になるまで提出しない」と 1 行書くだけで、確認が仕組みになります。人が「ちゃんと見たか」を信じる必要がなくなりました。

はまった所

  • パスワード付きの docx・xlsx は読めない: 提出用に暗号化したファイルは開けないので、例外をつかまえて「暗号化前のファイルを渡して」と表示するようにしました。
  • ~$ で始まるファイル: Word や Excel を開いている間にできるロックファイルです。フォルダごと渡すと拾ってしまうので、名前で除きます。
  • チェックボックス □: 「□ はい □ いいえ」のどちらにも印が無い状態も空欄です。必要なら ^[□\s はいいえ]+$ のような判定を足すと拾えます。

まとめ

  • 「読む」確認と「空いている所を探す」確認は別物。後者は機械に任せたほうが確実
  • 日本の書式は全角コロン・全角スペース・全角アンダーバーまで見る
  • Word は段落と表の両方、Excel は結合セルの右端から数える
  • 終了コードで返して、人や AI の手順に組み込む

80 行の小さなスクリプトですが、これを入れてから同じ不備は一度も出ていません。書類を扱う作業がある方は、提出フォルダの前に一枚かませてみてください。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?