コンテンツ クエリ Web パーツを使用すると、コンテンツの動的ビューを作成できます。 どのようなコンテンツを表示するかを定義するクエリをカスタマイズし、そのコンテンツのページ上での表示方法を決定するビューの設定をカスタマイズすることができます。
この記事の内容
コンテンツ クエリ Web パーツとは
コンテンツ クエリ Web パーツには、Web ブラウザーを使用して作成したクエリに基づいて、動的な項目セットが表示されます。 クエリを使用して表示する項目を指定し、プレゼンテーション オプションを設定して、完成したページにそれらの項目を表示する方法を決定できます。
コンテンツ クエリ Web パーツによって表示されるアイテムには、常に、ページ閲覧者がアクセスを許可されているクエリによって取得される最新のアイテムが反映されます。 クエリは、コンテンツのクエリ Web パーツを含むページが表示されるたびに実行されます。 新しいコンテンツが追加され、そのコンテンツがクエリの抽出条件と一致すると、そのコンテンツはコンテンツ クエリ Web パーツにより自動的に表示されます。
注
新しいコンテンツを追加してから、そのコンテンツがコンテンツ クエリ Web パーツによって表示されるまで、数分かかる場合があります。
ページにコンテンツ クエリ Web パーツを追加したら、Web パーツを編集して、表示するアイテムとその表示方法を変更できます。 コンテンツ クエリ Web パーツを編集するには、Web パーツをポイントし、Web パーツの右上隅の下向き矢印をクリックして、[Web パーツの編集] をクリックします。 ツール ウィンドウが開き、コンテンツ クエリ Web パーツの設定が表示されます。
設定は、次の 5 つのカテゴリがあります。
- クエリ これらの設定を使用してクエリを作成します。
- プレゼンテーション これらの設定を使用して、クエリによって取得される項目の表示をカスタマイズします。
- 外観 これらの設定を使用して、Web パーツ自体の外観を調整します。 これらの設定では、Web パーツのタイトル、高さ、幅、および枠 (Web パーツの枠を構成するデザイン要素とナビゲーション用の要素) を変更できます。
- レイアウト これらの設定を使用して、Web パーツのレイアウトを調整します。 Web パーツの表示または非表示、方向 (左から右、右から左、またはどちらもなし)、表示領域 (上端、左端列、または右端列)、および領域のインデックスを指定できます。
- 詳細 これらの設定を使用して、より高度な Web パーツのさまざまなオプションを調整します。
クエリを構築する
次の [クエリ] の設定を使用して、クエリによって取得されるコンテンツを指定することができます。
ソース この設定により、クエリのスコープが決まります。 この設定は必須です。 次の 3 つのオプションがあります。
- このサイト コレクション内のすべてのサイトのアイテムを表示 するサイト コレクション全体を照会するには、このオプションを選択します。 既定の設定です。
- 次のサイトとすべてのサブサイトのアイテムを表示する サイト コレクション内の特定のサイトにクエリを制限するには、このオプションを選択します。 サイトのアドレスを入力できますが、[ 参照 ] ボタンを使用してサイトを選択することをお勧めします。 [ 参照] をクリックすると、[サイト Web パーツの 選択 ] ダイアログ ボックスが開き、サイト コレクションのツリー ビューが表示されます。 クエリを実行するサイトをクリックし、[OK] をクリック します。
- 次の一覧の項目を表示します。 サイト コレクション内の特定のリストまたはライブラリにクエリを制限するには、このオプションを選択します。 リストのアドレスを入力できますが、[ 参照 ] ボタンを使用してリストまたはライブラリを選択することをお勧めします。 [ 参照] をクリックすると、[ リストまたはライブラリ Web パーツの選択] ダイアログ ボックスが開き、サイト コレクションのツリー ビューが表示されます。 クエリを実行するリストまたはライブラリが特定のサイト内にある場合は、そのサイトの名前の横にあるプラス記号 (+) をクリックします。 クエリを実行するリストまたはライブラリが表示されたら、それをクリックし、[OK] をクリック します。
リストの種類 この設定は必須です。 サイト コレクション内の任意の種類のリストを選択できます。 選択したリストの種類によって、クエリのスコープ内にあるリストまたはライブラリのうち、クエリによって処理されるリストまたはライブラリが決まります。
コンテンツ タイプ コンテンツ タイプには、 コンテンツ タイプ グループとコンテンツ タイプ の 2 つの設定 があります。 これらの設定は省略可能です。 これらの設定を使用して、サイト コレクションに対して定義されている特定のコンテンツ タイプのアイテムにクエリを制限できます。
対象ユーザーのターゲット設定 この設定は省略可能です。
[対象ユーザーのターゲット設定] を選択すると、クエリによって取得されたコンテンツがフィルター処理され、ページ ビューアーが属する対象ユーザーを対象とするコンテンツのみが表示されます。 対象ユーザーはシステム全体で定義されており、コンテンツ クエリ Web パーツを使用して変更することはできません。 この設定は、Web パーツが対象ユーザーのターゲット設定を尊重するかどうかを決定するだけです。
[対象ユーザーのターゲット設定] を選択すると、2 つ目の設定が使用できるようになります。対象ではないアイテムを含めます。 この設定を選択すると、対象ユーザーを明示的に対象としていないコンテンツは、ページを表示しているユーザーに関係なく、クエリによって取得されます。
[対象ユーザーのターゲット設定] を選択してもこの設定を選択しない場合、対象ユーザーを明示的にターゲットにしていないコンテンツはクエリによって取得されません。
その他のフィルター この設定は省略可能です。 この設定を使用して、クエリが取得するコンテンツをさらに制限できます。 フィルター フィールド、比較演算子を選択し、条件を入力します。 たとえば、フィルター フィールド Author、比較演算子 Is Equal To、および条件 Toni Poe を使用して、クエリの結果を Toni Poe によって作成されたアイテムに制限できます。 フィルター オプションは、選択したフィルター フィールドによって異なります。 たとえば、[作成者] フィールドを選択すると、追加のオプションが表示されます。
[自分] では、自分が作成したコンテンツが表示されます。
ユーザーを入力または参照して、Web パーツ によって作成されたコンテンツが表示されるようにします。
[ユーザー設定の値またはクエリ] では、次のトークンをフィルター値として入力することも可能です。
[PageFieldValue: フィールド名] の設定を使用すると、現在のページの指定したフィールドの値を使用して動的にコンテンツをフィルタリングできます。
[PageQueryString: クエリ文字列パラメーター名] の設定を使用すると、現在のページの URL で指定されたクエリ文字列プロパティの値に基づいて、コンテンツを動的にフィルター処理できます。
注
ページのフィールド値またはクエリ文字列パラメーター値が null の場合、そのフィルターはクエリで使用されません。
[追加フィルター] 設定では、フィルターを 3 つまで指定できます。 複数のフィルターを使用する場合は、2 番目のフィルターと 3 番目のフィルターの前に [かつ] オプションや [または] オプションを追加して、フィルターを一括して適用する方法を指定する必要があります。
注
[ 追加フィルター] のオプションは、選択したソースによって異なる場合があります。
データの表示方法をカスタマイズする
次の [プレゼンテーション] の設定を使用して、クエリにより取得されるコンテンツの表示をカスタマイズすることができます。 これらはすべて任意の設定です。
グループ化と並べ替え これらの設定を使用して、クエリによって取得される項目を配置します。
- 項目をグループ化する 項目をグループに分割するために使用するフィールドを選択します。 たとえば、作成者に基づいて項目をグループ化する場合は、[ 作成者] を選択します。
- グループ化の基準となるフィールドを選択するとき、[昇順でグループを表示する] および [降順でグループを表示する] を使用して、アイテムを昇順で整列するか降順で整列するかを指定できます。
- 列の数 項目の配置に使用する列の数を指定します。 項目は最大 5 列に配置できます。
- 項目の並べ替え方法 アイテムの並べ替えに使用するフィールドを選択します。 項目をグループ化することを指定した場合、項目はそれらのグループ内で並べ替えられます。
- 並べ替えの基準となるフィールドを選択するとき、[昇順でアイテムを表示する] および [降順でアイテムを表示する] を使用して、アイテムを昇順で整列するか降順で整列するかを指定できます。
- 表示する項目の数を制限する 表示される項目の数を制限するには、このオプションを設定します。 制限を指定しない場合は、クエリによって取得されたすべての項目が表示されます。 項目数が多い場合は、ページが展開され、対応します。
スタイル これらの設定を使用して、グループと項目に視覚的なスタイルを適用します。
- グループ スタイル グループ見出しに適用するスタイルを選択します。 たとえば、作成者別にグループ化すると、アイテムの各グループが作成者名で先頭に表示され、作成者名はこの設定を使用して指定したスタイルで表示されます。
- アイテム スタイル アイテムに適用するスタイルを選択する
表示するフィールド クエリの範囲に応じて、このスタイルの表示スロットに表示する値を持つ 1 つ以上のサイト列またはリスト列を選択できます。 特定のグループの列を指定するには、列名の後に角かっこで囲んでグループの名前を入力します (例: Column [Group])。 入力した各列をセミコロンで区切ってください。
指定した最初の列の値が空白の場合、Web パーツには後続の列の値が表示されます。
フィード クエリ Web パーツによるコンテンツを RSS フィードとして機能させることができます。 これにより、ページ閲覧者は、Web パーツのクエリ結果をサブスクライブして、新しいアイテムが表示されたときにページを再訪することなく受け取ることができます。 これらの設定を使用して、RSS フィードのタイトルと説明を指定します。
- フィード タイトル RSS フィードに使用する名前を入力します。 この名前は、サブスクライブしているユーザーが RSS リーダー内でフィードを特定するときの手掛かりとなります。
- フィードの説明 RSS フィードに使用する説明を入力します。 この説明は、サブスクライブしているユーザーが RSS リーダー内でフィードを特定するときの手掛かりとなります。