Versions Compared

Key

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

...

Section
titleDisplay Property Value from a referenced Document

The use case for the 

Static Document Link
documentDisplay Document Property Ref Macro
is a little more complex. It allows you to specify a document where a property references another document which provides a property you want to render. Seems complicated? Well, let's look at an example!

Example Box
titleRendering a Property from a referenced Document

Suppose you add a person document for Gabriella Green. The idea is that every person working for an organization should have the organization's website as default.

So this is the new version of the organization document:

And this is the document for Gabriella Green:

While the email address is for Gabriella personally, the website of the organization is rendered for her website.

Here is the Display Document Property Ref Macro in the macro editor:

Because Documents is empty the macro points to the Organization property in the same document. Following the link to the organization, the macro picks the value of the organization's Website property.

In case the website for the organization changes, the change will be applied automatically to the Website property of Gabriella's document.


projectdoc-box-note
titleIssue with the Documents Parameter

Due to an issue with the Documents parameter, there is no autocomplete. See

Jira
serversmartics JIRA
serverId79ad43bc-d289-364e-bfc7-46c09847bebd
keyPDAC-1543
for details



projectdoc-section
titleConcatenate Property Values from two different Documents

The use case for the 

Static Document Link
documentDisplay Document Property Ref Concat Macro
is only one small step further. It allows to fetch two property values from two different documents and render them together. Is there actually a use case for this macro? Here is the example:

Example Box
titleRendering two Property Values from two Documents

For this use case we add a telephone number to get in touch with the Green Documentation Organization.

The Phone Stem property provides the base phone number where employees add their extension number. For Gabriella this looks like this:

The configuration of the Display Document Property Ref Concat Macro in the macro editor looks like this:

The rendered document of Gabriella:

Both properties, Phone and Website, use the Organization reference to fetch information Phone Stem and the Website from the organization.


...