projectdoc Toolbox 4.4 Release Notes

Web API docs up again, less clutter, and more.

Today we released version 4.4.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. 

New and Noteworthy

Web API Documentation on again!

Since the update of the REST API Browser (see Resolved: REST API Browser showing API documentation again!) the documentation for the services of the projectdoc Toolbox and the Web API Extension is again shown.

Please also update to version 3.2.3 of the REST API Browser!

Again, less clutter

This version allows to specify default values per document property name. Default values will not be rendered, also known as hidden per default.

See Document Property Default Values for more details.

Defaults for Defaults-to of Name List

The Defaults-To parameter of the Name List Macro may now be overridden per space property.

See Name List Macro Defaults-to Configuration for more details.

Breaking Changes

This version has no breaking changes.

Upgrade Instructions

Please install the new OBR of the projectdoc Toolbox, then the extension shown below.

List of Changes

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

Key Summary T P Status Resolution Description
PDAC-1197 Remove Web API Workaround Bug Blocker (migrated) Done Fixed

Due to the fix of the issue https://jira.atlassian.com/browse/CONFSERVER-57887 in the REST API Browser 3.2.3 we can now again make the documentation of the REST API available in the UI of Confluence.

PDAC-1201 Support Space Property for Name List Defaults-to Parameter New Feature Critical (migrated) Done Fixed

Allow to configure the parameter Defaults-to of the Name List Macro with a Space Property.

PDAC-1196 Allow Hiding Property Default Values New Feature Critical (migrated) Done Fixed

Allow to define default values for a property name. A property with any of these value will be hidden on the Document Properties Marker Macro (but not on any other of the Marker Macros).

This supports the feature of removing clutter from the view.

PDAC-1202 Document-centric Fragment Cache New Feature Major Done Fixed

Allow to specify a property on a projectdoc document to partition the fragment cache. Fragments are related to this document.

This way a document can use fragments for its own context. Using the same identifier, the context can be shared.

PDAC-1194 Default Target Location by Doctype Metadata New Feature Major Done Fixed

Allow to control the default target for documents of a given type by a configuration in the doctype model.

PDAC-1203 Provide ID, CSS, and Style Parameters for Steps Macro Improvement Major Done Fixed

To control the rendering of steps we need to add parameters to specify the HTML-ID, the CSS classes, and CSS styles.

PDAC-1200 Default User Space for Parent Page Calculation Improvement Major Done Fixed

Use the user's space as a last check to find the parent page for default location calculation.

PDAC-1198 Organize Events on REST API Call Improvement Major Done Fixed

The solution just prevents the event on the REST call to be executed before the thread completes (and executes it after all adjustments by itself).

This makes sure to make the order of calls predictable (and reduce possible duplicate work).

PDAC-1193 Add Continuation-of as common Property Improvement Major Done Fixed

Define the Continuation-of document property as a common property. Currently this property is used by the event and the todo doctype. By making this a common property other doctypes may also implement the Continue-with feature more easily (by adhering to a name convention).

PDAC-1204 Support Jira Macros as Table Data Bug Major Done Fixed

The Tour Macro should properly render a Jira Macro.

PDAC-1199 Scroll Table Caption and Fragments Cache Bug Major Done Fixed

The table captions created by ScrollOffice are missing their number (e.g. "Table 2") in case the fragment cache is used.

When the cache is turned off and then turned on again, the problem persists.

We need to check first if the cache is cleared when the cache is turned off (IIRC it is not). If the problem persists with cleared cache, we need to investigate further.

PDAC-1206 Fix Property Name "Uhrzeit der letzten Änderungs" Bug Minor (migrated) Done Fixed

The name of the property "Uhrzeit der letzten Änderungs" should read "Uhrzeit der letzten Änderung".

PDAC-1205 Setter Injection Issues Bug Minor (migrated) Done Fixed

We need to replace setter injection with constructor injection for a number of classes.

  1. ClearFragmentsCacheAction
  2. DoctypeCacheRefreshAction
  3. DoctypePropertiesCacheRefreshAction
  4. DoctypePropertiesCacheRefreshTreeAction
  5. FlushReferencedFragmentsAction
  6. ProjectdocGroupCondition
PDAC-1195 Sort Key incremented twice Bug Minor (migrated) Done Fixed

When creating a new document the sort key for section documents is incremented twice.

So instead of counting 100, 110, 120, ... the counting is 110, 130, 150, ... .

Related Releases

Extension Add-ons

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

Web API Extension

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

Key Summary T P Status Resolution Description
PDEXWAPI-47 Update Blueprint Service Access Improvement Blocker (migrated) Done Fixed

Adjustments required to be compatible with the projectdoc Toolbox 4.4. API.

PDEXWAPI-46 Remove Web API Workaround Bug Blocker (migrated) Done Fixed

Maven Extension

The following changes are part of the latest Maven Extension.

Key Summary T P Status Resolution Description
PDEXMVN-27 Update Blueprint Service Access Improvement Blocker (migrated) Done Fixed

Adjustments required to be compatible with the projectdoc Toolbox 4.4. API.

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.

projectdoc Developer Diaries

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

Key Summary T P Status Resolution Description
DEVDIARY-122 Use common Property for Continuation-of Improvement Major Done Fixed

Use the common property for Continuation-of which is provided by the projectdoc Toolbox 4.3.1.

DEVDIARY-124 Default Target Location for Events Improvement Minor (migrated) Done Fixed

Define the default homepage for documents of the event type.

This allows the projectdoc Toolbox to derive this location from the model.

DEVDIARY-123 Missing Document Property for Year Doctype Bug Critical (migrated) Done Fixed

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.