Support for users of projectdoc macros to select from a range of valid values.
Supported Parameters
The following parameters support Autocomplete.
Names Parameter
The Name List Macro allows to select names from a range of valid names. The range of valid names is defined by the documents of the referenced doctype.
The following parameter put constraints on the search result:
- Doctype - the value is required
- Space Key / Space Keys - limit the name search to the specified spaces / space groups
- Where - provide a where clause (similar to using the Where parameter of the Display Table Macro)
- Autocomplete Sort - provide a sort order (similar to using the Sort By parameter of the Display Table Macro)
The multiplicity (single/multiple) and the tagging option can be configured by the following macro parameters:
Currently only the Name List Macros allow this configuration for their Names Parameter. There is no option to configure this for e.g. the Doctype Parameter.
| Type | Macro Parameter Restrict to one Value | Macro Parameter Restricted to Range |
|---|---|---|
| single | Checked | Unchecked |
| multiple | Unchecked | Unchecked |
| tagging | Unchecked | Checked |
Doctypes Parameter
Many macros that allow to select doctypes are supporting a selection from a drop down menu.
Doctypes missing?
In case the list of doctypes is incomplete, the doctype cache may be corrupt. In this case the doctype cache needs to be refreshed.
See Cache Refresh Actions on how to do this.
Documents Parameter
The Display Document Property Macro allows to select one or more documents to display property values.
Other display document property macros also allow to select one or more documents.
Note that the selection can be constraint on macro basis by the following properties:
- Autocomplete Constraints - provide a where clause (similar to using the Where parameter of the Display Table Macro)
- Autocomplete Sort - provide a sort order (similar to using the Sort By parameter of the Display Table Macro)
Document Property Name Parameter
The Display Document Property Macro supports selecting a valid property name from a referenced document. In case there are multiple documents referenced, the user may pick from the merged sets of property names of the referenced documents.
Macro Parameter Panel
Selecting a value when clicking on a macro in the page editor is an experimental feature that is turned off by default.
Feature Configuration
The feature can be configured for the whole site. The user needs admin privileges to access these.
Go to General configuration.
Then click "Experimental Features".
This leads to the Experimental Features page.
In case the Autocomplete Feature is not activated, the subfeatures Use Macro Parameter Panel for Autocomplete and Force ad-hoc Taxonomies are deactivated by default.
