Previous pageData Integration Next page
Defining Links in fields 

Any field in the Query's resultset can be made into a Link.

There are two events which can trigger a link.

  • On-click
  • On-mouseover

Links are normally defined using the On-click event, with the On-mouseover event being used for ajax transitions.

Destinations

A Link in a Query can target a range of destinations:

  • Local Page – a specified page within the current site
  • Field – the destination UR is taken from the value of a field included within the Query
  • Ajax transition – parts of the current page are updated based on the parameters specified in the link. Read more...

Options

"Open in" target window

You can specify whether the link should open in the Current Window, or in a New Window (except for Ajax transitions, which inherently affect the current window)

QueryString parameters

Parameters are normally specified using the Link Parameters tab, but the option is also provided to manually specify extra parameters. This is most useful when linking to external sites.

Anchor parameters

Used to specify the location with the target page which should be brought into view.

Link parameters

When used to link to pages on the same site, links in Queries can also carry with them extra information, known as Parameters, which are used to affect the display of the destination page. Typically this is used to allow the destination page to provide information related to the particular record that was clicked on.

Parameters are normally the 'Record ID's of the Forms or feeds making up the Query. (For database aficionados, a Record ID is equivalent to the Primary Key in a Table)

There are two modes of parameter selection, automatic, and custom:

Automatic parameter selection

This includes the Record ID and User ID for each table involved in the Query.

A Record ID is a unique number identifying a record in a table.
A User ID is a unique number identifying the owner of a record.

Custom parameter selection

This allows you to select which parameters should be included.


 

Using parameters in embeds

When a page is called with parameters in the link, they appear as a querystring at the end of the URL. By default, any embedded Query (an 'embed') on the page will restrict its output to records matching those parameters, assuming the parameters are relevant to the information it is showing.

However in some cases you may want the embed to ignore the parameters, and show all records (or a selection of records chosen by some other criteria) in which case you can uncheck the Parent parameters checkbox in the embed dialog.