projectdoc Toolbox 2.4 Release Notes

Wiki Link for Remote Controlled Documents, improvements and bugfixes

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

This release provides some new features, improvements of existing features, and fixes a number issues.

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

The following changes may be the most interesting of this release.

Request Parameters for Wiki Link Macro

The Wiki Link Macro allows to specify the parameters of an HTTP query string. With this improvement it is now possible to create URLs to use Remote Controlled Documents from within the wiki easily.

For a usage example please refer to Remote Control in our tips section.

Preview of Document Properties

Preview of macros is still a work in progress. With this release the Document Properties Marker Macro takes the recent changes into account when rendering in page or macro preview mode.

Upgrade Instructions

Install the new OBR of the projectdoc Toolbox.

To support the new artificial property Doctype Homepage, run a reindex. If you do not use this new property, a reindex is not required.

Updating the following doctype add-ons is recommended.

Add-on for the projectdoc Toolbox Version
1.0.0.b3
4.0.1
3.0.2

List of Changes

The complete list of changes for this release.

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

Key Summary T P Status Resolution Description
PDAC-898 Request Parameters for Wiki Link Macro Neue Funktion Critical (migrated) Fertig Behoben

Add a parameter to allow users specify request parameters for the generated URL.

PDAC-886 Provide Confluence Links with data-projectdoc-id values Verbesserung Critical (migrated) Fertig Behoben

The rendered Confluence Links should also provide the data-projectdoc-id attribute for property values.

This will make it easier for libraries to only look for the attribute in rendered property values instead of parsing HTML (rendered) and XML (original storage format).

This fix allows to follow transitively transcluded content (since the rendered property value now also presents the data attribute).

PDAC-897 Date Picker Support for Wizards Verbesserung Schwerwiegend Fertig Behoben

We need to make it easier for template authors to render the current date inside a date picker.

PDAC-893 Allow Multiple Doctypes for Ancestor Macro Verbesserung Schwerwiegend Fertig Behoben

We need to allow to specify a list of doctypes with the Ancestor Macro. This makes it possible to have an ancestor of different types.

PDAC-892 Change Default for Wiki Link Macro Verbesserung Schwerwiegend Fertig Behoben

Currently the default for the link macro is to render a create-page link. Unfortunately this link is per default not associated with the blueprint to run. Therefore the more convenient default would be to render the link in plain text.

Choosing "empty" as default seems not the right choice since the macro may be placed inside an HTML element that would not work properly without a value (e.g. an empty li element). 

PDAC-887 Preview of Document Properties Verbesserung Schwerwiegend Fertig Behoben

The Document Properties Marker Macro provides a preview of the current document in the database, not the current document.

We should parse the content of the macro in Preview Mode. This should include the page and macro preview.

PDAC-885 Refresh Copy Tree Improvement Verbesserung Schwerwiegend Fertig Behoben

A refresh after a copy-tree event is required to update references within the tree of pages.

PDAC-884 Update Copy Root Verbesserung Schwerwiegend Fertig Behoben

Copy tree runs a refresh at the parent of the copied tree root level. Refreshing the tree root would be enough.

PDAC-894 Quirk Mode for Steps Verbesserung Minor (migrated) Fertig Behoben

Provide a quirk mode to render steps for Scroll Office Word.

PDAC-891 Normalize Flag for Quote Macro Verbesserung Minor (migrated) Fertig Behoben

Currently the name of the author (or authors) are always normalized. This is useful if the names are rendered with additional tags in the original document that should not appear in the quote.

In case the rendering is applicable for the quote, the user should have the option to either normalize the value or not. A non-normalized value would still contain the links.

PDAC-890 Tour Macro without Table Verbesserung Minor (migrated) Fertig Behoben

There should be an error message if the Tour Marker Macro has no table with properties in it.

PDAC-889 Document Property Marker Macro without Table Verbesserung Minor (migrated) Fertig Behoben

There should be an error message if the Document Property Marker Macro has no table with properties in it.

PDAC-896 Document Property Name Normalization fails Bug Schwerwiegend Fertig Behoben

Document property names with spaces fail to be normalized (in ancestor queries) using the $<...> encoding.

PDAC-895 URL Rendering for Display Property Concat Bug Schwerwiegend Fertig Behoben

The concatenation version of the display property macro fails to render a concatenated URL.

PDAC-883 Refs rendering wrong values Bug Schwerwiegend Fertig Behoben

The artificial property DocumentPropertyRefs is rendered with two problems:

  1. Name List Macros are not recognized and rendered as SpaceKey.PageTitle:PropertyName but should be skipped
  2. Instead of a space key the title of the page is rendered
PDAC-888 Tour Macro Override Bug Minor (migrated) Fertig Behoben

In Definition List Mode the macro fails to allow overriding the second value.

PDAC-882 Rendering Problem with Date Delegate Properties Bug Minor (migrated) Fertig Behoben

Rendering a value that renders to null may result in an exception since the date parser may assume falsely that the value is not yet rendered. But it is simply only not set.

PDAC-881 Encoding Problem with Name List Macro Bug Minor (migrated) Fertig Behoben

When the doctype parameter of the Name List Macro has a list value and the list value contains a space, the macro will not render in edit mode on some environments.

As a workaround: Do not use spaces, like in: one,two

PDAC-880 Spacing for Dates in Quotes Bug Minor (migrated) Fertig Behoben

There is a space missing in front of a rendered date for the Quote Macro.

Related Releases

Extension Add-ons

Extension add-ons extends the functionality of the projectdoc Toolbox.

Extension add-ons for the projectdoc Toolbox provide additional features. Extensions need a licensed version of the projectdoc Toolbox to be installed.

Maven Extension

List of changes in this add-on.

Key Summary T P Status Resolution Description
PDEXMVN-19 Update to Toolbox 3.2.1 Verbesserung Minor (migrated) Fertig Behoben

Web API Extension

List of changes in this add-on.

Key Summary T P Status Resolution Description
PDEXWAPI-23 Update to Toolbox 3.2.1 Verbesserung Blocker (migrated) Fertig Behoben

An API change in projectdoc Toolbox 3.2.1 requires this update.

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.