projectdoc Toolbox 7.0.1 Release Notes

Section

Column

Document Properties Marker

doctype	release-note
override	false

Short Description

Confluence 9.1 Support, breaking change in Velocity integration.

Name

projectdoc Toolbox 7.0.1 Release Notes

Short Name

Parent

Parent Property

property-name	Name

hide

Audience

Name List

doctype	role
render-no-hits-as-blank	true
property	Audience
empty-as-none	true

Subject

Name List

doctype	subject
property	Subject

Sponsors

Name List

doctype	stakeholder
render-no-hits-as-blank	true
property	Sponsors

Sort Key

00007.00000.0010

hide

Section

show-title	false
title	Description

Today we released version

Display Property

property-name	Version

of the projectdoc Toolbox on the Atlassian Marketplace!

This version supports Confluence version 9.1.x.

This version introduces a breaking change (despite this is only labelled as a bugfix version!). If you use the Velocity integration, the API requires to provide the page identifier instead of the page object. This change is necessary due to a change on Confluence 9.1.0. The API used by the projectdoc Toolbox was not intended for use by apps.

For previous versions of Confluence there are separate versions of the projectdoc For previous versions of Confluence there are separate versions of the projectdoc Toolbox:

Confluence 8.x/7.x see
Static Document Link
document projectdoc Toolbox 6.2.13 Release Notes
label version 6.2.13
Confluence 9.0.x see
Static Document Link
document projectdoc Toolbox 7.0.0 Release Notes
label version 7.0.0

Panel

borderColor	darkgrey
borderWidth	2

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

Transclusion

document	HOMESPACE:projectdoc Video Link
ids	projectdoc

Content Marker

hide	true

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

Column

width	350px

Panel

title	Release Notes Overview

Table of Contents

indent	15px
exclude	Release Notes\|Description\|Summary\|References\|Resources
style	none

...

projectdoc-section

Section

title	New and Noteworthy

Section

title	Using Velocity with the projectdoc Toolbox

There is an update to the Velocity API of the projectdoc Context object. In previous versions the API required a Velocity Sitemesh Page object as argument. Due to compatibility changes on Confluence the API now requires to pass in the ID of the page as argument.

Code Block

language	text
title	Use $page.id instead of $page as argument

#if ($projectdocContext && $page)
 ${projectdocContext.toHtml($page.id)}
#end

Expand

title

Breaking Changes

	Expand to see the old use case with Velocity ...

Code Block

language	xml
title	Old Version which will not work with projectdoc Toolbox 7.0.1 and greater ...

#if ($projectdocContext)
 ${projectdocContext.toHtml($sitemeshPage)}
#end

Section

title	Selection Macro Rendering

Content Marker

consider-as-empty	true

Despite this is only a micro version (aka bugfix) update, it contains a breaking change. Please note that this version is only released for Confluence 9.1.x.

List of breaking changes with probably the largest impact on existing installations.

No issues found

Content Marker

is-empty-text

The rendering of Selection Macros, such as the

Static Document Link

document	Iteration Macro

is no longer taking the user's selected locale into account. Instead the value is always rendered using the site default locale.

See

Jira

server	smartics JIRA
columnIds	issuekey,summary,issuetype,priority,description,fixVersions
columns	key,summary,type,priority,description,fixVersions
maximumIssues	1000
jqlQuery	project = 'projectdoc Toolbox' && (fixVersion IN ('7.0.1')) && "Break"!='runtime (fix with reindex)' ORDER BY priority DESC, type DESC
serverId	79ad43bc-d289-364e-bfc7-46c09847bebd

Section

title	Known Issues

Section

title	Installation Instructions

Install the projectdoc Toolbox to your Confluence instance. There are no additional steps necessary.

Section

title	Upgrade Instructions

Update the projectdoc Toolbox on your Confluence instance.

Update all projectdoc Extensions and Doctype Add-ons you are using, since this version of the projectdoc Toolbox introduces API changes.

serverId	79ad43bc-d289-364e-bfc7-46c09847bebd
key	PDAC-1823

