ソフトウェアの分析と設計に関するドキュメントを作成する方法

ソフトウェア プログラムの最終的な目標は、問題を解決することです。問題は、テキスト ドキュメント内の単語のスペルミスをチェックするソフトウェア プログラムのように単純な場合もあれば、データベースの作成に使用されるソフトウェア プログラムのように複雑な場合もあります。問題に関係なく、ソフトウェア プログラムが問題に効果的に対処し、ユーザーがソリューションを作成する手段を提供しない場合、そのソフトウェア プログラムは効果的ではなく、目標を達成できません。優れたソフトウェアの作成は、ユーザーの要件に対応し、ソリューションを提供するための計画を作成する分析および設計ドキュメントから始まります。

問題を定義する

ステップ 1

最初に全体像を見て、要求を評価します。ユーザーが求めていることを確実に理解してください。問題の根本にたどり着くために、「誰が、何を、どこで、いつ、なぜ、どのように」という詳細な質問をします。

ステップ 2

プロジェクトの範囲と制約を定義します。たとえば、本の注文システムをコンピュータ化するソフトウェア プログラムが要求されている場合は、現在の注文システムを最初から最後まで評価します。プロジェクトの境界を定義して確立し、既存のハードウェアやプロジェクト完了までの限られた時間枠など、その範囲内で作業する必要があるプロジェクトの制約を特定します。

ステップ 3

エンドユーザーを見てください。日常的にソフトウェアを使用する人々にインタビューして観察し、要求に対応するためにソフトウェアがどのように機能する必要があるか、およびユーザーのニーズに最適な新しいシステムをどのように設計できるかを判断します。エンド ユーザーのスキル レベルがトレーニング要件にどのように影響するかなど、プロジェクトに影響を与える可能性のあるユーザー関連の要因を特定します。

ステップ 4

実現可能性を判断し、推奨事項を提示します。コスト、利益、完了までの予定、およびソフトウェアが記載された問題に効果的に対処するかどうかについての推奨事項の見積もりを含む、要求の書面による評価を提供してください。

分析および設計ドキュメントの準備

ステップ 1

データ フロー図とプロセスの説明を作成します。データ フロー ダイアグラムはプログラムが何を行うかを説明し、プロセス ダイアグラムはソフトウェア プログラムがそれをどのように行うかを示します。たとえば、書籍注文システムのデータ フロー図とプロセスの説明では、適切な書籍の選択から書籍の在庫への入力までのプロセスを段階的に文書化し、説明します。

ステップ 2

必要なデータ要素を定義および記述し、これらの要素をデータ レコードに結合するデータ ディクショナリを作成します。たとえば、書籍注文システムでは、データ要素の例として、書籍名、ISBN、著者、および価格が含まれます。次に、これらの要素を組み合わせて書籍レコードを形成します。ベンダー名、アカウント番号、営業担当者などの他の要素を組み合わせて、ベンダー レコードを形成できます。

ステップ 3

データ フロー ダイアグラム、プロセス フローの説明、およびデータ ディクショナリを組み合わせて、ソフトウェア プログラムを論理的な記述形式で記述したドキュメント パッケージにします。これを使用して、プログラム プロトタイプまたはソフトウェア プログラムの作業モデルを作成できます。

ヒント

プロジェクトの範囲を明確に定義する利点は、プロジェクトが最初の要求を超えて拡大したときに発生する可能性がある「プロジェクト クリープ」を回避するのに役立つことです。

エンド ユーザーの要件を特定するためのもう 1 つのアイデアは、自由回答形式の質問、限定形式の質問、および回答範囲の質問を組み合わせて調査を作成することです。 「書籍注文システムにどのような機能が必要ですか?」などの質問を含めます。 「毎月何冊の本を注文しますか？」そして「1 から 10 のスケールで、現在の書籍注文システムの非効率性をどのように評価しますか?」

ソフトウェア プログラムの書面による分析および設計ドキュメントを提示することに加えて、プレゼンテーション ソフトウェアを使用して、新しいソフトウェア システムのグラフィカルな表現を追加すると役立つ場合があります。