ページ プロパティ レポート マクロ
マクロはページで以下のように表示されます。
マクロ ブラウザでのセットアップは次のようになります。
特定のページ プロパティ マクロのレポート
1 つのページに複数のページ プロパティ マクロを追加して、レポートにすべてのマクロを含めるか、特定のマクロのみを含めるかを選択できます。ページ プロパティ マクロには、個々のページ プロパティ マクロの識別に使用できるオプションの ID パラメーターが含まれます。
それぞれのコンテンツを表示するには、次のようにします。
- 選択したページ プロパティ マクロをレポートに表示 - 対象のページのラベルと、ページ プロパティ マクロの ID ([オプション] 配下) を指定します。
- すべてのページ プロパティ マクロ をレポートに表示 - ページのラベルのみを指定し、ページ プロパティ ID フィールドは空白のまま残します。
注: ページ プロパティ レポート マクロでは、ID は 1 つのみ許可されます。
CQL フィールド
フィールドの追加リンクを使用し、クエリに付加フィルターを追加します。
- OR 検索の場合、1 つのフィールドに複数の値を指定します。
"label-a" または "label-b"、またはそれらの両方を含むページを表示するには、1 つのラベル フィールドに "label-a" と "label-b" を以下のように指定します。
- AND 検索の場合、1 つ以上のフィルターを追加し、それぞれに値を 1 つずつ指定します。
label-a と label-b を含むページのみを表示するには、1 つのラベル フィールドに "label-a" を指定し、マクロに次のように 2 つ目のフィールドを追加して、そこに "label-b" を指定します。
つまり、OR の値は同じフィルタに、AND の値は異なるフィルタに入力します。
AND は一部のフィルタでのみサポートされます。AND 演算子がサポートされていないフィルタの場合、フィルタを追加することはできません。 - NOT 検索の場合は、マイナス記号 (-) をラベルの前に入力します。これにより、そのラベルを含むものはすべて除外されます。
クエリを構築する際は、以下の CQL を使用できます。
| フィルター | 説明 | 演算子 |
|---|---|---|
| ラベル* | このラベルを持つページ、ブログ投稿、または添付ファイルを含む。 | OR (同じフィルター内の複数の値) AND (複数のラベル フィルタ) |
| 先祖あり | このページの子ページを含む。 これによってマクロを 1 つのページ ツリーに限定できます。 | OR (同じフィルター内の複数の値) |
| 投稿者** | これらのユーザーが作成または編集したページまたはブログ投稿を含む。 | OR (同じフィルター内の複数の値) |
| 作成者 | このユーザーが作成した項目を含む。 | OR (同じフィルター内の複数の値) |
| ユーザーのメンションあり | これらのユーザーをメンションするページやブログ投稿を含む。 | OR (同じフィルター内の複数の値) |
| 親あり | このページの直下の子ページのみを含む (以降のサブページは含まない)。 | EQUALS (1 ページのみ) |
| スペース内** | このスペースの項目を含む。 | OR (同じフィルター内の複数の値) |
| テキストを含む** | このテキストを含む項目を含む。 | CONTAINS (1 つのワードまたはフレーズ) |
| タイトルあり | タイトルにこのテキストを持つ項目を含む。 | CONTAINS (1 つのワードまたはフレーズ) |
| 同一タイプ** | ページ、ブログ、添付ファイルのみを含める。 | OR (同じフィルター内の複数の値) |
* このフィールドは CQL で動作するマクロに必須です。
** CQL で動作するマクロにこれらのフィルターを追加できますが、検索を行う場合、これらは標準の検索フィルターの一部となっているため、[フィルターを追加] メニューには表示されません。
マクロの表示オプション
ページでのマクロの表示方法を次のオプションで制御します。
| パラメーター | 既定 | 説明 |
|---|---|---|
| ページ プロパティ ID | 空白 | この値が指定されない場合、レポートはページ上にある複数のページ プロパティ マクロすべてのデータを示します。ID を指定することで、同じ ID を使用するページ プロパティ マクロからのデータのみを含めることができます。 |
| タイトル コラム見出し | タイトル | レポート テーブルの 1 列目に表示される見出しです。この列には、レポートで表示されるページへのリンクが含まれます。既定の列見出しは "タイトル" です。 |
| 表示する列 | この値が指定しない場合、レポートはすべての列を表示します。含める列をカンマ区切りテキストで指定できます。 列見出しにカンマが使用されている場合、列名を二重引用符で囲みます。列見出しに引用符が使用されている場合は、二重引用符を使用します。例: A column, "My ""new"" column, yes", Third column | |
| 表示するアイテム数 | 30 | テーブルで、追加アイテムのページネーション オプションを表示する前に表示するアイテムの数。 このマクロは最大で 500 ページを表示するので、500 ページすべてをまとめて一覧にするのではなく、ページ区切りを使用することをおすすめします。 |
| 並び替え順序 | 最終変更日 | 特定の列見出しでテーブルを並べ替えます。対応するページ プロパティマクロの表記と同じ列名を入力します。 逆順ソート チェックボックスをオンにすると、逆順で表をソートします。 |
| コメント件数の表示 | いいえ | テーブルの各ページのコメント数を表示します。 |
| 「いいね!」件数の表示 | いいえ | テーブルの各ページに対する "いいね!" の数を表示します。 |
トラブルシューティング
レポートが空白の場合、以下を確認してください。
- ラベルを適切に入力していて、ページ プロパティ マクロを含むページにそのラベルが表示されていること。
- 各ページのページ プロパティ マクロが適切に構成されていること。
- 指定した他のフィールドで検索を絞り込みすぎていない (例: 指定した親ページの下にそのラベルを持つページがない) こと。
制限事項
ページ プロパティ レポート マクロには最大で 500 ページが表示されます。表示すべきページの枚数がこれよりも多い場合は、もっとも最近に作成または編集された 500 ページが表示され、一致するすべてのページを確認できる詳細検索へのリンクが提供されます。