この記事にはアフィリエイト広告を含みます。
「全体の集計だけでなく、工程別の内訳も出してほしい」。小さな仕様変更に見えても、分類の仕方が変わることで、これまで使っていた総件数や平均まで変わることがあります。
確認するのは、追加した機能が要求どおりか、そして維持する既存機能に意図しない変化がないかの二点です。後者を確かめる試験を、回帰テストと呼びます。NASAのソフトウェア工学ハンドブックSWE-191も、変更の影響分析を試験の選定につなげる考え方を説明しています。
この記事では、工場の確認用CSV集計ツールに内訳を追加する架空例で、変更内容と再試験項目を対応づけます。NASAの要求を一般の工場へ一律に適用する説明ではありません。完成させるのは、開発担当と業務担当が「何を、なぜ確かめるか」を合わせるための変更影響・再試験表です。
変更前の仕様と、今回変える要求を並べる
最初に、現在使っているツールの版、入力条件、既存の試験と期待結果をそろえます。稼働中の版や設定が分からない場合は、業務ツールの引継ぎから確認してください。
今回の仮定は、作業時間の記録をまとめるツールv1へ、工程別の件数と平均を追加してv2にする、というものです。設備の指令や製品の合否判定には使いません。次の条件を、変更前後で分けて記録します。
| 要求ID | v1で決めていること | v2での扱い |
|---|---|---|
| R01 | IDは一ファイル内で一意。工程名はAまたはB | 維持。空欄・未知の工程名・ID重複は結果確定を保留 |
| R02 | 時間の単位はs。値は0以上の有限な数、空欄は値不明 | 維持。単位違いを推測で換算しない |
| R03 | 全体の件数、有効値件数、値不明件数、平均を出す。有効0件なら平均は算出不可 | 維持。平均の分母は有効値件数 |
| R04 | 計算途中で丸めず、表示時だけ小数第2位を四捨五入して第1位まで出す | 維持 |
| R05 | summary.csvを既存帳票が読む | ファイル名・列構成・値の意味を維持 |
| R06 | 工程別の出力はない | 新設。工程別内訳を別ファイルへ出す |
これは説明用に決めた仕様です。実際のツールが空欄をそのまま受け入れていたなら、改修のついでにエラー扱いへ変えるのではなく、その変更も別の要求として合意します。
「変更する」「維持する」に加えて、まだ判断できないものには「影響不明」と書きます。例えば、新しいCSVを同じフォルダへ保存してよいかは、そこから別の処理が何を取り込んでいるかを確認するまで決められません。
変更した処理から、結果を使う先までたどる
コードの変更行数が少なくても、共通の処理を変えれば複数の出力へ影響します。次の図は、今回の仮定例で確認する依存関係です。
追加する内訳の手前と後ろも確認する
CSV → 入力確認 → 全体集計 → summary.csv → 既存帳票
同じ入力確認の結果 → 工程別集計【追加】→ 内訳CSV【追加】
要確認:保存先にあるCSVをまとめて読む別の処理はないか。
工程名で分類する際、空欄の行が集計から漏れると、全体の件数まで変わることがあります。また、別ファイルに分けても、既存処理がフォルダ内のCSVをすべて読むなら、内訳まで二重に取り込むおそれがあります。保存先・ファイル名・読取対象を、利用先の担当者と確認します。
| 影響をたどる箇所 | 今回の確認 | 再試験を選ぶ理由 |
|---|---|---|
| 共通の入力確認 | ID、工程名、単位、空欄、数値形式 | 既存の入力条件が追加処理の影響を受けていないか確かめる必要がある |
| 全体集計 | 件数、平均の分母、丸め前の値 | 内訳を追加しても既存結果を変えないという要求がある |
| 工程別集計 | 分類キーと各工程の内訳 | 今回追加する機能そのもの |
| 既存帳票 | summary.csvを読んだ結果 | 出力の列順や意味が変わると利用先へ影響する |
| 内訳CSVの保存先 | 他の処理の読取条件 | 新しいファイルの追加が別処理へ及ぼす影響は未確認 |
資料やコードを見ても範囲を絞れない場合は、試験を広げるか、開発担当へ調査を依頼します。「影響不明」を「影響なし」と読み替えて試験を省かないことが、ここでの要点です。
変わる答えと、変えてはいけない答えを先に作る
次はヘッダーと4件の架空データです。R01〜R04に従い、時間0は有効値、空欄は値不明とします。
record_id,process,time_value,unit
M01,A,10.06,s
M02,A,20.06,s
M03,B,0,s
M04,A,,s
全体の受領件数は4、有効値は3、値不明は1です。時間の合計は30.12 s、全体平均は 30.12÷3=10.04 s、表示は10.0 sになります。この全体結果がv1とv2で一致することを、仕様として求めます。
| 確認する出力 | 受領件数 | 有効値件数 | 値不明件数 | 丸め前の平均 | 表示する平均 |
|---|---|---|---|---|---|
| 全体:維持 | 4 | 3 | 1 | 10.04 s | 10.0 s |
| 工程A:追加 | 3 | 2 | 1 | 15.06 s | 15.1 s |
| 工程B:追加 | 1 | 1 | 0 | 0 s | 0.0 s |
工程AとBの平均を単純に平均すると、(15.06+0)÷2=7.53 sとなり、全体平均と一致しません。有効値の件数が異なるためです。全体平均については、元の有効値から直接計算した値と、丸め前の工程平均を有効値件数で加重平均した値が一致することを確かめます。
丸める順序も、結果を変えます。先に各入力を10.1 s、20.1 s、0.0 sへ丸めると、平均は約10.0667 sとなり、表示は10.1 sです。R04に従って求めた10.0 sとは異なります。表示値だけでなく、丸め前の値と計算対象のIDも照合してください。空欄と0の意味の違いは、欠測とゼロの区別を参照してください。
これらの数値は本記事の仮定仕様から求め、制作時にPythonの十進計算で検算した期待値です。実運用ツールv1・v2を動かした試験結果ではありません。
変更要求と既存試験を、一枚の表につなぐ
次の表は今回の試験計画案です。変更が正しく実装されたかを見るT01と、維持する条件を確かめるT02以降を分けて管理します。実際の結果は、対象版を実行してから記入します。
| 試験ID・対象要求 | 入力・操作 | v2で期待する結果 |
|---|---|---|
| T01・R06 | 上の4件を工程別に集計 | Aは3件・有効2件・表示15.1 s、Bは1件・有効1件・表示0.0 s。値不明はAの1件 |
| T02・R03/R04 | 同じ4件の全体集計 | 4件・有効3件・値不明1件・丸め前10.04 s・表示10.0 s。v1の要求を維持 |
| T03・R01 | M04の工程名を空欄にする。別の試験でM01を重複させる | それぞれ理由を示して結果確定を保留。空欄行の削除や重複の自動除去をしない |
| T04・R02 | M01の単位をmsへ変更。別の試験で時間欄を文字へ変更 | 単位違いと数値形式の不一致を区別して保留。10.06 msを10.06 sとして計算しない |
| T05・R02/R03 | 時間欄を全件空欄にする | 全体4件・有効0件・値不明4件。全体・各工程の平均は算出不可と表示し、0にしない |
| T06・R01/R06 | M02の工程名だけAからBへ変更 | Aの平均10.06 s、Bの平均10.03 s。全体平均10.04 sは不変 |
| T07・R05 | 検証用の既存帳票にsummary.csvを読ませる | 合意した列・件数・平均が読める。読取失敗や列のずれがない |
T04は単位変換機能を追加する試験ではありません。今回の変更要求にない機能まで広げないための確認です。T05のように有効値がない場合の扱いは、本記事ではR03で定めています。実際のツールで変更前の仕様に根拠がなければ、試験前に業務担当と定義します。
既存の試験一覧がある場合は、要求IDと処理の依存関係に照らし、再実行する試験と、その理由を記します。過去の不具合を再現した試験も候補に含めます。今回選ばなかった試験についても、対象外と判断した根拠を残します。試験数を少なくすることを目的にせず、業務への影響と確認可能な範囲から決めてください。
NASAのSoftware Testingの説明も、要求の変更に合わせて試験計画・手順を更新する考え方を示しています。古い試験をすべてそのまま使うのではなく、新しい要求と対応させます。
不一致を見つけたら、期待値を変える前に理由を分ける
v1とv2の出力が違っていても、すべてが不具合とは限りません。次の三つに分け、どの要求に照らして判断したかを残します。
- 意図した変更:工程別の内訳が増えた。新しい要求R06と期待結果に照らして確認する。
- 意図しない変更:内訳追加だけなのに、全体平均が7.53 sになった。R03に合わないので修正対象にする。
- まだ判断できない差:保存先を読む別処理の扱いが不明。担当者へ確認し、利用範囲を保留する。
旧版の出力自体に誤りが見つかった場合も、旧版へ一致させればよいわけではありません。仕様の誤りか実装の不一致かを調べ、必要なら別の変更要求にします。期待値を変更するときは、新旧の値、根拠、承認した人、影響する試験を記録します。
変更影響・再試験の記録欄
変更ID/ツール旧版・候補版/要求の版:
変更要求ID/影響する入力・処理・出力・利用先:
試験ID/選んだ理由/入力データの版:
期待結果と根拠/実際の結果と保存先:
状態:一致・不一致・未実行・影響不明
修正・追加確認の担当/再確認する条件:
採用判断者/利用を認める範囲/切替・戻す条件:
開発担当へ渡す際は「前の機能を壊さないで」だけでなく、維持する要求IDとT02〜T07のような期待結果を添えます。新規開発から依頼条件を作る場合は、CSV集計ツールの外注と検収を参照してください。
少量の確認なら、複製したCSVとExcel、手作業での集計、既存の試験表でも始められます。AIに変更差分や試験候補の整理を補助させることもできますが、影響範囲が網羅されたか、期待値が要求に合うかは人が確認します。社内で保守できる人がいなければ、変更要求と影響不明の項目をまとめ、既存の保守窓口や開発担当へ相談します。
採用前には、試験した候補版と実際に切り替える版が同一か、不一致や未実行が残っていないかを確認します。切替後の確認と戻す条件は、データへの影響も含めて業務責任者と決めます。試験が通った範囲を、あらゆる入力や実環境で欠陥がないことの保証と読み替えないようにします。
外部の開発会社を探す場合
社内の担当者や元の開発者では改修・調査を進められない場合は、外部の開発会社へ相談する選択肢もあります。依頼前に、変更要求、維持する結果、影響不明の箇所、期待値付きの試験表をまとめます。これらは、相談先を探すときにも、その会社へ任せる範囲を決めるときにも材料になります。
PR:発注先選定の補助として発注ナビを利用する場合
発注ナビの公式説明では、IT分野の発注先選定を支援するサービスとして案内されています。法人・個人事業主として開発会社を探す場合の補助的な選択肢です。既存ツールの改修や回帰テストに対応できるか、調査・実装・試験のどこまでを依頼できるか、費用と成果物はどうなるかは、相談先の開発会社へ個別に確認してください。会社の紹介は、この記事の試験の実施や合格を保証するものではありません。
個別の変更範囲の整理で迷う場合は、XのS1N_seigitechへ困りごとの概要をDMでお知らせください。機密資料や個人情報は送らないでください。DMが使えない場合はお問い合わせページをご利用ください。
資料確認・期待値の検算日:2026年11月1日。入力・仕様・試験表は架空の設計例であり、実企業の改修・受入試験を実施した記事ではありません。