Distributed Index Handler 25.4
Distributed Index Handler Help

# Refs

The references of the documents to change the index date, expire date or database values for.

You should percent-encode document references. This ensures that any reserved characters that are part of a reference are not interpreted as query syntax. If you are sending HTTP requests using the content-type `application/x-www-form-urlencoded` you should percent-encode all parameter values, meaning that document references are percent-encoded twice. For more information, see Percent Encoding in Queries.

Reference encoding example.

If you have the following two references:

- http://www.example.com/?script.pl&query=test

- http://www.example.com/?script.pl&query=cat+dog

Percent-encode each reference:

    http%3A%2F%2Fwww%2Eexample%2Ecom%2F%3Fscript%2Epl%26query%3Dtest

    http%3A%2F%2Fwww%2Eexample%2Ecom%2F%3Fscript%2Epl%26query%3Dcat%2Bdog

Separate the two references with a plus symbol:

    http%3A%2F%2Fwww%2Eexample%2Ecom%2F%3Fscript%2Epl%26query%3Dtest+http%3A%2F%2Fwww%2Eexample%2Ecom%2F%3Fscript%2Epl%26query%3Dcat%2Bdog

If you send your HTTP request using the content-type `application/x-www-form-urlencoded`, all parameter values should be percent-encoded. When the Content component receives the request, the references should have been percent-encoded twice and the "+" separator should have been percent-encoded only once:

    http%253A%252F%252Fwww%252Eexample%252Ecom%252F%253Fscript%252Epl%2526query%253Dtest%2Bhttp%253A%252F%252Fwww%252Eexample%252Ecom%252F%253Fscript%252Epl%2526query%253Dcat%252Bdog

By default, the Content component searches for the references in all reference fields. If you have multiple reference fields and want to search for the specified `Refs` in only one, set the Field parameter to the reference field to use.

Actions: | DRECHANGEMETA
Type: | String
Default: |
Example: | `Refs=http%253A%252F%252Fwww%252Ecompany%252Ecom%252Fmarket%252Easp%253F%2Bhttp%253A%252F%252Fwww%252Esomewhere%252Ejp`
See Also: | Field

Copyright 2025 Open Text
Version 25.4 | Last updated October 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery Distributed Index Handler 25.4

Topic Title: Refs