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


---

# Recuperar campos de opção usando serviços web diretos

# Recuperar campos de opção usando serviços web diretos {#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

Para recuperar ou definir campos de opção, use o Valorde opção , não o Rótulo.

Por exemplo, se você quiser recuperar uma lista de todos os incidentes encerrados, use o valor numérico para Encerrado, que é 7 por padrão.

    <state>7</state>

Para ver uma lista de valores de seleção:

1. Navegue até o formulário que contém o campo de opção. Por exemplo, navegue até Incidente \> Abrir e selecione um incidente.
2. Clique com o botão direito do mouse no campo de valor de opção e selecione Configurar dicionário. Por exemplo, configure o dicionário para o campo Estado.
3. Na lista relacionada Escolhas, anote o valor do rótulo que você deseja consultar. Por exemplo, observe que a opção Encerrado tem um valor de 7.
{#retrieving-choice-fields-direct-ws__ol_wpc_wgy_5w}
**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.")
* [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.")
* [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.")