• 関連ドキュメント
クラウド

We're updating our terminology in Jira

'Issue' is changing to 'work item'. You might notice some inconsistencies while this big change takes place.

投稿者マクロを挿入する

投稿者マクロはページに何らかの投稿を行ったことがある Confluence ユーザーを一覧として表示します。ページのウォッチャーを一覧表示する際にも使用できます。

マクロの適用範囲は、指定したページの子や子孫ページまで拡張可能です。投稿者の一覧は次の作業を行ったユーザーから作成されます。

  • ページの作成または編集

  • ページへのコメントまたはラベルの追加

  • ページのウォッチ

投稿者マクロを追加するには、次の手順に従います。

  1. 編集時には、 ツールバーから

  2. マクロを名前で検索して選択します。

  3. 必要に応じて設定します。

このページに「/」と入力して、ツールバーから を選択することで、同じリストを表示することもできます。続けてマクロの名前を入力して、リストをフィルタリングします。

投稿者マクロを編集するには、次の手順に従います。

  1. マクロのプレースホルダーを選択します。

  2. [編集] アイコン を選択して、設定パネルを開きます。

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

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

中央揃え 、幅 、全幅 の各アイコンを使用して、一部のマクロの幅を調整することもできます。マクロを削除するには、ゴミ箱アイコン を選択します。

パラメーター

パラメーターとは、設定してマクロの内容をページに表示する方法を制御できるオプションです。 

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

パラメーター

既定

説明

Contribution Type
(include) 

authors

ページ (およびオプションでその子孫ページ) で行われた投稿のタイプ、またはページのウォッチによる絞り込み。投稿者タイプは次のものになります。

  • authors - ページを作成または編集したユーザーを含む

  • comments - ページにコメントしたユーザーを含む

  • labels - ページにラベルを追加したユーザーを含む

  • watches - ページをウォッチしてるユーザーを含む。

    コンマ区切りで複数の投稿タイプを指定できます。

Sort By
(order) 

count

投稿者の並べ替えに使用される基準を指定します。並べ替え基準には次のものがあります。

  • count - ページへの投稿数でユーザーを並べ替え

  • name - ユーザーをアルファベット順に並べ替え

  • update - ページへの最終投稿日でユーザーを並べ替え

Reverse Sort
(reverse) 

false

Reverses the sort order of contributors in the list. Must be used in conjunction with the Sort By parameter.

最大投稿者数

(limit)

制限なし

投稿者一覧での人数を制限します。数字を指定しない場合、すべての投稿者が表示されます。

Display Format
(mode) 

inline

投稿者一覧での名前の表示形式を設定します。

  • inline — カンマ区切りの一覧

  • list — 箇条書きの一覧

Show Anonymous Contributions?
(showAnonymous) 

false

ページに匿名で投稿した人を含めるかどうかを設定します。

Show Count?
(showCount) 

false

指定した投稿タイプでの投稿回数を投稿者ごとに表示するかどうかを設定します。

Show Last Contribution Time?
(showLastTime) 

false

指定した投稿タイプでの投稿の最新日時を投稿者ごとに表示するかどうかを設定します。

Page Name
(page) 

current

投稿者リストを作成する際に使用するページを指定します。ページ名とスペースが空白の場合、現在のページと見なされます。

Label(s)
(labels) 

なし

投稿者の一覧を、ページで指定したラベルを作成したユーザーで絞り込みます。カンマ区切りで複数のラベルを指定できます。

Space(s)
(spaces) 

current

Specifies the space key of the Confluence space that contains the page set in Page Name or alternatively, specifies the spaces to search. Space keys are case-sensitive.

This parameter also takes special values, including:

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

  • @personal — すべての個人用スペース。

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

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

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

Content Type
(contentType) 

pages と blog posts の両方

投稿者一覧を作成する際に使用するコンテンツ タイプを制限します。

  • pages — ページ

  • blogposts — ブログ投稿

Blog Post Date
(publishDate) 

なし

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

Include Page Hierarchy
(scope) 

指定されたページのみ

投稿者一覧を生成する際に追加で含めるページを指定します。

  • children — 指定したページの子ページのみ

  • descendants — 指定したページのすべての子孫ページ

Show Selected Pages
(showPages) 

false

投稿者一覧の生成に使用したページの一覧を表示するかどうかを設定します。

Custom "None Found" Message
(noneFoundMessage) 

既定のメッセージ

投稿者が見つからなかった際に表示する既定のメッセージを上書きする内容を指定します。

 

 

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。
コミュニティに質問
コミュニティ質問、ディスカッション、記事