Test Suites - Add

リファレンス

Service:: Test

API Version:: 7.1-preview.3

テストケースをスイートに追加します。

POST https://dev.azure.com/{organization}/{project}/_apis/test/Plans/{planId}/suites/{suiteId}/testcases/{testCaseIds}?api-version=7.1-preview.3

URI パラメーター

名前	/	必須	型	説明
organization	path	True	string	Azure DevOps 組織の名前です。
planId	path	True	integer int32	スイートを含むテスト計画の ID。
project	path	True	string	プロジェクト ID またはプロジェクト名
suiteId	path	True	integer int32	テストケースを追加する必要があるテストスイートの ID。
testCaseIds	path	True	string	スイートに追加するテストケースの ID。 ID はコンマ区切り形式で指定されます。
api-version	query	True	string	使う API のバージョン。このバージョンの API を使用するには、これを '7.1-preview.3' に設定する必要があります。

応答

名前	型	説明
200 OK	SuiteTestCase[]	成功した操作

セキュリティ

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

名前	説明
vso.test_write	テスト計画、ケース、結果、その他のテスト管理関連の成果物を読み取り、作成、更新する機能を付与します。

例

Sample Request

HTTP

POST https://dev.azure.com/fabrikam/fabrikam-fiber-tfvc/_apis/test/Plans/1/suites/1/testcases/39,40?api-version=7.1-preview.3

Sample Response

Status code:: 200

{
  "value": [
    {
      "testCase": {
        "id": "39",
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/39",
        "webUrl": "https://dev.azure.com/fabrikam/web/wi.aspx?pcguid=d81542e4-cdfa-4333-b082-1ae2d6c3ad16&id=39"
      },
      "pointAssignments": [
        {
          "configuration": {
            "id": "2",
            "name": "Windows 8"
          },
          "tester": {
            "id": "e5a5f7f8-6507-4c34-b397-6c4818e002f4",
            "displayName": "Fabrikam Fiber",
            "uniqueName": "fabrikamfiber1@outlook.com",
            "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/e5a5f7f8-6507-4c34-b397-6c4818e002f4",
            "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=e5a5f7f8-6507-4c34-b397-6c4818e002f4"
          }
        }
      ]
    },
    {
      "testCase": {
        "id": "40",
        "url": "https://dev.azure.com/fabrikam/_apis/wit/workItems/40",
        "webUrl": "https://dev.azure.com/fabrikam/web/wi.aspx?pcguid=d81542e4-cdfa-4333-b082-1ae2d6c3ad16&id=40"
      },
      "pointAssignments": [
        {
          "configuration": {
            "id": "2",
            "name": "Windows 8"
          },
          "tester": {
            "id": "e5a5f7f8-6507-4c34-b397-6c4818e002f4",
            "displayName": "Fabrikam Fiber",
            "uniqueName": "fabrikamfiber1@outlook.com",
            "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/e5a5f7f8-6507-4c34-b397-6c4818e002f4",
            "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=e5a5f7f8-6507-4c34-b397-6c4818e002f4"
          }
        }
      ]
    }
  ],
  "count": 2
}

定義

名前	説明
IdentityRef
PointAssignment	テストケースをスイートに追加すると、テストスイートに割り当てられた既定の構成とテスト担当者に基づいて、さらにテストポイントの 1 つが作成されます。 PointAssignment は、テストスイートに追加された各テストケースに対して作成されたテストポイントの一覧です。
ReferenceLinks	REST 参照リンクのコレクションを表すクラス。
ShallowReference	他のリソースへの抽象化された参照。このクラスは、リンクを介して簡単に走査できる方法で他のリソースを参照する一様な方法でビルドデータコントラクトを提供するために使用されます。
SuiteTestCase	スイートのテストケース。
WorkItemReference	WorkItem リファレンスの詳細。

IdentityRef

名前	型	説明
_links	ReferenceLinks	このフィールドには、グラフの件名に関する 0 個以上の興味深いリンクが含まれています。これらのリンクを呼び出して、このグラフの件名に関する追加のリレーションシップまたは詳細情報を取得できます。
descriptor	string	記述子は、システムの実行中にグラフの件名を参照する主な方法です。このフィールドは、アカウントと組織の両方で同じグラフの件名を一意に識別します。
directoryAlias	string	非推奨 - IdentityRef "_links" ディクショナリの "self" エントリで参照されている Graph ユーザーに対してクエリを実行することで取得できます
displayName	string	これは、グラフの件名の一意でない表示名です。このフィールドを変更するには、ソースプロバイダーでその値を変更する必要があります。
id	string
imageUrl	string	非推奨 - IdentityRef "_links" 辞書の "アバター" エントリで使用できます
inactive	boolean	非推奨 - GraphUser "_links" ディクショナリの "membershipState" エントリで参照されている Graph メンバーシップの状態を照会することで取得できます
isAadIdentity	boolean	非推奨 - 記述子のサブジェクト型 (Descriptor.IsAadUserType/Descriptor.IsAadGroupType) から推論できます
isContainer	boolean	非推奨 - 記述子のサブジェクト型 (Descriptor.IsGroupType) から推論できます
isDeletedInOrigin	boolean
profileUrl	string	非推奨 - ToIdentityRef の既存のほとんどの実装では使用されていません
uniqueName	string	非推奨 - 代わりに Domain+PrincipalName を使用する
url	string	この URL は、このグラフの件名のソースリソースへの完全なルートです。

PointAssignment

テストケースをスイートに追加すると、テストスイートに割り当てられた既定の構成とテスト担当者に基づいて、さらにテストポイントの 1 つが作成されます。 PointAssignment は、テストスイートに追加された各テストケースに対して作成されたテストポイントの一覧です。

名前	型	説明
configuration	ShallowReference	テストケースに割り当てられた構成。
tester	IdentityRef	テストケースに割り当てられたテスト担当者

ReferenceLinks

REST 参照リンクのコレクションを表すクラス。

名前	型	説明
links	object	リンクの読み取り専用ビュー。参照リンクは読み取り専用であるため、参照リンクは読み取り専用として公開する必要があります。

ShallowReference

他のリソースへの抽象化された参照。このクラスは、リンクを介して簡単に走査できる方法で他のリソースを参照する一様な方法でビルドデータコントラクトを提供するために使用されます。

名前	型	説明
id	string	リソースの ID
name	string	リンクされたリソースの名前 (定義名、コントローラー名など)
url	string	リソースへの完全な http リンク

SuiteTestCase

スイートのテストケース。

名前	型	説明
pointAssignments	PointAssignment[]	テストスイートのテストケースのポイント割り当て。
testCase	WorkItemReference	テストケースの workItem リファレンス。

WorkItemReference

WorkItem リファレンスの詳細。

名前	型	説明
id	string	WorkItem ID。
name	string	WorkItem 名。
type	string	WorkItem 型。
url	string	WorkItem URL。有効な値: (バグ、タスク、ユーザーストーリー、テストケース)
webUrl	string	WorkItem WebUrl。

次の方法で共有