Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section


Column


Document Properties Marker
overridefalse


Short DescriptionCompatibility with Confluence 7.4, Enhanced Space Properties,  Enhanced Materializing of Properties, Toggle Links, Enhanced Document Property Controls, Enhanced Home Page Links, and support for Accessing Auto-ID Context Informationmuch more.
Doctyperelease-notehide
Nameprojectdoc Toolbox 4.5 Release Notes
Short Name
Parent
Parent Property
property-nameName
hide
Audience
Name List
doctyperole
render-no-hits-as-blanktrue
propertyAudience
empty-as-nonetrue

Subject
Name List
doctypesubject
propertySubject

Categories
Name List
doctypecategory
propertyCategories

Tags
Tag List
propertyTags

Iteration

Iteration
valueproduction

hide
Type
Name List
doctyperelease-note-type
render-no-hits-as-blanktrue
propertyType

Version4.5hide
Productprojectdoc Toolboxhide
Release Date

20 Mar  

hide
Sponsors
Name List
doctypestakeholder
render-no-hits-as-blanktrue
propertySponsors

Sort Key00004.00005.0000hide



Section
show-titlefalse
titleDescription

Today we released version 

Display Property
property-nameVersion
of the projectdoc Toolbox on the Atlassian Marketplace!

This release provides compatibility with Confluence 7.4, new features, improvements, and bugfixes.

Panel
borderColordarkgrey
borderWidth2

The projectdoc Toolbox is an add-on for Confluence supporting agile software development teams to collaborate on process, project, system, and product documentation. 

Transclusion
documentHOMESPACE:projectdoc Video Link
idsprojectdoc



Info Box

Download the projectdoc Toolbox or visit the projectdoc Toolbox on the Atlassian Marketplace!




Column
width350px


Panel
titleRelease Notes Overview

Table of Contents
indent15px
excludeRelease Notes|Description|Summary|"References"|Resources
stylenone



...

) to take advantage of this improved service

Section
titleNew and Noteworthy


Section
titleEnhanced Space Properties

Properties that define the space closures can now be defined in space properties extensions.

This is an important feature for publishing processes. Now all space specific properties can be collected on a separate page that is treated different from other published pages.

Space properties are also rendered, therefore macros can be used in more space property values.

For more information see 

Jira
serversmartics JIRA
serverId79ad43bc-d289-364e-bfc7-46c09847bebd
keyPDAC-1222
.


Section
titleMaterialize Properties

This new version allows template authors to easily materialize values by the use of the mat document property control.

Materialization can also be controlled by the space property named Materialize by Doctype.

This allows the use of Deep Links on the left side of a Where constraint (see Search Tips).


Section
titleRemote Controlling Macros

Transcluding macros now take advantage of the Remote Control feature. By the use if Remote Controls these macros configure the context of the rendering process and alter the rendering result.

The following macros support remote controls (the Wiki Link Macro supported this feature in the past and does so by the use of HTTP request parameters):

Display Table
doctypemacro, app-macro
render-modedefinition
where$<Tags>=[Remote Controller]
space-keyPDAC1


Section
titleToggle Feature for Wiki Links

The Wiki Link Macro allows, based on its Remote Control Parameters, to toggle between two states. Since the macro is now also allowed to reference the document it is part of, this feature can be used to toggle between two views of the same page.

A typical use case is to have a condensed and another expanded version of a table.

The tip Toggle Views shows this use case in some detail.


Section
titleMatch Pattern for Display Property Macro

There are new parameters for the Display Document Property Macro that allow to define a match pattern by a regular expression and use the matched groups in a template.

This new feature allows users to grab parts of a property value and reuse its parts in its own value. For instance: if you document a product which has the version number in its name, then the short name could be defined as the name without the version. So in case the name is changed, the short name is updated accordingly.


Section
titleEmpty Content

The Content Marker Macro and Section Macro may now be tagged as being empty. This allows wrapping containers to control more specifically to hide if all its content is considered to be empty.

This is the generalization of the Ignore Template Buttons where a section is considered empty if this button is the only visible element inside a content marker or section.


Section
titleImprovements to Property ControlsPretend being a Printer

In previous versions the only way to switch to printer mode to export Confluence pages to PDF or Word has been to set the user space property Pretend Being A to the value 'printer'. This has been only possible for users who created a user space for their own.

With this version the mode is automatically selected in case the output type of PDF or Word has been selected. This new feature not only makes it much easier to switch to printer and activate quirk modes, but makes this feature also available to users without a user space.


