You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

projectdoc Toolbox

projectdoc documents are stored in caches for quick access. Users may want to clear one of these caches.

With the following actions that interact with the caches users can execute:

  1. Refresh Page - refreshes this page only
  2. Refresh Page Tree - refreshes this page and all descendant pages
  3. Flush Page Transclusions - kicks the fragments of all referenced pages from the cache (since version 1.9.0)
  4. Refresh Doctype Cache - refreshes the document type information derived from the page blueprints
  5. Clear Fragments Cache - clears fragments of pages used for transclusion (since version 1.9.0)

These actions access the following caches:

  1. projectdoc Document Cache - caches document representations for fast access
  2. projectdoc Doctype Cache - caches doctype information found in templates
  3. projectdoc Fragments Cache - caches fragments for special use cases that take heavily advantage from transclusion (deactivated by default)

There is an additional cache for mapping document type help texts called projectdoc Documentation Cache.

As administrator you can control the document, doctype and documentation caches via Cache Management in your Confluence Admin. The fragments cache is stored in the database. There is no additional cache layer.

Here is the screenshot for these actions:

 

Since version 1.9.0 the refresh of a page (first two actions) will also remove the page from the page fragments cache.

Granting Access

These actions are shown in the tools menu of a page, if

  • the page is a projectdoc document
  • the user has edit permissions on that page
  • the user is member of a required group

All of the above conditions have to be met.

 

It is not enforced that only users of these groups can execute the actions. They are just not displayed to users who usually do not need to use them.

Role-Action Matrix

A user is required to be associated to one of the following groups to have access to the given action.


Refresh PageRefresh Page TreeFlush Page TransclusionsRefresh Doctype CacheClear Fragments Cache
projectdoc-authors(tick)(tick)(tick)(error)(error)
projectdoc-template-authors(tick)(tick)(tick)(tick)(tick)
projectdoc-admins(error)(error)(tick)(tick)(tick)
projectdoc-gardeners(tick)(tick)(tick)(tick)(tick)
projectdoc-documentation-architects(tick)(tick)(tick)(tick)(tick)
projectdoc-developers(tick)(tick)(tick)(tick)(tick)

Since 1.12

Prior to version 1.12 of the projectdoc Toolbox there has been only one role: projectdoc-developers.

Troubleshooting

You may want to check your caches if your Ancestor searches (see Search Tips) do not display the assumed results. In case of the downstream search check if your document provide valid values for the AncestorTypeNames property. If not, you need to refresh the pages (i.e. the projectdoc Document Cache).

If you encounter difficulties with the upstream search, refreshing your projectdoc Doctype Cache should be sufficient.

Resources

  • No labels