大規模組織での Employee Directory: ページング、キャッシュ、合計、エクスポートの制限

はじめに

読み込み時間は、ディレクトリの規模、ネットワーク、ブラウザー、構成によって異なります。 一方、数千から数万のアカウントがあるテナントでは、Web パーツがユーザーをどのように取得するかが重要になります。最初のページが表示されるまでの時間、検索や絞り込みの反応速度、合計の正確さ、Excel へのエクスポートにかかる時間などです。

このソリューションには、異なる 2 つの読み込みモデルに基づくディレクトリ Web パーツが 2 つあります。Employee Directory (Entra ID) はディレクトリ全体を一度ブラウザーに読み込み、その後はメモリ上で動作します。Employee Directory は検索のたびにサーバーへクエリを送信し、結果を 1 ページずつ読み込みます。この記事では、両方のモデル、それらに影響する設定、および大規模な組織向けのディレクトリの構成方法について説明します。

2 つの読み込みモデルの概要

Employee Directory (Entra ID): ディレクトリ全体をブラウザーに

初回読み込み

キャッシュされたデータがない状態で Web パーツが開かれると、Microsoft Graph からすべてのユーザーを 900 アカウントずつのページで読み取り、最後のページが届くまでページング リンクをたどります。一覧が表示されるのはその後で、それまでは読み込み中のインジケーターが表示されます。そのため、この初回読み込みにかかる時間はテナントのアカウント数に応じて長くなります。

Microsoft Graph が返す内容を変える設定が 2 つあります。

• ブロックされたユーザーを除外する (従業員を除外する グループ、既定でオン) は Microsoft Graph 側で適用されます。無効化されたアカウントはまったくダウンロードされないため、読み込みが短くなります。
• 上司 列: 一覧またはカードに表示されている場合 (リストに表示する または カードに表示)、各ユーザーはその上司と一緒に要求されます。そのため Microsoft Graph の要求が重くなり、キャッシュされるデータも大きくなります。どちらでも非表示の場合、上司は要求されません。

その他の除外はすべて、データの受信後にブラウザーで適用されます。ゲスト アカウントは常に除外され、ライセンスのない従業員を除外する、空の部門を持つ従業員を除外する、空白の役職を持つ従業員を除外する、および定義済みフィルターによって一覧がさらに絞り込まれます。これらは一覧を短くしますが、ダウンロードされるデータ量は減りません。

ブラウザー キャッシュと更新

読み込みが成功すると、Web パーツは一覧を圧縮 JSON としてブラウザーのローカル ストレージのキー Vitextra.EmployeeDirectory.Data に、読み込み時刻とともに保存します。次回のアクセス時は次のようになります。

1. ディレクトリは、バックグラウンド更新の前にキャッシュのユーザー一覧を使用します。写真、プレゼンス、その他の機能では、追加データが要求される場合があります。
2. キャッシュされたコピーが 24 時間より古い場合、Web パーツはバックグラウンドで Microsoft Graph からデータを再読み込みします。読み込み中もキャッシュの一覧は画面に表示されたままで、新しいデータが届くと置き換えられます。

結果の上にある 最終更新日時: にはデータの経過時間 (例: 「最終更新日時: 3 時間前」) が表示され、その横の 更新 リンクを選択すると、必要なときにディレクトリ全体を Microsoft Graph から再読み込みできます。手動で更新すると、初回読み込みと同様に読み込み中のインジケーターが表示されます。

バックグラウンド更新や手動更新が失敗しても、読み込み済みの空でない一覧がある場合は、その一覧と元の更新時刻が保持され、警告 一覧を更新できませんでした。保存済みのコピーを表示しています。 が表示されます。続けて技術的なエラー情報が表示される場合もあります。手動更新が失敗した場合は、読み込み中の表示が以前の一覧に戻ります。読み込み済みの空でない一覧がない場合は、代わりにエラーが表示されます。後で 更新 を再試行し、警告が続く場合は接続と承認済みの Microsoft Graph のアクセス許可を確認してください。

