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

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 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(String snboqId)

    Définit la tâche d’exécuteur de test 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. 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 un test d’exécution d’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. 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 de progression du test terminé.

    Type : numéro
    Objet.état État de l’enregistrement de la demande de commande.
    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 les 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 d’infrastructure cloud trouvent et exécutent des tests en attente.
    • Terminé : la tâche de test est terminée.
    • État Échoué : 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 suit : {snboqId : « <sys_id>"}.
    • sys_id de demande de commande non valide transmise : l’ID fourni doit se trouver pour un enregistrement de demande de changement dans la table File d’attente Orchestration du navigateur [sn_atf_tg_sn_boq].

    L’exemple suivant montre comment démarrer un test d’exécution d’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(String testId)

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

    Tableau 5. Paramètres
    Nom Type Description
    ID test Chaîne Requis. Le 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 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 un test d’exécution d’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}