「要件定義書のアウトライン作成」完全マニュアル：誰にでも分かるSEのための文章術（4）（1/3 ページ）

「提案書」や「要件定義書」は書くのが難しい。読む人がITの専門家ではないからだ。専門用語を使わず、高度な内容を的確に伝えるにはどうすればいいか。「提案書」「要件定義書」の書き方を通じて、「誰にでも伝わる」文章術を伝授する。

» 2009年11月19日 00時00分公開

この記事は会員限定です。会員登録（無料）すると全てご覧いただけます。

　他の文書と同様、要件定義書はまず文書全体のアウトライン（骨格、構成）をしっかり作り上げてから内容を記述します。今回は、読みやすく分かりやすい要件定義書にするためのアウトライン作成方法を紹介します。

要件定義書の書き方について知りたい方は、以下の記事も参考になります
・マニュアル執筆が怖くなくなる、12の執筆ポイント
・開発工程でSEが書く文書の基本

階層構造で読みやすい文書にする

　要件定義書を作るためには、全体を大見出し＝中見出し＝小見出し（章＝節＝項）の階層構造にします。

　「大見出し」「中見出し」「小見出し」の数を、それぞれ5から10程度にするのは、前回（第3回「分かりやすい提案書はアウトラインが美しい」）紹介した提案書と同様です。見出しの数が多すぎると、読み手が文書の全体像を把握できなくなります。また、1つの項目の記述量を1ページ内に収めるようにします。

要件定義書を構成する項目

　要件定義書に必要な大見出しの項目としては、次のようなものが挙げられます。

システムの概要／システムの構想
機能要求
入力要求と出力要求
システム導入後の業務フロー
品質・性能要求
セキュリティ要求
システム導入の目的と目標

　「システムの概要／システムの構想」、「機能要求」（要求機能）「入力要求と出力要求」（入力イメージと出力イメージ）は中心的な項目です。そのほか、「システム導入後の業務フロー」は、業務とシステムの間の架け橋になる情報を提供するための欠かせない項目です。

　機能に問題がなくても、品質に不備があればシステムの不備になります。そのため、「品質・性能要求」を明確にしておく必要があります。さらに、現在はセキュリティもシステムの重要な要素であり、「セキュリティ要求」も明確にしておきます。

　「システム導入の目的と目標」も重要な項目です。ただ、非常に抽象的な記述になってしまうことがよくあります。それでは読み手に伝わりにくくなってしまいます。そこで、「導入の目標」は「導入の目的」から導き出し、上位＝下位の関係になるものとして整理します。

　まず、「システム導入の目的」は、「顧客や取引先と、BtoBオンライン商取引によりビジネスを効率化し、コストを削減する」や「顧客サービスを向上させる」といった、経営戦略や経営方針などに基づいた、経営陣や上層部のシステムに対する要求（理念的な要求）と考えます。

　一方、「システム導入の目標」は、「在庫率を現在から3割圧縮できるようにする」や「受注の時点で納期を即答できるようにする」といった、何をどれだけ向上・改善させるのかを具体的に示すものです。「導入の目的」の1つひとつに対して、実際の業務を遂行する部署や担当グループ（担当者）など現場の視点で具体化して落とし込んだ「下位の要求」と考えます。このように整理すると、具体的に分かりやすく記述できるでしょう。