“GIHOZ”を活用したWeb APIテスト設計の勘所 #GIHOZ #devsumi #devsumiB

Slide 1

Slide 1 text

Slide 2

Slide 2 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ 35年以上にわたりソフトウェア検証で品質向上に貢献 ◼ 仕様などの要求事項が満たされているかを評価する Verification と、機能や性能が本来意図された用途や目的に合っているかを評価する Validation。当社の社名にはこの 2つのV を提供する（Service）という想いが込められています。株式会社ベリサーブ本社東京都千代田区神田三崎町3-1-16 神保町北東急ビル 9階西日本支社大阪府大阪市中央区北浜1-8-16 大阪証券取引所ビル 19階中部支社愛知県名古屋市東区泉2-27-14 関電不動産高岳ビル 13階沖縄テストセンター沖縄県うるま市字州崎14-1 沖縄IT津梁パーク情報通信機器検証拠点施設宇都宮テクニカルセンター栃木県宇都宮市宿郷2-7-3 IRビル宿郷 5階広島テクニカルセンター広島県広島市南区荒神町1-2 日宝荒神町ビル 2階刈谷テクニカルセンター愛知県刈谷市桜町1-24 JS刈谷駅ビル 2階西新宿テクニカルセンター東京都新宿区西新宿6-24-1 西新宿三井ビル 14階社名株式会社ベリサーブ (VeriServe Corporation) 設立 2001年7月24日代表者代表取締役社長新堀義之従業員数 1,371名（2021年3月末時点連結）資本金 792百万円（2021年3月末時点）事業内容 1. 製品検証サービス 2. セキュリティ検証サービス 3. その他サービス子会社株式会社ベリサーブ沖縄テストセンター AIQVE ONE株式会社拠点右記参照

Slide 3

Slide 3 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ 2021年4月に株式会社ベリサーブ入社 ◼ 研究企画開発部サービス開発課課長 / プロダクトマネージャー ◆ ベリサーブ内製のテスト支援プロダクト群の全体統制と普及展開に従事 ➢ 前職は大手SIerにて、全社横断技術部門にて技術開発や商用案件適用支援などに従事 ◼ 2009年～2013年：ソフトウェアテスト技術を中心に ◼ 2013年～2020年：アジャイル開発関連技術を中心に自己紹介 2 朱峰錦司（あけみねきんじ）

Slide 4

Slide 4 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ ソフトウェアテスト技術関連の社外活動にも継続的に従事自己紹介 3 2013年～2019年 2016年～2017年 2021年～ WACATE 実行委員 ICST 2017 運営委員 JaSST nano お世話係出典： https://wacate.jp/ 出典： http://aster.or.jp/conference/icst2017/ 出典： https://jasst-nano.connpass.com/

Slide 5

Slide 5 text

【向こう10年のためのスキル提言】 • 書いたテストのパターンの根拠をチーム内で明快に説明・共有できる • プロダクトの仕様変更時にどのテストを直せばいいか一目瞭然

Slide 6

Slide 6 text

Slide 7

Slide 7 text

Slide 8

Slide 8 text

Slide 9

Slide 9 text

Slide 10

Slide 10 text

Slide 11

Slide 11 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ ソフトウェアテストプロセスのさまざまな工程を支援するプロダクトを内製開発・展開中ベリサーブが提供するソフトウェアテスト支援ツールテスト計画テスト完了テスト分析テスト設計テスト実装テスト実行テストのモニタリングとコントロール業界初のテスト分析/設計支援ツール “今すぐ使える”テスト技法ツール

Slide 12

Slide 12 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ ソフトウェアテストプロセスのさまざまな工程を支援するプロダクトを内製開発・展開中ベリサーブが提供するソフトウェアテスト支援ツールテスト計画テスト完了テスト分析テスト設計テスト実装テスト実行テストのモニタリングとコントロールテスト管理をシンプルに。快適、スケーラブルなテスト管理ツール業界初のテスト分析/設計支援ツール “今すぐ使える”テスト技法ツール

Slide 13

Slide 13 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ ソフトウェアテストプロセスのさまざまな工程を支援するプロダクトを内製開発・展開中ベリサーブが提供するソフトウェアテスト支援ツールテスト計画テスト完了テスト分析テスト設計テスト実装テスト実行テストのモニタリングとコントロール [開発中] 探索的テスト支援ツールテスト管理をシンプルに。快適、スケーラブルなテスト管理ツール業界初のテスト分析/設計支援ツール “今すぐ使える”テスト技法ツールチームによる探索的テストを加速させるツール

