ヴィシュア・ソリューションズ


サポート
登録する
ログイン
無料トライアルを開始

優れた要件の書き方

優れた要件の書き方

目次

ソフトウェア開発プロジェクトの最も重要な部分の XNUMX つは、詳細で正確な要件を作成することです。 何を構築する必要があるかを明確に理解していなければ、高品質の最終製品を作成することはできません。 残念ながら、適切な要件を記述することは、言うは易く行うは難しです。 不十分な要件を作成する主な理由は、適切な要件を作成するためのトレーニングや経験がないためです。 あなたやあなたのスタッフが適切な要件を書くのに問題がある場合は、適切な要件を書く方法についてのガイダンスが役に立つかもしれません。 時間をかけてより良い要件を作成する方法を学ぶことで、ソフトウェア開発プロジェクトの全体的な品質を向上させることができ、将来の多くの頭痛の種から解放されます。

要求仕様とは?

要件仕様は、要件を定義、文書化、および分析するプロセスです。 開発を開始する前に、すべての利害関係者がソフトウェアの機能に同意することを保証するため、これはソフトウェア開発の重要な部分です。 こうすることで、後で誤解ややり直しの可能性を減らすことができます。

ドキュメントとも呼ばれる要件仕様は、システムとユーザーのすべての要件をドキュメントの形式で書き留める、または書き出すプロセスです。 これらの要件は、明確、完全、包括的、かつ一貫している必要があります。

適切な要件を記述することが重要なのはなぜですか?

優れた要求仕様を持つことには多くの利点があります。 それらのいくつかを以下に示します。

  • すべての利害関係者が、開発されるシステムについて共通の理解を持つようにするのに役立ちます。 これにより、開発の後の段階での誤解を避けることができます。
  • 開発プロセス中のすべての利害関係者の参照ポイントとして機能します。
  • 要件のギャップを早い段階で特定するのに役立ちます。
  • 要件の変更による手直しが回避されるため、開発の全体的なコストと時間が削減されます。

優れた要件を作成することで、何を達成できますか?

優れた要件が達成に役立つことがたくさんあります。 それらのいくつかを以下に示します。

  • 優れた要件は、開発中のシステムがユーザーのニーズを満たすことを保証するのに役立ちます。
  • これらは、システムをテストして期待どおりに動作することを確認するための基礎として機能します。
  • 要件の変更によるやり直しを回避することで、開発の全体的なコストと時間を削減するのに役立ちます。
  • 優れた要件は、開発プロセスをより効率的かつ効果的にするのに役立ちます。

要件を記述する際の課題

要件を作成するときに人々が直面するさまざまな課題があります。

事務処理が不十分 – 一部の組織では、プロセスの文書化が存在しないか、標準に達していません。 この場合、要件の収集は XNUMX 段階のプロセスになります。最初に既存のプロセスをリバース エンジニアリングし、次に改善と最適化が必要な領域を特定します。 要件が具体的で正確であることを確認するには、主要な利害関係者と対象分野の専門家を特定し、直接関与することが重要です。 ビジネス プロセス マップの描画とワークフローの視覚化は、そのための XNUMX つの優れた方法です。 これは、全体像を提供しながら、誤った仮定を排除するのに役立ちます。 プロセス マップの描画とプロセスの表示は、この目的に役立つ XNUMX つの方法です。

相反する要件 – 利害関係者がビジネス目標に対して異なる優先順位を持っている場合、これは互いに競合する要件につながります。 このような場合、ビジネス アナリストの責任は、すべての要件を詳細に文書化し、どの要求が相反するかを特定し、利害関係者が優先順位を決定する機会を与えることです。

利害関係者の意見を聞くことなく決定を下すことはできません。また、ビジネス アナリストとして、何を優先すべきかについていくつかのアイデアを持っているかもしれません。 利害関係者の視点を聞くことは依然として重要です。 世論調査を設定することは、大多数の利害関係者にとって何が最も重要かを明確にする方法の XNUMX つかもしれません。

ユーザー入力の利用不可 – いくつかの理由により、エンド ユーザーが利用できなくなる可能性があり、それぞれに独自の解決策が必要です。 たとえば、エンド ユーザーが日常業務に没頭しすぎて、要件収集活動に参加したくない場合があります。

このような場合、ビジネス アナリストができる最善の方法は、エンゲージメントの数と長さを制限することです。 会議の前に、できるだけ多くの調査を行うと、議論がより組織的で有益なものになります。 これは、要件の収集を要件の検証セッションに変えるようなものです。 フォーカス グループを定義し、各グループに最適なエンド ユーザーを特定する

経験ではなくインターフェースに焦点を当てる – 多くの利害関係者とエンド ユーザーは、新しいソリューションがどのように表示されるべきかについて明確なビジョンを持っていますが、それが何を達成すべきかを知りません。 どのシステムのユーザー インターフェイスも重要ですが、機能を定義したり干渉したりしてはなりません。

