List Filter Online のフィルター ペイン コントロールとサポートされる列の種類

はじめに

フィルター ペインは、List Filter Online の中でエンド ユーザーが最もよく目にする部分です。管理者がリストの中から絞り込みに使用する列を選び、それぞれにコントロールを割り当てます。ユーザーは、CAML を入力したり、複数の列メニューを次々に開いたりする代わりに、ドロップダウン、日付ピッカー、ユーザー ピッカー、スライダーを使ってリストを絞り込みます。

この記事は、そのペインのリファレンスです。プロパティ ペインで列とコントロールを選択する方法、各コントロールの外観と動作、各コントロールについて Web パーツが SharePoint Online に送信する比較、そして SharePoint の列の種類ごとに提供されるコントロールについて説明します。Web パーツの一般的な構成については、KB10201. List Filter Online Web パーツの構成で説明しています。

フィルター ペインを構成する

フィルター ペインは、プロパティ ペインの フィルター ウィンドウ グループで構成します。このグループには、3 つのトグルと列の構成ツールがあります。

• フィルター ウィンドウ - ページ上のペインの表示と非表示を切り替えます。ペインに列が選択されていない場合も、ペインは自動的に非表示になります。
• カスケード フィルター - ペイン内の他のコントロールで選択したフィルターに応じて、ドロップダウン コントロールの値リストを絞り込みます。KB10256. カスケード フィルター: 選択済みの他のフィルターによるドロップダウン オプションの絞り込みを参照してください。
• ユーザーの前回のフィルターを記憶する - ユーザーが前回の訪問時に適用したフィルターを復元します。KB10253. List Filter Online でフィルターを保存し、フィルター済みビューのリンクを共有するを参照してください。
• 選択された列 - 現在ペインに含まれている列 (または 選択されていません) の一覧と、それに続く、構成ツールを開く 列の選択 ボタン。

列の選択 ボタンをクリックすると、列 パネルが開きます。このパネルには、選択したリストまたはライブラリの列のうち、SharePoint がフィルター可能としているすべての列が一覧表示されます。ただし、システム列と、マネージド メタデータ列に付随する非表示のテキスト列は除きます。各行には次のフィールドがあります。

保存 を押すと選択内容が Web パーツに適用されます。キャンセル を押すと、変更せずにパネルが閉じます。チェックを付けていない列は保存されないため、チェック ボックスをオフにすると、その列に対して選択したキャプションとコントロールも破棄されます。

フィルター コントロール

以下のセクションでは、フィルターの種類 の一覧から選択できる各コントロールについて、ユーザーに表示される内容、値の入力方法、Web パーツが CAML クエリに設定する比較を説明します。CAML の要素名 (Eq、Contains、In、Geq など) は、開発者モードの CAML クエリ ダイアログでクエリを確認する管理者や、Query Builder で事前定義フィルターを作成する管理者のために記載しています。

テキスト

1 つのテキスト ボックスです。ユーザーが値の一部を入力します。比較は、入力したテキストによる 次の値を含む (Contains) です。これは、テキスト、数値、通貨、参照、ハイパーリンク、計算値、ID の各列の既定のコントロールです。Contains は列のインデックスを使用できないため、大規模なリストでは別のコントロールを使用してください (KB10257 を参照)。

テキスト (オプション付き)

演算子のドロップダウンと、それに続くテキスト ボックス (最大 300 文字) です。演算子は、次の値を含む (Contains)、次の値と等しい (Eq)、次の値と等しくない (Neq)、次の値で始まる (BeginsWith)、より大きい (Gt)、以上 (Geq)、より小さい (Lt)、以下 (Leq)、データを含まない (IsNull)、データを含む (IsNotNull) です。最後の 2 つの演算子は値を必要としないため、テキスト ボックスは表示されなくなります。既定の演算子は 次の値を含む です。テキスト ボックスが空の演算子では、条件は追加されません。

ドロップダウン

列から読み込んだ値のドロップダウン リストです。要求では現在のフォルダーが考慮され、カスケード フィルター が有効な場合はウィンドウ内の他の条件も考慮されます。値を選ぶと Eq 条件になります。このコントロールは固定コマンドの (すべて)、データを含む、データを含まない を追加しません。選択を解除するには フィルターのクリア を使用します。選択肢列の既定のコントロールです。

ドロップダウン (複数の値)

