projectdoc Toolbox 4.9 Release Notes

Property Clean Report, Wiki Link Filter, Delegate Fixes, and more improvements & bugfixes.

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

This release provides new features, improvements and bugfixes.

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!

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.

Release Notes Overview

Breaking Changes

This release removes the Content Management Dashboard from doctype add-ons.

Upgrade Instructions

Here is a short guide to update to this new version of the projectdoc Toolbox. For detailed information on dependencies, please consult the documentation of the add-ons.

Please install the projectdoc Toolbox first, then update your extensions, and finally your doctype add-ons.

List of Changes

The following changes are part of the latest projectdoc Toolbox for Confluence. 

Key Summary T P Description
PDAC-1372 Table Marker with Content Marker Improvement Critical (migrated)

If part of a list merged with the Table Merger Macro is hidden with the Content Marker Macro, then the Table Merger Macro does not locate the list within the Content Marker Macro.

Therefore the Table Merger Macro allows to add additional roots by the class table-merger-root. This allows to select the lists to merge.

Since tables are not nested, the marker is not required for tables.
PDAC-1365 Wiki Link Filter Improvement Critical (migrated)

For the Wiki Link Macro and the Dynamic Document Link Macro we need to filter on the doctype. That is: if the referenced document from the space closure (including the current space) is not of one of the specified doctypes, then the page is rejected as link target.
PDAC-1369 Delegate Property Update Issues Bug Critical (migrated)

Properties provided by delegate properties are not properly updated.

If properties in delegate documents are changed, the delegating documents require an update.

The issue can be worked around when the delegating documents are refreshed after an update of the delegate.
PDAC-1368 Remove Delegate Reference Bug Critical (migrated)

Removing a delegate relationship from a projectdoc document fails to remove that relationship from the Content Property Database.
PDAC-1367 Prevent Self Delegation Bug Critical (migrated)

We need to prevent that a document defines itself as delegate.
PDAC-1358 HTML Element Placeholders Bug Critical (migrated)

Transclusion replacements with HTML elements are not conducted for all HTML fragments successfully.

The cleaning of the placeholder content is too aggressive, removing relevant information.
PDAC-1357 Clean Property Report New Feature Major

Provide a report for the result of the cleaning process. Allow to generate the report without acutally persisting the cleaning result.
PDAC-1373 Render groups and users in Space List Macro Improvement Major

Allow to render the group names and user names with view privileges on a space in the space list macro.

Only users with administration privileges on the space or global are allowed to see this information.
PDAC-1370 Support verbatim ID for Content Marker and Section Macro Improvement Major

Allow users to explicitly specify the identifier with the hashmark prefix.

If the user specifies, for instance, #abc as identifier, it will not be made unique within the page, but is used verbatim (i.e. ... id="abc").
PDAC-1366 Exclude Labels for Tag Macro Improvement Major

Provide a parameter to suppress the function that copies the labels of a page as tag names.

The parameter should be set to false by default and be controlled by a space parameter.
PDAC-1364 Render Document ID with Wiki Link Macros Improvement Major

If the Wiki Link Macro (or one of its relatives) links to a projectdoc document, the data attribute with the projectdoc document identifier should be rendered.

data-projectdoc-id="12345"
PDAC-1363 Allow Comma as CSS Class Name Separator Improvement Major

The parameter values for CSS selector lists should allow a comma as separator.

Autocompletion currently always uses the comma as separator. 
PDAC-1362 Render Action Button as Link Improvement Major

Allow to configure the Action Button Macro to render the element as button (default) or as link.
PDAC-1361 Render ID for no hits Improvement Major

When a search yields no hits, the identifier is not rendered for the generated element. Even if no element is rendered the location of the content needs to be identifiable for userscripts.

Therefore, if an identifier is specified by a macro parameter, the rendered content must also render this identifier regardless if there are hit or not.
PDAC-1360 Property Value Cleaner should allow br Element Improvement Major

Since Confluence adds a <br/> as content to an empty table cell, the cleaner should not remove it. When removed, Confluence will add it next time the document is saved.
PDAC-1375 False Tag Inheritance Bug Major

When the parent is rendered in the context of its children, the Name List Macro inherits tags of the parent to the children.

The context of each document is required to be separated from the contexts of other documents.
PDAC-1374 Property Name Autocomplete Failure depending on Draft Bug Major

Using the Display Property Macro Autocomplete Feature with the local document, the list of matching values is empty when no draft document is available.

Independent of the availability of a draft document, the matching properties must be calculated.
PDAC-1359 Fix Plain Text Handling for Space Properties Bug Major

Space properties with HTML entities is not properly processed.

The rendered content is already decoded and needs to be re-encoded before it is further processed.
PDAC-1355 Skip projectdoc Document Marking in Indexer Bug Major

When in index mode the service cannot write to the database and therefore cannot ensure that the projectdoc content marker is set.

This is typically no problem since a page is stored before it is index. In case the label is removed manually, we need to make sure not to run into an exception.

Therefore we need to skip this "ensure content marker service" in index mode.
PDAC-1371 Definition List Data Handling with Discard Bug Minor (migrated)

