---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Utiliser des formulaires pour limiter ou étendre la réponse à la requête

# Utiliser des formulaires pour limiter ou étendre la réponse à la requête {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute de lecture

Parfois, il est nécessaire de limiter le nombre de valeurs de champ renvoyées par une requête SOAP.  
Vous pouvez utiliser une vue de formulaire pour limiter le nombre de valeurs de champ renvoyées par une requête SOAP. La spécification d'une vue de formulaire a les effets suivants :

1. Limitation des éléments de réponse pour qu'ils ne contiennent que les champs de la vue.
2. Spécification des valeurs de champ d'enregistrement de référence à partir de champs référencés tels que caller_id.email. La valeur de l'e-mail de l'appelant est alors renvoyée dans la réponse SOAP.
{#using-forms-limit-extend-query-resp__ol_uvq_k3y_5w}

Pour activer les vues de formulaire pour les requêtes SOAP, configurez la com.glide.soap.view propriété pour qu'elle contienne le nom de la vue que vous voulez utiliser pour toutes les réponses de requête SOAP. La valeur par défaut est soap_response. Vous pouvez également spécifier le nom de la vue en tant que paramètre d'URL, sysparm_view=\<view name\>, lors de l'appel SOAP. Par exemple :

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

Par défaut, si aucun nom de vue spécifié n'existe, la réponse contient tous les champs.
**Concepts associés**   

* [Renvoyer la valeur d'affichage pour les variables de référence](https://servicenow-prod.fluidtopics.net/4BthMZHZkq1CkQXWLhyzcw "Lorsque vous interrogez un enregistrement à l’aide d’une get fonction ou getRecords , l’instance renvoie tous les champs associés à cet enregistrement. Les champs sont souvent des champs de référence qui contiennent un sys_id pour un enregistrement sur une autre table.")
* [Effacer les valeurs d'une instance cible](https://servicenow-prod.fluidtopics.net/F9H3b8A9mO85TaoEIB20tg "Vous pouvez transmettre une valeur vide via un paramètre SOAP pour effacer la valeur respective dans l’instance cible.")
* [Récupérer des entrées de journal à l'aide de services Web directs](https://servicenow-prod.fluidtopics.net/B_4pB2~gPirlPl3tUNNKYA "Pour obtenir le contenu d’un champ journal, effectuez une deuxième requête SOAP sur la table sys_journal_field pour récupérer les enregistrements de journal appropriés pour l’enregistrement en question.")
* [Récupérer les champs de choix à l'aide de services Web directs](https://servicenow-prod.fluidtopics.net/tIRkJCbhtET_FuoPazvhSQ "Pour récupérer ou définir des champs de choix, utilisez la valeur de choix et non l’étiquette.")
* [Conserver une session HTTP sur tous les appels SOAP](https://servicenow-prod.fluidtopics.net/hFazUFd0q43IlD9_zYnW7g "Dans les cas où un client SOAP effectue de nombreux appels dans un court laps de temps, vous pouvez réutiliser une seule session HTTP pour tous les appels SOAP.")  
**Référence associée**   

* [Fonctions de l'API du service Web direct SOAP](https://servicenow-prod.fluidtopics.net/iFv41cdCZNozKTdV6e2UlA "L’API SOAP standard est un ensemble de petites fonctions définies globalement qui peuvent être exécutées sur une ressource ciblée.")