Webhooks

Test Manager stellt Webhooks bereit, mit denen externe Tools Ereignisse in Test Manager abonnieren können.

Derzeit werden die folgenden Ereignisse unterstützt.

• Defekt erstellen: Dieses Ereignis wird ausgelöst, wenn ein Benutzer die Aufgabe „Defekt erstellen“ von einem Testfallergebnis aus aufruft. Sie ermöglicht es externen Defektverwaltungstools, Defektberichte mit Protokollinformationen aus Testergebnissen zu erhalten.
• Defekte KPIs: Dieses Ereignis wird aufgerufen, wenn die defekten KPIs im Test Manager-Dashboard aktualisiert werden. Dadurch können Statistiken aus externen Fehlermanagementsystemen eingeschlossen werden, die auf dem Test Manager-Dashboard angezeigt werden.

Verträge

In diesem Abschnitt finden Sie die Details der Anforderungs- und Antwortnutzlast für jedes Ereignis.

Erstellen Sie einen Fehler.

Test Manager feuert registrierte Webhooks mit der folgenden Nutzlast aus:

Verwenden Sie die Test Manager REST-API, um Details zum fehlgeschlagenen Test abzurufen und Informationen zum erstellten Defekt hinzuzufügen.

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.

Fehler-KPIs

Test Manager feuert registrierte Webhooks mit der folgenden Nutzlast aus:

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
}

Konfigurieren einer Webhook-Verbindung

Register a webhook endpoint in Test Manager so that external tools receive event payloads — such as defect creation or KPI updates — from your project.

1. Melden Sie sich bei Test Manager als Administrator an.

2. Öffnen Sie Ihr Projekt.

3. Navigate to Project Settings > Integration.

4. Select New Connection and select WebHook from the dropdown.

5. Konfigurieren Sie die folgenden Verbindungseinstellungen:

   • Name: Enter a name for your WebHook connection.
   • Beschreibung (optional): Fügen Sie eine Beschreibung als Referenz hinzu.
   • Payload URL: Add the endpoint server URL. For example: https://company-name-serverRegion.cloudapp.azure.com.
   • Authentication Header Type: Select a hashing method between Client Secret and HMACSHA256.
   • Secret: Enter your client secret value.
   • Allow Insecure SSL: Choose whether to allow endpoints with insecure SSL connections.
   • Supports Defect Dashboard: Choose if KPIs needs to be shown in the project dashboard.

   

6. Wählen Sie Speichern.

7. Select the connection to expand the panel and copy the API Key for later use.

Verwalten von WebHooks-Verbindungen

In der folgenden Tabelle sind die Aktionen aufgeführt, die Sie zum Verwalten Ihrer WebHooks-Verbindungen ausführen können.

Aktion	Beschreibung	Verfahren
Bearbeiten	Bearbeiten Sie Ihre Verbindungseinstellungen.	Melden Sie sich beim Test Manager als Administrator an. Öffnen Sie Ihr Projekt. Gehen Sie zu Projekteinstellungen . In the Integration list, select a WebHook connection to expand the panel. Select Edit to configure the connection. Klicken Sie zum Bestätigen auf Speichern.
Löschen	Löschen Sie die ausgewählte Verbindung und die zugehörigen Anforderungen.	Melden Sie sich beim Test Manager als Administrator an. Öffnen Sie Ihr Projekt. Gehen Sie zu Projekteinstellungen . In the Integration list, select a WebHook connection to expand the panel. Select Delete to remove the connection. Select Ok to confirm.

Ähnliche Artikel

Synchronisierung von Defekten

Ergebnis

The webhook connection is created. External tools can now subscribe to Test Manager events such as defect creation and KPI updates from the connected project.