Discarding items on definition lists do remove definition data, always.

HTML dd elements should be rendered as is and not be filtered.
PDAC-1356 NPE in Indexer Bug Minor (migrated)

The indexer runs into a NPE in case the cached value cannot be reused and is discarded.
21 issues

Related Releases

Extension Add-ons

The following extension are required to be updated for the projectdoc Toolbox.

Doctype Add-on Version
Web API Extension
9.1.0
Bookmarklets Extension
no update required
Information Systems Extension
no update required
Maven Extensionno update required

Web API Extension

The following changes are part of the latest Web API Extension.

Key Summary T P Status Resolution Description
PDEXWAPI-56 Clean Property Report New Feature Major Done Fixed

Cleanup service requires to provide a report.
1 issue

Doctype Add-ons

The following doctype add-ons are recommended to be updated for the projectdoc Toolbox.

All doctype add-ons are optional. In case an add-on is not installed, there is no need to install it for this version of the projectdoc Toolbox.

Core Doctypes

The following changes are part of the latest Core Doctypes Add-on. 

Key Summary T P Status Resolution Description
PDCORED-289 Remove Content Management Dashboard Improvement Blocker (migrated) Done Fixed

Most spaces do not need the Content Management Dashboard, but it is always added by default. This version removes the tool. It may be added by those spaces that need to provided it manually. Probably it is only required to be supported by the Core Doctypes.
PDCORED-288 Support projectdoc Toolbox 4.9 Improvement Major Done Fixed

The projectdoc Toolbox 4.9 provides two constructors for Content Providers, one of which is deprecated. The new Doctype MP generates the new constructor and is therefore no longer compatible with versions of the projectdoc Toolbox prior to 4.9.
PDCORED-290 Table Columns and Formatting for Subjects, Categories, and Tags Improvement Minor (migrated) Done Fixed

Remove Creation Date and Modification Date form the table that lists documents.

Align center for Iteration and Doctype column.
3 issues

Doctypes for Agile Planning

The following changes are part of the latest Doctypes for Agile Planning.

Key Summary T P Status Resolution Description
PDAGILE-102 Remove Content Management Dashboard Improvement Blocker (migrated) Done Fixed

Most spaces do not need the Content Management Dashboard, but it is always added by default. This version removes the tool. It may be added by those spaces that need to provided it manually. Probably it is only required to be supported by the Core Doctypes.
PDAGILE-101 Support projectdoc Toolbox 4.9 Improvement Major Done Fixed

The projectdoc Toolbox 4.9 provides two constructors for Content Providers, one of which is deprecated. The new Doctype MP generates the new constructor and is therefore no longer compatible with versions of the projectdoc Toolbox prior to 4.9.
PDAGILE-103 Hide more Properties by Default Improvement Minor (migrated) Done Fixed

Properties on documents that are used to be rendered in special contexts (such as short name) or are only relevant in overviews (such as Iteration) should be hidden per default. This includes: Name, Short Name, and Iteration.
3 issues

projectdoc Developer Diaries

The following changes are part of the latest projectdoc Developer Diaries.

Key Summary T P Status Resolution Description
DEVDIARY-146 Remove Content Management Dashboard Improvement Blocker (migrated) Done Fixed

Most spaces do not need the Content Management Dashboard, but it is always added by default. This version removes the tool. It may be added by those spaces that need to provided it manually. Probably it is only required to be supported by the Core Doctypes.
DEVDIARY-145 Support projectdoc Toolbox 4.9 Improvement Major Done Fixed

The projectdoc Toolbox 4.9 provides two constructors for Content Providers, one of which is deprecated. The new Doctype MP generates the new constructor and is therefore no longer compatible with versions of the projectdoc Toolbox prior to 4.9.
DEVDIARY-144 Preserve Task Property Value Improvement Minor (migrated) Done Fixed

Property values with Tasks need to be preserved.

The task element renders a span element without any attributes. Therefore this span will be cleaned. To preserve this element, the property contol 'preserve' must be added to the Status property of the Todo doctype.
3 issues

Doctypes for Project Management

The following changes are part of the latest Doctypes for Project Management.

Key Summary T P Status Resolution Description
PDPRJMGMT-87 Remove Content Management Dashboard Improvement Blocker (migrated) Done Fixed

Most spaces do not need the Content Management Dashboard, but it is always added by default. This version removes the tool. It may be added by those spaces that need to provided it manually. Probably it is only required to be supported by the Core Doctypes.
PDPRJMGMT-86 Support projectdoc Toolbox 4.9 Improvement Major Done Fixed

The projectdoc Toolbox 4.9 provides two constructors for Content Providers, one of which is deprecated. The new Doctype MP generates the new constructor and is therefore no longer compatible with versions of the projectdoc Toolbox prior to 4.9.
2 issues

Doctypes for Service Management

The following changes are part of the latest Doctypes for Service Management.

Key Summary T P Status Resolution Description
SERVICES-39 Remove Content Management Dashboard Improvement Blocker (migrated) Done Fixed

