単体テスト仕様書兼報告書の使い方

単体テスト仕様書兼報告書の使い方

 図2は「DUNGEON」のテンプレートの「単体テスト仕様書兼報告書」です。単体テスト仕様書兼報告書のフォーマットは、こちら(http://www.thinkit.co.jp/images/article/140/3/14031.zip)からダウンロードできます(14031.zip/42.7 KB)。

 当テンプレートの工夫点を挙げてみます。

 1点目は前節で述べた詳細設計書との連携部分です。詳細設計書と別ファイルであるということは、同一ファイルの場合に比べて、作成時の工数増、テスト項目の漏れが発生するリスク増というデメリットがあります。

 しかし、詳細設計書から転記しやすいフォーマットにすることでそのデメリットを解消しているのです。構成として、詳細設計書の章立てごとにシートを分けています。なぜならチェックする内容ごとにシートのフォーマットが異なるからです。極力リスト形式にして汎用性を高めていますが、チェック内容に応じたアレンジを多少することでテスト効率も上がります。今回の例は、弊社パッケージの詳細設計書の章立てを例にしていますが、皆さんは自社の詳細設計書に合わせて、各シートは変更してかまいません。

 2点目は、誰がこれを使用するかという観点での工夫点です。単体テストフェーズの実施手順をおおまかに示すと次のようになります。

1.テスト仕様書を作成する。
2.作成したテスト仕様書をレビューする。
3.テストを実施し、テスト報告書を作成する。
4.作成したテスト報告書をレビューする。

 さて、上記それぞれの手順で、テンプレートを誰が使用するのか考えながら説明しましょう。

実施方法の標準化

 この手順のうち、1.の単体テスト仕様書作成は誰が行うものでしょうか?通常は設計者が詳細設計書に合わせて作成するケースが多いでしょう。しかし、筆者が担当するプロジェクトではプログラマに作成させています。

 その理由としては、まずプログラマに作成させ、そのでき栄えを確認することでプログラマが製造に入る前の理解度を測ることができるからです。また、あらかじめテスト項目を書かせることで、どういった点に注意して製造しなければならないかという品質意識を持たせる教育になるからです。さらには、一般的にはSEよりもプログラマのほうが原価が低いため、コストダウンによる競争力アップにもつながります。したがって、プログラマが作成する以上、プログラマでも書きやすい工夫をしています。

 例えば先の詳細設計書との連携にも関連しますが、詳細設計書から簡単に作成しやすいフォーマットを意識しています。詳細設計書の1チェック項目ごとに、その文言をそのままExcelの行に張り付けていけば完成するようなイメージです。また、作成後に必ず設計者がレビューする運用とし、その際のチェック観点をわざわざ表紙に記載しています。この観点を事前に明示することで、作成する側のプログラマにも品質意識が共有化できるのです。

 では、手順3のテストを実施し報告書を作成するのは誰でしょうか?候補としては実装担当のプログラマ、設計担当のSE、実装担当外のプログラマ、プロジェクトリーダー、専属テスト担当者などを挙げることができます。しかし実は誰でもいいのです。最低限守ってほしいのは実装担当のプログラマ以外の目で1回はテストするという点です。

 その意味で、当フォーマットは計2回の結果を入力できるようになっています。例えば1回目は実装担当プログラマ、2回目は専属テスト担当者が実施というような運用で使用してください。

 「標準化」においては、ドキュメントを作成するだけでは不十分です。なぜなら上記のようにドキュメントを使う際の想定ルールが必ずあるからです。誰がどういった手順で使用するかという運用ルールもきちんと標準化してこそ、ドキュメントが真の効果を発揮すると認識しましょう。

人気記事トップ10

人気記事ランキングをもっと見る

企画広告も役立つ情報バッチリ! Sponsored

ClickHouse Cloudが実現した広告運用SaaS「ATOM」のデータ基盤革新、パフォーマンスを向上しながら、運用負荷とコストを削減 11月11日 6:20 AIで開発が加速する時代、品質保証はどう変わる? Tricentisが示すAIエージェント活用の実像 11月9日 6:45 悪用までの猶予が「1分」に迫るフロンティアAI時代に開発と本番を貫く脆弱性管理が必要 10月29日 8:30 欧州CRA対応とSBOM運用。AI生成コードのOSS混入問題の対策とは ――スニペット単位で検出する「FossID」「Insignary Clarity」によるSBOM運用 9月16日 6:40 PostgreSQLからTiDBへ、稼働中SaaSで進める段階的DB移行の実践と再設計への展望 9月7日 6:30 機能安全開発におけるGoogleTestの活用を支援!「Parasoft C/C++test CT」で実現する効率化&AI連携 4月14日 6:30 【CNDW2025】Grafanaが明かす「オブザーバビリティの哲学」ー最小限の労力で実用的なインサイトを得るには 1月23日 6:30 【CNDW2025】プロダクト急増に備える基盤刷新 ーウェルスナビがECSからEKSへの移行で得た知見とは 1月15日 6:30 【CNDW2025】250環境を5人で運用、構築時間は30分に ーKINTOテクノロジーズが語るインフラ基盤組織の作り方 2025年12月18日 6:30 新たな自動化で熱視線! AIエージェントの「推論能力」を支える2つのコンポーネントとは? 2025年11月28日 6:30