Slide 14

Slide 14 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ ソフトウェアテストプロセスのさまざまな工程を支援するプロダクトを内製開発・展開中ベリサーブが提供するソフトウェアテスト支援ツールテスト計画テスト完了テスト分析テスト設計テスト実装テスト実行テストのモニタリングとコントロール [開発中] 探索的テスト支援ツールテスト管理をシンプルに。快適、スケーラブルなテスト管理ツール業界初のテスト分析/設計支援ツール “今すぐ使える”テスト技法ツールチームによる探索的テストを加速させるツール

Slide 15

Slide 15 text

#GIHOZ

Slide 16

Slide 16 text

Slide 17

Slide 17 text

Slide 18

Slide 18 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ ソフトウェアテストの際に、テストケースを作成したり選択したりするための技術の総称 ◼ 具体的な技法はさまざまなものがある ➢ テスト技法を活用することで、なぜそのテストパターンになったのか、を説明可能になるテスト技法とは 17 これだけのテストを書きました！これだけ条件が網羅されていれば問題なさそう！

Slide 19

Slide 19 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ 例：JSTQB（ソフトウェアテストの国際資格である ”ISTQB” の日本版）による分類テスト技法の種類 18 テスト技法ブラックボックステスト技法ホワイトボックステスト技法経験ベースのテスト技法同値分割法境界値分析デジジョンテーブルテスト状態遷移テストユースケーステストその他ステートメントテストデシジョンテストその他その他探索的テストエラー推測チェックリストベースドテスト

Slide 20

Slide 20 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ 適切な技法を選ぶことが難しい！テスト技法を活用する際の課題 19 テスト技法ブラックボックステスト技法ホワイトボックステスト技法経験ベースのテスト技法同値分割法境界値分析デジジョンテーブルテスト状態遷移テストユースケーステストその他ステートメントテストデシジョンテストその他その他探索的テストエラー推測チェックリストベースドテスト

Slide 21

Slide 21 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ 適切な技法を選ぶことが難しい！テスト技法を活用する際の課題 20 テスト技法ブラックボックステスト技法ホワイトボックステスト技法経験ベースのテスト技法同値分割法境界値分析デジジョンテーブルテスト状態遷移テストユースケーステストその他ステートメントテストデシジョンテストその他その他探索的テストエラー推測チェックリストベースドテスト本日はWeb APIのテストについてテッパンのテスト設計のやり方をサンプルを通して紹介します。

Slide 22

Slide 22 text

Slide 23

Slide 23 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ Webサーバ上で動作し、HTTPプロトコルで実行可能なAPI ➢ サーバサイドでのマイクロサービスアーキテクチャの採用や、クライアントチャネルの多様化により、 Web APIの設計およびそのテストは非常に重要な技術要素となっている ◼ Web API Firstを開発の原則としている企業も増えている Web API 22 出典： https://www.commerce21.co.jp/microservices/

Slide 24

Slide 24 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 Web APIのテストの特長 23 テストドライバ・クライアントテスト対象の Web API HTTPリクエスト HTTPレスポンス • 汎用プログラミング言語のテストフレームワーク上に実現 • Postmanやcurlで手動実行 1テストケースは、1往復の”入り” と”出”の対とするのが良い

Slide 25

Slide 25 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ 技法に求められる要件 ◼ 入力と出力の対応のパターンを整理できること ◼ 入力は複数の入力パラメータを扱えること ◆ たとえば認証APIでは、「メールアドレス」と「パスワード」の2つのパラメータを扱う Web APIのテスト設計 24 デシジョンテーブルテスト技法の適用が最適である

Slide 26

Slide 26 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。（参考）テストレベル 25 要件定義基本設計詳細設計実装コンポーネントテスト統合テストシステムテスト受入れテストインタフェースを定義し、そこに対する”入り”と”出” （とその過程）をテストすることがメイン「開発者テスト」のメイン領域「QAテスト」のメイン領域テスト済のインタフェースをつなげて、さまざまな条件で動かしてテストすることがメインより上位テストへのシフトを意識しつつ、まずは仕様ベースの開発テストの第一歩・基礎として、デシジョンテーブルテストの習得は有用

Slide 27

Slide 27 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ 「E2Eテスト」という言葉は、開発現場ごとに意味合いが異なっているので、社外交流の際は要注意 ➢ システムアーキテクチャに対するカバレッジのみが関心ごとの場合（参考）「E2Eテスト」 26 フロントエンドモバイルアプリスマートデバイス ..etc エンドポイントサービス層モデル層データベース

