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

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 12 minutes de lecture

    • Gère les tâches de l’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 du nom de l’API, Test de régression en un clic pour ATF, dans l’explorateur d’API REST. Le rôle administrateur 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 l’API API REST de génération des tests exécuteurs dans le cloud and API REST de l’utilisateur test de l’exécuteur dans le cloud. Par exemple, vous pouvez générer un test (API Cloud Runner Test Generation), puis obtenir la progression du test dans la file d’attente Orchestration du navigateur (API Cloud Runner TEST Generation) 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 Exécuteur dans le cloud TestUserApi : dans le champ d’application, global.

    Utilisateur 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 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
    Aucun
    Tableau 2. Paramètres de requête
    Nom Description
    snboqId Requis. Enregistrement BOQ sys_id de la tâche de l’utilisateur test dont vous souhaitez obtenir la progression.

    Type de données : chaîne

    Table : Demande de changement [sn_atf_tg_sn_boq]
    Tableau 3. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    Aucun

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement 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
    Aucun

    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 avec succès.
    400 Erreur lors de l’obtention de l’état d’enregistrement de nomenclature. Renvoie l’un des messages suivants :
    • Aucun ID de confirmation d’achat transmis : aucun ID de confirmation d’achat n’a été fourni. Ajoutez l’ID de confirmation des achats au corps de la demande.
    • Impossible de trouver l’enregistrement BOQ : ID système non valide. Vérifiez que l’sys_id de l’enregistrement de la demande 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 d’administrateur.

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

    Nom Description
    résultat Objet contenant les résultats de l’avancement de la tâche du 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.progression Pourcentage qui indique à quel point un test est proche de l’achèvement lorsqu’il est en cours d’exécution.

    Type de données : nombre
    résultat.état État actuel de l’enregistrement de la demande de recommandation.

    Valeurs possibles :

    • 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 de tests.
    • 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 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.
    • En cours d’exécution : Les navigateurs de l’infrastructure cloud trouvent et exécutent les 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 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é,
    • Nécessite une réinitialisation du mot de passe,
    • Est administrateur,
    • Est en lecture seule,
    • Est services Web uniquement

    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
    Aucun
    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é,
    • Nécessite une réinitialisation du mot de passe,
    • Est administrateur,
    • Est en lecture seule,
    • Est services Web uniquement

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

    Type de données : chaîne
    Tableau 9. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    Aucun

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement 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
    Aucun

    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 d’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.valideUtilisateur Marqueur indiquant si l’utilisateur répond aux critères d’utilisateur du cloud. Si la valeur est 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é dans le 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 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
    Aucun
    Tableau 14. Paramètres de requête
    Nom Description
    Aucun
    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 à cette action HTTP uniquement 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 de 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
    Aucun

    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 Insertion réussie d’une tâche de demande d’achat d’utilisateur de 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 d’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 de nomenclature qui est inséré lorsque la tâche de l’utilisateur de test démarre avec succès.

    Type de données : chaîne

    Table : Demande de changement [sn_atf_tg_sn_boq]

    Demande cURL

    L’exemple de demande suivant montre comment insérer une tâche d’utilisateur 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 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 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
    Aucun
    Tableau 20. Paramètres de requête
    Nom Description
    Aucun
    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 à cette action HTTP uniquement 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 de 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
    Aucun

    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 Le travail de demande de changement a été annulé avec succès.
    400 Erreur lors de l’annulation de la tâche. Renvoie l’un des messages suivants :
    • Aucun ID de confirmation d’achat transmis : aucun ID de confirmation d’achat n’a été fourni. Ajoutez l’ID de confirmation des achats au corps de la demande.
    • Impossible de trouver l’enregistrement BOQ : ID système non valide. Vérifiez que l’sys_id de l’enregistrement de la demande 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 d’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 indiquant 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 test dans la table 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 la réponse réussie :

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

    Utilisateur 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 d’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
    Aucun
    Tableau 26. Paramètres de requête
    Nom Description
    Aucun
    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 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 à cette action HTTP uniquement 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 de 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
    Aucun

    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 tâches d’exécution et de génération de tests.
    400 Erreur lors du test de l’infrastructure de l’exécuteur cloud de bout en bout complète et lors de la définition de l’utilisateur du cloud. Assurez-vous que le nom d’utilisateur n’est pas vide ou qu’il 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 d’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 les futures exécutions de tests et générations de tests sur l’infrastructure de l’exécuteur dans le cloud.

    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 indiquant que l’utilisateur du cloud a été sélectionné avec succès pour les exécutions de tests et les générations.

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