こんにちは、UPSHARE AIエンジニアです。業務自動化やAIエージェントの実装を担当しています。今回は、私たちが取り組んでいる「雇用契約ジェネレーター」のような、書類自動生成アプリを開発する際に直面する「表示項目の制御」という課題についてお話しします。
なぜ「表示しない」制御が重要なのか
雇用契約書には、正社員、アルバイト、契約社員といった雇用形態ごとに、記載すべき項目とそうでない項目が存在します。たとえば、アルバイトであれば「契約期間の定め」や「更新の有無」が必須ですが、無期雇用の正社員には不要な場合があります。すべての項目を一つのフォームに詰め込むと、入力者は「どこを埋めればいいのか」と迷い、結果として入力ミスや手戻りが発生します。システム側で「条件に応じて項目を動的に隠す」ことは、単なるUIの工夫ではなく、業務の正確性を担保するための重要な設計判断です。
条件分岐の設計：データモデルとUIの連動
項目制御の基本は、雇用形態をキーにした条件分岐です。実装において重要なのは、フロントエンドの表示制御と、バックエンドのバリデーション（入力値の検証）を一致させることです。よくある失敗は、画面上では項目を隠したのに、裏側のデータ送信時にその項目が「空」として処理され、PDF生成時にエラーを吐くケースです。私たちは、雇用形態という「親」の選択肢に対し、表示すべき「子」の項目群を定義するマッピングテーブルを作成し、選択が切り替わった瞬間にフォームの構成を再描画する設計を採用しています。
Word・PDF整合の落とし穴
システムで生成したデータをWordやPDFに流し込む際、最も注意すべきは「空欄の扱い」です。Wordテンプレートに差し込み項目を配置する場合、データが空の項目をそのまま出力すると、書類上に不自然な空白や、プレースホルダー（例：{contract_period}）がそのまま残ってしまうことがあります。これを防ぐには、テンプレートエンジン側で「値が空の場合は行ごと削除する」あるいは「該当箇所を空白ではなくハイフンで埋める」といった条件分岐をテンプレート内に持たせる必要があります。ドキュメントの整合性を保つには、アプリ側のロジックだけでなく、出力先であるWordファイルの構造まで考慮した設計が不可欠です。
実務で確認すべき判断基準
開発者として、また業務効率化を考える立場として、以下の手順で制御を設計することをお勧めします。
- 必須項目の洗い出し：労働基準法や関連法規に基づき、雇用形態ごとに「絶対に記載が必要な項目」をリスト化する。
- デフォルト値の定義：「空」を許容するのか、あるいは「該当なし」と印字するのか、法的な観点からルールを決める。
- プレビュー機能の実装：最終出力前に、不要な項目が正しく消えているかを確認できるプレビュー画面を必ず設ける。
雇用契約書は、会社と労働者の信頼関係の基礎となる書類です。システムで自動化するからこそ、こうした細かい制御の積み重ねが、結果として「安心できる契約」につながると考えています。同じようなアプリ開発や業務効率化でお悩みの方は、ぜひお気軽にお問い合わせください。
