ユーザー リスト マクロ

マクロ

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

ユーザー リスト マクロをページに追加すると、特定のグループの Confluence ユーザーの一覧を表示できます。マクロは、ユーザーがオンラインかオフラインかも示します。 

これは従来のマクロで、非常に大きなサイトではパフォーマンスに問題が生じることがあります。このマクロを使用してサイト内のすべてのユーザーの表示を試みることは推奨されません。

On this page:

スクリーンショット: ユーザー リスト マクロが 2 つ含まれるページ。

制限事項

多数のユーザーがいるサイトでは、ユーザー リスト マクロが大量のメモリを消費する場合があります。サイトでメモリ不足エラーが発生するのを防ぐため、指定したグループに 10,000 以上のユーザーがいる場合、このマクロは表示されません。管理者は confluence.extra.userlister.limit システム プロパティの設定により、この制限を変更できます。

このマクロをページに追加する

ユーザー リスト マクロをページに追加するには:

  1. エディタのツールバーで、[挿入] > [その他のマクロ] を選択します。
  2. [Confluence コンテンツ] カテゴリから [ユーザー リスト] を選択します。
  3. 表示したいグループを入力します。
  4. [挿入] をクリックします。 

その後、ページを公開するとマクロの動作を確認できます。 

スクリーンショット: グループのメンバーを表示するためのユーザー リスト マクロの設定。 

マクロ パラメーターを変更する

マクロ パラメーターは、マクロの動作を変えるために使用します。

マクロ パラメーターを変更するには、次の手順を実行します。

  1. エディタでマクロのプレースホルダーをクリックし、[編集] を選択します。
  2. 必要に応じてパラメーターを更新し、[挿入] を選択します。

このマクロで使用できるパラメーターの一覧は、次のとおりです。 

パラメーター

既定

説明

グループ
(groups

なし

グループ名を指定します。複数のグループをコンマで区切って指定するか、*を使用して Confluence のすべてのユーザーを表示します。

他のユーザーの詳細を見ることができるユーザーを制御する方法の詳細については、このナレッジベース ページを参照してください。

オンライン / オフラインのユーザーを表示
(online

登録されている全ユーザー

オンラインまたはオフライン ユーザーをリストします。ステータスに関係なく、すべてのユーザーを表示するには、空白のままにします。

許可される値:

  • 指定なし – マクロはすべての登録ユーザーを表示します。
  • true  –マクロはオンラインのユーザーのみを表示します。
  • false – マクロはオフラインのユーザーのみを表示します。

Confluence の保存形式または wiki マークアップで使用されるパラメーター名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example)。

このマクロを追加するその他の方法

手入力でこのマクロを追加する

{」と入力してからマクロ名の入力を開始すると、マクロの一覧が表示されます。

Wiki マークアップを使用してこのマクロを追加する

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

マクロ名: userlister

マクロ本文: なし。

{userlister:groups=confluence-users|online=false}
最終更新日: 2023 年 10 月 13 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.