Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Column
Document Properties Marker
overridefalse
Short DescriptionA short introduction using the impersonator feature of the projectdoc Toolbox. In this example we examine what to do to reuse a layout defined in another document.
Doctypetopichide
NameImpersonator - using Live Templates
Short Name
Parent
Parent Property
property-nameName
hide
Audience

Name List
doctyperole
render-no-hits-as-blanktrue
render-list-as-comma-separated-valuestrue
namesAuthor, Template Author, Documentation Architect
propertyAudience


Subject
Name List
doctypesubject
propertySubject

Categories
Name List
doctypecategory
propertyCategories

Tags

Tag List
namesImpersonator, Transclusion, projectdoc Toolbox, Confluence, Template, Content Reuse, Layout
propertyTags

hide
Flagshide
Iteration

Iteration
valuefocused

hide
Type

Name List
doctypetopic-type
render-no-hits-as-blanktrue
namesTip
propertyType


Level of Experience

Name List
doctypeexperience-level
render-no-hits-as-blanktrue
namesCompetent
propertyLevel of Experience


Expected Duration
Sponsors
Name List
doctypestakeholder
render-no-hits-as-blanktrue
propertySponsors

Sort Keyhide
Column
Panel
titleContents

Table of Contents
indent10px
stylenone

Section
show-titlefalse
titleDescription

Transclusion is a powerful tool for content reuse. Impersonation takes this feature of the PDAC1 for Confluence one step further an allows to render content transcluded from another document in one's own context.

Sounds complicated? Well it isn't.

Section
titleSummary

Section
titlePrerequisites

This feature is available for the projectdoc Toolbox for Confluence since version 2.7.

Column
Panel
titleContents

Table of Contents
indent10px
stylenone

Section
titleImpersonator - the Concept

What is the impersonator feature?

First: What is transclusion? The Transclusion Macro allows to reuse content from another projectdoc document. The content is referenced from the page that contains the Transclusion Macro. The content is rendered in the referenced page and the rendered content is then inserted at the location of the Transclusion Macro.

Now impersonation: The Transclusion Macro is also in use for impersonation. In the case the Impersonate parameter of the Transclusion Macro must be checked. The Transclusion Macro still references content on another page, but this time the unrendered content is delivered to the transcluding page and the this content is rendered in the context of the transcluding page. The context is typically the document properties and the document sections of the transcluding document.

That's the theory. Now let's have a look at an example!

...