投稿者の概要マクロ
投稿者の概要マクロは、一連のページについて投稿者をベースとした統計を表にして表示します。この統計は個々のページまたは投稿者ごとにグループ化することが可能です。
マクロの適用範囲は、単独 1 ページですが、指定したページの直近の子や子孫ページまで拡張可能です。以下のタイプの投稿者の統計を算出します：
- ページの編集を行う
- ページにコメントを追加する
- ページにラベルを追加する
- ページをウォッチしている人
以下のスクリーンショットは投稿者サマリーマクロの例です。この統計表は各投稿者がページを編集した回数、ページにコメントを追加した回数、ページにラベルを追加した回数を表示しています。
スクリーンショット：投稿者マクロ統計表の例
この例では、すべて既定のパラメーター設定を使用しています。マクロのパラメーターの詳細情報については、以下のパラメーターセクションを参照してください。
投稿者の概要マクロを使用する
投稿者の概要マクロをページに追加するには：
- Confluence のエディタで、[挿入] > [その他のマクロ] を選択します。
- 対象のマクロを見つけて、選択します。
オートコンプリートでマクロエントリを高速化： タイプ{とマクロ名の先頭には、提案したマクロの一覧を表示します。詳細は、こちらを参照ください。リンク、ファイル、マクロ、メンションのオートコンプリート
既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。マクロのパラメータが編集可能な場合、マクロのダイアログ ウィンドウが開きます。
パラメーター
Parameters are options that you can set to control the content or format of the macro output. Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the macro browser, it will be listed below in brackets (example).
パラメーター | 既定 | 説明 |
|---|---|---|
グループ | contributors | 投稿者ベース統計をグループ化する基準を指定します：
|
表示する列 | edits、comments、labels | 表に表示するカラムを設定します。表示する統計または情報の種類はグループパラメーターで設定されたグループ設定の基準により決定されます。以下の内容に対して統計を算出します：
|
並び替え順序 | edits | 表内で項目を並べ替える際に使用する基準を設定します。並べ替える項目はグループパラメーターで設定されたグループ化の基準によって決定されます。並べ替え基準とは：
|
逆順ソート | false | 表内の項目を、指定した並べ替えパラメーターを使用して逆の順番で並べ替えます。（並べ替え パラメーターと併用時のみ利用可能です。） |
項目の最大数 | 制限なし | 指定した値に対する表内の投稿者数またはページ数を制限します。数字を指定しない場合、すべての項目が表示されます。 |
匿名投稿者の表示 | false | ページに匿名で投稿した投稿者も含まれます。 |
ゼロの表示 / 非表示 | false | 統計結果がゼロだった投稿者またはページも含めるか否か設定します。 |
ページ名 | current | 投稿者ベースの統計を算出する対象ページを設定します。ページ名およびスペースに値が何も指定されていない場合、 現在のページを前提とします。 |
ラベル | なし | 投稿者ベースの統計を指定したラベルのみに制限します。カンマ区切りで複数のラベルを指定できます。 |
スペース | current | 指定したページを含む Confluence スペースのスペースキーを指定するか、あるいは検索するスペースの範囲を指定します。スペースキーは大文字／小文字を区別します。 カンマ区切りで複数のスペースキーまた特殊値を指定できます。 |
コンテンツ タイプ | pages と blog posts の両方 | ページの種類をページ (pages) またはブログ投稿 (blogposts) に制限します。マクロブラウザに値が指定されていない場合、ページとブログ投稿の両方が含まれます。 許可される値: |
ブログ投稿日 | なし | ブログ投稿の公開日を指定します。日付は YYYY/MM/DD 形式で入力します。 |
ページ階層を含む | 指定されたページのみ | 指定したページの直近の子ページまたはすべての子孫ページのどちらを含むか指定します。マクロブラウザに値が指定されていない場合、指定したページのみが含まれます。 |
コードの例
次の例は、Confluence ページの基本的なマークアップを調べたり、編集したりする上級ユーザー向けに提供されています。
マクロ名: contributors-summary
マクロ本文: なし。
保存形式の例
この例では、ブログ投稿のコンテンツ タイプを指定しています。
<ac:structured-macro ac:name="contributors-summary">
<ac:parameter ac:name="limit">10</ac:parameter>
<ac:parameter ac:name="spaces">
<ri:space ri:space-key="ds"/>
<ri:space ri:space-key="@personal"/>
</ac:parameter>
<ac:parameter ac:name="reverse">true</ac:parameter>
<ac:parameter ac:name="showAnonymous">true</ac:parameter>
<ac:parameter ac:name="order">update</ac:parameter>
<ac:parameter ac:name="labels">chocolate,cake</ac:parameter>
<ac:parameter ac:name="columns">edits,comments,labels,lastupdate</ac:parameter>
<ac:parameter ac:name="groupby">pages</ac:parameter>
<ac:parameter ac:name="contentType">blogposts</ac:parameter>
<ac:parameter ac:name="showZeroCounts">true</ac:parameter>
<ac:parameter ac:name="publishDate">2012/06/07</ac:parameter>
</ac:structured-macro>この例では、ページ コンテンツ タイプを指定しています。
<ac:structured-macro ac:name="contributors-summary">
<ac:parameter ac:name="limit">10</ac:parameter>
<ac:parameter ac:name="spaces">
<ri:space ri:space-key="ds"/>
<ri:space ri:space-key="@personal"/>
</ac:parameter>
<ac:parameter ac:name="reverse">true</ac:parameter>
<ac:parameter ac:name="showAnonymous">true</ac:parameter>
<ac:parameter ac:name="scope">descendants</ac:parameter>
<ac:parameter ac:name="order">update</ac:parameter>
<ac:parameter ac:name="page">
<ac:link>
<ri:page ri:content-title="Advanced Topics" ri:space-key="ds"/>
</ac:link>
</ac:parameter>
<ac:parameter ac:name="labels">chocolate,cake</ac:parameter>
<ac:parameter ac:name="columns">edits,comments,labels,lastupdate</ac:parameter>
<ac:parameter ac:name="groupby">pages</ac:parameter>
<ac:parameter ac:name="contentType">pages</ac:parameter>
<ac:parameter ac:name="showZeroCounts">true</ac:parameter>
</ac:structured-macro>Wiki マークアップの例
この例では、ブログ投稿のコンテンツ タイプを指定しています。
{contributors-summary:limit=10|spaces=ds,@personal|reverse=true|showAnonymous=true|order=update|labels=chocolate,cake|columns=edits,comments,labels,lastupdate|groupby=pages|contentType=blogposts|showZeroCounts=true|publishDate=2012/06/07}この例では、ページ コンテンツ タイプを指定しています。
{contributors-summary:limit=10|spaces=ds,@personal|reverse=true|showAnonymous=true|scope=descendants|order=update|page=ds:Advanced Topics|labels=chocolate,cake|columns=edits,comments,labels,lastupdate|groupby=pages|contentType=pages|showZeroCounts=true}