---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# REST-API für Cloud Runner-Testgenerierung

# REST-API für Cloud Runner-Testgenerierung {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 8 Minuten Lesedauer

Verwaltet die Testauftragsgenerierung, die in einem Cloud Runner für automatisiertes Test-Framework (ATF) ausgeführt werden soll.
Die Cloud Runner-Testgenerierung API erfordert [ATF Test Generator and Cloud Runner](https://www.servicenow.com/docs/access?context=atf-tg-cr-intro&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US)Plugin (sn_atf_tg). Die mit dieser API verfügbaren Methoden werden in ausgeführt Jetzt Namespace und kann über API-Namen aufgerufen werden, Ein-Klick-Regressionstests für ATF , Im REST API Explorer. Für den Zugriff auf diese API ist die Administratorrolle erforderlich.  
Sie können diese API für die folgenden Aufgaben verwenden:

* Starten Sie den Testgenerierungsauftrag.
* Überprüfen Sie den Fortschritt des Testgenerierungsauftrags.
* Brechen Sie den Testgenerierungsauftrag ab.
{#cloudrunner-testgeneration-api__cloudrnr-TestGenerationAPI-scoped_ul_vwb_wvn_31c}

Die Cloud Runner-Testgenerierung API kann zusammen mit verwendet werden [Cloud Runner Test Runner REST API](https://servicenow-prod.fluidtopics.net/n0cULYjO5Joy1UGTlBoqPQ#cloudrunner-testrunner-api "Verwaltet Tests, die in einem Cloud Runner für automatisiertes Test-Framework (ATF) ausgeführt werden sollen.")Und [Cloud Runner-Testanwender-REST-API](https://servicenow-prod.fluidtopics.net/MUeoyh3rK8hyQFqsqByx1A#cloudrunner-testuser-api "Verwaltet Testanwenderaufträge, die in einem Cloud Runner für automatisiertes Test-Framework (ATF) ausgeführt werden sollen."). Sie können beispielsweise die Testgenerierungs-API aufrufen, um einen Test auszuführen und dann den Fortschritt des Tests in der Browser-Orchestration-Warteschlange (Cloud Runner-TESTGENERIERUNGS-API) abzurufen, und dann die Anzahl der bestandenen oder fehlgeschlagenen Tests überprüfen.

Informationen zum Anzeigen der Server-API-Referenzdokumentation dieser API finden Sie unter [Cloud Runner-TestgenerationApi: Bereichsbezogen, global](https://servicenow-prod.fluidtopics.net/gOV3~zQ7Sv9dIz6fUpRihw#cloudrnr-TestGenerationAPI-scoped "Verwaltet die Testauftragsgenerierung, die in einem Cloud Runner für automatisiertes Test-Framework (ATF) ausgeführt werden soll. Diese API ist Teil der CloudRunnerApi-Skripteinbindung.").

## Cloud Runner-Testgenerierung -- GET /now/sn_atf_tg/Test_Generation_Progress {#ariaid-title2}

Stellt den Status jedes generierten Tests für einen bereitgestellten BOQ-Datensatz (BrowserOrchestration Queue) bereit.

### URL-Format {#cr-TestGenAPI-GET-test-gen-progress__section_mdy_gwz_31c}

Standard-URL: ABRUFEN /api/now/sn_atf_tg/Test_Generation_Progress

### Unterstützte Anforderungsparameter {#cr-TestGenAPI-GET-test-gen-progress__section_ndy_gwz_31c}

{#cr-TestGenAPI-GET-test-gen-progress__table_ody_gwz_31c__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 1. Pfad-Parameter]

{#cr-TestGenAPI-GET-test-gen-progress__table_ody_gwz_31c} {#cr-TestGenAPI-GET-test-gen-progress__table_pdy_gwz_31c__entry__2}

| Name | Beschreibung |
|-|-|
| SnboqId | Erforderlich. Die sys_ID des BOQ-Datensatzes des Testgenerierungsauftrags, dessen Fortschritt abgerufen werden soll. Datentyp: Zeichenfolge Tabelle: BOQ \[sn_atf_tg_sn_boq\] |
[Tabelle : 2. Abfrageparameter]

{#cr-TestGenAPI-GET-test-gen-progress__table_pdy_gwz_31c} {#cr-TestGenAPI-GET-test-gen-progress__table_qdy_gwz_31c__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Anforderungstext-Parameter (XML oder JSON)]

{#cr-TestGenAPI-GET-test-gen-progress__table_qdy_gwz_31c}

### Header {#cr-TestGenAPI-GET-test-gen-progress__section_rdy_gwz_31c}

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#cr-TestGenAPI-GET-test-gen-progress__table_sdy_gwz_31c__entry__2}{#cr-TestGenAPI-GET-test-gen-progress__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 4. Anforderungskopfzeilen.]

{#cr-TestGenAPI-GET-test-gen-progress__table_sdy_gwz_31c} {#cr-TestGenAPI-GET-test-gen-progress__table_tdy_gwz_31c__entry__2}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwort-Header]

{#cr-TestGenAPI-GET-test-gen-progress__table_tdy_gwz_31c}

### Statuscodes {#cr-TestGenAPI-GET-test-gen-progress__section_udy_gwz_31c}

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#cr-TestGenAPI-GET-test-gen-progress__table_vdy_gwz_31c__entry__2}

| Statuscode | Beschreibung |
|-|-|
| 200 | Der Fortschritt des BOQ-Auftrags wurde erfolgreich abgerufen. |
| 400 | Fehler beim Abrufen des BOQ-Datensatzstatus. Gibt eine der folgenden Nachrichten zurück: * Keine BOQ-ID übergeben -- es wurde keine BOQ-ID angegeben. Fügen Sie dem Anforderungstext die BOQ-ID hinzu. * BOQ-Datensatz kann nicht gefunden werden -- ungültige SYS-ID. Stellen Sie sicher, dass die sys_ID des BOQ-Datensatzes gültig und der Datensatz vorhanden ist. {#cr-TestGenAPI-GET-test-gen-progress__ul_d5p_btk_p1c} |
| 403 | Fehler beim Gewähren des Anwenderzugriffs auf den Endpunkt. Stellen Sie sicher, dass der Anwender über die Administratorrolle verfügt. |
[Tabelle : 6. Statuscodes]

{#cr-TestGenAPI-GET-test-gen-progress__table_vdy_gwz_31c}

### Antworttext-Parameter (JSON oder XML) {#cr-TestGenAPI-GET-test-gen-progress__section_wdy_gwz_31c}

{#cr-TestGenAPI-GET-test-gen-progress__table_xdy_gwz_31c__entry__2}

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt, das die Fortschrittsergebnisse des generierten Testauftrags oder eine Nachricht enthält, die erklärt, warum die Anforderung fehlgeschlagen ist. Datentyp: Objekt "result": { "testsSucceeded": Number, "testsFailed": Number, "testsPending": Number, "testsInProgress": Number, "testsSkipped": Number } } Oder: { "result": { "message": "String" } } |
| Ergebnis.Nachricht | Fehlermeldung, die angibt, warum der Fortschritt der Testgenerierung nicht abgerufen werden kann. Der Nachrichtenparameter wird in einer erfolgreichen Antwort nicht zurückgegeben. Datentyp: Zeichenfolge |
| Ergebnis.TestsSuccessed | Anzahl der generierten Tests, die bestanden haben. Datentyp: Zahl |
| Ergebnis.testsFehlgeschlagen | Anzahl der generierten Tests, die fehlgeschlagen sind. Datentyp: Zahl |
| Ergebnis.TestsAusstehend | Anzahl der Anwendungsfälle, die auf generierte Tests warten. Datentyp: Zahl |
| Ergebnis.TestinProgress | Anzahl der Anwendungsfälle, für die Tests erstellt werden. Datentyp: Zahl |
| Ergebnis.TestsÜbersprungen | Anzahl der Tests, die aufgrund des Auftragsabbruchs übersprungen wurden. Datentyp: Zahl |
[ ]

{#cr-TestGenAPI-GET-test-gen-progress__table_xdy_gwz_31c}  

### Curl-Anforderung {#cr-TestGenAPI-GET-test-gen-progress__example_ydy_gwz_31c}

Der folgende GET-Aufruf gibt Fortschrittsinformationen zu generierten Tests zurück, die der snboqId 1234 zugeordnet sind.

    curl "https://instance.service-now.com/api/now/sn_atf_tg/test_generation_progress?snboqId=1234" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user "username":"password"

Ausgabe:

    { 
      "result": { 
        "testsSucceeded": 0, 
        "testsFailed": 0, 
        "testsPending": 0, 
        "testsInProgress": 0, 
        "testsSkipped": 161 
      } 
    }

Das folgende Beispiel gibt eine Fehlermeldung 400 zurück, wenn keine BOQ-ID übergeben wird.

    curl "http://instance.service-now.com/api/now/sn_atf_tg/test_generation_progress" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"

Antwort:

    {
      "result": {
        "message": "No SNBOQ ID passed in, add snboqId to request body"
      }
    }

Das folgende Beispiel gibt eine Fehlermeldung 400 zurück, wenn eine ungültige BOQ-ID übergeben wird.

    curl "http://instance.service-now.com/api/now/sn_atf_tg/test_generation_progress?snboqId=invalid_sys_id" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"

Antwort:

    {
      "result": {
        "message": "Invalid SNBOQ sys_id passed in"
      }
    }

## Cloud Runner-Testgenerierung -- POST /now/sn_atf_tg/Cancel_Test_Generation {#ariaid-title3}

Legt den Testgenerierungsauftrag und den zugehörigen Update-Satz-Datensatz auf den Status „Abgeschlossen" fest. Bricht die Stamm-Tracker aller generierten Tests ab, die ausgeführt werden. Wenn beim Abbrechen Testaufträge ausgeführt werden, legt diese Methode einen der generierten in Bearbeitung befindlichen Testdatensätze auf „Übersprungen" fest.
Tests können aufgrund von Business-Regeln oder Zugriffssteuerungsregeln (Access Control Rule, ACL)-Problemen fehlschlagen oder automatisch abgebrochen werden. Zeigen Sie die generierte Testtabelle an, um weitere Details zu fehlgeschlagenen oder abgebrochenen Tests zu erhalten.

### URL-Format

Standard-URL: POST /api/now/sn_atf_tg/Cancel_Test_Generation

### Unterstützte Anforderungsparameter

{#cr-TestGenAPI-POST-cancel-test-gen__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 7. Pfad-Parameter]

{#cr-TestGenAPI-POST-cancel-test-gen__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 8. Abfrageparameter]

{#cr-TestGenAPI-POST-cancel-test-gen__table_o1y_cwz_31c__entry__2}

| Name | Beschreibung |
|-|-|
| SnboqId | Erforderlich. SYS_ID des Datensatzes der Browser-Orchestration-Warteschlange (BOQ), der abgebrochen werden soll. Datentyp: Zeichenfolge Tabelle: BOQ \[sn_atf_tg_sn_boq\] |
[Tabelle : 9. Anforderungstext-Parameter (XML oder JSON)]

{#cr-TestGenAPI-POST-cancel-test-gen__table_o1y_cwz_31c}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#cr-TestGenAPI-POST-cancel-test-gen__entry__14}{#cr-TestGenAPI-POST-cancel-test-gen__accept-RESTAPI}{#cr-TestGenAPI-POST-cancel-test-gen__content_type-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
| Inhaltstyp | Datenformat des Anforderungstexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 10. Anforderungskopfzeilen.]

{#cr-TestGenAPI-POST-cancel-test-gen__entry__20}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#cr-TestGenAPI-POST-cancel-test-gen__entry__24}

| Statuscode | Beschreibung |
|-|-|
| 200 | Der BOQ-Auftrag wurde erfolgreich abgebrochen. |
| 400 | Fehler beim Abbrechen des Auftrags. Gibt eine der folgenden Nachrichten zurück: * Keine BOQ-ID übergeben -- es wurde keine BOQ-ID angegeben. Fügen Sie dem Anforderungstext die BOQ-ID hinzu. * BOQ-Datensatz kann nicht gefunden werden -- ungültige SYS-ID. Stellen Sie sicher, dass die sys_ID des BOQ-Datensatzes gültig und der Datensatz vorhanden ist. {#cr-TestGenAPI-POST-cancel-test-gen__ul_fzp_ztk_p1c} |
| 403 | Fehler beim Gewähren des Anwenderzugriffs auf den Endpunkt. Stellen Sie sicher, dass der Anwender über die Administratorrolle verfügt. |
[Tabelle : 12. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#cr-TestGenAPI-POST-cancel-test-gen__entry__32}

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt, das die Ergebnisse der Stornierungsanforderung enthält. Datentyp: Objekt "result": { "message": "String" } |
| Ergebnis.Nachricht | Nachricht, die angibt, ob der Testabbruch erfolgreich war. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Die folgende Anforderung bricht den Testgenerierungsauftrag eines angegebenen BOQ-Datensatzes ab.

    curl "http://instance.service-now.com/api/now/sn_atf_tg/cancel_test_generation" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{\"snboqId\":\"<sys_id of BOQ record>\"}" \ 
    --user "username":"password"

Der Antworttext gibt eine Erfolgsmeldung des Abbruchs zurück.

    { 
      "result": { 
        "message": "success" 
      } 
    }

Das folgende Beispiel gibt eine Fehlermeldung 400 zurück, wenn keine BOQ-ID übergeben wird.

    curl "http://instance.service-now.com/api/now/sn_atf_tg/cancel_test_generation" \
    --request POST \
    --header "Accept:application/json" \
    --user "username":"password"

Antwort:

    {
      "result": {
        "message": "No SNBOQ ID passed in, add snboqId to request body"
      }
    }

Das folgende Beispiel gibt eine Fehlermeldung 400 zurück, wenn eine ungültige BOQ-ID übergeben wird.

    curl "http://instance.service-now.com/api/now/sn_atf_tg/cancel_test_generation" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{\"snboqId\":\"invalid_sys_id\"}" \
    --user "username":"password"

Antwort:

    {
      "result": {
        "message": "No SNBOQ ID passed in, add snboqId to request body"
      }
    }

## Cloud Runner-Testgenerierung -- POST /now/sn_atf_tg/Test_Generation {#ariaid-title4}

Fügt einen Datensatz in die Tabelle „Browserorchestration-Warteschlange" (BOQ) \[sn_atf_tg_sn_boq\] ein, um einen Testauftrag zu starten.

### URL-Format {#cr-TestGenAPI-POST-test-generation__section_k1y_cwz_31c}

Standard-URL: POST /api/now/sn_atf_tg/Test_Generation

### Unterstützte Anforderungsparameter {#cr-TestGenAPI-POST-test-generation__section_l1y_cwz_31c}

{#cr-TestGenAPI-POST-test-generation__table_m1y_cwz_31c__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 13. Pfad-Parameter]

{#cr-TestGenAPI-POST-test-generation__table_m1y_cwz_31c} {#cr-TestGenAPI-POST-test-generation__table_n1y_cwz_31c__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 14. Abfrageparameter]

{#cr-TestGenAPI-POST-test-generation__table_n1y_cwz_31c} {#cr-TestGenAPI-POST-test-generation__table_o1y_cwz_31c__entry__2}

| Name | Beschreibung |
|-|-|
| CatalogEncodedQuery | Codierte Abfrage, die angibt, für welche Katalogelemente Tests generiert werden sollen. Standardmäßig sind alle Katalogelemente leer. Weitere Informationen zum Erstellen von codierten Abfragen finden Sie unter [Encoded query strings](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US). Datentyp: Zeichenfolge |
| E-Mail | E-Mail-Adresse, die gewarnt werden soll, wenn die Testgenerierung abgeschlossen ist. Datentyp: Zeichenfolge |
| Max. Testanzahl | Anzahl der insgesamt zu generierenden Tests. Akzeptierte Werte: Beliebige Zahl zwischen 1 und 9999. Datentyp: Zahl Standard: 9999 |
| MaxTestCountPerItem | Anzahl der pro Katalogelement zu generierenden Tests. Akzeptierte Werte: Beliebige Zahl zwischen 1 und 10. Datentyp: Zahl Standard: 10 |
| MaxTestCountPerTable | Anzahl der pro Tabelle zu generierenden Tests. Akzeptierte Werte: Beliebige Zahl zwischen 1 und 10. Datentyp: Zahl Standard: 10 |
| TableEncodedQuery | Codierte Abfrage, die die Tabellen angibt, für die Tests generiert werden sollen. Standardmäßig sind alle Tabellen leer. Weitere Informationen zum Erstellen von codierten Abfragen finden Sie unter [Encoded query strings](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US). Datentyp: Zeichenfolge |
| SeparateUpdateSetPerScope | Kennzeichnung, die angibt, ob generierte Tests in die jeweiligen Suites, Update-Sätze und Umfänge getrennt oder Tests in einer Suite, einem Update-Satz und einem Umfang platziert werden sollen. Gültige Werte: * Wahr: Tests werden entsprechend dem Umfang der einzelnen Tabellen oder Katalogelemente in ihrer jeweiligen Suite und in ihrem Update-Satz platziert. * Falsch: Alle generierten Tests werden in derselben Suite, demselben Update-Satz und demselben Umfang platziert. Wenn „falsch", scopeForGeneratingTestsIst in der Anforderung erforderlich. {#cr-TestGenAPI-POST-test-generation__ul_l4b_qfj_y1c} Datentyp: Boolescher Wert Standard: Wahr |
| GeltungsbereichForGenerierungTests | Erforderlich, wenn separateUpdateSetPerScopeIst auf „falsch" festgelegt. SYS_ID des Bereichs, in dem alle generierten Tests platziert werden sollen. Datentyp: Zeichenfolge |
| UserEncodedQuery | Codierte Abfrage, die angibt, für welche Anwender Tests generiert werden sollen. Eine leere Zeichenfolgeneingabe ist standardmäßig auf alle Tabellen festgelegt. Weitere Informationen zum Erstellen von codierten Abfragen finden Sie unter [Encoded query strings](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US). Datentyp: Zeichenfolge |
[Tabelle : 15. Anforderungstext-Parameter (XML oder JSON)]

{#cr-TestGenAPI-POST-test-generation__table_o1y_cwz_31c}

### Header {#cr-TestGenAPI-POST-test-generation__section_vpj_gxz_31c}

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#cr-TestGenAPI-POST-test-generation__table_krf_y2j_41c__entry__2}{#cr-TestGenAPI-POST-test-generation__accept-RESTAPI}{#cr-TestGenAPI-POST-test-generation__content_type-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
| Inhaltstyp | Datenformat des Anforderungstexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 16. Anforderungskopfzeilen.]

{#cr-TestGenAPI-POST-test-generation__table_krf_y2j_41c} {#cr-TestGenAPI-POST-test-generation__table_xpj_gxz_31c__entry__2}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 17. Antwort-Header]

{#cr-TestGenAPI-POST-test-generation__table_xpj_gxz_31c}

### Statuscodes {#cr-TestGenAPI-POST-test-generation__section_s1y_cwz_31c}

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#cr-TestGenAPI-POST-test-generation__table_t1y_cwz_31c__entry__2}

| Statuscode | Beschreibung |
|-|-|
| 200 | Ein BOQ-Auftrag zur Testgenerierung wurde erfolgreich eingefügt. Alle Fehler werden während der Verarbeitung in den BOQ-Datensatzprotokollen angezeigt. Alle Eingaben generieren standardmäßig die maximale Anzahl von Tests für alle Tabellen und Servicekatalogelemente. |
| 403 | Fehler beim Gewähren des Anwenderzugriffs auf den Endpunkt. Stellen Sie sicher, dass der Anwender über die Administratorrolle verfügt. |
[Tabelle : 18. Statuscodes]

{#cr-TestGenAPI-POST-test-generation__table_t1y_cwz_31c}

### Antworttext-Parameter (JSON oder XML) {#cr-TestGenAPI-POST-test-generation__section_u1y_cwz_31c}

{#cr-TestGenAPI-POST-test-generation__table_v1y_cwz_31c__entry__2}

| Name | Beschreibung |
|-|-|
| Ergebnis | Objekt, das die Ergebnisse der Anforderung enthält. "result": { "snboqId": String } Datentyp: Objekt |
| Ergebnis.snboqId | SYS_ID des Datensatzes, der in die sn_atf_tg_sn_boq-Tabelle eingefügt wird, wenn die Testgenerierung beginnt. Datentyp: Zeichenfolge |
[ ]

{#cr-TestGenAPI-POST-test-generation__table_v1y_cwz_31c}  

### Curl-Anforderung {#cr-TestGenAPI-POST-test-generation__example_w1y_cwz_31c}

Das folgende Anforderungsbeispiel startet einen neuen Testauftrag in der Instanz ohne Anforderungsparameter und fügt den Auftrag in die BOQ-Tabelle ein.

    curl "http://instance.service-now.com/api/now/sn_atf_tg/test_generation" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --user "username":"password"

Antworttext:

    { 
      "result": { 
        "snboqId": <sys_id of newly inserted BOQ record> 
      } 
    }

Das folgende Anforderungsbeispiel startet einen neuen Testauftrag mit einer maximalen Testanzahl von 2, filtert die Tests in die Incident-Tabelle und fügt den Auftrag dann in die BOQ-Tabelle ein.

    curl "http://instance.service-now.com/api/now/sn_atf_tg/test_generation" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{\"maxTestCount\":\"2\",\"tableEncodedQuery\":\"name=incident\"}" \ 
    --user "username":"password"

{#cr-TestGenAPI-POST-test-generation__codeblock_grj_5ph_41c}

Antworttext:

    { 
      "result": { 
        "snboqId": <sys_id of newly inserted BOQ record> 
      } 
    }

{#cr-TestGenAPI-POST-test-generation__codeblock_pkx_5ph_41c}

