Sampleアプリ

このページでは、Sampleアプリの画面・バッチ・帳票について、それぞれの役割と画面タイプ、フォルダ名を説明します。
Sampleアプリのセットアップは「環境構築」、画面をコピーして新しい画面を作成する手順は「開発手順」を参照してください。

概要

Sampleアプリは、Haluで作成した、受注管理を題材にしたサンプルアプリケーションです。
18の画面と1つのバッチ処理、2つの帳票が実装されています。

アプリケーションを開発する際は、Sampleアプリの画面をコピーして新しい画面を実装します。

メニュー

ログイン後に表示するメニュー画面です。
タブで表示する項目を切り替えます。項目を選択した場合、各画面に遷移します。
管理者用と一般ユーザ用のどちらを表示するかは、ユーザ詳細の「メニュー名」で設定します。

メニュー（管理者用）

画面タイプ：その他（tabMenu）
フォルダ名：AdminMenu

メニュー（一般ユーザ用）

画面タイプ：その他（tabMenu）
フォルダ名：StartMenu

受注管理

受注一覧

受注を検索し、一覧に表示する画面です。
「訂正」「照会」は、受注明細一覧に遷移し、一覧で選択した受注を表示します。
検索条件の顧客は、顧客選択ダイアログで選択します。
「受注一覧表(ヘッダー)」「受注一覧表(ヘッダー・明細)」は、帳票を出力します（関連：「帳票」）。

画面タイプ：list（一覧照会）
フォルダ名：OrderList

受注明細一覧

受注の明細を登録・訂正・削除する画面です。
受注一覧の「訂正」「照会」から遷移します。
明細の変更は、「実行」で受注1件分をまとめて反映します。
商品は商品選択ダイアログで選択し、数量と単価から小計と合計金額を計算します。

画面タイプ：mainte（1件の登録・訂正・削除）
フォルダ名：OrderDetailListMainte

受注データアップロード

受注データ（CSV）をアップロードし、受注を一括で登録する画面です。
アップロードした受注データは全件をチェックし、エラーが1件でもあれば取り込みを中止して、内容を取込エラー一覧に記録します。
エラーがなければバッチ処理を起動し、受注を登録します（関連：「バッチ処理」）。

画面タイプ：upload（ファイルアップロード・バッチ実行）
フォルダ名：OrderUpload

取込エラー一覧

受注データアップロードで検出したエラーを一覧に表示する画面です。
表示するのは最新の取り込み1回分のみです。

画面タイプ：list（一覧照会）
フォルダ名：OrderUploadErrorList

バッチ一覧

バッチ処理の実行状況を一覧に表示する画面です。
実行状況は、バッチ処理の実行時に自動で記録されます。
「分割画面」は、一覧で選択したバッチ処理のバッチ分割一覧に遷移します。
「処理削除」は、選択したバッチ処理の管理情報を削除します。

画面タイプ：list（一覧照会）
フォルダ名：BatchList

バッチ分割一覧

バッチ処理の実行状況を、分割した単位ごとに一覧に表示する画面です。
バッチ一覧の「分割画面」から遷移し、選択したバッチ処理の分割単位を表示します。
「再処理」は、一覧で選択した分割単位だけを再実行します（関連：「バッチ処理」）。

画面タイプ：list（一覧照会）
フォルダ名：BatchDivisionList

マスタ

顧客一覧登録

顧客を一覧に表示し、一覧の上で登録・訂正・削除する画面です。
「登録」は、追加した行を新規登録、既存の行を訂正として、まとめて反映します。
「削除」は、チェックを入れた行を論理削除します。

画面タイプ：list-mainte（一覧＋行編集）
フォルダ名：CustomerListMainte

商品一覧登録

商品を一覧に表示し、一覧の上で登録・訂正・削除する画面です。
「登録」は、追加した行を新規登録、既存の行を訂正として、まとめて反映します。
「削除」は、チェックを入れた行を論理削除します。

画面タイプ：list-mainte（一覧＋行編集）
フォルダ名：ProductListMainte

ユーザ一覧

ユーザを検索し、一覧に表示する画面です。
「新規登録」「訂正」「照会」「削除」は、ユーザ詳細に遷移します。

画面タイプ：list（一覧照会）
フォルダ名：UserList

ユーザ詳細

ユーザ1件を登録・訂正・削除・照会する画面です。
ユーザ一覧から、それぞれのモードで遷移します。
「実行」は、モードに応じて登録・訂正・論理削除を行います。
パスワードはハッシュ化して保存します。

画面タイプ：mainte（1件の登録・訂正・削除）
フォルダ名：UserDetailMainte

システム

個人用テーマ設定

ログイン中のユーザが使用するテーマ（画面の配色）を選択する画面です。
「実行」は、選択したテーマをログイン中のユーザの設定として保存します。

画面タイプ：list-mainte（一覧＋行編集）
フォルダ名：ThemePersonalListMainte

システム用テーマ設定

システム全体で使用するテーマを選択する画面です。
システム用のテーマは、ログイン画面と、個人用テーマを設定していないユーザの画面で使用します。
「実行」は、選択したテーマを保存し、「削除」にチェックを入れたテーマを物理削除します。

画面タイプ：list-mainte（一覧＋行編集）
フォルダ名：ThemeListMainte

ダイアログ

顧客選択ダイアログ

顧客を一覧から選択し、呼び出し元の受注一覧に返すダイアログです。

画面タイプ：selection（選択ダイアログ）
フォルダ名：CustomerSelectionDialog

商品選択ダイアログ

商品を検索して一覧から選択し、呼び出し元の受注明細一覧に返すダイアログです。

画面タイプ：selection（選択ダイアログ）
フォルダ名：ProductSelectionDialog

エラー（404）

遷移先の画面が存在しない場合に表示する画面です。
フレームワークが自動で表示します。

画面タイプ：なし
フォルダ名：Error404

バッチ処理

受注データアップロードで取り込んだ受注データから、受注を登録するバッチ処理です。
処理は分割して実行し、実行状況はバッチ一覧とバッチ分割一覧で確認します。
バッチ処理の仕組みは「データ移送の仕組み」を参照してください。

フォルダ名：
　・BatchOrderUploadStart（起動用の定義・起動プログラム）
　・BatchOrderUploadProc（処理用の定義）
　・BatchRerun（再処理）

帳票

受注一覧から出力する帳票です。
Excelのテンプレートに値を書き込み、PDFに変換して出力します。
帳票出力の仕組みは「データ移送の仕組み」を参照してください。

フォルダ名：OrderListPrint
テンプレート：ExcelTemplate/Apps/OrderListPrint

受注一覧表（ヘッダー）

受注一覧の検索条件に合う受注を、1行に1件ずつ一覧にした帳票です。

受注一覧表（ヘッダー・明細）

受注一覧の検索条件に合う受注ごとに、ヘッダーと明細を出力する帳票です。
受注ごとにページを分けて、1つのPDFにまとめて出力します。