複数の値をオンにできるコンボ ボックスです。選択した値は、ボックスにコンマ区切りで表示されます。条件は In (Values リストを持つ In) であるため、列にオンにした値のいずれかが含まれている項目が一致します。値リストの読み込みと絞り込みは ドロップダウン の場合と同じです。固定項目の (すべて)、データを含む、データを含まない は、ここでは表示されません。

日付ピッカー

演算子のドロップダウンと、日付が必要な演算子の場合はカレンダー ピッカーです。カレンダー ピッカーは、サイトの地域設定の日付形式と週の開始曜日に従います。演算子は、データを含む (IsNotNull)、データを含まない (IsNull)、指定日 (Eq)、指定日以外 (Neq)、以降 (Geq)、後 (Gt)、以前 (Leq)、前 (Lt) です。日付は時刻部分なしで送信されるため、比較は日単位で行われます。

日付範囲

開始日 と 終了日 というラベルが付いた 2 つのカレンダー ピッカーです。どちらも空のままにできます。開始日は 後 (Gt)、終了日は 前 (Lt) になります。どちらの境界も排他的であるため、開始日 または 終了日 の日付ちょうどの項目は含まれません。それらを含めるには、ユーザーが 1 日前または 1 日後の日付を選択する必要があります。ピッカーでは、開始日より前の終了日は選択できません。これは日付と時刻の列の既定のコントロールで、日付が選択されるまで条件は追加されません。

相対日付

現在の日を基準とした期間のドロップダウンと、それに続く、必要な期間の場合は数値ボックスです。期間は、過去X日間、過去X週間、過去Xか月、過去X年、今日、次のX日間、次のX週間、次のXか月、次のX年 です。今日 は、CAML の <Today /> 値を持つ Eq になります。その他の期間は、計算された境界日と今日との間の 2 つの比較 (Geq と Leq) の組になります。数値は最大 1,000 まで指定できます。

ユーザーまたはグループ

コンパクトなユーザー ピッカーです。ユーザーは名前の一部を入力し、ユーザーの候補 の一覧からユーザーを選択します。ピッカーはサイトのユーザーを検索します。単一値のバリアントでは 1 人を選択でき、ユーザーまたはグループ (複数の値) では最大 20 人を選択できます。条件は、ユーザー ID (FieldRef LookupId="TRUE") に対する In であるため、複数値の列は、選択したユーザーのいずれかが含まれている場合に一致します。ユーザーまたはグループ列では、複数値のバリアントが既定で使用されます。

用語

マネージド メタデータ列用のタグ ピッカーです。ユーザーは用語ラベルの一部を入力し、列にバインドされた用語セットから用語を選択します。非推奨の用語は候補に表示されません。用語 は 1 つの用語を受け入れ、用語ラベルによる 次の値を含む (Contains) になります。用語 (複数の値) は最大 20 個の用語を受け入れ、ラベルによる In になります。これは、マネージド メタデータ列の既定のコントロールです。

数値範囲

2 つのハンドルがあるスライダーです。ペインの読み込み時に、Web パーツはリスト内 (現在のフォルダー内) の列の最小値と最大値を読み取り、それらをスライダーの両端として使用します。ステップは、整数列では 1、その他の数値と通貨では 0.1 です。ハンドルを動かすと、下限値には 以上 (Geq)、上限値には 以下 (Leq) が、列の種類に応じて生成されます。

はい/いいえ

はい と いいえ のラベルが付いたトグルです。条件は、1 または 0 による 次の値と等しい (Eq) です。操作していないトグルは条件を追加しません。ユーザーが一度切り替えると現在の位置が送信されるため、いいえ に戻すと、フィルターが解除されるのではなく、値が「いいえ」の項目に絞り込まれます。フィルターのクリア で条件が削除されます。これは、はい/いいえ列と 添付ファイル 列の唯一のコントロールで、添付ファイル列では 「はい」は「添付ファイルあり」を意味します。

列の種類と使用可能なコントロール

構成ツールの フィルターの種類 の一覧には、SharePoint の列の種類ごとに次のコントロールが表示されます。太字のコントロールが既定です。

その他の種類の列 (コンテンツ タイプ ID、GUID、ワークフロー列、スレッド列) は、SharePoint がフィルター可能としている場合に一覧に表示されることがありますが、その フィルターの種類 の一覧は空であり、選択しないでください。複数の値を持つ列 (複数選択の選択肢、複数値の参照、複数選択のユーザーまたはグループ、複数値のマネージド メタデータ) には、単一値の対応する列と同じコントロールが提供されます。いずれかの値が条件を満たしている場合、その項目は条件に一致します。