...
Understanding Keychains
The key (excuse the pun) to understanding Reporting is to understand how keychains work.
...
So in this context, the content:modifier key is calling the modifier parameter from the Content Supplier to find out which user updated the page.
Because the modifier parameter from the Content Supplier returns a User type value, we can then "chain" a parameter from the User Supplier, in this case, the picture parameter, to retrieve the profile image of the user that updated the page.
...
First, we'll have to find to ask Reporting to retrieve the title.
Create a Report Info macro.
For the Key, type in "content:title"
This means we're using the Content Supplier to retrieve the properties of Title parameter, which is of the Text type.You should now have this:
which should result in the following text:
"Chaining Keys with Keychains"Now that we have the title, let's ask Reporting to actually count the characters in the title.
Edit the Report Info macro you created.Amend the Key parameter so it now looks like this: "content:title > text:size"
This means that we are now passing the value of the content:title to the Text Supplier, to retrieve the Size parameter.
You should now have this:
Which should result in this:
"28"And now we know that the title of this page (Chaining Keys with Keychains) contains 28 characters, including spaces.
...
First, let's get Reporting to retrieve the creator name.
Create a Report Info macro.
For the Key, type in "content:creator".
This means we're using the Content Supplier to retrieve the properties of Creator parameter, which is of the User type.
Let's also make the creator name a hyperlink to his profile by ticking the Link To Item checkbox.You should now have this:
which should result in the following:
"Ted Mahsun"Now, create another Report Info macro.
For the Key, type in "content:creator > user:authored pages count".
This means that we are now passing the value of the content:creator to the User Supplier, to retrieve the Authored Pages Count parameter.You should now have this:
which should result in this:
"1137"Let's make this more readable.
String the two Report Info macros that you created together with some relevant words to form a sentence.
For example:
which should result in this:
"Ted Mahsun has written 1137 pages in this Confluence instance."
...
Create a Report Image macro.
For the Key, type in "content:modifier > user:picture".
This means we are using the Content Supplier to retrieve the properties of the Modifier parameter (which is of the User type).
And then we chain that onto the User Supplier to retrieve the properties of the Picture parameter.You should now have this:
which will render this: