--- 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 --- # Ticket de problème Ouvrir l'API # Ticket de problème Ouvrir l'API {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 52 minutes de lecture L'API Trouble Ticket Open fournit des points de terminaison pour créer, mettre à jour et récupérer des données à partir des tables Ticket \[sn_customerservice_case\] et Incident \[incident\]. Utilisez cette API pour gérer les informations de ticket entre les systèmes de création de tickets externes et le Now Platform. Cette API est incluse dans l'application [Telecommunications Assurance Workflows](https://store.servicenow.com/sn_appstore_store.do#!/store/application/9e07323d5b2110100206cb837b81c773) , disponible sur le ServiceNow Store. Les Service clientèle applications (com.sn_customerservice) et Gestion de la base d'installation du Service clientèle (com.snc.install_base) sont requises pour utiliser cette API avec la table Ticket \[sn_customerservice_case\]. Cette API est fournie dans l'espace de noms `sn_ind_tsm_sdwan` . L'utilisateur appelant doit avoir le rôle ticket_integrator. Cette API peut être étendue pour effectuer des personnalisations autour des paramètres requis, de la validation du corps de la demande, des opérations REST supplémentaires et des mappages de champs. Pour plus d'informations, voir le [Guide du développeur de l'API ouverte Trouble Ticket](https://servicenow-prod.fluidtopics.net/ivYXKcjMozdajf5Td4H7~Q#trouble-ticket_dev-guide "Utilisez l’API Trouble Ticket Open pour gérer les informations de ticket entre les systèmes de création de tickets externes et la Now Platform. Cette API crée, met à jour et récupère les données des tables Ticket [sn_customerservice_case] et Incident [incident]."). L'API Trouble Ticket Open est une ServiceNow® implémentation de la spécification REST de l'API TM Forum Trouble Ticket Management. Cette implémentation est basée sur la [spécification REST de l'API TMF621 Trouble Ticket Management Version 19, juin](https://www.tmforum.org/resources/specification/tmf621-trouble-ticket-management-api-rest-specification-r19-0-0/) 2019. La conformité de l'API Trouble Ticket Open est certifiée par TM Forum. ## Ticket de problème : GET /sn_ind_tsm_sdwan/ticket/troubleTicket {#ariaid-title2} Récupère une liste de tous les enregistrements de tickets d'incident des tables Ticket \[sn_customerservice_case\] et Incident \[incident\]. ### Format d'URL URL par défaut : /api/sn_ind_tsm_sdwan/ticket/troubleTicket ### Paramètres de demande pris en charge {#trouble-ticket-GET-ticket-tt__entry__2} | Nom | Description | |-|-| | Aucun | | [Tableau 1. Paramètres de chemin d'accès] {#trouble-ticket-GET-ticket-tt__entry__6} | Nom | Description | |-|-| | champs | Liste des champs à renvoyer dans la réponse. Les champs non valides sont ignorés. Champs valides : * canal * creationDate * description * href * id * lastUpdate (en anglais seulement) * nom * note * entité connexe * relatedParty * severity * statut * ticketType * @type {#trouble-ticket-GET-ticket-tt__ul_n1h_htz_54b} Par défaut : renvoie tous les champs. Type de données : chaîne | | id | Filtrer les tickets d'incident par sys_id. Seuls les tickets avec le sys_id spécifié sont renvoyés dans la réponse. 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 . Par défaut : 25 Maximum : 100 Vous pouvez modifier les valeurs maximales et par défaut en mettant à jour les sn_ind_tsm_sdwan.pagination.set_limit propriétés système and sn_ind_tsm_sdwan.pagination.max_limit . Type de données : nombre | | décalage | Index de départ auquel commencer à récupérer des enregistrements. Utilisez cette valeur pour paginer la récupération des enregistrements. Cette fonctionnalité permet de récupérer tous les enregistrements, quel que soit le nombre d'enregistrements, par petits blocs gérables. Par défaut : 0 Type de données : nombre | | severity | Filtrez les tickets d'incident par gravité. Seuls les tickets avec la gravité spécifiée sont renvoyés dans la réponse. Type de données : chaîne | | statut | Filtrez les tickets d'incident par état. Seuls les tickets avec l'état spécifié sont renvoyés dans la réponse. Type de données : chaîne | | ticketType | Filtrer les tickets d'incident par type de ticket. Seuls les tickets du type spécifié sont renvoyés dans la réponse. Valeurs valides : * Ticket * Incident {#trouble-ticket-GET-ticket-tt__ul_pb5_lk3_ktb} Type de données : chaîne | [Tableau 2. Paramètres de requête] {#trouble-ticket-GET-ticket-tt__entry__22} | Nom | Description | |-|-| | Aucun | | [Tableau 3. Paramètres du corps de la demande (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."). {#trouble-ticket-GET-ticket-tt__entry__26} | En-tête | Description | |-|-| | Aucun | | [Tableau 4. En-têtes de demandes] {#trouble-ticket-GET-ticket-tt__table_c2r_4gm_lsb__entry__2}{#trouble-ticket-GET-ticket-tt__content-range-row}{#trouble-ticket-GET-ticket-tt__content-type-row}{#trouble-ticket-GET-ticket-tt__links-pagination-row}{#trouble-ticket-GET-ticket-tt__x-total-count-descr} | 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. Ne prend en charge application/jsonque les fichiers . | | Lien | Contient les liens suivants pour parcourir les résultats de la requête. * premier * dernier * suivant * previous {#trouble-ticket-GET-ticket-tt__ul_zzk_sdm_lsb} | | 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] {#trouble-ticket-GET-ticket-tt__table_c2r_4gm_lsb} ### 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."). {#trouble-ticket-GET-ticket-tt__table_qbg_4cm_lsb__entry__2}{#trouble-ticket-GET-ticket-tt__tmf-get-status-200-p}{#trouble-ticket-GET-ticket-tt__tmf-get-status-206-entry}{#trouble-ticket-GET-ticket-tt__tmf-get-status-400-entry}{#trouble-ticket-GET-ticket-tt__tmf-get-status-404-entry} | Code d'état | Description | |-|-| | 200 | Demande traitée avec succès. Ressource complète renvoyée en réponse (aucune pagination). | | 206 | Ressource partielle renvoyée en réponse (avec pagination). | | 400 | Demande incorrecte. Raisons possibles : * Paramètre de chemin d'accès non valide * URI non valide {#trouble-ticket-GET-ticket-tt__ul_rys_1gy_fsb} | | 404 | Enregistrement introuvable. Aucun enregistrement correspondant aux paramètres de requête n'a été trouvé dans la table. | [Tableau 6. Codes d'état] {#trouble-ticket-GET-ticket-tt__table_qbg_4cm_lsb} ### Paramètres de corps de réponse (JSON) {#trouble-ticket-GET-ticket-tt__section_mgj_t43_ktb} {#trouble-ticket-GET-ticket-tt__table_n4d_yvm_5pb__entry__2} | Nom | Description | |-|-| | canal | Méthode de contact par laquelle le ticket a été créé. Type de données : objet "channel":{ "name": "String" } | | channel.name | Nom de la méthode de contact. Mappe au champ Canal \[contact_type\] pour les tickets et au champ Type de contact \[contact_type\] pour les incidents. Type de données : chaîne | | creationDate | Date à laquelle l'enregistrement du ticket ou de l'incident a été créé. Mappe au champ Créé . Type de données : chaîne | | description | Description du problème à partir du ticket. Mappe au champ Description . Type de données : chaîne | | href | Lien relatif à l'enregistrement du ticket ou de l'incident. Type de données : chaîne | | id | sys_id de l'enregistrement du ticket ou de l'incident. Type de données : chaîne | | lastUpdate (en anglais seulement) | Date de dernière mise à jour de l'enregistrement. Mappe vers le champ Mis à jour . Type de données : chaîne | | nom | Nom du ticket d'incident, généralement une brève description du problème. Mappe au champ Brève description . Type de données : chaîne | | note | Liste de tous les commentaires sur le ticket. Cette liste n'inclut pas les notes de travail. Type de données : tableau "note":[ { "author": "String", "date": "String", "text": "String", "@type": "String" } ] | | note.@type | Le type de note. Seuls les commentaires sont renvoyés (pas les notes de travail), cette valeur est donc toujours des `commentaires`. Type de données : chaîne | | note.auteur | Nom de l'utilisateur ServiceNow d'intégration qui a effectué la demande POST ou PATCH qui a créé le commentaire. Type de données : chaîne | | note.date | Date à laquelle le commentaire a été créé dans l'instance ServiceNow . Type de données : chaîne | | note.texte | Le texte du commentaire. Type de données : chaîne | | entité connexe | Liste des actifs, produits, produits vendus (inventaire de produits), éléments de configuration ou services affectés. Type de données : tableau "relatedEntity": [ { "id": "String", "href": "String", "name": "String", "role": "String", "@referredType": "String", "@type": "String" } ] | | relatedEntity.id | Sys_id de l'élément ou du service impacté. Pour les tickets, cette valeur provient de l'une des tables suivantes : * Actif \[alm_asset\] * Modèle de produit \[cmdb_model\] * Produit vendu \[sn_install_base_sold_product\] * Inventaire des produits \[sn_prd_invt_product_inventory\], qui étend la table Produit vendu \[sn_install_base_sold_product\] {#trouble-ticket-GET-ticket-tt__ul_en1_3jc_hwb}Pour les incidents, cette valeur provient de l'une des tables suivantes : * Élément de configuration \[cmdb_ci\] * Service \[cmdb_ci_service\] {#trouble-ticket-GET-ticket-tt__ul_fn1_3jc_hwb} Type de données : chaîne | | relatedEntity.href | Renvoie une chaîne vide. Type de données : chaîne | | relatedEntity.name | Nom de l'élément ou du service impacté. Type de données : chaîne | | relatedEntity.role | Description de l'élément ou du service impacté. Type de données : chaîne | | relatedEntity.@referredType | Le type d'élément ou de service. Valeurs valides pour les tickets de ticket : * asset * Produit * product_inventory {#trouble-ticket-GET-ticket-tt__ul_zrm_5jp_mtb} Valeurs valides pour les tickets d'incident : * cmdb_ci * cmdb_ci_service {#trouble-ticket-GET-ticket-tt__ul_asm_5jp_mtb} Type de données : chaîne | | relatedEntity.@type | Cette valeur est toujours `relatedEntity`. Type de données : chaîne | | relatedParty | Détails sur les contacts pour le ticket. Type de données : tableau "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String" } ] | | relatedParty.id | Sys_id de la partie liée. Les sys_id peuvent provenir des tables suivantes en fonction du type de ticket et du type de partie connexe. Ticket : * Compte \[customer_account\] : le type de partie connexe est client * Contact \[customer_contact\] : le type de partie connexe est customer_contact {#trouble-ticket-GET-ticket-tt__ul_vf5_n3g_4tb} Incident: * Société \[core_company\] : le type de partie connexe est client * Utilisateur \[sys_user\] : le type de partie connexe est customer_contact {#trouble-ticket-GET-ticket-tt__ul_ll2_p3g_4tb} Ticket ou incident : * Groupe \[sys_user_group\] : le type de partie connexe est assignment_group * Utilisateur \[sys_user\] : le type de partie connexe est assigned_to {#trouble-ticket-GET-ticket-tt__ul_umf_r3g_4tb} Type de données : chaîne | | relatedParty.name | Nom de la partie connexe. Type de données : chaîne | | relatedParty.@referredType | Type de partie liée. Valeurs possibles : * assigned_to : l'utilisateur affecté pour travailler sur le ticket. * assignment_group : le groupe affecté pour travailler sur le ticket. * client : la société ou le compte du billet. * customer_contact : l'appelant ou le contact pour le ticket. {#trouble-ticket-GET-ticket-tt__ul_bxv_jgg_4tb} Type de données : chaîne | | severity | La gravité du problème décrit par le ticket d'incident. Mappe au champ Priorité. Type de données : chaîne | | statut | L'état actuel du ticket de problème. Mappe au champ État . Type de données : chaîne | | ticketType | Le type de billet. Valeurs possibles : * Ticket * Incident {#trouble-ticket-GET-ticket-tt__ul_czp_2mc_ktb} Type de données : chaîne | | @type | Cette valeur est toujours `TroubleTicket`. Type de données : chaîne | [ ] {#trouble-ticket-GET-ticket-tt__table_n4d_yvm_5pb} ### Demande cURL Cet exemple renvoie des champs spécifiés pour les cinq premiers enregistrements de tickets de ticket d'incident. curl "https://instance.servicenow.com/api/sn_ind_tsm_sdwan/ticket/troubleTicket?limit=5&fields=id%2Cname%2Cdescription%2Cstatus%2Cseverity%2CticketType&ticketType=case" \ --request GET \ --user 'username':'password' Corps de réponse. [ { "id": "0004609eb9830110f877b3758cd21d37", "name": "Compliant Over 2796", "description": "checkNo2796", "status": "New", "severity": "3 - Moderate", "ticketType": "Case" }, { "id": "000560d2b9c30110f877b3758cd21d36", "name": "Compliant Over 4696", "description": "checkNo4696", "status": "New", "severity": "3 - Moderate", "ticketType": "Case" }, { "id": "0007ac5eb9c30110f877b3758cd21d34", "name": "Compliant Over 8817", "description": "checkNo8817", "status": "New", "severity": "3 - Moderate", "ticketType": "Case" }, { "id": "0007ac5eb9c30110f877b3758cd21d39", "name": "Compliant Over 8819", "description": "checkNo8819", "status": "New", "severity": "3 - Moderate", "ticketType": "Case" }, { "id": "0007ac5eb9c30110f877b3758cd21d3e", "name": "Compliant Over 8821", "description": "checkNo8821", "status": "New", "severity": "3 - Moderate", "ticketType": "Case" } ] ## Ticket de problème : GET /sn_ind_tsm_sdwan/ticket/troubleTicket/{id} {#ariaid-title3} Récupère un enregistrement spécifié de la table Ticket \[sn_customerservice_case\] ou Incident \[incident\]. ### Format d'URL {#trouble-ticket-GET-ticket-tt-id__section_fcs_wqm_5pb} URL par défaut : /api/sn_ind_tsm_sdwan/ticket/troubleTicket/{id} ### Paramètres de demande pris en charge {#trouble-ticket-GET-ticket-tt-id__table_ufw_yqm_5pb__entry__2} | Nom | Description | |-|-| | id | Sys_id de l'enregistrement de ticket ou d'incident à récupérer. Situé dans la table Ticket \[sn_customerservice_case\] ou Incident \[incident\]. Type de données : chaîne | [Tableau 7. Paramètres de chemin d'accès] {#trouble-ticket-GET-ticket-tt-id__table_ufw_yqm_5pb} {#trouble-ticket-GET-ticket-tt-id__table_cn5_zqm_5pb__entry__2} | Nom | Description | |-|-| | champs | Liste des champs à renvoyer dans la réponse. Les champs non valides sont ignorés. Valeurs valides : * canal * creationDate * description * href * id * lastUpdate (en anglais seulement) * nom * note * entité connexe * relatedParty * severity * statut * ticketType * @type {#trouble-ticket-GET-ticket-tt-id__ul_n1h_htz_54b} Par défaut : renvoie tous les champs. Type de données : chaîne | [Tableau 8. Paramètres de requête] {#trouble-ticket-GET-ticket-tt-id__table_cn5_zqm_5pb} {#trouble-ticket-GET-ticket-tt-id__entry__10} | Nom | Description | |-|-| | Aucun | | [Tableau 9. Paramètres du corps de la demande (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."). {#trouble-ticket-GET-ticket-tt-id__entry__14}{#trouble-ticket-GET-ticket-tt-id__accept-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. | [Tableau 10. En-têtes de demandes] {#trouble-ticket-GET-ticket-tt-id__entry__18} | En-tête | Description | |-|-| | Aucun | | [Tableau 11. 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."). {#trouble-ticket-GET-ticket-tt-id__entry__22}{#trouble-ticket-GET-ticket-tt-id__entry-200-status-code} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Un type de demande incorrect ou une demande mal formée a été détecté pour une ou plusieurs des raisons suivantes. * Paramètre de chemin d'accès non valide. * URI non valide. {#trouble-ticket-GET-ticket-tt-id__ul_rjf_fqw_rpb} | | 404 | Enregistrement introuvable. Un enregistrement associé à l'ID est introuvable dans la table Ticket \[sn_customerservice_case\] ou Incident \[incident\]. | [Tableau 12. Codes d'état] ### Paramètres de corps de réponse (JSON) {#trouble-ticket-GET-ticket-tt-id__table_n4d_yvm_5pb__entry__2} | Nom | Description | |-|-| | canal | Méthode de contact par laquelle le ticket a été créé. Type de données : objet "channel":{ "name": "String" } | | channel.name | Nom de la méthode de contact. Mappe au champ Canal \[contact_type\] pour les tickets et au champ Type de contact \[contact_type\] pour les incidents. Type de données : chaîne | | creationDate | Date à laquelle l'enregistrement du ticket ou de l'incident a été créé. Mappe au champ Créé . Type de données : chaîne | | description | Description du problème à partir du ticket. Mappe au champ Description . Type de données : chaîne | | href | Lien relatif à l'enregistrement du ticket ou de l'incident. Type de données : chaîne | | id | sys_id de l'enregistrement du ticket ou de l'incident. Type de données : chaîne | | lastUpdate (en anglais seulement) | Date de dernière mise à jour de l'enregistrement. Mappe vers le champ Mis à jour . Type de données : chaîne | | nom | Nom du ticket d'incident, généralement une brève description du problème. Mappe au champ Brève description . Type de données : chaîne | | note | Liste de tous les commentaires sur le ticket. Cette liste n'inclut pas les notes de travail. Type de données : tableau "note":[ { "author": "String", "date": "String", "text": "String", "@type": "String" } ] | | note.@type | Le type de note. Seuls les commentaires sont renvoyés (pas les notes de travail), cette valeur est donc toujours des `commentaires`. Type de données : chaîne | | note.auteur | Nom de l'utilisateur qui a écrit le commentaire. Type de données : chaîne | | note.date | Date à laquelle le commentaire a été créé dans l'instance ServiceNow . Type de données : chaîne | | note.texte | Le texte du commentaire. Type de données : chaîne | | entité connexe | Liste des actifs, produits, produits vendus (inventaire de produits), éléments de configuration ou services affectés. Type de données : tableau "relatedEntity": [ { "id": "String", "href": "String", "name": "String", "role": "String", "@referredType": "String", "@type": "String" } ] | | relatedEntity.id | Sys_id de l'élément ou du service impacté. Pour les tickets, cette valeur provient de l'une des tables suivantes : * Actif \[alm_asset\] * Modèle de produit \[cmdb_model\] * Produit vendu \[sn_install_base_sold_product\] * Inventaire des produits \[sn_prd_invt_product_inventory\], qui étend la table Produit vendu \[sn_install_base_sold_product\] {#trouble-ticket-GET-ticket-tt-id__ul_en1_3jc_hwb}Pour les incidents, cette valeur provient de l'une des tables suivantes : * Élément de configuration \[cmdb_ci\] * Service \[cmdb_ci_service\] {#trouble-ticket-GET-ticket-tt-id__ul_fn1_3jc_hwb} Type de données : chaîne | | relatedEntity.href | Renvoie une chaîne vide. Type de données : chaîne | | relatedEntity.name | Nom de l'élément ou du service impacté. Type de données : chaîne | | relatedEntity.role | Description de l'élément ou du service impacté. Type de données : chaîne | | relatedEntity.@referredType | Le type d'élément ou de service. Valeurs valides pour les tickets de ticket : * asset * Produit * product_inventory {#trouble-ticket-GET-ticket-tt-id__ul_zrm_5jp_mtb} Valeurs valides pour les tickets d'incident : * cmdb_ci * cmdb_ci_service {#trouble-ticket-GET-ticket-tt-id__ul_asm_5jp_mtb} Type de données : chaîne | | relatedEntity.@type | Cette valeur est toujours `relatedEntity`. Type de données : chaîne | | relatedParty | Détails sur les contacts pour le ticket. Type de données : tableau "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String" } ] | | relatedParty.id | Sys_id de la partie liée. Les sys_id peuvent provenir des tables suivantes en fonction du type de ticket et du type de partie connexe. Ticket : * Compte \[customer_account\] : le type de partie connexe est client * Contact \[customer_contact\] : le type de partie connexe est customer_contact {#trouble-ticket-GET-ticket-tt-id__ul_vf5_n3g_4tb} Incident: * Société \[core_company\] : le type de partie connexe est client * Utilisateur \[sys_user\] : le type de partie connexe est customer_contact {#trouble-ticket-GET-ticket-tt-id__ul_ll2_p3g_4tb} Ticket ou incident : * Groupe \[sys_user_group\] : le type de partie connexe est assignment_group * Utilisateur \[sys_user\] : le type de partie connexe est assigned_to {#trouble-ticket-GET-ticket-tt-id__ul_umf_r3g_4tb} Type de données : chaîne | | relatedParty.name | Nom de la partie connexe. Type de données : chaîne | | relatedParty.@referredType | Type de partie liée. Valeurs possibles : * assigned_to : l'utilisateur affecté pour travailler sur le ticket. * assignment_group : le groupe affecté pour travailler sur le ticket. * client : la société ou le compte du billet. * customer_contact : l'appelant ou le contact pour le ticket. {#trouble-ticket-GET-ticket-tt-id__ul_bxv_jgg_4tb} Type de données : chaîne | | severity | La gravité du problème décrit par le ticket d'incident. Mappe au champ Priorité. Type de données : chaîne | | statut | L'état actuel du ticket de problème. Mappe au champ État . Type de données : chaîne | | ticketType | Le type de billet. Valeurs possibles : * Ticket * Incident {#trouble-ticket-GET-ticket-tt-id__ul_czp_2mc_ktb} Type de données : chaîne | | @type | Cette valeur est toujours `TroubleTicket`. Type de données : chaîne | [ ] {#trouble-ticket-GET-ticket-tt-id__table_n4d_yvm_5pb} ### Demande cURL Cet exemple récupère un enregistrement de ticket d'incident à partir de la table Ticket \[sn_customerservice_case\]. curl "https://instance.servicenow.com/api/sn_ind_tsm_sdwan/ticket/troubleTicket/6467508d47e345508761b955d36d43f6" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' Corps de réponse. { "id": "370415f03c20e910f8772f1bc332b31b", "href": "/api/sn_ind_tsm_sdwan/ticket/troubleTicket/370415f03c20e910f8772f1bc332b31b", "creationDate": "2023-01-19 22:39:28", "lastUpdate": "2023-01-19 22:41:39", "description": "Router is not working, my devices cannot detect any signals from the router. First button from the left is flashing red, all others are black. Resetting the router does not solve the problem, I need urgent assistance.", "severity": "2 - High", "ticketType": "Case", "name": "My router is not working properly", "status": "Open", "channel": { "name": "e_bonding" }, "relatedParty": [ { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@referredType": "customer" }, { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@referredType": "customer_contact" }, { "id": "", "name": "", "@referredType": "assignment_group" }, { "id": "", "name": "", "@referredType": "assigned_to" } ], "relatedEntity": [ { "id": "b7fa12c7532520103b6bddeeff7b123b", "href": "", "name": "Deduplication and Compression PRD00001965", "role": "This is the product associated with the case.", "@type": "relatedEntity", "@referredType": "product" }, { "id": "71e73d87c3e23010ff00ed23a140dde8", "href": "", "name": "", "role": "This is the asset associated with the case.", "@type": "relatedEntity", "@referredType": "asset" }, { "id": "a1913c3577b301108e191e599a5a99e8", "href": "", "name": "Deduplication and Compression PI0000037", "role": "This is the product inventory associated with the case.", "@type": "relatedEntity", "@referredType": "product_inventory" } ], "note": [ { "text": "This is a testing comment", "date": "2023-01-19 14:41:39", "author": "System Administrator", "@type": "comments" }, { "text": "This is a testing comment", "date": "2023-01-19 14:39:28", "author": "System Administrator", "@type": "comments" } ], "@type": "TroubleTicket" } ## Ticket de problème : GET /sn_ind_tsm_sdwan/troubleticket/{ticketType}/{id} {#ariaid-title4} Récupère un enregistrement spécifié de la table Ticket \[sn_customerservice_case\] ou Incident \[incident\]. Important : Ce point de terminaison est obsolète à partir de la Tokyo mise en production. La nouvelle version de ce point de terminaison est [Ticket de problème : GET /sn_ind_tsm_sdwan/ticket/troubleTicket/{id}](https://servicenow-prod.fluidtopics.net/Bp~JY2CqIkKe3YcQyp53cg#trouble-ticket-GET-ticket-tt-id "Récupère un enregistrement spécifié de la table Ticket [sn_customerservice_case] ou Incident [incident]."). ### Format d'URL {#trouble-ticket-GET-trouble_ticket__section_fcs_wqm_5pb} URL par défaut : /api/sn_ind_tsm_sdwan/troubleticket/{ticketType}/{id} ### Paramètres de demande pris en charge {#trouble-ticket-GET-trouble_ticket__table_ufw_yqm_5pb__entry__2} | Nom | Description | |-|-| | ticketType | Le type de billet. Cette valeur détermine si un enregistrement est récupéré à partir de la table Ticket \[sn_customerservice_case\] ou Incident \[incident\]. Valeurs valides : * ticket * incident {#trouble-ticket-GET-trouble_ticket__ul_k1m_qvs_qpb} Type de données : chaîne | | id | Sys_id de l'enregistrement de ticket ou d'incident à récupérer. Type de données : chaîne | [Tableau 13. Paramètres de chemin d'accès] {#trouble-ticket-GET-trouble_ticket__table_ufw_yqm_5pb} {#trouble-ticket-GET-trouble_ticket__table_cn5_zqm_5pb__entry__2} | Nom | Description | |-|-| | champs | Liste des champs séparés par des virgules à envoyer dans la réponse. Les champs non valides sont ignorés. Si cette valeur n'est pas transmise, tous les champs sont renvoyés. Champs valides : * canal * creationDate * description * id * lastUpdate (en anglais seulement) * nom * note * entité connexe * relatedParty * severity * statut * ticketType * @type {#trouble-ticket-GET-trouble_ticket__ul_n1h_htz_54b} Type de données : chaîne | [Tableau 14. Paramètres de requête] {#trouble-ticket-GET-trouble_ticket__table_cn5_zqm_5pb} {#trouble-ticket-GET-trouble_ticket__entry__12} | Nom | Description | |-|-| | Aucun | | [Tableau 15. 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."). {#trouble-ticket-GET-trouble_ticket__entry__16}{#trouble-ticket-GET-trouble_ticket__accept-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. | [Tableau 16. En-têtes de demandes] {#trouble-ticket-GET-trouble_ticket__entry__20} | En-tête | Description | |-|-| | Aucun | | [Tableau 17. 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."). {#trouble-ticket-GET-trouble_ticket__entry__24}{#trouble-ticket-GET-trouble_ticket__entry-200-status-code} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Un type de demande incorrect ou une demande mal formée a été détecté pour une ou plusieurs des raisons suivantes. * Paramètre de chemin d'accès non valide. * URI non valide. {#trouble-ticket-GET-trouble_ticket__ul_rjf_fqw_rpb} | | 404 | Enregistrement introuvable. Un enregistrement associé à l'ID est introuvable dans la table Ticket \[sn_customerservice_case\] ou Incident \[incident\]. | [Tableau 18. Codes d'état] ### Paramètres du corps de réponse (JSON ou XML) {#trouble-ticket-GET-trouble_ticket__table_n4d_yvm_5pb__entry__2} | Nom | Description | |-|-| | @type | Cette valeur est toujours `TroubleTicket`. Type de données : chaîne | | canal | Méthode de contact par laquelle le ticket a été créé. Type de données : objet "channel":{ "name": "String" } | | channel.name | Nom de la méthode de contact. Mappe au champ Canal \[contact_type\] pour les tickets et au champ Type de contact \[contact_type\] pour les incidents. Type de données : chaîne | | creationDate | Date à laquelle l'enregistrement du ticket ou de l'incident a été créé. Mappe au champ Créé . Type de données : chaîne | | description | Description du problème à partir du ticket. Mappe au champ Description . Type de données : chaîne | | id | sys_id de l'enregistrement du ticket ou de l'incident. Type de données : chaîne | | lastUpdate (en anglais seulement) | Date de dernière mise à jour de l'enregistrement. Mappe vers le champ Mis à jour . Type de données : chaîne | | nom | Nom du ticket d'incident, généralement une brève description du problème. Mappe au champ Brève description . Type de données : chaîne | | note | Liste de tous les commentaires sur le ticket. Cette liste n'inclut pas les notes de travail. Type de données : tableau "note":[ { "author": "String", "date": "String", "text": "String", "@type": "String" } ] | | note.@type | Le type de note. Seuls les commentaires sont renvoyés (pas les notes de travail), cette valeur est donc toujours des `commentaires`. Type de données : chaîne | | note.auteur | Nom de l'utilisateur d'intégration ServiceNow qui a effectué la demande POST ou PATCH qui a créé le commentaire. Type de données : chaîne | | note.date | Date à laquelle le commentaire a été créé dans l'instance ServiceNow. Type de données : chaîne | | note.texte | Le texte du commentaire. Type de données : chaîne | | entité connexe | Liste des actifs, produits, produits vendus (inventaire de produits), éléments de configuration ou services affectés. Type de données : tableau "relatedEntity": [ { "id": "String", "href": "String", "name": "String", "role": "String", "@referredType": "String", "@type": "String" } ] | | relatedEntity.id | Sys_id de l'élément ou du service impacté. Pour les tickets, cette valeur provient de l'une des tables suivantes : * Actif \[alm_asset\] * Modèle de produit \[cmdb_model\] * Produit vendu \[sn_install_base_sold_product\] * Inventaire des produits \[sn_prd_invt_product_inventory\], qui étend la table Produit vendu \[sn_install_base_sold_product\] {#trouble-ticket-GET-trouble_ticket__ul_en1_3jc_hwb}Pour les incidents, cette valeur provient de l'une des tables suivantes : * Élément de configuration \[cmdb_ci\] * Service \[cmdb_ci_service\] {#trouble-ticket-GET-trouble_ticket__ul_fn1_3jc_hwb} Type de données : chaîne | | relatedEntity.href | Renvoie une chaîne vide. Type de données : chaîne | | relatedEntity.name | Nom de l'élément ou du service impacté. Type de données : chaîne | | relatedEntity.role | Description de l'élément ou du service impacté. Type de données : chaîne | | relatedEntity.@referredType | Le type d'élément ou de service. Valeurs valides pour les tickets de ticket : * asset * Produit * product_inventory {#trouble-ticket-GET-trouble_ticket__ul_zrm_5jp_mtb} Valeurs valides pour les tickets d'incident : * cmdb_ci * cmdb_ci_service {#trouble-ticket-GET-trouble_ticket__ul_asm_5jp_mtb} Type de données : chaîne | | relatedEntity.@type | Cette valeur est toujours `relatedEntity`. Type de données : chaîne | | relatedParty | Détails sur les sociétés et les contacts associés au billet. Type de données : tableau "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String" } ] | | relatedParty.@referredType | Type de partie liée. Valeurs valides : * client : la société ou le compte du billet. * customer_contact : l'appelant ou le contact pour le ticket. {#trouble-ticket-GET-trouble_ticket__ul_sfh_g3j_5pb} Type de données : chaîne | | relatedParty.id | Sys_id de la partie liée. Pour les tickets, le sys_id provient des tables Contact \[customer_contact\] ou Compte \[customer_account\]. Pour les incidents, le sys_id provient des tables Utilisateur \[sys_user\] ou Entreprise \[core_company\]. Si vous fournissez un contact ou un utilisateur (appelant), son compte ou sa société est automatiquement renseigné sur le ticket. Type de données : chaîne | | relatedParty.name | Nom de la partie connexe. Pour les tickets, est mappé au champ Contact ou Compte . Pour les incidents, est mappé au champ Appelant ou Société . Type de données : chaîne | | severity | La gravité du problème décrit par le ticket d'incident. Mappe au champ Priorité. Type de données : chaîne | | statut | L'état actuel du ticket de problème. Mappe au champ État . Type de données : chaîne | | ticketType | Type de ticket (ticket ou incident). Type de données : chaîne | [ ] {#trouble-ticket-GET-trouble_ticket__table_n4d_yvm_5pb} ### Demande cURL Cet exemple permet d'obtenir le nom, la description, la gravité et l'état d'un ticket. curl "https://instance.servicenow.com/api/sn_ind_tsm_sdwan/troubleticket/case/a78e2c8cdb68b41015364c9b0b96193e?fields=name%2Cdescription%2Cseverity%2Cstatus" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' Corps de réponse. { "name": "Short description of issue", "description": "Example description of an issue", "severity": "2 - High", "status": "Open" } ## Ticket de problème : PATCH /sn_ind_tsm_sdwan/ticket/troubleTicket/{id} {#ariaid-title5} Met à jour un enregistrement spécifié dans la table Ticket \[sn_customerservice_case\] ou Incident \[incident\]. ### Format d'URL URL par défaut : /api/sn_ind_tsm_sdwan/ticket/troubleTicket/{id} ### Paramètres de demande pris en charge {#trouble-ticket-PATCH-ticket-tt__entry__2} | Nom | Description | |-|-| | id | Sys_id de l'enregistrement de ticket ou d'incident à mettre à jour. Situé dans la table Ticket \[sn_customerservice_case\] ou Incident \[incident\]. Type de données : chaîne | [Tableau 19. Paramètres de chemin d'accès] {#trouble-ticket-PATCH-ticket-tt__entry__6} | Nom | Description | |-|-| | Aucun | | [Tableau 20. Paramètres de requête] {#trouble-ticket-PATCH-ticket-tt__entry__10} | Nom | Description | |-|-| | canal | Méthode de contact par laquelle le ticket a été créé. Type de données : objet "channel":{ "name": "String" } | | channel.name | Nom de la méthode de contact. Mappe au champ Canal \[contact_type\] pour les tickets et au champ Type de contact \[contact_type\] pour les incidents. Les valeurs valides sont les choix pour le champ contact_type. Vous pouvez fournir l'étiquette ou la valeur de choix. Par exemple, `Agent virtuel` ou `virtual_agent`. Type de données : chaîne | | description | Description du problème. Mappe au champ Description . Type de données : chaîne | | nom | Nom du ticket d'incident, généralement une brève description du problème. Mappe au champ Brève description . Type de données : chaîne | | note | Une liste des notes de travail et des commentaires à ajouter au ticket. Type de données : tableau "note":[ { "text": "String", "@type": "String" } ] | | note.@type | Le type de note. Cette valeur détermine si la note est enregistrée dans le champ Notes de travail ou Commentaires supplémentaires . Valeurs valides : * work_notes * commentaires {#trouble-ticket-PATCH-ticket-tt__ul_vtx_hmz_rpb} Type de données : chaîne | | note.texte | Texte de la note. Mappe au champ Notes de travail ou Commentaires supplémentaires . Type de données : chaîne | | entité connexe | Liste des actifs, produits, produits vendus (inventaire de produits), éléments de configuration ou services affectés. Type de données : tableau "relatedEntity": [ { "id": "String", "@referredType": "String" } ] | | relatedEntity.id | Sys_id de l'élément ou du service impacté. Pour les tickets, cette valeur provient de l'une des tables suivantes : * Actif \[alm_asset\] * Modèle de produit \[cmdb_model\] * Produit vendu \[sn_install_base_sold_product\] * Inventaire des produits \[sn_prd_invt_product_inventory\], qui étend la table Produit vendu \[sn_install_base_sold_product\] {#trouble-ticket-PATCH-ticket-tt__ul_vl4_13c_hwb}Pour les incidents, cette valeur provient de l'une des tables suivantes : * Élément de configuration \[cmdb_ci\] * Service \[cmdb_ci_service\] {#trouble-ticket-PATCH-ticket-tt__ul_lbg_b3c_hwb} Type de données : chaîne | | relatedEntity.@referredType | Le type d'élément ou de service. Valeurs valides pour les tickets de ticket : * asset * Produit * product_inventory {#trouble-ticket-PATCH-ticket-tt__ul_bjm_lfy_wsb} Valeurs valides pour les tickets d'incident : * cmdb_ci * cmdb_ci_service {#trouble-ticket-PATCH-ticket-tt__ul_sfh_g3j_5pa} Type de données : chaîne | | relatedParty | Détails sur les contacts pour le ticket. Pour les tickets, ce paramètre renseigne le champ Contact ou Compte . Pour les incidents, ce paramètre renseigne le champ Appelant ou Société . Type de données : tableau "relatedParty": [ { "id": "String", "@referredType": "String" } ] | | relatedParty.id | Sys_id de la partie liée. Pour les tickets, le sys_id provient des tables Contact \[customer_contact\] ou Compte \[customer_account\]. Pour les incidents, le sys_id provient des tables Utilisateur \[sys_user\] ou Entreprise \[core_company\]. Si vous fournissez un contact ou un utilisateur (appelant), son compte ou sa société est automatiquement renseigné sur le ticket. Type de données : chaîne | | relatedParty.@referredType | Type de partie liée. Valeurs valides : * client : la société ou le compte du billet. * customer_contact : l'appelant ou le contact pour le ticket. {#trouble-ticket-PATCH-ticket-tt__ul_sfh_g3j_5pb} Type de données : chaîne | | severity | La gravité du problème décrit par le ticket d'incident. Mappe au champ Priorité. Valeurs valides : * 1 : Critique. * 2 : Élevée. * 3 : Modérée. * 4 : Faible. * 5 : Planification. Incident uniquement. {#trouble-ticket-PATCH-ticket-tt__ul_xhd_24p_rpb}Les valeurs valides sont les choix pour le champ Priorité . Vous devez fournir uniquement la valeur de choix. Par exemple, `1`. Si une valeur non valide est fournie, la gravité est définie sur Faible. Type de données : chaîne | | statut | L'état actuel du ticket de problème. Mappe au champ État . Les valeurs valides sont les choix pour le champ État . Vous pouvez fournir l'étiquette ou la valeur de choix. Par exemple, `Nouveau` ou `1`. Type de données : chaîne | [Tableau 21. Paramètres du corps de la demande (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."). {#trouble-ticket-PATCH-ticket-tt__entry__42}{#trouble-ticket-PATCH-ticket-tt__accept-JSON-only-entry-RESTAPI}{#trouble-ticket-PATCH-ticket-tt__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 22. En-têtes de demandes] {#trouble-ticket-PATCH-ticket-tt__entry__48} | En-tête | Description | |-|-| | Aucun | | [Tableau 23. 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."). {#trouble-ticket-PATCH-ticket-tt__entry__52}{#trouble-ticket-PATCH-ticket-tt__entry-200-status-code} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Un type de demande incorrect ou une demande mal formée a été détecté pour une ou plusieurs des raisons suivantes. * Paramètre de chemin d'accès non valide. * URI non valide. {#trouble-ticket-PATCH-ticket-tt__ul_rjf_fqw_rpb} | | 404 | Enregistrement introuvable. Un enregistrement associé à l'ID est introuvable dans la table Ticket \[sn_customerservice_case\] ou Incident \[incident\]. | [Tableau 24. Codes d'état] ### Paramètres de corps de réponse (JSON) {#trouble-ticket-PATCH-ticket-tt__entry__60} | Nom | Description | |-|-| | canal | Méthode de contact par laquelle le ticket a été créé. Type de données : objet "channel":{ "name": "String" } | | channel.name | Nom de la méthode de contact. Type de données : chaîne | | creationDate | Date de création de l'enregistrement. Type de données : chaîne | | description | Description du problème à partir du ticket. Type de données : chaîne | | href | Lien relatif à l'enregistrement du ticket ou de l'incident. Type de données : chaîne | | id | sys_id de l'enregistrement du ticket ou de l'incident. Type de données : chaîne | | lastUpdate (en anglais seulement) | Date de dernière mise à jour de l'enregistrement. Type de données : chaîne | | nom | Nom du ticket d'incident, généralement une brève description du problème. Type de données : chaîne | | note | Liste de tous les commentaires sur le ticket. Cette liste n'inclut pas les notes de travail. Type de données : tableau "note":[ { "author": "String", "date": "String", "text": "String", "@type": "String" } ] | | note.@type | Le type de note. Seuls les commentaires sont renvoyés (pas les notes de travail), cette valeur est donc toujours des `commentaires`. Type de données : chaîne | | note.auteur | Nom de l'utilisateur qui a écrit le commentaire. Type de données : chaîne | | note.date | Date à laquelle le commentaire a été créé dans l'instance ServiceNow . Type de données : chaîne | | note.texte | Le texte du commentaire. Type de données : chaîne | | entité connexe | Liste des actifs, produits, produits vendus (inventaire de produits), éléments de configuration ou services affectés. Type de données : tableau "relatedEntity": [ { "id": "String", "href": "String", "name": "String", "role": "String", "@referredType": "String", "@type": "String" } ] | | relatedEntity.id | Sys_id de l'élément ou du service impacté. Pour les tickets, cette valeur provient de l'une des tables suivantes : * Actif \[alm_asset\] * Modèle de produit \[cmdb_model\] * Produit vendu \[sn_install_base_sold_product\] * Inventaire des produits \[sn_prd_invt_product_inventory\], qui étend la table Produit vendu \[sn_install_base_sold_product\] {#trouble-ticket-PATCH-ticket-tt__ul_en1_3jc_hwb}Pour les incidents, cette valeur provient de l'une des tables suivantes : * Élément de configuration \[cmdb_ci\] * Service \[cmdb_ci_service\] {#trouble-ticket-PATCH-ticket-tt__ul_fn1_3jc_hwb} Type de données : chaîne | | relatedEntity.href | Renvoie une chaîne vide. Type de données : chaîne | | relatedEntity.name | Nom de l'élément ou du service impacté. Type de données : chaîne | | relatedEntity.role | Description de l'élément ou du service impacté. Type de données : chaîne | | relatedEntity.@referredType | Le type d'élément ou de service. Valeurs valides pour les tickets de ticket : * asset * Produit * product_inventory {#trouble-ticket-PATCH-ticket-tt__ul_zrm_5jp_mtb} Valeurs valides pour les tickets d'incident : * cmdb_ci * cmdb_ci_service {#trouble-ticket-PATCH-ticket-tt__ul_asm_5jp_mtb} Type de données : chaîne | | relatedEntity.@type | Cette valeur est toujours `relatedEntity`. Type de données : chaîne | | relatedParty | Détails sur les contacts pour le ticket. Type de données : tableau "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String" } ] | | relatedParty.id | Sys_id de la partie liée. Les sys_id peuvent provenir des tables suivantes en fonction du type de ticket et du type de partie connexe. Ticket : * Compte \[customer_account\] : le type de partie connexe est client * Contact \[customer_contact\] : le type de partie connexe est customer_contact {#trouble-ticket-PATCH-ticket-tt__ul_vf5_n3g_4tb} Incident: * Société \[core_company\] : le type de partie connexe est client * Utilisateur \[sys_user\] : le type de partie connexe est customer_contact {#trouble-ticket-PATCH-ticket-tt__ul_ll2_p3g_4tb} Ticket ou incident : * Groupe \[sys_user_group\] : le type de partie connexe est assignment_group * Utilisateur \[sys_user\] : le type de partie connexe est assigned_to {#trouble-ticket-PATCH-ticket-tt__ul_umf_r3g_4tb} Type de données : chaîne | | relatedParty.name | Nom de la partie connexe. Type de données : chaîne | | relatedParty.@referredType | Type de partie liée. Valeurs possibles : * assigned_to : l'utilisateur affecté pour travailler sur le ticket. * assignment_group : le groupe affecté pour travailler sur le ticket. * client : la société ou le compte du billet. * customer_contact : l'appelant ou le contact pour le ticket. {#trouble-ticket-PATCH-ticket-tt__ul_bxv_jgg_4tb} Type de données : chaîne | | severity | La gravité du problème décrit par le ticket d'incident. Type de données : chaîne | | statut | L'état actuel du ticket de problème. Type de données : chaîne | | ticketType | Le type de billet. Valeurs possibles : * Ticket * Incident {#trouble-ticket-PATCH-ticket-tt__ul_czp_2mc_ktb} Type de données : chaîne | | @type | Cette valeur est toujours `TroubleTicket`. Type de données : chaîne | [ ] ### Demande cURL Cet exemple met à jour un enregistrement de ticket. curl "https://instance.servicenow.com/api/sn_ind_tsm_sdwan/ticket/troubleTicket/6467508d47e345508761b955d36d43f6" \ --request PATCH \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ description: "Updated description", "note": [ { "text": "Adding another comment", "@type": "comments" } ] }" \ --user 'username':'password' Corps de réponse. { "id": "6467508d47e345508761b955d36d43f6", "href": "/api/sn_ind_tsm_sdwan/ticket/troubleTicket/6467508d47e345508761b955d36d43f6", "creationDate": "2022-05-16 23:38:55", "lastUpdate": "2022-05-16 23:48:42", "description": "Updated description", "severity": "2 - High", "ticketType": "Case", "name": "Laptop problem", "status": "New", "channel": { "name": "web" }, "relatedParty": [ { "id": "", "name": "", "@referredType": "customer" }, { "id": "62826bf03710200044e0bfc8bcbe5df1", "name": "", "@referredType": "customer_contact" }, { "id": "", "name": "", "@referredType": "assignment_group" }, { "id": "", "name": "", "@referredType": "assigned_to" } ], "relatedEntity": [ { "id": "", "href": "", "name": "", "role": "This is the product associated with the case", "@type": "relatedEntity", "@referredType": "product" }, { "id": "74a9ec0d3790200044e0bfc8bcbe5d7f", "href": "", "name": "P1000597 - Apple MacBook Pro 15\"", "role": "This is the asset associated with the case", "@type": "relatedEntity", "@referredType": "asset" } { "id": "a1913c3577b301108e191e599a5a99e8", "href": "", "name": "Deduplication and Compression PI0000037", "role": "This is the product inventory associated with the case.", "@type": "relatedEntity", "@referredType": "product_inventory" } ], "note": [ { "text": "Adding another comment", "date": "2022-05-16 16:48:42", "author": "admin", "@type": "comments" }, { "text": "Comment about this case", "date": "2022-05-16 16:38:55", "author": "admin", "@type": "comments" } ], "@type": "TroubleTicket" } ## Ticket de problème : PATCH /sn_ind_tsm_sdwan/troubleticket/{ticketType}/{id} {#ariaid-title6} Met à jour un enregistrement dans la table Ticket \[sn_customerservice_case\] ou Incident \[incident\]. Important : Ce point de terminaison est obsolète à partir de la Tokyo mise en production. La nouvelle version de ce point de terminaison est [Ticket de problème : PATCH /sn_ind_tsm_sdwan/ticket/troubleTicket/{id}](https://servicenow-prod.fluidtopics.net/Bp~JY2CqIkKe3YcQyp53cg#trouble-ticket-PATCH-ticket-tt "Met à jour un enregistrement spécifié dans la table Ticket [sn_customerservice_case] ou Incident [incident]."). ### Format d'URL URL par défaut : /api/sn_ind_tsm_sdwan/troubleticket/{ticketType}/{id} ### Paramètres de demande pris en charge {#trouble-ticket-PATCH-trouble_ticket__entry__2} | Nom | Description | |-|-| | ticketType | Le type de billet. Cette valeur détermine si un enregistrement est mis à jour dans la table Ticket \[sn_customerservice_case\] ou Incident \[incident\]. Valeurs valides : * ticket * incident {#trouble-ticket-PATCH-trouble_ticket__ul_k1m_qvs_qpb} Type de données : chaîne | | id | sys_id de l'enregistrement de ticket ou d'incident à mettre à jour. Type de données : chaîne | [Tableau 25. Paramètres de chemin d'accès] {#trouble-ticket-PATCH-trouble_ticket__entry__8} | Nom | Description | |-|-| | Aucun | | [Tableau 26. Paramètres de requête] {#trouble-ticket-PATCH-trouble_ticket__entry__12} | Nom | Description | |-|-| | canal | Méthode de contact par laquelle le ticket a été créé. Type de données : objet "channel":{ "name": "String" } | | channel.name | Nom de la méthode de contact. Mappe au champ Canal \[contact_type\] pour les tickets et au champ Type de contact \[contact_type\] pour les incidents. Les valeurs valides sont les choix pour le champ contact_type. Vous pouvez fournir l'étiquette ou la valeur de choix. Par exemple, `Agent virtuel` ou `virtual_agent`. Type de données : chaîne | | description | Description du problème. Mappe au champ Description . Type de données : chaîne | | nom | Nom du ticket d'incident, généralement une brève description du problème. Mappe au champ Brève description . Type de données : chaîne | | note | Une liste des notes de travail et des commentaires à ajouter au ticket. Type de données : tableau "note":[ { "text": "String", "@type": "String" } ] | | note.@type | Le type de note. Cette valeur détermine si la note est enregistrée dans le champ Notes de travail ou Commentaires supplémentaires . Valeurs valides : * work_notes * commentaires {#trouble-ticket-PATCH-trouble_ticket__ul_vtx_hmz_rpb} Type de données : chaîne | | note.texte | Texte de la note. Mappe au champ Notes de travail ou Commentaires supplémentaires . Type de données : chaîne | | entité connexe | Liste des actifs, produits, produits vendus (inventaire de produits), éléments de configuration ou services affectés. Type de données : tableau "relatedEntity": [ { "id": "String", "@referredType": "String" } ] | | relatedEntity.id | Sys_id de l'élément ou du service impacté. Pour les tickets, cette valeur provient de l'une des tables suivantes : * Actif \[alm_asset\] * Modèle de produit \[cmdb_model\] * Produit vendu \[sn_install_base_sold_product\] * Inventaire des produits \[sn_prd_invt_product_inventory\], qui étend la table Produit vendu \[sn_install_base_sold_product\] {#trouble-ticket-PATCH-trouble_ticket__ul_vl4_13c_hwb}Pour les incidents, cette valeur provient de l'une des tables suivantes : * Élément de configuration \[cmdb_ci\] * Service \[cmdb_ci_service\] {#trouble-ticket-PATCH-trouble_ticket__ul_lbg_b3c_hwb} Type de données : chaîne | | relatedEntity.@referredType | Le type d'élément ou de service. Valeurs valides pour les tickets de ticket : * asset * Produit * product_inventory {#trouble-ticket-PATCH-trouble_ticket__ul_bjm_lfy_wsb} Valeurs valides pour les tickets d'incident : * cmdb_ci * cmdb_ci_service {#trouble-ticket-PATCH-trouble_ticket__ul_sfh_g3j_5pa} Type de données : chaîne | | relatedParty | Détails sur les contacts pour le ticket. Pour les tickets, ce paramètre renseigne le champ Contact ou Compte . Pour les incidents, ce paramètre renseigne le champ Appelant ou Société . Type de données : tableau "relatedParty": [ { "id": "String", "@referredType": "String" } ] | | relatedParty.@referredType | Type de partie liée. Valeurs valides : * client : la société ou le compte du billet. * customer_contact : l'appelant ou le contact pour le ticket. {#trouble-ticket-PATCH-trouble_ticket__ul_sfh_g3j_5pb} Type de données : chaîne | | relatedParty.id | Sys_id de la partie liée. Pour les tickets, le sys_id provient des tables Contact \[customer_contact\] ou Compte \[customer_account\]. Pour les incidents, le sys_id provient des tables Utilisateur \[sys_user\] ou Entreprise \[core_company\]. Si vous fournissez un contact ou un utilisateur (appelant), son compte ou sa société est automatiquement renseigné sur le ticket. Type de données : chaîne | | severity | La gravité du problème décrit par le ticket d'incident. Mappe au champ Priorité. Valeurs valides : * 1 : Critique. * 2 : Élevée. * 3 : Modérée. * 4 : Faible. * 5 : Planification. Incident uniquement. {#trouble-ticket-PATCH-trouble_ticket__ul_xhd_24p_rpb}Les valeurs valides sont les choix pour le champ Priorité . Vous devez fournir uniquement la valeur de choix. Par exemple, `1`. Si une valeur non valide est fournie, la gravité est définie sur Faible. Type de données : chaîne | | statut | L'état actuel du ticket de problème. Mappe au champ État . Les valeurs valides sont les choix pour le champ État . Vous pouvez fournir l'étiquette ou la valeur de choix. Par exemple, `Nouveau` ou `1`. Type de données : chaîne | [Tableau 27. 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."). {#trouble-ticket-PATCH-trouble_ticket__entry__44}{#trouble-ticket-PATCH-trouble_ticket__accept-JSON-only-entry-RESTAPI}{#trouble-ticket-PATCH-trouble_ticket__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 28. En-têtes de demandes] {#trouble-ticket-PATCH-trouble_ticket__entry__50} | En-tête | Description | |-|-| | Aucun | | [Tableau 29. 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."). {#trouble-ticket-PATCH-trouble_ticket__entry__54}{#trouble-ticket-PATCH-trouble_ticket__entry-200-status-code} | Code d'état | Description | |-|-| | 200 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Un type de demande incorrect ou une demande mal formée a été détecté pour une ou plusieurs des raisons suivantes. * Paramètre de chemin d'accès non valide. * URI non valide. {#trouble-ticket-PATCH-trouble_ticket__ul_rjf_fqw_rpb} | | 404 | Enregistrement introuvable. Un enregistrement associé à l'ID est introuvable dans la table Ticket \[sn_customerservice_case\] ou Incident \[incident\]. | [Tableau 30. Codes d'état] ### Paramètres du corps de réponse (JSON ou XML) {#trouble-ticket-PATCH-trouble_ticket__entry__62} | Nom | Description | |-|-| | @type | Cette valeur est toujours `TroubleTicket`. Type de données : chaîne | | canal | Méthode de contact par laquelle le ticket a été créé. Type de données : objet "channel":{ "name": "String" } | | channel.name | Nom de la méthode de contact. Type de données : chaîne | | creationDate | Date de création de l'enregistrement. Type de données : chaîne | | description | Description du problème à partir du ticket. Type de données : chaîne | | id | sys_id de l'enregistrement du ticket ou de l'incident. Type de données : chaîne | | lastUpdate (en anglais seulement) | Date de dernière mise à jour de l'enregistrement. Type de données : chaîne | | nom | Nom du ticket d'incident, généralement une brève description du problème. Type de données : chaîne | | note | Liste de tous les commentaires sur le ticket. Cette liste n'inclut pas les notes de travail. Type de données : tableau "note":[ { "author": "String", "date": "String", "text": "String", "@type": "String" } ] | | note.@type | Le type de note. Seuls les commentaires sont renvoyés (pas les notes de travail), cette valeur est donc toujours des `commentaires`. Type de données : chaîne | | note.auteur | Nom de l'utilisateur d'intégration ServiceNow qui a effectué la demande POST ou PATCH qui a créé le commentaire. Type de données : chaîne | | note.date | Date à laquelle le commentaire a été créé dans l'instance ServiceNow. Type de données : chaîne | | note.texte | Le texte du commentaire. Type de données : chaîne | | entité connexe | Liste des actifs, produits, produits vendus (inventaire de produits), éléments de configuration ou services affectés. Type de données : tableau "relatedEntity": [ { "id": "String", "href": "String", "name": "String", "role": "String", "@referredType": "String", "@type": "String" } ] | | relatedEntity.id | Sys_id de l'élément ou du service impacté. Pour les tickets, cette valeur provient de l'une des tables suivantes : * Actif \[alm_asset\] * Modèle de produit \[cmdb_model\] * Produit vendu \[sn_install_base_sold_product\] * Inventaire des produits \[sn_prd_invt_product_inventory\], qui étend la table Produit vendu \[sn_install_base_sold_product\] {#trouble-ticket-PATCH-trouble_ticket__ul_en1_3jc_hwb}Pour les incidents, cette valeur provient de l'une des tables suivantes : * Élément de configuration \[cmdb_ci\] * Service \[cmdb_ci_service\] {#trouble-ticket-PATCH-trouble_ticket__ul_fn1_3jc_hwb} Type de données : chaîne | | relatedEntity.href | Renvoie une chaîne vide. Type de données : chaîne | | relatedEntity.name | Nom de l'élément ou du service impacté. Type de données : chaîne | | relatedEntity.role | Description de l'élément ou du service impacté. Type de données : chaîne | | relatedEntity.@referredType | Le type d'élément ou de service. Valeurs valides pour les tickets de ticket : * asset * Produit * product_inventory {#trouble-ticket-PATCH-trouble_ticket__ul_zrm_5jp_mtb} Valeurs valides pour les tickets d'incident : * cmdb_ci * cmdb_ci_service {#trouble-ticket-PATCH-trouble_ticket__ul_asm_5jp_mtb} Type de données : chaîne | | relatedEntity.@type | Cette valeur est toujours `relatedEntity`. Type de données : chaîne | | relatedParty | Détails sur les sociétés et les contacts associés au billet. Type de données : tableau "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String" } ] | | relatedParty.@referredType | Type de partie liée. Valeurs valides : * client : la société ou le compte du billet. * customer_contact : l'appelant ou le contact pour le ticket. {#trouble-ticket-PATCH-trouble_ticket__d4359e333} Type de données : chaîne | | relatedParty.id | Sys_id de la partie liée. Pour les tickets, le sys_id provient des tables Contact \[customer_contact\] ou Compte \[customer_account\]. Pour les incidents, le sys_id provient des tables Utilisateur \[sys_user\] ou Entreprise \[core_company\]. Si vous fournissez un contact ou un utilisateur (appelant), son compte ou sa société est automatiquement renseigné sur le ticket. Type de données : chaîne | | relatedParty.name | Nom de la partie connexe. Type de données : chaîne | | severity | La gravité du problème décrit par le ticket d'incident. Type de données : chaîne | | statut | L'état actuel du ticket de problème. Type de données : chaîne | | ticketType | Type de ticket (ticket ou incident). Type de données : chaîne | [ ] ### Demande cURL Cet exemple met à jour un enregistrement de ticket. curl "https://instance.servicenow.com/api/sn_ind_tsm_sdwan/troubleticket/case/370415f03c20e910f8772f1bc332b31b" \ --request PATCH \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ \"description\":\"Router is not working, my devices cannot detect any signals from the router. First button from the left is flashing red, all others are black. Resetting the router does not solve the problem, I need urgent assistance.\", \"name\":\"My router is not working properly\", \"severity\":\"2\", \"status\":\"10\", \"ticketType\":\"Case\", \"channel\":{ \"id\":\"8774\", \"name\":\"eBonding\", \"@type\":\"Channel\" }, \"note\":[ { \"id\":\"77456\", \"author\":\"Jack Smith\", \"date\":\"2019-05-31T07:34:45.968Z\", \"text\":\"This is a testing work notehello world and

