insertMultiple

Erstellt mehrere neue Datensätze für die in der URL angegebene Tabelle.

Eingabefelder

Das Element insertMultiple kann 1 oder mehrere Datensatz-Tags enthalten, die alle Felder der Zieltabelle enthalten, mit Ausnahme der Systemfelder. Begrenzen Sie die Anzahl der Datensätze, die in einem einzelnen Vorgang eingefügt werden, auf maximal 200. Sie können diese Anzahl mit nachfolgenden Exporten schrittweise erhöhen, wenn die Steigerung die Instanzleistung nicht negativ beeinflusst.

Ausgabefelder

Auf das Tag insertMultipleResponse folgt 1 oder mehrere Datensatz-Tags, die Folgendes enthalten:

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:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:inc="http://www.service-now.com/incident">
   <soapenv:Header/>
   <soapenv:Body>
      <inc:insertMultiple>
         <record>
            <short_description>this is test 1</short_description>
         </record>
         <record>
            <short_description>this is test 2</short_description>
         </record>
         <record>
            <short_description>this is test 3</short_description>
         </record>
      </inc:insertMultiple>
   </soapenv:Body>
</soapenv:Envelope>

Die resultierende Antwort sieht folgendermaßen aus:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:inc="http://www.service-now.com/incident">
   <soapenv:Header/>
   <soapenv:Body>
      <insertMultipleResponse>
         <insertResponse>
            <sys_id>168160ad4a36231200a89091281dc803</sys_id>
            <number>INC0055180</number>
         </insertResponse>
         <insertResponse>
            <sys_id>1681622e4a36231200a8909115e5c388</sys_id>
            <number>INC0055181</number>
         </insertResponse>
         <insertResponse>
            <sys_id>1681626e4a36231200a89091fa3c0aa8</sys_id>
            <number>INC0055182</number>
         </insertResponse>
      </insertMultipleResponse>
   </soapenv:Body>
</soapenv:Envelope>

Beispiel-SOAP-Nachrichten für eine Importsatztabelle

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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:imp="http://www.service-now.com/imp_notification">
   <soapenv:Header/>
   <soapenv:Body>
      <imp:insertMultiple>:-->
         <imp:record>
            <imp:message>one</imp:message>
            <imp:uuid>a</imp:uuid>
         </imp:record>
         <imp:record>
            <imp:message>two</imp:message>
            <imp:uuid>b</imp:uuid>
         </imp:record>
         <imp:record>
            <imp:message>three</imp:message>
            <imp:uuid>c</imp:uuid>
         </imp:record>
      </imp:insertMultiple>
   </soapenv:Body>
</soapenv:Envelope>

Die resultierende Antwort sieht folgendermaßen aus:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:imp="http://www.service-now.com/imp_notification">
   <soapenv:Header/>
   <soapenv:Body>
      <insertMultipleResponse>
         <insertResponse>
            <sys_id>1296b3ab0a0a0b5b73e966fbfab7acde</sys_id>
            <table>incident</table>
            <display_name>number</display_name>
            <display_value>INC0010033</display_value>
            <status>ignored</status>
            <status_message>No field values changed</status_message>
         </insertResponse>
         <insertResponse>
            <sys_id>1296b48e0a0a0b5b62513bb5974a7d96</sys_id>
            <table>incident</table>
            <display_name>number</display_name>
            <display_value>INC0010034</display_value>
            <status>ignored</status>
            <status_message>No field values changed</status_message>
         </insertResponse>
         <insertResponse>
            <sys_id>1296b58b0a0a0b5b468f534659538b9a</sys_id>
            <table>incident</table>
            <display_name>number</display_name>
            <display_value>INC0010035</display_value>
            <status>ignored</status>
            <status_message>No field values changed</status_message>
         </insertResponse>
      </insertMultipleResponse>
   </soapenv:Body>
</soapenv:Envelope>