API REST de l’utilisateur test de l’exécuteur dans le cloud

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 13 minutes de lecture
  • Gère les tâches d’utilisateur de test à exécuter dans un exécuteur dans le cloud pour Framework de tests automatisés (ATF).

    L’API d’utilisateur de test de l’exécuteur dans le cloud nécessite le (sn_atf_tg) module d’extension ATF Test Generator and Cloud Runner . Les méthodes disponibles avec cette API s’exécutent dans l’espace de noms Now et peuvent être appelées à l’aide de Nom de l’API, Test de régression en un clic pour ATF, dans l’explorateur d’API REST. Le rôle admin est requis pour accéder à cette API.

    Vous pouvez utiliser cette API pour les tâches suivantes :
    • Démarrez la tâche de test utilisateur.
    • Définissez l’utilisateur du cloud.
    • Vérifiez si l’utilisateur spécifié est valide.
    • Vérifiez la progression de la tâche de test utilisateur.
    • Annulez la tâche de test.

    L’API Cloud Runner Test Runner peut être utilisée en tandem avec les balises API REST de génération des tests de l’exécuteur dans le cloud et API REST de l’utilisateur test de l’exécuteur dans le cloud. Par exemple, vous pouvez générer un test (API de génération de test de l’exécuteur dans le cloud), puis obtenir la progression du test dans la file d’attente d’orchestration du navigateur (API de génération de test de l’exécuteur dans le cloud) et vérifier le nombre de tests qui ont réussi ou échoué.

    Pour consulter la documentation de référence de l’API Server relative à cette API, reportez-vous à la section TestUserApi de l’exécuteur dans le cloud : champ d’application, global.

    Utilisateur de test de l’exécuteur dans le cloud : GET /now/sn_atf_tg/test_user_progress

    Fournit l’état de la tâche de l’utilisateur de test pour un enregistrement de file d’attente d’orchestration du navigateur (BOQ) fourni.

    Format d'URL

    URL par défaut : GET /api/now/sn_atf_tg/test_user_progress

    Paramètres de demande pris en charge

    Tableau 1. Paramètres de chemin d'accès
    Nom Description
    Néant
    Tableau 2. Paramètres de requête
    Nom Description
    snboqId Requis. Enregistrement BOQ sys_id de la tâche de l’utilisateur test dont obtenir la progression.

    Type de données : chaîne

    Table : Boq [sn_atf_tg_sn_boq]

    Tableau 3. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    Néant

    En-têtes

    Les en-têtes de demande et de réponse suivants s’appliquent uniquement à cette action HTTP ou s’appliquent à cette action d’une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 4. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json

    Tableau 5. En-têtes de réponses
    En-tête Description
    Néant

    Codes d'état

    Les codes d’état suivants s’appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 6. Codes d'état
    Code d'état Description
    200 La progression de la tâche de l’utilisateur test a été récupérée.
    400 Erreur lors de l’obtention de l’état d’enregistrement de nomenclature. Renvoie l’un des messages suivants :
    • Aucun ID de devis transmis : aucun identifiant de devis n’a été fourni. Ajoutez l’ID de nomenclature au corps de la demande.
    • Impossible de trouver l’enregistrement BOQ : ID système non valide. Vérifiez que le sys_id de l’enregistrement de nomenclature est valide et que l’enregistrement existe.
    403 Erreur lors de l’octroi de l’accès de l’utilisateur au point de terminaison. Assurez-vous que l’utilisateur dispose du rôle administrateur.

    Paramètres du corps de la réponse (JSON ou XML)

    Nom Description
    résultat Objet contenant les résultats de progression de la tâche de test exécutable ou un message expliquant pourquoi la demande a échoué.
    "result": { 
        "progress": 100, 
        "state": "completed" 
      }

    Ou :

    "result": { 
        "message": "String"
    }

    Type de données : objet

    résultat.message Message d’erreur expliquant pourquoi la progression du test exécutable ne peut pas être récupérée. Le paramètre message n’est pas renvoyé dans une réponse réussie.

    Type de données : chaîne

    Résultat.Progrès Pourcentage qui indique à quel point un test est proche de l’achèvement lorsqu’il est à l’état En cours d’exécution.

    Type de données : nombre

    résultat.état État actuel de l’enregistrement de la nomenclature.

    Valeurs possibles :

    • 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 du test.
    • Terminé : la tâche de test est terminée.
    • État Échec : la tâche de test a échoué.
    • 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.
    • En cours d’exécution : Les navigateurs de l’infrastructure cloud détectent et exécutent des tests en attente.

    Type de données : chaîne

    Demande cURL

    L’exemple de demande suivant montre comment vérifier la progression d’une tâche d’utilisateur test.

    curl "https://instance.service-now.com/api/now/sn_atf_tg/test_user_progress?snboqId=<sys_id of SNBOQ record>" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user "username:password"

    Corps de la réponse :

    { 
      "result": { 
        "progress": 100, 
        "state": "completed" 
      } 
    }

    Utilisateur de test de l’exécuteur dans le cloud : GET /now/sn_atf_tg/is_valid_cloud_user

    Vérifie si un utilisateur fourni est un utilisateur valide du cloud.

    Cette méthode vérifie si l’utilisateur répond aux critères suivants :
    • existe,
    • Est actif,
    • N’est pas verrouillé,
    • a besoin d’une réinitialisation du mot de passe,
    • Est un administrateur,
    • Est en lecture seule,
    • Sont uniquement des services Web

    Format d'URL

    URL par défaut : GET /api/now/sn_atf_tg/is_valid_cloud_user

    Paramètres de demande pris en charge

    Tableau 7. Paramètres de chemin d'accès
    Nom Description
    Néant
    Tableau 8. Paramètres de requête
    Nom Description
    nom d'utilisateur Requis. Nom d’utilisateur du sys_user pour vérifier si l’utilisateur répond aux critères de base de référence suivants.
    • existe,
    • Est actif,
    • N’est pas verrouillé,
    • a besoin d’une réinitialisation du mot de passe,
    • Est un administrateur,
    • Est en lecture seule,
    • Sont uniquement des services Web

    Si l’une de ces conditions échoue, l’API renvoie un faux booléen avec un message sur les critères qui ont échoué.

    Type de données : chaîne

    Tableau 9. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    Néant

    En-têtes

    Les en-têtes de demande et de réponse suivants s’appliquent uniquement à cette action HTTP ou s’appliquent à cette action d’une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 10. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json

    Tableau 11. En-têtes de réponses
    En-tête Description
    Néant

    Codes d'état

    Les codes d’état suivants s’appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 12. Codes d'état
    Code d'état Description
    200 Renvoie vrai ou faux si l’utilisateur est valide et répond aux critères d’utilisateur du cloud.
    403 Erreur lors de l’octroi de l’accès de l’utilisateur au point de terminaison. Assurez-vous que l’utilisateur dispose du rôle administrateur.

    Paramètres du corps de la réponse (JSON ou XML)

    Nom Description
    résultat Objet contenant les résultats de la demande.
    
      "result": { 
        "validUser": Boolean 
      }

    Type de données : objet

    résultat.validUser Marqueur indiquant si l’utilisateur répond aux critères d’utilisateur du cloud. Si vrai, l’utilisateur répond aux critères.

    Type de données : booléennes

    Demande cURL

    La demande suivante vérifie si le sys_user fourni répond aux critères d’utilisation de la fonctionnalité cloud.

    curl "http://instance.service-now.com/api/now/sn_atf_tg/is_valid_cloud_user?username=<username of sys_user to check>" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user "username:password"

    Corps de la réponse :

    { 
      "result": { 
        "validUser": <Boolean value indicating whether user is valid cloud user> 
      } 
    }

    Utilisateur de test de l’exécuteur dans le cloud : POST /now/sn_atf_tg/test_user

    Insère une tâche d’utilisateur de test dans la table BOQ [sn_atf_tg_sn_boq] pour un nom d’utilisateur donné, qui est ensuite exécutée sur l’exécuteur dans le cloud.

    Format d'URL

    URL par défaut : POST /api/now/sn_atf_tg/test_user

    Paramètres de demande pris en charge

    Tableau 13. Paramètres de chemin d'accès
    Nom Description
    Néant
    Tableau 14. Paramètres de requête
    Nom Description
    Néant
    Tableau 15. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    nom d'utilisateur Requis. Nom d’utilisateur du sys_user pour tester l’infrastructure de bout en bout de l’exécuteur dans le cloud.

    Type de données : chaîne

    En-têtes

    Les en-têtes de demande et de réponse suivants s’appliquent uniquement à cette action HTTP ou s’appliquent à cette action d’une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 16. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json

    Type de contenu Format des données du corps de la demande. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json

    Tableau 17. En-têtes de réponses
    En-tête Description
    Néant

    Codes d'état

    Les codes d’état suivants s’appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 18. Codes d'état
    Code d'état Description
    200 A inséré avec succès une tâche BOQ d’utilisateur test.
    400 Erreur lors du démarrage de la tâche de l’utilisateur test.

    Si un nom d’utilisateur vide est fourni ou si un utilisateur est introuvable dans sys_user table, le serveur génère une erreur.

    403 Erreur lors de l’octroi de l’accès de l’utilisateur au point de terminaison. Assurez-vous que l’utilisateur dispose du rôle administrateur.

    Paramètres du corps de la réponse (JSON ou XML)

    Nom Description
    résultat Objet contenant les résultats de la demande.
    
      "result": { 
        "snboqId": String
      }

    Ou :

    "result": { 
        "message": "String"
    }

    Type de données : objet

    résultat.message Message d’erreur expliquant pourquoi les options de test ne peuvent pas être affectées au nom d’utilisateur. Le paramètre message n’est pas renvoyé dans une réponse réussie.

    Type de données : chaîne

    résultat.snboqId Sys_id de l’enregistrement BOQ inséré lorsque la tâche de l’utilisateur test démarre avec succès.

    Type de données : chaîne

    Table : Boq [sn_atf_tg_sn_boq]

    Demande cURL

    L’exemple de demande suivant montre comment insérer une tâche d’utilisateur de test dans la table BOQ [sn_atf_tg_sn_boq] pour un nom d’utilisateur donné.

    curl "http://instance.service-now.com/api/now/sn_atf_tg/test_user" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{\"username\":\"<username of sys_user to test cloud infrastructure>\"}" \ 
    --user "username:password"

    La réponse renvoie un sys_id de l’enregistrement BOQ qui est inséré au démarrage de la tâche de l’utilisateur test.

    { 
      "result": { 
        "snboqId": "<sys_id of newly inserted BOQ record>" 
      } 
    }

    L’exemple suivant renvoie un message d’erreur 400 lorsqu’aucun nom d’utilisateur ou un nom d’utilisateur non valide n’est transmis.

    curl "https://instance.service-now.com/api/now/sn_atf_tg/test_user" \
    --request POST \
    --header "Accept:application/json" \
    --user "username:password"

    Réponse :

    {
      "result": {
        "message": "Unable to set cloud user as cloud user not valid"
      }
    }

    Utilisateur de test de l’exécuteur dans le cloud : POST /now/sn_atf_tg/cancel_test_user

    Définit l’état de la tâche de l’utilisateur de test dans la table File d’attente d’orchestration du navigateur (BOQ) [sn_atf_tg_sn_boq] comme terminé.

    Format d'URL

    URL par défaut : POST /api/now/sn_atf_tg/cancel_test_user

    Paramètres de demande pris en charge

    Tableau 19. Paramètres de chemin d'accès
    Nom Description
    Néant
    Tableau 20. Paramètres de requête
    Nom Description
    Néant
    Tableau 21. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    snboqId Requis. Sys_id de l’enregistrement de nomenclature à annuler associé à la tâche de l’utilisateur test.

    Type de données : chaîne

    Tableau : SNBOQ [sn_atf_tg_sn_boq]

    En-têtes

    Les en-têtes de demande et de réponse suivants s’appliquent uniquement à cette action HTTP ou s’appliquent à cette action d’une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 22. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json

    Type de contenu Format des données du corps de la demande. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json

    Tableau 23. En-têtes de réponses
    En-tête Description
    Néant

    Codes d'état

    Les codes d’état suivants s’appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 24. Codes d'état
    Code d'état Description
    200 Annulation réussie de la tâche de nomenclature des tâches.
    400 Erreur lors de l’annulation de la tâche. Renvoie l’un des messages suivants :
    • Aucun ID de devis transmis : aucun identifiant de devis n’a été fourni. Ajoutez l’ID de nomenclature au corps de la demande.
    • Impossible de trouver l’enregistrement BOQ : ID système non valide. Vérifiez que le sys_id de l’enregistrement de nomenclature est valide et que l’enregistrement existe.
    403 Erreur lors de l’octroi de l’accès de l’utilisateur au point de terminaison. Assurez-vous que l’utilisateur dispose du rôle administrateur.

    Paramètres du corps de la réponse (JSON ou XML)

    Nom Description
    résultat Objet contenant les résultats de la demande.
    
      "result": { 
        "message": String
      }

    Type de données : objet

    résultat.message Message détaillant si l’annulation de l’utilisateur test a réussi.

    Type de données : chaîne

    Demande cURL

    La demande suivante montre comment annuler une tâche d’utilisateur de test dans la table de la file d’attente Orchestration du navigateur [sn_atf_tg_sn_boq].

    curl "https://instance.service-now.com/api/now/sn_atf_tg/cancel_test_user" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{\"snboqId\":\"<sys_id of BOQ record>\"}" \ 
    --user "username:password"

    Corps de réponse réussi :

    { 
      "result": { 
        "message": "success" 
      } 
    }

    Utilisateur de test de l’exécuteur dans le cloud : POST /now/sn_atf_tg/select_cloud_user

    Démarre une tâche d’utilisateur test de bout en bout sur l’exécuteur dans le cloud. Si l’utilisateur est en mesure de se connecter avec le rôle administrateur, la propriété utilisateur dans le cloud est définie par défaut sur cet utilisateur pour les futures exécutions de tests et générations de tests.

    Format d'URL

    URL par défaut : POST /api/now/sn_atf_tg/select_cloud_user

    Paramètres de demande pris en charge

    Tableau 25. Paramètres de chemin d'accès
    Nom Description
    Néant
    Tableau 26. Paramètres de requête
    Nom Description
    Néant
    Tableau 27. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    nom d'utilisateur Requis. Nom d’utilisateur du sys_user pour tester et définir l’utilisateur du cloud pour les futures tâches d’exécuteur de test et de génération de test.

    Type de données : chaîne

    En-têtes

    Les en-têtes de demande et de réponse suivants s’appliquent uniquement à cette action HTTP ou s’appliquent à cette action d’une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 28. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json

    Type de contenu Format des données du corps de la demande. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json

    Tableau 29. En-têtes de réponses
    En-tête Description
    Néant

    Codes d'état

    Les codes d’état suivants s’appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 30. Codes d'état
    Code d'état Description
    200 Test réussi de l’infrastructure de l’exécuteur dans le cloud de bout en bout et définition de l’utilisateur du cloud pour les futures exécutions de tests et les tâches de génération de tests.
    400 Erreur lors du test de l’infrastructure de l’exécuteur dans le cloud de bout en bout et lors de la définition de l’utilisateur dans le cloud. Assurez-vous que le nom d’utilisateur n’est pas vide ou que l’utilisateur existe dans la table sys_user pour un nom d’utilisateur donné.
    403 Erreur lors de l’octroi de l’accès de l’utilisateur au point de terminaison. Assurez-vous que l’utilisateur dispose du rôle administrateur.

    Paramètres du corps de la réponse (JSON ou XML)

    Nom Description
    résultat Objet contenant les résultats de la demande.
    
      "result": { 
        "message": "String"
      }

    Type de données : objet

    résultat.message Message détaillant si l’utilisateur a été sélectionné avec succès pour les futures exécutions de tests et générations de tests sur l’infrastructure de l’exécuteur dans le cloud.

    Type de données : chaîne

    Demande cURL

    L’exemple suivant montre comment demander la sélection d’un utilisateur spécifique pour de futures exécutions de tests et générations de tests sur l’infrastructure Cloud Runner.

    curl "https://instance.service-now.com/api/now/sn_atf_tg/select_cloud_user" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{\"username\":\"<username of sys_user to set as cloud user>\"}" \ 
    --user "username:password"

    Le corps de la réponse renvoie un message de réussite qui indique que l’utilisateur du cloud a été sélectionné avec succès pour les exécutions et les générations de tests.

    { 
      "result": { 
        "message": "success" 
      } 
    }