Cloud Runner TestRunnerAPI : champ d’application, global

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 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 périmètre global, cette API est exécutée dans l’espace de noms sn_atf_tg. Vous devez avoir activé le module d’extension ATF Test Generator and Cloud Runner (sn_atf_tg) pour utiliser cette API.

    Voir aussi :

    TestRunnerApi – cancelJob(String snboqId)

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

    Tableau 1. Paramètres
    Nom Type Description
    snboqId Chaîne Requis. Le 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, exécuter 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 Orchestration du navigateur (BOQ) fourni.

    Tableau 3. Paramètres
    Nom Type Description
    snboqId Chaîne Requis. Le 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.progrès Indique le pourcentage de progression du test terminé.

    Type : nombre
    Objet.État État de l’enregistrement de la 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 les enregistrements pour s’assurer que les suivis des exécutions 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 dans le cloud pour démarrer les navigateurs pour la génération ou l’exécution de tests.
    • En cours d’exécution : les navigateurs d’infrastructure cloud trouvent et exécutent les tests en attente.
    • Terminée : la tâche de test est terminée.
    • État d’échec : échec de la tâche de test.

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

    L’exemple suivant montre comment démarrer un test, exécuter 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. La sys_id du test ATF ou de la suite de tests à exécuter dans le navigateur de l’exécuteur dans le cloud. 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 Le 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, exécuter 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}