メインコンテンツへスキップ
見出し画像

帳票あるある②ーExcel台帳と帳票テンプレートを二重管理していた話

    前回の続きから

    前回は、帳票が設計書で「出力可能」の一行になっていて、その一行が人によって全然違うものを指していた、という話を書きました。

    今回は、その後の流れで起きていたことを書きます。実装が始まってから気づく、少しコードに近い側の話です。

    帳票の「データ」はどこから来るのか

    帳票を出力する、という要件が具体化してくると、最初にぶつかるのが「帳票に載せるデータはどこから取るのか」という問いです。

    画面側のデータはだいたい DB から来ます。が、帳票のレイアウトには、DB に入っていないデータが出てくることがあります。会社のロゴ、部署名の表記ルール、摘要欄に入れる決まり文句、押印欄の位置と担当者名などです。

    こういった項目は、どこかの Excel ファイルに書いてある、というケースを何度か見ています。

    「その情報、K さんが管理してる Excel に入ってます。月初に更新してるやつです」

    この一言が出た瞬間に、少し空気が変わる感覚があります。

    「二重管理」が始まる瞬間

    その Excel を確認すると、帳票の見た目に必要な情報が丁寧にまとまっていることが多いです。担当部署、発行者名、金額の単位表記、様式番号のルール。よく整理されていて、長年の運用で育てられてきた台帳です。

    問題は、そのデータをシステムがどう扱うか、です。

    いくつかの選択肢が出てきます。

    ・Excel のデータをそのまま読み込む
    ・DB に移行して DB から取る
    ・プログラムに定数として直書きする
    ・帳票テンプレートのファイル自体に埋め込む

    どれを選んでも、「業務側が日常的に更新している Excel」と「システム側の何か」の間に、ズレが生まれる構造になります。

    Excel を更新しても、システム側の帳票テンプレートには反映されない。テンプレートを直しても、業務側の Excel には反映されない。そういった状態が続いていくのを、何度か横で見てきました。

    「帳票テンプレートが手元にある」とはどういうことか

    もうひとつ、よく遭遇する場面があります。

    帳票ツールを使っている現場では、「帳票のデザインを変えたいとき」に専用ツールを開いて編集する、という手順が発生します。

    このとき、帳票のテンプレートファイルはどこに置いてあって、誰が管理していて、変更するとどこに影響するか、という情報が暗黙になっていることが多いように見えます。

    「テンプレートはサーバーのこのフォルダにあります。変更するときはバックアップ取ってから上書きしてます」

    そしてその「テンプレート」とは別に、業務担当が日常的に見ている Excel の台帳がある、という状態が続きます。

    印刷に使われるテンプレートと、業務担当が更新する台帳。同じ情報のはずなのに、二か所に分かれていて、どちらが正しいのか分からなくなってきます。

    ライセンスのコストが判断を遅くする

    話を少し横に広げます。

    帳票ツールには、年間の利用料が発生するものがあります。規模によっては、その費用が案件の予算議論に乗るくらいの金額になることもあります。

    私が観測してきた範囲では、このコストをどう扱うかが、設計の早い段階で決まらないことがあります。

    「帳票ツールを使うか、使わないか」の判断が宙に浮いたまま、実装が進む。結果として、中盤になってから「ツールを使うにはコストが見合わない」という話が出てきて、別の方法を急いで探す、というパターンです。

    あるいは逆に、「ツールを使う」前提で進んでいたのに、保守フェーズで「ライセンスを更新しない」という判断が出て、帳票の担当がいなくなる、というケースもあります。

    どちらも、帳票の仕組みを最初にもう少し整理しておけば、と思う場面でした。

    HTML で帳票を作ったときに気づいたこと

    少し前に、小規模な業務システムの帳票を HTML で出力する仕組みを試したことがあります。

    専用ツールを使わずに、HTML と CSS で帳票のレイアウトを書いて、ブラウザの印刷機能か PDF 出力で使う、というシンプルな構成です。

    やってみて気づいたのは、帳票の構造が見えやすくなる、ということでした。

    テンプレートは HTML ファイルで、データは JSON や DB から渡す。CSS で余白やフォントを指定する。印刷時の改ページも CSS で書ける。専用ツールの操作画面がなくても、テキストエディタで見ながら調整できます。

    二重管理の問題が消えるわけではないですが、「どこに何が書いてあるか」は追いやすくなりました。特定のツールのライセンスに依存しないので、保守の引き継ぎも少しやりやすかったです。

    それが、個人的に帳票ライブラリを作り始めたきっかけの一部です。帳票出力をライブラリとして整理することで、コードの中での役割分担が少し明確になりました。まだ開発中の部分もありますが、使った感触としてはシンプルに動く、というのが今の状態です。

    次回

    次回は、帳票の「印刷余白」と「用紙サイズ指定」の話を書こうと思っています。A4 縦で余白を揃えて出力する、という一見シンプルな要件が、現場でどう扱われているか。ブラウザ印刷特有の癖と、それをどう乗り越えたかの記録です。

    帳票の話は続きます。気になる方はフォローから覗いてみてください。

     
     
    昼はサラリーマン。夜はAIとコードを書く。 休みは子供と過ごす。 SIer 17 年の現場感覚を、AI Agent と株自動売買で再現してみた実録です。 教科書ではなく、現場の生データ。 失敗も成功も、隠さずに。

    あなたへのおすすめ