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


---

# Renvoyer la valeur d'affichage pour les variables de référence

# Renvoyer la valeur d'affichage pour les variables de référence {#ariaid-title1}

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

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.  
Utilisez l'une de ces options si vous souhaitez que la valeur d'affichage du champ soit renvoyée au lieu du sys_id :

1. Ajoutez la glide.soap.return_displayValue propriété à vos propriétés système, et chaque requête SOAP renvoie une valeur d'affichage pour un champ de référence.
2. Ajoutez le paramètre à l'URL de votre requête SOAP, et les displayvalue=true demandes SOAP avec ce paramètre renverront une valeur d'affichage pour un champ de référence sous forme de chaîne, au lieu de la sys_id. L'URL SOAP se présente comme suit : https://\<nom d'instance\>.service-now.com/incident.do?displayvalue=true\&SOAP.
3. Ajoutez le displayvalue=all paramètre à l'URL de votre requête SOAP, et les requêtes SOAP avec ce paramètre renverront une valeur d'affichage pour un champ de référence, en plus du sys_id. Le nom de l'élément de réponse pour le champ de valeur d'affichage sera précédé de dv, par exemple dv_caller_id.
{#return-display-reference-variables__ol_fdm_tmv_bdb}
**Concepts associés**   

* [Utiliser des formulaires pour limiter ou étendre la réponse à la requête](https://servicenow-prod.fluidtopics.net/bx8LaYEEfyKSW8SC5G39xw "Parfois, il est nécessaire de limiter le nombre de valeurs de champ renvoyées par une requête SOAP.")
* [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.")