# Reference

The references of one or more documents to display references for. You can return the values of all reference fields in the given documents (for example, to find the value of another reference field from a value that you know).

If the reference contains plus symbols (`+`) or spaces, you must percent-encode the reference twice. If you have multiple references, percent-encode each reference separately once, then separate the references with plus symbols (there must be no space before or after a plus symbol) and percent-encode the whole string again (using a Web browser or the ACI client).

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

Percent-encode the whole string again:

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

You can return only the values of a particular reference field by specifying the ReferenceField parameter.

Actions: | GetAllRefs
Type: | String
Default: |
Example: |
    Reference=http%253A%252F%252Fwww%252Eexample%252Ecom%252F%253Fscript%252Epl%2526query%253Dtest%2Bhttp%253A%252F%252Fwww%252Eexample%252Ecom%252F%253Fscript%252Epl%2526query%253Dcat%252Bdog
In this example documents that have the reference `http://www.example.com/?script.pl&query=test` and `http://www.example.com/?script.pl&query=cat+dog` are returned.
See Also: | ReferenceField

© Copyright 2020 Micro Focus or one of its affiliates | Send documentation feedback Close Send documentation feedback To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a mail client, and then send this email to swpdl.idoldocsfeedback@microfocus.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_FT_HTML5_bannerTitle.htm