キャッシュには次の特性があります。

• ブラウザー ストレージ。 キャッシュは同じブラウザー プロファイルと SharePoint オリジンで共有され、サインインした Microsoft 365 アカウント別には分離されません。他のプロファイルやデバイスには別のストレージがあります。ブラウザー データを消去するとキャッシュも削除されます。
• すべての Web パーツで 1 つのコピーを共有します。 同じブラウザーで同じ SharePoint ドメイン上で開かれたすべての Employee Directory (Entra ID) Web パーツは、どのページにあっても 1 つのキャッシュ コピーを共有します。
• Entra ID での変更は更新後に反映されます。 Microsoft Graph が返す変更は、バックグラウンド更新または手動更新が成功した後、構成したフィルターと除外設定に従って反映されます。
• データを再読み込みする設定とそうでない設定があります。 ライセンスのない従業員を除外する、空の部門を持つ従業員を除外する、空白の役職を持つ従業員を除外する、ブロックされたユーザーを除外する、または ユーザー設定の列 を変更すると、ディレクトリが Microsoft Graph から再読み込みされます。上司 列を表示しても再読み込みは行われません。キャッシュされたコピーは上司なしで読み込まれています。

ブラウザー ストレージがいっぱいの場合

ローカル ストレージの容量には上限があり、同じオリジンの他のデータと共有されます。圧縮したディレクトリを保存できなくても、読み込んだ一覧はメモリ上で使用できます。以前のキャッシュが残る場合もあります。利用可能なコピーがなければ、次回は全件の読み込みが必要です。

典型的な兆候: ディレクトリが開くまでに毎回最初のアクセス時と同じくらい時間がかかり、最終更新日時: が常に直前の時刻を示します。データ量を減らすには、ブロックされたユーザーを除外する をオンのままにし、不要であれば 上司 列を非表示にし、ページで実際に使用する ユーザー設定の列 のみを構成します。

メモリ上で動作する機能

テキスト検索、絞り込み、A–Z ナビゲーション、自分の部署、並べ替え、グループ化、合計、エクスポートは、読み込んだ一覧をブラウザー内で処理します。速度は一覧のサイズやデバイスに依存します。スキル検索、個人用クイック フィルター、ロールのメンバー取得、写真、プレゼンス、詳細セクションでは引き続きネットワーク要求が発生する場合があります。

1 ページあたりの表示件数: はダウンロードされる内容を変更しません。一度に表示する人数を制限するだけで、一覧の下の その他の結果を表示します... は既に読み込まれたデータの次の部分を表示します。

Employee Directory: サーバーから 1 ページずつ

Employee Directory Web パーツはディレクトリをブラウザーに保持しません。ページが開かれたとき、検索が実行されたとき、絞り込みが選択されたとき、または 自分の部署 クイック フィルターがオンになったときに、データ ソース で選択したソースに新しいクエリを送信し、結果の最初のページだけを受け取ります。

• ユーザー プロファイル - Web パーツは SharePoint の人物検索を実行します。ページ サイズは返す行数として渡され、次のページは既に読み込まれた行の後から始まります。検索結果の絞り込みパネルの値は、クエリのたびに SharePoint 検索から返されます。
• Entra ID (Azure AD) - Web パーツは、ページ サイズを結果の件数として Microsoft Graph にユーザーのクエリを送信します。Microsoft Graph は次のページへのリンクを返し、Web パーツは次の部分の読み込みにそれを使用します。

さらに結果がある場合は、一覧の下に その他の結果を表示します... が表示されます。このボタンはサーバーに次のページを要求して一覧に追加します。要求の処理中は、ボタンの代わりに 検索... が表示されます。

1 ページだけを要求すると初回の転送量を減らせます。サーバー検索や絞り込みの選択には毎回要求が必要で、応答時間はサービスとクエリに依存します。結果は Microsoft Graph の応答または SharePoint 検索インデックスを反映します。

