insérerMultiple

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

Champs d'entrée

L’élément insertMultiple peut contenir une ou plusieurs balises d’enregistrement qui contiennent tous les champs de la table ciblée, à l’exception des champs système. Limitez le nombre d’enregistrements insérés en une seule opération à 200 au maximum. Vous pouvez augmenter progressivement ce nombre avec les exportations suivantes 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 qui contiennent :

Tableau 1. Champs de sortie de la méthode d’insertion

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	sys_id de la ligne du jeu d’importation, nom de la table cible transformée (table), display_name de la table cible transformée, display_value de la ligne cible transformée et un champ d’état, lequel peut contenir inserté, mis à jour ou erreur. Il peut y avoir un champ status_message facultatif ou une valeur de champ error_message lorsque status=error. Lorsqu’une insertion n’a pas entraîné la transformation d’une ligne cible (ignorée, car une valeur de clé n’est pas spécifiée), le champ de sys_id contiendra le sys_id de la ligne du jeu d’importation, plutôt que la table de transformation ciblée.
Jeu d’importation avec transformations multiples	La réponse de ce type d’insertion contiendra plusieurs ensembles de champs de l’insertion de table de jeux d’importation standard encapsulé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 normale

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

<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 est la suivante :

<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 jeux d’importation

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

<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 est la suivante :

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