---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# inserir

# inserir {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

Cria um novo registro para a tabela de destino no URL.

## Campos de entrada

Todos os campos da tabela de destino, exceto os campos do sistema. Os campos configurados como obrigatórios no Dicionário do sistema são refletidos no WSDL com o atributo `minOccurs=1`.

## Campos de saída

{#r_Insert__table_nohead_insert__entry__2}

| 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. |
[Tabela 1. Inserir campos de saída do método]

{#r_Insert__table_insert}

## Amostra de mensagens SOAP para uma tabela regular

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

    <?xml version="1.0" encoding="ISO-8859-1"?>
    <SOAP-ENV:Envelope xmlns:tns="http://www.service-now.com/incident" 
      xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
      xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" 
      xmlns:m="http://www.service-now.com"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
    SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
        <SOAP-ENV:Body>
            <insert xmlns="http://www.service-now.com">
                <short_description xsi:type="xsd:string">This is a test</short_description>
            </insert>
        </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>

A resposta resultante é semelhante a esta:  

    <?xml version="1.0" encoding="ISO-8859-1"?>
    <SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" 
      xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" 
      xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" 
      xmlns:m="http://www.service-now.com" 
      xmlns:tns="http://www.service-now.com/incident" xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <SOAP-ENV:Body>
            <insertResponse xmlns="http://www.service-now.com">
                <sys_id>6b06494fc611227d00b5f87caf618831</sys_id>
            </insertResponse>
        </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>

## Exemplo de mensagens específicas do idioma

Para obter amostras de inserção específicas de idioma, consulte os seguintes tópicos:

[Perl SOAP::Lite](https://servicenow-prod.fluidtopics.net/tFriVt91eiPXmj14UQZf4g#c_PerlWebServicesClientExamples__insert)

[Java Apache Axis2](https://servicenow-prod.fluidtopics.net/5Wd~NjidEHAIy08vafZs6w "Uma classe de exemplo para inserir um registro de incidente.")

[Python](https://servicenow-prod.fluidtopics.net/EHyZw4GZ4nGHpUYQ3_K54g#c_PythonWebServicesClientExamples__insert)