Slide 28

Slide 28 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ 「E2Eテスト」という言葉は、開発現場ごとに意味合いが異なっているので、社外交流の際は要注意 ➢ システムアーキテクチャに対するカバレッジに加え、ユーザのユースケースに対するカバレッジもおさえる場合（参考）「E2Eテスト」 27 フロントエンドモバイルアプリスマートデバイス ..etc エンドポイントサービス層モデル層データベース特定の目的を達成できる 3連続の操作

Slide 29

Slide 29 text

Slide 30

Slide 30 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ 入力データや入力条件の組み合わせに対する処理や出力結果をテーブルにまとめるもの ◼ 1958年頃にGeneral Electric社やSutherland社で考案され、 1960年代にはテスト設計への応用事例が発表されている ◼ ISO 5806:1984、JIS X 0125:1986として規格化もされている ➢ 自然言語で書かれた仕様を論理的に整理する場合に利用できる ◼ このあとの例も、いきなりWeb APIではなく、まずは一般的なビジネス仕様の例をお見せします ➢ デシジョンテーブルに基づいてテストケースを作成する技法を「デシジョンテーブルテスト」と呼ぶデシジョンテーブルとは 29

Slide 31

Slide 31 text

Slide 32

Slide 32 text

Slide 33

Slide 33 text

Slide 34

Slide 34 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。デシジョンテーブルの様式 33 割引率の決定 1 2 3 4 タイムサービス時間内 Y Y Y N 対象商品 Y N N - 会員 - Y N - 15％値下げ X - - - 5％値下げ - X - - 値下げ無し - - X X 表見出し部条件記述部条件指定部動作記述部動作指定部記述部指定部条件部動作部

Slide 35

Slide 35 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ 仕様 ◼ あるショップでタイムサービスによる割引を実施している ◼ 18時から20時までをイブニングサービスタイム、20時から22時までをナイトサービスタイムとし、サービスタイムの対象商品は、イブニングサービスタイムには10%の割引価格、ナイトサービスタイムには15%の割引価格となる ◼ 対象商品の割引価格は、ショップの会員・非会員ともに上記の通りとなる ◼ ショップの会員に限り、サービスタイム時間内であれば、会員特典として対象商品以外の商品も、 5%の割引価格となるデシジョンテーブルの作成例 34

Slide 36

Slide 36 text

Slide 37

Slide 37 text

Slide 38

Slide 38 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ メリット ◼ 入力データや入力条件の組み合わせを網羅的に整理できる ◼ 組み合わせに応じた動作結果を指定することで、仕様を論理的に整理できる ◼ 上手に圧縮するとテストの件数を減らすことができる ➢ デメリット ◼ 入力データや入力条件が多いと表が大きくなりがち ◼ 下手に圧縮するとテスト漏れに繋がるデシジョンテーブルのメリット・デメリット 37

Slide 39

Slide 39 text

Slide 40

Slide 40 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 GIHOZ 39 ソフトウェア開発に関わる全ての人のテスト設計の「作業」をゼロにします。手軽にテストケースを作成・利用 ✔ ✔ ✔ 目的に応じてテスト技法を選択ソフトウェア開発の効率化に貢献クラウド型テスト技法ツールは、各種テスト技法を手軽に利用できるクラウド型ツールです。アカウント登録のみで、すぐに利用が可能です。

Slide 41

Slide 41 text

Slide 42

Slide 42 text

Slide 43

Slide 43 text

Slide 44

Slide 44 text

Slide 45

Slide 45 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。リポジトリを選ぶ/作る 44 ①初期状態では「MyRepository」のみ自動で作成されている ②「リポジトリ作成」を押す ③アルファベット・数字・アンダーバーで入力 ④説明は任意で入力 ⑤実際の業務で使う場合は、基本的には「非公開」を選択。「公開」を選ぶと、URLを知っている人はテストケースを閲覧できるようになるので、選ぶときは注意

Slide 46

Slide 46 text

Slide 47

Slide 47 text

Slide 48

Slide 48 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ 以下の仕様のWeb APIをテスト設計しよう ◼ Twitterのようなマイクロブログアプリで、自身の過去の投稿を更新・上書きするAPI 例題 47  入力 ➢ リクエストヘッダ • 認証時に取得した認証トークン ➢ パス変数 • 投稿ID ➢ リクエストボディ • 投稿本文  出力 ➢ レスポンスヘッダ • HTTPステータス  仕様 • トークンが不正な場合はHTTPステータス401 • 投稿した本人でない場合はHTTPステータス403 • 投稿本文が空か141文字以上の場合はHTTPステータス400 • 更新が成功した場合はHTTPステータス204

