inserirvários

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 2 min. de leitura
  • Cria vários novos registros para a tabela de destino na URL.

    Campos de entrada

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

    Campos de saída

    O marcador insertMutipleResponse é 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 O campo sys_id e o valor de exibição da tabela de destino (tabela) são retornados.
    Conjunto de importação

    O sys_id da linha do conjunto de importação, o nome da tabela de destino transformada (tabela), o display_name da tabela de destino transformada, o display_value da linha de destino transformada e um campo de status, que pode conter inserido, atualizadoou erro.

    Pode haver um campo status_message opcional ou um valor de campo error_message quando status=error.

    Quando uma inserção não causou a transformação de uma linha de destino (ignorada porque um valor de chave não foi especificado), o campo sys_id 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 da tabela de conjunto de importação regular encapsulados em um elemento primário multiInsertResponse. Cada conjunto conterá um campo de mapa, mostrando qual mapa de transformação criou a resposta.

    Amostra de mensagens SOAP 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>

    Amostra de mensagens SOAP 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>