> For the complete documentation index, see [llms.txt](https://docs.nexthink.com/platform/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexthink.com/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/inbound-connectors/servicenow-tickets-connector.md).
# ServiceNow チケット コネクタ
ServiceNow Tickets コネクターは、ServiceNow に記録されたインシデントおよびリクエストタイプのチケットとの、安全で設定可能な統合を提供します。 リクエストタイプのチケットは、ServiceNow のサービス/リクエストカタログから作成される項目です。たとえば、カタログの設定に応じて、権限のリクエストやハードウェアのリクエストなどがあります。 このコネクターは、過去のインシデントおよびリクエストデータを取り込み、新規および更新されたチケットをストリーミングし、分析とインサイトを強化します。 すぐに使用できるマッピングが含まれており、セットアップを迅速化し、一貫したデータ統合を実現します。
ServiceNow Tickets コネクタは、エスカレーションされたチケットから Spark が継続的に学習できるようにします。 [Spark 設定とデータ入力の管理](/platform/ja/user-guide/spark/setting-up-and-managing-spark/managing-spark-settings.md) のドキュメントを参照してください。
## コネクタの認証情報の設定
Nexthink が ServiceNow インスタンスからチケット情報を取得できるようにするには、適切なアクセスレベルを持つ専用の統合アカウントを ServiceNow に設定します。 このコネクターは、ServiceNow Table API を介してインシデントおよびリクエストデータを読み取ります。
チケットの取得に使用する ServiceNow 認証情報を設定するには、以下の手順に従ってください：
1. ServiceNow Admin Console で、Nexthink 統合用の専用の有効な ServiceNow ユーザーアカウントを作成します。 API 認証用にアカウントを有効にします。
2. ServiceNow Roles 管理で、Nexthink 統合ユーザーに読み取り専用ロールを割り当てます。 既存のロールを使用するか、`x_nexthink_ticket_reader` などの専用ロールを作成します。
3. incident テーブルおよび request テーブルに対して、テーブルレベルの読み取り Access Control Lists（ACL）を設定します。 これにより、読み取り専用ロールは Table API を介してこれらのテーブルにアクセスできます。
4. コネクターが必要とするチケットフィールドに対して、フィールドレベルの読み取り ACL を設定します。
5. Nexthink 統合ユーザーに、管理者ロールまたは書き込みアクセスロールを割り当てないでください。
{% hint style="warning" %}
機密情報を含む可能性があるチケットも含め、Nexthink に公開するチケットのみに読み取り専用ロールのスコープを限定してください。
{% endhint %}
コネクターの認証情報の詳細については、[サードパーティ認証情報](/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/connector-credentials.md)ドキュメンテーションを参照してください。
## ServiceNow Tickets コネクターの設定
Nexthink web インターフェース から:
1. **Administration** > **Inbound connectors** に移動します。
2. ページの右上隅にある **新しいコネクタ** ボタンをクリックします。
3. **ServiceNow Tickets** を選択します。
### 一般タブ
* **Name**: コネクタにとって意味のある名前です。 この名前は管理ページに表示されます。
* **NQL ID**：NQL クエリで ServiceNow コネクタを参照する際に使用される、コネクタ固有の識別子です. 提案された NQL ID は最初に変更できますが、コネクタを保存すると以後は変更できなくなります。
* **Description**: コネクターの目的と動作に関する簡潔な説明です。
* **スケジューリング**:
* **繰り返し**：実行時刻と繰り返しを設定します。 実行は予定された時刻に開始され、その後1時間にわたって分散して行われます。
* **接続:**
* **資格情報**: コネクターの資格情報ページから事前設定済みの資格情報を選択します。 このコネクタは、OAuth 2.0 と Basic Auth の認証方法をサポートしています。 認証情報は、割り当てと ServiceNow の権限によって Nexthink が取得できるチケットを定義する、専用の統合ユーザーに属している必要があります。 機密情報を含む可能性があるチケットを含め、Nexthink に公開するチケットにその範囲を限定する責任はお客様にあります。 詳細については、[サードパーティ認証情報](/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/connector-credentials.md)ドキュメンテーションを参照してください。
### パラメータ タブ
* **レコードタイプ**: ServiceNow から収集するチケットタイプを定義します。 **Incidents** と **Requests** の両方がデフォルトで選択されています — 少なくとも1つは選択する必要があります。
* **クエリ（任意）**: Nexthink に取り込まれる ServiceNow のインシデントおよびリクエストをフィルタリングします。 `sysparm_query` 文字列を入力して、状態、カテゴリ、割り当てグループなどのフィルター条件を指定します。 `assignment_group` などのグループ名に基づいて ServiceNow チケットをフィルタリングするには、フィールドに `.name` を追加し、引用符なしで値を入力します。例：`assignment_group.name=SBS HDL`。
* **開始日**: コネクターによってデータの同期を開始する日付を選択します。
* **カスタムヘッダー**: OAuth 2.0 認証方式において、**Client Credentials** や **Authorization Code** などの追加資格情報を含めるためにカスタムヘッダーを使用します。 デフォルトのOAuth 2.0認証メカニズムを超えて追加の認証方法が必要な場合に便利です。 **OAuth 2.0 - クライアント認証情報**または**OAuth 2.0 - 認証コード**認証に追加情報を含めるには、**カスタムヘッダーを追加**を選択します。
Nexthink は、PII の削除を含め、取り込み前にすべてのチケットコンテンツをサニタイズします。 チケットのテキストは要約されます。元の文面は Nexthink に保存されず、アクセスすることもできません。 チケットに機密性の高いコンテンツが含まれている場合、その要約は空のままとなります。 取り込まれたチケットデータは、`tickets` NQL テーブルで利用できます。 詳細については、[NQLデータモデル](/platform/ja/understanding-key-data-platform-concepts/nql-data-model.md)を参照してください。
{% hint style="info" %}
**Applications** モジュールの [**Efficiency** ダッシュボード](https://docs.nexthink.com/platform/ja/technical-previews/application-business-view) 用に ServiceNow コネクタを構成する際は、インシデントではなく **サービスリクエストのみ** が集計対象となる点に注意してください。 コネクターパラメーターでインシデントのみが選択されている場合、データは表示されません。
{% endhint %}
## テスト結果パネル
{% hint style="info" %}
**テスト結果**パネルは、サポート対象のコネクタでのみ利用できます。 コネクタの可用性は、お客様のライセンスにも依存します。
{% endhint %}
右側の **Test results** パネルを使用すると、実際のデータでコネクターをオンデマンドで実行し、レスポンスやエラーを確認できます。 テストパネルは、セットアップ時のデバッグと検証をより迅速に行うのに役立ち、試行錯誤を減らして、より信頼性の高いマッピングを実現します。
API を呼び出し、認証情報を検証し、対象のエンドポイントへの接続性を確認するには、**Run test** ボタンを選択します。
レスポンスのステータスコードや時間といった基本情報に加えて、パネルの下部にはレスポンスのサンプルレコードも表示されます。
エラーが発生した場合、問題の診断に役立てるためにシステムは API のレスポンスを表示します。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.nexthink.com/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/inbound-connectors/servicenow-tickets-connector.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.