上流工程とAI駆動開発 1199上流工程とAI駆動開発
システム例外の書き方
システム例外は利用者が入力を直しても解消しないので、設計書には画面ごとの文言を書かず、共通エラー画面の方式に従うと1行で書く。。91秒の動画で、効果音と画面の字幕だけで進みます。
用語 業務例外 = Business exception、システム例外 = System exception
字幕の全文
- 工数を入力して保存を押したあとに、2つの出来事が起きたとします
- 1つ目は、保存しようとしたプロジェクトがすでに終了していた場合です
- 2つ目は、あるはずのマスタのデータが見つからなかった場合です
- 利用者が自分の入力を直して解決できるのは、どちらでしょうか
- 終了したプロジェクトのほうは、利用者がやり直せば解決します
- ビジネスルールの違反を検知したことを通知する例外が、業務例外です
- 一方、マスタのデータが見つからないほうは、利用者には直せません
- システムが正常稼働している時に、発生してはいけない状態だからです
- この状態を検知したことを通知する例外を、システム例外と呼びます
- 2つの例外は、画面設計書に書く中身も違うのです
- 業務例外は、メッセージIDと埋め込む値と表示位置を書きます
- では、システム例外にも、画面ごとに文言を書くべきでしょうか
- 技術的な中身を画面に出しても、利用者には直せません
- そのうえ、原因を推測できる情報を、外に見せてしまうおそれがあります
- そこで、システム例外のときは、共通エラー画面へ移すと決めておきます
- 共通エラー画面は、画面ごとに作らず、システムで1つに決める画面です
- 画面設計書には、「共通エラー画面の方式に従う」と1行だけ書きます
- 利用者に直せない例外は、共通の方式に従うと1行で書きましょう