ADM-001-6 pworld_mail_bulk_save_article_links

← EP-一覧 · 共通前提

概要

一覧上の複数行を一括して記事連携を保存する。成功時は現在のフィルタ・ページに基づき一覧ペイロードを再取得してマージし得る。

POST パラメータ

フィールド	必須	説明
rows	条件付き必須	ネストした配列。各行に mail_id, hall_name, article_target_date, show_in_article（単体更新と同じ検証）
mail_list_page	任意	一覧のページ番号（1 以上。不正時は 1 にフォールバック）
mail_list_subject_search	任意	一覧再取得用フィルタ
mail_list_date_from / mail_list_date_to	任意	同上

挙動

• 現在のフィルタ・ページに対応する 一覧のメール ID 集合と、rows の ID 集合が 件数・内容とも一致しないと PWORLD_BULK_ARTICLE_LINK_COUNT_MISMATCH 等で失敗
• 成功時は updated_count と、一覧再取得用の recent / mail_list_* をマージして返す（マージ失敗時も成功本体は維持）

pworld_mail_archiveテーブルからデータ取得（更新対象）

カラム名	where	検索値
id	○	rows[].mail_id
hall_name
article_target_date
show_in_article

pworld_mail_archiveテーブルからデータ取得（一覧再取得）

カラム名	where	検索値
subject	○	mail_list_subject_search
received_date	○	mail_list_date_from, mail_list_date_to
created_at

成功時 data

message と updated_count に加え、ADM-001-2 のジョブ完了時一覧ペイロード（recent・mail_list_* 系）と同じキーをマージして返す（一覧生成失敗時はベースのみ）。

論理名	物理名	型
メッセージ	message	string
更新件数	updated_count	int

（続きの recent / mail_list_* は ADM-001-2「ジョブ状態 done」表 と同一。）

その他

• ハンドラ先頭で set_time_limit( 120 )（可能な環境のみ）