Return the display value for reference variables
-
- UpdatedAug 1, 2024
- 1 minute read
- Xanadu
- API implementation
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.
- Add the glide.soap.return_displayValue property to your system properties, and every SOAP request will return a display value for a reference field.
- 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.
- 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.
Related Content
- Use forms to limit or extend the query response
On occasion, there is a need to limit the number of field values that a SOAP query returns.
- Clear values from a target instance
You can pass an empty value through a SOAP parameter to clear the respective value in the target instance.
- Retrieve journal entries using direct web services
To get the contents of a journal field, make a second soap request against the sys_journal_field table to pull the appropriate journal records back for the record in question.
- Retrieve choice fields using direct web services
To retrieve or set choice fields, use the choice Value, not the Label.
- Persist an HTTP session across all SOAP calls
In circumstances when a SOAP client makes many calls in a short amount of time, you may want to re-use a single HTTP session for all SOAP calls.
- SOAP direct web service API functions
The standard SOAP API is a set of small, globally defined functions that can be performed on a targeted resource.