Zendeskガイド外部クロールコネクタのクロール設定を構成する

コンテンツクロールの実行時に Zendesk Guide 外部コンテンツコネクタでクロールする記事のロケールと添付ファイルの種類を指定します。ドメインの包含フィルターまたは除外フィルターを定義して、ユーザー 権限のクロールを実行するときに、クロールがアクセス権限を取得するユーザーのセットを制限します。

始める前に

コネクタアドミンは、クロール設定を構成する ZendeskGuide 外部コンテンツコネクタを既に作成している必要があります。この手順の詳細については、「Zendeskガイド外部コンテンツコネクタの作成」を参照してください。

必要なロール：sn_ext_conn.xcc_admin

このタスクについて

このタスクはオプションです。デフォルトでは、Zendesk Guide 外部コンテンツコネクタは、ユーザー 権限のクロール中にソースシステムからすべてのユーザーをクロールします。コンテンツのクロール中、デフォルトでは、すべてのロケールからヘルプセンターの記事を取得し、サポートされているファイル拡張子を持つすべての添付ファイルを取得します。このタスクを実行する必要があるのは、コネクタで次のデフォルト以外の設定のいずれかを使用する場合のみです。

• ユーザー 権限クロールを実行するときにソースシステムにアクセスするユーザーアカウントの包含フィルターまたは除外フィルター
• コンテンツクロールの実行時にクロールするヘルプセンター記事ロケールの包含フィルターまたは除外フィルター
• コンテンツのクロールの実行時に取得する添付ファイル拡張子の包含フィルターまたは除外フィルター

コンテンツは、構成されたすべてのクロール設定フィルターに合格した場合にのみ、ソースシステムから取得されます。クロール設定フィルターでコンテンツアイテムが除外されている場合、外部コンテンツコネクタはコンテンツアイテムを取得しません。

重要:

デフォルトでは、各外部コンテンツコネクタは、ソースシステムから最大 1,000 万 (10,000,000) 個のコンテンツアイテムのインデックスを作成できます。コネクタは、この制限を超えると、ソースシステムのクロールを続行しますが、コンテンツアイテムの削除と更新のみをインデックス作成のために AI 検索 に送信し、新しいコンテンツアイテムは無視します。コネクタは、インデックス作成制限を超えてクロールする 10,000 のコンテンツアイテムごとにエラーメッセージをログに記録します。

コネクタのインデックス付きコンテンツアイテムの数が 800,000 を超えると、インデックス作成の制限に近づいていることを示す警告メッセージがコネクタの UI に表示されます。コネクタがインデックス作成の制限に達すると、コネクタの UI にエラーメッセージが表示されます。

ユーザー権限クロールをサポートする外部コンテンツコネクタは、最大 50 万人のユーザーとそのグループの権限を処理できます。コネクタがこの制限を超えてユーザーを取得すると、コネクタの取得されたコンテンツにユーザー権限とグループの権限が正しく適用されない可能性があります。その結果、コンテンツが検索できなくなる可能性があります。

コネクタの 1 つがコンテンツインデックス作成の制限に達した場合は、そのクロール設定とファイルの包含/除外フィルターを更新して、取得するコンテンツアイテムの数を減らすことができます。または、10,000,000 を超えるコンテンツアイテムにインデックスを付けるためにコネクタが必要な場合は、https://support.servicenow.com/now でカスタマーサービス & サポートケースを作成して、コネクタの制限の引き上げを要求できます。

手順

1. 移動先 すべて > 外部コンテンツコネクタ > 外部コンテンツアドミンホーム.
2. [コネクタ] リストで、設定を変更する Zendesk Guide 外部コンテンツコネクタのレコードを選択します。
3. コネクタエディターの 設定] タブで、[ [クロール設定] を選択します。
4. 次のいずれかのユーザー 権限フィルタリングオプションを選択します。
   • ソースシステムからすべてのユーザーのユーザー 権限を取得するには、[すべてのユーザーをマッピング] を選択します。

   • ソースシステムの指定されたドメインからのみユーザーのユーザー 権限を取得するには、[これらのユーザーのみをマッピング] を選択し、[含めるユーザーのメールアドレスのドメインを追加] フィールドと [追加] ボタンを使用して、ユーザー 権限のクロールにユーザーを含めるドメインを入力します。

     たとえば、「example.com」と入力すると、指定したドメインのユーザーのユーザー 権限のみを含めることができます。

5. 次の ロケールフィルタリング オプションのいずれかを選択します。
   • ソース システムで定義されているすべてのロケールから記事をクロールするには、[ すべてのロケールをクロール] を選択します。

   • ソース システムで定義されている指定したロケール セットの記事のみをクロールするには、[ これらのロケールのみを含める] を選択し、[ 含めるロケール ] フィールドを使用して、クロールに含める記事のロケールの識別子を入力します。

     たとえば、 en-US と es-MX を入力すると、英語 (米国) またはスペイン語 (メキシコ) のロケールの記事から検索可能なコンテンツのみをクロールできます。

   • ソース システムで定義されている指定したロケール セットの記事を除くすべての記事をクロールするには、[ これらのロケールのみを除外する] を選択し、[ 除外するロケール ] フィールドを使用して、クロールから除外する記事のロケールの識別子を入力します。

     たとえば、 pt-BR と入力すると、ブラジル ポルトガル語ロケールの記事から検索可能なコンテンツを除外できます。

6. 次のいずれかの 添付ファイルフィルタリング オプションを選択します。
   • サポートされているファイル拡張子を持つすべての添付ファイルをソースシステムから取得するには、[ すべての添付ファイルをクロール] を選択します。

   • 指定したファイル拡張子を持つ添付ファイルのみをソースシステムから取得するには、[ これらのファイル拡張子のみを含める] を選択し、[ 含めるファイル拡張子] フィールドを使用して、クロール時にコネクタに含める添付ファイル拡張子を入力します。

     たとえば、「 .docx 」と入力すると、 Microsoft Word ファイル形式の添付ファイルのみを取得できます。

   • 指定されたファイル拡張子を持つ添付ファイルを除くすべての添付ファイルをソースシステムから取得するには、[ これらのファイル拡張子のみを除外する] を選択し、[ 除外するファイル拡張子] フィールドを使用して、クロール時にコネクタで除外する添付ファイルの拡張子を入力します。

     たとえば、「 .csv 」と入力すると、カンマ区切り値 (CSV) ファイル形式の添付ファイルを除外できます。

   サポートされている添付ファイルの拡張子の詳細については、「 外部コンテンツコネクタでサポートされているバイナリファイル拡張子」を参照してください。
7. [保存して検証] を選択します。

タスクの結果

Zendesk Guide 外部コンテンツコネクタが、変更したクロール設定で更新されます。

次のタスク

変更したクロール設定を使用して Zendesk Guide ソースシステムからコンテンツを取得するには、 Zendesk Guide 外部コンテンツコネクタの 1 回限りのコンテンツクロールを作成して実行します。1 回限りのコンテンツクロールの作成と実行については、「 外部コンテンツコネクタのコンテンツクロールの作成」を参照してください。