Cloud Runner TestRunnerApi – Bereichsbezogen, Global

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 2 Minuten Lesedauer

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

    Sie können diese API für die folgenden Aufgaben verwenden:
    • Starten Sie einen ATF-Test oder eine ATF-Test-Suite im Cloud Runner-Browser.
    • Überprüft den Fortschritt des Testauftrags.
    • Brechen Sie den Testauftrag 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:

    TestRunnerApi – cancelJob(String snboqId)

    Legt den Test Runner-Auftrag auf den Status „Abgeschlossen“ fest und bricht die Stammtracker aller generierten Tests ab, die ausgeführt werden.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    snboqId Zeichenfolge Erforderlich. Die sys_id des BOQ-Datensatzes in der Tabelle „Browser-Orchestrationswarteschlange“ [sn_atf_tg_sn_boq].
    Tabelle : 2. Ausgabe
    Typ Beschreibung
    Null NULL bei Erfolg, andernfalls Fehlermeldung.

    Das folgende Beispiel zeigt, wie Sie einen Testlauf eines ATF-Tests starten, den Fortschritt anzeigen und den Testlauf stoppen. Verwenden Sie im globalen Bereich den Namespace sn_atf_tg.

    var snboqId = CloudRunnerAPI.TestRunnerAPI.startJob({
	"testId": "<sys_id>"
});

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

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

    Ausgabe:

    {progress: 64, state: running}

    TestRunnerApi – Progress(String snboqId)

    Stellt den Status jedes Tests bereit, der für einen angegebenen BOQ-Datensatz (Browser Orchestration Queue) ausgeführt wurde.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    snboqId Zeichenfolge Erforderlich. Die sys_id des BOQ-Datensatzes in der Tabelle „Browser-Orchestrationswarteschlange“ [sn_atf_tg_sn_boq].
    Tabelle : 4. Ausgabe
    Typ Beschreibung
    Objekt JSON-Objekt, das den Testfortschritt angibt.
    {
  "progress": Number,
  "state": "String"
}
    Object.progress Gibt den abgeschlossenen Prozentsatz des Testfortschritts an.

    Typ: Nummer
    Objekt.status Status des BOQ-Datensatzes.
    Mögliche Werte:
    • Ausstehend: Die angeforderte Testaktivität wurde erstellt und wartet auf die Ausführung.
    • Wird verarbeitet – Die Instanz scannt Datensätze, um sicherzustellen, dass die Ausführungstracker für Cloud Runner markiert sind, bevor die Anforderung an die Cloud-Infrastruktur gesendet wird.
    • Browser angefordert: An die Cloud-Infrastruktur wurde eine Anforderung zum Starten von Browsern für die Testgenerierung oder den Testlauf gesendet.
    • Wird ausgeführt – Cloud-Infrastrukturbrowser suchen ausstehende Tests und führen sie aus.
    • Abgeschlossen: Die Testaufgabe ist abgeschlossen.
    • Status „Fehlgeschlagen“ – Die Testaufgabe ist fehlgeschlagen.

    Typ: Zeichenfolge
    Fehler Falls nicht erfolgreich, mögliche Fehlermeldungen:
    • Keine BOQ-ID übergeben – Das angegebene JSON-Objekt hat keinen BOQ-ID-Eintrag. Vergewissern Sie sich, dass das JSON-Objekt wie folgt strukturiert ist: {snboqId: "<sys_id> "} .
    • Ungültige BOQ-sys_id übergeben: Die angegebene ID muss für einen BOQ-Datensatz in der Tabelle „Browser-Orchestrationswarteschlange“ [sn_atf_tg_sn_boq] gelten.

    Das folgende Beispiel zeigt, wie Sie einen Testlauf eines ATF-Tests starten, den Fortschritt anzeigen und den Testlauf stoppen. Verwenden Sie im globalen Bereich den Namespace sn_atf_tg.

    var snboqId = CloudRunnerAPI.TestRunnerAPI.startJob({
	"testId": "<sys_id>"
});

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

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

    Ausgabe:

    {progress: 64, state: running}

    TestRunnerApi – startJob(String testId)

    Startet einen ATF-Test oder eine Test-Suite im Cloud Runner-Browser.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    testId Zeichenfolge Erforderlich. Die sys_id des ATF-Tests oder der ATF-Test-Suite, der im Cloud Runner-Browser ausgeführt werden soll. Befindet sich in einer der folgenden Tabellen:
    • Testen [sys_atf_test]
    • Test-Suites [sys_atf_test_suite]
    Tabelle : 6. Rückgaben
    Typ Beschreibung
    Zeichenfolge Die sys_id des BOQ-Datensatzes in der Tabelle „Browser-Orchestrationswarteschlange“ [sn_atf_tg_sn_boq].

    Das folgende Beispiel zeigt, wie Sie einen Testlauf eines ATF-Tests starten, den Fortschritt anzeigen und den Testlauf stoppen. Verwenden Sie im globalen Bereich den Namespace sn_atf_tg.

    var snboqId = CloudRunnerAPI.TestRunnerAPI.startJob({
	"testId": "<sys_id>"
});

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

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

    Ausgabe:

    {progress: 64, state: running}