projectdoc Toolbox 6.0.4 Release Notes

Bugfix release for issues regarding Autocomplete with the Name List Macro.

Release Date
 

Today we released version 6.0.4 of the projectdoc Toolbox on the Atlassian Marketplace!

This is release provides a couple of fixes and improvements.

The projectdoc Toolbox is an add-on for Confluence supporting agile software development teams to collaborate on process, project, system, and product documentation. 

New and Noteworthy

Dynamic Property Values

Since version 6.0.x the default mode for Dynamic Property Values is allow. This has been selected to be the default because it puts the least constraints on property values.

It is recommended that the mode is set to lenient. By setting the system property 

de.smartics.projectdoc.dynamicValue.mode.initDefault

the admin is able to set a value different to allow. It is recommended to use lenient. If the system cannot parse a specified value, it assumes lenient, not allowed.

Another option for upgrading from version 4 with stricter mode than allow is to run the upgrade without migration. Then set the appropriate mode and finally run the upgrade manually. For more information on upgrading, please refer to projectdoc Toolbox 5.0 Release Notes. Details on the upgrade task are provided in projectdoc Rebuild Manual.

Dynamic Property Values have been introduced with version 6.0 (see projectdoc Toolbox 6.0 Release Notes).

Names List and Autocomplete

The Name List Macro allows to run Autocomplete to support authors selecting proper names.

The Where parameter of the macro is applied to the Autocomplete, so authors cannot select invalid values. The new mechanism on filtering on the result using the Matcher parameter was not taken into account for Autocomplete. This version fixes that with PDAC-1712 - Property Matcher in Autocomplete Done .

The Where parameter also has always been applied if specified. With this version (see PDAC-1713 - Where Clause Restriction Done ) it will only be applied, if the parameter Restrict to Range is selected. This is also true for the Matcher parameter.

Installation Instructions

Install the projectdoc Toolbox to your Confluence instance. There are no additional steps necessary.

There is only one artifact for deployment on Server and Data Center versions of Confluence.

Upgrade Instructions

Update the projectdoc Toolbox on your Confluence instance. There are no additional steps necessary.

There is only one artifact for deployment on Server and Data Center versions of Confluence.

List of Changes

The following changes are part of version 6.0.4 of the projectdoc Toolbox for Confluence

Key Summary T P Description
PDAC-1723 Name List Reference Issue Bug Major

When rendering a reference to a document with restricted privileges the Name List Macro must not render a proper link.

PDAC-1721 Property Position Issue Bug Major

The position values in the AO table for properties are not updated properly.

PDAC-1712 Property Matcher in Autocomplete Bug Major

For the Name List Macro the Where Parameter is taken into account for filtering on the Autocomplete function. When the user is specifying a property matcher, this is not the case. Autocomplete should only show those values that are allowed by the filter on the property values.

PDAC-1722 Max Result Size Issue with Web API Bug Minor (migrated)

When running queries with a Max Result Size with the Web API, the result is not pruned.

PDAC-1720 Page Creation Issue Bug Minor (migrated)

When storing a page programatically, for instance via the Web API, there is an error in the logs that states that the update process did not finish successfully.

PDAC-1718 Blueprint Creation Issue with Confluence 8 Bug Minor (migrated)

There is a naming issue with the blueprint wizard handling that prevents the creation of certain macros. This is only an issue with Confluence 8 since it enforces modules.

PDAC-1713 Where Clause Restriction Bug Minor (migrated)

For the Name List Macro the restriction of the Where parameter should only be applied to the Autocompletion filtering, if the Restriction parameter is set. Currently it is always applied.

PDAC-1719 Use Spring Config instead of XML Config Improvement Minor (migrated)

Use Spring Config as injection framework.

PDAC-1717 Horizontal Tables for Property Marker Improvement Minor (migrated)

Allow to render properties no only in tables and definition lists, but also in horizontal tables.

PDAC-1716 In-Document Link for Blog Posts Improvement Minor (migrated)

The In-Document Link Macro currently only works on pages, but not on blog posts.

Blog posts should be supported, too.

PDAC-1715 Default Value for Unset Dynamic Value Mode Improvement Minor (migrated)

Users should be able to set a system property to control the default behavior for dynamic values in the case where no property has been set.

Per default this value is 'allow', so that users get no constraints.

Some users may prefer to start with 'lenient' or another mode. With 

de.smartics.projectdoc.dynamicValue.mode.initDefault

set as a System Property, users may now set the default.

In case a default value is set, but not understood (misspelled), the default will be 'lenient', not 'allow'.

PDAC-1714 Sort Specification for Table Merger Improvement Minor (migrated)

The Table Merger Macro does only allow to sort by one column and only sorts ascending.

We need to support the default sort specification so that users may sort by multiple columns and also allow descending sort order.

References

Links to information referenced in the release notes.

Autocomplete
Support for users of projectdoc macros to select from a range of valid values.
Name List Macro
Lists references to projectdoc documents. The rendering will add a link to a document, if there is a document with the given name.
Dynamic Property Values
Property values should only change when a document is saved. They should not be dependent on request-time. If they are, then they are called 'dynamic'.
projectdoc Rebuild Manual
Information for administrators on how to maintain projectdoc documents or to build them from scratch.

Resources

Additional resources on our website regarding the release of the projectdoc Toolbox.

Release Notes for the projectdoc Toolbox
Relevant information on changes to the projectdoc Toolbox for Confluence introduces by new versions of this app.
Glossary
Terms used in and defined for projectdoc.
FAQs
Questions and answers related to the projectdoc Toolbox and Confluence.