自分のチーム、一緒に仕事をしている人、お気に入り のクイック フィルターは、どちらの Web パーツでも例外です。これらは独自の短いユーザー一覧を表示し、ブラウザーでフィルターされ、ページングされません。

ページ サイズの設定

ページ サイズは、データ ソース グループの 1 ページあたりの表示件数: スライダーで設定します。範囲と既定値は Web パーツによって異なります。

すべてのアイテムを表示するための個別のオプションはありません。Employee Directory (Entra ID) では、スライダーを 0 に設定します。Employee Directory では結果は常にページングされ、残りは その他の結果を表示します... で読み込みます。

合計

合計の表示 がオンの場合 (表示 グループ、既定でオン)、結果の上のツール バーに 結果の総数: が表示されます。この数値の意味は 2 つのモデルで異なります。

• Employee Directory (Entra ID) は、メモリ上のフィルター後の一覧の人数を数えます。除外、定義済みフィルター、クイック フィルター、絞り込み、A–Z の文字、検索テキストを適用した後の件数です。この件数は正確で、現在のページに表示されている人だけでなく結果全体が対象です。
• Employee Directory は、現在のクエリについてサーバーが返す合計を表示します。SharePoint 検索の結果件数、または Microsoft Graph が返す件数です。Entra ID (Azure AD) ソースで スキルで検索 がオンの場合は、スキルによって見つかったユーザーがこの件数に加算されます。合計は、これまでに読み込まれたページだけでなく、一致するすべてのユーザーが対象です。
• 自分のチーム、一緒に仕事をしている人、お気に入り のクイック フィルターでは、どちらの Web パーツもその一覧の人数を数えます。

パフォーマンスに影響する設定

大量の結果の Excel へのエクスポート

エクスポート グループで Microsoft Excel スプレッドシート トグルがオンになっていると、結果の上に Excel にエクスポート リンクが表示されます。どちらの Web パーツでも、このリンクは Employees という名前のテーブルを 1 つ含むファイル employee-directory.xlsx を Table Style Medium 2 のスタイルで作成します。テーブルには、詳細 ビューに表示される列 (リストに表示する) が、ユーザー設定の列も含めて構成された順序で含まれます。ただし イメージ と 状態 は除きます。

ファイルに含まれる内容は読み込みモデルによって異なります。

• Employee Directory (Entra ID) は、フィルター後の一覧全体を現在の並べ替え順でエクスポートします。除外、定義済みフィルター、クイック フィルター、絞り込み、A–Z の文字、検索テキストに一致するすべてのユーザーが対象で、現在のページに表示されている人だけではありません。データは既にメモリにあるため、追加の要求なしにファイルが作成されます。
• Employee Directory は、現在のクエリ (検索テキスト、保存済みクエリ、選択された絞り込み、自分の部署 クイック フィルター) のすべての結果を 100 件ずつのページでサーバーに再度クエリし、その後ファイルを作成します。100 件のページごとに個別の要求になるため、結果が多い場合は時間がかかります。
• 自分のチーム、一緒に仕事をしている人、お気に入り のクイック フィルターでは、どちらの Web パーツもその一覧のユーザーをエクスポートします。

ページの取得中はエクスポート リンクが非表示になります。詳細 と 連絡先 の両方に、Excel にエクスポート中 と件数（例：「レコード 1 ～ 300 / 1250」）が表示されます。ダウンロードが始まるまでページを開いたままにしてください。

組織の規模別の推奨事項

以下は一般的な推奨事項です。実際の読み込み時間は、サービス、ネットワーク、ブラウザー、構成した列によって異なります。キャッシュなしの読み込みを測定するには、新しいブラウザー プロファイルを使用するか、サイトのブラウザー データを消去してからテストしてください。

症状と対処方法

関連記事