TestRunnerAPI de l’exécuteur dans le cloud : champ d’application, global

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 3 minutes de lecture

    • Gère les tests à exécuter dans un exécuteur dans le cloud pour Framework de tests automatisés (ATF). Cette API fait partie de l’include de script CloudRunnerAPI.

    Vous pouvez utiliser cette API pour les tâches suivantes :
    • Démarrez un test ATF ou une suite de tests dans le navigateur Cloud Runner.
    • Vérifiez la progression de la tâche de test.
    • Annulez la tâche de test.

    Dans le champ d’application global, cette API est exécutée dans l’espace de noms sn_atf_tg. Vous devez avoir activé le (sn_atf_tg) module d’extension ATF Test Generator and Cloud Runner pour utiliser cette API.

    Voir aussi :

    TestRunnerApi – cancelJob(Chaîne snboqId)

    Définit la tâche de test exécutable sur l’état Terminé et annule les suivis racines de tous les tests générés en cours d’exécution.

    Tableau 1. Paramètres
    Nom Type Description
    snboqId Chaîne Requis. L’sys_id de l’enregistrement BOQ dans la table File d’attente Orchestration du navigateur [sn_atf_tg_sn_boq].
    Tableau 2. Renvoie
    Type Description
    null Nul en cas de réussite, message d’erreur dans le cas contraire.

    L’exemple suivant montre comment démarrer une exécution de test, un test ATF, afficher la progression et arrêter l’exécution du test. Dans le champ d’application global, utilisez l’espace de noms 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});

    Sortie :

    {progress: 64, state: running}

    TestRunnerApi – progress(String snboqId)

    Fournit l’état de chaque test exécuté pour un enregistrement de file d’attente d’orchestration du navigateur (BOQ) fourni.

    Tableau 3. Paramètres
    Nom Type Description
    snboqId Chaîne Requis. L’sys_id de l’enregistrement BOQ dans la table File d’attente Orchestration du navigateur [sn_atf_tg_sn_boq].
    Tableau 4. Renvoie
    Type Description
    Objet Objet JSON indiquant la progression du test.
    {
  "progress": Number,
  "state": "String"
}
    Objet.progression Indique le pourcentage d’achèvement de la progression du test.

    Type : numéro
    Objet.état État de l’enregistrement de nomenclature.
    Valeurs possibles :
    • En attente : l’activité de test demandée a été créée et attend d’être exécutée.
    • Traitement : l’instance recherche des enregistrements pour s’assurer que les suivis d’exécution sont marqués pour l’exécuteur dans le cloud avant que la demande ne soit envoyée à l’infrastructure dans le cloud.
    • Navigateurs demandés : une demande a été envoyée à l’infrastructure cloud pour démarrer les navigateurs pour la génération ou l’exécution du test.
    • En cours d’exécution : les navigateurs de l’infrastructure cloud trouvent et exécutent des tests en attente.
    • Terminé : la tâche de test est terminée.
    • État d’échec : la tâche de test a échoué.

    Type : chaîne
    Erreur En cas d’échec, messages d’erreur possibles :
    • Aucun ID de nomenclature transmis : l’objet JSON fourni n’a pas d’entrée d’ID de nomenclature. Vérifiez que l’objet JSON est structuré comme {snboqId : « <sys_id>"}.
    • sys_id de demande transmise non valide : l’ID fourni doit correspondre à un enregistrement de demande dans la table de file d’attente Orchestration du navigateur [sn_atf_tg_sn_boq].

    L’exemple suivant montre comment démarrer une exécution de test, un test ATF, afficher la progression et arrêter l’exécution du test. Dans le champ d’application global, utilisez l’espace de noms 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});

    Sortie :

    {progress: 64, state: running}

    TestRunnerApi : startJob(chaîne testId)

    Démarre un test ATF ou une suite de tests sur le navigateur Cloud Runner.

    Tableau 5. Paramètres
    Nom Type Description
    ID du test Chaîne Requis. La sys_id du test ATF ou de la suite de tests à exécuter dans le navigateur Cloud Runner. Situé dans l’une des tables suivantes :
    • Test [sys_atf_test]
    • Suites de tests [sys_atf_test_suite]
    Tableau 6. Renvoie
    Type Description
    Chaîne L’sys_id de l’enregistrement BOQ dans la table File d’attente Orchestration du navigateur [sn_atf_tg_sn_boq].

    L’exemple suivant montre comment démarrer une exécution de test, un test ATF, afficher la progression et arrêter l’exécution du test. Dans le champ d’application global, utilisez l’espace de noms 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});

    Sortie :

    {progress: 64, state: running}