ユーザー リスト マクロ

マクロ

このページの内容

お困りですか?

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

コミュニティに質問

ユーザー リスト マクロは、グループのメンバーシップに基づいて Confluence ユーザーの一覧を表示します。マクロは、ユーザーがオンラインかオフラインかも示します。

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


ユーザー リスト マクロの使用

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

  1. エディタのツールバーで、[挿入] > [その他のマクロ] を選択します。
  2. 対象のマクロを見つけて、選択します。

オートコンプリートを活用して素早く入力: {」とマクロ名の先頭を入力すると、マクロ候補の一覧が表示されます。この例では、cheese マクロを挿入します。

既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。これによりマクロの詳細を開き、マクロのパラメーターを編集できます。

パラメータ

パラメータは、マクロ出力の内容や形式を制御するために設定するオプションです。Confluence の保存形式または wiki マークアップで使用されるパラメータ名がマクロ ブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example)。

パラメータ

既定

説明

グループ
(groups

なし

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

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

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

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

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

許可される値:

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

オンライン/オフラインのユーザーを表示するようこのマクロを設定する方法の詳細については、以下を参照してください。

Wiki マークアップの例

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

マクロ名: userlister

マクロ本文: なし。

{userlister:groups=confluence-users|online=false}

ユーザー リスト マクロの設定

Display Online / Offline Users パラメーターを使用して、ユーザーが現在 Confluence にログイン中かどうかを示すには、システム アプリで、このマクロを提供する User Log In Listener コンポーネントを有効化する必要があります。これを実行するには、Confluence 管理者権限が必要です。

ユーザー リスト マクロで [オンライン/オフラインのユーザーを表示] フィルターを有効化するには:

  1. > [アプリの管理] に移動します。

  2. ドロップダウンから [システム] を選択し、[User Lister] を検索します。
  3. 一覧を展開し、User Log In Listener モジュールを有効化します。
  4. 変更内容を反映するには、 Confluence を再起動します。

最終更新日: 2019 年 12 月 3 日

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

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