Employee Directory (Entra ID) Web パーツの構成方法: フィルター、除外、A–Z ナビゲーション

Vitextra Employee Directory の Employee Directory (Entra ID) Web パーツは、Microsoft Graph を通じて Microsoft Entra ID から直接ユーザーを読み込みます。標準の Employee Directory Web パーツと比べて、ビジュアルなフィルター エディターで作成する定義済みフィルター、サービス用アカウントや不完全なアカウントを非表示にする除外設定、姓によるアルファベット順 (A–Z) ナビゲーションが追加されています。この記事では、Web パーツをページに追加し、データ ソース、除外設定、A–Z ナビゲーションを構成する方法を説明し、その他の設定については関連記事を紹介します。

始める前に

• Employee Directory ソリューションがテナントにインストールされていること。KB10035. SharePoint Online に Vitextra 製品をインストールする方法 を参照してください。
• ソリューションが要求する Microsoft Graph のアクセス許可 (User.Read.All や Directory.Read.All など) が、SharePoint 管理センターの API アクセス (API access) ページで承認されていること。これらがないと、Web パーツは Entra ID からユーザーを読み込めません。
• ディレクトリを配置する SharePoint ページを編集できること。

Web パーツをページに追加する

1. SharePoint ページを開き、編集 を選択します。
2. ディレクトリを配置したい場所にポインターを合わせ、+ 記号を選択して Employee Directory (Entra ID) を検索します。ツールボックスに表示される Web パーツ名は SharePoint の言語によって異なり、日本語では 従業員ディレクトリ(Entra ID) と表示されます。
3. Web パーツを選択して追加します。すぐに Entra ID からユーザーの読み込みが始まります。
4. Web パーツの編集 (鉛筆) アイコンを選択して、プロパティ ウィンドウを開きます。設定は折りたたみ可能なグループに分かれています: データ ソース、検索結果の絞り込みパネル、従業員を除外する、表示、クイック フィルター、コンテンツ フィールド、パネル、ショートカット メニュー、クイックアクション、エクスポート、個人用アプリ (Microsoft Teams)、詳細情報。
5. 以下の説明に従って Web パーツを構成し、再発行 を選択します。

データ ソースを構成する

データ ソース グループでは、表示する属性、ディレクトリに含めるユーザー、表示順を定義します。

列とユーザー設定の列

列 の 構成 を選択し、ディレクトリで使用する Entra ID の組み込み属性 (名前、役職、部署、オフィス、電話番号、メール、上司など) を選びます。列ごとに次の項目を設定できます。

• リストに表示する — 結果一覧 (「詳細」表示) に列を表示します。
• カードに表示 — ユーザーのカードに属性を表示します。
• 検索可能 — 列を検索対象に含めます。
• キャプション — ユーザーに表示される列見出しです。
• 順序 — 列の位置です。

検索可能 に設定された列が 1 つもない場合、Web パーツは名前、役職、部署、勤務先電話番号、携帯電話番号で検索します。検索では大文字と小文字を区別せず、値のどの部分に一致しても結果に含まれます。

ユーザー設定の列 では、オンプレミスの Active Directory から同期された属性など、Entra ID の拡張属性を追加できます。設定項目は同じで、フィルター、並べ替え、グループ化、絞り込みパネルでも使用できます。詳しくは KB10060. Employee Directory Web パーツでカスタム Entra ID 属性を表示する方法 を参照してください。

定義済みフィルター

フィルター のフィルター エディターを使用すると、ディレクトリを組織の特定の部分 (たとえば 1 つの国、1 つのオフィス、1 つの会社のみ) に限定できます。フィルターは条件 (属性、演算子、値) で構成され、条件を AND または OR のロジックでグループにまとめることができます。条件には、構成済みの列とユーザー設定の列をすべて使用できます。

定義済みフィルターは、結果一覧、結果の総数、絞り込みパネルの値、A–Z ナビゲーションの文字、Excel へのエクスポートなど、ディレクトリに表示されるすべてに適用されます。ユーザーはこのフィルターを解除できません。このページのディレクトリに誰を含めるかを決める設定です。

スキルで検索

スキルで検索 トグル (既定でオン) を使用すると検索が拡張され、検索可能な列に加えて、プロフィールに一致するスキルが登録されているユーザーも見つかります。スキルの検索は 2 文字以上入力すると開始され、一致したスキルがユーザーの 技能 の先頭に表示されます。トグルをオフにすると、検索ボックスは検索可能な列のみを対象にします。

並べ替え

並べ替え では、結果の既定の順序を設定します。ドロップダウンには構成済みの列とユーザー設定の列が表示されます。(空) を選ぶと、Entra ID がユーザーを返した順序のままになります。方向 トグルで 昇順で並べ替え と 降順で並べ替え を切り替えます。「詳細」表示では、ユーザーは列見出しを選択して一覧を並べ替え直すこともできます。

