上流工程とAI駆動開発 1199上流工程とAI駆動開発

システム例外の書き方

一覧に戻る

システム例外は利用者が入力を直しても解消しないので、設計書には画面ごとの文言を書かず、共通エラー画面の方式に従うと1行で書く。。91秒の動画で、効果音と画面の字幕だけで進みます。

用語 業務例外 = Business exception、システム例外 = System exception

字幕の全文

  1. 工数を入力して保存を押したあとに、2つの出来事が起きたとします
  2. 1つ目は、保存しようとしたプロジェクトがすでに終了していた場合です
  3. 2つ目は、あるはずのマスタのデータが見つからなかった場合です
  4. 利用者が自分の入力を直して解決できるのは、どちらでしょうか
  5. 終了したプロジェクトのほうは、利用者がやり直せば解決します
  6. ビジネスルールの違反を検知したことを通知する例外が、業務例外です
  7. 一方、マスタのデータが見つからないほうは、利用者には直せません
  8. システムが正常稼働している時に、発生してはいけない状態だからです
  9. この状態を検知したことを通知する例外を、システム例外と呼びます
  10. 2つの例外は、画面設計書に書く中身も違うのです
  11. 業務例外は、メッセージIDと埋め込む値と表示位置を書きます
  12. では、システム例外にも、画面ごとに文言を書くべきでしょうか
  13. 技術的な中身を画面に出しても、利用者には直せません
  14. そのうえ、原因を推測できる情報を、外に見せてしまうおそれがあります
  15. そこで、システム例外のときは、共通エラー画面へ移すと決めておきます
  16. 共通エラー画面は、画面ごとに作らず、システムで1つに決める画面です
  17. 画面設計書には、「共通エラー画面の方式に従う」と1行だけ書きます
  18. 利用者に直せない例外は、共通の方式に従うと1行で書きましょう