for details.

Section

title	Breaking Changes

Content Marker

consider-as-empty	true

Despite this is only a micro version (aka bugfix) update, it contains a breaking change. Please note that this version is only released for Confluence 9.1.x.

The breaking change is with the Velocity integration. Previous versions allowed to pass the Velocity Page object as parameter to the toHtml method. Since the type of the object is not meant as part of the public API of Confluence, we now need to use the page identifier instead of the whole page object. See

In-Document Link

anchor	New and Noteworthy

for details.

Content Marker

hide	true
consider-as-empty	true

List of breaking changes with probably the largest impact on existing installations.

Content Marker

is-empty-text	No issues found

Section

title	List of Changes

The following changes are part of version

Display Property

property-name	Version

of the projectdoc Toolbox for Confluence.

Jira

server	smartics JIRA
columnIds	issuekey,summary,issuetype,priority,description,fixVersions
columns	key,summary,type,priority,description,fixVersions
maximumIssues	1000
jqlQuery	project = 'projectdoc Toolbox' && (fixVersion

in

IN ('7.0.1')) && "Break"!='runtime (fix with reindex)' ORDER BY priority DESC, type

ASC

DESC
serverId	79ad43bc-d289-364e-bfc7-46c09847bebd

Section

title	Known Issues

Sort Key, Name

Section

title	Installation Instructions

Install the projectdoc Toolbox to your Confluence instance.

There are no additional steps necessary.

If you like to install an Extension or one or more Doctype Add-ons, please make sure to install the latest versions as shown below.

title	Subordinate Release Notes

Display Table

doctype

release-note

render-no-hits-as-blank

true

render-mode

definition

select

Name, Short Description

restrict-to-immediate-children

true

sort-by

Section

hidetitle	true
title	Related Releases
Upgrade Instructions

Update the projectdoc Toolbox on your Confluence instance.

Update all Doctype Add-ons you are using, since this version of the projectdoc Toolbox introduces API changes for the use of Blueprints.

In case your users used different locales when working with documents (for instance edit and refresh), then you probably would like to refresh the your spaces or the whole site. For detailed information, please refer to

Static Document Link

document	projectdoc Rebuild Manual

.

This version does not require updates of doctype-add-onsor the Web API Extension.

Section

title	Extension Add-ons

Content Marker

hide	true

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

Content Marker

id	doctype-add-ons-overview-copy

Tour

header-translations	Title=Doctype Add-on

TitleVersionWeb API Extension13.0.1Information Systems Extension8.0.0

Web API Extension

Section

title

List of Changes

The following changes are part

of the latest Web API Extension.

of version

Display Property

property-name	Version

of the projectdoc Toolbox for Confluence.

Jira

server	smartics JIRA
columnIds	issuekey,summary,issuetype,priority

,status,resolution

,description
columns	key,summary,type,priority,

status,resolution,

description
maximumIssues	1000
jqlQuery	project = '

PDEXWAPI

projectdoc Toolbox' && (fixVersion in ('

13

7.0.1')) ORDER BY priority DESC, type ASC
serverId	79ad43bc-d289-364e-bfc7-46c09847bebd

Section

title	Subordinate Release Notes

Display Table

doctype	release-note
render-no-hits-as-blank	true
render-mode	definition
select	Name, Short Description
restrict-to-immediate-children	true
sort-by	Sort Key, Name

Section

title	Related Releases

This version does not require updates of of the

Static Document Link

document	Web API Extension

or the

Static Document Link

document	Information Systems Extension

, but it does require the update of the Doctype Add-ons to the versions shown below.

Section

hide	true
title	Extension Add-ons

Content Marker

hide	true

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

Content Marker

id	doctype-add-ons-overview-copy

Tour

header-translations	Title=Doctype Add-on

Title	Version
Web API Extension	13.0.1
Information Systems Extension	8.0.0

Section

title	Web API

0')) ORDER BY type DESC, priority DESC

serverId

79ad43bc-d289-364e-bfc7-46c09847bebd

Section

hide	true
title	Bookmarklets Extension

