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

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

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

検索結果マクロの使用

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

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

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

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

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

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

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

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

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

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

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

パラメーター

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

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

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

 

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

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