---
title: "Employee Directory の概要: Web パーツ、SPFx、Microsoft Graph"
description: "SharePoint と Microsoft Teams 向け Vitextra Employee Directory ソリューションの概要です。Employee Directory、Employee Directory (Entra ID)、New Employees の各 Web パーツ、SharePoint Framework でのホスト、Microsoft Graph のアクセス許可、データ ソース、レイアウト、クイック フィルター、お気に入り、スキル検索、現地時刻と空き状況、Entra ID のフィルター エディターを紹介します。"
url: https://vitextra.com/ja/support/kb/10064
language: ja
published: 2026-11-14
modified: 2026-11-14
products:
  - "Employee Directory"
author: "Lidija Reising"
tags: ["Employee Directory 概要", "Employee Directory Web パーツ", "SharePoint 社員名簿", "Microsoft Teams 社員名簿", "Microsoft Graph アクセス許可", "Microsoft Entra ID 社員名簿", "New Employees Web パーツ", "SPFx Web パーツ", "カスタム列", "Excel エクスポート", "絞り込みパネル", "クイック フィルター", "お気に入り", "スキル検索", "グループ化", "フィルター エディター"]
---

# Employee Directory の概要: Web パーツ、SPFx、Microsoft Graph

SharePoint と Microsoft Teams 向け Vitextra Employee Directory ソリューションの概要です。Employee Directory、Employee Directory (Entra ID)、New Employees の各 Web パーツ、SharePoint Framework でのホスト、Microsoft Graph のアクセス許可、データ ソース、レイアウト、クイック フィルター、お気に入り、スキル検索、現地時刻と空き状況、Entra ID のフィルター エディターを紹介します。