The following changes are part of the latest Bookmarklets Extension.

Jira

server	smartics JIRA
columns	key,summary,type,priority,status,resolution,description
maximumIssues	1000
jqlQuery	project = 'PDEXBML' && (fixVersion = '4.0.2') ORDER BY type DESC, priority DESC
serverId	79ad43bc-d289-364e-bfc7-46c09847bebd

Section

title	Information Systems Extension

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

Jira

server	smartics JIRA
columnIds	issuekey,summary,issuetype,priority,status,resolution,description
columns	key,summary,type,priority,status,resolution,description
maximumIssues	1000
jqlQuery	project = 'PDEXINFOSY' && (fixVersion = '8.0.0') ORDER BY type DESC, priority DESC
serverId	79ad43bc-d289-364e-bfc7-46c09847bebd

Section

hide	true
title	Maven Extension

The following changes are part of the latest Maven Extension.latest

projectdoc-static-document-

box-cautionThis app is not available for Confluence Data Center

link-macro

document	Web API Extension

.

Jira

server	smartics JIRA
columnIds	issuekey,summary,issuetype,priority,status,resolution,description
columns	key,summary,type,priority,status,resolution,description
maximumIssues	1000
jqlQuery	project = 'PDEXMVNPDEXWAPI' && (fixVersion = in ('813.0.0')) ORDER BY type DESC, priority DESC
serverId	79ad43bc-d289-364e-bfc7-46c09847bebd-46c09847bebd

Section

title	Information Systems Extension

The following changes are part of the latest

Static Document Link

document	Information Systems Extension

.

Jira

server	smartics JIRA
columnIds	issuekey,summary,issuetype,priority,status,resolution,description
columns	key,summary,type,priority,status,resolution,description
maximumIssues	1000
jqlQuery	project = 'PDEXINFOSY' && (fixVersion = '8.0.0') ORDER BY type DESC, priority DESC
serverId	79ad43bc-d289-364e-bfc7-46c09847bebd

Section

title	Doctype Add-ons

The following doctype add-ons are required to be updated for the projectdoc Toolbox.

Content Marker

Section

title	Doctype Add-ons

The following doctype add-ons are required to be updated for the projectdoc Toolbox.

true

Content Marker

id	doctype-add-ons-overview

Tour

header-translations	Title=Doctype Add-on

Title

Version

Core Doctypes Add-on

19.0.0

Doctypes for Agile Planning

16.0.0

projectdoc Developer Diaries

16.0.0

Doctypes for Project Management

9.0.0

Doctypes for Service Management

6.1.0

Doctypes for Business Strategy

6.0.0

Doctypes for Software Development

15.0.0

projectdoc Add-on for arc42

13.0.0

Doctypes for Teamwork

5.0.1

Doctypes for V-Modell XT

7.0.0

projectdoc for Java Developers

not supported

projectdoc for Maven Developers

not suppoprted

Content Marker

hide

id	doctype-add-ons-overview-store

7.0.0

Tour

header-translations	Title=Doctype Add-on

Title	Version
Core Doctypes Add-on

19

20.0.0

Doctypes for Agile Planning

16

17.0.0

projectdoc Developer Diaries

16

17.0.0

Doctypes for Project Management

9

10.0.0

Doctypes for Service Management

6

7.

1

0.0

Doctypes for Business Strategy

6

7.0.0

Doctypes for Software Development

15

16.0.0

projectdoc Add-on for arc42

13

14.0.0

Doctypes for Teamwork

5.0.1

Doctypes for V-Modell XT

7.0.0

projectdoc for Java Developers

projectdoc for Maven Developers

6.0

.1

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.

In case any of the following doctype add-ons are used, they are required to be installed to work with this version of the projectdoc Toolbox.

Section

title	Core Doctypes

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

Jira

server	smartics JIRA
columnIds	issuekey,summary,issuetype,priority,status,resolution,description
columns	key,summary,type,priority,status,resolution,description
maximumIssues	1000
jqlQuery	project = 'PDCORED' && (fixVersion = '19.0.0') ORDER BY type DESC, priority DESC
serverId	79ad43bc-d289-364e-bfc7-46c09847bebd

