Employee Directory (Entra ID): フィルター エディターのリファレンス

Vitextra Employee Directory (Entra ID) Web パーツのフィルター エディターでは、Web パーツに表示するユーザーを定義します。条件と条件グループを AND と OR で組み合わせることで、ページごとに固定の表示範囲を作成できます。たとえば、1 つの部署だけ、1 つの国だけ、あるいはサービス アカウント以外の全員といった範囲です。同じエディターは New Employees Web パーツでも使用されます。この記事では、エディターが提供するすべての機能 (フィールド、演算子、値の種類、グループ、ユーザー ロール、フィルターの適用方法、制限事項、代表的な例) をリファレンスとして説明します。

フィルター エディターの場所

ページを編集し、Web パーツのプロパティ ウィンドウを開いて データ ソース グループを展開します。フィルター の下に現在のフィルターのプレビュー (フィルターがない場合は フィルターは適用されていません) と フィルターの編集 ボタンが表示されます。

フィルターの編集 を選択すると、高度なフィルター処理 パネルが開きます。ここでフィルターを作成し、保存 を選択して適用するか、キャンセル を選択して変更を破棄します。保存するとすぐにページが更新されます。全員に変更を反映するには、ページを再発行してください。

フィルターの構造

フィルターは 最上位レベル で構成され、そこに 2 種類の項目を配置できます。どちらも 追加 ボタンで追加します。

• 条件 - 1 つのルールです。フィールド、演算子、および (ほとんどの演算子では) 値で構成されます。例: 部署 ＝ Sales。
• グループ - 独自の AND/OR 設定を持つ、複数の条件のコンテナーです。グループは最上位レベルにのみ追加できます。グループ内には条件を追加できますが、さらにグループを追加することはできません。

各レベル (最上位レベルと各グループ) には かつ / または の切り替えがあります。

• かつ - そのレベルのすべての条件に一致する必要があります。
• または - そのレベルの少なくとも 1 つの条件に一致する必要があります。

フィルターの評価時には、最上位レベルの条件は最上位レベルの切り替えに従って、各グループ内の条件はそのグループの切り替えに従って組み合わされ、その後 各グループはフィルターの残りの部分と AND (かつ) で組み合わされます。実際には、次のシンプルなパターンになります。すべて満たす必要がある条件は最上位レベルに かつ で配置し、選択肢の組み合わせ (「Sales または Marketing」、「ドイツまたはオーストリア」) はそれぞれ または のグループに配置します。

条件やグループを削除するには、その横にある削除 (ごみ箱) アイコンを選択します。フィールドが選択されていない条件は無視されます。

使用できるフィールド

条件のフィールド一覧は、次のセクションに分かれています。

Employee Directory (Entra ID) Web パーツでは、プロパティ セクションに 列 の構成にあるすべての列 (一覧に表示するかどうかに関係なく) と、ユーザー設定の列 にあるすべての列が表示されます。イメージ 列と 状態 (プレゼンス) 列は、フィルターできるテキストを含まないため除外されます。New Employees Web パーツでは一覧は固定で、標準の列が含まれ、カスタム属性は使用できません。

フィルターに特に役立つ組み込みの列と、対応する Microsoft Entra ID のユーザー属性は次のとおりです。

演算子

選択できる演算子はフィールドによって異なります。

テキストの比較はすべて 大文字と小文字を区別しません。sales、Sales、SALES は同じものとして扱われます。テキストは文字どおりに比較されます。* や % などのワイルドカードに特別な意味はなく、スペースも比較対象になるため、値の先頭や末尾にスペースを入れないでください。

値の種類

値の入力コントロールは、選択したフィールドによって変わります。

• テキスト ボックス - プロパティ のすべてのフィールド。比較するテキストを入力します。が空白でない と が空白である では値が不要なため、テキスト ボックスは表示されません。
• ドロップダウン リスト - アカウントの状態: 有効 または 無効。
• 複数選択リスト - ユーザー ロール: 1 つ以上のディレクトリ ロールを選択します。

値はテキストとして比較されます。数値や日付は数値や日付としては比較されません。たとえば ID が次の値で始まる 10 は 10、105、10-A に一致します。そのため、「より大きい」「より小さい」といった演算子はありません。

ユーザー ロールとロール テンプレート

ユーザー ロール の条件には、組み込みの Microsoft Entra ディレクトリ ロール (Global Administrator、User Administrator、Exchange Administrator、SharePoint Administrator、Teams Administrator、Helpdesk Administrator、Directory Synchronization Accounts など約 100 種類) が一覧表示されます。このロール テンプレートの一覧は Web パーツに同梱されています。組み込みロールにはそれぞれ固定のロール テンプレート ID があり、すべての Microsoft 365 テナントで同じです。そのため、一覧をテナントから読み込む必要がなく、保存したフィルターを別のテナントにコピーしても引き続き機能します。

ユーザー ロール の条件では、選択したロールと各ユーザーに割り当てられたディレクトリ ロールを比較します。

• 次を含む - 選択したロールの少なくとも 1 つを持っている。
• が次の値を含まない - 選択したロールを 1 つも持っていない。

一覧に含まれるのは組み込みのディレクトリ ロールだけです。カスタム ロール、アプリケーション ロール、グループ メンバーシップはこの条件の対象外です。

フィルターと Microsoft Graph の関係

フィルターは Microsoft Graph の $filter クエリには変換されません。Web パーツは Microsoft Graph からユーザーを読み込み、読み込んだデータに対してブラウザー内でフィルターを適用します。