Slide 49

Slide 49 text

ライブデモ可能な方は、ぜひGIHOZ登録のうえ、お手元でお試しください

Slide 50

Slide 50 text

Slide 51

Slide 51 text

Slide 52

Slide 52 text

Slide 53

Slide 53 text

Slide 54

Slide 54 text

Slide 55

Slide 55 text

Slide 56

Slide 56 text

Slide 57

Slide 57 text

Slide 58

Slide 58 text

Slide 59

Slide 59 text

Slide 60

Slide 60 text

Slide 61

Slide 61 text

Slide 62

Slide 62 text

Slide 63

Slide 63 text

Slide 64

Slide 64 text

Slide 65

Slide 65 text

Slide 66

Slide 66 text

Slide 67

Slide 67 text

Slide 68

Slide 68 text

Slide 69

Slide 69 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ テスト技法を活用して仕様を整理することで、仕様の不備にも気付きやすくなる例題：仕様更新 68  入力 ➢ リクエストヘッダ • 認証時に取得した認証トークン ➢ パス変数 • 投稿ID ➢ リクエストボディ • 投稿本文  出力 ➢ レスポンスヘッダ • HTTPステータス  仕様 • トークンが不正な場合はHTTPステータス401 • 投稿IDが存在しない場合はHTTPステータス404 • 投稿した本人でない場合はHTTPステータス403 • 投稿本文が空か141文字以上の場合はHTTPステータス400 • 更新が成功した場合はHTTPステータス204

Slide 70

Slide 70 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ https://gihoz.com/users/KinjiAKEMINE/repositories/DevelopersSummit2022/docu ments/decision_table/83fd3da6-5d8a-42a4-a48d-c40452d3a096 ➢ 公開リポジトリはユーザ登録なしでも・ログインしていなくても、全世界から参照可能です！（参考）例題の回答例 69

Slide 71

Slide 71 text

Slide 72

Slide 72 text

Slide 73

Slide 73 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ ソフトウェアテストの際に、テストケースを作成したり選択したりするための技術の総称 ◼ 具体的な技法はさまざまなものがある ➢ テスト技法を活用することで、なぜそのテストパターンになったのか、を説明可能になる [再掲] テスト技法とは 72 これだけのテストを書きました！これだけ条件が網羅されていれば問題なさそう！

Slide 74

Slide 74 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ 適切な技法を選ぶことが難しい！ [再掲] テスト技法を活用する際の課題 73 テスト技法ブラックボックステスト技法ホワイトボックステスト技法経験ベースのテスト技法同値分割法境界値分析デジジョンテーブルテスト状態遷移テストユースケーステストその他ステートメントテストデシジョンテストその他その他探索的テストエラー推測チェックリストベースドテスト

Slide 75

Slide 75 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ 技法に求められる要件 ◼ 入力と出力の対応のパターンを整理できること ◼ 入力は複数の入力パラメータを扱えること ◆ たとえば認証APIでは、「メールアドレス」と「パスワード」の2つのパラメータを扱う [再掲] Web APIのテスト設計 74 デシジョンテーブルテスト技法の適用が最適である

Slide 76

Slide 76 text

Slide 77

Slide 77 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 [再掲] GIHOZ 76 ソフトウェア開発に関わる全ての人のテスト設計の「作業」をゼロにします。手軽にテストケースを作成・利用 ✔ ✔ ✔ 目的に応じてテスト技法を選択ソフトウェア開発の効率化に貢献クラウド型テスト技法ツールは、各種テスト技法を手軽に利用できるクラウド型ツールです。アカウント登録のみで、すぐに利用が可能です。

Slide 78

Slide 78 text

© 2022 VeriServe Corporation 会社名・製品名・サービス名は、各社の登録商標または商標です。 ➢ ソフトウェアテストプロセスのさまざまな工程を支援するプロダクトを内製開発・展開中 [再掲] ベリサーブが提供するソフトウェアテスト支援ツールテスト計画テスト完了テスト分析テスト設計テスト実装テスト実行テストのモニタリングとコントロール [開発中] 探索的テスト支援ツールテスト管理をシンプルに。快適、スケーラブルなテスト管理ツール業界初のテスト分析/設計支援ツール “今すぐ使える”テスト技法ツールチームによる探索的テストを加速させるツール

Slide 79

Slide 79 text