You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

projectdoc Toolbox

Support for users of projectdoc macros to select from a range of valid values.

The Autocomplete Feature has been introduced with version 4.0 of the projectdoc Toolbox. Users are supported by providing a range of valid values to select from. Autocomplete is supported by a number of macros for a number of their parameters.

The feature is currently experimental, but activated by default.

Autocomplete in the projectdoc Toolbox

Autocomplete is provided for a selection of macro on a selection of macro parameters.

Autocomplete does allow the user to select a value for a macro parameter from a list of valid values. Some parameter values are required to be a single value, other may allow to specify multiple values. In some cases where multiple values are allowed, there is a add-hoc taxonomy supported, in others this taxonomy needs to be prepared in advance.

TypeDescription
singleA single value (or none) is expected.
multiple

Any amount of values are allowed.

This approach is called prepared taxononmy since only values that are already defined are allowed.

Examples: Categories and types.

tagging

Values are allowed that are not already defined in projectdoc. Can only be used with multiple.

This approach is called ad-hoc taxonomy since the taxonomy on the type is expanded by selection a value that is not already defined.

Examples: Tags

Documents need to be in iteration Released, Production, or Deprecated to be selected. Records may be in any Iteration state. This selection can be configured via a space property.

Iteration Released, Production, or Deprecated

 

If a document is not in a ready-for-use state, which is Released, Production, or Deprecated, then the name of the document will not be rendered as a selection option.

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)

Doctypes Parameter

Many macros that allow to select doctypes are supporting a selection from a drop down menu.

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.


Space Properties

The following space propert

Macros

The following macros support, possibly partially, Autocomplete:

  • No labels