InsertMultiple

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • Cria vários novos registros para a tabela de destino no URL.

    Campos de entrada

    . InsertMultiple o elemento pode conter 1 ou mais marcadores de registro que contém todos os campos da tabela de destino, excluindo os campos do sistema. Limite o número de registros inseridos em uma única operação a não mais de 200. Você pode aumentar gradualmente esse número com exportações subsequentes se o aumento não afetar negativamente o desempenho da instância.

    Campos de saída

    . InsertMultipleResponse o marcador é seguido por 1 ou mais marcadores de registro que contém:

    Tabela 1. Inserir campos de saída do método
    Tipo de tabela Campos de saída
    Normal . sys_id e o valor de exibição da tabela de destino ( tabela ) são retornados.
    Conjunto de importação

    . sys_id da linha do conjunto de importação, o nome da tabela de destino transformada ( tabela . display_name para a tabela de destino transformada, o. display_value da linha de destino transformada e um status , que pode conter inserido , atualizado ou erro .

    Pode haver um opcional status_message ou um error_message valor do campo quando status: erro .

    Quando uma inserção não fez com que uma linha de destino fosse transformada (ignorada porque um valor de chave não foi especificado), o. sys_id o campo conterá o sys_id da linha do conjunto de importação, em vez da tabela de transformação de destino.

    Conjunto de importação com várias transformações A resposta deste tipo de inserção conterá vários conjuntos de campos da inserção de tabela de conjunto de importação regular encapsulada em um MultiInsertResponse elemento primário. Cada conjunto conterá um mapa campo, mostrando qual mapa de transformação criou a resposta.

    Mensagens SOAP de amostra para uma tabela regular

    O exemplo a seguir mostra uma inserção que especifica somente a descrição resumida:

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

    A resposta resultante é semelhante a esta:

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

    Mensagens SOAP de amostra para uma tabela de conjunto de importação

    O exemplo a seguir mostra uma inserção que especifica somente a descrição resumida:

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

    A resposta resultante é semelhante a esta:

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