Section
titleTemplates for Tour Macro

With this version the header column may contain a template to render multiple properties in one column.

Use the standard syntax to define a template.

Code Block
languagetext
#T{$[Name] (${Type})}

Use the column translation parameter to specify the column header label.


Section
titleArtificial URL Property Values

The URL and Tiny URL artificial properties now follow the following semantics.

PropertySemantics
URL, Tiny URLThe URL as an HTML anchor element.
URL$, Tiny URL$The label for the URL.
URL§, Tiny URL§The plain URL.

These semantics already have been applied to other URL properties.

Here is more information on 

Static Document Link
documentArtificial Properties
 and
Static Document Link
anchorUniform Resource Locators
documentArtificial Properties
tooltipArtificial properties having Uniform Resource Locators as value.
labelURLs of artificial properties
.


Section
titleImprovements to Property Controls


Section
titleEditing Property Controls

The REST services now allow users to edit document property controls. Please updated to the latest version of the Web API Extension (see

Jira
serversmartics JIRA
serverId79ad43bc-d289-364e-bfc7-46c09847bebd
keyPDEXWAPI-48
) to take advantage of this improved service.


Section
titleClean Controls

Document property controls are now cleaned from HTML elements per default.

Pasting a property control with the Confluence editor often not only copies the control string, but also HTML elements, like span with some CSS attributes. While the additional HTML markup is often not easily perceived by users, the parser does not recognize the control, assuming that the additional HTML elements are of significance.

We now assume that there is no need for users to add markup to the controls column of their Document Properties Marker Macro (or related macros). Therefore we remove them before parsing the control strings.



