inserir

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 1 min. de leitura
  • Cria um novo registro para a tabela de destino na URL.

    Campos de entrada

    Todos os campos da tabela de destino, excluindo os campos do sistema. Campos configurados como obrigatórios em O Dicionário do sistema é refletido no WSDL com o atributo MinOccurs: 1 .

    Campos de saída

    Tabela 1. Insira 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 ), o. display_name para a tabela de destino transformada, o. display_value da linha de destino transformada, e um status campo, que pode conter inserido , atualizado , ou erro .

    Pode haver um opcional message_status ou um error_message valor do campo quando 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 A. MultiInsertResponse elemento primário. Cada conjunto conterá um mapa campo, mostrando qual mapa de transformação criou a resposta.

    Mensagens de SOAP de amostra 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 tem esta aparência:

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

    Mensagens de amostra específicas do idioma

    Para idioma específico inserir exemplos, consulte os seguintes tópicos:

    Perl SOAP::Lite

    Java Apache Axis2

    Python