title

\", \"@type\":\"Worknotes\" }, { \"id\":\"77457\", \"author\":\"Jack Smith\", \"date\":\"2019-05-31T07:35:45.968Z\", \"text\":\"This is a testing comment\", \"@type\":\"Comment\" } ], \"relatedParty\":[ { \"id\":\"eaf68911c35420105252716b7d40ddde\", \"href\":\"https://mycsp.com:8080/tmf-api/partyManagement/v1/individual/9866\", \"name\":\"Sally Thomas\", \"role\":\"customer\", \"@referredType\":\"customer_contact\" }, { \"id\":\"ffc68911c35420105252716b7d40dd55\", \"href\":\"https://mycsp.com:8080/tmf-api/partyManagement/v4/customer/9176\", \"name\":\"Funco Intl\", \"role\":\"customer\", \"@referredType\":\"customer\" } ], \"relatedEntity\": [ { \"id\": \"b7fa12c7532520103b6bddeeff7b123b\", \"href\": \"www.google.com\", \"name\": \"Some random name\", \"role\": \"I dont know what this is\", \"@type\": \"relatedEntity\", \"@referredType\": \"product\" }, { \"id\": \"71e73d87c3e23010ff00ed23a140dde8\", \"href\": \"www.google.com\", \"name\": \"Some random name\", \"role\": \"I dont know what this is\", \"@type\": \"relatedEntity\", \"@referredType\": \"asset\" }, { \"id\": \"a1913c3577b301108e191e599a5a99e8\", \"href\": \"www.google.com\", \"name\": \"Some random name\", \"role\": \"I dont know what this is\", \"@type\": \"relatedEntity\", \"@referredType\": \"product_inventory\" } ] }" \ --user 'username':'password' Corps de réponse. { "id": "370415f03c20e910f8772f1bc332b31b", "href": "/api/sn_ind_tsm_sdwan/ticket/troubleTicket/370415f03c20e910f8772f1bc332b31b", "creationDate": "2023-01-19 22:39:28", "lastUpdate": "2023-01-19 22:41:39", "description": "Router is not working, my devices cannot detect any signals from the router. First button from the left is flashing red, all others are black. Resetting the router does not solve the problem, I need urgent assistance.", "severity": "2 - High", "ticketType": "Case", "name": "My router is not working properly", "status": "Open", "channel": { "name": "e_bonding" }, "relatedParty": [ { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@referredType": "customer" }, { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@referredType": "customer_contact" }, { "id": "", "name": "", "@referredType": "assignment_group" }, { "id": "", "name": "", "@referredType": "assigned_to" } ], "relatedEntity": [ { "id": "b7fa12c7532520103b6bddeeff7b123b", "href": "", "name": "Deduplication and Compression PRD00001965", "role": "This is the product associated with the case.", "@type": "relatedEntity", "@referredType": "product" }, { "id": "71e73d87c3e23010ff00ed23a140dde8", "href": "", "name": "", "role": "This is the asset associated with the case.", "@type": "relatedEntity", "@referredType": "asset" }, { "id": "a1913c3577b301108e191e599a5a99e8", "href": "", "name": "Deduplication and Compression PI0000037", "role": "This is the product inventory associated with the case.", "@type": "relatedEntity", "@referredType": "product_inventory" } ], "note": [ { "text": "This is a testing comment", "date": "2023-01-19 14:41:39", "author": "System Administrator", "@type": "comments" }, { "text": "This is a testing comment", "date": "2023-01-19 14:39:28", "author": "System Administrator", "@type": "comments" } ], "@type": "TroubleTicket" } ## Ticket de problème : POST /sn_ind_tsm_sdwan/ticket/troubleTicket {#ariaid-title7} Crée un enregistrement dans la table Ticket \[sn_customerservice_case\] ou Incident \[incident\]. ### Format d'URL URL par défaut : /api/sn_ind_tsm_sdwan/ticket/troubleTicket ### Paramètres de demande pris en charge {#trouble-ticket-POST-ticket-tt__entry__2} | Nom | Description | |-|-| | Aucun | | [Tableau 31. Paramètres de chemin d'accès] {#trouble-ticket-POST-ticket-tt__entry__6} | Nom | Description | |-|-| | Aucun | | [Tableau 32. Paramètres de requête] {#trouble-ticket-POST-ticket-tt__entry__10} | Nom | Description | |-|-| | canal | Méthode de contact par laquelle le ticket a été créé. Type de données : objet "channel":{ "name": "String" } | | channel.name | Nom de la méthode de contact. Mappe au champ Canal \[contact_type\] pour les tickets et au champ Type de contact \[contact_type\] pour les incidents. Les valeurs valides sont les choix pour le champ contact_type. Vous pouvez fournir l'étiquette ou la valeur de choix. Par exemple, `Agent virtuel` ou `virtual_agent`. Type de données : chaîne | | description | Requis. Description du problème. Mappe au champ Description . Type de données : chaîne | | nom | Nom du ticket d'incident, généralement une brève description du problème. Mappe au champ Brève description . Type de données : chaîne | | note | Une liste des notes de travail et des commentaires à ajouter au ticket. Type de données : tableau "note":[ { "text": "String", "@type": "String" } ] | | note.@type | Le type de note. Cette valeur détermine si la note est enregistrée dans le champ Notes de travail ou Commentaires supplémentaires . Valeurs valides : * work_notes * commentaires {#trouble-ticket-POST-ticket-tt__ul_vtx_hmz_rpb} Type de données : chaîne | | note.texte | Texte de la note. Mappe au champ Notes de travail ou Commentaires supplémentaires . Type de données : chaîne | | entité connexe | Liste des actifs, produits, produits vendus (inventaire de produits), éléments de configuration ou services affectés. Type de données : tableau "relatedEntity": [ { "id": "String", "@referredType": "String" } ] | | relatedEntity.id | Sys_id de l'élément ou du service impacté. Pour les tickets, cette valeur provient de l'une des tables suivantes : * Actif \[alm_asset\] * Modèle de produit \[cmdb_model\] * Produit vendu \[sn_install_base_sold_product\] * Inventaire des produits \[sn_prd_invt_product_inventory\], qui étend la table Produit vendu \[sn_install_base_sold_product\] {#trouble-ticket-POST-ticket-tt__ul_vl4_13c_hwb}Pour les incidents, cette valeur provient de l'une des tables suivantes : * Élément de configuration \[cmdb_ci\] * Service \[cmdb_ci_service\] {#trouble-ticket-POST-ticket-tt__ul_lbg_b3c_hwb} Type de données : chaîne | | relatedEntity.@referredType | Le type d'élément ou de service. Valeurs valides pour les tickets de ticket : * asset * Produit * product_inventory {#trouble-ticket-POST-ticket-tt__ul_bjm_lfy_wsb} Valeurs valides pour les tickets d'incident : * cmdb_ci * cmdb_ci_service {#trouble-ticket-POST-ticket-tt__ul_sfh_g3j_5pa} Type de données : chaîne | | relatedParty | Détails sur les contacts pour le ticket. Pour les tickets, ce paramètre renseigne le champ Contact ou Compte . Pour les incidents, ce paramètre renseigne le champ Appelant ou Société . Type de données : tableau "relatedParty": [ { "id": "String", "@referredType": "String" } ] | | relatedParty.id | Sys_id de la partie liée. Pour les tickets, le sys_id provient des tables Contact \[customer_contact\] ou Compte \[customer_account\]. Pour les incidents, le sys_id provient des tables Utilisateur \[sys_user\] ou Entreprise \[core_company\]. Si vous fournissez un contact ou un utilisateur (appelant), son compte ou sa société est automatiquement renseigné sur le ticket. Type de données : chaîne | | relatedParty.@referredType | Type de partie liée. Valeurs valides : * client : la société ou le compte du billet. * customer_contact : l'appelant ou le contact pour le ticket. {#trouble-ticket-POST-ticket-tt__ul_sfh_g3j_5pb} Type de données : chaîne | | severity | Requis. La gravité du problème décrit par le ticket d'incident. Mappe au champ Priorité. Valeurs valides : * 1 : Critique. * 2 : Élevée. * 3 : Modérée. * 4 : Faible. * 5 : Planification. Incident uniquement. {#trouble-ticket-POST-ticket-tt__ul_xhd_24p_rpb}Les valeurs valides sont les choix pour le champ Priorité . Vous devez fournir uniquement la valeur de choix. Par exemple, `1`. Si une valeur non valide est fournie, la gravité est définie sur Faible. Type de données : chaîne | | statut | Requis. L'état actuel du ticket de problème. Mappe au champ État . Les valeurs valides sont les choix pour le champ État . Vous pouvez fournir l'étiquette ou la valeur de choix. Par exemple, `Nouveau` ou `1`. Si vous fournissez une valeur non valide, l'état est défini sur Nouveau. Type de données : chaîne | | ticketType | Le type de billet. Cette valeur détermine si l'enregistrement est créé dans la table Ticket \[sn_customerservice_case\] ou Incident \[incident\]. Valeurs valides : * Ticket * Incident {#trouble-ticket-POST-ticket-tt__ul_p44_tjp_rpb} Type de données : chaîne Par défaut : incident | [Tableau 33. Paramètres du corps de la demande (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."). {#trouble-ticket-POST-ticket-tt__entry__44}{#trouble-ticket-POST-ticket-tt__accept-JSON-only-entry-RESTAPI}{#trouble-ticket-POST-ticket-tt__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 34. En-têtes de demandes] {#trouble-ticket-POST-ticket-tt__entry__50} | En-tête | Description | |-|-| | Aucun | | [Tableau 35. 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."). {#trouble-ticket-POST-ticket-tt__entry__54} | Code d'état | Description | |-|-| | 201 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Un type de demande incorrect ou une demande mal formée a été détecté pour une ou plusieurs des raisons suivantes. * Charge utile vide. * Charge utile non valide. Champ obligatoire manquant. * ticketType non valide. {#trouble-ticket-POST-ticket-tt__ul_rjf_fqw_rpb} | [Tableau 36. Codes d'état] ### Paramètres de corps de réponse (JSON) {#trouble-ticket-POST-ticket-tt__entry__60} | Nom | Description | |-|-| | @type | Cette valeur est toujours `TroubleTicket`. Type de données : chaîne | | canal | Méthode de contact par laquelle le ticket a été créé. Type de données : objet "channel":{ "name": "String" } | | channel.name | Nom de la méthode de contact. Type de données : chaîne | | creationDate | Date à laquelle l'enregistrement du ticket ou de l'incident a été créé. Type de données : chaîne | | description | Description du problème à partir du ticket. Type de données : chaîne | | href | Lien relatif à l'enregistrement du ticket ou de l'incident. Type de données : chaîne | | id | sys_id de l'enregistrement de ticket ou d'incident qui a été créé. Type de données : chaîne | | lastUpdate (en anglais seulement) | Date de dernière mise à jour de l'enregistrement du ticket ou de l'incident. Type de données : chaîne | | nom | Nom du ticket d'incident, généralement une brève description du problème. Type de données : chaîne | | note | Liste de tous les commentaires sur le ticket. Cette liste n'inclut pas les notes de travail. Type de données : tableau "note":[ { "author": "String", "date": "String", "text": "String", "@type": "String" } ] | | note.@type | Le type de note. Seuls les commentaires sont renvoyés (pas les notes de travail), cette valeur est donc toujours des `commentaires`. Type de données : chaîne | | note.auteur | Nom de l'utilisateur qui a écrit le commentaire. Type de données : chaîne | | note.date | Date à laquelle le commentaire a été créé dans l'instance ServiceNow . Type de données : chaîne | | note.texte | Le texte du commentaire. Type de données : chaîne | | entité connexe | Liste des actifs, produits, produits vendus (inventaire de produits), éléments de configuration ou services affectés. Type de données : tableau "relatedEntity": [ { "id": "String", "href": "String", "name": "String", "role": "String", "@referredType": "String", "@type": "String" } ] | | relatedEntity.id | Sys_id de l'élément ou du service impacté. Pour les tickets, cette valeur provient de l'une des tables suivantes : * Actif \[alm_asset\] * Modèle de produit \[cmdb_model\] * Produit vendu \[sn_install_base_sold_product\] * Inventaire des produits \[sn_prd_invt_product_inventory\], qui étend la table Produit vendu \[sn_install_base_sold_product\] {#trouble-ticket-POST-ticket-tt__ul_en1_3jc_hwb}Pour les incidents, cette valeur provient de l'une des tables suivantes : * Élément de configuration \[cmdb_ci\] * Service \[cmdb_ci_service\] {#trouble-ticket-POST-ticket-tt__ul_fn1_3jc_hwb} Type de données : chaîne | | relatedEntity.href | Renvoie une chaîne vide. Type de données : chaîne | | relatedEntity.name | Nom de l'élément ou du service impacté. Type de données : chaîne | | relatedEntity.role | Description de l'élément ou du service impacté. Type de données : chaîne | | relatedEntity.@referredType | Le type d'élément ou de service. Valeurs valides pour les tickets de ticket : * asset * Produit * product_inventory {#trouble-ticket-POST-ticket-tt__ul_zrm_5jp_mtb} Valeurs valides pour les tickets d'incident : * cmdb_ci * cmdb_ci_service {#trouble-ticket-POST-ticket-tt__ul_asm_5jp_mtb} Type de données : chaîne | | relatedEntity.@type | Cette valeur est toujours `relatedEntity`. Type de données : chaîne | | relatedParty | Détails sur les contacts pour le ticket. Type de données : tableau "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String" } ] | | relatedParty.id | Sys_id de la partie liée. Les sys_id peuvent provenir des tables suivantes en fonction du type de ticket et du type de partie connexe. Ticket : * Compte \[customer_account\] : le type de partie connexe est client * Contact \[customer_contact\] : le type de partie connexe est customer_contact {#trouble-ticket-POST-ticket-tt__ul_vf5_n3g_4tb} Incident: * Société \[core_company\] : le type de partie connexe est client * Utilisateur \[sys_user\] : le type de partie connexe est customer_contact {#trouble-ticket-POST-ticket-tt__ul_ll2_p3g_4tb} Ticket ou incident : * Groupe \[sys_user_group\] : le type de partie connexe est assignment_group * Utilisateur \[sys_user\] : le type de partie connexe est assigned_to {#trouble-ticket-POST-ticket-tt__ul_umf_r3g_4tb} Type de données : chaîne | | relatedParty.name | Nom de la partie connexe. Type de données : chaîne | | relatedParty.@referredType | Type de partie liée. Valeurs possibles : * assigned_to : l'utilisateur affecté pour travailler sur le ticket. * assignment_group : le groupe affecté pour travailler sur le ticket. * client : la société ou le compte du billet. * customer_contact : l'appelant ou le contact pour le ticket. {#trouble-ticket-POST-ticket-tt__ul_bxv_jgg_4tb} Type de données : chaîne | | severity | La gravité du problème décrit par le ticket d'incident. Type de données : chaîne | | statut | L'état actuel du ticket de problème. Type de données : chaîne | | ticketType | Le type de billet. Valeurs possibles : * Ticket * Incident {#trouble-ticket-POST-ticket-tt__ul_czp_2mc_ktb} Type de données : chaîne | [ ] ### Demande cURL Cet exemple crée un enregistrement de ticket de ticket d'incident. curl "https://instance.servicenow.com/api/sn_ind_tsm_sdwan/ticket/troubleTicket" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ "name": "Laptop problem", "description": "Laptop keeps shutting off unexpectedly", "severity": "2", "status": "New", "ticketType": "Case", "channel": { "name": "Web" }, "note": [ { "text": "Work note about this case", "@type": "work_notes" }, { "text": "Comment about this case", "@type": "comments" } ], "relatedEntity": [ { "id": "74a9ec0d3790200044e0bfc8bcbe5d7f", "@referredType": "asset" } ], "relatedParty": [ { "id": "62826bf03710200044e0bfc8bcbe5df1", "@referredType": "customer_contact" } ] }" \ --user 'username':'password' Corps de réponse. { "id": "6467508d47e345508761b955d36d43f6", "href": "/api/sn_ind_tsm_sdwan/ticket/troubleTicket/6467508d47e345508761b955d36d43f6", "creationDate": "2022-05-16 23:38:55", "lastUpdate": "2022-05-16 23:38:55", "description": "Laptop keeps shutting off unexpectedly", "severity": "2 - High", "ticketType": "Case", "name": "Laptop problem", "status": "New", "channel": { "name": "web" }, "relatedParty": [ { "id": "", "name": "", "@referredType": "customer" }, { "id": "62826bf03710200044e0bfc8bcbe5df1", "name": "", "@referredType": "customer_contact" }, { "id": "", "name": "", "@referredType": "assignment_group" }, { "id": "", "name": "", "@referredType": "assigned_to" } ], "relatedEntity": [ { "id": "", "href": "", "name": "", "role": "This is the product associated with the case.", "@type": "relatedEntity", "@referredType": "product" }, { "id": "74a9ec0d3790200044e0bfc8bcbe5d7f", "href": "", "name": "P1000597 - Apple MacBook Pro 15\"", "role": "This is the asset associated with the case.", "@type": "relatedEntity", "@referredType": "asset" } { "id": "a1913c3577b301108e191e599a5a99e8", "href": "", "name": "Deduplication and Compression PI0000037", "role": "This is the product inventory associated with the case.", "@type": "relatedEntity", "@referredType": "product_inventory" } ], "note": [ { "text": "Comment about this case", "date": "2022-05-16 16:38:55", "author": "admin", "@type": "comments" } ], "@type": "TroubleTicket" } ## Ticket de problème : POST /sn_ind_tsm_sdwan/troubleticket/{ticketType} {#ariaid-title8} Crée un enregistrement dans la table Ticket \[sn_customerservice_case\] ou Incident \[incident\]. Important : Ce point de terminaison est obsolète à partir de la Tokyo mise en production. La nouvelle version de ce point de terminaison est [Ticket de problème : POST /sn_ind_tsm_sdwan/ticket/troubleTicket](https://servicenow-prod.fluidtopics.net/Bp~JY2CqIkKe3YcQyp53cg#trouble-ticket-POST-ticket-tt "Crée un enregistrement dans la table Ticket [sn_customerservice_case] ou Incident [incident]."). ### Format d'URL URL par défaut : /api/sn_ind_tsm_sdwan/troubleticket/{ticketType} ### Paramètres de demande pris en charge {#trouble-ticket-POST-trouble_ticket__entry__2} | Nom | Description | |-|-| | ticketType | Le type de billet. Cette valeur détermine si l'enregistrement est créé dans la table Ticket \[sn_customerservice_case\] ou Incident \[incident\]. Valeurs valides : * ticket * incident {#trouble-ticket-POST-trouble_ticket__ul_k1m_qvs_qpb} Type de données : chaîne | [Tableau 37. Paramètres de chemin d'accès] {#trouble-ticket-POST-trouble_ticket__entry__6} | Nom | Description | |-|-| | Aucun | | [Tableau 38. Paramètres de requête] {#trouble-ticket-POST-trouble_ticket__entry__10} | Nom | Description | |-|-| | canal | Méthode de contact par laquelle le ticket a été créé. Type de données : objet "channel":{ "name": "String" } | | channel.name | Nom de la méthode de contact. Mappe au champ Canal \[contact_type\] pour les tickets et au champ Type de contact \[contact_type\] pour les incidents. Les valeurs valides sont les choix pour le champ contact_type. Vous pouvez fournir l'étiquette ou la valeur de choix. Par exemple, `Agent virtuel` ou `virtual_agent`. Type de données : chaîne | | description | Requis. Description du problème. Mappe au champ Description . Type de données : chaîne | | nom | Nom du ticket d'incident, généralement une brève description du problème. Mappe au champ Brève description . Type de données : chaîne | | note | Une liste des notes de travail et des commentaires à ajouter au ticket. Type de données : tableau "note":[ { "text": "String", "@type": "String" } ] | | note.@type | Le type de note. Cette valeur détermine si la note est enregistrée dans le champ Notes de travail ou Commentaires supplémentaires . Valeurs valides : * work_notes * commentaires {#trouble-ticket-POST-trouble_ticket__ul_vtx_hmz_rpb} Type de données : chaîne | | note.texte | Texte de la note. Mappe au champ Notes de travail ou Commentaires supplémentaires . Type de données : chaîne | | entité connexe | Liste des actifs, produits, produits vendus (inventaire de produits), éléments de configuration ou services affectés. Type de données : tableau "relatedEntity": [ { "id": "String", "@referredType": "String" } ] | | relatedEntity.id | Sys_id de l'élément ou du service impacté. Pour les tickets, cette valeur provient de l'une des tables suivantes : * Actif \[alm_asset\] * Modèle de produit \[cmdb_model\] * Produit vendu \[sn_install_base_sold_product\] * Inventaire des produits \[sn_prd_invt_product_inventory\], qui étend la table Produit vendu \[sn_install_base_sold_product\] {#trouble-ticket-POST-trouble_ticket__ul_vl4_13c_hwb}Pour les incidents, cette valeur provient de l'une des tables suivantes : * Élément de configuration \[cmdb_ci\] * Service \[cmdb_ci_service\] {#trouble-ticket-POST-trouble_ticket__ul_lbg_b3c_hwb} Type de données : chaîne | | relatedEntity.@referredType | Le type d'élément ou de service. Valeurs valides pour les tickets de ticket : * asset * Produit * product_inventory {#trouble-ticket-POST-trouble_ticket__ul_bjm_lfy_wsb} Valeurs valides pour les tickets d'incident : * cmdb_ci * cmdb_ci_service {#trouble-ticket-POST-trouble_ticket__ul_sfh_g3j_5pa} Type de données : chaîne | | relatedParty | Détails sur les contacts pour le ticket. Pour les tickets, ce paramètre renseigne le champ Contact ou Compte . Pour les incidents, ce paramètre renseigne le champ Appelant ou Société . Type de données : tableau "relatedParty": [ { "id": "String", "@referredType": "String" } ] | | relatedParty.@referredType | Type de partie liée. Valeurs valides : * client : la société ou le compte du billet. * customer_contact : l'appelant ou le contact pour le ticket. {#trouble-ticket-POST-trouble_ticket__ul_sfh_g3j_5pb} Type de données : chaîne | | relatedParty.id | Sys_id de la partie liée. Pour les tickets, le sys_id provient des tables Contact \[customer_contact\] ou Compte \[customer_account\]. Pour les incidents, le sys_id provient des tables Utilisateur \[sys_user\] ou Entreprise \[core_company\]. Si vous fournissez un contact ou un utilisateur (appelant), son compte ou sa société est automatiquement renseigné sur le ticket. Type de données : chaîne | | severity | Requis. La gravité du problème décrit par le ticket d'incident. Mappe au champ Priorité. Valeurs valides : * 1 : Critique. * 2 : Élevée. * 3 : Modérée. * 4 : Faible. * 5 : Planification. Incident uniquement. {#trouble-ticket-POST-trouble_ticket__ul_xhd_24p_rpb}Les valeurs valides sont les choix pour le champ Priorité . Vous devez fournir uniquement la valeur de choix. Par exemple, `1`. Si une valeur non valide est fournie, la gravité est définie sur Faible. Type de données : chaîne | | statut | L'état actuel du ticket de problème. Mappe au champ État . Les valeurs valides sont les choix pour le champ État . Vous pouvez fournir l'étiquette ou la valeur de choix. Par exemple, `Nouveau` ou `1`. Type de données : chaîne Par défaut : Nouveau | | ticketType | Requis. Le type de billet. Cette valeur détermine si l'enregistrement est créé dans la table Ticket \[sn_customerservice_case\] ou Incident \[incident\]. Valeurs valides : * ticket * incident {#trouble-ticket-POST-trouble_ticket__ul_p44_tjp_rpb} Type de données : chaîne | [Tableau 39. 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."). {#trouble-ticket-POST-trouble_ticket__entry__44}{#trouble-ticket-POST-trouble_ticket__accept-JSON-only-entry-RESTAPI}{#trouble-ticket-POST-trouble_ticket__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 40. En-têtes de demandes] {#trouble-ticket-POST-trouble_ticket__entry__50} | En-tête | Description | |-|-| | Aucun | | [Tableau 41. 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."). {#trouble-ticket-POST-trouble_ticket__entry__54} | Code d'état | Description | |-|-| | 201 | Réussi. La demande a été correctement traitée. | | 400 | Demande incorrecte. Un type de demande incorrect ou une demande mal formée a été détecté pour une ou plusieurs des raisons suivantes. * Charge utile vide. * Charge utile non valide. Champ obligatoire manquant. * Un ticketType ou un ticketType non valide ne correspond pas au paramètre de chemin d'accès ticketType. Par exemple, ticketType est `ticket` , mais le paramètre de chemin est `incident`. {#trouble-ticket-POST-trouble_ticket__ul_rjf_fqw_rpb} | [Tableau 42. Codes d'état] ### Paramètres du corps de réponse (JSON ou XML) {#trouble-ticket-POST-trouble_ticket__entry__60} | Nom | Description | |-|-| | @type | Cette valeur est toujours `TroubleTicket`. Type de données : chaîne | | canal | Méthode de contact par laquelle le ticket a été créé. Type de données : objet "channel":{ "name": "String" } | | channel.name | Nom de la méthode de contact. Type de données : chaîne | | creationDate | Date à laquelle l'enregistrement du ticket ou de l'incident a été créé. Type de données : chaîne | | description | Description du problème à partir du ticket. Type de données : chaîne | | id | sys_id de l'enregistrement de ticket ou d'incident qui a été créé. Type de données : chaîne | | lastUpdate (en anglais seulement) | Date de dernière mise à jour de l'enregistrement du ticket ou de l'incident. Type de données : chaîne | | nom | Nom du ticket d'incident, généralement une brève description du problème. Type de données : chaîne | | note | Une liste des commentaires et des notes de travail qui ont été ajoutés au ticket par la demande POST. Type de données : tableau "note":[ { "author": "String", "date": "String", "text": "String", "@type": "String" } ] | | note.@type | Le type de note. Valeurs valides : * work_notes * commentaires {#trouble-ticket-POST-trouble_ticket__ul_zmv_ybd_5pb} Type de données : chaîne | | note.auteur | Nom de l'utilisateur d'intégration ServiceNow qui a effectué la demande POST qui a créé la note. Type de données : chaîne | | note.date | Date à laquelle la note a été créée dans l'instance ServiceNow. Type de données : chaîne | | note.texte | Texte de la note. Type de données : chaîne | | entité connexe | Liste des actifs, produits, produits vendus (inventaire de produits), éléments de configuration ou services affectés. Type de données : tableau "relatedEntity": [ { "id": "String", "href": "String", "name": "String", "role": "String", "@referredType": "String", "@type": "String" } ] | | relatedEntity.id | Sys_id de l'élément ou du service impacté. Pour les tickets, cette valeur provient de l'une des tables suivantes : * Actif \[alm_asset\] * Modèle de produit \[cmdb_model\] * Produit vendu \[sn_install_base_sold_product\] * Inventaire des produits \[sn_prd_invt_product_inventory\], qui étend la table Produit vendu \[sn_install_base_sold_product\] {#trouble-ticket-POST-trouble_ticket__ul_en1_3jc_hwb}Pour les incidents, cette valeur provient de l'une des tables suivantes : * Élément de configuration \[cmdb_ci\] * Service \[cmdb_ci_service\] {#trouble-ticket-POST-trouble_ticket__ul_fn1_3jc_hwb} Type de données : chaîne | | relatedEntity.href | Renvoie une chaîne vide. Type de données : chaîne | | relatedEntity.name | Nom de l'élément ou du service impacté. Type de données : chaîne | | relatedEntity.role | Description de l'élément ou du service impacté. Type de données : chaîne | | relatedEntity.@referredType | Le type d'élément ou de service. Valeurs valides pour les tickets de ticket : * asset * Produit * product_inventory {#trouble-ticket-POST-trouble_ticket__ul_zrm_5jp_mtb} Valeurs valides pour les tickets d'incident : * cmdb_ci * cmdb_ci_service {#trouble-ticket-POST-trouble_ticket__ul_asm_5jp_mtb} Type de données : chaîne | | relatedEntity.@type | Cette valeur est toujours `relatedEntity`. Type de données : chaîne | | relatedParty | Détails sur les sociétés et les contacts associés au billet. Type de données : tableau "relatedParty": [ { "id": "String", "@referredType": "String" } ] | | relatedParty.id | Sys_id de la partie liée. Pour les tickets, le sys_id provient des tables Contact \[customer_contact\] ou Compte \[customer_account\]. Pour les incidents, le sys_id provient des tables Utilisateur \[sys_user\] ou Entreprise \[core_company\]. Si vous fournissez un contact ou un utilisateur (appelant), son compte ou sa société est automatiquement renseigné sur le ticket. Type de données : chaîne | | relatedParty.referredType | Type de partie liée. Valeurs valides : * client : la société ou le compte du billet. * customer_contact : l'appelant ou le contact pour le ticket. {#trouble-ticket-POST-trouble_ticket__d4359e333} Type de données : chaîne | | severity | La gravité du problème décrit par le ticket d'incident. Type de données : chaîne | | statut | L'état actuel du ticket de problème. Type de données : chaîne | | ticketType | Type de ticket (ticket ou incident). Type de données : chaîne | [ ] ### Demande cURL Cet exemple crée un ticket avec une priorité élevée et l'état ouvert. ccurl "https://instance.servicenow.com/api/sn_ind_tsm_sdwan/troubleticket/case" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ \"description\":\"Router is not working, my devices cannot detect any signals from the router. First button from the left is flashing red, all others are black. Resetting the router does not solve the problem, I need urgent assistance.\", \"name\":\"My router is not working properly\", \"severity\":\"2\", \"status\":\"10\", \"ticketType\":\"Case\", \"channel\":{ \"id\":\"8774\", \"name\":\"eBonding\", \"@type\":\"Channel\" }, \"note\":[ { \"id\":\"77456\", \"author\":\"Jack Smith\", \"date\":\"2019-05-31T07:34:45.968Z\", \"text\":\"This is a testing work notehello world and

