insertMultiple

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：6分

    • URL でターゲットとなるテーブルに対して複数の新しいレコードを作成します。

    入力フィールド

    insertMultiple 要素には、システムフィールドを除くターゲットテーブルのすべてのフィールドを含む 1 つ以上のレコードタグを含めることができます。1 回の操作で挿入されるレコードの数を 200 以下に制限します。増加してもインスタンスのパフォーマンスに悪影響を及ぼさない場合は、後続のエクスポートでこの数を徐々に増やすことができます。

    出力フィールド

    insertMultipleResponse タグの後に、次を含む 1 つ以上のレコードタグが続きます。

    表 : 1. メソッドの出力フィールドを挿入
    テーブルのタイプ 出力フィールド
    正規 sys_idフィールドとターゲットテーブル (テーブル) の表示値が返されます。
    インポートセット

    インポートセット行のsys_id、変換されたターゲットテーブル (テーブル) の名前、変換されたターゲットテーブルのdisplay_name、変換されたターゲット行のdisplay_value、およびステータスフィールド (挿入済み、更新済み、またはエラーを含めることができます)。

    status=error の場合は、オプションのstatus_messageフィールドまたはerror_messageフィールド値を使用できます。

    挿入によってターゲット行が変換されなかった場合 (キー値が指定されていないためにスキップされた場合)、 sys_id フィールドにはターゲットの変換テーブルではなく、インポートセット行のsys_idが含まれます。
    複数の変換を含むインポートセット このタイプの挿入からの応答には、 multiInsertResponse 親要素でラップされた通常のインポートセットテーブル挿入からの複数のフィールドセットが含まれます。各セットには、どの変換マップが応答を作成したかを示す マップ フィールドが含まれます。

    通常のテーブルのサンプル SOAP メッセージ

    次の例は、簡単な説明のみを指定する挿入を示しています。

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

    結果の応答は次のようになります。

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

    インポートセットテーブルのサンプル SOAP メッセージ

    次の例は、簡単な説明のみを指定する挿入を示しています。

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

    結果の応答は次のようになります。

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