Date: Fri, 29 Mar 2024 11:18:54 +0100 (CET) Message-ID: <4586510.17912.1711707534435@09e9d69a2016> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_17911_554835070.1711707534435" ------=_Part_17911_554835070.1711707534435 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
New macros, improvements, and bug= fixes. Requires update of extensions and all doctype add-ons
Today we released version 1.17.0 of the projectdoc Toolbox on the <= a class=3D"external-link" href=3D"https://marketplace.atlassian.com/plugins= /de.smartics.atlassian.confluence.smartics-projectdoc-confluence/server/ove= rview" rel=3D"nofollow">Atlassian Marketplace!
The projectdoc Toolbox is an add-on for Conflue= nce supporting agile software development teams to collaborate on proce= ss, 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 vide= o!
The following image is a link to a=
video on YouTube. When you click the link your browser will serve a page f=
rom youtube.com
.
Very interesting, but way too fast?
S=
tep through at your own pace with with our Prezi Presentation (external link to prezi.com
)!
In the Online M= anual you=E2=80=99ll find additional video material that introduces you= in the concepts of the projectdoc Toolbox.
Refer to use cases an= d show cases for inform= ation on how to use the projectdoc To= olbox.
The following changes may be the most interesting of this release.
The Tour Macro acce=
pts templates containing property references in columns that do not referen=
ces the document. That is ${}
and $[]
(for linked=
property values) may be used in table cells to define the rendered content=
. This feature makes it very easy to define columns where text with m=
ultiple properties are rendered.
The Di=
splay List Template Macro allows templates to specify the content of th=
e list items. Use ${}
and $[]
=
(for linked property values) to reference propery values with the Name Template and the Data Template.
See =
PDAC=
-748 - Getting issue details...
The new Transclusion to Text Macro allows to transclude content from a Conflue=
nce page as plain text. This macro is usful in use cases where the transcluded content is furthe=
r processed by an enclosing macro (like the Body Graph Macro).Tran=
sclusion to Text Macro
Due to an internal API change all doctype add-ons and the <= a href=3D"/confluence/display/PDAC1/Bookmarklets+Extension">Bookmarklets Ex= tension need to be updated.
See =
PDAC=
-758 - Getting issue details...
In case a cell of the table inside the Tour Macro contains text value, this test is rendered i=
nstead of the property whose value is referenced by the column title. The German translation for Space Title is now "Bereichstitel" instead of=
"Bereich" due to PDAC-771 - Getting issue details... In previous versions the transclusion defined the part of transcluded co=
ntent by the title of a Secti=
on. With this version the ID (if present) is used. When referencing the=
ID of a section, changes to the title would not take effect on the transcl=
usion defined in other pages (since the ID stays the same).Tour Macro
Renamed Artificial Property for Locale DE
Tra=
nsclusions defined by ID
The following topics have to be considered for an upgrade to this versio= n.
Install the new OBR of the projectdoc Toolbox first.
The following add-ons need to be updated to work with this version of th= e projectdoc Toolbox.
Add-on for the projectdoc Toolbox | Required Version |
---|---|
7.0.0 or newer
|
|
7.0.0 or newer
|
|
5.0.0 or newer
|
|
6.0.0 or newer
|
|
5.0.0 or newer
|
|
3.0.0 or newer
|
|
3.0.0 or newer
|
|
2.0.0 or newer
|
|
2.0.0 or newer
|
|
1.3.1 or newer
|
Due to a new artificial property, called Space Link, a reindex is recommended.
If not, existing pages do not have this additional property.
The complete list of changes for this release.
Key | Summary | T | P | Status | Resolution | Description |
---|---|---|---|---|---|---|
PDAC-775<= /a> | Allow Template for Proper= ty Values in Tour Macro | <= /a> | Done | Fixed | Allow to add template= s in non-referencing table columns. |
|
PDAC-748<= /a> | Display List Template Mac= ro | <= /a> | Done | Fixed | Provide a display lis= t macro that allows to specify a pattern for rendering list items and defin= ition list keys and values. |
|
PDAC-749<= /a> | Original Value for Delega= te Property | <= /a> | Done | Fixed | The delegate property= feature only delegates the rendered property. This has been sufficien= t for all our use cases. But now we need to access the original value to de= rive information from. This is the case for the Tour-by-Property Macro that= parses link information from the original value. Therefore we need t= o add the blank value from the delegate document in addition to the rendere= d value. |
|
PDAC-763<= /a> | Transclusion-to-Text Macr= o | <= /a> | Done | Fixed | We need a macro to re= nder the transcluded content as plain text. Since this may be a security ri= sk we need an extra macro instead of a checkbox in the existing Transclusio= n Macro. There needs to be a Confluence Wiki Markup version of this n= ew macro. |
|
PDAC-772<= /a> | Template Macro Link Suppo= rt | <= /a> | Done | Fixed | Currently all is a li= nk, but only $[...] should. |
|
PDAC-774<= /a> | Override Cell for Tour Ma= cro | <= /a> | Done | Fixed | If a table cell in a = tour macro contains text, this text is rendered instead of the referenced p= roperty. |
|
PDAC-753<= /a> | Support Index Entries wit= h Comma | <= /a> | Done | Fixed | The Index Macros do n= ot allow entries with a comma in their names. To support this, the index ma= cros need to make the separator configurable. |
|
PDAC-768<= /a> | Support Table Width Contr= ol | <= /a> | Done | Fixed | Provide means to cont= rol the width of the section style properties table for the Display Table M= acro. |
|
PDAC-759<= /a> | Support Multiple Links wi= th Tour-by-Property Macro | <= /a> | Done | Fixed | Currently values for = the Tour-by-Property Macro need to be separated by comma. If these are link= s, we can determine them even without the separator. |
|
PDAC-770<= /a> | Render Doctype Value with= Link to Doctype Homepage | <= /a> | Done | Fixed | The Display Property = Macro should render a link to the doctyper's homepage for the doctype prope= rty value. |
|
PDAC-756<= /a> | Provide CSS Parameter to = Name List Macro | <= /a> | Done | Fixed | Allow users to add a = CSS style to the list rendered by the name list, name body list, and tag li= st macro. |
|
PDAC-771<= /a> | Space Link as Artificial = Property | <= /a> | Done | Fixed | We should make it eas= ier to link to a space a document is part of. Therefore we need the p= roperty "Space" that provides a link to the space that is already provided = as "Space Key" and "Space Title". |
|
PDAC-769<= /a> | Support Properties render= ed as List | <= /a> | Done | Fixed | The Display Table Mac= ro should allow the properties above the sections be rendered as a definiti= on list. |
|
PDAC-760<= /a> | Plain List Rendering = | <= /a> | Done | Fixed | Allow Lists to be ren= dered as plain text. Values are separated by the specified delimiter, ', ' = by default. |
|
PDAC-765<= /a> | Support All Catch Identit= y | <= /a> | Done | Fixed | Since the "-" on an i= dentifier also includes the identifier as positively defined, we need a way= to define "Everything but some" -A, !X would be resolved as "A and n= othing else". -A, *, !X would now be resolved as "A and everything el= se but X" |
|
PDAC-757<= /a> | Support alternative Value= Separators | <= /a> | Done | Fixed | Allow to specify an a= lternative property value separator. |
|
PDAC-761<= /a> | Support Transclusion Macr= o in Confluence Wiki Syntax | <= /a> | Done | Fixed | In order to combine t= ransclusion with other macros that rely on the old Confluence Wiki Syntax w= e need to support this syntax, too. |
|
PDAC-767<= /a> | Support Suppressing Table= Header in Section Mode | <= /a> | Done | Fixed | The Display Table Mac= ro allows to suppress the table header, but it does not yet support section= mode. This enhancment should extend the feature on the table rendere= d above the sections. |
|
PDAC-752<= /a> | Transclusion of Step Macr= o | Done | Fixed | The level calculation= of transcluded section macros fails. The rendered section elements w= ithin the section macro will assume to be at a wrong target level. |
||
PDAC-750<= /a> | Tour-by-Property fails to= work with Delegate Properties | Done | Fixed | Due to Once |
||
PDAC-764<= /a> | Column With Calculation w= ith Counter Column | Done | Fixed | The Display Table Mac= ro confuses the column widths if they are explicitly specified and the coun= ter column is activated. If the counter column is activated, the widt= h for that column should be controlled, too. |
||
PDAC-773<= /a> | Index Links for Short Nam= es | Done | Fixed | In an index with shor= t names the short name entries should link to the (full) name entries.= This works for tables, but not for definition list and numbered/unnu= mbered lists. The ID for the HTML element is not generated. |
||
PDAC-766<= /a> | Check for NPE in Persiste= nce Listener | Done | Fixed | On checking if a= n attachment needs to be updated, there may not be an 'old document'. If th= ere is none we run into an NPE instead of returning 'false'. |
||
PDAC-762<= /a> | Sort on Short Names fails= | Done | Fixed | When sorting on injec= ted short names for the index macro, the sort key is wrongly injected. It i= s based on the name while it should be based on the short name. |
||
PDAC-755<= /a> | Template Calculation fail= s | Done | Fixed | The calculation of th= e doctype for the parent page fails, if no template or blueprint is availab= le. As a last check we need to find the template label to return as the nam= e of the doctype. |
||
PDAC-751<= /a> | Base Delegating Sections = on ID | Done | Fixed | When delegating secti= ons, the delegating sections should be based on the ID if there is one. =Currently it is only based on the title. When referencing the ID o= f a section, changes to the title would not take effect on the transclusion= defined in other pages (since the ID stays the same). |
||
PDAC-758<= /a> | Target Page Template not = used | Done | Fixed | If a doctype defines = a template for the target page, this template is not taken into account. |
||
PDAC-754<= /a> | Display Table Macro NPE <= /a> | Done | Fixed | Using the Displaytabl= e macro with the following configuartion leads to an NPE in DisplayListHelp= er.java:406. |
Doctype add-ons provide space and page blueprints based on the projectdo= c Toolbox.
Key | Summary | T | P | Status | Resolution | Description |
---|---|---|---|---|---|---|
PDCORE= D-121 | Update for projectdoc = Toolbox 1.17 | Done | Fixed | Due to a breaking cha= nge this update is required for the add-on to work with the projectdoc Tool= box version 1.17. |
||
PDCORE= D-122 | Add Charters Link to W= orkspace Space | Done | Fixed | Add a link to the cha= rters homepage from the "For Authors" section in the Workspace space. = td> |
Key | Summary | T | P | Status | Resolution | Description |
---|---|---|---|---|---|---|
PDSWDE= VD-91 | Update for projectdoc = Toolbox 1.17 | Done | Fixed | Due to a breaking cha= nge this update is required for the add-on to work with the projectdoc Tool= box version 1.17. |
||
PDSWDE= VD-92 | Quality and Code Homep= ages are missing | Done | Fixed | In the dialog of the = homepage blueprint, entries for the Quality and Code and Code Type homepage= s are missing. |
||
PDSWDE= VD-93 | Move Short Description= of Homepage | Done | Fixed | Move the Short Descri= ption Property of homepages to the first position in the document propertie= s table. Since excerpts of pages are shown in search results, this short de= scription is more meaningful to readers than the doctype and name of the do= cument. |
||
PDSWDE= VD-95 | Move Short Description= of Homepage | Done | Fixed | Move the Short Descri= ption Property of homepages to the first position in the document propertie= s table. Since excerpts of pages are shown in search results, this short de= scription is more meaningful to readers than the doctype and name of the do= cument. |
Key | Summary | T | P | Status | Resolution | Description |
---|---|---|---|---|---|---|
ARCF= OURTWO-33 | Update for projectdo= c Toolbox 1.17 | Done | Fixed | Due to a breaking cha= nge this update is required for the add-on to work with the projectdoc Tool= box version 1.17. |
Key | Summary | T | P | Status | Resolution | Description |
---|---|---|---|---|---|---|
PDAGILE= -40 | Update for projectdoc T= oolbox 1.17 | = | Done | Fixed | Due to a breaking cha= nge this update is required for the add-on to work with the projectdoc Tool= box version 1.17. |
|
PDAGILE= -44 | Dependency Error breaks= Team Renderer | Done | Fixed | Due to a false depend= ency the team renderer does not work on all Confluence versions. |
||
PDAGILE= -41 | Move Short Description = of Homepage | Done | Fixed | Move the Short Descri= ption Property of homepages to the first position in the document propertie= s table. Since excerpts of pages are shown in search results, this short de= scription is more meaningful to readers than the doctype and name of the do= cument. |
||
PDAGILE= -43 | Links on Retrospective = and Review Index Pages | Done | Fixed | The link on the index= page of the Retrospective Doctype and the Review Doctype should render pla= in, if the referenced index page does not yet exist. |
Key | Summary | T | P | Status | Resolution | Description |
---|---|---|---|---|---|---|
DEVDIA= RY-55 | Update for projectdoc = Toolbox 1.17 | Done | Fixed | Due to a breaking cha= nge this update is required for the add-on to work with the projectdoc Tool= box version 1.17. |
||
DEVDIA= RY-58 | Dependency Error break= s Templates | Done | Fixed | Due to a false depend= ency a number of template related classes are broken on some versions of Co= nfluence. |
||
DEVDIA= RY-56 | Move Short Description= of Homepage | Done | Fixed | Move the Short Descri= ption Property of homepages to the first position in the document propertie= s table. Since excerpts of pages are shown in search results, this short de= scription is more meaningful to readers than the doctype and name of the do= cument. |
Key | Summary | T | P | Status | Resolution | Description |
---|---|---|---|---|---|---|
PDJAV= ADEV-14 | Update for projectdoc= Toolbox 1.17 | Done | Fixed | Due to a breaking cha= nge this update is required for the add-on to work with the projectdoc Tool= box version 1.17. |
||
PDJAV= ADEV-18 | NPE in Creating a new= Space from POM | = td> | Done | Fixed | When creating a new s= pace from a POM file (specified by the GAV coordinates), the following mess= age is logged: [INFO] [talledLocalContainer] Caused by: java.lang.NullPointerExcep=
tion There seems to be = no problem with the generated space, though. |
|
PDJAV= ADEV-16 | Move Short Descriptio= n of Homepage | = td> | Done | Fixed | Move the Short Descri= ption Property of homepages to the first position in the document propertie= s table. Since excerpts of pages are shown in search results, this short de= scription is more meaningful to readers than the doctype and name of the do= cument. |
Key | Summary | T | P | Status | Resolution | Description |
---|---|---|---|---|---|---|
PDMVND= EV-11 | Update for projectdoc = Toolbox 1.17 | Done | Fixed | Due to a breaking cha= nge this update is required for the add-on to work with the projectdoc Tool= box version 1.17. |
||
PDMVND= EV-14 | Datatype from Plugin D= escriptor fails in Translation | Done | Fixed | |||
PDMVND= EV-12 | Move Short Description= of Homepage | Done | Fixed | Move the Short Descri= ption Property of homepages to the first position in the document propertie= s table. Since excerpts of pages are shown in search results, this short de= scription is more meaningful to readers than the doctype and name of the do= cument. |
Key | Summary | T | P | Status | Resolution | Description |
---|---|---|---|---|---|---|
PDPRJ= MGMT-18 | Update for projectdoc= Toolbox 1.17 | Done | Fixed | Due to a breaking cha= nge this update is required for the add-on to work with the projectdoc Tool= box version 1.17. |
||
PDPRJ= MGMT-22 | Dependency Error brea= ks Templates | = td> | Done | Fixed | Due to a false depend= ency a number of template related classes are broken on some versions of Co= nfluence. |
|
PDPRJ= MGMT-19 | Move Short Descriptio= n of Homepage | = td> | Done | Fixed | Move the Short Descri= ption Property of homepages to the first position in the document propertie= s table. Since excerpts of pages are shown in search results, this short de= scription is more meaningful to readers than the doctype and name of the do= cument. |
|
PDPRJ= MGMT-21 | Minutes Template Acti= on Description | = td> | Done | Fixed | The description of th= e action section is only describing the team member who takes responsibilit= y. It should explain that the actions to take should be listed here. |
Extension add-ons extends the functionality of the projectdoc Toolbox.= p>
Key | Summary | T | P | Status | Resolution | Description |
---|---|---|---|---|---|---|
PDEXBML-= 7 | Update for projectdoc To= olbox 1.17 | <= /a> | Done | Fixed | Due to a breaking cha= nge this update is required for the add-on to work with the projectdoc Tool= box version 1.17. |