inserir

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

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:

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

Java Apache Axis2

Python