Return the display value for reference variables

When you query a record using a get or getRecords function, the instance returns all fields associated with that record. The fields are often reference fields that contain a sys_id for a record on another table.

Use one of these options if you want the display value for the field to be returned instead of the sys_id:

1. Add the glide.soap.return_displayValue property to your system properties, and every SOAP request will return a display value for a reference field.
2. Add the displayvalue=true parameter to your SOAP request URL, and SOAP requests with that parameter will return a display value for a reference field as a string, instead of the sys_id. The SOAP URL would look as follows: https://<instance name>.service-now.com/incident.do?displayvalue=true&SOAP.
3. Add the displayvalue=all parameter to your SOAP request URL, and SOAP requests with that parameter will return a display value for a reference field, in addition to the sys_id. The response element name for the display value field will be prefixed with dv, such as dv_caller_id.

Parent Topic:Direct web services

Related topics

Use forms to limit or extend the query response

Clear values from a target instance

Retrieve journal entries using direct web services

Retrieve choice fields using direct web services

Persist an HTTP session across all SOAP calls

SOAP direct web service API functions