チュートリアル

RakAPItでは、APIテストにおけるテストケース作成からテスト実行まで簡単に行うことができます。このチュートリアルを通じて、APIテストをRakAPItでどのように行うか理解することができます。

1. Projectの作成

初めにプロジェクトを作成します。プロジェクトにはOpenAPI(Version2.0 & 3.0)をインポートできます。OpenAPIのAPI定義からTest Objectの作成が簡単にできます。

今回は RakAPIt Cars APIを使います。

  • Step 1: Create Projectカードを押下
  • Step 2: Project Name入力
  • Step 3: Description入力
  • Step 4: Swaggerファイルをインポート
    RakAPIt Cars APIのSwaggerを貼り付けて、Swaggerファイルを取得してください。
  • Step 5: 「OK」ボタンを押下

displayProject
Project作成

2. Test Objectの作成

次にTest Objectの作成を行います。

  • Step 1: 「+ Test Object」を押下
    「Swagger Operation」から元になるOperationを選択します。使用したいOperationを押下してください。
    今回は2ページ目にある GET cars/{id}/json を使います。

    displayProject
    Test Object作成

  • Step 2: 注目したいパラメータを選択するか、Skip ボタンをクリックしてすべてのパラメータを使用します。
  • Step 3: ステップ順にRequestの基本情報入力
    Method, API Endpoint, Header, Bodyの必要情報を入力します。Swaggerファイルを参照した場合は自動入力されるため、手動で入力する必要がありません。
    今回はSwaggerファイルを元にTest Objectを作成しているため、必要な情報が入力されています。
    各Parameterに対して、テストしたいデータパターンを入力します。Swaggerファイルを参照した場合、データパターンを自動生成することができます。
    下記の手順を行ってください。
    1. 「>>」(Generate Data Patterns)ボタンを押下
    2. Parameterを選択。今回はidを選択してください。
    3. 「OK」ボタンを押下

    find_test_object Generate Data Patterns

  • Step 4: Combination methodを選択
  • Step 5: 「Create」を押下

3. テストケースの実行

テストケースの実行を行います。テストケースは「Test case table」または「Test case detail」で実行できます。

  • Test case detail で実行する
    • Step 1: Test case detail モーダルを開く.
    • Step 2-1: 「Send & Save Result」 を押して実行して結果を保存するか、「Send」 を押して結果を保存せずにテストケースを実行します。

      run

    • Step 2-2:「Send」を押下後、結果を保存したい場合は 「Save Result」を押下。

      run

    • Step 3: テストケース詳細でテスト結果を確認
  • Test case table で実行する
    • Step 1: テスト実行するテストケースを選択
    • Step 2: Send & Save Resultボタンを押下してテスト実行
    • Step 3: テストケース一覧でテスト結果を確認

      result Test cases Screen

4. テストケースを自動的に生成

Generate Test cases 機能を使用し、複数テストケースを自動的に作成することができます。

Generate Test cases機能を利用するには、「By Response Code」タブの「Generate Test cases」ボタンを押下、または「By Test Suite」タブの「More」セクションの「Generate Test cases」を押下。

add_testcase

RakAPItはいくつかの自動生成メソッドを提供しています。今回はOpenAIを用いてテストケースを自動生成します。

  • Step 1: OpenAIを用いてテストケースを自動生成ためには「Generate Test cases」 モーダルにGenerate Test cases by OpenAIを選択、または「Generate Test cases by OpenAI」 ボタンを押してください。
  • add_testcase
    "Generate Test cases by OpenAI" モーダルを開く

    add_testcase_openai
    Generate Test cases by OpenAI モーダル

  • Step 2: フォーカスしたい parameters (1-1) と response code (1-2) を選択する。
  • Step 3: 「Generate suggestions of test cases」(2)ボタンを押下.
  • Step 4: 作成したいTest casesを選択し、「Add Test Cases」(3)ボタンを押下。

これでテストケース作成からテスト実行まで一通り行うことができました。詳細の使い方は各項目を参照してください。