einfügen

Erstellt einen neuen Datensatz für die in der URL angegebene Tabelle.

Eingabefelder

Alle Felder aus der Zieltabelle, ausgenommen Systemfelder. Felder, die im System-Dictionary als obligatorisch konfiguriert sind, werden in der WSDL mit dem Attribut minOccurs=1 angezeigt.

Ausgabefelder

Tabelle : 1. Methodenausgabefelder einfügen

Tabellentyp	Ausgabefelder
Regelmäßig	Das Feld sys_id und der Anzeigewert der Zieltabelle (table) werden zurückgegeben.
Import Set	Die sys_id der Import Set-Zeile, der Name der transformierten Zieltabelle (table), der display_name für die transformierte Zieltabelle, der display_value der transformierten Zielzeile, und ein Feld status, das inserted, updated, oder error enthalten kann. Ein optionales Feld status_message oder ein Feldwert error_message sind möglich, wenn status=error. Wenn eine Einfügung nicht dazu geführt hat, dass eine Zielzeile umgewandelt wurde (übersprungen wurde, da kein Schlüsselwert angegeben ist), enthält das Feld sys_id die „sys_id“ der Import Set-Zeile und nicht die Zieltransformationstabelle.
Import Set mit mehreren Transformationen	Die Antwort dieses Einfügetyps enthält mehrere Feldsätze aus der regulären Import Set-Tabelleneinfügung, die in ein übergeordnetes Element multiInsertResponse eingeschlossen ist. Jeder Satz enthält ein Feld map, das angibt, von welcher Transform Map die Antwort erstellt wurde.

Beispiel für SOAP-Nachrichten für eine reguläre Tabelle

Das folgende Beispiel zeigt eine Einfügung, die nur die Kurzbeschreibung angibt:

<?xml version="1.0" encoding="ISO-8859-1"?>
<SOAP-ENV:Envelope xmlns:tns="http://www.service-now.com/incident" 
  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" 
  xmlns:m="http://www.service-now.com"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
    <SOAP-ENV:Body>
        <insert xmlns="http://www.service-now.com">
            <short_description xsi:type="xsd:string">This is a test</short_description>
        </insert>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Die resultierende Antwort sieht folgendermaßen aus:

<?xml version="1.0" encoding="ISO-8859-1"?>
<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" 
  xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" 
  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" 
  xmlns:m="http://www.service-now.com" 
  xmlns:tns="http://www.service-now.com/incident" xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <SOAP-ENV:Body>
        <insertResponse xmlns="http://www.service-now.com">
            <sys_id>6b06494fc611227d00b5f87caf618831</sys_id>
        </insertResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Sprachspezifische Beispielnachrichten

Beispiele für sprachspezifisches insert finden Sie in den folgenden Themen:

Perl SOAP::Lite

Java Apache Axis2

Python