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


---

# Limpar valores de uma instância de destino

# Limpar valores de uma instância de destino {#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

Você pode passar um valor vazio por meio de um parâmetro SOAP para limpar o respectivo valor na instância de destino.

Você também pode passar um valor vazio (nulo) por meio do parâmetro de consulta SOAP \&allow_empty_value=true para limpar o respectivo valor na instância de destino.

Por exemplo, https:// \<instance name\> .service-now.com/incident.do?SOAP\&allow_empty_value=true permite passar um valor vazio para o registro de incidente em uma instância.  
Você pode inserir linhas como as seguintes na solicitação SOAP:

    <assigned_to>value</assigned_to>
    <assignment_group>value</assignment_group>
    <category></category>

No exemplo acima,

* \<assigned_to`valor` \</assigned_to\> O muda o valor no campo Atribuído a para o valor especificado na solicitação SOAP.
* \<assignment_group`valor` \</assignment_group\> O muda o valor no campo Grupo de atribuição para o valor especificado na solicitação SOAP.
* \<category\>\</category\>limpa o valor no campo `Categoria` .
{#clearing-values-target__ul_k3w_pn1_gdb}
**Conceitos relacionados**   

* [Use formulários para limitar ou estender a resposta da consulta](https://servicenow-prod.fluidtopics.net/o1e9kRi7B9hqDn0tbarilQ "Ocasionalmente, é necessário limitar o número de valores de campo que uma consulta SOAP retorna.")
* [Retornar o valor de exibição para variáveis de referência](https://servicenow-prod.fluidtopics.net/535msHt6r1Iyl3qBTcIGwQ "Quando você consulta um registro usando uma função get ou getRecords, a instância retorna todos os campos associados a esse registro. Os campos geralmente são campos de referência que contêm um sys_id para um registro em outra tabela.")
* [Recuperar entradas de registro usando serviços web diretos](https://servicenow-prod.fluidtopics.net/VuS6Vy7ZWsVYoWxB1h~clg "Para obter o conteúdo de um campo de diário, faça uma segunda solicitação soap na tabela sys_journal_field para extrair os registros de diário apropriados de volta para o registro em questão.")
* [Recuperar campos de opção usando serviços web diretos](https://servicenow-prod.fluidtopics.net/mThfpAtMyDDJtBQj7iWhKw "Para recuperar ou definir campos de opção, use o Valorde opção , não o Rótulo.")
* [Persistir uma sessão HTTP em todas as chamadas SOAP](https://servicenow-prod.fluidtopics.net/xOKPAvKGiBwHe7MMfq83rg "Nas circunstâncias em que um cliente SOAP faz muitas chamadas em um curto período de tempo, convém reutilizar uma única sessão HTTP para todas as chamadas SOAP.")  
**Referência relacionada**   

* [Funções da API de serviço web direto SOAP](https://servicenow-prod.fluidtopics.net/eJVS80QWhsVvvY99Orco9g "A SOAP API padrão é um conjunto de pequenas funções definidas globalmente que podem ser executadas em um recurso de destino.")