# Reference

The references of one or more IDOL Content Component documents whose content you want to use to suggest similar content.

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 specify a particular reference field using the ReferenceField parameter.

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

    $<section_number>

where `<section_number>` is the number of the document section whose content you want to return.

Actions: | Suggest
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, IDOL Content Component returns suggestions for documents that are similar to the documents with references `http://www.example.com/?script.pl&query=test` and `http://www.example.com/?script.pl&query=cat+dog`.
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