Scenario

There may be cases where you may want to aggregate blogposts on a Confluence instance in a page. By using the Content Reporter, you can do exactly that.

This recipe lists all blog posts from all spaces together with their summaries.

Result

Recipe

Apps


Reporting for Confluence Server & Data Center


Level

Easy

Estimated time

10 minutes

Macros

Content Reporter, Report Column, Report Info, Report Table

Suppliers

Content Supplier

Storage format

You can copy and paste this code into the Confluence Source Editor:

<p class="auto-cursor-target">
  <br />
</p>
<ac:structured-macro ac:macro-id="0b2be6c8-38eb-4af6-abb6-012725a2f155" ac:name="report-table" ac:schema-version="1">
  <ac:rich-text-body>
    <p class="auto-cursor-target">
      <br />
    </p>
    <ac:structured-macro ac:macro-id="b6cfc5f2-c305-41b5-ad70-e34cd24e9945" ac:name="content-reporter" ac:schema-version="1">
      <ac:parameter ac:name="type">news</ac:parameter>
      <ac:parameter ac:name="space">
        <ri:space ri:space-key="@all" />
      </ac:parameter>
      <ac:rich-text-body>
        <p>
          <br />
        </p>
      </ac:rich-text-body>
    </ac:structured-macro>
    <p class="auto-cursor-target">
      <br />
    </p>
    <ac:structured-macro ac:macro-id="4f26c099-76b6-48b7-9895-1cbd9ae29341" ac:name="report-column" ac:schema-version="1">
      <ac:parameter ac:name="title">Blog Posts</ac:parameter>
      <ac:rich-text-body>
        <p>
          <ac:structured-macro ac:macro-id="815283b4-ec94-470a-83c0-4455a25d47a0" ac:name="report-info" ac:schema-version="1">
            <ac:parameter ac:name="">content:title</ac:parameter>
          </ac:structured-macro>
        </p>
      </ac:rich-text-body>
    </ac:structured-macro>
    <p class="auto-cursor-target">
      <br />
    </p>
    <ac:structured-macro ac:macro-id="00b2b5ba-dd44-47bb-91f2-cfd0d8710b82" ac:name="report-column" ac:schema-version="1">
      <ac:parameter ac:name="title">Summaries</ac:parameter>
      <ac:rich-text-body>
        <p>
          <ac:structured-macro ac:macro-id="43389236-d09a-4cc3-83e9-d47c90f5acf7" ac:name="report-info" ac:schema-version="1">
            <ac:parameter ac:name="">content:summary</ac:parameter>
          </ac:structured-macro>
        </p>
      </ac:rich-text-body>
    </ac:structured-macro>
    <p class="auto-cursor-target">
      <br />
    </p>
  </ac:rich-text-body>
</ac:structured-macro>
<p class="auto-cursor-target">
  <br />
</p>

Macro structure

You can recreate the example in the editor view:

Steps

Line

Description

1

The report will be formatted as a table with Report Table.

2

Content Reporter is used retrieve all blogs from all spaces, with spaces parameter is set to '@all', and type parameter set to 'news'.

3

Two columns is created Report Column, with title set accordingly.

4

Name of each blog retrieved from Content Reporter is displayed via Report Info, setting supplier key to 'Content Supplier'.

5

Summary of each blog retrieved from Content Reporter is displayed via Report Info, setting supplier key to 'Content Supplier'

Line-by-Line Explanation

  • N/A