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

Compare with Current View Page History

« Previous Version 3 Next »

projectdoc Toolbox

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

There are basically four actions that interact with the caches every user 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)

The document cache is called projectdoc Document Cache, the doctype cache projectdoc Doctype Cache. As administrator you can control these 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-authorsxxx  
projectdoc-template-authorsxxxxx
projectdoc-admins  xxx
projectdoc-gardenersxxxxx
projectdoc-documentation-architectsxxxxx
projectdoc-developersxxxxx

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