• Employee Directory (Entra ID) は、ディレクトリのすべてのユーザーをページ単位 (1 回の要求につき 900 ユーザー) で読み込みます。Microsoft Graph に送信される条件は accountEnabled eq true だけで、それも ブロックされたユーザーを除外する がオンの場合に限られます。
• New Employees は、設定した月数 (ここ数か月で作成されたユーザーを表示する) 以内に作成されたメンバー ユーザー (userType eq 'Member') を Microsoft Graph に要求し、その結果にフィルターを適用します。

フィルターはブラウザー内で実行されるため、Microsoft Graph の高度なクエリの制限は適用されません。次を含む、が次の値で始まる、が次の値を含まない は、カスタム属性を含め一覧にあるどのフィールドにも使用でき、Microsoft Graph の追加のアクセス許可も必要ありません。一方で、フィルターによって Web パーツが読み込むデータ量が減ることはありません。大規模なディレクトリでは、初回の読み込みにかかる時間はフィルターの有無にかかわらず同じです。

フィルターは Web パーツの他の設定と組み合わせて動作します。ユーザーが表示されるのは、従業員を除外する グループのオプション、フィルター、および (使用している場合は) 絞り込みパネル、A–Z ナビゲーション、検索ボックスをすべて通過した場合だけです。絞り込みパネルの値と A–Z の文字は、フィルターを通過したユーザーから算出されます。

制限事項

• グループは 1 階層のみ。 グループは最上位レベルにのみ追加でき、常にフィルターの残りの部分と AND (かつ) で組み合わされます。
• テキスト比較のみ。 数値や日付の比較、ワイルドカード、正規表現は使用できません。大文字と小文字は区別されません。
• エディターには 「で終わる」演算子はありません。
• 値はディレクトリの値と一致している必要があります。 フィルターは Microsoft Entra ID に保存されている値を比較します。国/地域 属性に DE と Germany が混在している場合は、両方の値を「または」グループに追加してください。
• 単一値のテキスト属性のみ。 ユーザー型、複数値、値が設定されない列はフィルターに適していません (使用できるフィールドを参照)。
• セキュリティ境界ではありません。 フィルターはページ上で Web パーツが表示する内容を決めるだけで、Microsoft 365 のディレクトリ データへのアクセスを制限するものではありません。

例

例では日本語の UI ラベルを使用しています。サンプルの値は、お使いのディレクトリで使われている値に置き換えてください。

例 1. 1 つの部署

営業部だけを表示します。

• 最上位レベル (かつ): 部署 ＝ Sales

例 2. 複数の国またはオフィス

DACH 地域で働くユーザーを表示します。

• グループ (または):
  • 国/地域 ＝ Germany
  • 国/地域 ＝ Austria
  • 国/地域 ＝ Switzerland

特定のオフィス ビルを表示する場合は、オフィスの所在地 が次の値で始まる Berlin のような 1 つの条件を使用します。この条件は Berlin HQ、Berlin, Floor 3 などに一致します。

例 3. 役職が含む / 始まる

マネージャーとシニア スペシャリストを表示します。

• グループ (または):
  • 役職 次を含む manager
  • 役職 が次の値で始まる Senior

比較では大文字と小文字を区別せず、文字どおりの部分文字列を検索します。manager は Project Manager に一致しますが、Managing Director には一致しません。

例 4. カスタム属性

ユーザー設定の列 にキャプション コスト センター で追加したオンプレミスの拡張属性 (例: extensionAttribute1) に保存されているコスト センターを 1 つ表示します。

• 最上位レベル (かつ): コスト センター ＝ 4100

例 5. サービス アカウントとゲストを除外する

全社向けディレクトリから、技術用アカウント、共有メールボックス、外部ゲストを非表示にします。最上位レベルのすべての条件を満たす必要があります。

• 最上位レベル (かつ):
  • アカウントの状態 ＝ 有効
  • ユーザー名 が次の値で始まらない svc
  • 氏名 が次の値を含まない service
  • ユーザー名 が次の値を含まない #EXT#
  • 部署 が空白でない

#EXT# の条件は、ユーザー プリンシパル名にこのマーカーを含むゲスト ユーザーを除外します。部署の入力を必須にすると、実在の従業員に属さないアカウントの大半を簡単に除外できます。条件は組織の命名規則に合わせて調整してください。

例 6. 最上位レベルの条件と「または」グループを組み合わせる

ドイツの営業部とマーケティング部を表示します。

• 最上位レベル (かつ): 国/地域 ＝ Germany
• グループ (または):
  • 部署 ＝ Sales
  • 部署 ＝ Marketing

グループは最上位レベルの条件と AND (かつ) で組み合わされるため、結果は Germany かつ (Sales または Marketing) になります。

New Employees でフィルター エディターを使用する

New Employees Web パーツでは、プロパティ ウィンドウの フィルター に同じフィルター エディターがあります。動作は同じですが、次の点が異なります。

• フィルターは、New Employees がすでに選択したユーザー (ここ数か月で作成されたユーザーを表示する の期間内に作成されたメンバー ユーザー) に適用されます。
• フィールド一覧には標準の列が含まれ、カスタム属性は使用できません。
• アカウントの状態 は Employee Directory (Entra ID) と同様に使用できます。ユーザー ロール も同じように動作し、同じアクセス許可が必要です (ユーザー ロールとロール テンプレートを参照)。

一般的な使い方として、正社員だけを歓迎する場合 (例: 従業員の種類 ＝ Employee) や、特定の拠点の新入社員だけを表示する場合 (例: オフィスの所在地 が次の値で始まる London) があります。