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


---

# Use formulários para limitar ou estender a resposta da consulta

# Use formulários para limitar ou estender a resposta da consulta {#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

Ocasionalmente, é necessário limitar o número de valores de campo que uma consulta SOAP retorna.  
Você pode usar uma exibição de formulário para limitar o número de valores de campos retornados por uma consulta SOAP. Especificar uma exibição de formulário tem os efeitos de:

1. Limitar os elementos de resposta para conter somente os campos na exibição.
2. Especificar valores de campo de registro de referência de campos referenciados, como caller_id.email. Isso faz com que o valor do e-mail do solicitante seja retornado na resposta SOAP.
{#using-forms-limit-extend-query-resp__ol_uvq_k3y_5w}

Para habilitar exibições de formulário para consultas SOAP, configure a propriedade com.glide.soap.view para conter o nome da exibição que você deseja usar para todas as respostas de consulta SOAP. O padrão é soap_response. Você também pode especificar o nome da exibição como um parâmetro de URL, sysparm_view=\<view name\>, ao fazer a chamada SOAP. Por exemplo:

    https://<instance name>.service-now.com/incident.do?SOAP&sysparm_view=ess

Por padrão, se um nome de exibição especificado não existir, a resposta conterá todos os campos.
**Conceitos relacionados**   

* [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.")
* [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.")