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.
If you want to learn more about the projectdoc Toolbox and how it helps to create good project documentation, please refer to the introduction video!
The following image is a link to a video on YouTube. When you click the link your browser will serve a page from youtube.com
.
Very interesting, but way too fast?
Step through at your own pace with with our Prezi Presentation (external link to prezi.com
)!
In the Online Manual you’ll find additional video material that introduces you in the concepts of the projectdoc Toolbox.
Refer to use cases and show cases for information on how to use the projectdoc Toolbox.
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
.
de.smartics.projectdoc.dynamicValue.mode.initDefault=lenient
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 |
|
![]() |
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 |
|
![]() |
The position values in the AO table for properties are not updated properly. |
PDAC-1712 | Property Matcher in Autocomplete |
|
![]() |
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 |
|
|
When running queries with a Max Result Size with the Web API, the result is not pruned. |
PDAC-1720 | Page Creation Issue |
|
|
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 |
|
|
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 |
|
|
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 |
|
|
Use Spring Config as injection framework. |
PDAC-1717 | Horizontal Tables for Property Marker |
|
|
Allow to render properties no only in tables and definition lists, but also in horizontal tables. |
PDAC-1716 | In-Document Link for Blog Posts |
|
|
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 |
|
|
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 |
|
|
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.