insertMultiple

Crée plusieurs enregistrements pour la table ciblée dans l’URL.

Champs d'entrée

L’élément insertMultiple peut contenir une ou plusieurs balises d’enregistrement contenant tous les champs de la table ciblée, à l’exception des champs système. Limitez le nombre d’enregistrements insérés dans une seule opération à 200 maximum. Vous pouvez augmenter progressivement ce nombre avec des exportations ultérieures si l’augmentation n’a pas d’impact négatif sur les performances de l’instance.

Champs de sortie

La balise insertMultipleResponse est suivie d’une ou plusieurs balises d’enregistrement contenant :

Tableau 1. Insérer les champs de sortie de la méthode

Type de table	Champs de sortie
Régulier	Le champ sys_id et la valeur d’affichage de la table cible (table) sont renvoyés.
Jeu d'importation	Le sys_id de la ligne de jeu d’importation, le nom de la table cible transformée (table), l’display_name de la table cible transformée, l’display_value de la ligne cible transformée et un champ d’état , qui peut contenir inserted, updated ou error. Il peut y avoir un champ status_message facultatif ou une valeur de champ error_message lorsque état=erreur. Lorsqu’une insertion n’a pas provoqué la transformation d’une ligne cible (ignorée, car une valeur de clé n’est pas spécifiée), le champ sys_id contient le sys_id de la ligne de jeu d’importation, plutôt que la table de transformation ciblée.
Jeu d’importation avec plusieurs transformations	La réponse de ce type d’insertion contiendra plusieurs ensembles de champs à partir de l’insertion de la table de jeu d’importation standard insérée dans un élément parent multiInsertResponse . Chaque ensemble contiendra un champ de carte , indiquant quelle carte de transformation a créé la réponse.

Exemples de messages SOAP pour une table classique

L’exemple suivant montre un encart qui spécifie uniquement la description brève :

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

La réponse qui en résulte ressemble à ceci :

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

Exemples de messages SOAP pour une table de jeu d’importation

L’exemple suivant montre un encart qui spécifie uniquement la description brève :

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

La réponse qui en résulte ressemble à ceci :

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