コンテンツ クエリ 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 つ以上のサイト列またはリスト列を選択できます。 特定のグループの列を指定するには、列名の後に角かっこで囲んでグループの名前を入力します (列 [グループ]など)。 入力する各列は、セミコロンで区切るようにしてください。
指定した最初の列の値が空白の場合、Web パーツには後続の列の値が表示されます。
フィード クエリ Web パーツでコンテンツを RSS フィードとして使用するように選択できます。 これにより、ページ閲覧者は Web パーツのクエリ結果をサブスクライブして、ページを再表示することなく、表示されたときに新しいアイテムを受け取るオプションが提供されます。 これらの設定を使用して、RSS フィードのタイトルと説明を指定します。
-
フィードのタイトル RSS フィードに使用する名前を入力します。 この名前は、サブスクライブしているユーザーが RSS リーダー内でフィードを特定するときの手掛かりとなります。
-
フィードの説明 RSS フィードに使用する説明を入力します。 この説明は、サブスクライブしているユーザーが RSS リーダー内でフィードを特定するときの手掛かりとなります。