Most spaces do not need the Content Management Dashboard, but it is always added by default. This version removes the tool. It may be added by those spaces that need to provided it manually. Probably it is only required to be supported by the Core Doctypes.
SERVICES-38 Support projectdoc Toolbox 4.9 Improvement Major Done Fixed

The projectdoc Toolbox 4.9 provides two constructors for Content Providers, one of which is deprecated. The new Doctype MP generates the new constructor and is therefore no longer compatible with versions of the projectdoc Toolbox prior to 4.9.
SERVICES-40 Set all Dates for Service Announcement Improvement Minor (migrated) Done Fixed

There are three date properties: Release Date, Begin and End. All three should be initialized with the date from the wizard.
SERVICES-41 Duplicate Fields in Access Information Wizard Bug Major Done Fixed

The page blueprint wizard renders the name and short description two times.

The input field for name and short description must only be rendered once.
4 issues

Doctypes for Business Strategy

The following changes are part of the latest Doctypes for Business Strategy.

Key Summary T P Status Resolution Description
STRATEGY-34 Remove Content Management Dashboard Improvement Blocker (migrated) Done Fixed

Most spaces do not need the Content Management Dashboard, but it is always added by default. This version removes the tool. It may be added by those spaces that need to provided it manually. Probably it is only required to be supported by the Core Doctypes.
STRATEGY-33 Support projectdoc Toolbox 4.9 Improvement Major Done Fixed

The projectdoc Toolbox 4.9 provides two constructors for Content Providers, one of which is deprecated. The new Doctype MP generates the new constructor and is therefore no longer compatible with versions of the projectdoc Toolbox prior to 4.9.
2 issues

Doctypes for Software Development

The following changes are part of the latest Doctypes for Software Development.

Key Summary T P Status Resolution Description
PDSWDEVD-164 Remove Content Management Dashboard Improvement Blocker (migrated) Done Fixed

Most spaces do not need the Content Management Dashboard, but it is always added by default. This version removes the tool. It may be added by those spaces that need to provided it manually. Probably it is only required to be supported by the Core Doctypes.
PDSWDEVD-163 Support projectdoc Toolbox 4.9 Improvement Major Done Fixed

The projectdoc Toolbox 4.9 provides two constructors for Content Providers, one of which is deprecated. The new Doctype MP generates the new constructor and is therefore no longer compatible with versions of the projectdoc Toolbox prior to 4.9.
2 issues

Doctypes for Teamwork

The following changes are part of the latest Doctypes for Teamwork.

Key Summary T P Status Resolution Description
PDTEAMWORK-41 Remove Content Management Dashboard Improvement Blocker (migrated) Done Fixed

Most spaces do not need the Content Management Dashboard, but it is always added by default. This version removes the tool. It may be added by those spaces that need to provided it manually. Probably it is only required to be supported by the Core Doctypes.
PDTEAMWORK-40 Support projectdoc Toolbox 4.9 Improvement Major Done Fixed

The projectdoc Toolbox 4.9 provides two constructors for Content Providers, one of which is deprecated. The new Doctype MP generates the new constructor and is therefore no longer compatible with versions of the projectdoc Toolbox prior to 4.9.
2 issues

Doctypes for V-Modell XT

The following changes are part of the latest Doctypes for V-Modell XT.

Key Summary T P Status Resolution Description
PDVMXT-41 Remove Content Management Dashboard Improvement Blocker (migrated) Done Fixed

Most spaces do not need the Content Management Dashboard, but it is always added by default. This version removes the tool. It may be added by those spaces that need to provided it manually. Probably it is only required to be supported by the Core Doctypes.
PDVMXT-40 Support projectdoc Toolbox 4.9 Improvement Major Done Fixed

The projectdoc Toolbox 4.9 provides two constructors for Content Providers, one of which is deprecated. The new Doctype MP generates the new constructor and is therefore no longer compatible with versions of the projectdoc Toolbox prior to 4.9.
2 issues

projectdoc arc42 Template

The following changes are part of the latest projectdoc Add-on for arc42.

Key Summary T P Status Resolution Description
ARCFOURTWO-75 Support projectdoc Toolbox 4.9 Improvement Critical (migrated) Done Fixed

The projectdoc Toolbox 4.9 provides two constructors for Content Providers, one of which is deprecated. The new Doctype MP generates the new constructor and is therefore no longer compatible with versions of the projectdoc Toolbox prior to 4.9.
1 issue

Doctypes for Java Developers

The following changes are part of the latest projectdoc for Java Developers.

This extension is experimental.

Key Summary T P Status Resolution Description
No issues found

Doctypes for Maven Developers

The following changes are part of the latest projectdoc for Maven Developers.

This extension is experimental.

Key Summary T P Status Resolution Description
PDMVNDEV-26 Support projectdoc Toolbox 4.9 Improvement Critical (migrated) Done Fixed

The projectdoc Toolbox 4.9 provides two constructors for Content Providers, one of which is deprecated. The new Doctype MP generates the new constructor and is therefore no longer compatible with versions of the projectdoc Toolbox prior to 4.9.
1 issue

Resources

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.