API de modification de données JSON

Modifiez les données à l’aide du service Web JSON en envoyant une demande HTTPS POST à l’instance.

Le HTTP POST doit contenir un paramètre sysparm_action pour indiquer le type d’action à effectuer, avec la publication de l’objet JSON entrant dans le corps.

Remarque :

Le type de contenu de l’auto-test de démarrage doit être application/json. Il ne peut pas s’agir d’application/x-www-form-urlencoded ou de multipart/form-data.

insérer

Créez un enregistrement dans ServiceNow. L’objet JSON doit être POST en tant que corps (le type de contenu est généralement application/json, bien qu’il ne soit pas appliqué). La réponse de la création de l’enregistrement est un objet JSON de l’incident qui a été créé.

Par exemple, publication de l’objet JSON suivant :

{"short_description":"this is a test","priority":"1"}

à l’URL suivante :

https://your_instance.service-now.com/incident.do?JSONv2&sysparm_action=insert

Crée un incident.

Si vous le souhaitez, vous pouvez également spécifier le sysparm_action dans l’objet JSON. Le paramètre à l’intérieur de l’objet JSON a priorité sur le paramètre URL. Par exemple :

{"sysparm_action":"insert","short_description":"this is a test","priority":"1"}

insérerMultiple

Pour créer plusieurs nouveaux enregistrements dans ServiceNow, l’objet JSON d’entrée pour la fonction d’insertion doit être un tableau. La réponse de la création de l’enregistrement est un objet JSON des incidents qui ont été créés. Par exemple, l’objet JSON suivant :

{ "records" : [ { "short_description" : "this was inserted with python using JSON 1" , "priority" : "1 - Critical" , "impact" : "1" , "caller_id" : "Fred Luddy" } , { "short_description" : "this was inserted with python using JSON 2" , "priority" : "1 - Critical" , "impact" : "1" , "caller_id" : "Fred Luddy" } ] }

publié à l’une des URL suivantes :

https://<instance name>.service-now.com/incident.do?JSONv2&sysparm_action=insert
https://<instance name>.service-now.com/incident.do?JSONv2&sysparm_action=insertMultiple

Crée deux incidents. Notez les champs décrits comme une valeur de tableau pour le champ d’enregistrements .

mettre à jour

Mettez à jour un enregistrement ou une liste d’enregistrements filtrés par une chaîne de requête codée spécifiée par le paramètre URL sysparm_query . L’objet JSON doit être publié en tant que corps (le type de contenu est généralement application/json, bien qu’il ne soit pas appliqué). La réponse de la création d’enregistrement est un tableau d’objets JSON représentant les enregistrements qui ont été mis à jour.

Par exemple, publication de l’objet JSON suivant :

{"short_description":"this was updated with python", "priority": "3", "impact":"1"}

à l’URL suivante :

https://instance_name.service-now.com/incident.do?JSONv2&sysparm_query=priority=3&sysparm_action=update

met à jour tous les incidents de priorité 3 et définit les valeurs spécifiées par l’objet JSON.

deleteRecord

Supprimez un enregistrement unique de la table ciblée, identifiée par un paramètre sysparm_sys_id . Le paramètre peut être encodé dans l’objet JSON d’entrée ou donné comme paramètre URL.

Par exemple, publication :

{"sysparm_sys_id":"fd4001f80a0a0b380032ffa2b749927b"}

à l’URL suivante :

http://instance_name.service-now.com/incident.do?JSONv2&sysparm_action=deleteRecord

Supprime l’enregistrement d’incident identifié par le sys_id FD4001F80A0A0B380032FFA2B749927B.

deleteMultiple

Supprimez plusieurs enregistrements de la table ciblée, filtrés par une chaîne de requête codée spécifiée dans le paramètre URL sysparm_query . Le filtre peut également être encodé dans l’objet JSON d’entrée.

Par exemple, publication :

{"sysparm_query":"short_description=this was updated with python"}

à l’URL suivante :

http://instance_name.service-now.com/incident.do?JSONv2&sysparm_action=deleteMultiple

Supprime tous les enregistrements d’incident dont le champ short_description contient la valeur « ceci a été mis à jour avec Python ».