# Reference

The references of one or more documents whose content you want to analyze to find the best terms.

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 also set the ReferenceField parameter to specify the reference field that this reference must occur in.

You can also return the content of specific sections in documents by post-fixing a document `Reference` with the following string:

    $SectionNumber

where `SectionNumber` is the number of the document section whose content you want to return.

Actions: | TermGetBest
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, the action returns the best terms from the documents that have the reference `http://www.example.com/?script.pl&query=test` and `http://www.example.com/?script.pl&query=cat+dog`.
See Also: | ReferenceField

_FT_HTML5_bannerTitle.htm