検索結果マクロを挿入する

このマクロは新しいエディターから意図的に除外されており、従来のエディターから近日中に廃止されます。お知らせの詳細をご確認ください。

検索結果マクロは、マクロ パラメーターで指定した検索語に基づいて Confluence サイトを検索し、wiki ページ゙に結果を表示します。

検索結果マクロの使用

検索結果マクロを追加するには、次の手順に従います。

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

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

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

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

検索結果マクロを編集するには、次の手順に従います。

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

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

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

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

パラメーター

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

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

パラメーター

既定

説明

検索語
(query

なし

このマクロが結果の生成に使用する検索語です。

「AND」や「OR」などの演算子によって検索クエリを調整できます。例: my_query1 AND my_query2

詳細については「Confluence 検索構文」のドキュメントをご参照ください。

結果の最大数
(maxLimit

10

表示される検索結果数の制限を設定します。

このスペース キーに制限する

すべて

スペース名を入力してスペースを検索するか、検索するスペースのキーを指定します。キーは大文字と小文字を区別します。

コンテンツ タイプ
(type

すべて

コンテンツ タイプを指定します。コンテンツ タイプには次があります。pagecommentblogpostattachmentuserinfo (ユーザー プロファイルのコンテンツのみ) および spacedesc (スペース説明のコンテンツのみ)。

最終更新日
(lastModified

すべて

期間を週、日、時間および/あるいは分単位で指定し、その時間枠内に変更されたコンテンツを表示します。

使用できる値は次のとおりです。

  • w = 週

  • d = 日

  • h = 時間

  • m = 分

例:

  • 2h 35m

  • 3d 30m

メモ:

  • 時間カテゴリが指定されていない場合、Confluence は分と想定します。

  • 1 つ以上の期間 (週や日) を指定する場合は、スペースで期間を区切る必要があります。それらの期間は任意の順序で並べることができます。

  • 時間カテゴリでは大文字と小文字が区別されません。例: "4d" と "4D" は同じです。

このユーザー名だけを表示
(contributor

すべて

Confluence ユーザーのユーザー名を指定し、そのユーザーによって作成または更新されたコンテンツのみを表示します。

Wiki マークアップの例

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

マクロ名: search

マクロ本文: なし。

1 2 3 4 {search:lastModified=3w|query=choc|contributor=admin|maxLimit=10|type=page|spacekey=ds}

権限 — 検索結果マクロを含むページをユーザーが表示すると、検索結果にはユーザーが「表示」権限を持つページとその他のコンテンツ タイプのみが表示されます。

 

その他のヘルプ