ページング

アイテムを次のページ数に分割して表示する: では、一度に表示する人数 (0～50、既定は 40) を設定します。結果がそれより多い場合は、一覧の下に その他の結果を表示します... ボタンが表示され、次のページを読み込みます。スライダーを 0 にすると、ページに分けずにすべての結果を表示します。

従業員を除外する

Entra ID テナントには、実際の従業員以外にも、共有メールボックス、会議室、サービス アカウント、テスト ユーザー、退職者のブロックされたアカウントなどが含まれているのが一般的です。従業員を除外する グループを使うと、フィルターを作成しなくてもこれらを非表示にできます。各トグルは独立して動作し、条件は組み合わされます。つまり、オンにしたすべてのトグルの条件を満たすユーザーだけが表示されます。

ライセンスのない従業員を除外する

Microsoft Entra ID でライセンスが 1 つ以上割り当てられている場合、つまり Microsoft Graph が返す assignedLicenses プロパティが空でない場合に、そのユーザーはライセンスありと見なされます。製品の種類 (Microsoft 365、Office 365、Exchange Online、試用版など) は問わず、ライセンスが直接割り当てられたか、グループベースのライセンスで割り当てられたかも関係ありません。Web パーツは、どの製品が割り当てられているか、どのサービス プランが有効かまではチェックしません。

通常、共有メールボックス、会議室や備品のメールボックス、ほとんどのサービス アカウントにはライセンスがないため、このトグルはそれらを取り除く最も手軽な方法です。ゲスト ユーザーも通常はテナント内でライセンスを持たないため、同様に非表示になります。

部署または役職が空の従業員を除外する

この 2 つのトグルは、Entra ID の 部署 または 役職 属性が空のユーザーを非表示にします。人事プロセスですべての従業員にこれらの属性を設定している場合に便利です。これらの属性がないアカウントは、ほとんどの場合、技術用、テスト用、または入社手続きが完了していないアカウントです。

プロフィールが揃っているユーザーだけを表示するには両方をオンにしますが、事前にデータを確認してください。Entra ID で部署や役職が設定されていないユーザーは、属性が入力されるまでディレクトリに表示されません。

ブロックされたユーザーを除外する

ブロックされたユーザーを除外する は、サインインがブロックされているアカウント (accountEnabled 属性が false)、一般的には退職者のアカウントを非表示にします。このトグルは 既定でオン です。ほかの除外設定とは異なり、Microsoft Graph 側でも適用されます。ブロックされたアカウントはそもそもダウンロードされないため、ディレクトリの読み込みが速くなります。

除外設定が適用される範囲

除外設定は、定義済みフィルターとともにディレクトリの対象ユーザーを決定します。全体の一覧、検索結果、自分の部署 クイック フィルター、絞り込みパネルの値、A–Z ナビゲーションの文字、結果の総数、Excel へのエクスポートに適用されます。

アルファベット順 (A–Z) ナビゲーション

アルファベット順ナビゲーションは、結果の上に文字の行を追加し、姓の頭文字でユーザーにすばやく移動できるようにします。有効にするには、表示 グループを展開し、アルファベット順の表示 をオンにします (既定ではオフ)。

ナビゲーションのしくみ:

• 文字はデータから生成されます。 行には、除外設定と定義済みフィルターを適用した後のディレクトリ内のユーザーについて、姓 (Entra ID の surname 属性) の頭文字として実際に使われている文字だけが表示されます。該当者のいない文字は表示されず、ラテン文字以外の文字も扱えます。
• 姓で絞り込みます。 文字を選択すると、姓がその文字で始まるユーザーだけが表示されます。姓が空のユーザーは、表示名がその文字で始まっていても、文字が選択されている間は非表示になります。
• 複数の文字を同時に選択できます。 別の文字を選択すると選択に追加されます (たとえば B と M)。選択済みの文字をもう一度選択すると解除されます。文字が 1 つも選択されていない場合は、全体の一覧が表示されます。
• ほかのフィルターと組み合わせて使えます。 文字の選択は、絞り込みパネル、および文字を選ぶ前に入力した検索語と組み合わせて機能します。検索ボックスに入力したり、別のクイック フィルターに切り替えたりすると、選択した文字はクリアされます。
• 個人用の一覧では非表示になります。 自分のチーム、一緒に仕事をしている人、お気に入り のいずれかのクイック フィルターを選択している間は、文字の行は表示されません。

その他の設定

プロパティ ウィンドウの残りのグループは、ほかの Employee Directory Web パーツと共通で、それぞれ別の記事で説明しています。