Section

title	Doctypes for Agile Planning

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

Jira

server	smartics JIRA
columnIds	issuekey,summary,issuetype,priority,status,resolution,description
columns	key,summary,type,priority,status,resolution,description
maximumIssues	1000
jqlQuery	project = 'PDAGILE' && (fixVersion = '16.0.0') ORDER BY type DESC, priority DESC
serverId	79ad43bc-d289-364e-bfc7-46c09847bebd

.0
Doctypes for V-Modell XT	8.0.0

Content Marker

hide	true
id	doctype-add-ons-overview-store

Tour

header-translations	Title=Doctype Add-on

Title	Version
Core Doctypes Add-on	19.0.0
Doctypes for Agile Planning	16.0.0
projectdoc Developer Diaries	16.0.0
Doctypes for Project Management	9.0.0
Doctypes for Service Management	6.1.0
Doctypes for Business Strategy	6.0.0
Doctypes for Software Development	15.0.0
projectdoc Add-on for arc42	13.0.0
Doctypes for Teamwork	5.0.1
Doctypes for V-Modell XT	7.0.0

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.

In case any of the following doctype add-ons are used, they are required to be installed to work with this version of the projectdoc Toolbox.

Section

title	Core Doctypes

Section

title	projectdoc Developer Diaries

The following changes are part of the latest projectdoc Developer Diaries.Core Doctypes Add-on.

Jira

server	smartics JIRA
columnIds	issuekey,summary,issuetype,priority,status,resolution,description
columns	key,summary,type,priority,status,resolution,description
maximumIssues	1000
jqlQuery	project = 'DEVDIARYPDCORED' && (fixVersion = '1620.0.0') ORDER BY type DESC, priority DESC
serverId	79ad43bc-d289-364e-bfc7-46c09847bebd

Section

title	Doctypes for Project ManagementAgile Planning

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

Jira

server	smartics JIRA
columnIds	issuekey,summary,issuetype,priority,status,resolution,description
columns	key,summary,type,priority,status,resolution,description
maximumIssues	1000
jqlQuery	project = 'PDPRJMGMTPDAGILE' && (fixVersion = '917.0.0') ORDER BY type DESC, priority DESC
serverId	79ad43bc-d289-364e-bfc7-46c09847bebd

hide

Section

true	title	Doctypes for Risk Managementprojectdoc Developer Diaries

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

This extension is experimental.

Jira

server	smartics JIRAJIRA
columnIds	issuekey,summary,issuetype,priority,status,resolution,description
columns	key,summary,type,priority,status,resolution,description
maximumIssues	1000
jqlQuery	project = 'PDRISKMGMTDEVDIARY' && (fixVersion = '317.0.0') ORDER BY type DESC, priority DESC
serverId	79ad43bc-d289-364e-bfc7-46c09847bebd

Section

title	Doctypes for Service Project Management

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

Jira

server	smartics JIRA
columnIds	issuekey,summary,issuetype,priority,status,resolution,description
columns	key,summary,type,priority,status,resolution,description
maximumIssues	1000
jqlQuery	project = 'SERVICESPDPRJMGMT' && (fixVersion = '610.10.0') ORDER BY type DESC, priority DESC
serverId	79ad43bc-d289-364e-bfc7-46c09847bebd

Section

hide	true
title	Doctypes for Business StrategyRisk Management

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

This extension is experimental.

Jira

server	smartics JIRA	columnIds	issuekey,summary,issuetype,priority,status,resolution,description
columns	key,summary,type,priority,status,resolution,description
maximumIssues	1000
jqlQuery	project = 'STRATEGYPDRISKMGMT' && (fixVersion = '63.0.0') ORDER BY type DESC, priority DESC
serverId	79ad43bc-d289-364e-bfc7-46c09847bebd

Section

title	Doctypes for Software DevelopmentService Management

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

Jira

