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 New Feature Critical (migrated) Done Fixed

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

PDAC-886 Provide Confluence Links with data-projectdoc-id values Improvement Critical (migrated) Done Fixed

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 Improvement Major Done Fixed

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 Improvement Major Done Fixed

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 Improvement Major Done Fixed

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 Improvement Major Done Fixed

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 Improvement Major Done Fixed

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

PDAC-884 Update Copy Root Improvement Major Done Fixed

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 Improvement Minor (migrated) Done Fixed

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

PDAC-891 Normalize Flag for Quote Macro Improvement Minor (migrated) Done Fixed

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 Improvement Minor (migrated) Done Fixed

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 Improvement Minor (migrated) Done Fixed

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 Major Done Fixed

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

PDAC-895 URL Rendering for Display Property Concat Bug Major Done Fixed

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

PDAC-883 Refs rendering wrong values Bug Major Done Fixed

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) Done Fixed

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

PDAC-882 Rendering Problem with Date Delegate Properties Bug Minor (migrated) Done Fixed

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) Done Fixed

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) Done Fixed

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 Improvement Minor (migrated) Done Fixed

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 Improvement Blocker (migrated) Done Fixed

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.