API de modificação de dados JSON

Modifique os dados usando o serviço web JSON enviando uma solicitação HTTPS POST para a instância.

O HTTP POST deve conter um sysparm_action Parâmetro para indicar o tipo de ação a ser executada, com a publicação do objeto JSON de entrada no corpo.

Nota:

O tipo de conteúdo da PUBLICAÇÃO deve ser application/json. Não pode ser application/x-www-form-urlencoded ou multipart/form-data.

inserir

Crie um novo registro em ServiceNow. O objeto JSON deve ser publicado como o corpo (o tipo de conteúdo geralmente é application/json, embora não seja imposto). A resposta da criação do registro é um objeto JSON do incidente que foi criado.

Por exemplo, publicando o seguinte objeto JSON:

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

Para o seguinte URL:

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

cria um incidente.

Também é possível especificar sysparm_action no objeto JSON. O parâmetro dentro do objeto JSON tem precedência sobre o parâmetro URL. Por exemplo:

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

InsertMultiple

Para criar vários novos registros em ServiceNow, O objeto JSON de entrada para a função de inserção deve ser uma matriz. A resposta da criação do registro é um objeto JSON dos incidentes que foram criados. Por exemplo, o seguinte objeto JSON:

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

Publicado em um dos seguintes URLs:

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

cria dois incidentes. Observe os campos descritos como um valor de matriz para registros campo.

atualizar

Atualize um registro ou uma lista de registros filtrados por um cadeia de caracteres de consulta codificada especificada pelo sysparm_query Parâmetro de URL. O objeto JSON deve ser publicado como o corpo (o tipo de conteúdo geralmente é application/json, embora não seja imposto). A resposta da criação do registro é uma matriz de objetos JSON que representam os registros que foram atualizados.

Por exemplo, publicando o seguinte objeto JSON:

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

Para o seguinte URL:

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

Atualiza todos os incidentes com prioridade 3 e define os valores especificados pelo objeto JSON.

ExcluteRecord

Exclua um único registro da tabela de destino, identificado por um sysparm_sys_id parâmetro. O parâmetro pode ser codificado no objeto JSON de entrada ou fornecido como um parâmetro de URL.

Por exemplo, publicando:

{"sysparm_sys_id":"fd4001f80a0a0b380032ffa2b749927b"}

Para o seguinte URL:

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

exclui o registro de incidente identificado pelo sys_id fd4001f80a0a0b380032ffa2b749927b.

DeleteMultiple

Exclua vários registros da tabela de destino, filtrados por um cadeia de caracteres de consulta codificada especificada em sysparm_query Parâmetro de URL. O filtro também pode ser codificado no objeto JSON de entrada.

Por exemplo, publicando:

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

Para o seguinte URL:

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

exclui todos os registros de incidentes em que short_description o campo contém o valor "isto foi atualizado com pyton".