projectdoc Toolbox 2.6 Release Notes

Auto-Increment feature, improvements and bugfixes.

Today we released version 2.6.1 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

Auto Increment

The projectdoc Toolbox now provides support to add an automatically incremented identifier to the title of a page. This feature is called Auto Increment.

The identifier is also provided as an artificial property named Auto ID.

The configuration is done at space level via the space property named Doctype Auto ID Pattern. It has to be configured for each doctype individually.

For more information please refer to Auto Increment in Title.

Home and Index Page Flags

Instead of tagging Home Pages and Index Pages, these pages are now flagged. This moves these technical tags out of the view and leaves these for the domain. This is necessary since we do not provide documentation for these markers and tags are typically documented, while flags are not.

The values are now prefixed with 'projectdoc'.

The index page will be flagged with

projectdoc.doctype-index, projectdoc.all, projectdoc.related.doctype.${doctypeId}

The home page will be flagged with

projectdoc.doctype-index, projectdoc.all, projectdoc.related.doctype.${doctypeId}

Please note that existing pages need to be updated accordingly to be found with Lucene.

Upgrade Instructions

Install the new OBR of the projectdoc Toolbox.

Updating the following extensions is required.

Extension Add-on for the projectdoc Toolbox Version
3.2.0
8.0.0

Updating the following doctype add-ons is recommended.

List of Changes

The following changes are part of the latest projectdoc Toolbox for Confluence.

Key Summary T P Status Resolution Description
PDAC-994 Auto Increment Feature New Feature Critical (migrated) Done Fixed

Make it easy to add a unique identifier to the title for configured doctypes.

PDAC-995 space-local in User Space broken New Feature Major Done Fixed

If space-local is used with the user space, it is not obeyed in every use case.

If space-local is set, then the property must not be used outside of the user's space.

PDAC-993 Service Detecting Duplicate Index Documents New Feature Major Done Fixed

Provide a service to detect duplicate index document by page title.

PDAC-992 Identify Home and Index Pages Improvement Major Done Fixed

Currently only the index page it tagged to be identifiable. Since tags should be documented and are typical shown, the identification of home and index pages, which is probably only technically relevant, should not be shown.

Therefore the metadata will be moved to the Flags property.

In order to make the flags unique and not interfere with the information design of users, they will be prefixed with "projectdoc.".

The index page will be flagged with

projectdoc.doctype-index, projectdoc.all, projectdoc.related.doctype.${doctypeId}

The home page will be flagged with

projectdoc.doctype-index, projectdoc.all, projectdoc.related.doctype.${doctypeId}

doctypeId refers to "blank" which is the only doctype in the projectdoc Toolbox artifact.

PDAC-989 Create I18N Bean only once Improvement Minor (migrated) Done Fixed

The I18N Bean in the Doctype Service is calculated multiple times. Make it be calculated only once.

PDAC-988 Recheck Doctype Cache Entry Improvement Minor (migrated) Done Fixed

In case of a cache miss we should recheck once we get into the monitor. We cannot do something wrong here, but may be able to prohibit a reinit of the cache with a simple check.

PDAC-987 Page class checks Improvement Minor (migrated) Done Fixed

Check content entities and abstract pages for their concrete type even if the context of the cast would imply it to be a page.

PDAC-990 Space Wizard fails after deactivating Doctype Add-on Bug Critical (migrated) Done Won't Do

After deactivating a doctype add-on that provides blueprints, the space blueprint wizard fails.

The user encounters an error message that reads: "An unknown server error has occurred."

The attached screenshot shows this error message that is displayed after clicking on "Spaces", then "Create Space: The wizard does not start successfully.

The logfile contains these lines:

[INFO] [talledLocalContainer] ..... WARN [http-nio-1990-exec-7] [confluence.impl.hibernate.ConfluenceHibernateTransactionManager] doRollback Performing rollback. Transactions:
[INFO] [talledLocalContainer] ->[PluginReadWriteTx]: PROPAGATION_REQUIRED,ISOLATION_DEFAULT (Session #.....)
[INFO] [talledLocalContainer] – referer: ...../confluence/pages/viewpage.action?spaceKey=PP&title=x | url: /confluence/rest/create-dialog/1.0/space-blueprint/dialog/web-items | traceId: ..... | userName: .....

PDAC-997 Allow HTML Elements for Definition List Data Bug Major Done Fixed

HTML elements inside the table cells, like an image, should be rendered.

PDAC-996 Space-local Blueprints not taken into account Bug Major Done Fixed

When the projectdoc Toolbox creates new documents based on blueprints programatically, it does take into account changes made to the template of a blueprint at space level.

This is for instance the case when a document is created by the Web API.

PDAC-991 Fix Categories Key in Blank Doctype Template Bug Minor (migrated) Done Fixed

The key of the Categories property must be changed to *.categories.

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.