> 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 のチケットデータを Nexthink に取り込み、NQL を使用してクエリとレポートを実行できます。
{% hint style="info" %}
このコネクタは、過去のチケットに基づいて Spark または Workspace をグラウンディングしません。現在はどちらも、代わりに [ServiceNow Incidents コネクタ](/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/inbound-connectors/connector-for-servicenow-incidents.md)から学習します。 Spark または Workspace を使用する場合は、そのコネクタも設定してください。
今後のリリースで ServiceNow Incidents コネクタが非推奨になると、ServiceNow Tickets コネクタがこの役割を引き継ぎます。
{% endhint %}
## コネクタの認証情報の設定
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 インシデントとリクエストをフィルタリングします。 ServiceNow クエリ構文を使用します。
* **すべてのチケットのフィルター**：インシデントとリクエストの両方に適用するフィルターを入力します。例: `assignment_group=L1ServiceDesk`。
* **インシデントのみのフィルター**: インシデントにのみ適用するフィルターを入力します。例: `assignment_group=L1ServiceDesk`。
* **リクエストのみのフィルター**：リクエストのみに適用するフィルターを入力します。例: `stage=request_approved`。
{% hint style="info" %}
**インシデントのみのフィルター**または**リクエストのみのフィルター**にフィルターを追加すると、コネクターは一致するすべてのレコードを取り込みます。ただし、コネクターは子テーブルのフィルターに一致しないレコードをスキップするため、プラットフォームログでは実行が**部分的**としてマークされます。その結果、処理された行数は取り込まれた行数より少なくなります。たとえば、コネクターが64行を受信し、そのうち62行のみがフィルター条件に一致する場合、ログには処理された行数が62行、受信した行数が64行と表示されます。
{% endhint %}
* **開始日**：コネクターがチケットデータの同期を開始する日付を選択します。
* **カスタムヘッダー**: 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/user-guide/applications/monitoring-applications/monitoring-web-applications/ahead/efficiency) タブ用に 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
