投稿者の概要マクロを挿入する

投稿者の概要マクロは、一連のページについて投稿者をベースとした統計を表にして表示します。この統計は個々のページまたは投稿者ごとにグループ化することが可能です。

マクロの適用範囲は、単独 1 ページですが、指定したページの直近の子や子孫ページまで拡張可能です。以下のタイプの投稿者の統計を算出します:

  • ページの編集を行う

  • ページにコメントを追加する

  • ページにラベルを追加する

  • ページをウォッチしている人

以下のスクリーンショットは投稿者サマリーマクロの例です。この統計表は各投稿者がページを編集した回数、ページにコメントを追加した回数、ページにラベルを追加した回数を表示しています。

投稿者の概要マクロを使用する

投稿者の概要マクロを追加するには:

  1. 編集時には、ツールバーから を選択します。

  2. 挿入するアイテムを探して選択します

  3. [挿入] を選択します。

このページに「/」と入力して、ツールバーからを選択し、同じリストを表示することも可能です。

投稿者の概要マクロを編集するには:

  1. マクロのプレースホルダーを選択します。フローティング ツールバーが表示されます。

  2. 編集を選択します。右側のパネルが開きます。

  3. パラメータを修正します。変更内容は、移動するごとに保存されます。

  4. ページの編集を再開すると、パネルが閉じます。

パラメーター

パラメータは、マクロ出力の内容や形式を制御するために設定するオプションです。 

Confluence Cloud ストレージ形式または wikimarkup で使用されるパラメーター名が、ブラウザやスラッシュ コマンドを使用してマクロを挿入する際に使用されるラベルと異なる場合は、下記の角括弧内に記載します ()。

パラメーター

既定

説明

Group By
(groupby

contributors

投稿者ベース統計をグループ化する基準を指定します:

  • contributors — 投稿した人によってグループ化

  • pages — 投稿者を検索するために使用したページによってグループ化。

Columns to Display
(columns

edits、comments、labels

表に表示するカラムを設定します。表示する統計または情報の種類はグループパラメーターで設定されたグループ設定の基準により決定されます。以下の内容に対して統計を算出します:

  • edits — 各投稿者がページを編集した回数、または各ページに成された編集の回数。

  • edited — 各投稿者が編集したページのリスト、または各ページを編集した投稿者のリスト。

  • comments — 各投稿者がページにコメントを追加した回数、または各ページに追加されたコメントの数。

  • commented — 各投稿者がコメントを追加したページのリスト、または各ページにコメントを追加した投稿者のリスト。

  • labels — 各投稿者がページにラベルを追加した回数、または各ページに追加されたラベルの数。

  • labeled — 各投稿者がラベルを追加したページのリスト、または各ページにラベルを追加した投稿者のリスト。

  • labellist — 各投稿者が追加したまたは各ページに追加されたラベルのリスト。

  • watches — 各投稿者/人からウォッチされているページ数、または各ページをウォッチしている投稿者/人の人数。

  • watching — 各投稿者/人からウォッチされているページのリスト、または各ページをウォッチしている投稿者/人のリスト。

  • lastupdate — 各投稿者が最後に更新した時間、または各ページが最後に更新された時間。有効な更新にはページへの編集、コメント修正、ラベル修正が含まれます。

    複数の列を使用できます。

Sort By
(order

edits

表内で項目を並べ替える際に使用する基準を設定します。並べ替える項目はグループパラメーターで設定されたグループ化の基準によって決定されます。並べ替え基準とは:

  • edits — 投稿者によってなされた編集、またはページになされた編集の総数に基づき表内の項目を並べ替えます。

  • name — 投稿者名またはページ名のアルファベット順によって表内の項目を並べえます。

  • editTime — 投稿者がページ (または指定した複数のページ) を最終更新した時間、またはページが最終更新された時間によって表内の項目を並べ替えます。

  • update — 投稿者が最後にページ (または指定した複数のページ) に投稿した日時、またはページに最後に投稿があった日時を基に表内の項目を並べ替えます。

Reverse Sort
(reverse

false

表内の項目を、指定した並べ替えパラメーターを使用して逆の順番で並べ替えます。(並べ替え パラメーターと併用時のみ利用可能です。)

Maximum Number of Items
(limit

制限なし

指定した値に対する表内の投稿者数またはページ数を制限します。数字を指定しない場合、すべての項目が表示されます。

Show Anonymous Contributions?
(showAnonymous

false

ページに匿名で投稿した投稿者も含まれます。

Show Zero Counts?
(showZeroCounts

false

統計結果がゼロだった投稿者またはページも含めるか否か設定します。

Page Name
(page

current

投稿者ベースの統計を算出する対象ページを設定します。ページ名およびスペースに値が何も指定されていない場合、 現在のページを前提とします。

Label(s)
(labels

なし

投稿者ベースの統計を指定したラベルのみに制限します。カンマ区切りで複数のラベルを指定できます。

Space(s)
(spaces

current

指定したページ名を含む Confluence スペースのスペース キーを指定するか、検索するスペースのスコープを指定します。スペース キーでは大文字と小文字が区別されます。

また、このパラメーターは次のような特殊な値を使用します。

  • @global — すべてのサイト スペース。

  • @personal — すべてのパーソナル スペース。

  • @all - Confluence サイト内のすべてのスペース。

コンマ区切りで 1 つ以上のスペース キーや特別な値を指定できます。

ページ名ラベルを指定しない場合は、指定した一連のスペースにあるすべてのページが含まれます。

Content Type
(contentType

pages と blog posts の両方

ページの種類をページ (pages) またはブログ投稿 (blogposts) に制限します。マクロブラウザに値が指定されていない場合、ページとブログ投稿の両方が含まれます。

有効な値: pagesblogposts

Blog Post Date
(publishDate

なし

ブログ投稿の公開日を指定します。日付は YYYY/MM/DD 形式で入力します。

Include Page Hierarchy
(scope

指定されたページのみ

指定したページの直近の子ページまたはすべての子孫ページのどちらを含むか指定します。マクロブラウザに値が指定されていない場合、指定したページのみが含まれます。

Wiki マークアップの例

Wiki マークアップは従来のエディタでのみサポートされます。

Wiki マークアップはエディタ外部でマクロを追加する必要がある場合 (スペースのサイドバー、ヘッダー、またはフッターのカスタム コンテンツなど) に便利です。

Macro name: contributors-summary

マクロ本文: なし。

この例では、ブログ投稿のコンテンツ タイプを指定しています。

1 2 3 4 {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}

この例では、ページ コンテンツ タイプを指定しています。

1 2 3 4 {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}

 

その他のヘルプ