title

\", \"@type\":\"Worknotes\" }, { \"id\":\"77457\", \"author\":\"Jack Smith\", \"date\":\"2019-05-31T07:35:45.968Z\", \"text\":\"This is a testing comment\", \"@type\":\"Comment\" } ], \"relatedParty\":[ { \"id\":\"eaf68911c35420105252716b7d40ddde\", \"href\":\"https://mycsp.com:8080/tmf-api/partyManagement/v1/individual/9866\", \"name\":\"Sally Thomas\", \"role\":\"customer\", \"@referredType\":\"customer_contact\" }, { \"id\":\"ffc68911c35420105252716b7d40dd55\", \"href\":\"https://mycsp.com:8080/tmf-api/partyManagement/v4/customer/9176\", \"name\":\"Funco Intl\", \"role\":\"customer\", \"@referredType\":\"customer\" } ], \"relatedEntity\": [ { \"id\": \"b7fa12c7532520103b6bddeeff7b123b\", \"href\": \"www.google.com\", \"name\": \"Some random name\", \"role\": \"I dont know what this is\", \"@type\": \"relatedEntity\", \"@referredType\": \"product\" }, { \"id\": \"71e73d87c3e23010ff00ed23a140dde8\", \"href\": \"www.google.com\", \"name\": \"Some random name\", \"role\": \"I dont know what this is\", \"@type\": \"relatedEntity\", \"@referredType\": \"asset\" }, { \"id\": \"a1913c3577b301108e191e599a5a99e8\", \"href\": \"www.google.com\", \"name\": \"Some random name\", \"role\": \"I dont know what this is\", \"@type\": \"relatedEntity\", \"@referredType\": \"product_inventory\" } ] }" \ --user 'username':'password' Corps de réponse. { "id": "5bbb5cbc3c2ca910f8772f1bc332b34d", "href": "/api/sn_ind_tsm_sdwan/ticket/troubleTicket/5bbb5cbc3c2ca910f8772f1bc332b34d", "creationDate": "2023-01-19 18:33:24", "lastUpdate": "2023-01-19 18:33:24", "description": "Router is not working, my devices cannot detect any signals from the router. First button from the left is flashing red, all others are black. Resetting the router does not solve the problem, I need urgent assistance.", "severity": "2 - High", "ticketType": "Case", "name": "My router is not working properly", "status": "Open", "channel": { "name": "e_bonding" }, "relatedParty": [ { "id": "ffc68911c35420105252716b7d40dd55", "name": "Funco Intl", "@referredType": "customer" }, { "id": "eaf68911c35420105252716b7d40ddde", "name": "Sally Thomas", "@referredType": "customer_contact" }, { "id": "", "name": "", "@referredType": "assignment_group" }, { "id": "", "name": "", "@referredType": "assigned_to" } ], "relatedEntity": [ { "id": "b7fa12c7532520103b6bddeeff7b123b", "href": "", "name": "Deduplication and Compression PRD00001965", "role": "This is the product associated with the case.", "@type": "relatedEntity", "@referredType": "product" }, { "id": "71e73d87c3e23010ff00ed23a140dde8", "href": "", "name": "", "role": "This is the asset associated with the case.", "@type": "relatedEntity", "@referredType": "asset" }, { "id": "a1913c3577b301108e191e599a5a99e8", "href": "", "name": "Deduplication and Compression PI0000037", "role": "This is the product inventory associated with the case.", "@type": "relatedEntity", "@referredType": "product_inventory" } ], "note": [ { "text": "This is a testing comment", "date": "2023-01-19 10:33:24", "author": "System Administrator", "@type": "comments" } ], "@type": "TroubleTicket" }