--- sourceDocument: Référence de l’API Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Référence de l’API Xanadu ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # API ouverte de Gestion des tests de service # API ouverte de Gestion des tests de service {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 97 minutes de lecture L'API ouverte de gestion des tests de service fournit des points de terminaison pour créer et récupérer des définitions de test de service et des tests de service. Utilisez cette API pour gérer les informations de gestion des problèmes de service entre les systèmes externes et le Now Platform. L'API ouverte de gestion des tests de service est une ServiceNow implémentation de la spécification REST de l'API de gestion des problèmes de service TM Forum. Cette implémentation est basée sur . Cette API REST est conçue pour gérer et exécuter des tests de service dans un environnement de télécommunications. Elle permet aux utilisateurs de définir, de déclencher et de surveiller les tests de service, afin de s'assurer que les services répondent aux normes de qualité et de performances. L'API fournit des options pour la gestion des tests, y compris la création et la mise à jour des définitions de test, l'exécution de tests, la récupération des résultats des tests et la gestion des calendriers de tests. L'API ouverte Gestion des tests de service nécessite le module d'extension Gestion des problèmes du service clientèle (com.sn_sprb_mgmt) et le rôle sn_sprb_mgmt.test_integrator. Cette API appartient à l'espace de noms sn_sprb_mgmt. Pour plus d'informations sur la gestion des problèmes de service. Consultez [Customer Service Problem Management](https://www.servicenow.com/docs/access?context=cspm-landing-page&version=xanadu&pubname=xanadu-proactive-service-exp-workflows&ft:locale=en-US) pour plus d'informations sur cette application. L'API ouverte de gestion des tests de service crée ou met à jour des données dans les tables suivantes : * Exécution du test \[sn_st_mgmt_test\] * Définition du test de service \[sn_st_mgmt_test_definition\] * Caractéristique de la définition de test \[sn_st_mgmt_test_definition_characteristic\] * Caractéristique du test \[sn_st_mgmt_test_characteristic\] * Relation entre spécification et définition de test \[sn_st_mgmt_test_definition_m2m\] * Relation de définition de test \[sn_st_mgmt_test_definition_rel\] * Mesure de test \[sn_st_mgmt_test_measure\] * Mesurer la conséquence \[sn_st_mgmt_measure_consequence\] * Définition de la mesure de test \[sn_st_mgmt_test_measure_definition\] * Conséquence appliquée \[sn_st_mgmt_applied_consequence\] * Règle de seuil \[sn_st_mgmt_threshold_rule\] * Violation de la règle de seuil \[sn_st_mgmt_threshold_rule_violation\] {#service-test-management-api__ul_a4n_gcw_4bc} ## API ouverte de gestion des tests de service : GET /sn_sprb_mgmt/servicetestmanagement/serviceTest {#ariaid-title2} Récupère une liste de tous les tests de service. ### Format d'URL URL par défaut : /api/sn_sprb_mgmt/servicetestmanagement/serviceTest ### Paramètres de demande pris en charge {#servicetestmgmt-GET-serviceTest__entry__2} | Nom | Description | |-|-| | Aucun | | [Tableau 1. Paramètres de chemin d'accès] {#servicetestmgmt-GET-serviceTest__entry__6} | Nom | Description | |-|-| | champs | Liste des champs à renvoyer dans la réponse. Les champs non valides sont ignorés. Si ce paramètre n'est pas utilisé, tous les champs sont renvoyés. Situé dans la table Test de service \[sn_st_mgmt_test\]. Champs valides : * characteristic * description * endDateTime * id * Mode * service connexe * startDateTime * État * testMeasure (en anglais seulement) * testSpecification (Spécification de test) * valideFor {#servicetestmgmt-GET-serviceTest__ul_mtw_b3v_bcc} Type de données : chaîne | | limite | Nombre maximal d'enregistrements à renvoyer. Pour les demandes qui dépassent ce nombre d'enregistrements, utilisez le paramètre pour paginer la récupération de l'enregistrement offset . Type de données : nombre Valeur maximale : 100 Par défaut : 20 | | décalage | Index de départ auquel commencer à récupérer des enregistrements. Utilisez ce paramètre pour paginer les résultats en petits blocs faciles à gérer. Le premier enregistrement est indexé à 0. Type de données : nombre Par défaut : 0 | | État | Filtrez les définitions de test en fonction de l'état actuel du test. Seules les définitions de test dans l'état spécifié sont renvoyées dans la réponse. Valeurs valides : * confirmé * annulé * terminé * échoué * inProgress * en attente * rejeté {#servicetestmgmt-GET-serviceTest__ul_vzj_npn_xbc} Type de données : chaîne | [Tableau 2. Paramètres de requête] {#servicetestmgmt-GET-serviceTest__entry__16} | Nom | Description | |-|-| | Aucun | | [Tableau 3. Paramètres de corps de demande (XML ou JSON)] ### 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](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#servicetestmgmt-GET-serviceTest__entry__20} | En-tête | Description | |-|-| | Aucun | | [Tableau 4. En-têtes de demandes] {#servicetestmgmt-GET-serviceTest__entry__24} | En-tête | Description | |-|-| | Plage de contenu | Spécifie la plage de contenu renvoyée dans un appel paginé. Par exemple, si `offset=2` et `limit=3`, la valeur de l'en-tête Content-Range est les éléments `3 à 5`. | | Type de contenu | Format de données du corps de la réponse. Prend uniquement en charge application/json. | | Lien | Contient les liens suivants pour parcourir les résultats de la requête. * premier * dernier * suivant * previous {#servicetestmgmt-GET-serviceTest__ul_yy3_2fs_pbc} | | X-Total-Count | Pour les requêtes paginées, cet en-tête indique le nombre total d'enregistrements disponibles sur le serveur. | [Tableau 5. En-têtes de réponses] ### 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](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#servicetestmgmt-GET-serviceTest__entry__34}{#servicetestmgmt-GET-serviceTest__entry-200-status-code}{#servicetestmgmt-GET-serviceTest__entry-400-status-code}{#servicetestmgmt-GET-serviceTest__entry-404-status-code} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 206 | Ressource partielle renvoyée en réponse (avec pagination). | | 400 | Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. | | 404 | Introuvable. L'élément demandé est introuvable. | [Tableau 6. Codes d'état] {#servicetestmgmt-GET-serviceTest__table_ash_mhx_vbc__entry__2} | Nom | Description | |-|-| | characteristic | Liste décrivant les caractéristiques du test de service associé. Pour plus d'informations sur les caractéristiques des définitions de test, voir Type de données : tableau d'objets "characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ] | | characteristic.id | Sys_id ou external_id de caractéristiques. Situé dans la table Caractéristiques \[sn_prd_pm_characteristic\]. Si external_id est présent pour cet enregistrement, la réponse renvoie le external_id sinon elle renvoie le sys_id. Type de données : chaîne | | characteristic.name | Nom de la caractéristique. Type de données : chaîne | | valeur.caractéristique | Options de la caractéristique associées au test de service. Les caractéristiques varient en fonction de l'instance client. Type de données : chaîne | | type.valeur.caractéristique | Type de valeur caractéristique. * Oui/Non * choix * date * Date/Heure * durée * E-mail * étiquette * Test sur ligne unique {#servicetestmgmt-GET-serviceTest__ul_zfr_twr_dcc} Type de données : chaîne | | description | Description du test de service. Type de données : chaîne | | endDateTime | Date et heure de fin du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | href | Lien hypertexte renvoyant au test de service. Type de données : chaîne | | id | Sys_id ou external_id de la définition de test de service. Situé dans la table Test de service \[sn_st_mgmt_test\]. Type de données : chaîne | | Mode | Mode dans lequel le test de service s'exécute. Valeurs valides : * ONDEMAND : déclenche manuellement le test de service. * PROACTIF : déclenche automatiquement le test de service. {#servicetestmgmt-GET-serviceTest__ul_ybc_mqn_xbc} Par défaut : ONDEMAND | | nom | Requis. Nom du test de service. Type de données : chaîne | | service connexe | Requis. La définition de test associée au test de service. Type de données : objet "relatedService": { "href": "String", "id": "String", "name": "String" } | | relatedService.id | Sys_id ou external_id de l'inventaire des produits. Situé dans le champ sys_id ou external_id de la table Inventaire des produits \[sn_prd_invt_product_inventory\]. Type de données : chaîne | | relatedService.name | Nom de l'inventaire des produits. Type de données : chaîne | | startDateTime | Date et heure de début du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | État | État dans lequel se trouve le test de service. Valeurs valides : * confirmé * annulé * terminé * échoué * inProgress * en attente * rejeté {#servicetestmgmt-GET-serviceTest__ul_gym_mqn_xbc} Type de données : chaîne | | testMeasure (en anglais seulement) | Mesure d'un aspect spécifique d'un test de produit, de service ou de ressource, comme les paquets perdus ou l'état de connectivité. Type de données : tableau d'objets "testMeasure": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array], "unitOfMeasure": "String", "value": {Object} } ] | | testMeasure.accuracy | Valeur décimale flottante représentant la précision de la mesure de test capturée pour les mesures associées. Type de données : nombre Valeur maximale : 40 | | testMeasure.captureDateTime | Date et heure de capture de la mesure. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasure.id | Sys_id ou external_id des mesures de test. Situé dans les champs sys_id ou external_id de la table Mesures de test \[sn_st_mgmt_test_measure\]. Type de données : chaîne | | testMeasure.Measure.captureMethod | Méthode utilisée pour capturer la mesure. Valeurs valides : * automatique : capture automatiquement la mesure. * manual : capturez manuellement la mesure. * aucun : ne pas capturer la mesure. {#servicetestmgmt-GET-serviceTest__ul_ed2_gxv_xbc} Type de données : chaîne | | testMeasure.metricDescription | Brève description de la mesure. Type de données : chaîne | | testMeasure.metricName | Nom de la mesure de test. Type de données : chaîne | | testMeasure.ruleViolation | Objet pour la définition d'une règle dans la définition de la règle de seuil, ainsi que les conséquences en cas de violation de la règle. Type de données : tableau d'objets "ruleViolation"[ { appliedConsequence: [Array], conformanceTargetUpper: Number, conformanceComparatorUpper: "String", description: "String", id: "String", name: "String", numberOfAllowedCrossing: Number, thresholdRuleSeverity: "String", tolerancePeriod: "String" } ] | | testMeasure.ruleViolation.tolerancePeriod.amount | Nombre de périodes avant l'application de la conséquence. Type de données : nombre | | testMeasure.ruleViolation.appliedConsequence | Action (action prescrite ou notification) à prendre lorsqu'une règle de seuil est franchie. Type de données : tableau d'objets "appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ] | | testMeasure.ruleViolation.appliedConsequence.appliedAction | Action à exécuter en cas de violation d'une règle de seuil. Par exemple, l'envoi d'un avertissement ou la génération d'un rapport. Les actions appliquées peuvent varier d'une instance à l'autre. Type de données : chaîne | | testMeasure.ruleViolation.appliedSequence.description | Description de la conséquence appliquée. Type de données : chaîne | | testMeasure.ruleViolation.appliedConsequence.id | Sys_id ou external_id de la conséquence appliquée. Type de données : chaîne | | testMeasure.ruleViolation.appliedConsequence.name | Nom de la conséquence appliquée. Type de données : chaîne | | testMeasure.ruleViolation.appliedConsequence.repeatAction | Marqueur indiquant s'il faut répéter la conséquence lorsqu'une deuxième infraction se produit. Valeurs valides : * vrai : répétez l'action. * false : Répétez l'action. {#servicetestmgmt-GET-serviceTest__ul_ld2_gxv_xbc} Type de données : booléennes Valeur par défaut : false | | testMesure.règleViolation.conformitéComporatorExact | Marqueur indiquant si une valeur est identique. Valeurs valides : * true : la valeur est identique. * false : la valeur n'est pas identique. {#servicetestmgmt-GET-serviceTest__ul_od2_gxv_xbc} Type de données : booléennes Valeur par défaut : false | | testMesure.règleViolation.conformitéComporatorInférieur | Opérateur permettant de vérifier si une valeur tombe en dessous du seuil. Valeurs valides : * supérieur à * supérieur ou égal à {#servicetestmgmt-GET-serviceTest__ul_sd2_gxv_xbc} Type de données : chaîne | | testMesure.règleViolation.conformitéComporatorSupérieur | Opérateur permettant de vérifier si une valeur est supérieure au seuil. Valeurs valides : * inférieur à * inférieur ou égal à {#servicetestmgmt-GET-serviceTest__ul_vd2_gxv_xbc} Type de données : chaîne | | testMeasure.ruleViolation.conformanceTargetExact | Obligatoire si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur vrai, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre | | testMeasure.ruleViolation.conformanceTargetLower | Valeur de seuil inférieure pour comparer les résultats de la mesure de test. Détermine si le seuil est atteint ou plus. Type de données : nombre | | testMeasure.ruleViolation.conformanceTargetUpper | Valeur de seuil supérieure pour la comparaison des résultats de la mesure de test. Détermine si le seuil est atteint ou plus. Type de données : nombre | | testMeasure.ruleViolation.description | Description de la règle de seuil. Type de données : chaîne | | testMeasure.ruleViolation.id | Sys_id ou external_id de la violation de la règle de seuil. Situé dans la table Violation de la règle de seuil \[sn_st_mgmt_threshold_rule_violation\]. Type de données : chaîne | | testMeasure.ruleViolation.name | Nom de la règle de seuil. Type de données : chaîne | | testMeasure.ruleViolation.numberOfAllowedCrossing | Croisements maximaux autorisés pendant la période de tolérance avant l'application des conséquences. Type de données : nombre Valeur maximale : 40 | | testMeasure.ruleViolation.thresholdRuleSeverity | Gravité de la règle de seuil. Valeurs valides : * élevé * moyen * faible {#servicetestmgmt-GET-serviceTest__ul_xd2_gxv_xbc} Type de données : chaîne | | testMeasure.ruleViolation.tolerancePeriod | Intervalle de temps spécifié pendant lequel les occurrences de croisement sont activées sans déclencher de conséquences ou d'actions immédiates. Type de date : Objet "tolerancePeriod": { "amount": Number, "units": "String" } | | testMeasure.ruleViolation.tolerancePeriod.units | Unités de la période. Valeurs acceptées : * secondes * minutes * jours * Heures {#servicetestmgmt-GET-serviceTest__ul_qbw_qds_dcc} Type de données : chaîne | | testMeasure.unitOfMeasure | Spécifie l'unité de mesure pour les valeurs cibles de conformité de la mesure d'essai. Type de données : chaîne | | testMeasure.value | Valeur de la mesure de test. Type de données : objet "value": { "id": "String", "name": "String", "valueType": "String", "value": "String } | | testMeasure.value.id | ID de la valeur de la mesure de test. Type de données : chaîne | | testMeasure.value.name | Nom de la valeur de la mesure de test. Type de données : chaîne | | testMeasure.value.value | Valeur de la mesure de test. Type de données : chaîne | | testMeasure.value.valueType | Type de valeur de mesure de test (numérique, texte, etc.). Type de données : chaîne | | testSpecification (Spécification de test) | Requis. La définition de test associée à ce test. Type de données : objet "testSpecification": { "id": "String", "href": "String" } | | testSpecification.href | Lien hypertexte renvoyant à la définition de test de service. Type de données : chaîne | | testSpecification.id | Le sys_id ou le external_id de la définition de test de service. Situé dans le champ sys_id ou external_id de la table Définition de test de service \[sn_st_mgmt_test_definition\]. Type de données : chaîne | | valideFor | Plage de dates pour laquelle le test de service est valide. Type de données : objet "validFor": { "startDateTime": "String", "endDateTime ": "String" } | | valideFor.endDateTime | Date de fin de validité du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | valideFor.startDateTime | Date de début de validité du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | [Tableau 7. Paramètres du corps de réponse (XML ou JSON)] {#servicetestmgmt-GET-serviceTest__table_ash_mhx_vbc} ### Demande cURL L'exemple suivant récupère des informations sur les deux tests de service dans l'instance. curl --location --request GET "https://instance.servicenow.com/api/sn_sprb_mgmt/servicetestmanagement/serviceTest" \ --user 'username': 'password' Corps de réponse. [ { "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTest/09d1f42e3be28210d140068aa4e45ae2", "id": "09d1f42e3be28210d140068aa4e45ae2", "description": "Service test", "endDateTime": "2025-01-31 15:05:43", "mode": "proactive", "name": "Speed Test TR0001002", "startDateTime": "2024-06-05 09:07:10", "validFor": { "startDateTime": "", "endDateTime": "" }, "relatedService": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "name": "Internet_VPLS_PI0000011" }, "testSpecification": { "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/7d3854864316c6500e51203d5fb8f2d8", "id": "7d3854864316c6500e51203d5fb8f2d8" }, "characteristic": [], "testMeasure": [ { "id": "61d1382e3be28210d140068aa4e45a2e", "accuracy": "0.0001", "captureDateTime": "", "captureMethod": "automatic", "metricDescription": "", "metricName": "Flow speed", "unitOfMeasure": "A second", "value": "3000", "ruleViolation": [ { "id": "61d1382e3be28210d140068aa4e45a2f", "description": "This speed is greater than the target", "name": "tooMuchTraffic", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "", "conformanceTargetLower": "2500", "conformanceComparatorLower": "greater than", "appliedConsequence": [ { "id": "65d1382e3be28210d140068aa4e45a31", "appliedAction": "sendWarning", "description": "send a warning to the system", "name": "sendWarning", "repeatAction": "0" } ] } ] } ] }, { "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTest/18682a2a3b2682107222bf9985e45a55", "id": "18682a2a3b2682107222bf9985e45a55", "description": "Service test", "endDateTime": "2025-01-31 15:05:43", "mode": "proactive", "name": "Speed Test TR0001012", "startDateTime": "2024-06-05 17:45:07", "validFor": { "startDateTime": "", "endDateTime": "" }, "relatedService": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "name": "Internet_VPLS_PI0000011" }, "testSpecification": { "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/7d3854864316c6500e51203d5fb8f2d8", "id": "7d3854864316c6500e51203d5fb8f2d8" }, "characteristic": [ { "id": "5c682a2a3b2682107222bf9985e45a5a", "name": "url", "valueType": "single_line_text", "value": "http://abc.com" } ], "testMeasure": [ { "id": "7c686a2a3b2682107222bf9985e45a4d", "accuracy": "0.0001", "captureDateTime": "", "captureMethod": "automatic", "metricDescription": "", "metricName": "Flow speed", "unitOfMeasure": "A second", "value": "3000", "ruleViolation": [ { "id": "38686a2a3b2682107222bf9985e45a4e", "description": "This speed is greater than the target", "name": "tooMuchTraffic", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "", "conformanceTargetLower": "2500", "conformanceComparatorLower": "greater than", "appliedConsequence": [ { "id": "34686a2a3b2682107222bf9985e45a50", "appliedAction": "sendWarning", "description": "send a warning to the system", "name": "sendWarning", "repeatAction": "0" } ] } ] } ] } ] ## API ouverte de gestion des tests de service : GET /sn_sprb_mgmt/servicetestmanagement/serviceTest/{id} {#ariaid-title3} Récupère une entité de test de service en fonction de l'ID donné d'un test de service. ### Format d'URL URL par défaut : /api/sn_sprb_mgmt/servicetestmanagement/serviceTest/{id} ### Paramètres de demande pris en charge {#servicetestmgmt-GET-serviceTest-id__entry__2} | Nom | Description | |-|-| | id | Requis. Sys_id ou external_id du test de service à récupérer. Situé dans la table Test de service \[sn_st_mgmt_test\]. Type de données : chaîne | [Tableau 8. Paramètres de chemin d'accès] {#servicetestmgmt-GET-serviceTest-id__entry__6} | Nom | Description | |-|-| | champs | Liste des champs à renvoyer dans la réponse. Les champs non valides sont ignorés. Si ce paramètre n'est pas utilisé, tous les champs sont renvoyés. Situé dans la table Test de service \[sn_st_mgmt_test\]. Champs valides : * characteristic * description * endDateTime * id * Mode * service connexe * startDateTime * État * testMeasure (en anglais seulement) * testSpecification (Spécification de test) * valideFor {#servicetestmgmt-GET-serviceTest-id__ul_mtw_b3v_bcc} Type de données : chaîne | [Tableau 9. Paramètres de requête] {#servicetestmgmt-GET-serviceTest-id__entry__10} | Nom | Description | |-|-| | Aucun | | [Tableau 10. Paramètres de corps de demande (XML ou JSON)] ### 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](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#servicetestmgmt-GET-serviceTest-id__entry__14} | En-tête | Description | |-|-| | Aucun | | [Tableau 11. En-têtes de demandes] {#servicetestmgmt-GET-serviceTest-id__entry__18} | En-tête | Description | |-|-| | Type de contenu | Format de données du corps de la réponse. Prend uniquement en charge application/json. | [Tableau 12. En-têtes de réponses] ### 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](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#servicetestmgmt-GET-serviceTest-id__entry__22}{#servicetestmgmt-GET-serviceTest-id__entry-200-status-code}{#servicetestmgmt-GET-serviceTest-id__entry-400-status-code}{#servicetestmgmt-GET-serviceTest-id__entry-404-status-code} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. | | 404 | Introuvable. L'élément demandé est introuvable. | [Tableau 13. Codes d'état] ### Paramètres du corps de réponse (JSON ou XML) {#servicetestmgmt-GET-serviceTest-id__section_vkd_xwr_pbc} {#servicetestmgmt-GET-serviceTest-id__section_vkd_xwr_pbc__entry__2} | Nom | Description | |-|-| | characteristic | Liste décrivant les caractéristiques du test de service associé. Type de données : tableau d'objets "characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ] | | characteristic.id | Sys_id ou external_id de caractéristiques. Situé dans la table Caractéristiques \[sn_prd_pm_characteristic\]. Si external_id est présent pour cet enregistrement, la réponse renvoie le external_id sinon elle renvoie le sys_id. Type de données : chaîne | | characteristic.name | Nom de la caractéristique. Type de données : chaîne | | valeur.caractéristique | Options de la caractéristique associées au test de service. Les caractéristiques varient en fonction de l'instance client. Type de données : chaîne | | type.valeur.caractéristique | Type de valeur caractéristique. * Oui/Non * choix * date * Date/Heure * durée * E-mail * étiquette * Test sur ligne unique {#servicetestmgmt-GET-serviceTest-id__ul_egw_twr_dcc} Type de données : chaîne | | description | Description du test de service. Type de données : chaîne | | endDateTime | Date et heure de fin du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | href | Lien hypertexte renvoyant au test de service. Type de données : chaîne | | id | Sys_id ou external_id de la définition de test de service. Situé dans la table Test de service \[sn_st_mgmt_test\]. Type de données : chaîne | | Mode | Mode dans lequel le test de service s'exécute. Valeurs valides : * ONDEMAND : déclenche manuellement le test de service. * PROACTIF : déclenche automatiquement le test de service. {#servicetestmgmt-GET-serviceTest-id__ul_itl_ksn_xbc} Par défaut : ONDEMAND | | nom | Nom du test de service. Type de données : chaîne | | service connexe | Définition de test associée à ce test. Type de données : objet "relatedService": { "href": "String", "id": "String", "name": "String" } | | relatedService.id | sys_id ou external_id de l'inventaire des produits. Situé dans le champ sys_id ou external_id de la table Inventaire des produits \[sn_prd_invt_product_inventory\]. Type de données : chaîne | | relatedService.name | Nom de l'élément d'inventaire de produits. Type de données : chaîne | | startDateTime | Date et heure de début du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | État | État du test de service. Valeurs valides : * confirmé * annulé * terminé * échoué * inProgress * en attente * rejeté {#servicetestmgmt-GET-serviceTest-id__ul_prs_txv_xbc} | | testMeasure (en anglais seulement) | Mesure d'un aspect spécifique d'un test de produit, de service ou de ressource, comme les paquets perdus ou l'état de connectivité. Type de données : tableau d'objets "testMeasureDefinition": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array] "unitOfMeasure": "String", "value": {Object} } ] | | testMeasure.accuracy | Valeur décimale flottante représentant la précision de la mesure de test capturée pour les mesures associées. Type de données : nombre Valeur maximale : 40 | | testMeasure.captureDateTime | Date et heure de capture de la mesure. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasure.captureMethod | Méthode utilisée pour capturer la mesure. Valeurs valides : * automatique : capture automatiquement la mesure. * manual : capturez manuellement la mesure. * aucun : ne pas capturer la mesure. {#servicetestmgmt-GET-serviceTest-id__ul_zrs_txv_xbc} Type de données : chaîne | | testMeasure.id | Sys_id ou external_id de la mesure d'essai. Situé dans la table Mesures de test \[sn_st_mgmt_test_measure\]. Type de données : chaîne | | testMeasure.metricDescription | Brève description de la mesure. Type de données : chaîne | | testMeasure.metricName | Nom d'une mesure dans la mesure de test. Type de données : chaîne | | testMeasure.ruleViolation | Objet pour la définition d'une règle dans la définition de la règle de seuil, ainsi que les conséquences en cas de violation de la règle. Type de données : tableau d'objets "RuleViolation": [ { "appliedConsequence": [Array], "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": {Object} } ] | | testMeasure.ruleViolation.appliedConsequence | Action (action prescrite ou notification) à prendre en cas de violation d'une règle de seuil. Type de données : tableau d'objets "appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ] | | testMeasure.ruleViolation.appliedConsequence.appliedAction | Action à exécuter en cas de violation d'une règle de seuil. Par exemple, l'envoi d'un avertissement ou la génération d'un rapport. Les actions appliquées peuvent varier d'une instance à l'autre. Type de données : chaîne | | testMeasure.ruleViolation.appliedConsequence.appliedAction.repeatAction | Marqueur indiquant s'il faut répéter l'action appliquée ou non. Valeurs valides : * vrai : répète l'action. * faux : ne répète pas l'action. {#servicetestmgmt-GET-serviceTest-id__ul_kss_txv_xbc} Type de données : booléennes Valeur par défaut : false | | testMeasure.ruleViolation.appliedSequence.description | Description de la conséquence appliquée. Type de données : chaîne | | testMeasure.ruleViolation.appliedConsequence.id | Sys_id ou external_id de la conséquence appliquée. Type de données : chaîne | | testMeasure.ruleViolation.appliedConsequence.name | Nom de la conséquence appliquée. Type de données : chaîne | | testMeasure.ruleViolation.conformanceComparatorExact | Marqueur indiquant si une valeur est identique à la valeur de conformanceTargetExact. Valeurs valides : * true : la valeur est identique. * false : la valeur n'est pas identique. {#servicetestmgmt-GET-serviceTest-id__ul_uss_txv_xbc} Type de données : booléennes Valeur par défaut : false | | testMeasure.ruleViolation.conformanceComparatorLower | Opérateur qui vérifie si une valeur tombe en dessous du seuil. Valeurs valides : * supérieur à * est {#servicetestmgmt-GET-serviceTest-id__ul_fts_txv_xbc} Type de données : chaîne | | testMeasure.ruleViolation.conformanceComparatorUpper | Opérateur qui vérifie si une valeur dépasse le seuil. Valeurs valides : * est * inférieur à {#servicetestmgmt-GET-serviceTest-id__ul_mts_txv_xbc} Type de données : chaîne | | testMeasure.ruleViolation.conformanceTargetExact | Obligatoire si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur vrai, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre | | testMeasure.ruleViolation.conformanceTargetLower | Valeur de seuil inférieure pour comparer les résultats de la mesure de test. Détermine si le seuil est atteint ou plus. Type de données : nombre | | testMeasure.ruleViolation.conformanceTargetUpper | Valeur de seuil supérieure pour la comparaison des résultats de la mesure de test. Détermine si le seuil est atteint ou plus. Type de données : nombre | | testMeasure.ruleViolation.description | Description de la violation de la règle de seuil. Type de données : chaîne | | testMeasure.ruleViolation.id | Sys_id ou external_id de la violation de la règle de seuil. Situé dans la table Violation de la règle de seuil \[sn_st_mgmt_threshold_rule_violation\]. Type de données : chaîne | | testMeasure.ruleViolation.name | Nom de la violation de la règle de seuil. Type de date : chaîne | | testMeasure.ruleViolation.numberOfAllowedCrossing | Croisements maximaux autorisés pendant la période de tolérance avant l'application des conséquences. Type de données : nombre Maximum : 40 | | testMeasure.ruleViolation.thresholdRuleSeverity | Gravité de la règle de seuil. Valeurs valides : * élevé * faible * moyen {#servicetestmgmt-GET-serviceTest-id__ul_tts_txv_xbc} Type de données : chaîne | | testMeasure.ruleViolation.tolerancePeriod | Durée ou intervalle de temps pendant lequel des croisements autorisés peuvent se produire avant qu'une conséquence ne soit déclenchée. Type de date : Objet "tolerancePeriod": { "amount": Number, "units": "String" } | | testMeasure.ruleViolation.tolerancePeriod.amount | Montant de la période en nombre. Type de données : nombre | | testMeasure.ruleViolation.tolerancePeriod.units | Unités de la période. Valeurs acceptées : * secondes * minutes * jours * Heures {#servicetestmgmt-GET-serviceTest-id__ul_my3_qds_dcc} Type de données : chaîne | | testMeasure.unitOfMeasure | Valeur mesurable de temps utilisée pour calculer la performance d'un service en jours, minutes et secondes. Type de données : chaîne | | testMeasure.value | Valeur de la mesure dans le test. Type de données : objet "value": { "id": "String", "name": "String", "valueType": "String", "value": "String" } | | testMeasure.value.id | ID de la valeur de mesure dans le test. Type de données : chaîne | | testMeasure.value.name | Nom de la valeur de mesure dans le test. Type de données : chaîne | | testMeasure.value.value | Valeur de la mesure dans le test. Type de données : chaîne | | testMeasure.value.valueType | Type de valeur de mesure de test (numérique, texte, etc.). Type de données : chaîne | | testSpecification (Spécification de test) | Définition de test associée pour ce test. Type de données : objet "testSpecification": { "href": "String", "id": "String" } | | testSpecification.href | Lien hypertexte renvoyant à la définition de test de service. Type de données : chaîne | | testSpecification.id | Sys_id ou external_id de la définition de test de service. Situé dans le champ sys_id ou external_id de la table Définition de test de service \[sn_st_mgmt_test_definition\]. Type de données : chaîne | | valideFor | Plage de dates pour laquelle le test de service est valide. Type de données : objet "validFor": { "startDateTime": "String", "endDateTime": "String" } | | valideFor.endDateTime | Date de fin et horodatage du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | valideFor.startDateTime | Date et horodatage de début du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | [ ] ### Demande cURL {#servicetestmgmt-GET-serviceTest-id__example_z5y_hvr_rbc} L'exemple suivant récupère les détails sur l'entité de test de service associée à l'ID donné, 44b7a8ea3b6a42107222bf9985e45a45. curl --location --request GET "https://instance.servicenow.com/api/sn_sprb_mgmt/servicetestmanagement/serviceTest/44b7a8ea3b6a42107222bf9985e45a45 \ --user 'username': 'password' Corps de réponse. { "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTest/44b7a8ea3b6a42107222bf9985e45a45", "id": "44b7a8ea3b6a42107222bf9985e45a45", "description": "Service test", "endDateTime": "2025-01-31 15:05:43", "mode": "proactive", "name": "Speed Test TR0001001", "startDateTime": "2024-06-05 08:22:52", "validFor": { "startDateTime": "", "endDateTime": "" }, "relatedService": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "name": "Internet_VPLS_PI0000011" }, "testSpecification": { "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/7d3854864316c6500e51203d5fb8f2d8", "id": "7d3854864316c6500e51203d5fb8f2d8" }, "characteristic": [ { "id": "5c682a2a3b2682107222bf9985e45a5a", "name": "url", "valueType": "single_line_text", "value": "test" } ], "testMeasure": [ { "id": "62ade42a3ba28210d140068aa4e45a71", "accuracy": "0.0001", "captureDateTime": "", "captureMethod": "automatic", "metricDescription": "", "metricName": "Downstream Speed", "unitOfMeasure": "", "value": "16", "ruleViolation": [ { "id": "b9bee4ae3ba28210d140068aa4e45a3a", "description": "This speed is less than the target upper", "name": "tooMuchTraffic", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "", "conformanceTargetUpper": "75", "conformanceComparatorUpper": "less than", "appliedConsequence": [ { "id": "489074aa3be28210d140068aa4e45a42", "appliedAction": "generateReport", "description": "", "name": "generateReport", "repeatAction": "0" }, { "id": "785f2ce23be28210d140068aa4e45a75", "appliedAction": "sendWarning", "description": "", "name": "sendWarning", "repeatAction": "0" } ] } ] } ] } ## API ouverte de gestion des tests de service : GET /sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification {#ariaid-title4} Récupère une liste de toutes les définitions de test de service. ### Format d'URL URL par défaut : GET /api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification ### Paramètres de demande pris en charge {#servicetestmgmt-GET-servTestSpecif__entry__2} | Nom | Description | |-|-| | Aucun | | [Tableau 14. Paramètres de chemin d'accès] {#servicetestmgmt-GET-servTestSpecif__entry__6} | Nom | Description | |-|-| | champs | Liste des champs à renvoyer dans la réponse. Les champs non valides sont ignorés. Si ce paramètre n'est pas utilisé, tous les champs sont renvoyés. Situé dans la table Définition de test de service \[sn_st_mgmt_test_definition\]. Valeurs valides : * description * id * nom * relatedServiceSpecification (en anglais seulement) * serviceTestSpecRelationship * specCharacteristic (en anglais seulement) * testMeasureDefinition * valideFor {#servicetestmgmt-GET-servTestSpecif__ul_hss_b3v_bcc} Type de données : chaîne | | limite | Nombre maximal d'enregistrements à renvoyer. Pour les demandes qui dépassent ce nombre d'enregistrements, utilisez le paramètre pour paginer la récupération de l'enregistrement offset . Type de données : nombre Valeur maximale : 100 Par défaut : 20 | | décalage | Index de départ auquel commencer à récupérer des enregistrements. Utilisez ce paramètre pour paginer les résultats en petits blocs faciles à gérer. Le premier enregistrement est indexé à 0. Type de données : nombre Par défaut : 0 | | État | Filtrez les définitions de test en fonction de l'état actuel du test. Seules les définitions de test dans l'état spécifié sont renvoyées dans la réponse. Valeurs valides : * Archivés * brouillon * publié * retraité Type de données : chaîne | [Tableau 15. Paramètres de requête] {#servicetestmgmt-GET-servTestSpecif__entry__16} | Nom | Description | |-|-| | Aucun | | [Tableau 16. Paramètres de corps de demande (XML ou JSON)] ### 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](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#servicetestmgmt-GET-servTestSpecif__entry__20}{#servicetestmgmt-GET-servTestSpecif__accept-RESTAPI} | 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 17. En-têtes de demandes] {#servicetestmgmt-GET-servTestSpecif__entry__24} | En-tête | Description | |-|-| | Plage de contenu | Spécifie la plage de contenu renvoyée dans un appel paginé. Par exemple, si `offset=2` et `limit=3`, la valeur de l'en-tête Content-Range est les éléments `3 à 5`. | | Type de contenu | Format de données du corps de la réponse. Prend uniquement en charge application/json. | | Lien | Contient les liens suivants pour parcourir les résultats de la requête : * premier * dernier * suivant * previous {#servicetestmgmt-GET-servTestSpecif__ul_acj_pkx_4bc} | | X-Total-Count | Pour les requêtes paginées, cet en-tête indique le nombre total d'enregistrements disponibles sur le serveur. | [Tableau 18. En-têtes de réponses] ### 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](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#servicetestmgmt-GET-servTestSpecif__entry__34}{#servicetestmgmt-GET-servTestSpecif__entry-200-status-code}{#servicetestmgmt-GET-servTestSpecif__entry-400-status-code}{#servicetestmgmt-GET-servTestSpecif__entry-404-status-code} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 206 | Ressource partielle renvoyée en réponse (avec pagination). | | 400 | Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. | | 404 | Introuvable. L'élément demandé est introuvable. | [Tableau 19. Codes d'état] ### Paramètres du corps de réponse (JSON ou XML) {#servicetestmgmt-GET-servTestSpecif__section_xvz_1lx_4bc} {#servicetestmgmt-GET-servTestSpecif__table_yvz_1lx_4bc__entry__2} | Nom | Description | |-|-| | description | Description de la définition de test de service. Type de données : chaîne | | id | Sys_id ou external_id de la définition de test de service. Situé dans la table Définition de test de service \[sn_st_mgmt_test_definition\]. Type de données : chaîne | | nom | Requis. Nom de la définition de test de service. Type de données : chaîne | | relatedServiceSpecification (en anglais seulement) | Requis. Spécifications de service de la définition de test. Type de données : tableau d'objets "relatedServiceSpecification": [ { "id": "String", "name": "String" } ] | | relatedServiceSpecification.id | Sys_id ou external_id de la spécification de service. Situé dans le champ sys_id ou external_id de la table Spécification \[sn_prd_pm_specification\]. Type de données : chaîne | | relatedServiceSpecification.name | Nom de la spécification de service. Type de données : chaîne | | serviceTestSpecRelationship | Définition de test de service connexe. Type de données : tableau d'objets "serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ] | | serviceTestSpecRelationship.id | Sys_id ou external_id de la définition de test du service connexe. Situé dans le champ sys_id ou external_id de la table Définition de test \[sn_st_mgmt_test_definition\]. Type de données : chaîne | | serviceTestSpecRelationship.name | Nom de la définition de test connexe. Type de données : chaîne | | serviceTestSpecRelationship.relationshipType | Type de relation. Valeurs acceptées : * substitution * dépendance * exclusivité {#servicetestmgmt-GET-servTestSpecif__ul_hpg_xtr_dcc} Type de données : chaîne | | specCharacteristic (en anglais seulement) | Caractéristiques de la définition de test. Type de données : tableau d'objets "specCharacteristic": [ { "characteristicValueSpecification": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] | | specCharacteristic.characteristicValueSpecification | Tableau contenant les valeurs possibles de la caractéristique. Type de données : tableau d'objets "characteristicValueSpecification": [ { "value": "String" } ] | | specCharacteristic.characteristicValueSpecification.value | Valeur de la caractéristique. Type de données : chaîne | | specCharacteristic.description | Description de la caractéristique. Type de données : chaîne | | specCharacteristic.name | Nom de la caractéristique. Type de données : chaîne | | specCharacteristic.validFor | Plage de dates pour laquelle la caractéristique est valide. Type de données : objet "validFor": { "endDateTime": "String", "startDateTime": "String" } | | specCharacteristic.validFor.endDateTime | Date de fin de la caractéristique. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | specCharacteristic.validFor.startDateTime | Date de début de la caractéristique. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | specCharacteristic.valueType | Type de valeur caractéristique. * Oui/Non * choix * date * Date/Heure * durée * E-mail * étiquette * Test sur ligne unique {#servicetestmgmt-GET-servTestSpecif__ul_i3m_twr_dcc} Type de données : chaîne | | testMeasureDefinition | Définitions de mesure de test pour cette définition de test de service. Pour plus d'informations, consultez [Define test measure definitions for a service test](https://www.servicenow.com/docs/access?context=define-test-measure-spm&version=xanadu&pubname=xanadu-proactive-service-exp-workflows&ft:locale=en-US). Type de données : tableau d'objets "testMeasureDefinition": [ { "captureFrequency": "String", "captureMethod": "String", "capturePeriod": {Object}, "id": "String", "metricDescription": "String", "metricName": "String", "name": "String", "unitOfMeasure": "String", "thresholdRule": [Array], "validFor": {Object}, "valueType": "String" } ] | | testMeasureDefinition.captureFrequency | Fréquence à laquelle capturer la mesure. Valeurs valides : * aucun * une fois * quotidien * hebdomadaire * mensuel {#servicetestmgmt-GET-servTestSpecif__ul_lsw_jxv_xbc} Type de données : chaîne | | testMeasureDefinition.captureMethod | Méthode utilisée pour capturer la mesure. Valeurs valides : * automatique : capture automatiquement la mesure. * manual : capturez manuellement la mesure. * none : ne capture pas la mesure. {#servicetestmgmt-GET-servTestSpecif__ul_gsw_jxv_xbc} Type de données : chaîne | | testMeasureDefinition.capturePeriod | Période ou durée de la capture de mesure. Type de données : objet "capturePeriod": { "amount": Number, "units": "String" } | | testMeasureDefinition.capturePeriod.amount | Nombre de périodes de capture. Type de données : nombre | | testMeasureDefinition.capturePeriod.units | Unités de la période. Valeurs acceptées : * secondes * minutes * jours * Heures {#servicetestmgmt-GET-servTestSpecif__ul_rn1_3ds_dcc} Type de données : chaîne | | testMeasureDefinition.id | Sys_id ou external_id des définitions de mesure de test. Situé dans la table de définition de mesure de test \[sn_st_mgmt_test_measure_definition\]. Type de données : chaîne | | testMeasureDefinition.metricDescription | Brève description de la mesure. Type de données : chaîne | | testMeasureDefinition.metricName | Nom défini par l'utilisateur d'une mesure dans la mesure de test. Type de données : chaîne | | testMeasureDefinition.name | Nom de la définition de la mesure de test. Type de données : chaîne | | testMeasureDefinition.thresholdRule | Règle qui définit les conditions à remplir avant d'appliquer des conséquences lorsqu'un seuil est franchi (ou non dépassé) dans la définition de la mesure de test. Pour plus d'informations, consultez [Define threshold rules for a test measure definition](https://www.servicenow.com/docs/access?context=define-threshold-rules&version=xanadu&pubname=xanadu-proactive-service-exp-workflows&ft:locale=en-US). Type de données : tableau d'objets { "thresholdRule": { "consequence": Array, "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "consequence": Array, "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": Object } } | | testMeasureDefinition.thresholdRule.conformanceComparatorExact | Marqueur indiquant si une valeur est identique à la valeur définie pour testMeasureDefinition.thresholdRule.conformanceTargetExact. Si la valeur est définie sur vrai, testMeasureDefinition.thresholdRule.conformanceTargetExact est requise. Valeurs valides : * true : la valeur est identique à la valeur de conformanceTargetExact. * false : la valeur n'est pas identique.conformanceTargetExact {#servicetestmgmt-GET-servTestSpecif__ul_bsw_jxv_xbc} Type de données : booléennes Valeur par défaut : false | | testMeasureDefinition.thresholdRule.conformanceComparatorLower | Opérateur qui vérifie si une valeur tombe en dessous du seuil. Valeurs valides : * supérieur à * supérieur ou égal à {#servicetestmgmt-GET-servTestSpecif__ul_zrw_jxv_xbc} Type de données : chaîne | | testMeasureDefinition.thresholdRule.conformanceComparatorUpper | Opérateur qui vérifie si une valeur dépasse le seuil. Valeurs valides : * inférieur à * inférieur ou égal à {#servicetestmgmt-GET-servTestSpecif__ul_wrw_jxv_xbc} Type de données : chaîne | | testMeasureDefinition.thresholdRule.conformanceTargetExact | Obligatoire si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur vrai, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre | | testMeasureDefinition.thresholdRule.conformanceTargetLower | Valeur de seuil inférieure pour comparer les résultats de la mesure de test. Type de données : nombre | | testMeasureDefinition.thresholdRule.conformanceTargetUpper | Valeur de seuil supérieure pour la comparaison des résultats de la mesure de test. Type de données : nombre | | testMeasureDefinition.thresholdRule.consequence | Action (action prescrite ou notification) à prendre lorsqu'une règle de seuil est franchie. Pour plus d'informations, consultez [Define measure consequences for the threshold rules](https://www.servicenow.com/docs/access?context=define-threshold-consequences-spm&version=xanadu&pubname=xanadu-proactive-service-exp-workflows&ft:locale=en-US). Type de données : tableau d'objets "consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ] | | testMeasureDefinition.thresholdRule.consequence.description | Description de la conséquence. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.id | Sys_id ou external_id de la conséquence de la mesure. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.name | Nom de la conséquence. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.prescribeAction | Action définie par l'utilisateur à prendre en cas de violation de seuil. Les actions varient d'une instance à l'autre. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.repeatAction | Marqueur indiquant s'il faut répéter la conséquence appliquée. Valeurs valides : * vrai : répète l'action. * faux : ne répète pas l'action. {#servicetestmgmt-GET-servTestSpecif__ul_srw_jxv_xbc} Type de données : booléennes Valeur par défaut : false | | testMeasureDefinition.thresholdRule.consequence.validFor | Plage de dates pour laquelle la conséquence est valide. Type de données : objet "validFor": { "startDateTime": "String", "endDateTime ": "String" } | | testMeasureDefinition.thresholdRule.consequence.validFor.endDateTime | Date de fin de validité de la conséquence. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.validFor.startDateTime | Date de début de validité de la conséquence. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasureDefinition.thresholdRule.description | Description de la règle de seuil. Type de données : chaîne | | testMeasureDefinition.thresholdRule.id | Sys_id ou external_id des règles de seuil. Situé dans le champ Situé dans le champ sys_id ou external_id de la table Règles de seuil \[sn_st_mgmt_threshold_rule\]. Type de données : chaîne | | testMeasureDefinition.thresholdRule.name | Nom de la règle de seuil. Type de données : chaîne | | testMeasureDefinition.thresholdRule.numberOfAllowedCrossing | Croisements maximaux autorisés pendant la période de tolérance avant l'application des conséquences. Valeur maximale : 40 Type de données : nombre | | testMeasureDefinition.thresholdRule.thresholdRuleSeverity | Niveau de gravité de la règle de seuil. Valeurs valides : * élevé * moyen * faible {#servicetestmgmt-GET-servTestSpecif__ul_orw_jxv_xbc} Type de données : chaîne | | testMeasureDefinition.unitOfMeasure | Valeur mesurable de temps utilisée pour calculer la performance d'un service en jours, minutes et secondes. Type de données : chaîne | | testMeasureDefinition.validFor | Plage de dates pour laquelle la définition de mesure de test est valide. Type de données : chaîne "validFor": { "endDateTime": "String", "startDateTime": "String" } | | testMeasureDefinition.validFor.endDateTime | Date de fin de validité de la définition de la mesure d'essai. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasureDefinition.validFor.startDateTime | Date de début de validité de la définition de la mesure d'essai. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | valideFor | Plage de dates pour laquelle la définition de test est valide. Type de données : objet "validFor": { "endDateTime": "String", "startDateTime": "String" } | | valideFor.endDateTime | Date et heure de la définition de test sur lesquelles l'état de celle-ci est mis hors service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | valideFor.startDateTime | Date et heure de la définition de test sur laquelle son état est publié. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | [ ] {#servicetestmgmt-GET-servTestSpecif__table_yvz_1lx_4bc} ### Demande cURL Cet exemple récupère les détails de toutes les définitions de test de service de test dans l'instance. Dans ce cas, deux définitions sont renvoyées. curl --location --request GET "https://instance.servicenow.com//api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification" \ --user 'username': 'password' Corps de réponse. [ { "description": "Operation, Administration and Maintenance", "id": "76a3b160432a02104fefe4511fb8f2ad", "name": "OAM Test", "validFor": { "startDateTime": "", "endDateTime": "" }, "testMeasureDefinition": [ { "id": "77b9b964432a02104fefe4511fb8f26e", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the Rx signal level", "metricName": "Rx Optical Signal Level", "name": "Rx Optical Signal Level", "unitOfMeasure": "a minute", "valueType": "", "capturePeriod": "", "validFor": { "startDateTime": "", "endDateTime": "" }, "thresholdRule": [ { "id": "d3e97d64432a02104fefe4511fb8f281", "description": "", "name": "gponOntAniOpInfoRxOpticalSignalLevel", "numberOfAllowedCrossing": "", "thresholdRuleSeverity": "", "tolerancePeriod": "", "conformanceTargetUpper": "0", "conformanceComparatorUpper": "less than", "conformanceTargetLower": "-50", "conformanceComparatorLower": "greater than", "consequence": [] } ] }, { "id": "878afd64432a02104fefe4511fb8f28d", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the Tx signal level", "metricName": "TX Optical Signal Level", "name": "TX Optical Signal Level", "unitOfMeasure": "a minute", "valueType": "", "capturePeriod": "", "validFor": { "startDateTime": "", "endDateTime": "" }, "thresholdRule": [ { "id": "b3dab5a4432a02104fefe4511fb8f2d3", "description": "", "name": "gponOntAniOpInfoTxOpticalSignalLevel", "numberOfAllowedCrossing": "", "thresholdRuleSeverity": "", "tolerancePeriod": "", "conformanceTargetUpper": "65", "conformanceComparatorUpper": "less than", "conformanceTargetLower": "-65", "conformanceComparatorLower": "greater than", "consequence": [] } ] } ], "specCharacteristic": [ { "name": "AccessRequired", "description": "AccessRequired", "valueType": "yes_no", "validFor": { "startDatetime": "2024-05-30 09:09:57" }, "characteristicValueSpecification": [ { "value": "Yes", "validFor": { "startDateTime": "", "endDateTime": "" } }, { "value": "No", "validFor": { "startDateTime": "", "endDateTime": "" } } ] } ], "serviceTestSpecRelationship": [], "relatedServiceSpecification": [ { "id": "f559b564432a02104fefe4511fb8f2e0", "name": "OAM" } ] }, { "description": "Upstream and Downstream speed ", "id": "89d2b920432a02104fefe4511fb8f22e", "name": "Speed Test", "validFor": { "startDateTime": "2024-05-31", "endDateTime": "2024-06-27" }, "testMeasureDefinition": [ { "id": "1a04f560432a02104fefe4511fb8f2ad", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the downstream speed in a service", "metricName": "Downstream Speed", "name": "Downstream Speed", "unitOfMeasure": "a second", "valueType": "", "capturePeriod": "30 Minutes", "validFor": { "startDateTime": "2024-05-30 08:49:26", "endDateTime": "2024-05-31 08:49:29" }, "thresholdRule": [ { "id": "a754f960432a02104fefe4511fb8f2d0", "description": "This speed is greater than the target upper", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "15 Minutes", "conformanceTargetLower": "75", "conformanceComparatorLower": "greater than", "consequence": [ { "id": "15a4bd60432a02104fefe4511fb8f2b8", "prescribeAction": "null", "description": "generate a waring report", "name": "degradedQualityOfService", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:51:29", "endDateTime": "2024-08-06 08:51:31" } }, { "id": "e6847d60432a02104fefe4511fb8f2c3", "prescribeAction": "null", "description": "send a warning to the system", "name": "packetdrop", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:50:53", "endDateTime": "2024-08-06 08:50:55" } } ] }, { "id": "cb55b5a0432a02104fefe4511fb8f201", "description": "", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "medium", "tolerancePeriod": "", "conformanceTargetUpper": "120", "conformanceComparatorUpper": "less than", "consequence": [] } ] }, { "id": "8f987524432a02104fefe4511fb8f2f0", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the upstream speed in the service", "metricName": "Upstream Speed", "name": "Upstream Speed", "unitOfMeasure": "a second", "valueType": "", "capturePeriod": "", "validFor": { "startDateTime": "", "endDateTime": "" }, "thresholdRule": [] } ], "specCharacteristic": [ { "name": "restart", "description": "restart", "valueType": "yes_no", "validFor": { "startDatetime": "2024-05-30 08:45:49" }, "characteristicValueSpecification": [ { "value": "No", "validFor": { "startDateTime": "", "endDateTime": "" } }, { "value": "Yes", "validFor": { "startDateTime": "", "endDateTime": "" } } ] } ], "serviceTestSpecRelationship": [ { "id": "76a3b160432a02104fefe4511fb8f2ad", "name": "OAM Test", "relationshipType": "" } ], "relatedServiceSpecification": [ { "id": "aeddcd1fb7d69910ff00f203ae11a990", "name": "Home Internet" } ] } ] ## API ouverte de gestion des tests de service : GET /sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/{id} {#ariaid-title5} Récupère une entité de définition de test de service. ### Format d'URL URL par défaut : /api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/{id} ### Paramètres de demande pris en charge {#servicetestmanagement-GET-id__entry__2} | Nom | Description | |-|-| | id | Requis. Sys_id ou external_id de la définition de test de service à récupérer. Situé dans la table Définition de test de service \[sn_st_mgmt_test_definition\]. Type de données : chaîne | [Tableau 20. Paramètres de chemin d'accès] {#servicetestmanagement-GET-id__entry__6} | Nom | Description | |-|-| | champs | Liste des champs à renvoyer dans la réponse. Les champs non valides sont ignorés. Si ce paramètre n'est pas utilisé, tous les champs sont renvoyés. Situé dans la table Définition de test de service \[sn_st_mgmt_test_definition\]. Valeurs valides : * description * id * nom * relatedServiceSpecification (en anglais seulement) * serviceTestSpecRelationship * specCharacteristic (en anglais seulement) * testMeasureDefinition * valideFor {#servicetestmanagement-GET-id__ul_hss_b3v_bcc} Type de données : chaîne | | État | Filtrez les définitions de test en fonction de l'état actuel du test. Seules les définitions de test dans l'état spécifié sont renvoyées dans la réponse. Valeurs valides : * Archivés * brouillon * publié * retraité Type de données : chaîne | [Tableau 21. Paramètres de requête] {#servicetestmanagement-GET-id__entry__12} | Nom | Description | |-|-| | Aucun | | [Tableau 22. Paramètres de corps de demande (XML ou JSON)] ### 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](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#servicetestmanagement-GET-id__entry__16}{#servicetestmanagement-GET-id__accept-RESTAPI} | 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 23. En-têtes de demandes] {#servicetestmanagement-GET-id__entry__20}{#servicetestmanagement-GET-id__content_type-JSON-only-entry-RESTAPI} | En-tête | Description | |-|-| | Content-Type | Format de données du corps de la demande. Prend uniquement en charge application/json. | [Tableau 24. En-têtes de réponses] ### 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](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#servicetestmanagement-GET-id__entry__24}{#servicetestmanagement-GET-id__entry-200-status-code}{#servicetestmanagement-GET-id__entry-400-status-code}{#servicetestmanagement-GET-id__entry-404-status-code} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. | | 404 | Introuvable. L'élément demandé est introuvable. | [Tableau 25. Codes d'état] ### Paramètres du corps de réponse (JSON ou XML) {#servicetestmanagement-GET-id__entry__32} | Nom | Description | |-|-| | description | Description de la définition de test de service. Type de données : chaîne | | id | Sys_id ou external_id de la définition de test de service. Situé dans la table Définition de test de service \[sn_st_mgmt_test_definition\]. Type de données : chaîne | | nom | Requis. Nom de la définition de test de service. Type de données : chaîne | | relatedServiceSpecification (en anglais seulement) | Requis. Spécifications de service de la définition de test. Type de données : tableau d'objets "relatedServiceSpecification": [ { "id": "String", "name": "String" } ] | | relatedServiceSpecification.id | Sys_id ou external_id de la spécification de service. Situé dans le champ sys_id ou external_id de la table Spécification \[sn_prd_pm_specification\]. Type de données : chaîne | | relatedServiceSpecification.name | Nom de la spécification de service. Type de données : chaîne | | serviceTestSpecRelationship | Définition de test de service connexe. Type de données : tableau d'objets "serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ] | | serviceTestSpecRelationship.id | Sys_id ou external_id de la définition de test du service connexe. Situé dans le champ sys_id ou external_id de la table Définition de test \[sn_st_mgmt_test_definition\]. Type de données : chaîne | | serviceTestSpecRelationship.name | Nom de la définition de test connexe. Type de données : chaîne | | serviceTestSpecRelationship.relationshipType | Type de relation. Valeurs acceptées : * substitution * dépendance * exclusivité {#servicetestmanagement-GET-id__ul_hpg_xtr_dcc} Type de données : chaîne | | specCharacteristic (en anglais seulement) | Caractéristiques de la définition de test. Type de données : tableau d'objets "specCharacteristic": [ { "characteristicValueSpecification": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] | | specCharacteristic.characteristicValueSpecification | Tableau contenant les valeurs possibles de la caractéristique. Type de données : tableau d'objets "characteristicValueSpecification": [ { "value": "String" } ] | | specCharacteristic.characteristicValueSpecification.value | Valeur de la caractéristique. Type de données : chaîne | | specCharacteristic.description | Description de la caractéristique. Type de données : chaîne | | specCharacteristic.name | Nom de la caractéristique. Type de données : chaîne | | specCharacteristic.validFor | Plage de dates pour laquelle la caractéristique est valide. Type de données : objet "validFor": { "endDateTime": "String", "startDateTime": "String" } | | specCharacteristic.validFor.endDateTime | Date de fin de la caractéristique. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | specCharacteristic.validFor.startDateTime | Date de début de la caractéristique. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | specCharacteristic.valueType | Type de valeur caractéristique. * Oui/Non * choix * date * Date/Heure * durée * E-mail * étiquette * Test sur ligne unique {#servicetestmanagement-GET-id__ul_i3m_twr_dcc} Type de données : chaîne | | testMeasureDefinition | Définitions de mesure de test pour cette définition de test de service. Pour plus d'informations, consultez [Define test measure definitions for a service test](https://www.servicenow.com/docs/access?context=define-test-measure-spm&version=xanadu&pubname=xanadu-proactive-service-exp-workflows&ft:locale=en-US). Type de données : tableau d'objets "testMeasureDefinition": [ { "captureFrequency": "String", "captureMethod": "String", "capturePeriod": {Object}, "id": "String", "metricDescription": "String", "metricName": "String", "name": "String", "unitOfMeasure": "String", "thresholdRule": [Array], "validFor": {Object}, "valueType": "String" } ] | | testMeasureDefinition.captureFrequency | Fréquence à laquelle capturer la mesure. Valeurs valides : * aucun * une fois * quotidien * hebdomadaire * mensuel {#servicetestmanagement-GET-id__ul_lsw_jxv_xbc} Type de données : chaîne | | testMeasureDefinition.captureMethod | Méthode utilisée pour capturer la mesure. Valeurs valides : * automatique : capture automatiquement la mesure. * manual : capturez manuellement la mesure. * none : ne capture pas la mesure. {#servicetestmanagement-GET-id__ul_gsw_jxv_xbc} Type de données : chaîne | | testMeasureDefinition.capturePeriod | Période ou durée de la capture de mesure. Type de données : objet "capturePeriod": { "amount": Number, "units": "String" } | | testMeasureDefinition.capturePeriod.amount | Nombre de périodes de capture. Type de données : nombre | | testMeasureDefinition.capturePeriod.units | Unités de la période. Valeurs acceptées : * secondes * minutes * jours * Heures {#servicetestmanagement-GET-id__ul_rn1_3ds_dcc} Type de données : chaîne | | testMeasureDefinition.id | Sys_id ou external_id des définitions de mesure de test. Situé dans la table de définition de mesure de test \[sn_st_mgmt_test_measure_definition\]. Type de données : chaîne | | testMeasureDefinition.metricDescription | Brève description de la mesure. Type de données : chaîne | | testMeasureDefinition.metricName | Nom défini par l'utilisateur d'une mesure dans la mesure de test. Type de données : chaîne | | testMeasureDefinition.name | Nom de la définition de la mesure de test. Type de données : chaîne | | testMeasureDefinition.thresholdRule | Règle qui définit les conditions à remplir avant d'appliquer des conséquences lorsqu'un seuil est franchi (ou non dépassé) dans la définition de la mesure de test. Pour plus d'informations, consultez [Define threshold rules for a test measure definition](https://www.servicenow.com/docs/access?context=define-threshold-rules&version=xanadu&pubname=xanadu-proactive-service-exp-workflows&ft:locale=en-US). Type de données : tableau d'objets { "thresholdRule": { "consequence": Array, "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "consequence": Array, "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": Object } } | | testMeasureDefinition.thresholdRule.conformanceComparatorExact | Marqueur indiquant si une valeur est identique à la valeur définie pour testMeasureDefinition.thresholdRule.conformanceTargetExact. Si la valeur est définie sur vrai, testMeasureDefinition.thresholdRule.conformanceTargetExact est requise. Valeurs valides : * true : la valeur est identique à la valeur de conformanceTargetExact. * false : la valeur n'est pas identique.conformanceTargetExact {#servicetestmanagement-GET-id__ul_bsw_jxv_xbc} Type de données : booléennes Valeur par défaut : false | | testMeasureDefinition.thresholdRule.conformanceComparatorLower | Opérateur qui vérifie si une valeur tombe en dessous du seuil. Valeurs valides : * supérieur à * supérieur ou égal à {#servicetestmanagement-GET-id__ul_zrw_jxv_xbc} Type de données : chaîne | | testMeasureDefinition.thresholdRule.conformanceComparatorUpper | Opérateur qui vérifie si une valeur dépasse le seuil. Valeurs valides : * inférieur à * inférieur ou égal à {#servicetestmanagement-GET-id__ul_wrw_jxv_xbc} Type de données : chaîne | | testMeasureDefinition.thresholdRule.conformanceTargetExact | Obligatoire si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur vrai, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre | | testMeasureDefinition.thresholdRule.conformanceTargetLower | Valeur de seuil inférieure pour comparer les résultats de la mesure de test. Type de données : nombre | | testMeasureDefinition.thresholdRule.conformanceTargetUpper | Valeur de seuil supérieure pour la comparaison des résultats de la mesure de test. Type de données : nombre | | testMeasureDefinition.thresholdRule.consequence | Action (action prescrite ou notification) à prendre lorsqu'une règle de seuil est franchie. Pour plus d'informations, consultez [Define measure consequences for the threshold rules](https://www.servicenow.com/docs/access?context=define-threshold-consequences-spm&version=xanadu&pubname=xanadu-proactive-service-exp-workflows&ft:locale=en-US). Type de données : tableau d'objets "consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ] | | testMeasureDefinition.thresholdRule.consequence.description | Description de la conséquence. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.id | Sys_id ou external_id de la conséquence de la mesure. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.name | Nom de la conséquence. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.prescribeAction | Action définie par l'utilisateur à prendre en cas de violation de seuil. Les actions varient d'une instance à l'autre. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.repeatAction | Marqueur indiquant s'il faut répéter la conséquence appliquée. Valeurs valides : * vrai : répète l'action. * faux : ne répète pas l'action. {#servicetestmanagement-GET-id__ul_srw_jxv_xbc} Type de données : booléennes Valeur par défaut : false | | testMeasureDefinition.thresholdRule.consequence.validFor | Plage de dates pour laquelle la conséquence est valide. Type de données : objet "validFor": { "startDateTime": "String", "endDateTime ": "String" } | | testMeasureDefinition.thresholdRule.consequence.validFor.endDateTime | Date de fin de validité de la conséquence. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.validFor.startDateTime | Date de début de validité de la conséquence. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasureDefinition.thresholdRule.description | Description de la règle de seuil. Type de données : chaîne | | testMeasureDefinition.thresholdRule.id | Sys_id ou external_id des règles de seuil. Situé dans le champ Situé dans le champ sys_id ou external_id de la table Règles de seuil \[sn_st_mgmt_threshold_rule\]. Type de données : chaîne | | testMeasureDefinition.thresholdRule.name | Nom de la règle de seuil. Type de données : chaîne | | testMeasureDefinition.thresholdRule.numberOfAllowedCrossing | Croisements maximaux autorisés pendant la période de tolérance avant l'application des conséquences. Valeur maximale : 40 Type de données : nombre | | testMeasureDefinition.thresholdRule.thresholdRuleSeverity | Niveau de gravité de la règle de seuil. Valeurs valides : * élevé * moyen * faible {#servicetestmanagement-GET-id__ul_orw_jxv_xbc} Type de données : chaîne | | testMeasureDefinition.unitOfMeasure | Valeur mesurable de temps utilisée pour calculer la performance d'un service en jours, minutes et secondes. Type de données : chaîne | | testMeasureDefinition.validFor | Plage de dates pour laquelle la définition de mesure de test est valide. Type de données : chaîne "validFor": { "endDateTime": "String", "startDateTime": "String" } | | testMeasureDefinition.validFor.endDateTime | Date de fin de validité de la définition de la mesure d'essai. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasureDefinition.validFor.startDateTime | Date de début de validité de la définition de la mesure d'essai. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | valideFor | Plage de dates pour laquelle la définition de test est valide. Type de données : objet "validFor": { "endDateTime": "String", "startDateTime": "String" } | | valideFor.endDateTime | Date et heure de la définition de test sur lesquelles l'état de celle-ci est mis hors service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | valideFor.startDateTime | Date et heure de la définition de test sur laquelle son état est publié. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | [ ] ### Demande cURL Cet exemple récupère les détails d'une définition de test de service avec un ID donné. curl --location --request GET "https:/instance.servicenow.com/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/89d2b920432a02104fefe4511fb8f22e" \ --user 'username': 'password' Corps de réponse. { "description": "Upstream and Downstream speed ", "id": "89d2b920432a02104fefe4511fb8f22e", "name": "Speed Test", "validFor": { "startDateTime": "2024-05-31", "endDateTime": "2024-06-27" }, "testMeasureDefinition": [ { "id": "1a04f560432a02104fefe4511fb8f2ad", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the downstream speed in a service", "metricName": "Downstream Speed", "name": "Downstream Speed", "unitOfMeasure": "a second", "valueType": "", "capturePeriod": "30 Minutes", "validFor": { "startDateTime": "2024-05-30 08:49:26", "endDateTime": "2024-05-31 08:49:29" }, "thresholdRule": [ { "id": "a754f960432a02104fefe4511fb8f2d0", "description": "This speed is greater than the target upper", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "15 Minutes", "conformanceTargetLower": "75", "conformanceComparatorLower": "greater than", "consequence": [ { "id": "15a4bd60432a02104fefe4511fb8f2b8", "prescribeAction": "null", "description": "generate a waring report", "name": "degradedQualityOfService", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:51:29", "endDateTime": "2024-08-06 08:51:31" } }, { "id": "e6847d60432a02104fefe4511fb8f2c3", "prescribeAction": "null", "description": "send a warning to the system", "name": "packetdrop", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:50:53", "endDateTime": "2024-08-06 08:50:55" } } ] }, { "id": "cb55b5a0432a02104fefe4511fb8f201", "description": "", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "medium", "tolerancePeriod": "", "conformanceTargetUpper": "120", "conformanceComparatorUpper": "less than", "consequence": [] } ] } ], "specCharacteristic": [ { "name": "restart", "description": "restart", "valueType": "yes_no", "validFor": { "startDatetime": "2024-05-30 08:45:49" }, "characteristicValueSpecification": [ { "value": "No", "validFor": { "startDateTime": "", "endDateTime": "" } }, { "value": "Yes", "validFor": { "startDateTime": "", "endDateTime": "" } } ] } ], "serviceTestSpecRelationship": [ { "id": "76a3b160432a02104fefe4511fb8f2ad", "name": "OAM Test", "relationshipType": "" } ], "relatedServiceSpecification": [ { "id": "aeddcd1fb7d69910ff00f203ae11a990", "name": "Home Internet" } ] } ## API ouverte de gestion des tests de service : PATCH /sn_sprb_mgmt/servicetestmanagement/serviceTest/{id} {#ariaid-title6} Met à jour une entité de test de service. ### Format d'URL URL par défaut : /api/sn_sprb_mgmt/servicetestmanagement/serviceTest/{id} ### Paramètres de demande pris en charge {#servicetestmgmt-PATCH-serviceTestid__entry__2} | Nom | Description | |-|-| | id | Requis. Sys_id ou external_id du test de service à récupérer. Situé dans la table Test de service \[sn_st_mgmt_test\]. Type de données : chaîne | [Tableau 26. Paramètres de chemin d'accès] {#servicetestmgmt-PATCH-serviceTestid__entry__6} | Nom | Description | |-|-| | Aucun | | [Tableau 27. Paramètres de requête] {#servicetestmgmt-PATCH-serviceTestid__entry__10} | Nom | Description | |-|-| | characteristic | Liste décrivant les caractéristiques du test de service associé. Pour plus d'informations sur les caractéristiques des définitions de test, voir Type de données : tableau d'objets "characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ] | | characteristic.id | Sys_id ou external_id de caractéristiques. Situé dans la table Caractéristiques \[sn_prd_pm_characteristic\]. Si external_id est présent pour cet enregistrement, la réponse renvoie le external_id sinon elle renvoie le sys_id. Type de données : chaîne | | characteristic.name | Nom de la caractéristique. Type de données : chaîne | | valeur.caractéristique | Options de la caractéristique associées au test de service. Les caractéristiques varient en fonction de l'instance client. Type de données : chaîne | | type.valeur.caractéristique | Type de valeur caractéristique. * Oui/Non * choix * date * Date/Heure * durée * E-mail * étiquette * Test sur ligne unique {#servicetestmgmt-PATCH-serviceTestid__ul_zfr_twr_dcc} Type de données : chaîne | | description | Description du test de service. Type de données : chaîne | | endDateTime | Date et heure de fin du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | Mode | Mode dans lequel le test de service s'exécute. Valeurs valides : * ONDEMAND : déclenche manuellement le test de service. * PROACTIF : déclenche automatiquement le test de service. {#servicetestmgmt-PATCH-serviceTestid__ul_ybc_mqn_xbc} Par défaut : ONDEMAND | | nom | Requis. Nom du test de service. Type de données : chaîne | | service connexe | Requis. La définition de test associée au test de service. Type de données : objet "relatedService": { "href": "String", "id": "String", "name": "String" } | | relatedService.href | Lien hypertexte renvoyant au service connexe. Type de données : chaîne | | relatedService.id | Sys_id ou external_id de l'inventaire des produits. Situé dans le champ sys_id ou external_id de la table Inventaire des produits \[sn_prd_invt_product_inventory\]. Type de données : chaîne | | startDateTime | Date et heure de début du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | État | État dans lequel se trouve le test de service. Valeurs valides : * confirmé * annulé * terminé * échoué * inProgress * en attente * rejeté {#servicetestmgmt-PATCH-serviceTestid__ul_gym_mqn_xbc} Type de données : chaîne | | testMeasure (en anglais seulement) | Mesure d'un aspect spécifique d'un test de produit, de service ou de ressource, comme les paquets perdus ou l'état de connectivité. Type de données : tableau d'objets "testMeasure": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array], "unitOfMeasure": "String", "value": {Object} } ] | | testMeasure.accuracy | Valeur décimale flottante représentant la précision de la mesure de test capturée pour les mesures associées. Type de données : nombre Valeur maximale : 40 | | testMeasure.captureDateTime | Date et heure de capture de la mesure. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasure.id | Sys_id ou external_id des mesures de test. Situé dans les champs sys_id ou external_id de la table Mesures de test \[sn_st_mgmt_test_measure\]. Type de données : chaîne | | testMeasure.Measure.captureMethod | Méthode utilisée pour capturer la mesure. Valeurs valides : * automatique : capture automatiquement la mesure. * manual : capturez manuellement la mesure. * aucun : ne pas capturer la mesure. {#servicetestmgmt-PATCH-serviceTestid__ul_ed2_gxv_xbc} Type de données : chaîne | | testMeasure.metricDescription | Brève description de la mesure. Type de données : chaîne | | testMeasure.metricName | Nom de la mesure de test. Type de données : chaîne | | testMeasure.ruleViolation | Objet pour la définition d'une règle dans la définition de la règle de seuil, ainsi que les conséquences en cas de violation de la règle. Type de données : tableau d'objets "ruleViolation"[ { appliedConsequence: [Array], conformanceTargetUpper: Number, conformanceComparatorUpper: "String", description: "String", id: "String", name: "String", numberOfAllowedCrossing: Number, thresholdRuleSeverity: "String", tolerancePeriod: "String" } ] | | testMeasure.ruleViolation.tolerancePeriod.amount | Nombre de périodes avant l'application de la conséquence. Type de données : nombre | | testMeasure.ruleViolation.appliedConsequence | Action (action prescrite ou notification) à prendre lorsqu'une règle de seuil est franchie. Type de données : tableau d'objets "appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ] | | testMeasure.ruleViolation.appliedConsequence.appliedAction | Action à exécuter en cas de violation d'une règle de seuil. Par exemple, l'envoi d'un avertissement ou la génération d'un rapport. Les actions appliquées peuvent varier d'une instance à l'autre. Type de données : chaîne | | testMeasure.ruleViolation.appliedSequence.description | Description de la conséquence appliquée. Type de données : chaîne | | testMeasure.ruleViolation.appliedConsequence.id | Sys_id ou external_id de la conséquence appliquée. Type de données : chaîne | | testMeasure.ruleViolation.appliedConsequence.name | Nom de la conséquence appliquée. Type de données : chaîne | | testMeasure.ruleViolation.appliedConsequence.repeatAction | Marqueur indiquant s'il faut répéter la conséquence lorsqu'une deuxième infraction se produit. Valeurs valides : * vrai : répétez l'action. * false : Répétez l'action. {#servicetestmgmt-PATCH-serviceTestid__ul_ld2_gxv_xbc} Type de données : booléennes Valeur par défaut : false | | testMesure.règleViolation.conformitéComporatorExact | Marqueur indiquant si une valeur est identique. Valeurs valides : * true : la valeur est identique. * false : la valeur n'est pas identique. {#servicetestmgmt-PATCH-serviceTestid__ul_od2_gxv_xbc} Type de données : booléennes Valeur par défaut : false | | testMesure.règleViolation.conformitéComporatorInférieur | Opérateur permettant de vérifier si une valeur tombe en dessous du seuil. Valeurs valides : * supérieur à * supérieur ou égal à {#servicetestmgmt-PATCH-serviceTestid__ul_sd2_gxv_xbc} Type de données : chaîne | | testMesure.règleViolation.conformitéComporatorSupérieur | Opérateur permettant de vérifier si une valeur est supérieure au seuil. Valeurs valides : * inférieur à * inférieur ou égal à {#servicetestmgmt-PATCH-serviceTestid__ul_vd2_gxv_xbc} Type de données : chaîne | | testMeasure.ruleViolation.conformanceTargetExact | Obligatoire si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur vrai, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre | | testMeasure.ruleViolation.conformanceTargetLower | Valeur de seuil inférieure pour comparer les résultats de la mesure de test. Détermine si le seuil est atteint ou plus. Type de données : nombre | | testMeasure.ruleViolation.conformanceTargetUpper | Valeur de seuil supérieure pour la comparaison des résultats de la mesure de test. Détermine si le seuil est atteint ou plus. Type de données : nombre | | testMeasure.ruleViolation.description | Description de la règle de seuil. Type de données : chaîne | | testMeasure.ruleViolation.id | Sys_id ou external_id de la violation de la règle de seuil. Situé dans la table Violation de la règle de seuil \[sn_st_mgmt_threshold_rule_violation\]. Type de données : chaîne | | testMeasure.ruleViolation.name | Nom de la règle de seuil. Type de données : chaîne | | testMeasure.ruleViolation.numberOfAllowedCrossing | Croisements maximaux autorisés pendant la période de tolérance avant l'application des conséquences. Type de données : nombre Valeur maximale : 40 | | testMeasure.ruleViolation.thresholdRuleSeverity | Gravité de la règle de seuil. Valeurs valides : * élevé * moyen * faible {#servicetestmgmt-PATCH-serviceTestid__ul_xd2_gxv_xbc} Type de données : chaîne | | testMeasure.ruleViolation.tolerancePeriod | Intervalle de temps spécifié pendant lequel les occurrences de croisement sont activées sans déclencher de conséquences ou d'actions immédiates. Type de date : Objet "tolerancePeriod": { "amount": Number, "units": "String" } | | testMeasure.ruleViolation.tolerancePeriod.units | Unités de la période. Valeurs acceptées : * secondes * minutes * jours * Heures {#servicetestmgmt-PATCH-serviceTestid__ul_qbw_qds_dcc} Type de données : chaîne | | testMeasure.unitOfMeasure | Spécifie l'unité de mesure pour les valeurs cibles de conformité de la mesure d'essai. Type de données : chaîne | | testMeasure.value | Valeur de la mesure de test. Type de données : objet "value": { "id": "String", "name": "String", "valueType": "String", "value": "String } | | testMeasure.value.id | ID de la valeur de la mesure de test. Type de données : chaîne | | testMeasure.value.name | Nom de la valeur de la mesure de test. Type de données : chaîne | | testMeasure.value.value | Valeur de la mesure de test. Type de données : chaîne | | testMeasure.value.valueType | Type de valeur de mesure de test (numérique, texte, etc.). Type de données : chaîne | | testSpecification (Spécification de test) | Requis. La définition de test associée à ce test. Type de données : objet "testSpecification": { "id": "String", "href": "String" } | | testSpecification.href | Lien hypertexte renvoyant à la définition de test de service. Type de données : chaîne | | testSpecification.id | Le sys_id ou le external_id de la définition de test de service. Situé dans le champ sys_id ou external_id de la table Définition de test de service \[sn_st_mgmt_test_definition\]. Type de données : chaîne | | valideFor | Plage de dates pour laquelle le test de service est valide. Type de données : objet "validFor": { "startDateTime": "String", "endDateTime ": "String" } | | valideFor.endDateTime | Date de fin de validité du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | valideFor.startDateTime | Date de début de validité du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | [Tableau 28. Paramètres de corps de demande (XML ou JSON)] ### 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](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#servicetestmgmt-PATCH-serviceTestid__entry__120}{#servicetestmgmt-PATCH-serviceTestid__accept-RESTAPI} | 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 29. En-têtes de demandes] {#servicetestmgmt-PATCH-serviceTestid__entry__124} | En-tête | Description | |-|-| | Aucun | | [Tableau 30. En-têtes de réponses] ### 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](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#servicetestmgmt-PATCH-serviceTestid__entry__128}{#servicetestmgmt-PATCH-serviceTestid__entry-200-status-code}{#servicetestmgmt-PATCH-serviceTestid__entry-400-status-code}{#servicetestmgmt-PATCH-serviceTestid__entry-404-status-code} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. | | 404 | Introuvable. L'élément demandé est introuvable. | [Tableau 31. Codes d'état] ### Paramètres du corps de réponse (JSON ou XML) {#servicetestmgmt-PATCH-serviceTestid__entry__136} | Nom | Description | |-|-| | characteristic | Liste décrivant les caractéristiques du test de service associé. Type de données : tableau d'objets "characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ] | | characteristic.id | Sys_id ou external_id de caractéristiques. Situé dans la table Caractéristiques \[sn_prd_pm_characteristic\]. Si external_id est présent pour cet enregistrement, la réponse renvoie le external_id sinon elle renvoie le sys_id. Type de données : chaîne | | characteristic.name | Nom de la caractéristique. Type de données : chaîne | | valeur.caractéristique | Options de la caractéristique associées au test de service. Les caractéristiques varient en fonction de l'instance client. Type de données : chaîne | | type.valeur.caractéristique | Type de valeur caractéristique. * Oui/Non * choix * date * Date/Heure * durée * E-mail * étiquette * Test sur ligne unique Type de données : chaîne | | description | Description du test de service. Type de données : chaîne | | id | Sys_id ou external_id de la définition de test de service. Situé dans la table Test de service \[sn_st_mgmt_test\]. Type de données : chaîne | | nom | Nom du test de service. Type de données : chaîne | | service connexe | Définition de test associée pour ce test. Type de données : objet "relatedService": { "href": "string", "id": "String", "name": "String" } | | relatedService.id | Sys_id ou external_id de l'inventaire des produits. Situé dans le champ sys_id ou external_id de la table Inventaire des produits \[sn_prd_invt_product_inventory\]. Type de données : chaîne | | relatedService.name | Nom de l'inventaire des produits. Type de données : chaîne | | testMeasure (en anglais seulement) | Mesure d'un aspect spécifique d'un test de produit, de service ou de ressource, comme les paquets perdus ou l'état de connectivité. Type de données : tableau d'objets "testMeasureDefinition": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array] "unitOfMeasure": "String", "value": {Object} } ] | | testMeasure.accuracy | Valeur décimale flottante représentant la précision de la mesure de test capturée pour les mesures associées. Type de données : nombre Valeur maximale : 40 | | testMeasure.captureDateTime | Date et heure de capture de la mesure. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasure.captureMethod | Méthode utilisée pour capturer la mesure. Valeurs valides : * automatique : capture automatiquement la mesure. * manual : capturez manuellement la mesure. * aucun : ne pas capturer la mesure. {#servicetestmgmt-PATCH-serviceTestid__ul_zrs_txv_xbc} Type de données : chaîne | | testMeasure.id | Sys_id ou external_id de la mesure d'essai. Situé dans la table Mesures de test \[sn_st_mgmt_test_measure\]. Type de données : chaîne | | testMeasure.metricDescription | Brève description de la mesure. Type de données : chaîne | | testMeasure.metricName | Nom d'une mesure dans la mesure de test. Type de données : chaîne | | testMeasure.ruleViolation | Objet pour la définition d'une règle dans la définition de la règle de seuil, ainsi que les conséquences en cas de violation de la règle. Type de données : tableau d'objets "RuleViolation": [ { "appliedConsequence": [Array], "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": {Object} } ] | | testMeasure.ruleViolation.appliedConsequence | Action (action prescrite ou notification) à prendre en cas de violation d'une règle de seuil. Type de données : tableau d'objets "appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ] | | testMeasure.ruleViolation.appliedConsequence.appliedAction | Action à exécuter en cas de violation d'une règle de seuil. Par exemple, l'envoi d'un avertissement ou la génération d'un rapport. Les actions appliquées peuvent varier d'une instance à l'autre. Type de données : chaîne | | testMeasure.ruleViolation.appliedConsequence.appliedAction.repeatAction | Marqueur indiquant s'il faut répéter l'action appliquée ou non. Valeurs valides : * vrai : répète l'action. * faux : ne répète pas l'action. {#servicetestmgmt-PATCH-serviceTestid__ul_kss_txv_xbc} Type de données : booléennes Valeur par défaut : false | | testMeasure.ruleViolation.appliedSequence.description | Description de la conséquence appliquée. Type de données : chaîne | | testMeasure.ruleViolation.appliedConsequence.id | Sys_id ou external_id de la conséquence appliquée. Type de données : chaîne | | testMeasure.ruleViolation.appliedConsequence.name | Nom de la conséquence appliquée. Type de données : chaîne | | testMeasure.ruleViolation.conformanceComparatorExact | Marqueur indiquant si une valeur est identique à la valeur de conformanceTargetExact. Valeurs valides : * true : la valeur est identique. * false : la valeur n'est pas identique. {#servicetestmgmt-PATCH-serviceTestid__ul_uss_txv_xbc} Type de données : booléennes Valeur par défaut : false | | testMeasure.ruleViolation.conformanceComparatorLower | Opérateur qui vérifie si une valeur tombe en dessous du seuil. Valeurs valides : * supérieur à * est {#servicetestmgmt-PATCH-serviceTestid__ul_fts_txv_xbc} Type de données : chaîne | | testMeasure.ruleViolation.conformanceComparatorUpper | Opérateur qui vérifie si une valeur dépasse le seuil. Valeurs valides : * est * inférieur à {#servicetestmgmt-PATCH-serviceTestid__ul_mts_txv_xbc} Type de données : chaîne | | testMeasure.ruleViolation.conformanceTargetExact | Obligatoire si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur vrai, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre | | testMeasure.ruleViolation.conformanceTargetLower | Valeur de seuil inférieure pour comparer les résultats de la mesure de test. Détermine si le seuil est atteint ou plus. Type de données : nombre | | testMeasure.ruleViolation.conformanceTargetUpper | Valeur de seuil supérieure pour la comparaison des résultats de la mesure de test. Détermine si le seuil est atteint ou plus. Type de données : nombre | | testMeasure.ruleViolation.description | Description de la violation de la règle de seuil. Type de données : chaîne | | testMeasure.ruleViolation.id | Sys_id ou external_id de la violation de la règle de seuil. Situé dans la table Violation de la règle de seuil \[sn_st_mgmt_threshold_rule_violation\]. Type de données : chaîne | | testMeasure.ruleViolation.numberOfAllowedCrossing | Croisements maximaux autorisés pendant la période de tolérance avant l'application des conséquences. Type de données : nombre Maximum : 40 | | testMeasure.ruleViolation.thresholdRuleSeverity | Gravité de la règle de seuil. Valeurs valides : * élevé * faible * moyen {#servicetestmgmt-PATCH-serviceTestid__ul_tts_txv_xbc} Type de données : chaîne | | testMeasure.ruleViolation.tolerancePeriod | Durée ou intervalle de temps pendant lequel des croisements autorisés peuvent se produire avant qu'une conséquence ne soit déclenchée. Type de date : Objet "tolerancePeriod": { "amount": Number, "units": "String" } | | testMeasure.ruleViolation.tolerancePeriod.amount | Montant de la période en nombre. Type de données : nombre | | testMeasure.ruleViolation.tolerancePeriod.units | Unités de la période. Valeurs acceptées : * secondes * minutes * jours * Heures {#servicetestmgmt-PATCH-serviceTestid__ul_my3_qds_dcc} Type de données : chaîne | | testMeasure.unitOfMeasure | Valeur mesurable de temps utilisée pour calculer la performance d'un service en jours, minutes et secondes. Type de données : chaîne | | testMeasure.value | Valeur de la mesure dans le test. Type de données : objet "value": { "id": "String", "name": "String", "valueType": "String", "value": "String" } | | testMeasure.value.id | ID de la valeur de mesure dans le test. Type de données : chaîne | | testMeasure.value.name | Nom de la valeur de mesure dans le test. Type de données : chaîne | | testMeasure.value.value | Valeur de la mesure dans le test. Type de données : chaîne | | testMeasure.value.valueType | Type de valeur de mesure de test (numérique, texte, etc.). Type de données : chaîne | | testSpecification (Spécification de test) | Définition de test associée pour ce test. Type de données : objet "testSpecification": { "href": "String", "id": "String" } | | testSpecification.href | Lien hypertexte renvoyant à la définition de test de service. Type de données : chaîne | | testSpecification.id | Sys_id ou external_id de la définition de test de service. Situé dans le champ sys_id ou external_id de la table Définition de test de service \[sn_st_mgmt_test_definition\]. Type de données : chaîne | | valideFor | Plage de dates pour laquelle le test de service est valide. Type de données : objet "validFor": { "startDateTime": "String", "endDateTime": "String" } | | valideFor.endDateTime | Date de fin et horodatage du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | valideFor.startDateTime | Date et horodatage de début du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | [ ] ### Demande cURL L'exemple suivant met à jour l'entité de test du service donné en fonction des détails fournis dans le corps de la demande. curl "http://instance.servicenow.com/api/sn_sprb_mgmt/servicetestmanagement/serviceTest/2b406ec043b202104fefe4511fb8f211" \ --request PATCH \ --header "Accept:application/json" \ --user 'username':'password' --data { "description": "Service test description", "endDateTime": "2025-01-31 15:05:43", "mode": "proactive", "name": "Speed Test TR0001002", "startDateTime": "2024-06-05 09:07:10", "validFor": { "startDateTime": "", "endDateTime": "" }, "relatedService": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "name": "Internet_VPLS_PI0000011" }, "testSpecification": { "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/76a3b160432a02104fefe4511fb8f2ad", "id": "76a3b160432a02104fefe4511fb8f2ad" }, "characteristic": [ { "id": "e7ef960443f202104fefe4511fb8f224", "name": "AccessRequired", "valueType": "yes_no", "value": "No" } ], "testMeasure": [ { "id": "61d1382e3be28210d140068aa4e45a2e", "accuracy": "0.0001", "captureDateTime": "", "captureMethod": "automatic", "metricDescription": "", "metricName": "Flow speed", "unitOfMeasure": "A second", "value": "3000", "ruleViolation": [ { "id": "61d1382e3be28210d140068aa4e45a2f", "description": "This speed is greater than the target", "name": "tooMuchTraffic", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "", "conformanceTargetLower": "2500", "conformanceComparatorLower": "greater than", "appliedConsequence": [ { "id": "65d1382e3be28210d140068aa4e45a31", "appliedAction": "sendWarning", "description": "send a warning to the system", "name": "sendWarning", "repeatAction": "0" } ] } ] } ] } La réponse montre une mise à jour réussie en renvoyant les informations modifiées dans le service de test donné. { "description": "Service test description", "endDateTime": "2025-01-31 15:05:43", "mode": "proactive", "name": "Speed Test TR0001002", "startDateTime": "2024-06-05 09:07:10", "validFor": { "startDateTime": "", "endDateTime": "" }, "relatedService": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "name": "Internet_VPLS_PI0000011" }, "testSpecification": { "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/76a3b160432a02104fefe4511fb8f2ad", "id": "76a3b160432a02104fefe4511fb8f2ad" }, "characteristic": [ { "id": "e7ef960443f202104fefe4511fb8f224", "name": "AccessRequired", "valueType": "yes_no", "value": "yes" } ], "testMeasure": [ { "id": "61d1382e3be28210d140068aa4e45a2e", "accuracy": "0.0001", "captureDateTime": "", "captureMethod": "automatic", "metricDescription": "", "metricName": "Flow speed", "unitOfMeasure": "A second", "value": "3000", "ruleViolation": [ { "id": "61d1382e3be28210d140068aa4e45a2f", "description": "This speed is greater than the target", "name": "tooMuchTraffic", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "", "conformanceTargetLower": "2500", "conformanceComparatorLower": "greater than", "appliedConsequence": [ { "id": "65d1382e3be28210d140068aa4e45a31", "appliedAction": "sendWarning", "description": "send a warning to the system", "name": "sendWarning", "repeatAction": "0" } ] } ] } ] } ## API ouverte de gestion des tests de service : PATCH /sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/{id} {#ariaid-title7} Autorise les mises à jour partielles d'une entité de définition de test de service. ### Format d'URL URL par défaut : /api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/{id} ### Paramètres de demande pris en charge {#servicetestmgmt-PATCH-servTestSp-id__entry__2} | Nom | Description | |-|-| | id | Requis. Sys_id ou external_id de la définition de test de service à récupérer. Situé dans la table Définition de test de service \[sn_st_mgmt_test_definition\]. Type de données : chaîne | [Tableau 32. Paramètres de chemin d'accès] {#servicetestmgmt-PATCH-servTestSp-id__entry__6} | Nom | Description | |-|-| | Aucun | | [Tableau 33. Paramètres de requête] {#servicetestmgmt-PATCH-servTestSp-id__entry__10} | Nom | Description | |-|-| | description | Description de la définition de test de service. Type de données : chaîne | | nom | Requis. Nom de la définition de test de service. Type de données : chaîne | | relatedServiceSpecification (en anglais seulement) | Requis. Spécifications de service de la définition de test. Type de données : tableau d'objets "relatedServiceSpecification": [ { "id": "String", "name": "String" } ] | | relatedServiceSpecification.id | Sys_id ou external_id de la spécification de service. Situé dans le champ sys_id ou external_id de la table Spécification \[sn_prd_pm_specification\]. Type de données : chaîne | | relatedServiceSpecification.name | Nom de la spécification de service. Type de données : chaîne | | serviceTestSpecRelationship | Définition de test de service connexe. Type de données : tableau d'objets "serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ] | | serviceTestSpecRelationship.id | Sys_id ou external_id de la définition de test du service connexe. Situé dans le champ sys_id ou external_id de la table Définition de test \[sn_st_mgmt_test_definition\]. Type de données : chaîne | | serviceTestSpecRelationship.name | Nom de la définition de test connexe. Type de données : chaîne | | serviceTestSpecRelationship.relationshipType | Type de relation. Valeurs acceptées : * substitution * dépendance * exclusivité {#servicetestmgmt-PATCH-servTestSp-id__ul_hpg_xtr_dcc} Type de données : chaîne | | specCharacteristic (en anglais seulement) | Caractéristiques de la définition de test. Type de données : tableau d'objets "specCharacteristic": [ { "characteristicValueSpecification": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] | | specCharacteristic.characteristicValueSpecification | Tableau contenant les valeurs possibles de la caractéristique. Type de données : tableau d'objets "characteristicValueSpecification": [ { "value": "String" } ] | | specCharacteristic.characteristicValueSpecification.value | Valeur de la caractéristique. Type de données : chaîne | | specCharacteristic.description | Description de la caractéristique. Type de données : chaîne | | specCharacteristic.name | Nom de la caractéristique. Type de données : chaîne | | specCharacteristic.validFor | Plage de dates pour laquelle la caractéristique est valide. Type de données : objet "validFor": { "endDateTime": "String", "startDateTime": "String" } | | specCharacteristic.validFor.endDateTime | Date de fin de la caractéristique. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | specCharacteristic.validFor.startDateTime | Date de début de la caractéristique. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | specCharacteristic.valueType | Type de valeur caractéristique. * Oui/Non * choix * date * Date/Heure * durée * E-mail * étiquette * Test sur ligne unique {#servicetestmgmt-PATCH-servTestSp-id__ul_i3m_twr_dcc} Type de données : chaîne | | testMeasureDefinition | Définitions de mesure de test pour cette définition de test de service. Pour plus d'informations, consultez [Define test measure definitions for a service test](https://www.servicenow.com/docs/access?context=define-test-measure-spm&version=xanadu&pubname=xanadu-proactive-service-exp-workflows&ft:locale=en-US). Type de données : tableau d'objets "testMeasureDefinition": [ { "captureFrequency": "String", "captureMethod": "String", "capturePeriod": {Object}, "id": "String", "metricDescription": "String", "metricName": "String", "name": "String", "unitOfMeasure": "String", "thresholdRule": [Array], "validFor": {Object}, "valueType": "String" } ] | | testMeasureDefinition.captureFrequency | Fréquence à laquelle capturer la mesure. Valeurs valides : * aucun * une fois * quotidien * hebdomadaire * mensuel {#servicetestmgmt-PATCH-servTestSp-id__ul_lsw_jxv_xbc} Type de données : chaîne | | testMeasureDefinition.captureMethod | Méthode utilisée pour capturer la mesure. Valeurs valides : * automatique : capture automatiquement la mesure. * manual : capturez manuellement la mesure. * none : ne capture pas la mesure. {#servicetestmgmt-PATCH-servTestSp-id__ul_gsw_jxv_xbc} Type de données : chaîne | | testMeasureDefinition.capturePeriod | Période ou durée de la capture de mesure. Type de données : objet "capturePeriod": { "amount": Number, "units": "String" } | | testMeasureDefinition.capturePeriod.amount | Nombre de périodes de capture. Type de données : nombre | | testMeasureDefinition.capturePeriod.units | Unités de la période. Valeurs acceptées : * secondes * minutes * jours * Heures {#servicetestmgmt-PATCH-servTestSp-id__ul_rn1_3ds_dcc} Type de données : chaîne | | testMeasureDefinition.id | Sys_id ou external_id des définitions de mesure de test. Situé dans la table de définition de mesure de test \[sn_st_mgmt_test_measure_definition\]. Type de données : chaîne | | testMeasureDefinition.metricDescription | Brève description de la mesure. Type de données : chaîne | | testMeasureDefinition.metricName | Nom défini par l'utilisateur d'une mesure dans la mesure de test. Type de données : chaîne | | testMeasureDefinition.name | Nom de la définition de la mesure de test. Type de données : chaîne | | testMeasureDefinition.thresholdRule | Règle qui définit les conditions à remplir avant d'appliquer des conséquences lorsqu'un seuil est franchi (ou non dépassé) dans la définition de la mesure de test. Pour plus d'informations, consultez [Define threshold rules for a test measure definition](https://www.servicenow.com/docs/access?context=define-threshold-rules&version=xanadu&pubname=xanadu-proactive-service-exp-workflows&ft:locale=en-US). Type de données : tableau d'objets { "thresholdRule": { "consequence": Array, "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "consequence": Array, "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": Object } } | | testMeasureDefinition.thresholdRule.conformanceComparatorExact | Marqueur indiquant si une valeur est identique à la valeur définie pour testMeasureDefinition.thresholdRule.conformanceTargetExact. Si la valeur est définie sur vrai, testMeasureDefinition.thresholdRule.conformanceTargetExact est requise. Valeurs valides : * true : la valeur est identique à la valeur de conformanceTargetExact. * false : la valeur n'est pas identique.conformanceTargetExact {#servicetestmgmt-PATCH-servTestSp-id__ul_bsw_jxv_xbc} Type de données : booléennes Valeur par défaut : false | | testMeasureDefinition.thresholdRule.conformanceComparatorLower | Opérateur qui vérifie si une valeur tombe en dessous du seuil. Valeurs valides : * supérieur à * supérieur ou égal à {#servicetestmgmt-PATCH-servTestSp-id__ul_zrw_jxv_xbc} Type de données : chaîne | | testMeasureDefinition.thresholdRule.conformanceComparatorUpper | Opérateur qui vérifie si une valeur dépasse le seuil. Valeurs valides : * inférieur à * inférieur ou égal à {#servicetestmgmt-PATCH-servTestSp-id__ul_wrw_jxv_xbc} Type de données : chaîne | | testMeasureDefinition.thresholdRule.conformanceTargetExact | Obligatoire si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur vrai, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre | | testMeasureDefinition.thresholdRule.conformanceTargetLower | Valeur de seuil inférieure pour comparer les résultats de la mesure de test. Type de données : nombre | | testMeasureDefinition.thresholdRule.conformanceTargetUpper | Valeur de seuil supérieure pour la comparaison des résultats de la mesure de test. Type de données : nombre | | testMeasureDefinition.thresholdRule.consequence | Action (action prescrite ou notification) à prendre lorsqu'une règle de seuil est franchie. Pour plus d'informations, consultez [Define measure consequences for the threshold rules](https://www.servicenow.com/docs/access?context=define-threshold-consequences-spm&version=xanadu&pubname=xanadu-proactive-service-exp-workflows&ft:locale=en-US). Type de données : tableau d'objets "consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ] | | testMeasureDefinition.thresholdRule.consequence.description | Description de la conséquence. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.id | Sys_id ou external_id de la conséquence de la mesure. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.name | Nom de la conséquence. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.prescribeAction | Action définie par l'utilisateur à prendre en cas de violation de seuil. Les actions varient d'une instance à l'autre. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.repeatAction | Marqueur indiquant s'il faut répéter la conséquence appliquée. Valeurs valides : * vrai : répète l'action. * faux : ne répète pas l'action. {#servicetestmgmt-PATCH-servTestSp-id__ul_srw_jxv_xbc} Type de données : booléennes Valeur par défaut : false | | testMeasureDefinition.thresholdRule.consequence.validFor | Plage de dates pour laquelle la conséquence est valide. Type de données : objet "validFor": { "startDateTime": "String", "endDateTime ": "String" } | | testMeasureDefinition.thresholdRule.consequence.validFor.endDateTime | Date de fin de validité de la conséquence. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.validFor.startDateTime | Date de début de validité de la conséquence. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasureDefinition.thresholdRule.description | Description de la règle de seuil. Type de données : chaîne | | testMeasureDefinition.thresholdRule.id | Sys_id ou external_id des règles de seuil. Situé dans le champ Situé dans le champ sys_id ou external_id de la table Règles de seuil \[sn_st_mgmt_threshold_rule\]. Type de données : chaîne | | testMeasureDefinition.thresholdRule.name | Nom de la règle de seuil. Type de données : chaîne | | testMeasureDefinition.thresholdRule.numberOfAllowedCrossing | Croisements maximaux autorisés pendant la période de tolérance avant l'application des conséquences. Valeur maximale : 40 Type de données : nombre | | testMeasureDefinition.thresholdRule.thresholdRuleSeverity | Niveau de gravité de la règle de seuil. Valeurs valides : * élevé * moyen * faible {#servicetestmgmt-PATCH-servTestSp-id__ul_orw_jxv_xbc} Type de données : chaîne | | testMeasureDefinition.unitOfMeasure | Valeur mesurable de temps utilisée pour calculer la performance d'un service en jours, minutes et secondes. Type de données : chaîne | | testMeasureDefinition.validFor | Plage de dates pour laquelle la définition de mesure de test est valide. Type de données : chaîne "validFor": { "endDateTime": "String", "startDateTime": "String" } | | testMeasureDefinition.validFor.endDateTime | Date de fin de validité de la définition de la mesure d'essai. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasureDefinition.validFor.startDateTime | Date de début de validité de la définition de la mesure d'essai. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | [Tableau 34. Paramètres de corps de demande (XML ou JSON)] ### 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](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#servicetestmgmt-PATCH-servTestSp-id__entry__118}{#servicetestmgmt-PATCH-servTestSp-id__accept-RESTAPI}{#servicetestmgmt-PATCH-servTestSp-id__content_type-JSON-only-entry-RESTAPI} | 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 | | Content-Type | Format de données du corps de la demande. Prend uniquement en charge application/json. | [Tableau 35. En-têtes de demandes] {#servicetestmgmt-PATCH-servTestSp-id__entry__124} | En-tête | Description | |-|-| | Type de contenu | Format de données du corps de la réponse. Prend uniquement en charge application/json. | [Tableau 36. En-têtes de réponses] ### 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](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#servicetestmgmt-PATCH-servTestSp-id__entry__128}{#servicetestmgmt-PATCH-servTestSp-id__entry-200-status-code}{#servicetestmgmt-PATCH-servTestSp-id__entry-400-status-code}{#servicetestmgmt-PATCH-servTestSp-id__entry-404-status-code} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. | | 404 | Introuvable. L'élément demandé est introuvable. | [Tableau 37. Codes d'état] ### Paramètres du corps de réponse (JSON ou XML) {#servicetestmgmt-PATCH-servTestSp-id__section_h1m_wz4_qbc} {#servicetestmgmt-PATCH-servTestSp-id__table_i1m_wz4_qbc__entry__2} | Nom | Description | |-|-| | description | Description de la définition de test de service. Type de données : chaîne | | id | Le sys_id ou le external_id de la définition de test de service. Situé dans la table Test de service \[sn_st_mgmt_test\]. Type de données : chaîne | | nom | Nom de la définition de test de service. Type de données : chaîne | | relatedServiceSpecification (en anglais seulement) | Spécifications de service pour les définitions de test. Type de données : tableau d'objets "relatedServiceSpecification": [ { "id": "String", "name": "String" } ] | | relatedServiceSpecification.id | Le sys_id ou le external_id de la spécification de service. Situé dans le champ sys_id ou external_id de la table Spécification \[sn_prd_pm_specification\]. Type de données : chaîne | | relatedServiceSpecification.name | Nom de la spécification de service. Type de données : chaîne | | serviceTestSpecRelationship | Définition de test de service connexe. Type de données : tableau d'objets "serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ] | | serviceTestSpecRelationship.id | Sys_id ou external_id de la définition de test du service connexe. Situé dans le champ sys_id ou external_id de la table Définition de test \[sn_st_mgmt_test_definition\]. Type de données : chaîne | | serviceTestSpecRelationship.name | Nom de la définition de test connexe. Type de données : chaîne | | serviceTestSpecRelationship.relationshipType | Type de relation. Valeurs acceptées : * substitution * dépendance * exclusivité {#servicetestmgmt-PATCH-servTestSp-id__d2981e2369} Type de données : chaîne | | specCharacteristic (en anglais seulement) | Caractéristiques de la définition de test. Type de données : tableau d'objets "specCharacteristic": [ { "characteristicValueSpecification": Array, "description": "String", "name": "String", "validFor": Object, "valueType": "String" } ] | | specCharacteristic.characteristicValueSpecification | Tableau contenant les valeurs possibles de la caractéristique. Type de données : tableau d'objets "characteristicValueSpecification": [ { "value": "String" } ] | | specCharacteristic.characteristicValueSpecification.value | Valeur de la caractéristique. Type de données : chaîne | | specCharacteristic.description | Description de la caractéristique. Type de données : chaîne | | specCharacteristic.name | Nom de la caractéristique. Type de données : chaîne | | specCharacteristic.validFor | Plage de dates pour laquelle la caractéristique est valide. Type de données : objet "validFor": { "endDateTime": "String", "startDateTime": "String" } | | specCharacteristic.validFor.endDateTime | Date de fin de la caractéristique. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | specCharacteristic.validFor.startDateTime | Date de début de la caractéristique. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | specCharacteristic.valueType | Type de valeur caractéristique. * Oui/Non * choix * date * Date/Heure * durée * E-mail * étiquette * Test sur ligne unique {#servicetestmgmt-PATCH-servTestSp-id__ul_uwb_5wr_dcc} Type de données : chaîne | | testMeasureDefinition | Définitions de mesure de test pour cette définition de test de service. Pour plus d'informations, consultez [Define test measure definitions for a service test](https://www.servicenow.com/docs/access?context=define-test-measure-spm&version=xanadu&pubname=xanadu-proactive-service-exp-workflows&ft:locale=en-US). Type de données : tableau d'objets "testMeasureDefinition": [ { "captureFrequency": "String", "captureMethod": "String", "capturePeriod": {Object}, "id": "String", "metricDescription": "String", "metricName": "String", "name": "String", "unitOfMeasure": "String", "thresholdRule": [Array], "validFor": {Object}, "valueType": "String" } ] | | testMeasureDefinition.captureFrequency | Fréquence à laquelle capturer la mesure. Valeurs valides : * quotidien * mensuel * aucun * une fois * hebdomadaire {#servicetestmgmt-PATCH-servTestSp-id__ul_od2_sxv_xbc} Type de données : chaîne | | testMeasureDefinition.captureMethod | Méthode utilisée pour capturer la mesure. Valeurs valides : * manual : capturez manuellement la mesure. * automatique : capture automatiquement la mesure. * aucun : ne pas capturer la mesure. {#servicetestmgmt-PATCH-servTestSp-id__ul_rd2_sxv_xbc} Type de données : chaîne | | testMeasureDefinition.capturePeriod | Une durée ou une période de la capture. Type de données : objet "capturePeriod": { "amount": Number, "units": "String" } | | testMeasureDefinition.capturePeriod.amount | Nombre de périodes de capture. Type de données : nombre | | testMeasureDefinition.capturePeriod.units | Unités de la période. Valeurs acceptées : * secondes * minutes * jours * Heures {#servicetestmgmt-PATCH-servTestSp-id__ul_lfv_dds_dcc} Type de données : chaîne | | testMeasureDefinition.id | Sys_id ou external_id des définitions de la mesure de test. Situé dans la table de définition de mesure de test \[sn_st_mgmt_test_measure_definition\]. Type de données : chaîne | | testMeasureDefinition.metricDescription | Brève description de la mesure. Type de données : chaîne | | testMeasureDefinition.metricName | Nom défini par l'utilisateur d'une mesure dans la mesure de test. Type de données : chaîne | | testMeasureDefinition.name | Nom de la définition de la mesure de test. Type de données : chaîne | | testMeasureDefinition.thresholdRule | Règle qui définit la condition (raise ou clear) à atteindre pour appliquer les conséquences lorsqu'un seuil est franchi ou cesse d'être franchi pour une définition de mesure de test particulière. Type de données : tableau d'objets { "thresholdRule": { "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "consequence": Array, "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": Object } } | | testMeasureDefinition.thresholdRule.conformanceComparatorExact | Marqueur indiquant si une valeur est identique à la valeur de conformanceTargetExact. Valeurs valides : * true : la valeur est identique à la valeur de conformanceTargetExact. * false : la valeur n'est pas identique.conformanceTargetExact {#servicetestmgmt-PATCH-servTestSp-id__ul_gyl_vqr_dcc} Type de données : booléennes Valeur par défaut : false | | testMeasureDefinition.thresholdRule.conformanceComparatorLower | Opérateur qui vérifie si une valeur tombe en dessous du seuil. Valeurs valides : * supérieur à * est {#servicetestmgmt-PATCH-servTestSp-id__ul_b22_sxv_xbc} Type de données : chaîne | | testMeasureDefinition.thresholdRule.conformanceComparatorUpper | Opérateur qui vérifie si une valeur dépasse le seuil. Valeurs valides : * inférieur à * est {#servicetestmgmt-PATCH-servTestSp-id__ul_e22_sxv_xbc} Type de données : chaîne | | testMeasureDefinition.thresholdRule.conformanceTargetExact | Obligatoire si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur vrai, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre | | testMeasureDefinition.thresholdRule.conformanceTargetLower | Valeur de seuil inférieure pour comparer les résultats de la mesure de test. Type de données : nombre | | testMeasureDefinition.thresholdRule.conformanceTargetUpper | Valeur de seuil supérieure pour la comparaison des résultats de la mesure de test. Type de données : nombre | | testMeasureDefinition.thresholdRule.consequence | Action (action prescrite ou notification) à prendre lorsqu'une règle de seuil est franchie. Type de données : tableau d'objets "consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ] | | testMeasureDefinition.thresholdRule.consequence.description | Description de la conséquence. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.id | Sys_id ou external_id de la conséquence de la mesure. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.name | Nom de la conséquence. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.prescribeAction | Action définie par l'utilisateur à prendre en cas de violation de seuil. Les actions varient d'une instance à l'autre. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.repeatAction | Marqueur indiquant s'il faut répéter l'action appliquée ou non. Valeurs valides : * vrai : répète l'action. * faux : ne répète pas l'action. {#servicetestmgmt-PATCH-servTestSp-id__ul_rjm_pxy_rbc} Type de données : booléennes Valeur par défaut : false | | testMeasureDefinition.thresholdRule.consequence.validFor | Plage de dates pour laquelle la conséquence est valide. Type de données : objet "validFor": { "startDateTime": "String", "endDateTime ": "String" } | | testMeasureDefinition.thresholdRule.consequence.validFor.endDateTime | Date de fin de validité de la conséquence. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.validFor.startDateTime | Date de début de validité de la conséquence. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasureDefinition.thresholdRule.description | Description de la règle de seuil. Type de données : chaîne | | testMeasureDefinition.thresholdRule.id | Sys_id ou external_id des règles de seuil. Situé dans la table Règles de seuil \[sn_st_mgmt_threshold_rule\]. Type de données : chaîne | | testMeasureDefinition.thresholdRule.name | Nom de la règle de seuil. Type de données : chaîne | | testMeasureDefinition.thresholdRule.numberOfAllowedCrossing | Croisements maximaux autorisés pendant la période de tolérance avant l'application des conséquences. Type de données : nombre Valeur maximale : 40 | | testMeasureDefinition.thresholdRule.thresholdRuleSeverity | Gravité de la règle de seuil. Valeurs valides : * élevé * faible * moyen {#servicetestmgmt-PATCH-servTestSp-id__ul_j22_sxv_xbc} Type de données : chaîne | | testMeasureDefinition.unitOfMeasure | Valeur mesurable de temps utilisée pour calculer la performance d'un service en jours, minutes et secondes. Type de données : chaîne | | testMeasureDefinition.validFor | Plage de dates pour laquelle la définition de la mesure de test est valide. Type de données : objet "validFor": { "startDateTime": "String", "endDateTime": "String" } | | testMeasureDefinition.validFor.endDateTime | Date de fin de validité de la définition de la mesure d'essai. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasureDefinition.validFor.startDateTime | Date de début de validité de la définition de la mesure d'essai. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | [ ] {#servicetestmgmt-PATCH-servTestSp-id__table_i1m_wz4_qbc} ### Demande cURL L'exemple suivant met à jour partiellement l'ID de définition de test de service donné en fonction des modifications fournies dans le corps de la demande. curl "http://instance.servicenow.com/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/89d2b920432a02104fefe4511fb8f22e " --request PATCH --header "Accept:application/json" --user 'username':'password' --data { "description": "Upstream and Downstream speed ", "name": "This is my new Speed Test", "testMeasureDefinition": [ { "id": "1a04f560432a02104fefe4511fb8f2ad", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the downstream speed in a service", "metricName": "Downstream Speed", "name": "Downstream Speed", "unitOfMeasure": "a second", "valueType": "", "capturePeriod": "30 Minutes", "validFor": { "startDateTime": "2024-05-30 08:49:26", "endDateTime": "2024-05-31 08:49:29" }, "thresholdRule": [ { "id": "a754f960432a02104fefe4511fb8f2d0", "description": "This speed is greater than the target upper", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "15 Minutes", "conformanceTargetLower": "75", "conformanceComparatorLower": "greater than", "consequence": [ { "id": "15a4bd60432a02104fefe4511fb8f2b8", "prescribeAction": "null", "description": "generate a waring report", "name": "degradedQualityOfService", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:51:29", "endDateTime": "2024-08-06 08:51:31" } }, { "id": "e6847d60432a02104fefe4511fb8f2c3", "prescribeAction": "null", "description": "send a warning to the system", "name": "packetdrop", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:50:53", "endDateTime": "2024-08-06 08:50:55" } } ] }, { "id": "cb55b5a0432a02104fefe4511fb8f201", "description": "", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "medium", "tolerancePeriod": "", "conformanceTargetUpper": "120", "conformanceComparatorUpper": "less than", "consequence": [] } ] }, { "id": "8f987524432a02104fefe4511fb8f2f0", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the upstream speed in the service", "metricName": "Upstream Speed", "name": "Upstream Speed", "unitOfMeasure": "a second", "valueType": "", "capturePeriod": "", "validFor": { "startDateTime": "", "endDateTime": "" }, "thresholdRule": [] } ], "specCharacteristic": [ { "name": "restart", "description": "restart", "valueType": "yes_no", "validFor": { "startDatetime": "2024-05-30 08:45:49" } } ], "serviceTestSpecRelationship": [ { "id": "76a3b160432a02104fefe4511fb8f2ad", "name": "OAM Test", "relationshipType": "" } ], "relatedServiceSpecification": [ { "id": "aeddcd1fb7d69910ff00f203ae11a990", "name": "Home Internet" } ] } Le corps de la réponse renvoie la partie mise à jour de la spécification de test de service : { "description": "Upstream and Downstream speed ", "name": "This is my new Speed Test", "testMeasureDefinition": [ { "id": "1a04f560432a02104fefe4511fb8f2ad", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the downstream speed in a service", "metricName": "Downstream Speed", "name": "Downstream Speed", "unitOfMeasure": "a second", "valueType": "", "capturePeriod": "30 Minutes", "validFor": { "startDateTime": "2024-05-30 08:49:26", "endDateTime": "2024-05-31 08:49:29" }, "thresholdRule": [ { "id": "a754f960432a02104fefe4511fb8f2d0", "description": "This speed is greater than the target upper", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "15 Minutes", "conformanceTargetLower": "75", "conformanceComparatorLower": "greater than", "consequence": [ { "id": "15a4bd60432a02104fefe4511fb8f2b8", "prescribeAction": "null", "description": "generate a waring report", "name": "degradedQualityOfService", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:51:29", "endDateTime": "2024-08-06 08:51:31" } }, { "id": "e6847d60432a02104fefe4511fb8f2c3", "prescribeAction": "null", "description": "send a warning to the system", "name": "packetdrop", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:50:53", "endDateTime": "2024-08-06 08:50:55" } } ] }, { "id": "cb55b5a0432a02104fefe4511fb8f201", "description": "", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "medium", "tolerancePeriod": "", "conformanceTargetUpper": "120", "conformanceComparatorUpper": "less than", "consequence": [] } ] }, { "id": "8f987524432a02104fefe4511fb8f2f0", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the upstream speed in the service", "metricName": "Upstream Speed", "name": "Upstream Speed", "unitOfMeasure": "a second", "valueType": "", "capturePeriod": "", "validFor": { "startDateTime": "", "endDateTime": "" }, "thresholdRule": [] } ], "specCharacteristic": [ { "name": "restart", "description": "restart", "valueType": "yes_no", "validFor": { "startDatetime": "2024-05-30 08:45:49" } } ], "serviceTestSpecRelationship": [ { "id": "76a3b160432a02104fefe4511fb8f2ad", "name": "OAM Test", "relationshipType": "" } ], "relatedServiceSpecification": [ { "id": "aeddcd1fb7d69910ff00f203ae11a990", "name": "Home Internet" } ] } ## API ouverte de gestion des tests de service : POST /sn_sprb_mgmt/servicetestmanagement/serviceTest {#ariaid-title8} Crée un test de service. ### Format d'URL URL par défaut : /api/sn_sprb_mgmt/servicetestmanagement/serviceTest ### Paramètres de demande pris en charge {#servicetestmgmt-POST-serviceTest__entry__2} | Nom | Description | |-|-| | Aucun | | [Tableau 38. Paramètres de chemin d'accès] {#servicetestmgmt-POST-serviceTest__entry__6} | Nom | Description | |-|-| | Aucun | | [Tableau 39. Paramètres de requête] {#servicetestmgmt-POST-serviceTest__id_q31_zd1_qbc__entry__2}{#servicetestmgmt-POST-serviceTest__serviceTest-request-characteristic}{#servicetestmgmt-POST-serviceTest__serviceTest-request-characteristic.id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-characteristic.name}{#servicetestmgmt-POST-serviceTest__serviceTest-request-characteristic.value}{#servicetestmgmt-POST-serviceTest__serviceTest-request-characteristic.valueType}{#servicetestmgmt-POST-serviceTest__serviceTest-request-description}{#servicetestmgmt-POST-serviceTest__serviceTest-request-endDateTime}{#servicetestmgmt-POST-serviceTest__serviceTest-request-id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-mode}{#servicetestmgmt-POST-serviceTest__serviceTest-request-name}{#servicetestmgmt-POST-serviceTest__serviceTest-request-relatedService}{#servicetestmgmt-POST-serviceTest__serviceTest-request-relatedService.href}{#servicetestmgmt-POST-serviceTest__serviceTest-request-relatedService.id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-relatedService.name}{#servicetestmgmt-POST-serviceTest__serviceTest-request-startDateTime}{#servicetestmgmt-POST-serviceTest__serviceTest-request-state}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.accuracy}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.captureDateTime}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.captureMethod}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.metricDescription}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.metricName}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.appliedConsequence}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.appliedConsequence.appliedAction}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.appliedConsequence.description}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.appliedConsequence.id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.appliedConsequence.name}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.appliedConsequence.repeatAction}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.conformanceComporatorExact}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.conformanceComporatorLower}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.conformanceComporatorUpper}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.conformanceTargetExact}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.conformanceTargetLower}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.conformanceTargetUpper}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.description}{#servicetestmgmt-POST-serviceTest__serviceTest-request-test.Measure.ruleViolation.id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.name}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.numberOfAllowedCrossing}{#servicetestmgmt-POST-serviceTest__serviceTest-request-estMeasure.ruleViolation.thresholdRuleSeverity}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.tolerancePeriod}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.amount}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.ruleViolation.tolerancePeriod.units}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.unitOfMeasure}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.value}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.value.id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.value.name}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.value.value}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testMeasure.value.valueType}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testSpecification}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testSpecification.href}{#servicetestmgmt-POST-serviceTest__serviceTest-request-testSpecification.id}{#servicetestmgmt-POST-serviceTest__serviceTest-request-validFor}{#servicetestmgmt-POST-serviceTest__serviceTest-request-validFor.endDateTime}{#servicetestmgmt-POST-serviceTest__serviceTest-request-validFor.startDateTime} | Nom | Description | |-|-| | characteristic | Liste décrivant les caractéristiques du test de service associé. Pour plus d'informations sur les caractéristiques des définitions de test, voir Type de données : tableau d'objets "characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ] | | characteristic.id | Sys_id ou external_id de caractéristiques. Situé dans la table Caractéristiques \[sn_prd_pm_characteristic\]. Si external_id est présent pour cet enregistrement, la réponse renvoie le external_id sinon elle renvoie le sys_id. Type de données : chaîne | | characteristic.name | Nom de la caractéristique. Type de données : chaîne | | valeur.caractéristique | Options de la caractéristique associées au test de service. Les caractéristiques varient en fonction de l'instance client. Type de données : chaîne | | type.valeur.caractéristique | Type de valeur caractéristique. * Oui/Non * choix * date * Date/Heure * durée * E-mail * étiquette * Test sur ligne unique {#servicetestmgmt-POST-serviceTest__ul_zfr_twr_dcc} Type de données : chaîne | | description | Description du test de service. Type de données : chaîne | | endDateTime | Date et heure de fin du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | id | Sys_id ou external_id du test de service. Situé dans la table Test de service \[sn_st_mgmt_test\]. Cet ID crée un test de service et est utilisé comme external_id. Type de données : chaîne | | Mode | Mode dans lequel le test de service s'exécute. Valeurs valides : * ONDEMAND : déclenche manuellement le test de service. * PROACTIF : déclenche automatiquement le test de service. {#servicetestmgmt-POST-serviceTest__ul_ybc_mqn_xbc} Par défaut : ONDEMAND | | nom | Requis. Nom du test de service. Type de données : chaîne | | service connexe | Requis. La définition de test associée au test de service. Type de données : objet "relatedService": { "href": "String", "id": "String", "name": "String" } | | relatedService.href | Lien hypertexte renvoyant au service connexe. Type de données : chaîne | | relatedService.id | Sys_id ou external_id de l'inventaire des produits. Situé dans le champ sys_id ou external_id de la table Inventaire des produits \[sn_prd_invt_product_inventory\]. Type de données : chaîne | | relatedService.name | Nom de l'élément d'inventaire de produits. Type de données : chaîne | | startDateTime | Date et heure de début du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | État | État dans lequel se trouve le test de service. Valeurs valides : * confirmé * annulé * terminé * échoué * inProgress * en attente * rejeté {#servicetestmgmt-POST-serviceTest__ul_gym_mqn_xbc} Type de données : chaîne | | testMeasure (en anglais seulement) | Mesure d'un aspect spécifique d'un test de produit, de service ou de ressource, comme les paquets perdus ou l'état de connectivité. Type de données : tableau d'objets "testMeasure": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array], "unitOfMeasure": "String", "value": {Object} } ] | | testMeasure.accuracy | Valeur décimale flottante représentant la précision de la mesure de test capturée pour les mesures associées. Type de données : nombre Valeur maximale : 40 | | testMeasure.captureDateTime | Date et heure de capture de la mesure. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasure.id | Sys_id ou external_id des mesures de test. Situé dans les champs sys_id ou external_id de la table Mesures de test \[sn_st_mgmt_test_measure\]. Type de données : chaîne | | testMeasure.Measure.captureMethod | Méthode utilisée pour capturer la mesure. Valeurs valides : * automatique : capture automatiquement la mesure. * manual : capturez manuellement la mesure. * aucun : ne pas capturer la mesure. {#servicetestmgmt-POST-serviceTest__ul_ed2_gxv_xbc} Type de données : chaîne | | testMeasure.metricDescription | Brève description de la mesure. Type de données : chaîne | | testMeasure.metricName | Nom de la mesure de test. Type de données : chaîne | | testMeasure.ruleViolation | Objet pour la définition d'une règle dans la définition de la règle de seuil, ainsi que les conséquences en cas de violation de la règle. Type de données : tableau d'objets "ruleViolation"[ { appliedConsequence: [Array], conformanceTargetUpper: Number, conformanceComparatorUpper: "String", description: "String", id: "String", name: "String", numberOfAllowedCrossing: Number, thresholdRuleSeverity: "String", tolerancePeriod: "String" } ] | | testMeasure.ruleViolation.appliedConsequence | Action (action prescrite ou notification) à prendre lorsqu'une règle de seuil est franchie. Type de données : tableau d'objets "appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ] | | testMeasure.ruleViolation.appliedConsequence.appliedAction | Action à exécuter en cas de violation d'une règle de seuil. Par exemple, l'envoi d'un avertissement ou la génération d'un rapport. Les actions appliquées peuvent varier d'une instance à l'autre. Type de données : chaîne | | testMeasure.ruleViolation.appliedSequence.description | Description de la conséquence appliquée. Type de données : chaîne | | testMeasure.ruleViolation.appliedConsequence.id | Sys_id ou external_id de la conséquence appliquée. Type de données : chaîne | | testMeasure.ruleViolation.appliedConsequence.name | Nom de la conséquence appliquée. Type de données : chaîne | | testMeasure.ruleViolation.appliedConsequence.repeatAction | Marqueur indiquant s'il faut répéter la conséquence lorsqu'une deuxième infraction se produit. Valeurs valides : * vrai : répétez l'action. * false : Répétez l'action. {#servicetestmgmt-POST-serviceTest__ul_ld2_gxv_xbc} Type de données : booléennes Valeur par défaut : false | | testMesure.règleViolation.conformitéComporatorExact | Marqueur indiquant si une valeur est identique. Valeurs valides : * true : la valeur est identique. * false : la valeur n'est pas identique. {#servicetestmgmt-POST-serviceTest__ul_od2_gxv_xbc} Type de données : booléennes Valeur par défaut : false | | testMesure.règleViolation.conformitéComporatorInférieur | Opérateur permettant de vérifier si une valeur tombe en dessous du seuil. Valeurs valides : * supérieur à * supérieur ou égal à {#servicetestmgmt-POST-serviceTest__ul_sd2_gxv_xbc} Type de données : chaîne | | testMesure.règleViolation.conformitéComporatorSupérieur | Opérateur permettant de vérifier si une valeur est supérieure au seuil. Valeurs valides : * inférieur à * inférieur ou égal à {#servicetestmgmt-POST-serviceTest__ul_vd2_gxv_xbc} Type de données : chaîne | | testMeasure.ruleViolation.conformanceTargetExact | Obligatoire si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur vrai, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre | | testMeasure.ruleViolation.conformanceTargetLower | Valeur de seuil inférieure pour comparer les résultats de la mesure de test. Détermine si le seuil est atteint ou plus. Type de données : nombre | | testMeasure.ruleViolation.conformanceTargetUpper | Valeur de seuil supérieure pour la comparaison des résultats de la mesure de test. Détermine si le seuil est atteint ou plus. Type de données : nombre | | testMeasure.ruleViolation.description | Description de la règle de seuil. Type de données : chaîne | | testMeasure.ruleViolation.id | Sys_id ou external_id de la violation de la règle de seuil. Situé dans la table Violation de la règle de seuil \[sn_st_mgmt_threshold_rule_violation\]. Type de données : chaîne | | testMeasure.ruleViolation.name | Nom de la règle de seuil. Type de données : chaîne | | testMeasure.ruleViolation.numberOfAllowedCrossing | Croisements maximaux autorisés pendant la période de tolérance avant l'application des conséquences. Type de données : nombre Valeur maximale : 40 | | testMeasure.ruleViolation.thresholdRuleSeverity | Gravité de la règle de seuil. Valeurs valides : * élevé * moyen * faible {#servicetestmgmt-POST-serviceTest__ul_xd2_gxv_xbc} Type de données : chaîne | | testMeasure.ruleViolation.tolerancePeriod | Intervalle de temps spécifié pendant lequel les occurrences de croisement sont activées sans déclencher de conséquences ou d'actions immédiates. Type de date : Objet "tolerancePeriod": { "amount": Number, "units": "String" } | | testMeasure.ruleViolation.tolerancePeriod.amount | Nombre de périodes avant l'application de la conséquence. Type de données : nombre | | testMeasure.ruleViolation.tolerancePeriod.units | Unités de la période. Valeurs acceptées : * secondes * minutes * jours * Heures {#servicetestmgmt-POST-serviceTest__ul_qbw_qds_dcc} Type de données : chaîne | | testMeasure.unitOfMeasure | Spécifie l'unité de mesure pour les valeurs cibles de conformité de la mesure d'essai. Type de données : chaîne | | testMeasure.value | Valeur de la mesure de test. Type de données : objet "value": { "id": "String", "name": "String", "valueType": "String", "value": "String } | | testMeasure.value.id | ID de la valeur de la mesure de test. Type de données : chaîne | | testMeasure.value.name | Nom de la valeur de la mesure de test. Type de données : chaîne | | testMeasure.value.value | Valeur de la mesure de test. Type de données : chaîne | | testMeasure.value.valueType | Type de valeur de mesure de test (numérique, texte, etc.). Type de données : chaîne | | testSpecification (Spécification de test) | Requis. La définition de test associée à ce test. Type de données : objet "testSpecification": { "id": "String", "href": "String" } | | testSpecification.href | Lien hypertexte renvoyant à la définition de test de service. Type de données : chaîne | | testSpecification.id | Le sys_id ou le external_id de la définition de test de service. Situé dans le champ sys_id ou external_id de la table Définition de test de service \[sn_st_mgmt_test_definition\]. Type de données : chaîne | | valideFor | Plage de dates pour laquelle le test de service est valide. Type de données : objet "validFor": { "startDateTime": "String", "endDateTime ": "String" } | | valideFor.endDateTime | Date de fin de validité du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | valideFor.startDateTime | Date de début de validité du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | [Tableau 40. Paramètres de corps de demande (XML ou JSON)] {#servicetestmgmt-POST-serviceTest__id_q31_zd1_qbc} ### 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](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#servicetestmgmt-POST-serviceTest__entry__124}{#servicetestmgmt-POST-serviceTest__accept-RESTAPI} | 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 41. En-têtes de demandes] {#servicetestmgmt-POST-serviceTest__entry__128} | En-tête | Description | |-|-| | Aucun | | [Tableau 42. En-têtes de réponses] ### 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](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#servicetestmgmt-POST-serviceTest__entry__132}{#servicetestmgmt-POST-serviceTest__entry-200-status-code}{#servicetestmgmt-POST-serviceTest__entry-400-status-code} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. | [Tableau 43. Codes d'état] ### Paramètres du corps de réponse (JSON ou XML) {#servicetestmgmt-POST-serviceTest__table_qzk_r2p_qbc__entry__2} | Nom | Description | |-|-| | characteristic | Liste décrivant les caractéristiques du test de service associé. Type de données : tableau d'objets "characteristic": [ { "id": "String", "name": "String", "value": "String", "valueType": "String" } ] | | characteristic.id | Sys_id ou external_id de caractéristiques. Situé dans la table Caractéristiques \[sn_prd_pm_characteristic\]. Si external_id est présent pour cet enregistrement, la réponse renvoie le external_id sinon elle renvoie le sys_id. Type de données : chaîne | | characteristic.name | Nom de la caractéristique. Type de données : chaîne | | valeur.caractéristique | Options de la caractéristique associées au test de service. Les caractéristiques varient en fonction de l'instance client. Type de données : chaîne | | type.valeur.caractéristique | Type de valeur caractéristique. * Oui/Non * choix * date * Date/Heure * durée * E-mail * étiquette * Test sur ligne unique Type de données : chaîne | | description | Description du test de service. Type de données : chaîne | | endDateTime | Date et heure de fin du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | id | Sys_id ou external_id de la définition de test de service. Situé dans la table Test de service \[sn_st_mgmt_test\]. Type de données : chaîne | | Mode | Mode dans lequel le test de service s'exécute. Valeurs valides : * ONDEMAND : déclenche manuellement le test de service. * PROACTIF : déclenche automatiquement le test de service. {#servicetestmgmt-POST-serviceTest__ul_itl_ksn_xbc} Par défaut : ONDEMAND | | nom | Nom du test de service. Type de données : chaîne | | service connexe | Définition de test associée pour ce test. Type de données : objet "relatedService": { "href": "string", "id": "String", "name": "String" } | | relatedService.id | Sys_id ou external_id de l'inventaire des produits. Situé dans le champ sys_id ou external_id de la table Inventaire des produits \[sn_prd_invt_product_inventory\]. Type de données : chaîne | | relatedService.name | Nom de l'inventaire des produits. Type de données : chaîne | | startDateTime | Date et heure de début du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | État | État du test de service. Valeurs valides : * confirmé * annulé * terminé * échoué * inProgress * en attente * rejeté {#servicetestmgmt-POST-serviceTest__ul_prs_txv_xbc} | | testMeasure (en anglais seulement) | Mesure d'un aspect spécifique d'un test de produit, de service ou de ressource, comme les paquets perdus ou l'état de connectivité. Type de données : tableau d'objets "testMeasureDefinition": [ { "accuracy": "String", "captureDateTime": "String", "captureMethod": "String", "id": "String", "metricDescription": "String", "metricName": "String", "ruleViolation": [Array] "unitOfMeasure": "String", "value": {Object} } ] | | testMeasure.accuracy | Valeur décimale flottante représentant la précision de la mesure de test capturée pour les mesures associées. Type de données : nombre Valeur maximale : 40 | | testMeasure.captureDateTime | Date et heure de capture de la mesure. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasure.captureMethod | Méthode utilisée pour capturer la mesure. Valeurs valides : * automatique : capture automatiquement la mesure. * manual : capturez manuellement la mesure. * aucun : ne pas capturer la mesure. {#servicetestmgmt-POST-serviceTest__ul_zrs_txv_xbc} Type de données : chaîne | | testMeasure.id | Sys_id ou external_id de la mesure d'essai. Situé dans la table Mesures de test \[sn_st_mgmt_test_measure\]. Type de données : chaîne | | testMeasure.metricDescription | Brève description de la mesure. Type de données : chaîne | | testMeasure.metricName | Nom d'une mesure dans la mesure de test. Type de données : chaîne | | testMeasure.ruleViolation | Objet pour la définition d'une règle dans la définition de la règle de seuil, ainsi que les conséquences en cas de violation de la règle. Type de données : tableau d'objets "RuleViolation": [ { "appliedConsequence": [Array], "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": {Object} } ] | | testMeasure.ruleViolation.appliedConsequence | Action (action prescrite ou notification) à prendre en cas de violation d'une règle de seuil. Type de données : tableau d'objets "appliedConsequence": [ { "appliedAction": "String", "description": "String", "id": "String", "name": "String", "repeatAction": Boolean } ] | | testMeasure.ruleViolation.appliedConsequence.appliedAction | Action à exécuter en cas de violation d'une règle de seuil. Par exemple, l'envoi d'un avertissement ou la génération d'un rapport. Les actions appliquées peuvent varier d'une instance à l'autre. Type de données : chaîne | | testMeasure.ruleViolation.appliedConsequence.appliedAction.repeatAction | Marqueur indiquant s'il faut répéter l'action appliquée ou non. Valeurs valides : * vrai : répète l'action. * faux : ne répète pas l'action. {#servicetestmgmt-POST-serviceTest__ul_kss_txv_xbc} Type de données : booléennes Valeur par défaut : false | | testMeasure.ruleViolation.appliedSequence.description | Description de la conséquence appliquée. Type de données : chaîne | | testMeasure.ruleViolation.appliedConsequence.id | Sys_id ou external_id de la conséquence appliquée. Type de données : chaîne | | testMeasure.ruleViolation.appliedConsequence.name | Nom de la conséquence appliquée. Type de données : chaîne | | testMeasure.ruleViolation.conformanceComparatorExact | Marqueur indiquant si une valeur est identique à la valeur de conformanceTargetExact. Valeurs valides : * true : la valeur est identique. * false : la valeur n'est pas identique. {#servicetestmgmt-POST-serviceTest__ul_uss_txv_xbc} Type de données : booléennes Valeur par défaut : false | | testMeasure.ruleViolation.conformanceComparatorLower | Opérateur qui vérifie si une valeur tombe en dessous du seuil. Valeurs valides : * supérieur à * est {#servicetestmgmt-POST-serviceTest__ul_fts_txv_xbc} Type de données : chaîne | | testMeasure.ruleViolation.conformanceComparatorUpper | Opérateur qui vérifie si une valeur dépasse le seuil. Valeurs valides : * est * inférieur à {#servicetestmgmt-POST-serviceTest__ul_mts_txv_xbc} Type de données : chaîne | | testMeasure.ruleViolation.conformanceTargetExact | Obligatoire si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur vrai, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre | | testMeasure.ruleViolation.conformanceTargetLower | Valeur de seuil inférieure pour comparer les résultats de la mesure de test. Détermine si le seuil est atteint ou plus. Type de données : nombre | | testMeasure.ruleViolation.conformanceTargetUpper | Valeur de seuil supérieure pour la comparaison des résultats de la mesure de test. Détermine si le seuil est atteint ou plus. Type de données : nombre | | testMeasure.ruleViolation.description | Description de la violation de la règle de seuil. Type de données : chaîne | | testMeasure.ruleViolation.id | Sys_id ou external_id de la violation de la règle de seuil. Situé dans la table Violation de la règle de seuil \[sn_st_mgmt_threshold_rule_violation\]. Type de données : chaîne | | testMeasure.ruleViolation.name | Nom de la violation de la règle de seuil. Type de date : chaîne | | testMeasure.ruleViolation.numberOfAllowedCrossing | Croisements maximaux autorisés pendant la période de tolérance avant l'application des conséquences. Type de données : nombre Maximum : 40 | | testMeasure.ruleViolation.thresholdRuleSeverity | Gravité de la règle de seuil. Valeurs valides : * élevé * faible * moyen {#servicetestmgmt-POST-serviceTest__ul_tts_txv_xbc} Type de données : chaîne | | testMeasure.ruleViolation.tolerancePeriod | Durée ou intervalle de temps pendant lequel des croisements autorisés peuvent se produire avant qu'une conséquence ne soit déclenchée. Type de date : Objet "tolerancePeriod": { "amount": Number, "units": "String" } | | testMeasure.ruleViolation.tolerancePeriod.amount | Montant de la période en nombre. Type de données : nombre | | testMeasure.ruleViolation.tolerancePeriod.units | Unités de la période. Valeurs acceptées : * secondes * minutes * jours * Heures {#servicetestmgmt-POST-serviceTest__ul_my3_qds_dcc} Type de données : chaîne | | testMeasure.unitOfMeasure | Valeur mesurable de temps utilisée pour calculer la performance d'un service en jours, minutes et secondes. Type de données : chaîne | | testMeasure.value | Valeur de la mesure dans le test. Type de données : objet "value": { "id": "String", "name": "String", "valueType": "String", "value": "String" } | | testMeasure.value.id | ID de la valeur de mesure dans le test. Type de données : chaîne | | testMeasure.value.name | Nom de la valeur de mesure dans le test. Type de données : chaîne | | testMeasure.value.name | Nom de la valeur de mesure dans le test. Type de données : chaîne | | testMeasure.value.value | Valeur de la mesure dans le test. Type de données : chaîne | | testMeasure.value.valueType | Type de valeur de mesure de test (numérique, texte, etc.). Type de données : chaîne | | testSpecification (Spécification de test) | Définition de test associée pour ce test. Type de données : objet "testSpecification": { "href": "String", "id": "String" } | | testSpecification.href | Lien hypertexte renvoyant à la définition de test de service. Type de données : chaîne | | testSpecification.id | Sys_id ou external_id de la définition de test de service. Situé dans le champ sys_id ou external_id de la table Définition de test de service \[sn_st_mgmt_test_definition\]. Type de données : chaîne | | valideFor | Plage de dates pour laquelle le test de service est valide. Type de données : objet "validFor": { "startDateTime": "String", "endDateTime": "String" } | | valideFor.endDateTime | Date de fin et horodatage du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | valideFor.startDateTime | Date et horodatage de début du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | [ ] {#servicetestmgmt-POST-serviceTest__table_qzk_r2p_qbc} ### Demande cURL {#servicetestmgmt-POST-serviceTest__example_x42_qf1_qbc} L'exemple suivant crée un nouveau test de service en fonction des détails spécifiques fournis dans le corps de la demande. curl "https:/instance.servicenow.com/api/sn_sprb_mgmt/servicetestmanagement/serviceTest" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data { "description": "Service test", "endDateTime": "2025-01-31 15:05:43", "mode": "proactive", "name": "Speed Test TR0001002", "startDateTime": "2024-06-05 09:07:10", "validFor": { "startDateTime": "", "endDateTime": "" }, "relatedService": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "name": "Internet_VPLS_PI0000011" }, "testSpecification": { "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/76a3b160432a02104fefe4511fb8f2ad", "id": "76a3b160432a02104fefe4511fb8f2ad" }, "characteristic": [ { "id": "e7ef960443f202104fefe4511fb8f224", "name": "AccessRequired", "valueType": "yes_no", "value": "Yes" } ], "testMeasure": [ { "id": "61d1382e3be28210d140068aa4e45a2e", "accuracy": "0.0001", "captureDateTime": "", "captureMethod": "automatic", "metricDescription": "", "metricName": "Flow speed", "unitOfMeasure": "A second", "value": "3000", "ruleViolation": [ { "id": "61d1382e3be28210d140068aa4e45a2f", "description": "This speed is greater than the target", "name": "tooMuchTraffic", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "", "conformanceTargetLower": "2500", "conformanceComparatorLower": "greater than", "appliedConsequence": [ { "id": "65d1382e3be28210d140068aa4e45a31", "appliedAction": "sendWarning", "description": "send a warning to the system", "name": "sendWarning", "repeatAction": "0" } ] } ] } ] } La réponse renvoie les détails de confirmation du nouveau service de test et lui attribue un ID unique, 2b406ec043b202104fefe4511fb8f211 : { "description": "Service test", "endDateTime": "2025-01-31 15:05:43", "mode": "proactive", "name": "Speed Test TR0001002", "startDateTime": "2024-06-05 09:07:10", "validFor": { "startDateTime": "", "endDateTime": "" }, "relatedService": { "id": "fa6d13f45b5620102dff5e92dc81c77f", "name": "Internet_VPLS_PI0000011" }, "testSpecification": { "href": "/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification/76a3b160432a02104fefe4511fb8f2ad", "id": "76a3b160432a02104fefe4511fb8f2ad" }, "characteristic": [ { "id": "e7ef960443f202104fefe4511fb8f224", "name": "AccessRequired", "valueType": "yes_no", "value": "Yes" } ], "testMeasure": [ { "id": "61d1382e3be28210d140068aa4e45a2e", "accuracy": "0.0001", "captureDateTime": "", "captureMethod": "automatic", "metricDescription": "", "metricName": "Flow speed", "unitOfMeasure": "A second", "value": "3000", "ruleViolation": [ { "id": "61d1382e3be28210d140068aa4e45a2f", "description": "This speed is greater than the target", "name": "tooMuchTraffic", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "", "conformanceTargetLower": "2500", "conformanceComparatorLower": "greater than", "appliedConsequence": [ { "id": "65d1382e3be28210d140068aa4e45a31", "appliedAction": "sendWarning", "description": "send a warning to the system", "name": "sendWarning", "repeatAction": "0" } ] } ] } ], "id": "2b406ec043b202104fefe4511fb8f211" } ## API ouverte de gestion des tests de service : POST /sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification {#ariaid-title9} Crée une nouvelle définition de test de service. ### Format d'URL URL par défaut : /api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification ### Paramètres de demande pris en charge {#servicetestmgmt-POST-serviceTestSp__entry__2} | Nom | Description | |-|-| | Aucun | | [Tableau 44. Paramètres de chemin d'accès] {#servicetestmgmt-POST-serviceTestSp__entry__6} | Nom | Description | |-|-| | Aucun | | [Tableau 45. Paramètres de requête] {#servicetestmgmt-POST-serviceTestSp__id_thr_xwn_qbc__entry__2}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-description-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-id-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-name-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-relatedServiceSpecification-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-relatedServiceSpecification.id-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-relatedServiceSpecification.name-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristics-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristics.characteristicValueSpecification-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristic.characteristicValueSpecification.value-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristic.characteristicValueSpecification.descr-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristic.characteristicValueSpecification.name-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristic.validFor-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristic.validFor.endDateTime-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristic.validFor.startDateTime-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-specCharacteristic.valueType-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.captureFrequency-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.captureMethod-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.capturePeriod-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.capturePeriod.amount-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.capturePeriod.units-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.id-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.metricDescription-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.metricName-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.name-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.ComporatorExact-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.ComporatorLower-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.ComporatorUpper-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.TargetExact-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.TargetLower-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.TargetUpper-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.description-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.id-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.name-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.prescribeAction-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.repeatAction-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.validFor-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.validFor.endDateTime-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.consequence.validFor.startDateTime-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.description-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.id-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.name-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.numberOfAllowedCrossing-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.thresholdRule.thresholdRuleSeverity-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.unitOfMeasure-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.validFor-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.validFor.endDateTime-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-testMeasureDefinition.validFor.startDateTime-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-validFor-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-validFor.endDateTime-param}{#servicetestmgmt-POST-serviceTestSp__testSpec-request-validFor.startDateTime-param} | Nom | Description | |-|-| | description | Description de la définition de test de service. Type de données : chaîne | | id | Sys_id ou external_id de la définition de test de service. Situé dans la table Définition de test de service \[sn_st_mgmt_test_definition\]. Type de données : chaîne | | nom | Requis. Nom de la définition de test de service. Type de données : chaîne | | relatedServiceSpecification (en anglais seulement) | Requis. Spécifications de service de la définition de test. Type de données : tableau d'objets "relatedServiceSpecification": [ { "id": "String", "name": "String" } ] | | relatedServiceSpecification.id | Sys_id ou external_id de la spécification de service. Situé dans le champ sys_id ou external_id de la table Spécification \[sn_prd_pm_specification\]. Type de données : chaîne | | relatedServiceSpecification.name | Nom de la spécification de service. Type de données : chaîne | | serviceTestSpecRelationship | Définition de test du service connexe. Type de données : tableau d'objets "serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ] | | serviceTestSpecRelationship.id | Sys_id ou external_id de la définition de test du service connexe. Situé dans le champ sys_id ou external_id de la table Définition de test \[sn_st_mgmt_test_definition\]. Type de données : chaîne | | serviceTestSpecRelationship.name | Nom de la définition de test connexe. Type de données : chaîne | | serviceTestSpecRelationship.relationshipType | Type de relation. Valeurs acceptées : * substitution * dépendance * exclusivité Type de données : chaîne | | specCharacteristic (en anglais seulement) | Caractéristiques de la définition de test. Type de données : tableau d'objets "specCharacteristic": [ { "characteristicValueSpecification": [Array], "description": "String", "name": "String", "validFor": {Object}, "valueType": "String" } ] | | specCharacteristic.characteristicValueSpecification | Tableau contenant les valeurs possibles de la caractéristique. Type de données : tableau d'objets "characteristicValueSpecification": [ { "value": "String" } ] | | specCharacteristic.characteristicValueSpecification.value | Valeur de la caractéristique. Type de données : chaîne | | specCharacteristic.description | Description de la caractéristique. Type de données : chaîne | | specCharacteristic.name | Nom de la caractéristique. Type de données : chaîne | | specCharacteristic.validFor | Plage de dates pour laquelle la caractéristique est valide. Type de données : objet "validFor": { "endDateTime": "String", "startDateTime": "String" } | | specCharacteristic.validFor.endDateTime | Date de fin de la caractéristique. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | specCharacteristic.validFor.startDateTime | Date de début de la caractéristique. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | specCharacteristic.valueType | Type de valeur caractéristique. * Oui/Non * choix * date * Date/Heure * durée * E-mail * étiquette * Test sur ligne unique {#servicetestmgmt-POST-serviceTestSp__ul_i3m_twr_dcc} Type de données : chaîne | | testMeasureDefinition | Définitions de mesure de test pour cette définition de test de service. Pour plus d'informations, consultez [Define test measure definitions for a service test](https://www.servicenow.com/docs/access?context=define-test-measure-spm&version=xanadu&pubname=xanadu-proactive-service-exp-workflows&ft:locale=en-US). Type de données : tableau d'objets "testMeasureDefinition": [ { "captureFrequency": "String", "captureMethod": "String", "capturePeriod": {Object}, "id": "String", "metricDescription": "String", "metricName": "String", "name": "String", "unitOfMeasure": "String", "thresholdRule": [Array], "validFor": {Object}, "valueType": "String" } ] | | testMeasureDefinition.captureFrequency | Fréquence à laquelle capturer la mesure. Valeurs valides : * aucun * une fois * quotidien * hebdomadaire * mensuel {#servicetestmgmt-POST-serviceTestSp__ul_lsw_jxv_xbc} Type de données : chaîne | | testMeasureDefinition.captureMethod | Méthode utilisée pour capturer la mesure. Valeurs valides : * automatique : capture automatiquement la mesure. * manual : capturez manuellement la mesure. * none : ne capture pas la mesure. {#servicetestmgmt-POST-serviceTestSp__ul_gsw_jxv_xbc} Type de données : chaîne | | testMeasureDefinition.capturePeriod | Période ou durée de la capture de mesure. Type de données : objet "capturePeriod": { "amount": Number, "units": "String" } | | testMeasureDefinition.capturePeriod.amount | Nombre de périodes de capture. Type de données : nombre | | testMeasureDefinition.capturePeriod.units | Unités de la période. Valeurs acceptées : * secondes * minutes * jours * Heures {#servicetestmgmt-POST-serviceTestSp__ul_rn1_3ds_dcc} Type de données : chaîne | | testMeasureDefinition.id | Sys_id ou external_id des définitions de mesure de test. Situé dans la table de définition de mesure de test \[sn_st_mgmt_test_measure_definition\]. Type de données : chaîne | | testMeasureDefinition.metricDescription | Brève description de la mesure. Type de données : chaîne | | testMeasureDefinition.metricName | Nom défini par l'utilisateur d'une mesure dans la mesure de test. Type de données : chaîne | | testMeasureDefinition.name | Nom de la définition de la mesure de test. Type de données : chaîne | | testMeasureDefinition.thresholdRule | Règle qui définit les conditions à remplir avant d'appliquer des conséquences lorsqu'un seuil est franchi (ou non dépassé) dans la définition de la mesure de test. Pour plus d'informations, consultez [Define threshold rules for a test measure definition](https://www.servicenow.com/docs/access?context=define-threshold-rules&version=xanadu&pubname=xanadu-proactive-service-exp-workflows&ft:locale=en-US). Type de données : tableau d'objets { "thresholdRule": { "consequence": Array, "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "consequence": Array, "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": Object } } | | testMeasureDefinition.thresholdRule.conformanceComparatorExact | Marqueur indiquant si une valeur est identique à la valeur définie pour testMeasureDefinition.thresholdRule.conformanceTargetExact. Si la valeur est définie sur vrai, testMeasureDefinition.thresholdRule.conformanceTargetExact est requise. Valeurs valides : * true : la valeur est identique à la valeur de conformanceTargetExact. * false : la valeur n'est pas identique.conformanceTargetExact {#servicetestmgmt-POST-serviceTestSp__ul_bsw_jxv_xbc} Type de données : booléennes Valeur par défaut : false | | testMeasureDefinition.thresholdRule.conformanceComparatorLower | Opérateur qui vérifie si une valeur tombe en dessous du seuil. Valeurs valides : * supérieur à * supérieur ou égal à {#servicetestmgmt-POST-serviceTestSp__ul_zrw_jxv_xbc} Type de données : chaîne | | testMeasureDefinition.thresholdRule.conformanceComparatorUpper | Opérateur qui vérifie si une valeur dépasse le seuil. Valeurs valides : * inférieur à * inférieur ou égal à {#servicetestmgmt-POST-serviceTestSp__ul_wrw_jxv_xbc} Type de données : chaîne | | testMeasureDefinition.thresholdRule.conformanceTargetExact | Obligatoire si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur vrai, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre | | testMeasureDefinition.thresholdRule.conformanceTargetLower | Valeur de seuil inférieure pour comparer les résultats de la mesure de test. Type de données : nombre | | testMeasureDefinition.thresholdRule.conformanceTargetUpper | Valeur de seuil supérieure pour la comparaison des résultats de la mesure de test. Type de données : nombre | | testMeasureDefinition.thresholdRule.consequence | Action (action prescrite ou notification) à prendre lorsqu'une règle de seuil est franchie. Pour plus d'informations, consultez [Define measure consequences for the threshold rules](https://www.servicenow.com/docs/access?context=define-threshold-consequences-spm&version=xanadu&pubname=xanadu-proactive-service-exp-workflows&ft:locale=en-US). Type de données : tableau d'objets "consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ] | | testMeasureDefinition.thresholdRule.consequence.description | Description de la conséquence. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.id | Sys_id ou external_id de la conséquence de la mesure. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.name | Nom de la conséquence. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.prescribeAction | Action définie par l'utilisateur à prendre en cas de violation de seuil. Les actions varient d'une instance à l'autre. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.repeatAction | Marqueur indiquant s'il faut répéter la conséquence appliquée. Valeurs valides : * vrai : répète l'action. * faux : ne répète pas l'action. {#servicetestmgmt-POST-serviceTestSp__ul_srw_jxv_xbc} Type de données : booléennes Valeur par défaut : false | | testMeasureDefinition.thresholdRule.consequence.validFor | Plage de dates pour laquelle la conséquence est valide. Type de données : objet "validFor": { "startDateTime": "String", "endDateTime ": "String" } | | testMeasureDefinition.thresholdRule.consequence.validFor.endDateTime | Date de fin de validité de la conséquence. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.validFor.startDateTime | Date de début de validité de la conséquence. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasureDefinition.thresholdRule.description | Description de la règle de seuil. Type de données : chaîne | | testMeasureDefinition.thresholdRule.id | Sys_id ou external_id des règles de seuil. Situé dans le champ Situé dans le champ sys_id ou external_id de la table Règles de seuil \[sn_st_mgmt_threshold_rule\]. Type de données : chaîne | | testMeasureDefinition.thresholdRule.name | Nom de la règle de seuil. Type de données : chaîne | | testMeasureDefinition.thresholdRule.numberOfAllowedCrossing | Croisements maximaux autorisés pendant la période de tolérance avant l'application des conséquences. Valeur maximale : 40 Type de données : nombre | | testMeasureDefinition.thresholdRule.thresholdRuleSeverity | Niveau de gravité de la règle de seuil. Valeurs valides : * élevé * moyen * faible {#servicetestmgmt-POST-serviceTestSp__ul_orw_jxv_xbc} Type de données : chaîne | | testMeasureDefinition.unitOfMeasure | Valeur mesurable de temps utilisée pour calculer la performance d'un service en jours, minutes et secondes. Type de données : chaîne | | testMeasureDefinition.validFor | Plage de dates pour laquelle la définition de mesure de test est valide. Type de données : chaîne "validFor": { "endDateTime": "String", "startDateTime": "String" } | | testMeasureDefinition.validFor.endDateTime | Date de fin de validité de la définition de la mesure d'essai. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasureDefinition.validFor.startDateTime | Date de début de validité de la définition de la mesure d'essai. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | valideFor | Plage de dates pour laquelle la définition de test est valide. Type de données : objet "validFor": { "endDateTime": "String", "startDateTime": "String" } | | valideFor.endDateTime | Date et heure de la définition de test sur lesquelles l'état de celle-ci est mis hors service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | valideFor.startDateTime | Date et heure de la définition de test sur laquelle son état est publié. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | [Tableau 46. Paramètres de corps de demande (XML ou JSON)] {#servicetestmgmt-POST-serviceTestSp__id_thr_xwn_qbc} ### 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](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#servicetestmgmt-POST-serviceTestSp__entry__126}{#servicetestmgmt-POST-serviceTestSp__accept-JSON-only-entry-RESTAPI}{#servicetestmgmt-POST-serviceTestSp__content_type-JSON-only-entry-RESTAPI} | En-tête | Description | |-|-| | Accepter | Format de données du corps de la réponse. Prend uniquement en charge application/json. | | Content-Type | Format de données du corps de la demande. Prend uniquement en charge application/json. | [Tableau 47. En-têtes de demandes] {#servicetestmgmt-POST-serviceTestSp__entry__132} | En-tête | Description | |-|-| | Type de contenu | Format de données du corps de la réponse. Prend uniquement en charge application/json. | [Tableau 48. En-têtes de réponses] ### 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](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres."). {#servicetestmgmt-POST-serviceTestSp__entry__136}{#servicetestmgmt-POST-serviceTestSp__entry-200-status-code}{#servicetestmgmt-POST-serviceTestSp__entry-400-status-code} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté. | [Tableau 49. Codes d'état] ### Paramètres du corps de réponse (JSON ou XML) {#servicetestmgmt-POST-serviceTestSp__table_qqg_3s4_qbc__entry__2} | Nom | Description | |-|-| | description | Description de la définition de test de service. Type de données : chaîne | | id | Le sys_id ou le external_id de la définition de test de service. Situé dans la table Test de service \[sn_st_mgmt_test\]. Type de données : chaîne | | nom | Nom de la définition de test de service. Type de données : chaîne | | relatedServiceSpecification (en anglais seulement) | Spécifications de service pour les définitions de test. Type de données : tableau d'objets "relatedServiceSpecification": [ { "id": "String", "name": "String" } ] | | relatedServiceSpecification.id | Le sys_id ou le external_id de la spécification de service. Situé dans le champ sys_id ou external_id de la table Spécification \[sn_prd_pm_specification\]. Type de données : chaîne | | relatedServiceSpecification.name | Nom de la spécification de service. Type de données : chaîne | | serviceTestSpecRelationship | Définition de test de service connexe. Type de données : tableau d'objets "serviceTestSpecRelationship": [ { "id": "String", "name": "String", "relationshipType": "String" } ] | | serviceTestSpecRelationship.id | Sys_id ou external_id de la définition de test du service connexe. Situé dans le champ sys_id ou external_id de la table Définition de test \[sn_st_mgmt_test_definition\]. Type de données : chaîne | | serviceTestSpecRelationship.name | Nom de la définition de test connexe. Type de données : chaîne | | serviceTestSpecRelationship.relationshipType | Type de relation. Valeurs acceptées : * substitution * dépendance * exclusivité {#servicetestmgmt-POST-serviceTestSp__ul_hpg_xtr_dcc} Type de données : chaîne | | specCharacteristic (en anglais seulement) | Caractéristiques de la définition de test. Type de données : tableau d'objets "specCharacteristic": [ { "characteristicValueSpecification": Array, "description": "String", "name": "String", "validFor": Object, "valueType": "String" } ] | | specCharacteristic.characteristicValueSpecification | Tableau contenant les valeurs possibles de la caractéristique. Type de données : tableau d'objets "characteristicValueSpecification": [ { "value": "String" } ] | | specCharacteristic.characteristicValueSpecification.value | Valeur de la caractéristique. Type de données : chaîne | | specCharacteristic.description | Description de la caractéristique. Type de données : chaîne | | specCharacteristic.name | Nom de la caractéristique. Type de données : chaîne | | specCharacteristic.validFor | Plage de dates pour laquelle la caractéristique est valide. Type de données : objet "validFor": { "endDateTime": "String", "startDateTime": "String" } | | specCharacteristic.validFor.endDateTime | Date de fin de la caractéristique. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | specCharacteristic.validFor.startDateTime | Date de début de la caractéristique. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | specCharacteristic.valueType | Type de valeur caractéristique. * Oui/Non * choix * date * Date/Heure * durée * E-mail * étiquette * Test sur ligne unique {#servicetestmgmt-POST-serviceTestSp__ul_uwb_5wr_dcc} Type de données : chaîne | | testMeasureDefinition | Définitions de mesure de test pour cette définition de test de service. Pour plus d'informations, consultez [Define test measure definitions for a service test](https://www.servicenow.com/docs/access?context=define-test-measure-spm&version=xanadu&pubname=xanadu-proactive-service-exp-workflows&ft:locale=en-US). Type de données : tableau d'objets "testMeasureDefinition": [ { "captureFrequency": "String", "captureMethod": "String", "capturePeriod": {Object}, "id": "String", "metricDescription": "String", "metricName": "String", "name": "String", "unitOfMeasure": "String", "thresholdRule": [Array], "validFor": {Object}, "valueType": "String" } ] | | testMeasureDefinition.captureFrequency | Fréquence à laquelle capturer la mesure. Valeurs valides : * quotidien * mensuel * aucun * une fois * hebdomadaire {#servicetestmgmt-POST-serviceTestSp__ul_od2_sxv_xbc} Type de données : chaîne | | testMeasureDefinition.captureMethod | Méthode utilisée pour capturer la mesure. Valeurs valides : * manual : capturez manuellement la mesure. * automatique : capture automatiquement la mesure. * aucun : ne pas capturer la mesure. {#servicetestmgmt-POST-serviceTestSp__ul_rd2_sxv_xbc} Type de données : chaîne | | testMeasureDefinition.capturePeriod | Une durée ou une période de la capture. Type de données : objet "capturePeriod": { "amount": Number, "units": "String" } | | testMeasureDefinition.capturePeriod.amount | Nombre de périodes de capture. Type de données : nombre | | testMeasureDefinition.capturePeriod.units | Unités de la période. Valeurs acceptées : * secondes * minutes * jours * Heures {#servicetestmgmt-POST-serviceTestSp__ul_lfv_dds_dcc} Type de données : chaîne | | testMeasureDefinition.id | Sys_id ou external_id des définitions de la mesure de test. Situé dans la table de définition de mesure de test \[sn_st_mgmt_test_measure_definition\]. Type de données : chaîne | | testMeasureDefinition.metricDescription | Brève description de la mesure. Type de données : chaîne | | testMeasureDefinition.metricName | Nom défini par l'utilisateur d'une mesure dans la mesure de test. Type de données : chaîne | | testMeasureDefinition.name | Nom de la définition de la mesure de test. Type de données : chaîne | | testMeasureDefinition.thresholdRule | Règle qui définit la condition (raise ou clear) à atteindre pour appliquer les conséquences lorsqu'un seuil est franchi ou cesse d'être franchi pour une définition de mesure de test particulière. Type de données : tableau d'objets { "thresholdRule": { "conformanceComparatorExact": Boolean, "conformanceComparatorLower": "String", "conformanceComparatorUpper": "String", "conformanceTargetExact": "String", "conformanceTargetLower": "String", "conformanceTargetUpper": "String", "consequence": Array, "description": "String", "id": "String", "name": "String", "numberOfAllowedCrossing": Number, "thresholdRuleSeverity": "String", "tolerancePeriod": Object } } | | testMeasureDefinition.thresholdRule.conformanceComparatorExact | Marqueur indiquant si une valeur est identique à la valeur de conformanceTargetExact. Valeurs valides : * true : la valeur est identique à la valeur de conformanceTargetExact. * false : la valeur n'est pas identique.conformanceTargetExact {#servicetestmgmt-POST-serviceTestSp__ul_gyl_vqr_dcc} Type de données : booléennes Valeur par défaut : false | | testMeasureDefinition.thresholdRule.conformanceComparatorLower | Opérateur qui vérifie si une valeur tombe en dessous du seuil. Valeurs valides : * supérieur à * est {#servicetestmgmt-POST-serviceTestSp__ul_b22_sxv_xbc} Type de données : chaîne | | testMeasureDefinition.thresholdRule.conformanceComparatorUpper | Opérateur qui vérifie si une valeur dépasse le seuil. Valeurs valides : * inférieur à * est {#servicetestmgmt-POST-serviceTestSp__ul_e22_sxv_xbc} Type de données : chaîne | | testMeasureDefinition.thresholdRule.conformanceTargetExact | Obligatoire si conformanceComparatorExact est défini sur vrai. Si la conformanceComparatorExact valeur est définie sur vrai, sa valeur correspond à la valeur définie dans conformanceTargetExact. Type de données : nombre | | testMeasureDefinition.thresholdRule.conformanceTargetLower | Valeur de seuil inférieure pour comparer les résultats de la mesure de test. Type de données : nombre | | testMeasureDefinition.thresholdRule.conformanceTargetUpper | Valeur de seuil supérieure pour la comparaison des résultats de la mesure de test. Type de données : nombre | | testMeasureDefinition.thresholdRule.consequence | Action (action prescrite ou notification) à prendre lorsqu'une règle de seuil est franchie. Type de données : tableau d'objets "consequence": [ { "description": "String", "id": "String", "name": "String", "prescribeAction": "String", "repeatAction": Boolean, "validFor": { "endDateTime": "String", "startDateTime": "String" } ] | | testMeasureDefinition.thresholdRule.consequence.description | Description de la conséquence. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.id | Sys_id ou external_id de la conséquence de la mesure. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.name | Nom de la conséquence. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.prescribeAction | Action définie par l'utilisateur à prendre en cas de violation de seuil. Les actions varient d'une instance à l'autre. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.repeatAction | Marqueur indiquant s'il faut répéter l'action appliquée ou non. Valeurs valides : * vrai : répète l'action. * faux : ne répète pas l'action. {#servicetestmgmt-POST-serviceTestSp__ul_rjm_pxy_rbc} Type de données : booléennes Valeur par défaut : false | | testMeasureDefinition.thresholdRule.consequence.validFor | Plage de dates pour laquelle la conséquence est valide. Type de données : objet "validFor": { "startDateTime": "String", "endDateTime ": "String" } | | testMeasureDefinition.thresholdRule.consequence.validFor.endDateTime | Date de fin de validité de la conséquence. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasureDefinition.thresholdRule.consequence.validFor.startDateTime | Date de début de validité de la conséquence. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasureDefinition.thresholdRule.description | Description de la règle de seuil. Type de données : chaîne | | testMeasureDefinition.thresholdRule.id | Sys_id ou external_id des règles de seuil. Situé dans la table Règles de seuil \[sn_st_mgmt_threshold_rule\]. Type de données : chaîne | | testMeasureDefinition.thresholdRule.name | Nom de la règle de seuil. Type de données : chaîne | | testMeasureDefinition.thresholdRule.numberOfAllowedCrossing | Croisements maximaux autorisés pendant la période de tolérance avant l'application des conséquences. Type de données : nombre Valeur maximale : 40 | | testMeasureDefinition.thresholdRule.thresholdRuleSeverity | Gravité de la règle de seuil. Valeurs valides : * élevé * faible * moyen {#servicetestmgmt-POST-serviceTestSp__ul_j22_sxv_xbc} Type de données : chaîne | | testMeasureDefinition.unitOfMeasure | Valeur mesurable de temps utilisée pour calculer la performance d'un service en jours, minutes et secondes. Type de données : chaîne | | testMeasureDefinition.validFor | Plage de dates pour laquelle la définition de la mesure de test est valide. Type de données : objet "validFor": { "startDateTime": "String", "endDateTime": "String" } | | testMeasureDefinition.validFor.endDateTime | Date de fin de validité de la définition de la mesure d'essai. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | testMeasureDefinition.validFor.startDateTime | Date de début de validité de la définition de la mesure d'essai. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | valideFor | Plage de dates pour laquelle le test de service est valide. Type de données : objet "validFor": { "startDateTime": "String", "endDateTime ": "String" } | | valideFor.endDateTime | Date et heure de fin du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | | valideFor.startDateTime | Date et heure de début du test de service. Format : JJ-MM-AAAA 00:00:00. Par exemple, `2025-01-31 09:35:43`. Type de données : chaîne | [ ] {#servicetestmgmt-POST-serviceTestSp__table_qqg_3s4_qbc} ### Demande cURL L'exemple suivant crée une nouvelle définition de test de service. curl "https:/instance.servicenow.com/api/sn_sprb_mgmt/servicetestmanagement/serviceTestSpecification" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --user 'username':'password' -- data { "description": "Upstream and Downstream speed ", "name": "Speed Test", "validFor": { "startDateTime": "2024-05-31", "endDateTime": "2024-06-27" }, "testMeasureDefinition": [ { "id": "1a04f560432a02104fefe4511fb8f2ad", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the downstream speed in a service", "metricName": "Downstream Speed", "name": "Downstream Speed", "unitOfMeasure": "a second", "valueType": "", "capturePeriod": "30 Minutes", "validFor": { "startDateTime": "2024-05-30 08:49:26", "endDateTime": "2024-05-31 08:49:29" }, "thresholdRule": [ { "id": "a754f960432a02104fefe4511fb8f2d0", "description": "This speed is greater than the target upper", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "15 Minutes", "conformanceTargetLower": "75", "conformanceComparatorLower": "greater than", "consequence": [ { "id": "15a4bd60432a02104fefe4511fb8f2b8", "prescribeAction": "null", "description": "generate a waring report", "name": "degradedQualityOfService", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:51:29", "endDateTime": "2024-08-06 08:51:31" } }, { "id": "e6847d60432a02104fefe4511fb8f2c3", "prescribeAction": "null", "description": "send a warning to the system", "name": "packetdrop", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:50:53", "endDateTime": "2024-08-06 08:50:55" } } ] }, { "id": "cb55b5a0432a02104fefe4511fb8f201", "description": "", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "medium", "tolerancePeriod": "", "conformanceTargetUpper": "120", "conformanceComparatorUpper": "less than", "consequence": [] } ] }, { "id": "8f987524432a02104fefe4511fb8f2f0", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the upstream speed in the service", "metricName": "Upstream Speed", "name": "Upstream Speed", "unitOfMeasure": "a second", "valueType": "", "capturePeriod": "", "validFor": { "startDateTime": "", "endDateTime": "" }, "thresholdRule": [] } ], "specCharacteristic": [ { "name": "restart", "description": "restart", "valueType": "yes_no", "validFor": { "startDatetime": "2024-05-30 08:45:49" }, "characteristicValueSpecification": [ { "value": "No", }, { "value": "Yes", } ] } ], "serviceTestSpecRelationship": [ { "id": "76a3b160432a02104fefe4511fb8f2ad", "name": "OAM Test", "relationshipType": "" } ], "relatedServiceSpecification": [ { "id": "aeddcd1fb7d69910ff00f203ae11a990", "name": "Home Internet" } ] } Corps de réponse. { "description": "Upstream and Downstream speed ", "name": "Speed Test", "validFor": { "startDateTime": "2024-05-31", "endDateTime": "2024-06-27" }, "testMeasureDefinition": [ { "id": "1a04f560432a02104fefe4511fb8f2ad", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the downstream speed in a service", "metricName": "Downstream Speed", "name": "Downstream Speed", "unitOfMeasure": "a second", "valueType": "", "capturePeriod": "30 Minutes", "validFor": { "startDateTime": "2024-05-30 08:49:26", "endDateTime": "2024-05-31 08:49:29" }, "thresholdRule": [ { "id": "a754f960432a02104fefe4511fb8f2d0", "description": "This speed is greater than the target upper", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "high", "tolerancePeriod": "15 Minutes", "conformanceTargetLower": "75", "conformanceComparatorLower": "greater than", "consequence": [ { "id": "15a4bd60432a02104fefe4511fb8f2b8", "prescribeAction": "null", "description": "generate a waring report", "name": "degradedQualityOfService", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:51:29", "endDateTime": "2024-08-06 08:51:31" } }, { "id": "e6847d60432a02104fefe4511fb8f2c3", "prescribeAction": "null", "description": "send a warning to the system", "name": "packetdrop", "repeatAction": "0", "validFor": { "startDateTime": "2024-05-30 08:50:53", "endDateTime": "2024-08-06 08:50:55" } } ] }, { "id": "cb55b5a0432a02104fefe4511fb8f201", "description": "", "name": "InternetSpeedValue", "numberOfAllowedCrossing": "0", "thresholdRuleSeverity": "medium", "tolerancePeriod": "", "conformanceTargetUpper": "120", "conformanceComparatorUpper": "less than", "consequence": [] } ] }, { "id": "8f987524432a02104fefe4511fb8f2f0", "captureFrequency": "once", "captureMethod": "automatic", "metricDescription": "This is the upstream speed in the service", "metricName": "Upstream Speed", "name": "Upstream Speed", "unitOfMeasure": "a second", "valueType": "", "capturePeriod": "", "validFor": { "startDateTime": "", "endDateTime": "" }, "thresholdRule": [] } ], "specCharacteristic": [ { "name": "restart", "description": "restart", "valueType": "yes_no", "validFor": { "startDatetime": "2024-05-30 08:45:49" }, "characteristicValueSpecification": [ { "value": "No", "validFor": { "startDateTime": "", "endDateTime": "" } }, { "value": "Yes", "validFor": { "startDateTime": "", "endDateTime": "" } } ] } ], "serviceTestSpecRelationship": [ { "id": "76a3b160432a02104fefe4511fb8f2ad", "name": "OAM Test", "relationshipType": "" } ], "relatedServiceSpecification": [ { "id": "aeddcd1fb7d69910ff00f203ae11a990", "name": "Home Internet" } ] "id": "89d2b920432a02104fefe4511fb8f22e" }