- スタート アップ ガイド
- プロジェクト管理
- プロジェクトの運用とユーティリティ
- Test Manager の設定
- ALM ツールとの連携
- API 連携
Test Manager には、外部ツールが Test Manager 内のイベントにサブスクライブするための Webhook が用意されています。
現在、次のイベントがサポートされています。
- Create Defect: This event is triggered whenever a user invokes the "Create Defect" task from a test case result. It allows external defect management tools to receive defect reports with log information from test results.
- Defect KPIs: This event is invoked when the defect KPIs on the Test Manager dashboard are refreshed. This allows to include statistics from external defect management systems to be displayed on the Test Manager dashboard.
Contracts (コントラクト)
このセクションでは、各イベントの要求および応答ペイロードの詳細を示します。
不具合を作成する
Test Manager は、以下のペイロードで登録済みの Webhook を起動します。
Use the Test Manager REST API to fetch details about the failed test to add information to the created defect.
Request:
CreateDefectFromTestCaseLogRequest{
testExecutionId string($uuid)
testCaseId string($uuid)
variationId string
nullable: true
linkToTestCaseLog string
nullable: true
}
Response:
Returns a defect payload to allow Test Manager to add a link to the created defect in the test case log.
Request:
CreateDefectFromTestCaseLogRequest{
testExecutionId string($uuid)
testCaseId string($uuid)
variationId string
nullable: true
linkToTestCaseLog string
nullable: true
}
Response:
Returns a defect payload to allow Test Manager to add a link to the created defect in the test case log.
不具合の KPI
Test Manager は、以下のペイロードで登録済みの Webhook を起動します。
Request:
api/kpis/project/<projectid>/defectstatus
Response:
KPIConnectorDefectsDto{
totalDefects integer($int32)
criticalDefects integer($int32)
moderateDefects integer($int32)
openDefects integer($int32)
closedDefects integer($int32)
status ConnectorKPIStatusstring
Enum:
Array [ 3 ]
criticalDefectsLink string
nullable: true
}
Request:
api/kpis/project/<projectid>/defectstatus
Response:
KPIConnectorDefectsDto{
totalDefects integer($int32)
criticalDefects integer($int32)
moderateDefects integer($int32)
openDefects integer($int32)
closedDefects integer($int32)
status ConnectorKPIStatusstring
Enum:
Array [ 3 ]
criticalDefectsLink string
nullable: true
}
Webhook 接続を設定する
-
Test Manager に管理者としてログインします。
-
プロジェクトを開きます。
-
[プロジェクト設定] > [連携] に移動します。
-
[新しい接続] をクリックして、ドロップダウンから [Webhook] を選択します。
-
次の接続設定を構成します。
-
名前: Webhook 接続の名前を入力します。
-
説明 (任意): 参考になる説明を入力します。
-
ペイロード URL: エンドポイント サーバーの URL を追加します。例:
https://company-name-serverRegion.cloudapp.azure.com。 -
認証ヘッダーの種類:
Client SecretおよびHMACSHA256のいずれかのハッシュ方法を選択します。 -
シークレット: クライアント シークレットの値を入力します。
-
セキュリティで保護されていない SSL を許可: セキュリティで保護されていない SSL 接続を使用するエンドポイントを許可するかどうかを選択します。
-
不具合のダッシュボードをサポート: プロジェクト ダッシュボードに KPI を表示する必要があるかどうかを選択します。
-
-
[保存] をクリックします。
-
接続をクリックしてパネルを展開し、後で必要になる [API キー] をコピーします。
Webhook 接続を管理する
以下に、Webhook 接続を管理するために実行できるアクションのリストを示します。
| 操作 | 説明 | 手順 |
|---|---|---|
|
編集 |
接続設定を編集します。 |
|
|
削除する |
選択した接続および関連する要件を削除します。 |
|
関連記事