Microsoft 365 管理センターで Microsoft Graph コネクタを設定する
この記事では、Microsoft 365 管理センターで Microsoft Graph コネクタを設定するために必要な基本的なプロセスについて説明します。 基本的なプロセスには、以下のステップが含まれます。
- Microsoft 365 管理センターに Microsoft Graph コネクタを追加する
- 接続に名前を指定する
- 接続設定を構成する
- プロパティを選択する
- 検索のアクセス許可を管理する
- プロパティ ラベルを割り当てる
- スキーマを管理する
- 設定を更新する
- 接続を確認する
- 検索結果ページをカスタマイズする
この記事には、次の情報も含まれています。
注意
セットアップ プロセスは、すべての Microsoft Graph コネクタで似ていますが、まったく同じではありません。 この記事を読むことに加えて、お使いのデータ ソースのコネクタに固有の情報を必ずお読みください。
手順 1: Microsoft 365 管理センターに Microsoft Graph コネクタを追加する
Microsoft Graph コネクタのいずれかを構成するには、次の手順を実行します。
Microsoft 365 管理センターで、お使いの管理者アカウントにサインインします。
ナビゲーション ウィンドウで、[設定] を選択し、[検索とインテリジェンス] を選択します。 [データ ソース] タブを選択します。
[+ 追加] を選択し、使用可能なオプションのメニューから任意のデータ ソースを選択します。
注意
各テナントに最大 10 個の Microsoft Graph 接続を追加できます。
手順 2: 接続に名前を指定する
以下の属性を指定します。
- Name (必須)
- 接続 ID (必須)
- 説明 (省略可能)
- チェック ボックスの選択 (必須)
接続 ID によって、コネクタの暗黙的なプロパティが作成されます。 英数字のみを使用し、最大 32 文字にする必要があります。
手順 3. 接続設定を構成する
接続設定を構成するプロセスは、データ ソースの種類に応じて異なります。 セットアップ プロセスでこの手順を完了するためにテナントに追加するデータ ソースの種類については、 コネクタ固有の情報を参照してください。
オンプレミス データ ソースへの接続の詳細については、「 Microsoft Graph Connector Agent のセットアップ」を参照してください。
手順 4: プロパティを選択する
Microsoft Search によってインデックスが作成されるプロパティを選択できます。
注意
接続の作成後にクロールされたプロパティを更新するには、 検索スキーマの管理 に関する記事を参照してください。
手順 5: 検索のアクセス許可を管理する
アクセス制御リスト (ACL) によって、組織内のどのユーザーが各項目にアクセスできるかが決まります。
Microsoft SQL やAzure Data Lake Storage Gen2などの一部のコネクタでは、Azure Active Directory (Azure AD) ACL がネイティブにサポートされています。
ServiceNow Knowledge、ServiceNow カタログ、Azure DevOps 作業項目、Salesforce などの他のコネクタは、Azure AD 以外のユーザーとグループの同期をサポートします。
[すべてのユーザー] を選択すると、組織内のすべてのユーザーにこのデータ ソースからの検索結果が表示されます。
手順 6: プロパティ ラベルを割り当てる
ソース プロパティにセマンティック ラベルを割り当てるには、[プロパティ ラベルの割り当て] ページを使用します。 ラベルは Microsoft によって提供される既知のタグで、セマンティックな意味を提供します。 これにより、Microsoft は、強化された検索、ユーザー カード、インテリジェント検出などの Microsoft 365 エクスペリエンスにコネクタのデータを統合できます。
次の表に、現在サポートされているラベルとその説明を示します。
| Label | 説明 |
|---|---|
| title | 検索や他のエクスペリエンスに表示する、アイテムのタイトル |
| url | ソース システム内のアイテムのターゲット URL |
| 作成者 | アイテムを作成したユーザーの名前 |
| 最終更新者 | アイテムを最後に編集したユーザーの名前 |
| Authors | アイテムの作成に参加したり共同作業を行ったりしたユーザーの名前 |
| 作成日時 | アイテムが作成された時刻 |
| 最終更新日時 | アイテムが最後に編集された時刻 |
| ファイル名 | ファイル アイテムの名前 |
| ファイル拡張子 | .pdf や .word など、ファイル アイテムの種類 |
このページのプロパティはお使いのデータ ソースに基づいて事前に選択されていますが、特定のラベルにより適した別のプロパティがある場合は、この選択を変更できます。
ラベル タイトル が最も重要です。 接続が結果クラスター エクスペリエンスに参加できるように、このラベルにプロパティを割り当てることを 強くお勧めします。
ラベルのマッピングが正しくないと、検索エクスペリエンスが低下します。 一部のラベルにプロパティが割り当てられていなくても問題ありません。
手順 7: スキーマを管理する
コンテンツ プロパティ
オプションのドロップダウン メニューから コンテンツ プロパティ を選択するか、存在する場合は既定値のままにすることをお勧めします。 このプロパティは、コンテンツのフルテキスト インデックス処理、検索結果ページのスニペットの生成、結果クラスターへの参加、言語の検出、HTML/テキストのサポート、ランク付けと関連性、クエリの編成に使用されます。
コンテンツ プロパティを選択した場合は、結果の種類を作成するときにシステム生成プロパティ ResultSnippet を使用できます。 このプロパティは、クエリ時にコンテンツ プロパティから生成される動的スニペットのプレースホルダーとして機能します。 結果の種類でこのプロパティを使用すると、検索結果にスニペットが生成されます。
ソース プロパティのエイリアス
[スキーマの管理] ページの [エイリアス] 列で、プロパティにエイリアスを追加できます。 エイリアスは、プロパティのフレンドリ名です。 クエリやフィルターの作成で使用されます。 また、複数の接続からのソース プロパティを正規化して、同じ名前になるようにするためにも使用されます。 こうすることで、複数の接続を持つバーティカル用に 1 つのフィルターを作成できます。 詳細については、「検索バーティカルの管理」をご覧ください。
検索スキーマの属性
検索スキーマ属性を設定して、各ソース プロパティの検索機能を制御できます。 検索スキーマは、検索結果ページに表示される結果と、エンド ユーザーが表示およびアクセスできる情報を決定するのに役立ちます。
検索スキーマの属性には、クエリ、検索、取得、絞り込み に対するオプションがあります。 次の表に Microsoft Graph コネクタがサポートする各属性の一覧を示し、その機能について説明します。
| 検索スキーマの属性 | 職務 | 例 |
|---|---|---|
| SEARCH | プロパティのテキスト コンテンツを検索できるようにします。 プロパティ コンテンツは、フルテキスト インデックスに含められます。 | プロパティが タイトル の場合、エンタープライズ をクエリすると、テキストまたはタイトルに エンタープライズ という語句を含む回答が返されます。 |
| クエリ | クエリでは、特定のプロパティの一致を検索します。 その後、プロパティ名をプログラムで、または逐語的にクエリに指定できます。 | Title プロパティをクエリできる場合は、Title: エンタープライズ というクエリがサポートされます。 |
| 取得 | 検索可能なプロパティのみを結果の種類で使用し、検索結果に表示できます。 | |
| 絞り込み | 絞り込みオプションは、Microsoft 検索結果ページと同様に使用できます。 | 組織内のユーザーは、接続のセットアップ中に絞り込みプロパティがマークされている場合、検索結果ページの URL で フィルター処理できます。 |
ファイル共有コネクタを除くすべてのコネクタでは、カスタム型を手動で設定する必要があります。 各フィールドの検索機能をアクティブにするには、検索スキーマをプロパティの一覧にマップする必要があります。 接続構成アシスタントは、選択した一連のソース プロパティに基づいて検索スキーマを自動的に選択します。 このスキーマを変更するには、検索スキーマ ページで各プロパティと属性のチェック ボックスをオンにします。
検索スキーマの設定に関する制限事項と推奨事項
コンテンツ プロパティは検索のみ可能です。 ドロップダウンで選択した後、このプロパティを 取得 または クエリ のオプションと共に使用することはできません。
コンテンツ プロパティを使用して検索結果をレンダリングすると、パフォーマンスに大きな問題が発生します。 たとえば、ServiceNow のナレッジ ベース記事の Text コンテンツ フィールドの場合がそうです。
取得可能としてマークされたプロパティのみが検索結果にレンダリングされ、モダンな結果の種類 (MRT) の作成に使用できます。
検索可能とマークできるのは文字列プロパティのみです。
注意
接続の作成後にスキーマを更新するには、 検索スキーマの管理 に関する記事を参照してください。
手順 8: 更新の設定
更新間隔によって、データ ソースと Microsoft Search の間でデータが同期される頻度が決まります。 データ ソースの種類ごとに、データの変更頻度と変更の種類に基づいて、最適な更新スケジュールのセットが異なります。
更新間隔には 、[完全更新 ] と [ 増分更新] の 2 種類がありますが、一部のデータ ソースでは増分更新を使用できません。
完全更新を使用すると、検索エンジンは、以前のクロールに関係なく、コンテンツ ソースで変更されたアイテムを処理してインデックスを作成します。 完全更新は、次の状況に最適です。
- データの削除を検出する。
- 増分更新でエラーが検出され、失敗した。
- ACL が変更された。
- クロール ルールが変更された。
- 接続のスキーマが更新されました。
増分更新 を使用すると、検索エンジンは、前回正常にクロールされた後に作成または変更されたアイテムのみを処理してインデックスを作成できます。 その結果、コンテンツ ソース内のすべてのデータのインデックスが再作成されるわけではありません。 増分更新は、コンテンツ、メタデータ、アクセス許可、その他の更新を検出するのに最適です。
注意
増分クロールでは、現在 、アクセス許可 の更新の処理はサポートされていません。
増分更新は、変更されていない項目が処理されないため、完全更新よりもはるかに高速です。 ただし、増分更新を実行することを選択した場合でも、コンテンツ ソースと検索インデックスの間で正しいデータ同期を維持するために、完全更新を定期的に実行する必要があります。
手順 9: 接続を確認する
接続を完了する前に、構成全体を確認し、必要に応じて設定を編集できます。 まだ読んでいない場合は、お使いのデータ ソースのコネクタに固有の情報を必ずお読みください。 接続を完了する準備ができたら、[ 更新の完了] を選択します。
手順 10: 検索結果ページをカスタマイズする
接続を発行した後、バーティカルや結果の種類を使用して検索結果ページをカスタマイズする必要があります。 検索結果のカスタマイズの詳細については、垂直型と結果の種類を管理する方法を確認してください。
手順 11: 接続のセットアップが機能したかどうかを確認する
管理センターの [コネクタ] タブで、発行された接続の一覧に移動します。 更新と削除を行う方法については、「 接続を監視する」を参照してください。
トラブルシューティング
お使いのデータ ソースのコネクタに固有の情報をお読みください。
注意
現時点では、すべてのコネクタ固有の記事にトラブルシューティングの推奨事項が含まれているわけではありません。
制限事項
すべてのデータ ソースに適用される制限事項については、 Microsoft Graph コネクタの概要 に関する記事を参照してください。
データ ソースのコネクタ固有の情報を参照して、その特定の Microsoft Graph コネクタに他の制限事項が適用されるかどうかを確認します。