Cloud Runner TestGenerationApi – Scoped, Global

Verwaltet die Testauftragsgenerierung, die in einem Cloud Runner für Automated Test Framework (ATF) ausgeführt werden soll. Diese API ist Teil der CloudRunnerApi-Skripteinbindung.

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.

Im globalen Bereich wird diese API innerhalb des Namespace sn_atf_tg ausgeführt. Sie müssen das Plugin ATF Test Generator and Cloud Runner (sn_atf_tg) aktivieren, um diese API verwenden zu können.

Siehe auch:

• Cloud Runner TestRunnerApi – Scoped, Global
• Cloud Runner TestUserApi – Scoped, Global
• Cloud Runner-Testgenerierung-REST-API (REST-Implementierung)

TestGenerationApi – cancelJob(String snboqId)

Legt den Testgenerierungsauftrag und den zugehörigen Update Set-Datensatz auf den Status „Abgeschlossen“ fest. Bricht die Stammtracker aller generierten Tests ab, die ausgeführt werden. Wenn beim Abbruch Testaufträge ausgeführt werden, legt diese Methode einen der generierten Datensätze für laufende Tests auf „Übersprungen“ fest.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
snboqId	Zeichenfolge	Erforderlich. Die sys_id des BOQ-Datensatzes in der Tabelle „Browser Orchestration-Warteschlange“ [sn_atf_tg_sn_boq].

Tabelle : 2. Ausgabe

Typ	Beschreibung
Null	NULL bei Erfolg, andernfalls Fehlermeldung.

Das folgende Beispiel zeigt, wie Sie mit der Generierung von Tests für die Incident-Tabelle beginnen und die Testgenerierung abbrechen. Verwenden Sie im globalen Bereich den Namespace sn_atf_tg.

var insertedSnboqId = CloudRunnerAPI.TestGenerationAPI.startJob({
  tableEncodedQuery: "nameISincident",
  catalogEncodedQuery: "sysIdISEMPTY",
  maxTestCount: 10
});

CloudRunnerAPI.TestGenerationAPI.cancelJob({snboqId: insertedSnboqId});

TestGenerationApi – progress(String snboqId)

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

Tabelle : 3. Parameter

Name	Typ	Beschreibung
snboqId	Zeichenfolge	Erforderlich. Die sys_id des BOQ-Datensatzes in der Tabelle „Browser Orchestration-Warteschlange“ [sn_atf_tg_sn_boq].

Tabelle : 4. Ausgabe

Typ	Beschreibung
Objekt	Informationen zum Testauftrag. Erweiterte Testdetails finden Sie in der Tabelle „Generierte Tests“ [sn_atf_tg_generated_test]. { "testsFailed": Number, "testsInProgress": Number, "testsPending": Number, "testsSkipped": Number, "testsSucceeded": Number }
TestsFehlgeschlagen	Die Anzahl der generierten fehlgeschlagenen Tests. Die Fehlergründe sind in der Tabelle „Generierte Tests“ [sn_atf_tg_generated_test] aufgeführt. Datentyp: Zahl
testInProgress	Die Anzahl der erstellten Anwendungsfälle. Datentyp: Zahl
TestsAusstehend	Die Anzahl der verbleibenden Anwendungsfälle, die generiert werden müssen. Datentyp: Zahl
TestsÜbersprungen	Die Anzahl der Tests, die aufgrund des Auftragsabbruchs übersprungen wurden. Datentyp: Zahl
TestsErfolgreich	Die Anzahl der erfolgreich generierten Tests. Datentyp: Zahl

Das folgende Beispiel zeigt, wie Sie mit der Generierung von Tests für die Incident-Tabelle beginnen, den Fortschritt abrufen und die Testgenerierung abbrechen. Verwenden Sie im globalen Bereich den Namespace sn_atf_tg.

var snboqId = CloudRunnerAPI.TestGenerationAPI.startJob({
  "tableEncodedQuery": "nameISincident",
  "catalogEncodedQuery": "sysIdISEMPTY",
  "maxTestCount": 10
});

gs.info(JSON.stringify(CloudRunnerAPI.TestGenerationAPI.progress({snboqId: snboqId})));

CloudRunnerAPI.TestGenerationAPI.cancelJob({"snboqId": snboqId});

Ausgabe:

{
  "testsSucceeded": 4,
  "testsFailed": 2,
  "testsPending": 2,
  "testsInProgress": 8,
  "testsSkipped": 0
}

TestGenerationApi – startJob(String tableEncodedQuery, String userEncodedQuery, String catalogEncodedQuery, Number maxTestCount, Number maxTestCountPerTable, Number maxTestCountPerItem, String email)

Fügt einen Datensatz in die Tabelle „Browser Orchestration Queue (BOQ)“ [sn_atf_tg_sn_boq] ein, um einen Testauftrag zu starten.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
tableEncodedQuery	Zeichenfolge	Optional. Codierte Abfrage, die die Tabellen angibt, für die Tests generiert werden sollen. Weitere Informationen finden Sie unter Encoded query strings. Standard: Alle Tabellen (leere Zeichenfolge)
userEncodedQuery	Zeichenfolge	Optional. Codierte Abfrage, die die Benutzer angibt, für die Tests generiert werden sollen. Standard: Alle Benutzer (leere Zeichenfolge)
catalogEncodedQuery	Zeichenfolge	Optional. Codierte Abfrage, die die Katalogelemente (CIs) angibt, für die Tests generiert werden sollen. Standard: Alle CIs (leere Zeichenfolge)
maxTestCount	Nummer	Optional. Maximale Anzahl der zu generierenden Tests. Standard: 9999 (Höchstwert)
maxTestCountPerTable	Nummer	Optional. Maximale Anzahl der pro Tabelle zu generierenden Tests. Standard: 10 (Höchstwert)
maxTestCountPerItem	Nummer	Optional. Maximale Anzahl der pro CI zu generierenden Tests. Standard: 10 (Höchstwert)
E-Mail	Zeichenfolge	Optional. Die E-Mail-Adresse, an die eine Benachrichtigung gesendet werden soll, wenn die Testgenerierung abgeschlossen ist. Standard: Keine E-Mail (leere Zeichenfolge)

Tabelle : 6. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Die sys_id des BOQ-Datensatzes in der Tabelle „Browser Orchestration-Warteschlange“ [sn_atf_tg_sn_boq].

Das folgende Beispiel zeigt, wie Sie mit der Generierung von Tests für die Incident-Tabelle beginnen. Verwenden Sie im globalen Bereich den Namespace sn_atf_tg.

var insertedSnboqId = CloudRunnerAPI.TestGenerationAPI.startJob({
  tableEncodedQuery: "nameISincident",
  catalogEncodedQuery: "sysIdISEMPTY",
  maxTestCount: 10
});

gs.info(insertedSnboqId);

Ausgabe:

<sys_id of inserted BOQ record>