Vitextra の [Employee Directory](https://vitextra.com/ja/products/employee-directory) ソリューションには、3 つの Web パーツが含まれています。

- [Employee Directory](https://vitextra.com/ja/support/kb/10064#employee-directory)
- [Employee Directory (Entra ID)](https://vitextra.com/ja/support/kb/10064#employee-directory-azure-ad)
- [New Employees](https://vitextra.com/ja/support/kb/10064#new-employees)

これらの Web パーツを組み合わせることで、豊富な従業員情報と強力な検索機能により ::SharePoint:: と ::Microsoft Teams:: を拡張できます。

この記事では、各 Web パーツの主な機能について順に説明します。

💡 **ヒント**  
関連記事:
- [KB10309. Employee Directory Web パーツの追加と構成方法](https://vitextra.com/ja/support/kb/10309)
- [KB10310. Employee Directory と Employee Directory (Entra ID) の比較: どちらの Web パーツを選ぶべきか](https://vitextra.com/ja/support/kb/10310)
- [KB10311. Employee Directory (Entra ID) Web パーツの構成方法: フィルター、除外、A–Z ナビゲーション](https://vitextra.com/ja/support/kb/10311)

## SharePoint Framework
Employee Directory アプリは ::SharePoint Framework (SPFx):: で構築されているため、SharePoint のモダン ページとクラシック ページのほか、Microsoft Teams でもホストできます。同じアプリが、これらすべてのプラットフォームで制限なく動作します。

他の SPFx ソリューションと同様に、このアプリは現在のユーザーのアカウントでブラウザー内で実行されます。

📝 **注**  
SPFx Web パーツが、Entra ID で現在のユーザーにすでに付与されているアクセス許可を超えることは決してありません。  

詳細については、ブログ記事「[Vitextra アプリケーション使用時のデータ保護](https://vitextra.com/ja/blog/spfx-data-protection)」を参照してください。

[![さまざまなプラットフォーム上の SPFx ベースのアプリ](https://static.vitextra.com/articles/10064/spfx-multi-platform_thumb3.jpg)](https://static.vitextra.com/articles/10064/spfx-multi-platform.jpg){data-provide="lightbox" data-lity}
*さまざまなプラットフォーム上の SPFx ベースのアプリ*

## Microsoft Graph

Employee Directory の Web パーツは、::Microsoft Graph:: API を使用して、ユーザーの詳細情報、Teams でのプレゼンス状態、Outlook の予定を取得します。Microsoft Graph との通信は、SharePoint Framework に組み込まれたネイティブ クライアントを介して行われます。

データは次の順序で取得されます。

1. Web パーツが、Microsoft Graph にアクセスするためのトークンを Entra ID に要求します。
2. Entra ID が、ソリューションに付与されたアクセス許可に基づいてトークンを発行します。
3. Web パーツが、Microsoft Graph にデータを要求します。
4. Microsoft Graph が、要求されたデータを返します。

![Microsoft Graph API の利用](https://static.vitextra.com/articles/10064/spfx-graph-security.png)
*Microsoft Graph API の利用*

❗ **重要**  
Web パーツが Microsoft Graph を呼び出せるようにするには、SharePoint 管理センターで、ソリューションに必要な [API アクセス許可を承認](https://vitextra.com/ja/support/kb/10035#api-access)する必要があります。 

Employee Directory アプリには、次のアクセス許可が必要です。

- Directory.Read.All
- User.Read.All
- Presence.Read.All
- Calendars.Read
- People.Read

これらを組み合わせることで、Web パーツはユーザー情報、上司と部下の関係、予定表データ、一緒に仕事をしている人の情報にアクセスできます。

- *Directory.Read.All* と *User.Read.All* は、上司と部下の関係とともにユーザーの詳細情報を取得します。
- *Presence.Read.All* は、Microsoft Teams でのユーザーの現在のプレゼンス状態を読み取ります。
- *Calendars.Read* は、ユーザーの予定表データへのアクセスを提供します。このデータはスケジュールと空き時間情報 (空き/予定あり) に使用されます。
- *People.Read* は、現在のユーザーにとって関連性の高いユーザーの一覧を読み取り、クイック フィルター **一緒に仕事をしている人** に使用されます。

📝 **注**  
これらのアクセス許可は、SharePoint 管理センターで承認する必要があります。

📝 **注**  
Employee Directory は Microsoft Graph からデータを読み取るだけで、変更することはありません。

## Web パーツ
### Employee Directory

Employee Directory Web パーツは、組織全体の従業員情報を検索および閲覧するための中心的なハブです。

#### データ ソース

Employee Directory Web パーツでは、データ ソースとして ::Microsoft Entra ID:: (Microsoft Graph) または ::ユーザー プロファイル:: のいずれかを使用できます。ユーザー プロファイルを使用する場合、Web パーツは SharePoint 検索サービスを介して情報を取得します。

#### カスタム列

どちらのデータ ソースも、カスタム属性をサポートしています。ユーザー プロファイルの場合は、まず SharePoint の検索スキーマでそれらの属性を定義する必要があります。詳細な手順については、記事「[KB10049. Employee Directory Web パーツにユーザー プロファイルのカスタム属性を追加する方法](https://vitextra.com/ja/support/kb/10049)」(ユーザー プロファイル) と「[KB10060. Employee Directory Web パーツでカスタム Entra ID 属性を表示する方法](https://vitextra.com/ja/support/kb/10060)」(Microsoft Entra ID) を参照してください。

💡 **ヒント**  
任意のカスタム属性を、Web パーツの列として表示できます。

#### レイアウト

Web パーツには、検索結果を表示する方法として **連絡先** と **詳細** の 2 つがあります。

![Employee Directory の詳細ビュー](https://static.vitextra.com/articles/10064/employee-directory-grid.png)
*Employee Directory の詳細ビュー*

![Employee Directory の連絡先ビュー](https://static.vitextra.com/articles/10064/employee-directory-contact3.png)
*Employee Directory の連絡先ビュー*

**連絡先** モードでは、各従業員がカードとして表示されます。カードに表示するフィールドは自由に選択できます。フィールドの数は Web パーツの設定で指定したカードのサイズによって異なり、1 枚のカードにつき最大 4 つです。

[![検索結果における従業員カードのサイズ](https://static.vitextra.com/articles/10064/contact-fields_thumb.png)](https://static.vitextra.com/articles/10064/contact-fields.png){data-provide="lightbox" data-lity}
*検索結果における従業員カードのサイズ*

**詳細** モードでは、列として表示するフィールドとその順序を選択できます。画像列とステータス列を除くすべての列は折りたたみ可能です。Web パーツの表示領域が狭くなると、これらの列は自動的に非表示になります。これにより、横スクロールが発生せず、Web パーツは利用可能なスペースに合わせて動的に調整されます。

💡 **ヒント**  
Employee Directory では、連絡先ビューと詳細ビューの両方で、表示する属性をカスタマイズできます。

**グループ化** オプションを使用すると、部署などの属性で結果をグループ化できます。レイアウト、カードのサイズ、カードのフィールド、グループ化の詳細については、「[KB10314. Employee Directory の表示形式: 一覧とカード、カード サイズ、カード フィールド、グループ化](https://vitextra.com/ja/support/kb/10314)」を参照してください。

#### クイック フィルターとお気に入り

結果の上にあるクイック フィルター バーを使うと、ワンクリックでディレクトリを絞り込めます: **自分の部署**、**自分のチーム**、**一緒に仕事をしている人**、**お気に入り**。ユーザーは、同僚のカードの星アイコンでその同僚をお気に入りに追加します。お気に入りはブラウザーに保存されるため、同じデバイスとブラウザー プロファイルであればセッションをまたいで保持されます。「[KB10214. Employee Directory のクイック フィルター: 自分の部署、自分のチーム、一緒に仕事をしている人、お気に入り](https://vitextra.com/ja/support/kb/10214)」を参照してください。

#### スキル検索

**スキルで検索** を有効にすると、Microsoft Entra ID のプロファイルに登録されたスキルで同僚を検索できます。一致したスキルは、**技能** 列の先頭に表示されます。「[KB10316. Employee Directory でスキルから従業員を検索する方法](https://vitextra.com/ja/support/kb/10316)」を参照してください。

#### 詳細ペイン

検索結果で従業員を選択すると、詳細なプロファイルが開きます。プロファイルには、その従業員が最近編集したドキュメント、現地時刻 (自分のタイム ゾーンとの時差と、勤務時間内かどうか)、および当日のスケジュールと空き時間情報 (従業員と自分の両方) が含まれます。

[![詳細ペイン](https://static.vitextra.com/articles/10064/details-pane_thumb.png)](https://static.vitextra.com/articles/10064/details-pane.png){data-provide="lightbox" data-lity}
*詳細ペイン*

カードとそのコンテキスト メニューから、Teams チャットの開始、通話、メールの送信、メール アドレスのコピー、会議のスケジュール、連絡先カード (vCard) のダウンロードを行えます。どの操作を利用できるかは管理者が決定します。

💡 **ヒント**  
詳細については、「[KB10315. Employee Directory の従業員アクション: チャット、通話、メール、メール アドレスのコピー、会議の設定、vCard](https://vitextra.com/ja/support/kb/10315)」と「[KB10317. Employee Directory: 現地時間、勤務時間、空き時間情報](https://vitextra.com/ja/support/kb/10317)」を参照してください。

#### テーマ バリエーション

Employee Directory ソリューションのすべての Web パーツは、配置先サイトのテーマを自動的に継承します。また、Web パーツは、モダン ページのセクションに割り当てることができる配色バリエーションにも対応しています。次の図は、2 種類の SharePoint ::サイト:: テーマにおいて、Web パーツを 4 つの配色バリエーションで表示したものです。

[![テーマ バリエーション](https://static.vitextra.com/articles/10064/theme-variants_thumb.png)](https://static.vitextra.com/articles/10064/theme-variants.png){data-provide="lightbox" data-lity}
*テーマ バリエーション*

Microsoft Teams では、Employee Directory Web パーツは、さらに既定 (Default) とダーク (Dark) のテーマにも対応しています。

#### 絞り込みパネル

絞り込みパネルを使用すると、選択したフィールドで検索結果を絞り込むことができます。このパネルは SharePoint ::検索サービス:: によって提供されるため、データ ソースがユーザー プロファイルの場合にのみ利用できます。

[![絞り込みパネル](https://static.vitextra.com/articles/10064/employee-directory-refinable-panel_thumb.png)](https://static.vitextra.com/articles/10064/employee-directory-refinable-panel.png){data-provide="lightbox" data-lity}
*絞り込みパネル*

このパネルでは、さまざまな構成オプションを利用できます。

- フィールドの表示順序
- 各値に対して表示する一致件数
- 名前または結果の件数による並べ替え
- パネルの位置 (左、右、または上)

💡 **ヒント**  
Employee Directory は、絞り込みパネルでのカスタム ユーザー プロファイル属性をサポートしています。

#### Excel へのエクスポート

現在の検索結果を Excel ファイルにエクスポートできます。詳細については、「[従業員リストを Excel スプレッドシートにエクスポートする](https://vitextra.com/ja/support/kb/10062)」を参照してください。

![[Excel にエクスポート] アクション リンク](https://static.vitextra.com/articles/10062/export-button.png)
*[Excel にエクスポート] アクション リンク*

📝 **注**  
エクスポートにはいくつかの制限があります。
- エクスポートされたスプレッドシートの列幅は固定です。
- テーブル スタイルは変更できず、常に **Blue, Table Style Medium 2** (青、テーブル スタイル (中) 2) に設定されます。

### Employee Directory (Entra ID)

これは、Microsoft Entra ID を唯一のデータ ソースとして使用する、Employee Directory Web パーツの専用バージョンです。Microsoft Entra ID 内のユーザーを対象とした、フル機能の検索を提供するように設計されています。外観と結果のレイアウトは自由にカスタマイズでき、標準の Employee Directory Web パーツと同じです。

![Employee Directory (Entra ID)](https://static.vitextra.com/articles/10064/employee-directory-azure-ad.png)
*Employee Directory (Entra ID)*

#### 動作と機能

Employee Directory (Entra ID) Web パーツは、まず Microsoft Entra ID からユーザーの完全なリストを取得し、それを基に検索を構築します。この方式により、次の機能が利用できます。

- **除外**: ライセンスのないユーザー、ブロックされたアカウント、部署または役職が空の従業員を検索結果から除外します。
- **検索対象フィールドの選択**: 従業員の検索に使用する属性を選択します。これらの属性は、結果の表示時に非表示にできます。
- **事前定義フィルター**: Web パーツの設定でフィルターを定義して、検索範囲を制限します。このフィルターは常に適用され、ユーザーが上書きすることはできません。

事前定義フィルターは、Web パーツのプロパティ ウィンドウにあるフィルター エディターで構成します。**フィルター** の下には現在のフィルターのテキスト プレビュー (または *フィルターは適用されていません*) が表示され、**フィルターの編集** ボタンで **高度なフィルター処理** パネルが開きます。このパネルでは、条件と条件グループを **かつ** / **または** で組み合わせます。条件には、組み込み属性またはカスタム属性を、*＝*、*が次の値で始まる*、*次を含む*、*が空白でない* などの演算子とともに使用できます。**アカウントの状態** と **ユーザー ロール** の条件も利用できます。クエリ言語の知識は必要ありません。

[![Employee Directory (Entra ID) のフィルター エディター](https://static.vitextra.com/articles/10064/query-builder_thumb.png)](https://static.vitextra.com/articles/10064/query-builder.png){data-provide="lightbox" data-lity}
*Employee Directory (Entra ID) のフィルター エディター*

💡 **ヒント**  
Employee Directory (Entra ID) では、カスタム属性を含む、利用可能な任意の属性からフィルターを作成できます。条件と演算子の詳しい説明については、「[KB10312. Employee Directory (Entra ID): フィルター エディターのリファレンス](https://vitextra.com/ja/support/kb/10312)」を参照してください。

**アルファベット ナビゲーション**: アルファベット ナビゲーションは、Microsoft Entra ID のユーザー データから自動的に生成されます。各従業員の姓の頭文字を使用して、文字の一覧が作成されます。

**絞り込みパネル**: Employee Directory (Entra ID) では、従業員のさまざまな属性から絞り込みパネルを作成できます。

❗ **重要**  
Microsoft Entra ID テナントのアクティブなユーザーが 2,000 人を超える場合、ページ上で Web パーツが初期化されるまでに 1 秒以上かかることがあります。

### New Employees

**New Employees** Web パーツには、Microsoft Entra ID に最近作成されたユーザーの一覧が表示されます。

![New Employees Web パーツ](https://static.vitextra.com/articles/10064/new-employees.png)
*New Employees Web パーツ*

Web パーツの設定で、表示する従業員の数 (1～10) と、**ここ数か月で作成されたユーザーを表示する** による対象期間 (1～6 か月、既定値は 3) を指定できます。さらに、同じフィルター エディターで一覧を絞り込んだり、カードとコンテキスト メニューで利用できる操作を選択したりできます。「[KB10207. New Employees Web パーツで新入社員を紹介する方法](https://vitextra.com/ja/support/kb/10207)」を参照してください。

📝 **注**  
New Employees Web パーツでは、現在、詳細ペインは利用できません。

## まとめ

Vitextra Employee Directory は、従業員の検索機能とプロファイル情報を SharePoint と Microsoft Teams に直接取り込みます。SharePoint Framework と Microsoft Graph API 上に構築されているため、お使いの環境にネイティブに統合され、各ユーザー自身のアクセス許可に基づいて Microsoft Entra ID からデータを安全に読み取ります。

カスタマイズ可能なビュー、クイック フィルターとお気に入り、スキル検索、テーマ バリエーション、絞り込みパネル、Excel へのエクスポートにより、このソリューションは組織の働き方に適応し、従業員が同僚を見つけてより迅速につながれるよう支援します。
