Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Document Properties Marker
overridefalse


Short DescriptionA document template that uses query macros enables documents to dynamically render links to a set of related documents. If new documents are added to the system that meet the query criteria, links to these documents are automatically added to the querying document. This feature is also called dynamic lists or automatic linking.
Doctypefeaturehide
NameDynamic Linking
Parent
Parent Property
property-nameName

Audience
Name List
doctyperole
render-no-hits-as-blanktrue
propertyAudience

Categories
Name List
doctypecategory
propertyCategories

Tags
Name List
doctypetag
propertyTags

Iteration

Iteration
value

filled

production

hide
Importance
Feature Importance

Sort Keyhide


...

Section
show-titlefalse
titleDescription


Image Removed

Dynamic linking allows to render links dependent on the context . This can be a single link or a list of links as shown in the following screenshotat request time. Request time is the time when a page is rendered for a reader in the web browser. Dynamic Linking refers to a list of links, which is called Dynamic List, or a single link, which is called a Dynamic Link.

Section
titleDynamic List

A dynamic list may be rendered as a list or as a table. Sometimes it is also called and automatic list, because the links are rendered dynamically and automatic at request time.

Each list item or table row represents information from one document that is member of the query result set.  A query contains constraints to match all documents of a given document type and a couple of tags. When a user browses to a page with a dynamic list, the system executes the query and shows all pages that match that query at request time. 

Image Added

In the following screenshot you see a dynamic list, rendered in form of a table.

Image Modified

You specify queries like this:

Code Block
languagesql
SELECT PropertyOne, PropertyTwo, PropertyFour
WHERE PropertyOne = "Some String" AND 
        (PropertyTwo = "Another String" OR PropertyFive = "Something")
SORT BY PropertyOne, PropertyThree

Note that this is pseudo syntax. The values for SELECT, WHERE and SORT BY are passed to the macros as parameters.

Dynamic

linking

lists is supported with

Display Table
doctypemacro
render-modedefinition
space-keysPDAC1
where$<Tags>=[Dynamic List]


Section
titleDynamic Link

You may also want to render a single link to a document that may or may not exist. If it exists you have control over the rendering of the link. It may for instance be plain text or the label is not rendered at al. Use the 

Static Document Link
documentDynamic Document Link Macro
and configure the rendering of the link with the Link Rendering Control parameter.

Image Added



Section
titleSubfeature
Display Table
doctypefeature
render-no-hits-as-blanktrue
selectName, Short Description
restrict-to-immediate-childrentrue
sort-bySort Key, Name

...