ビジネス アナリストは、ドキュメント内で設計要件と機能要件を区別することを常に忘れないでください。 設計ドラフトではなく、ダイアグラム、ユーザー ストーリー、ローファイ プロトタイプなどのより一般的なツールを使用することで、要件収集の機能面に集中することができます。

利害関係者のインプット – 利害関係者またはエンドユーザーが、システムが何をすべきかではなく、システムがどのように機能すべきかを設計者に伝えようとすると、最適ではない設計につながる可能性があります。 これを回避するには、「なぜ?」と尋ねて、潜在的な「誤った要件」を検証します。 解決が必要な本当の問題に到達するまで。

コミュニケーションの問題 – ビジネス アナリストと他の関係者の間の誤解につながる可能性のある問題には、言葉の壁、間違った前提、不十分な語彙の説明、専門用語の乱用などがあります。

この問題を回避するための理想的なアプローチは、頻繁に対話し、双方向の会話を展開することです。 発見したニーズを文書化し、ピア レビューとさまざまな主題の専門家への批評のために提出し、専門用語の用語集を作成し、前提を再確認します。

一連の正しい要件のルール

要件が「正しい」と呼ばれるために遵守しなければならない特定の規則があります。

  • 完全 – 要件ドキュメントには、開発チームとテスターが製品を完成させ、バグなしでユーザーの要件を満たしていることを確認するのに十分な情報を含める必要があります。
  • 一貫性 – 一貫した詳細レベルを維持します。 たとえば、ユーザーの要件については、エンド ユーザーをすべての文の主語にする必要があります。 同様に、システム要件については、システムをすべての文の主語にする必要があります。
  • 変更可能性 – 要件は、プロジェクトのライフサイクルを通じて変化する可能性があります。 要件ログは保存する必要があり、変更が他の要件やプロジェクト要素に与える影響を分析できる必要があります。
  • 優先順位付け – 要件は重要度の観点から分類する必要があります。 システムに必要なすべての特性が等しく重要であるとは限りません。 そのためには、組織レベルで要件の優先順位を定義するルールを確立し、それを各プロジェクトに適応させることが役立つでしょう。 また、ユーザーが要件に優先順位を付けることができるように、ユーザーと協力してください。

より良い要件を作成するための 20 のヒント

