A collection of macros supports dynamic parameters that may be controlled remotely or by their context. This tip provides some information on context controlled macros.
Templates
To control the parameters with the context, the macro is required to provide a unique identifier.
The feature must be activated. Otherwise the context is not taken into account.
Override Parameter
The parameter's name can be quickly fetched with the inspect context menu item provided by your browser.
Use the part after the prefix "macro-param-", such as "select" in the example above.
The name of the parameters that are actually supported are documented with the macro. For the Display Table Macro they are listed with the section Remote Controlled Documents.
Construct the name of the property to override the parameter value like this:
<Macro Identifier> + ':' + <Parameter Name>
For the example above this would read:
myUniqueId:select
Example
In this example we use the Display Table Macro to list documents that describe doctypes. It shows how a basic configuration can be overriden by a context property.
The macro editor shows the Display Table Macro querying for documents of document type 'doctype'. The table columns show the name and the short description for each hit.
To make the macro context aware, we provide an identifier and activate the Context controlled checkbox.
Now add the property to the document that contains the macro.
The table will now be rendered with columns Name, ID, Set, and Short Description.
