テスト印刷(プレビュー)をテストデータ取り込みモードで実行するときのCSVってどういう形式にすればいいの?とお困りの方に、本エントリではCSVの基本的な書式について解説したいと思います。

レイアウトを確認(プレビュー)したい

🕒️2021/6/2

今回は作成中の帳票をプレビューする方法をお伝えします。帳票を設計する上ではもっとも基本的なことですが、私が昔、SVF Cloud Designerで帳票設計を始めた時は、「こう設計すれば、思った通りに表示されるだろう。」という想定だけでガリガリ作ってしまい、いざ印刷してみたらぜんぜん思っていたような帳票ができていないことがありました。手戻りが発生しない為にはこまめなプレビューは非常に重要なことですので、ここでしっかりマスターしてくださいね。下の図はいずれもプレビュー(テスト印刷)した際の出力イメージです。左はCSV...

WingArc TECH BLOG

上位アプリケーションからSVFに渡すときの為だけでなく、用意したCSVでテスト印刷(プレビュー)をすることで、本番運用に近づけたテストが行えますのでとても重要なところになります。

CSVを作成する

CSV作成に際しての特に重要なポイントは次の3点です。

ポイント1:使用可能な区切り文字

区切り文字についてですが、SVFで使用できるヘッダ項目、およびデータ項目の区切り文字にはカンマ「,」、またはタブになります。本エントリではカンマ区切りとして説明します。

ポイント2:文字コード

作成するCSVの文字コードについてですが、特に構築する上位アプリなどの制約がない場合、CSVファイルの文字コードを「UTF-8」にしておくとよいでしょう。これはUTF-8にしておくことで様々な言語での出力に対応できる為です。

ポイント3:1行目は必ずヘッダ名(=フィールド名)にしてください。

なお、可変帳票のためのCSV設計手法については本エントリでは説明しません。

上記のポイントを踏まえてCSVを作成すると、例として下記のようになります。

◆CSVファイルの例(カンマ区切り)

上記はよくある商品発注の明細ですが、1行目にヘッダ名(=フィールド名)が記載されており、2行目以降に実際の明細を記載しています。ここで気を付けなければならないのはカンマ(,)の取り扱いについてです。金額を3桁区切りにしている場合、カンマ記号(,)がデータ中に入ることがあると思いますが、区切り文字としてのカンマ(,)と区別するため、必ずダブルクォーテーション(“)でデータを囲ってください。 

ここまでできたら、あとは必要な数の分だけ、明細を増やせば完成となります。

まとめ

ということで、今回はSVFの最も重要なポイントの1つであるCSVの書式について解説しましたが、いかがでしたでしょうか。
ポイントをしっかり押さえ、こまめなテスト印刷(プレビュー)を繰り返すことで手戻りを防ぐことにつながりますのでここでマスターしておきましょう。