組織ごとに異なる作業方法があるため、要件のセットも異なります。 したがって、要件管理のプロセスもさまざまです。 しかし、一貫していることの 20 つは、要件の記述の基本です。 以下は、より良い要件を作成するための XNUMX のヒントです。

  1. 一つずつ – 各要件は個別のテスト ケースとして扱う必要があります。 and、or などの接続詞は、要件を見逃す可能性があるため、使用しないでください。 このような用語は、ソフトウェア開発者やテスターが要件を見落とす可能性があるため、これは特に重要です。 複雑なニーズを小さな部分に分割して、それぞれを個別にテストできるようにすることは、これを防ぐ XNUMX つの方法です。

  1. 「どのように」ではなく「何を」話す – システムがどのように機能するかではなく、システムが何を実行するかに焦点を当てる必要があります。 さらに、フィールド名、プログラミング言語オブジェクト、ソフトウェア オブジェクトなどの設計トピックを深く掘り下げないようにしてください。 要件仕様ドキュメントでこれらのトピックについて議論していることに気付いた場合は、一歩下がってください。これは、具体的になりすぎている可能性があります。

  1. 検証可能 – 要件を整理する際に留意すべきもう XNUMX つのことは、要件は常にテスト可能である必要があるということです。 これは、システムが問題の要件を満たしていることを確認できる必要があることを意味します。 これは、次のポイントであるトレーサビリティにもつながります。 要件があいまいな用語でいっぱいの場合、システムが実際にこれらの基準を満たしているかどうかを分析して検証するのが難しくなります。 したがって、要件の収集があいまいなプロセスにならないように、できるだけ明確で正確な言語を目指してください。

  1. トレーサビリティ – プロジェクト管理におけるトレーサビリティとは、要件がプロジェクト内の他のコンポーネントにリンクされていることを確認することです。 これにより、プロジェクト マネージャー、開発者、および利害関係者は、システムの他の部分だけでなく、すべての方向で要件のライフサイクル全体を最初から最後まで追跡できます。 トレーサビリティを適切に管理すれば、どの要件にも対応しないコード (「浮遊」コード) を回避し、すべてのテスト ケースが少なくとも XNUMX つの要件をカバーするようにすることができます。 一意の識別子でラベルを付け、すべてのチーム メンバーがアクセスできる中央リポジトリにソースに関する情報を提供することで、要件を追跡可能にすることができます。

  1. 実現可能な – プロジェクトの予算とタイムラインが実現可能であり、利用可能なリソースがあることを確認します。 これらの条件が要件をサポートできる場合は、計画を進めることができます。

  1. 一貫性 – 一貫した詳細レベルを維持します。 たとえば、ユーザーの要件については、エンド ユーザーをすべての文の主語にする必要があります。 同様に、システム要件については、システムをすべての文の主語にする必要があります。

  1. 例外 – 要件にエスケープ句を含めることはできません。 たとえば、「ユーザーが明らかに間違ったユーザー名を入力した場合を除き、システムはログイン試行回数を決定します」。

  1. アクティブボイス – 常に能動態で書き、俳優の XNUMX 人がすべての文の主語になるようにします。

  1. 「手放し」条項にノーと言う – but、except、and only if needed などの言い回しは避けてください。

  1. 略語なし – すべての要件は、頭字語や専門用語を使用せずに完全な文にする必要があります。

  1. 主語と述語 – すべての要件には、主語 (ユーザー/システム) と述語 (意図した結果、アクション、または条件) が必要です。 

  1. 明快さ – のような頭字語の使用によるあいまいさを避ける など、約。 等が挙げられる。

  1. 適切な条件を使用する – テスト ケースを定義しようとすると、ユーザー フレンドリー、汎用性、堅牢性などの未知の用語が問題を引き起こす可能性があります。 これらの言葉は、多くの場合、人によって意味が異なります。

  1. 投機は損害を引き起こす可能性があります – 推測しないでください。 問題外の機能のリストを作成しないでください。 システムにすべての予期しない障害を処理してほしいと言うのは、まったくの空想です。システムが 100% 希望通りになることは決してないからです。 重複や矛盾する記述は避けてください。

  1. オプションを避ける – アイデアやオプションを提供しないでください。 これらは、may、might、could、または should というフレーズを含むステートメントで見つけることができます。

  1. 整理された事務処理は驚くべきことを行います – ドキュメントの読みやすさを改善し、複数のソースを相互参照して時間を無駄にしないように、要件を XNUMX か所にまとめます。

  1. 私たちが持っているものと話してください – まだ定義されていない要件を参照しないでください。 あなたの目標は、文書をできるだけ読みやすくすることです。

  1. 何をどこで使用する必要がありますか? – 要件が述べられている場合は「しなければならない」を使用する必要があり、「意志」は事実の記述を表すために使用する必要があります。 & 「すべき」は、達成すべき目標を表します。

  1. 正解 – すべての文が完全であり、適切な主語、動詞、および述語を使用して文法的に正しいことを確認してください。

  1. フォーカス – とりとめのない、長すぎるフレーズ、および古い論文への言及を排除して、焦点を確立します。

視界要件ALMプラットフォーム

視界要件ALMプラットフォーム は、世界中のあらゆる規模の組織の要件管理に特化した、最も信頼できるアプリケーション ライフサイクル管理プラットフォームの XNUMX つです。 Visure の主要なパートナーには、ビジネスに不可欠な企業や安全に不可欠な企業が含まれます。 同社は、リスク管理、問題と欠陥の追跡、トレーサビリティ管理、変更管理、および品質分析、要件のバージョン管理、強力なレポート作成などのさまざまな分野を含むアプリケーション ライフサイクル管理プロセス全体を統合します。

機能要件と非機能要件の両方に役立つ要件管理ツールをお探しの場合は、Visure Requirements をご覧ください。 このプラットフォームを使用すると、プロジェクトのすべての要件を XNUMX か所で簡単に作成、管理、追跡できます。

まとめ

優れたソフトウェアを作成するには、適切に記述された要件仕様を持つことが重要です。 このドキュメントでは、顧客のニーズと、顧客の期待に応えるためにシステムが何をする必要があるかについて概説します。 ただし、適切な要件を記述することは困難な場合があります。 従わなければならない多くの標準とガイドラインがあり、使用する言語とツールに応じて、それらを記述するさまざまな方法があります。 Visure Requirements ALM Platform では、ベスト プラクティスと業界標準を使用して効果的な要件仕様を作成する方法を説明するコースを提供しています。 このコースでは、構造からフォーマットまで、要件ドキュメントのすべての重要なコンポーネントと、要件を記述するためのさまざまな言語の使用方法について説明します。 また、優れた要件の特徴を強調しているため、チームが気に入って作業できるドキュメントを作成できます。 効果的な要件の記述について詳しく知りたい場合は、 要件仕様コース 今日、Vision Requirements ALM プラットフォームで!

この投稿を共有することを忘れないでください!

トップ

不十分な要件管理による高いコスト

06年6月2024日

東部標準時午前11時 |中央ヨーロッパ時間午後 5 時 |午前8時(太平洋標準時)

ルイ・アルドゥイン

ルイ・アルドゥイン

メインスピーカー

非効率的な要件管理の影響と解決策

非効率的な要件管理の実践がプロジェクトのコストとスケジュールに与える重大な影響を調査します。