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


---

# Retornar o valor de exibição para variáveis de referência

# Retornar o valor de exibição para variáveis de referência {#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

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.  
Use uma dessas opções se quiser que o valor de exibição do campo seja retornado em vez do sys_id:

1. Adicione a propriedade glide.soap.return_displayValue às propriedades do sistema e cada solicitação SOAP retornará um valor de exibição para um campo de referência.
2. Adicione o parâmetro displayvalue=true ao URL da solicitação SOAP e as solicitações SOAP com esse parâmetro retornarão um valor de exibição para um campo de referência como uma cadeia de caracteres, em vez do sys_id. A URL SOAP seria a seguinte: https://\<instance name\> .service-now.com/incident.do?displayvalue=true\&SOAP .
3. Adicione o parâmetro displayvalue=all ao URL da solicitação SOAP e as solicitações SOAP com esse parâmetro retornarão um valor de exibição para um campo de referência, além do sys_id. O nome do elemento de resposta para o campo de valor de exibição será prefixado com dv, como dv_caller_id.
{#return-display-reference-variables__ol_fdm_tmv_bdb}
**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.")
* [Limpar valores de uma instância de destino](https://servicenow-prod.fluidtopics.net/HafjrMZUUt0OPHzXmCP79A "Você pode passar um valor vazio por meio de um parâmetro SOAP para limpar o respectivo valor na instância de destino.")
* [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.")