server	smartics JIRA
columnIds	issuekey,summary,issuetype,priority,status,resolution,description
columns	key,summary,type,priority,status,resolution,description
maximumIssues	1000
jqlQuery	project = 'PDSWDEVDSERVICES' && (fixVersion = '157.0.0') ORDER BY type DESC, priority DESC
serverId	79ad43bc-d289-364e-bfc7-46c09847bebd

Section

title	projectdoc arc42 TemplateDoctypes for Business Strategy

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

Jira

server	smartics JIRA
columnIds	issuekey,summary,issuetype,priority,status,resolution,description
columns	key,summary,type,priority,status,resolution,description
maximumIssues	1000
jqlQuery	project = 'ARCFOURTWOSTRATEGY' && (fixVersion = '137.0.0') ORDER BY type DESC, priority DESC
serverId	79ad43bc-d289-364e-bfc7-46c09847bebd

Section

title	Doctypes for TeamworkSoftware Development

The following changes are part of the latest Doctypes for TeamworkSoftware Development.

Jira

server	smartics JIRA
columnIds	issuekey,summary,issuetype,priority,status,resolution,description
columns	key,summary,type,priority,status,resolution,description
maximumIssues	1000
jqlQuery	project = 'PDTEAMWORKPDSWDEVD' && (fixVersion = '516.0.10') ORDER BY type DESC, priority DESC
serverId	79ad43bc-d289-364e-bfc7-46c09847bebd

Section

title	Doctypes for V-Modell XTprojectdoc arc42 Template

The following changes are part of the latest Doctypes for V-Modell XT projectdoc Add-on for arc42.

Jira

server	smartics JIRA
columnIds	issuekey,summary,issuetype,priority,status,resolution,description
columns	key,summary,type,priority,status,resolution,description
maximumIssues	1000
jqlQuery	project = 'PDVMXTARCFOURTWO' && (fixVersion = '714.0.0') ORDER BY type DESC, priority DESC
serverId	79ad43bc-d289-364e-bfc7-46c09847bebd

true

Section

hide

title	Doctypes for Java DevelopersTeamwork

The following changes are part of the latest projectdoc for Java Developers.This extension is experimentalDoctypes for Teamwork.

Jira

server	smartics JIRA
columnIds	issuekey,summary,issuetype,priority,status,resolution,description
columns	key,summary,type,priority,status,resolution,description
maximumIssues	1000
jqlQuery	project = 'PDJAVADEVPDTEAMWORK' && (fixVersion = '76.0.0') ORDER BY type DESC, priority DESC
serverId	79ad43bc-d289-364e-bfc7-46c09847bebd

Section

hide	true
title	Doctypes for Maven DevelopersV-Modell XT

The following changes are part of the latest projectdoc for Maven Developers.This extension is experimentalDoctypes for V-Modell XT.

Jira

server	smartics JIRA
columnIds	issuekey,summary,issuetype,priority,status,resolution,description
columns	key,summary,type,priority,status,resolution,description
maximumIssues	1000
jqlQuery	project = 'PDMVNDEVPDVMXT' && (fixVersion = '68.0.10') ORDER BY type DESC, priority DESC
serverId	79ad43bc-d289-364e-bfc7-46c09847bebd

...

Section

title	References

Content Marker

consider-as-empty	true

Links to information referenced in the release notes.

Tour

render-as-definition-list	true
replace-title-with-name	true

Title	Short Description
projectdoc Rebuild Manual

projectdoc-section

title	Resources

Content Marker

consider-as-empty	true

Additional resources on our website regarding the release of the projectdoc Toolbox.

Tour

render-as-definition-list	true
replace-title-with-name	true

Title	Short Description
Release Notes for the projectdoc Toolbox
Glossary
FAQs

Page tree

Docs

Support

Free Blueprints

Tooling for Blueprints

Free Extensions

Spaces

Plugins for Maven

Incubator

Libraries for Java

Incubator

Add-ons for Confluence

Tools

Support

Team

Legal

Versions Compared

Old Version 3

New Version Current

Key

About

Keep up-to-date!

Powered by