AI開発

システム間連携テストの進め方|発注側が確認する5手順

株式会社Atsumell|9分で読めます
システム間連携テストの進め方

はじめに

「送信した画面には成功と出たのに、受信先に注文がない」。システム間連携では、個々の画面や機能が動いていても、システムの境界で情報が欠けたり、二重に登録されたりします。開発会社に「連携テストは終わりました」と言われたとき、発注側は何を確認すればよいのでしょうか。

この記事では、受注システムから倉庫システムへ出荷指示を送る例を使い、連携テストの対象決めから結果の確認までを5手順で整理します。例の時刻や処理方法は説明用の仮定であり、実際の仕様は連携先と合意してください。

システム間連携テストで確かめること

システム間連携テストは、自社システムと別のシステム・外部サービスとの間で、決めた情報の受け渡しが成立するかを確認する活動です。ISTQBのテストシラバスでは、システム統合テストを対象システムと他システム・外部サービスのインターフェースの確認と位置づけ、運用に近い環境の必要性を説明しています。

単体テストが個々の部品、受け入れテストが利用者の業務上の必要を満たすかを見るのに対し、ここでは境界を越えるやり取りに注目します。名称や担当範囲は案件によって違うため、工程名だけで済ませず、誰が何を確認するかを決めましょう。

例えば、送信側に「受付完了」と表示されても、それが受信側の取り込み完了を意味するとは限りません。受付、処理、業務データへの反映のどこを成功とするかを、双方の担当者が同じ言葉で定義します。

連携テストを進める5手順

1. 連携一覧から対象と責任者を決める

まず、どのシステムから何を送り、どこで受け取るかを一覧にします。APIだけでなく、ファイルの定時送信、通知、メッセージなど、業務に必要な連携を確認します。手作業の受け渡しも対象にする場合は、自動連携と分けて記録します。

IPAの外部インタフェース編は、関連システム間のデータ授受を一覧として整理する考え方を示しています。テスト前にはこの一覧と詳細仕様、実際の連携先を照合し、一本ごとに識別子を付けます。台帳の作り方は外部インターフェース一覧の7項目も参考にしてください。

連携ID・目的送信元→受信先試験時の確認責任
IF-01 出荷指示受注→倉庫受注担当が送信、倉庫担当が受信を確認
IF-02 出荷結果倉庫→受注倉庫担当が送信、業務担当が結果を確認

同じ相手との往復でも、送信するデータや開始条件が異なるなら別に管理します。外部事業者が試験環境を用意できない場合は、代替手段、実接続で未確認の範囲、確認する時期を残します。模擬応答だけで実際の相手との接続を確認済みにはできません。

2. 成功条件と確認地点をそろえる

次に、一つの連携について、開始から業務上の完了までの流れを書きます。例なら「受注が確定する→出荷指示を送る→倉庫が受け付ける→対象の出荷指示が作成される」です。各地点で誰が何を見るかを決めます。

出荷指示の成功条件は、例えば「注文番号が一致し、商品・数量・配送先が指定どおりの指示が1件作成される」。送信時の応答だけでなく、受信結果と業務データを照合します。照合には、注文番号やテスト用の識別子を使い、双方が同じデータを見ていると分かるようにします。

即時連携と夜間のファイル連携では、結果を確認できる時刻が異なります。いつまでに反映されるべきか、どの時計・タイムゾーンを使うかも決めます。期待値が曖昧な項目は合格にせず、決定者と期限を付けた未決事項として扱います。

3. 正常系・異常系・再処理をケースにする

「送れた」だけでなく、業務影響の大きいケースから確認します。各行に事前状態、入力、操作、期待結果、証拠、担当者を付けて、別の人が再現できる形にします。

観点操作の例期待結果として確認する例
正常必須項目をそろえて送る双方で同じ注文番号・数量を確認
不正データ必須の配送先を空にする合意した方法で拒否し、不完全な指示を作らない
連携先停止受信先が利用できない失敗を検知し、通知と再処理の条件が分かる
応答なし受信後に応答を受け取れない状況登録済みか照合し、再送による二重登録を防ぐ
重複送信同じ指示を再送する合意した重複判定どおり、出荷指示の重複を防ぐ

表の結果は一般的な確認例であり、すべてのシステムで同じ動作を保証するものではありません。特に応答がない場合、処理が失敗したとは限りません。照合方法、再送する人、処理済みと判断するキーを決めます。部分的に成功するファイル連携では、何件受け付け、何件を再処理するのかも確認します。

優先順位は、誤出荷や二重請求などの影響、発生しやすさ、復旧の難しさをもとに関係者で決めます。対象外のケースも理由とともに残し、実施件数だけで網羅性を判断しないようにします。

4. 環境・データ・実施順を準備する

送信側と受信側で、接続先、仕様の版、利用可能な日時、担当者をそろえます。自社の試験環境から相手の本番環境へ誤送信しないよう、接続先や権限を開発・運用担当と確認します。メール送信や外部への発注など、試験操作が実業務に影響しない手段も必要です。

テストデータは、正常な注文に加え、境界値、欠損、重複、文字種などを用意します。個人情報は社内規程と相手先の条件に従って扱い、使用・保存・削除の責任を決めます。説明用の架空データでも、実在する連絡先を誤って使わないようにしましょう。

実施順は、環境疎通、正常な1件、必要な異常系、再処理の順に小さく進めると、原因を切り分けやすくなります。相手先に操作やログ確認を依頼する場合は、時間枠と連絡先も先に確保します。

5. 両端の証拠と未完了を確認する

結果には、テストID、日時、環境、実行者、入力の識別子、送受信双方の結果、証拠への参照を残します。証拠に機密情報が含まれる場合は、共有範囲と保存先に注意します。画面の成功表示だけでなく、受信側の反映結果や件数を、合意した範囲で確認します。

失敗した場合は、期待結果と実際の差、再現条件、担当者、次の判断期限を記録します。原因が送信側か受信側かを決めつけず、双方が同じ識別子と時刻を使って調べられる状態にします。修正後は該当ケースの再確認に加え、影響が及ぶ既存ケースを選んで確認します。

完了報告では、実施・合格・失敗・未実施を区別し、模擬環境だけで確認した範囲や相手先待ちも明記します。全件成功という言葉だけで、実接続や障害時対応まで確認したと解釈しないことが重要です。

まず一本の連携から始める

最初は業務影響の大きい連携を一本選び、送信元、受信先、成功条件、失敗時の対応、両端の確認者を書き出してみてください。開発会社には「送信成功の後、受信先で何が確認できるか」「結果が不明なときに誰が照合するか」を尋ねます。

Kakusillは、業務の要求整理と仕様管理を支える上流工程AIワークスペースです。散在する資料から連携に関する決定事項や確認が必要な論点を整理し、関係者が同じ前提で仕様を検討する際の選択肢として確認できます。連携仕様や受け入れ条件の整理から相談したい場合は、Atsumellにお問い合わせください。

#システム連携#結合テスト#要件定義#受け入れテスト#品質管理