Versions Compared

Key

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

...

Section
titleAdd Property to Document

While doctypes define the standard properties for a document, projectdoc allows to add any additional properties required for your use case.

For instance you may have a number of documents of type Topic. Now you want to attach a weight of relevance of these topics. You do not want to bother to create a new doctype just to introduce this new property. Therefore you add a property with name 'Relevance' and the HML Rating Macro as value.

The downside of this approach is that you

    (minus) You need to open every document and add this new line to each of your properties table inside the Document Properties Marker Macro

.The upside is that you

    (plus) You can access the relevance in every query using for instance the Display Table Macro or the Tour Macro

.

Section
titleUsing the Tour Macro

The Tour Macro allows to specify a list of document references and select properties by adding columns with the selected property name as heading.

You can override the value for a given document by adding a value to the cell in the column. You may even add a column with a heading that matches no property. So if you specify a column 'Relevance' you simply add values to it and they are displayed, even if there is no property with that name in the documents.

So this is the result in the view.

The short descriptions are fetched from the referenced documents, the relevance values are simply rendered from the table column.

The downside of this approach is that

    (minus) 'Relevance' is not a property of the documents and is therefore not accessible from other contexts

.The upside is that since

    (plus) Since the values are added to the table in their own column, they can be edited much more easily

.

Section
titlePrerequisites

...