API de modification des 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 l’objet JSON entrant POST dans le corps.

Remarque :

Le type de contenu du POST 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, la 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.

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"}

insertMultiple

Pour créer plusieurs enregistrements dans ServiceNow, l’objet JSON d’entrée de 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" } ] }

a publié sur 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 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 de l’enregistrement est un tableau d’objets JSON représentant les enregistrements qui ont été mis à jour.

Par exemple, la 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 avec une 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é par un paramètre sysparm_sys_id . Le paramètre peut être encodé dans l’objet JSON d’entrée ou indiqué comme paramètre d’URL.

Par exemple, publier :

{"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 codé dans l’objet JSON d’entrée.

Par exemple, publier :

{"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’incidents dans lesquels le champ short_description contient la valeur « Ceci a été mis à jour avec Python ».