JSON-Datenänderungs-API

Ändern Sie die Daten mithilfe des JSON-Webservices, indem Sie eine HTTPS-POST-Anforderung an die Instanz senden.

Der HTTP-POST muss einen Parameter sysparm_action enthalten, der den Typ der auszuführenden Aktion angibt, wobei das eingehende JSON-Objekt im Textkörper veröffentlicht wird.

Hinweis:

Der Content Typ des POST sollte „application/json“ sein. Es kann nicht „application/x-www-form-urlencoded“ oder „multipart/form-data“ sein.

insert

Erstellen Sie einen neuen Datensatz in ServiceNow. Das JSON-Objekt muss als Textkörper veröffentlicht werden (Content Typ ist normalerweise „application/json“, wird jedoch nicht erzwungen). Die Antwort von der Datensatzerstellung ist ein JSON-Objekt des Incidents, der erstellt wurde.

Zum Beispiel das Veröffentlichen des folgenden JSON-Objekts:

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

zur folgenden URL:

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

erstellt einen Incident.

Optional können Sie auch die „sysparm_action“ im JSON-Objekt angeben. Der Parameter im JSON-Objekt hat Vorrang vor dem URL-Parameter. Beispiel:

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

insertMultiple

Um mehrere neue Datensätze in ServiceNow zu erstellen, muss das Eingabe-JSON-Objekt für die -Funktion zum Einfügen ein Array sein. Die Antwort von der Datensatzerstellung ist ein JSON-Objekt der erstellten Incidents. Beispielsweise das folgende JSON-Objekt:

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

zu einer der folgenden URLs veröffentlicht:

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

erstellt zwei Incidents. Beachten Sie die Felder, die als Arraywert für das Feld records beschrieben werden.

update

Aktualisiert einen Datensatz oder eine Liste von Datensätzen, die nach einer kodierten Abfragezeichenfolge gefiltert wurden, die durch den URL-Parameter sysparm_query angegeben wurde. Das JSON-Objekt muss als Textkörper veröffentlicht werden (Content Typ ist normalerweise „application/json“, wird jedoch nicht erzwungen). Die Antwort von der Datensatzerstellung ist ein Array von JSON-Objekten, die die aktualisierten Datensätze darstellen.

Zum Beispiel das Veröffentlichen des folgenden JSON-Objekts:

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

zur folgenden URL:

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

aktualisiert alle Incidents mit Priorität 3, und legt die vom JSON-Objekt angegebenen Werte fest.

deleteRecord

Löscht einen einzelnen Datensatz aus der Zieltabelle, der durch einen Parameter sysparm_sys_id gekennzeichnet ist. Der Parameter kann im Eingabe-JSON-Objekt kodiert oder als URL-Parameter angegeben werden.

Zum Beispiel wird durch:

{"sysparm_sys_id":"fd4001f80a0a0b380032ffa2b749927b"}

zur folgenden URL:

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

der durch die sys_id fd4001f80a0a0b380032ffa2b749927b identifizierte Incident-Datensatz gelöscht.

deleteMultiple

Löscht mehrere Datensätze aus der Zieltabelle, gefiltert nach einer kodierten Abfragezeichenfolge, die im URL-Parameter sysparm_query angegeben ist. Der Filter kann auch im Eingabe-JSON-Objekt kodiert sein.

Zum Beispiel wird durch:

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

zur folgenden URL:

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

alle Incident-Datensätze gelöscht, in denen das Feld short_description den Wert „Dies wurde mit Python aktualisiert“ enthält.