テスト スイート

テスト スイートに関する情報を取得したり、テスト スイート作成または変更するには、次の API メソッドを使用します。

get_suite

既存のテスト スイートを返します。

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
GET index.php?/api/v2/get_suite/{suite_id}
GET index.php?/api/v2/get_suite/{suite_id}
GET index.php?/api/v2/get_suite/{suite_id}

パラメーター

名前 タイプ 必須 説明
suite_id integer true テスト スイートの ID

レスポンスの内容

典型的なレスポンスについては、下記を参照してください。

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
{
"description": "..",
"id": 1,
"name": "Setup & Installation",
"project_id": 1,
"url": "http:///testrail/index.php?/suites/view/1"
}
{ "description": "..", "id": 1, "name": "Setup & Installation", "project_id": 1, "url": "http:///testrail/index.php?/suites/view/1" }
{
    "description": "..",
    "id": 1,
    "name": "Setup & Installation",
    "project_id": 1,
    "url": "http:///testrail/index.php?/suites/view/1"
}

レスポンスには次のフィールドが含まれています。

名前 タイプ 説明
completed_on timestamp テスト スイートがクローズされた日時 (UNIXタイムスタンプ) (TestRail 4.0 で追加)
description string テスト スイートの説明
id integer テスト スイートの一意の ID
is_baseline boolean テスト スイートがベースライン テスト スイートである場合は true、そうでない場合は false (TestRail 4.0で追加)
is_completed boolean テスト スイートが完了/アーカイブ済みとしてマークされている場合は true、そうでない場合は false (TestRail 4.0で追加)
is_master boolean テスト スイートがマスター テスト スイートである場合は true、そうでない場合は false (TestRail 4.0で追加)
name string テスト スイートの名前
project_id integer テスト スイートが所属するプロジェクトの ID
url string ユーザー インターフェイスに表示されるテスト スイートのアドレス/URL

レスポンス コード

ステータス コード 説明
200 成功。テスト スイートがレスポンスの一部として返されます
400 無効または不明なテスト スイート
403 プロジェクトにアクセスできない

get_suites

プロジェクトのテスト スイートのリストを返します。

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
GET index.php?/api/v2/get_suites/{project_id}
GET index.php?/api/v2/get_suites/{project_id}
GET index.php?/api/v2/get_suites/{project_id}

パラメーター

名前 タイプ 必須 説明
project_id integer true プロジェクトの ID

レスポンスの内容

レスポンスにはテスト スイートの配列が含まれます。リスト内の各プロジェクトの形式は、get_suite と同じです。

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
[
{
"id": 1,
"name": "Setup & Installation",
},
{
"id": 2,
"name": "Document Editing",
},
]
[ { "id": 1, "name": "Setup & Installation", }, { "id": 2, "name": "Document Editing", }, ]
[
    {
        "id": 1,
        "name": "Setup & Installation", 
    },
    {
        "id": 2,
        "name": "Document Editing", 
    },
]

レスポンス コード

ステータス コード 説明
200 成功。テスト スイートがレスポンスの一部として返されます
400 無効または不明なプロジェクト
403 プロジェクトにアクセスできない

add_suite

新規テスト スイートを作成します。

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
POST index.php?/api/v2/add_suite/{project_id}
POST index.php?/api/v2/add_suite/{project_id}
POST index.php?/api/v2/add_suite/{project_id}

パラメーター

名前 タイプ 必須 説明
project_id integer true テスト スイートを追加するプロジェクトの ID

リクエスト ボディ

POST リクエスト ボディでは以下のフィールドがサポートされています。

名前 タイプ 必須 説明
name string true テスト スイートの名前
description string false テスト スイートの説明

リクエストの例

新しい空のテスト スイートを作成する方法を示す次の例も参照してください。

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
{
"name": "This is a new test suite",
"description": "Use the description to add additional context details"
}
{ "name": "This is a new test suite", "description": "Use the description to add additional context details" }
{
    "name": "This is a new test suite",
    "description": "Use the description to add additional context details"
}

テスト スイートを追加したら、セクションおよびテスト ケースを追加できます。

レスポンスの内容

成功した場合、このメソッドは get_suite と同じレスポンス形式を使用して新しいテスト スイートを返します。

レスポンス コード

ステータス コード 説明
200 成功。テスト スイートが作成され、レスポンスの一部として返されます
400 無効または不明なプロジェクト
403 テスト スイートを追加する権限がない、またはプロジェクトへのアクセス権がない

update_suite

既存のテスト スイートを更新します (部分的な更新がサポートされています。つまり、特定のフィールドのみを送信して更新できます)。

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
POST index.php?/api/v2/update_suite/{suite_id}
POST index.php?/api/v2/update_suite/{suite_id}
POST index.php?/api/v2/update_suite/{suite_id}

パラメーター

名前 タイプ 必須 説明
suite_id integer true テスト スイートの ID
このメソッドは add_suite と同じ POST フィールドをサポートします。

レスポンスの内容

成功した場合、このメソッドは get_suite と同じレスポンス形式を使用して更新されたテスト スイートを返します。

レスポンス コード

ステータス コード 説明
200 成功。テスト スイートが更新され、レスポンスの一部として返されます
400 無効または不明なテスト スイート
403 テスト スイートを更新する権限がない、またはプロジェクトへのアクセス権がない

delete_suite

削除したテスト スイートを元に戻すことはできず、すべてのアクティブなテスト ランおよびテスト結果、つまりまだクローズされていない (アーカイブされていない) テスト ランおよびテスト結果も削除されます。

既存のテスト スイートを削除します。


Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
POST index.php?/api/v2/delete_suite/{suite_id}
POST index.php?/api/v2/delete_suite/{suite_id}
POST index.php?/api/v2/delete_suite/{suite_id}

パラメーター

名前 タイプ 必須 説明
suite_id integer true テスト スイートの ID

Soft パラメーター

soft パラメーターを省略した場合、または soft=0 をサブミットした場合、テスト スイートとそのテスト ケースは削除されます。

If soft=1 の場合、影響を受けるテスト、テスト ケースなどの数に関するデータを返します。

soft=1 の場合、エンティティは実際には削除されません。

レスポンス コード

ステータス コード 説明
200 成功。テスト ランとそのすべてのテストが削除されました。
400 無効または不明なテスト スイート
403 テスト スイートを削除する権限がない、またはプロジェクトへのアクセス権がない