タグ設計ルール（再利用しやすい運用）
タグ設計を最初に整えると、後工程の修正コストが大きく下がります。このページでは、実務で使える命名ルールと失敗しない同期設計をまとめます。
1. 命名の基本ルール
- 英小文字 + アンダースコアで統一（例:
client_name） - 意味単位を明確にする（
nameだけでなくapplicant_name） - 同じ意味なら同じタグ名を使い回す
2. 推奨タグ一覧（例）
| 用途 | 推奨タグ | メモ |
|---|---|---|
| 申請者名 | applicant_name | 帳票をまたいで共通化しやすい |
| 住所 | applicant_address | 都道府県/市区町村分割時はサフィックス追加 |
| 提出日 | submission_date | 表示形式は出力前に統一確認 |
| 案件番号 | case_id | 外部システム連携時に有効 |
| 金額 | amount_total | 税込/税抜は別タグで管理 |
3. 失敗しやすいパターン
clientNameとclient_nameが混在して同期が切れるname_1,name_2のように意味のない連番で保守不能になる- 帳票ごとに微妙に違うタグ名を作って再利用性が落ちる
4. 保守しやすい設計手順
- 最初に共通項目（氏名/住所/日付/案件番号）だけタグ辞書を決める
- ページ配置後に同名タグ同期を確認する
- 提出前チェックで表記ゆれを検出して辞書を更新する
- 完成したタグ辞書をZIP運用に含める
運用メモ: タグ設計ルールは「使う人が増えるほど効きます」。担当者ごとの癖を吸収するため、チーム共通ルールとして固定するのが最も効果的です。
最終更新日: 2026-03-11