The REST services now allow users to edit document property controls. Please updated to the latest version of the Web API Extension (see

This version provides some improvements so that this information is working more intuitively out-of-the box. See 

Section
titleHomepage Links

The Wiki Link Macro provides style clues on whether or not there are documents of a given type in the current space or if this information is delegated to another space.

Section
titleEditing Property Controls
Jira
serversmartics JIRA
serverId79ad43bc-d289-364e-bfc7-46c09847bebd
keyPDAC-1225
Jira
serversmartics JIRA
serverId79ad43bc-d289-364e-bfc7-46c09847bebd
keyPDAC-1226
, and 

Jira
serversmartics JIRA
serverId79ad43bc-d289-364e-bfc7-46c09847bebd

keyPDEXWAPI-48
keyPDAC-1227
  for more information.


Section
titleREST Services for Auto IDs

We now provide some internal services to have access to the configuration of Auto IDs. While this is still an internal API – and therefore subject to change without notice – it may be a valuable tool for users who need to see the actual configuration.


The Wiki Link Macro provides style clues on whether or not there are documents of a given type in the current space or if this information is delegated to another space.

This version provides some improvements so that this information is working more intuitively out-of-the box. See 
Section
title
Clean Controls

Document property controls are now cleaned from HTML elements per default.

Pasting a property control with the Confluence editor often not only copies the control string, but also HTML elements, like span with some CSS attributes. While the additional HTML markup is often not easily perceived by users, the parser does not recognize the control, assuming that the additional HTML elements are of significance.

We now assume that there is no need for users to add markup to the controls column of their Document Properties Marker Macro (or related macros). Therefore we remove them before parsing the control strings.

Section
titleHomepage Links
Jira
serversmartics JIRA
serverId79ad43bc-d289-364e-bfc7-46c09847bebd
keyPDAC-1225
Jira
serversmartics JIRA
serverId79ad43bc-d289-364e-bfc7-46c09847bebd
keyPDAC-1226
, and 
Unlicensed Rendering

The Section Macro and Content Marker Macro render their body even if there is no license provided. This allows users to still see their content in the web view after the license expired.

When no license is provided the macro parameters and the body is rendered.

Here is an example of a page rendered without license.

Image Added

The section Child Documents shows the text content and some macros used in its body. For the Display Table Macro only the configured parameters are rendered. For the Tour Macro besides the macro parameters the body (with a table) is also rendered.

Note that it is only guaranteed that the body and parameters will be visible. All other features of the projectdoc Toolbox may or may not work.



  for more information.
Section
titleBreaking Changes

Issue 

Jira
serversmartics JIRA
serverId79ad43bc-d289-364e-bfc7

-46c09847bebd
keyPDAC-1227
Section
titleREST Services for Auto IDs

We now provide some internal services to have access to the configuration of Auto IDs. While this is still an internal API – and therefore subject to change without notice – it may be a valuable tool for users who need to see the actual configuration.

Section
titleBreaking Changes

-46c09847bebd
keyPDAC-1226
 might be considered a breaking change by users. We consider it a fix to the semantics.

Also issue Issue 

Jira
serversmartics JIRA
serverId79ad43bc-d289-364e-bfc7-46c09847bebd
keyPDAC-1226
 might be considered a breaking change by users. We consider it a fix to the semantics.Also
1243
 defines a couple of properties defined on projectdoc document pages that are also provided as space properties (such as the space homepage or extension documents) to be not considered space properties. While we consider this to be a fix, some users may experience this as a breaking change according to their use cases.

The issue 

Jira
serversmartics JIRA
serverId79ad43bc-d289-364e-bfc7-46c09847bebd
keyPDAC-1243
 defines a couple of properties defined on projectdoc document pages that are also provided as space properties (such as the space homepage or extension documents) to be not considered space properties. While we consider this to be a fix, some users may experience this as a breaking change according to their use cases
1269
 may be considered a breaking change since users accessing the property URL or Tiny URL will retrieve a value that contains an HTML code fragment. Use cases that expect the plain URL would need to access URL§ or Tiny URL§. This is not considered a breaking change since the semantics already have been defined that way, but the two artificial properties failed to adhere to these. So this is a bug fix.


Section
titleKnown Issues

Display Table
doctypesection
render-no-hits-as-blanktrue
render-modedefinition
restrict-to-immediate-childrentrue
where$<Flags>=[Known Issue]

...

Section
titleRelated Releases


Section
titleExtension Add-ons

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

Section
titleWeb API Extension

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

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDEXWAPI' && (fixVersion = '8.0.0') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
titleBookmarklets Extension

The following changes are part of the latest Bookmarklets Extension.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDEXBML' && (fixVersion = '34.10.10') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
hidetrue
titleInformation Systems Extension

The following changes are part of the latest Information Systems Extension.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDEXINFOSY' && (fixVersion = '3.1.13') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
hidetrue
titleMaven Extension

The following changes are part of the latest Maven Extension.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDEXMVN' && (fixVersion = '6.0.1') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd



Section
titleDoctype 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.

Section
hidetrue
titleCore Doctypes

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

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDCORED' && (fixVersion = '1314.10.10') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
hidetrue
titleDoctypes for Agile Planning

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

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDAGILE' && (fixVersion = '11.1.12') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
titleprojectdoc Developer Diaries

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

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'DEVDIARY' && (fixVersion = '12.0.0') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
titleDoctypes for Project Management

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

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDPRJMGMT' && (fixVersion = '5.1.1') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
hidetrue
titleDoctypes for Risk Management

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

This extension is experimental.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDRISKMGMT' && (fixVersion = '3.0.0') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


true
Section
hide
titleDoctypes for Service Management

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

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'SERVICES' && (fixVersion = '3.2.0') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
hidetrue
titleDoctypes for Business Strategy

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

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'STRATEGY' && (fixVersion = '3.1.01') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
titleDoctypes for Software Development

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

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDSWDEVD' && (fixVersion = '11.1.1') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


true
Section
hide
titleDoctypes for Teamwork

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

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDTEAMWORK' && (fixVersion = '3.1.1') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
hidetrue
titleDoctypes for V-Modell XT

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

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDVMXT' && (fixVersion = '3.1.01') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
hidetrue
titleprojectdoc arc42 Template

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

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'ARCFOURTWO' && (fixVersion = '9.0.1' || (fixVersion = '9.1.01') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
hidetrue
titleDoctypes for Java Developers

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

This extension is experimental.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDJAVADEV' && (fixVersion = '5.1.01') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd


Section
hidetrue
titleDoctypes for Maven Developers

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

This extension is experimental.

Jira
serversmartics JIRA
columnskey,summary,type,priority,status,resolution,description
maximumIssues1000
jqlQueryproject = 'PDMVNDEV' && (fixVersion = '5.1.01') ORDER BY type DESC, priority DESC
serverId79ad43bc-d289-364e-bfc7-46c09847bebd



...

Section
required-permissionswrite-access
titleNotes


Section
hidetrue
titleDownload

Since there is a temporary problem on the Atlassian Marketplace to download the OBRs (projectdoc Toolbox and add-ons), we add the links here.

Attachments
patterns*.obr, *.jar


Section
titleReferences


Section
titleResources


Tour
render-as-definition-listtrue
replace-title-with-nametrue


TitleShort Description
Release Notes
Glossary
FAQs



...