検索結果マクロ
検索結果マクロは、マクロ パラメーターで指定した検索語に基づいて Confluence サイトを検索し、wiki ページﾞに結果を表示します。
検索結果マクロの使用
ページに検索結果マクロを追加するには:
- エディタのツールバーで、[挿入]
> [その他のマクロ] を選択します。 - 対象のマクロを見つけて、選択します。
オートコンプリートを活用して素早く入力: 「{」とマクロ名の先頭を入力すると、マクロ候補の一覧が表示されます。この例では、cheese マクロを挿入します。
既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。これによりマクロの詳細を開き、マクロのパラメーターを編集できます。
パラメーター
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).
パラメーター | 既定 | 説明 |
|---|---|---|
検索語 | なし | このマクロが結果の生成に使用する検索語です。 詳細については、Confluence 検索構文 のドキュメントをご覧ください。 |
結果の最大数 | 10 | 表示される検索結果数の制限を設定します。 |
このスペース キーに制限する | すべて | スペース名を入力してスペースを検索するか、検索するスペースのキーを指定します。キーは大文字と小文字を区別します。 |
コンテンツ タイプ | すべて | コンテンツ タイプを指定します。コンテンツ タイプには次があります。page、comment、blogpost、attachment、userinfo (ユーザー プロファイルのコンテンツのみ) および spacedesc (スペース説明のコンテンツのみ)。 |
最終更新日 | すべて | 期間を週、日、時間および/あるいは分単位で指定し、その時間枠内に変更されたコンテンツを表示します。 使用できる値は次のとおりです。
例:
メモ:
|
このユーザ名だけを表示 | すべて | Confluence ユーザーのユーザー名を指定し、そのユーザーによって作成または更新されたコンテンツのみを表示します。 |
注意
権限: 検索結果マクロを含むページをユーザーが表示すると、検索結果にはユーザーが「表示」権限を持つページおよびその他のコンテンツ ﾀｲﾌﾟのみが表示されます。
Wiki マークアップの例
以下の例は、エディタ外部 (スペースのサイドバー、ヘッダー、フッターのカスタム コンテンツなど) でマクロを追加する場合に便利です。
マクロ名: search
マクロ本文: なし。
{search:lastModified=3w|query=choc|contributor=admin|maxLimit=10|type=page|spacekey=ds}