insérerMultiple

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 qui contient tous les champs de la table ciblée, à l’exception des champs système. Limitez à 200 le nombre d’enregistrements insérés en une seule opération. 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 Insérer

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 champ d’état qui peut contenir inséré,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 (omission car aucune valeur de clé n’est spécifiée), le champ de sys_id contient le sys_id de la ligne du 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 de la table d’ensembles d’importation standard insert enveloppés 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 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>

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

L’exemple suivant montre une insertion 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>