Services for User Macros, Autocomplete IDs and Tags, improvements for the Scroll integration.
Today we released version 4.1 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!
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.
List of Changes
The following changes are part of the latest projectdoc Toolbox for Confluence.
| Key | Summary | T | P | Status | Resolution | Description |
|---|---|---|---|---|---|---|
| PDAC-1144 | Autocomplete IDs and Tags |
|
|
Done | Fixed |
Provide support to fetch IDs and tags for the transclusion macro. This version will only support the non-transitive transclusion use case. |
| PDAC-1140 | User Macro Interface |
|
|
Done | Fixed |
Provide access to selected projectdoc services via a stable interface to be used in user macros. |
| PDAC-1138 | Improve Support for Integration with Scroll PDF |
|
|
Done | Fixed |
Improves integration with transclusion and Scroll PDF. Due to an update of the Scroll products the projectdoc Toolbox no longer provides the correct context to obey Scroll Ignore and Scroll Only macros. This improvement also fixes problems with labels on tables. |
| PDAC-1147 | Display Table Highlighting |
|
|
Done | Fixed |
Allow to highlight the current document in a display table listing. |
| PDAC-1142 | Tour Highlighting |
|
|
Done | Fixed |
Allow to highlight the current document in a tour table listing. |
| PDAC-1152 | Support Greater Than and Less Than for Where Constraints |
|
|
Done | Fixed |
When specifying Where Constraints the operators '>=' and '<=' are supported, but not '>' and '<'. In the context of date functions we need the additional operators. |
| PDAC-1149 | Replace Values Parameter Fix |
|
|
Done | Fixed |
When replacing values via the REST API the Tag Macro is not correctly manipulated. The parameter is rendered in a corrupt state. |
| PDAC-1148 | Abbreviated Argument Specification for Date Functions |
|
|
Done | Fixed |
Instead of specifying the date function call as now("", "-3w") allow the abbreviated form of now(-3w). |
| PDAC-1143 | Provide Time of Day as Artificial Property |
|
|
Done | Fixed |
In addition to the creation date and last modification date we need to add an artificial property that holds the time of day.
The format of the first two (...Time and ...Time$) is derived from the formatter provided by Confluence. The last (...Time§, normalized) is the format HHmmss. Note that existing pages must be reindexed to generate the artificial properties. |
| PDAC-1141 | Render Title for Name in Transclusion per Default |
|
|
Done | Fixed |
In case a transclusion renders the name of the transcluded document as a header, the macro assumes that the referenced page is a projectdoc document. If it is not a projectdoc document it has no name and no heading will be added. In case there is no name property, the macro should render the title instead. This also makes it easier for users to spot a configurations that do not align to the intended specification. Otherwise the heading would simply be missing. |
| PDAC-1137 | Render Name for Wiki Link Macro |
|
|
Done | Fixed |
The Wiki Link Macro should render the name of the referenced document in case it is actually a projectdoc document. Currently it is rendering the page title. |
| PDAC-1134 | Hide Aside Panels without Content |
|
|
Done | Fixed |
Hide Aside Panels if they have an empty body. |
| PDAC-1154 | Fix Merge Semantics |
|
|
Done | Fixed |
When merging properties the value will not be merged. |
| PDAC-1153 | Fix Title Extension |
|
|
Done | Fixed |
Due to changes in the Title Handling the Maven supported Version Doctype fails to render a propert unversioned title: the (Current Version) suffix is missing. |
| PDAC-1151 | Wiki Link URL Construction Fails |
|
|
Done | Fixed |
In case the URL already contains parameters (for instance of the page is referenced by page ID), then the additional parameters are not correctly added. |
| PDAC-1150 | Wiki Link fails on Page Titles with Apostrophe |
|
|
Done | Fixed |
In case the title of a referenced page contains an apostrophe, the link is not correctly rendered. This is because the lookup in the I18N bundle will remove the apostrophe when returning the key. The macro assumes that the title is actually a key, while it is not and uses the returned value as the page's title (the one without the apostrophe). |
| PDAC-1139 | Tooltip rendering with Wiki Link Macro |
|
|
Done | Fixed |
The Wiki Link Macro does not render its tooltip title free of HTML. |
| PDAC-1136 | Support of Umlauts in Autocomplete |
|
|
Done | Fixed |
When a search term for Autocomplete contains a umlauts character, the match fails. We also need to filter on terms using '-' or '+'. |
| PDAC-1131 | Support Page Title with Space Key by Wiki Link Macro |
|
|
Done | Fixed |
The Document parameter does not allow a prefix for the space key. The prefix should override any space key specified. |
| PDAC-1130 | Render preview for Document Property Table Macros |
|
|
Done | Fixed |
When rendering the preview of the Document Properties Marker Macro in the macro browser currently a page editor version of the macro body is rendered. It should render the fragment in the page view. |
| PDAC-1135 | Control Related Information Intro Text for Aside Macro |
|
|
Done | Fixed |
To make it easy to replace the introductional text for related information on home pages and index pages, this text must be controlled by a space property. |
| PDAC-1133 | Support Smaller View in Edit-Mode for WikiLink-Macro |
|
|
Done | Fixed |
Support the smaller view in edit-mode for WikiLink-Macro @see NameList-Macro. |
| PDAC-1132 | Support Different Modes for Instance Finding for Wiki Link Macro |
|
|
Done | Fixed |
Maybe we only need one mode if this is efficient enough. For now we will implement different modes to find which one we should use per default. |
| PDAC-1145 | Render Recursion Detection in Tour Macro |
|
|
Done | Fixed |
A transclusion recursion is detected, but rendered as a parsing problem. The transclusion recursion needs to be rendered instead. |
Related Releases
Extension Add-ons
The following extensions are required to be updated for the projectdoc Toolbox.
All extensions are optional. In case an extension is not installed, there is no need to install it for this version of 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-36 | Upload Hierarchies of Documents |
|
|
Done | Fixed |
Allow to upload document instances. Requires projectdoc Toolbox 4.1. |
| PDEXWAPI-31 | Upload Documents in CSV |
|
|
Done | Fixed |
Allow to upload a CSV file and create a document per line. |
| PDEXWAPI-37 | Support Changing Values for Iteration Macro |
|
|
Done | Fixed |
Add the Iteration Macro to the list of macros we know how to change values. This way the user does not need to construct the macro as value, but can simply pass the value. |
| PDEXWAPI-38 | Fix Dropping Property Controls |
|
|
Done | Fixed |
Fix issues with merging property controls. The update information prunes property controls. They need to be applied. |
| PDEXWAPI-39 | Fix Property Merging |
|
|
Done | Fixed |
Merging property values fails for positions without references. |
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-254 | Support empty Aside Panels |
|
|
Done | Fixed |
Redesign the integration of the Aside Panel Macro to allow hiding empty panels. |
| PDCORED-253 | Support Short Name Queries |
|
|
Done | Fixed |
Allow to query for Names and Short Names alike with type doctypes. |
| PDCORED-252 | Hide Section in Module Doctype |
|
|
Done | Fixed |
Hide Description, Summary, and Transcluded By from users without write permission. The module is meant for reuse and usually does not provide information to readers. |
| PDCORED-251 | Add IDs Home/Index Page Boxes |
|
|
Done | Fixed |
The boxes on home pages and index pages need to provide a unique identifier to refer to these boxes individually from CSS. |
Doctypes for Agile Planning
The following changes are part of the latest Doctypes for Agile Planning.
| Key | Summary | T | P | Status | Resolution | Description |
|---|---|---|---|---|---|---|
| PDAGILE-83 | Support empty Aside Panels |
|
|
Done | Fixed |
Redesign the integration of the Aside Panel Macro to allow hiding empty panels. |
| PDAGILE-82 | Support Short Name Queries |
|
|
Done | Fixed |
Allow to query for Names and Short Names alike with type doctypes. |
| PDAGILE-81 | Add IDs Home/Index Page Boxes |
|
|
Done | Fixed |
The boxes on home pages and index pages need to provide a unique identifier to refer to these boxes individually from CSS. |
projectdoc Developer Diaries
The following changes are part of the latest projectdoc Developer Diaries.
| Key | Summary | T | P | Status | Resolution | Description |
|---|---|---|---|---|---|---|
| DEVDIARY-119 | Add Author to Event, Asset, and Todo |
|
|
Done | Fixed |
For use cases related to event driven documentation the author of an event may be relevant for selection. This value should be derived from the parent's author property. |
| DEVDIARY-118 | Support empty Aside Panels |
|
|
Done | Fixed |
Redesign the integration of the Aside Panel Macro to allow hiding empty panels. |
| DEVDIARY-117 | Support Short Name Queries |
|
|
Done | Fixed |
Allow to query for Names and Short Names alike with type doctypes. |
| DEVDIARY-116 | Add IDs Home/Index Page Boxes |
|
|
Done | Fixed |
The boxes on home pages and index pages need to provide a unique identifier to refer to these boxes individually from CSS. |
Doctypes for Project Management
The following changes are part of the latest Doctypes for Project Management.
| Key | Summary | T | P | Status | Resolution | Description |
|---|---|---|---|---|---|---|
| PDPRJMGMT-66 | Support empty Aside Panels |
|
|
Done | Fixed |
Redesign the integration of the Aside Panel Macro to allow hiding empty panels. |
| PDPRJMGMT-65 | Support Short Name Queries |
|
|
Done | Fixed |
Allow to query for Names and Short Names alike with type doctypes. |
| PDPRJMGMT-64 | Add IDs Home/Index Page Boxes |
|
|
Done | Fixed |
The boxes on home pages and index pages need to provide a unique identifier to refer to these boxes individually from CSS. |
Doctypes for Software Development
The following changes are part of the latest Software Development Doctypes.
| Key | Summary | T | P | Status | Resolution | Description |
|---|---|---|---|---|---|---|
| PDSWDEVD-135 | Support empty Aside Panels |
|
|
Done | Fixed |
Redesign the integration of the Aside Panel Macro to allow hiding empty panels. |
| PDSWDEVD-134 | Support Short Name Queries |
|
|
Done | Fixed |
Allow to query for Names and Short Names alike with type doctypes. |
| PDSWDEVD-133 | Add IDs Home/Index Page Boxes |
|
|
Done | Fixed |
The boxes on home pages and index pages need to provide a unique identifier to refer to these boxes individually from CSS. |
Doctypes for Teamwork
The following changes are part of the latest Doctypes for Teamwork.
| Key | Summary | T | P | Status | Resolution | Description |
|---|---|---|---|---|---|---|
| PDTEAMWORK-22 | Support empty Aside Panels |
|
|
Done | Fixed |
Redesign the integration of the Aside Panel Macro to allow hiding empty panels. |
| PDTEAMWORK-21 | Support Short Name Queries |
|
|
Done | Fixed |
Allow to query for Names and Short Names alike with type doctypes. |
| PDTEAMWORK-20 | Add IDs Home/Index Page Boxes |
|
|
Done | Fixed |
The boxes on home pages and index pages need to provide a unique identifier to refer to these boxes individually from CSS. |
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-23 | Support empty Aside Panels |
|
|
Done | Fixed |
Redesign the integration of the Aside Panel Macro to allow hiding empty panels. |
| PDVMXT-22 | Support Short Name Queries |
|
|
Done | Fixed |
Allow to query for Names and Short Names alike with type doctypes. |
| PDVMXT-21 | Add IDs Home/Index Page Boxes |
|
|
Done | Fixed |
The boxes on home pages and index pages need to provide a unique identifier to refer to these boxes individually from CSS. |
projectdoc arc42 Template
The following changes are part of the latest projectdoc Add-on for arc42.
| Key | Summary | T | P | Status | Resolution | Description |
|---|---|---|---|---|---|---|
| ARCFOURTWO-68 | Support empty Aside Panels |
|
|
Done | Fixed |
Redesign the integration of the Aside Panel Macro to allow hiding empty panels. |
| ARCFOURTWO-67 | Add IDs Home/Index Page Boxes |
|
|
Done | Fixed |
The boxes on home pages and index pages need to provide a unique identifier to refer to these boxes individually from CSS. |
| ARCFOURTWO-69 | Remove hard-coded Intro Text |
|
|
Done | Fixed |
By removing the hard coded intro text the boxes on the Home and Index Pages are shorter. |
| ARCFOURTWO-70 | Fix Null in Title of SWAD |
|
|
Done | Fixed |