---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference
Release :
- xanadu
ft:locale :
- ja-JP
ft:publication_title :
- Xanadu API リファレンス
ft:clusterId :
- crapiref
bundleId :
- crapiref
workflow :
- Creator
---
# トラブルチケットオープン API
# トラブルチケットオープン API {#ariaid-title1}
* リリースバージョン: Xanadu
*
* 更新日 2024年08月01日
*
*  所要時間：94分
トラブルチケットオープン API は、ケース \[sn_customerservice_case\] およびインシデント \[incident\] テーブルからデータを作成、更新、および取得するためのエンドポイントを提供します。
この API を使用して、外部のチケットシステムと Now Platform の間のチケット情報を管理します。
この API は、ServiceNow Store で利用可能な[電気通信保証ワークフロー](https://store.servicenow.com/sn_appstore_store.do#!/store/application/9e07323d5b2110100206cb837b81c773)アプリケーションに含まれています。この API をケース \[sn_customerservice_case\] テーブルとともに使用するには、カスタマーサービス (com.sn_customerservice) および Customer Service Install Base Management (com.snc.install_base) アプリケーションが必要です。
この API は、 `sn_ind_tsm_sdwan` 名前空間内で提供されます。
呼び出し元ユーザーには、ticket_integrator ロールが必要です。
この API を拡張して、必要なパラメーター、要求本文の検証、追加の REST 操作、およびフィールドマッピングに関するカスタマイズを実行できます。詳細については、次を参照してください：[トラブルチケットオープンAPI開発者ガイド](https://servicenow-prod.fluidtopics.net/97j0TFAQn61U7J~pv82seg#trouble-ticket_dev-guide "トラブルチケットオープン API を使用して、外部のチケットシステムと Now Platform の間のチケット情報を管理します。この API は、ケース [sn_customerservice_case] およびインシデント [incident] テーブルのデータを作成、更新、取得します。")を参照してください。
トラブルチケットオープン API は、TM Forum Trouble Ticket Management API REST 仕様の ServiceNow® 実装です。この実装は、[TMF621 Trouble Ticket Management API REST Specification Release 19](https://www.tmforum.org/resources/specification/tmf621-trouble-ticket-management-api-rest-specification-r19-0-0/) (2019 年 6 月) に基づいています。トラブルチケットオープン API は、TM Forum によって適合性が認定されています。
## トラブルチケット - GET /sn_ind_tsm_sdwan/ticket/troubleTicket {#ariaid-title2}
すべてのトラブルチケットレコードリストを、ケース \[sn_customerservice_case\] およびインシデント \[incident\] テーブルから取得します。
### URL 形式
デフォルトの URL：/api/sn_ind_tsm_sdwan/ticket/troubleTicket
### サポートされている要求パラメーター
{#trouble-ticket-GET-ticket-tt__entry__2}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 1. パスパラメーター]
{#trouble-ticket-GET-ticket-tt__entry__6}
| 名前 | 説明 |
|-|-|
| fields | 応答で返すフィールドのリスト。無効なフィールドは無視されます。 有効なフィールド： * channel * creationDate * 説明 * href * id * lastUpdate * name * note * relatedEntity * relatedParty * severity * status * ticketType * @type {#trouble-ticket-GET-ticket-tt__ul_n1h_htz_54b} デフォルト：すべてのフィールドを返します。 データタイプ：文字列 |
| id | トラブルチケットを sys_id でフィルタリングします。指定された sys_id のチケットのみが応答で返されます。 データタイプ：文字列 |
| limit | 返されるレコードの最大数。このレコード数を超える要求の場合は、offset パラメーターを使用してレコード取得をページネーションします。 デフォルト：25 最大：100 デフォルト値と最大値を変更するには、sn_ind_tsm_sdwan.pagination.set_limit および sn_ind_tsm_sdwan.pagination.max_limit システムプロパティを更新します。 データタイプ：数値 |
| offset | レコードの取得を開始する開始インデックス。この値を使用して、レコード取得をページネーションします。この機能により、レコード数に関係なく、管理しやすい小さなチャンクに分割してすべてのレコードを取得できます。 デフォルト：0 データタイプ：数値 |
| severity | トラブルチケットを重大度でフィルタリングします。指定された重大度のチケットのみが応答で返されます。 データタイプ：文字列 |
| status | トラブルチケットをステータスでフィルタリングします。指定されたステータスのチケットのみが応答で返されます。 データタイプ：文字列 |
| ticketType | トラブルチケットをチケットタイプでフィルタリングします。指定されたタイプのチケットのみが応答で返されます。 有効な値： * ケース * インシデント {#trouble-ticket-GET-ticket-tt__ul_pb5_lk3_ktb} データタイプ：文字列 |
[表 : 2. クエリパラメータ]
{#trouble-ticket-GET-ticket-tt__entry__22}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 3. 要求本文パラメーター (JSON)]
### ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#trouble-ticket-GET-ticket-tt__entry__26}
| ヘッダー | 説明 |
|-|-|
| なし | |
[表 : 4. 要求ヘッダー]
{#trouble-ticket-GET-ticket-tt__table_c2r_4gm_lsb__entry__2}{#trouble-ticket-GET-ticket-tt__content-range-row}{#trouble-ticket-GET-ticket-tt__content-type-row}{#trouble-ticket-GET-ticket-tt__links-pagination-row}{#trouble-ticket-GET-ticket-tt__x-total-count-descr}
| ヘッダー | 説明 |
|-|-|
| Content-Range | ページネーションされた呼び出しで返されるコンテンツの範囲を指定します。 たとえば、`offset=2` および `limit=3` の場合、Content-Range ヘッダーの値は `items 3-5` です。 |
| Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Link | クエリー結果内を移動するための次のリンクが含まれています。 * first * last * next * previous {#trouble-ticket-GET-ticket-tt__ul_zzk_sdm_lsb} |
| X-Total-Count | ページネーションされたクエリの場合、このヘッダーはサーバーで利用可能なレコードの合計数を指定します。 |
[表 : 5. 応答ヘッダー]
{#trouble-ticket-GET-ticket-tt__table_c2r_4gm_lsb}
### ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#trouble-ticket-GET-ticket-tt__table_qbg_4cm_lsb__entry__2}{#trouble-ticket-GET-ticket-tt__tmf-get-status-200-p}{#trouble-ticket-GET-ticket-tt__tmf-get-status-206-entry}{#trouble-ticket-GET-ticket-tt__tmf-get-status-400-entry}{#trouble-ticket-GET-ticket-tt__tmf-get-status-404-entry}
| ステータスコード | 説明 |
|-|-|
| 200 | 要求が正常に処理されました。応答で完全なリソースが返されました (ページネーションなし)。 |
| 206 | 応答で部分的なリソースが返されました (ページネーションあり)。 |
| 400 | 要求が正しくありません。考えられる理由： * 無効なパスパラメーター * 無効な URI {#trouble-ticket-GET-ticket-tt__ul_rys_1gy_fsb} |
| 404 | レコードが見つかりません。クエリパラメーターに一致するレコードがテーブルに見つかりません。 |
[表 : 6. ステータスコード]
{#trouble-ticket-GET-ticket-tt__table_qbg_4cm_lsb}
### 応答本文のパラメーター (JSON) {#trouble-ticket-GET-ticket-tt__section_mgj_t43_ktb}
{#trouble-ticket-GET-ticket-tt__table_n4d_yvm_5pb__entry__2}
| 名前 | 説明 |
|-|-|
| channel | チケットの作成に使用された連絡方法。 データタイプ：オブジェクト "channel":{ "name": "String" } |
| channel.name | 連絡方法の名前。ケースのチャネル \[contact_type\] フィールドとインシデントの連絡先タイプ \[contact_type\] フィールドにマップされます。 データタイプ：文字列 |
| creationDate | ケースまたはインシデントレコードが作成された日付。\[作成日時\] フィールドにマップされます。 データタイプ：文字列 |
| 説明 | チケットの問題の説明。\[説明\] フィールドにマップされます。 データタイプ：文字列 |
| href | ケースまたはインシデントレコードへの相対リンク。 データタイプ：文字列 |
| id | ケースまたはインシデントレコードの sys_id。 データタイプ：文字列 |
| lastUpdate | レコードが最後に更新された日付。\[更新日時\] フィールドにマップされます。 データタイプ：文字列 |
| name | トラブルチケットの名前 (通常は問題の簡単な説明)。\[簡単な説明\] フィールドにマップされます。 データタイプ：文字列 |
| note | チケットのすべてのコメントのリスト。このリストには作業メモは含まれません。 データタイプ：アレイ "note":[ { "author": "String", "date": "String", "text": "String", "@type": "String" } ] |
| note.@type | メモのタイプ。(作業メモではなく) コメントのみが返されるため、この値は常に `comments` です。 データタイプ：文字列 |
| note.author | コメントを作成した POST または PATCH 要求を行った ServiceNow 統合ユーザーの名前。 データタイプ：文字列 |
| note.date | ServiceNow インスタンスでコメントが作成された日付。 データタイプ：文字列 |
| note.text | コメントのテキスト。 データタイプ：文字列 |
| relatedEntity | 影響を受ける資産、製品、販売済み製品 (製品インベントリ)、構成アイテム、またはサービスのリスト。 データタイプ：アレイ "relatedEntity": [ { "id": "String", "href": "String", "name": "String", "role": "String", "@referredType": "String", "@type": "String" } ] |
| relatedEntity.id | 影響を受けるアイテムまたはサービスの sys_id。 この値は次のいずれかのテーブルから取得されます。 * 資産 \[alm_asset\] * 製品モデル \[cmdb_model\] * 販売済み製品 \[sn_install_base_sold_product\] * 製品インベントリ \[sn_prd_invt_product_inventory\] は、販売済み製品 \[sn_install_base_sold_product\] テーブルを拡張します。 {#trouble-ticket-GET-ticket-tt__ul_en1_3jc_hwb}インシデントの場合、この値は次のいずれかのテーブルから取得されます。 * 構成アイテム (CI) \[cmdb_ci\] * サービス \[cmdb_ci_service\] {#trouble-ticket-GET-ticket-tt__ul_fn1_3jc_hwb} データタイプ：文字列 |
| relatedEntity.href | 空の文字列を返します。 データタイプ：文字列 |
| relatedEntity.name | 影響を受けるアイテムまたはサービスの名前。 データタイプ：文字列 |
| relatedEntity.role | 影響を受けるアイテムまたはサービスの説明。 データタイプ：文字列 |
| relatedEntity.@referredType | アイテムまたはサービスのタイプ。 ケースチケットの有効な値： * 資産 * product * product_inventory {#trouble-ticket-GET-ticket-tt__ul_zrm_5jp_mtb} インシデントチケットの有効な値： * cmdb_ci * cmdb_ci_service {#trouble-ticket-GET-ticket-tt__ul_asm_5jp_mtb} データタイプ：文字列 |
| relatedEntity.@type | この値は常に `relatedEntity` です。 データタイプ：文字列 |
| relatedParty | チケットの連絡先に関する詳細。 データタイプ：アレイ "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String" } ] |
| relatedParty.id | 関係者の sys_id。sys_id は、チケットタイプと関係者タイプに応じて、次のテーブルから取得できます。 ケース： * アカウント \[customer_account\] - 関係者タイプは customer です。 * 連絡先 \[customer_contact\] - 関係者タイプは customer_contact です。 {#trouble-ticket-GET-ticket-tt__ul_vf5_n3g_4tb} インシデント： * 会社 \[core_company\] - 関係者タイプは customer です。 * ユーザー \[sys_user\] - 関係者タイプは customer_contact です。 {#trouble-ticket-GET-ticket-tt__ul_ll2_p3g_4tb} ケースまたはインシデント： * グループ \[sys_user_group\] - 関係者タイプは assignment_group です。 * ユーザー \[sys_user\] - 関係者タイプは assigned_to です。 {#trouble-ticket-GET-ticket-tt__ul_umf_r3g_4tb} データタイプ：文字列 |
| relatedParty.name | 関係者の名前。 データタイプ：文字列 |
| relatedParty.@referredType | 関連するパーティのタイプ。 可能な値： * assigned_to：チケットの作業にアサインされたユーザー。 * assignment_group：チケットの作業にアサインされたグループ。 * customer：チケットの会社またはアカウント。 * customer_contact：チケットの問い合わせユーザーまたは連絡先。 {#trouble-ticket-GET-ticket-tt__ul_bxv_jgg_4tb} データタイプ：文字列 |
| severity | トラブルチケットに記載されている問題の重大度。\[優先度\] フィールドにマップされます。 データタイプ：文字列 |
| status | トラブルチケットの現在のステータス。\[ステータス\] フィールドにマップされます。 データタイプ：文字列 |
| ticketType | チケットのタイプ。 可能な値： * ケース * インシデント {#trouble-ticket-GET-ticket-tt__ul_czp_2mc_ktb} データタイプ：文字列 |
| @type | この値は常に `TroubleTicket` です。 データタイプ：文字列 |
[ ]
{#trouble-ticket-GET-ticket-tt__table_n4d_yvm_5pb}
### cURL 要求
この例では、最初の 5 つのトラブルチケットケースレコードの指定されたフィールドを返します。
curl "https://instance.servicenow.com/api/sn_ind_tsm_sdwan/ticket/troubleTicket?limit=5&fields=id%2Cname%2Cdescription%2Cstatus%2Cseverity%2CticketType&ticketType=case" \
--request GET \
--user 'username':'password'
応答本文。
[
{
"id": "0004609eb9830110f877b3758cd21d37",
"name": "Compliant Over 2796",
"description": "checkNo2796",
"status": "New",
"severity": "3 - Moderate",
"ticketType": "Case"
},
{
"id": "000560d2b9c30110f877b3758cd21d36",
"name": "Compliant Over 4696",
"description": "checkNo4696",
"status": "New",
"severity": "3 - Moderate",
"ticketType": "Case"
},
{
"id": "0007ac5eb9c30110f877b3758cd21d34",
"name": "Compliant Over 8817",
"description": "checkNo8817",
"status": "New",
"severity": "3 - Moderate",
"ticketType": "Case"
},
{
"id": "0007ac5eb9c30110f877b3758cd21d39",
"name": "Compliant Over 8819",
"description": "checkNo8819",
"status": "New",
"severity": "3 - Moderate",
"ticketType": "Case"
},
{
"id": "0007ac5eb9c30110f877b3758cd21d3e",
"name": "Compliant Over 8821",
"description": "checkNo8821",
"status": "New",
"severity": "3 - Moderate",
"ticketType": "Case"
}
]
## トラブルチケット - GET /sn_ind_tsm_sdwan/ticket/troubleTicket/{id} {#ariaid-title3}
指定されたレコードを、ケース \[sn_customerservice_case\] またはインシデント \[incident\] テーブルから取得します。
### URL 形式 {#trouble-ticket-GET-ticket-tt-id__section_fcs_wqm_5pb}
デフォルトの URL：/api/sn_ind_tsm_sdwan/ticket/troubleTicket/{id}
### サポートされている要求パラメーター
{#trouble-ticket-GET-ticket-tt-id__table_ufw_yqm_5pb__entry__2}
| 名前 | 説明 |
|-|-|
| id | 取得するケースまたはインシデントレコードの sys_id。ケース \[sn_customerservice_case\] またはインシデント \[incident\] テーブルにあります。 データタイプ：文字列 |
[表 : 7. パスパラメーター]
{#trouble-ticket-GET-ticket-tt-id__table_ufw_yqm_5pb} {#trouble-ticket-GET-ticket-tt-id__table_cn5_zqm_5pb__entry__2}
| 名前 | 説明 |
|-|-|
| fields | 応答で返すフィールドのリスト。無効なフィールドは無視されます。 有効な値： * channel * creationDate * 説明 * href * id * lastUpdate * name * note * relatedEntity * relatedParty * severity * status * ticketType * @type {#trouble-ticket-GET-ticket-tt-id__ul_n1h_htz_54b} デフォルト：すべてのフィールドを返します。 データタイプ：文字列 |
[表 : 8. クエリパラメーター]
{#trouble-ticket-GET-ticket-tt-id__table_cn5_zqm_5pb} {#trouble-ticket-GET-ticket-tt-id__entry__10}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 9. 要求本文パラメーター (JSON)]
### ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#trouble-ticket-GET-ticket-tt-id__entry__14}{#trouble-ticket-GET-ticket-tt-id__accept-JSON-only-entry-RESTAPI}
| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
[表 : 10. 要求ヘッダー]
{#trouble-ticket-GET-ticket-tt-id__entry__18}
| ヘッダー | 説明 |
|-|-|
| なし | |
[表 : 11. 応答ヘッダー]
### ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#trouble-ticket-GET-ticket-tt-id__entry__22}{#trouble-ticket-GET-ticket-tt-id__entry-200-status-code}
| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。次の 1 つ以上の理由で、不適切な要求タイプまたは誤った形式の要求が検出されました。 * 無効なパスパラメーター。 * 無効な URI。 {#trouble-ticket-GET-ticket-tt-id__ul_rjf_fqw_rpb} |
| 404 | レコードが見つかりません。ID に関連付けられたレコードがケース \[sn_customerservice_case\] またはインシデント \[incident\] テーブルに見つかりません。 |
[表 : 12. ステータスコード]
### 応答本文のパラメーター (JSON)
{#trouble-ticket-GET-ticket-tt-id__table_n4d_yvm_5pb__entry__2}
| 名前 | 説明 |
|-|-|
| channel | チケットの作成に使用された連絡方法。 データタイプ：オブジェクト "channel":{ "name": "String" } |
| channel.name | 連絡方法の名前。ケースのチャネル \[contact_type\] フィールドとインシデントの連絡先タイプ \[contact_type\] フィールドにマップされます。 データタイプ：文字列 |
| creationDate | ケースまたはインシデントレコードが作成された日付。\[作成日時\] フィールドにマップされます。 データタイプ：文字列 |
| 説明 | チケットの問題の説明。\[説明\] フィールドにマップされます。 データタイプ：文字列 |
| href | ケースまたはインシデントレコードへの相対リンク。 データタイプ：文字列 |
| id | ケースまたはインシデントレコードの sys_id。 データタイプ：文字列 |
| lastUpdate | レコードが最後に更新された日付。\[更新日時\] フィールドにマップされます。 データタイプ：文字列 |
| name | トラブルチケットの名前 (通常は問題の簡単な説明)。\[簡単な説明\] フィールドにマップされます。 データタイプ：文字列 |
| note | チケットのすべてのコメントのリスト。このリストには作業メモは含まれません。 データタイプ：アレイ "note":[ { "author": "String", "date": "String", "text": "String", "@type": "String" } ] |
| note.@type | メモのタイプ。(作業メモではなく) コメントのみが返されるため、この値は常に `comments` です。 データタイプ：文字列 |
| note.author | コメントを作成したユーザーの名前。 データタイプ：文字列 |
| note.date | ServiceNow インスタンスでコメントが作成された日付。 データタイプ：文字列 |
| note.text | コメントのテキスト。 データタイプ：文字列 |
| relatedEntity | 影響を受ける資産、製品、販売済み製品 (製品インベントリ)、構成アイテム、またはサービスのリスト。 データタイプ：アレイ "relatedEntity": [ { "id": "String", "href": "String", "name": "String", "role": "String", "@referredType": "String", "@type": "String" } ] |
| relatedEntity.id | 影響を受けるアイテムまたはサービスの sys_id。 この値は次のいずれかのテーブルから取得されます。 * 資産 \[alm_asset\] * 製品モデル \[cmdb_model\] * 販売済み製品 \[sn_install_base_sold_product\] * 製品インベントリ \[sn_prd_invt_product_inventory\] は、販売済み製品 \[sn_install_base_sold_product\] テーブルを拡張します。 {#trouble-ticket-GET-ticket-tt-id__ul_en1_3jc_hwb}インシデントの場合、この値は次のいずれかのテーブルから取得されます。 * 構成アイテム (CI) \[cmdb_ci\] * サービス \[cmdb_ci_service\] {#trouble-ticket-GET-ticket-tt-id__ul_fn1_3jc_hwb} データタイプ：文字列 |
| relatedEntity.href | 空の文字列を返します。 データタイプ：文字列 |
| relatedEntity.name | 影響を受けるアイテムまたはサービスの名前。 データタイプ：文字列 |
| relatedEntity.role | 影響を受けるアイテムまたはサービスの説明。 データタイプ：文字列 |
| relatedEntity.@referredType | アイテムまたはサービスのタイプ。 ケースチケットの有効な値： * 資産 * product * product_inventory {#trouble-ticket-GET-ticket-tt-id__ul_zrm_5jp_mtb} インシデントチケットの有効な値： * cmdb_ci * cmdb_ci_service {#trouble-ticket-GET-ticket-tt-id__ul_asm_5jp_mtb} データタイプ：文字列 |
| relatedEntity.@type | この値は常に `relatedEntity` です。 データタイプ：文字列 |
| relatedParty | チケットの連絡先に関する詳細。 データタイプ：アレイ "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String" } ] |
| relatedParty.id | 関係者の sys_id。sys_id は、チケットタイプと関係者タイプに応じて、次のテーブルから取得できます。 ケース： * アカウント \[customer_account\] - 関係者タイプは customer です。 * 連絡先 \[customer_contact\] - 関係者タイプは customer_contact です。 {#trouble-ticket-GET-ticket-tt-id__ul_vf5_n3g_4tb} インシデント： * 会社 \[core_company\] - 関係者タイプは customer です。 * ユーザー \[sys_user\] - 関係者タイプは customer_contact です。 {#trouble-ticket-GET-ticket-tt-id__ul_ll2_p3g_4tb} ケースまたはインシデント： * グループ \[sys_user_group\] - 関係者タイプは assignment_group です。 * ユーザー \[sys_user\] - 関係者タイプは assigned_to です。 {#trouble-ticket-GET-ticket-tt-id__ul_umf_r3g_4tb} データタイプ：文字列 |
| relatedParty.name | 関係者の名前。 データタイプ：文字列 |
| relatedParty.@referredType | 関連するパーティのタイプ。 可能な値： * assigned_to：チケットの作業にアサインされたユーザー。 * assignment_group：チケットの作業にアサインされたグループ。 * customer：チケットの会社またはアカウント。 * customer_contact：チケットの問い合わせユーザーまたは連絡先。 {#trouble-ticket-GET-ticket-tt-id__ul_bxv_jgg_4tb} データタイプ：文字列 |
| severity | トラブルチケットに記載されている問題の重大度。\[優先度\] フィールドにマップされます。 データタイプ：文字列 |
| status | トラブルチケットの現在のステータス。\[ステータス\] フィールドにマップされます。 データタイプ：文字列 |
| ticketType | チケットのタイプ。 可能な値： * ケース * インシデント {#trouble-ticket-GET-ticket-tt-id__ul_czp_2mc_ktb} データタイプ：文字列 |
| @type | この値は常に `TroubleTicket` です。 データタイプ：文字列 |
[ ]
{#trouble-ticket-GET-ticket-tt-id__table_n4d_yvm_5pb}
### cURL 要求
この例では、ケース \[sn_customerservice_case\] テーブルからトラブルチケットレコードを取得します。
curl "https://instance.servicenow.com/api/sn_ind_tsm_sdwan/ticket/troubleTicket/6467508d47e345508761b955d36d43f6" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'
応答本文。
{
"id": "370415f03c20e910f8772f1bc332b31b",
"href": "/api/sn_ind_tsm_sdwan/ticket/troubleTicket/370415f03c20e910f8772f1bc332b31b",
"creationDate": "2023-01-19 22:39:28",
"lastUpdate": "2023-01-19 22:41:39",
"description": "Router is not working, my devices cannot detect any signals from the router. First button from the left is flashing red, all others are black. Resetting the router does not solve the problem, I need urgent assistance.",
"severity": "2 - High",
"ticketType": "Case",
"name": "My router is not working properly",
"status": "Open",
"channel": {
"name": "e_bonding"
},
"relatedParty": [
{
"id": "ffc68911c35420105252716b7d40dd55",
"name": "Funco Intl",
"@referredType": "customer"
},
{
"id": "eaf68911c35420105252716b7d40ddde",
"name": "Sally Thomas",
"@referredType": "customer_contact"
},
{
"id": "",
"name": "",
"@referredType": "assignment_group"
},
{
"id": "",
"name": "",
"@referredType": "assigned_to"
}
],
"relatedEntity": [
{
"id": "b7fa12c7532520103b6bddeeff7b123b",
"href": "",
"name": "Deduplication and Compression PRD00001965",
"role": "This is the product associated with the case.",
"@type": "relatedEntity",
"@referredType": "product"
},
{
"id": "71e73d87c3e23010ff00ed23a140dde8",
"href": "",
"name": "",
"role": "This is the asset associated with the case.",
"@type": "relatedEntity",
"@referredType": "asset"
},
{
"id": "a1913c3577b301108e191e599a5a99e8",
"href": "",
"name": "Deduplication and Compression PI0000037",
"role": "This is the product inventory associated with the case.",
"@type": "relatedEntity",
"@referredType": "product_inventory"
}
],
"note": [
{
"text": "This is a testing comment",
"date": "2023-01-19 14:41:39",
"author": "System Administrator",
"@type": "comments"
},
{
"text": "This is a testing comment",
"date": "2023-01-19 14:39:28",
"author": "System Administrator",
"@type": "comments"
}
],
"@type": "TroubleTicket"
}
## トラブルチケット - GET /sn_ind_tsm_sdwan/troubleticket/{ticketType}/{id} {#ariaid-title4}
指定されたレコードを、ケース \[sn_customerservice_case\] またはインシデント \[incident\] テーブルから取得します。
重要:
Tokyo リリース以降、このエンドポイントは廃止されました。このエンドポイントの新しいバージョンは [トラブルチケット - GET /sn_ind_tsm_sdwan/ticket/troubleTicket/{id}](https://servicenow-prod.fluidtopics.net/rlSWIL1jgyCQDoLDUt9jPg#trouble-ticket-GET-ticket-tt-id "指定されたレコードを、ケース [sn_customerservice_case] またはインシデント [incident] テーブルから取得します。") です。
### URL 形式 {#trouble-ticket-GET-trouble_ticket__section_fcs_wqm_5pb}
デフォルトの URL：/api/sn_ind_tsm_sdwan/troubleticket/{ticketType}/{id}
### サポートされている要求パラメーター
{#trouble-ticket-GET-trouble_ticket__table_ufw_yqm_5pb__entry__2}
| 名前 | 説明 |
|-|-|
| ticketType | チケットのタイプ。この値は、レコードをケース \[sn_customerservice_case\] またはインシデント \[incident\] テーブルから取得するかどうかを決定します。 有効な値： * case * incident {#trouble-ticket-GET-trouble_ticket__ul_k1m_qvs_qpb} データタイプ：文字列 |
| id | 取得するケースまたはインシデントレコードの sys_id。 データタイプ：文字列 |
[表 : 13. パスパラメーター]
{#trouble-ticket-GET-trouble_ticket__table_ufw_yqm_5pb} {#trouble-ticket-GET-trouble_ticket__table_cn5_zqm_5pb__entry__2}
| 名前 | 説明 |
|-|-|
| fields | 応答で返すカンマ区切りのフィールドのリストです。無効なフィールドは無視されます。この値が渡されない場合は、すべてのフィールドが返されます。 有効なフィールド： * channel * creationDate * 説明 * id * lastUpdate * name * note * relatedEntity * relatedParty * severity * status * ticketType * @type {#trouble-ticket-GET-trouble_ticket__ul_n1h_htz_54b} データタイプ：文字列 |
[表 : 14. クエリパラメーター]
{#trouble-ticket-GET-trouble_ticket__table_cn5_zqm_5pb} {#trouble-ticket-GET-trouble_ticket__entry__12}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 15. 要求本文パラメーター (XML または JSON)]
### ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#trouble-ticket-GET-trouble_ticket__entry__16}{#trouble-ticket-GET-trouble_ticket__accept-JSON-only-entry-RESTAPI}
| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
[表 : 16. 要求ヘッダー]
{#trouble-ticket-GET-trouble_ticket__entry__20}
| ヘッダー | 説明 |
|-|-|
| なし | |
[表 : 17. 応答ヘッダー]
### ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#trouble-ticket-GET-trouble_ticket__entry__24}{#trouble-ticket-GET-trouble_ticket__entry-200-status-code}
| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。次の 1 つ以上の理由で、不適切な要求タイプまたは誤った形式の要求が検出されました。 * 無効なパスパラメーター。 * 無効な URI。 {#trouble-ticket-GET-trouble_ticket__ul_rjf_fqw_rpb} |
| 404 | レコードが見つかりません。ID に関連付けられたレコードがケース \[sn_customerservice_case\] またはインシデント \[incident\] テーブルに見つかりません。 |
[表 : 18. ステータスコード]
### 応答本文のパラメーター (JSON または XML)
{#trouble-ticket-GET-trouble_ticket__table_n4d_yvm_5pb__entry__2}
| 名前 | 説明 |
|-|-|
| @type | この値は常に `TroubleTicket` です。 データタイプ：文字列 |
| channel | チケットの作成に使用された連絡方法。 データタイプ：オブジェクト "channel":{ "name": "String" } |
| channel.name | 連絡方法の名前。ケースのチャネル \[contact_type\] フィールドとインシデントの連絡先タイプ \[contact_type\] フィールドにマップされます。 データタイプ：文字列 |
| creationDate | ケースまたはインシデントレコードが作成された日付。\[作成日時\] フィールドにマップされます。 データタイプ：文字列 |
| 説明 | チケットの問題の説明。\[説明\] フィールドにマップされます。 データタイプ：文字列 |
| id | ケースまたはインシデントレコードの sys_id。 データタイプ：文字列 |
| lastUpdate | レコードが最後に更新された日付。\[更新日時\] フィールドにマップされます。 データタイプ：文字列 |
| name | トラブルチケットの名前 (通常は問題の簡単な説明)。\[簡単な説明\] フィールドにマップされます。 データタイプ：文字列 |
| note | チケットのすべてのコメントのリスト。このリストには作業メモは含まれません。 データタイプ：アレイ "note":[ { "author": "String", "date": "String", "text": "String", "@type": "String" } ] |
| note.@type | メモのタイプ。(作業メモではなく) コメントのみが返されるため、この値は常に `comments` です。 データタイプ：文字列 |
| note.author | コメントを作成した POST または PATCH 要求を行った ServiceNow 統合ユーザーの名前。 データタイプ：文字列 |
| note.date | ServiceNow インスタンスでコメントが作成された日付。 データタイプ：文字列 |
| note.text | コメントのテキスト。 データタイプ：文字列 |
| relatedEntity | 影響を受ける資産、製品、販売済み製品 (製品インベントリ)、構成アイテム、またはサービスのリスト。 データタイプ：アレイ "relatedEntity": [ { "id": "String", "href": "String", "name": "String", "role": "String", "@referredType": "String", "@type": "String" } ] |
| relatedEntity.id | 影響を受けるアイテムまたはサービスの sys_id。 この値は次のいずれかのテーブルから取得されます。 * 資産 \[alm_asset\] * 製品モデル \[cmdb_model\] * 販売済み製品 \[sn_install_base_sold_product\] * 製品インベントリ \[sn_prd_invt_product_inventory\] は、販売済み製品 \[sn_install_base_sold_product\] テーブルを拡張します。 {#trouble-ticket-GET-trouble_ticket__ul_en1_3jc_hwb}インシデントの場合、この値は次のいずれかのテーブルから取得されます。 * 構成アイテム (CI) \[cmdb_ci\] * サービス \[cmdb_ci_service\] {#trouble-ticket-GET-trouble_ticket__ul_fn1_3jc_hwb} データタイプ：文字列 |
| relatedEntity.href | 空の文字列を返します。 データタイプ：文字列 |
| relatedEntity.name | 影響を受けるアイテムまたはサービスの名前。 データタイプ：文字列 |
| relatedEntity.role | 影響を受けるアイテムまたはサービスの説明。 データタイプ：文字列 |
| relatedEntity.@referredType | アイテムまたはサービスのタイプ。 ケースチケットの有効な値： * 資産 * product * product_inventory {#trouble-ticket-GET-trouble_ticket__ul_zrm_5jp_mtb} インシデントチケットの有効な値： * cmdb_ci * cmdb_ci_service {#trouble-ticket-GET-trouble_ticket__ul_asm_5jp_mtb} データタイプ：文字列 |
| relatedEntity.@type | この値は常に `relatedEntity` です。 データタイプ：文字列 |
| relatedParty | チケットに関連付けられている会社と連絡先の詳細。 データタイプ：アレイ "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String" } ] |
| relatedParty.@referredType | 関連するパーティのタイプ。 有効な値： * customer：チケットの会社またはアカウント。 * customer_contact：チケットの問い合わせユーザーまたは連絡先。 {#trouble-ticket-GET-trouble_ticket__ul_sfh_g3j_5pb} データタイプ：文字列 |
| relatedParty.id | 関係者の sys_id。ケースの場合、sys_id は、連絡先 \[customer_contact\] またはアカウント \[customer_account\] テーブルからのものです。インシデントの場合、sys_id は、ユーザー \[sys_user\] または会社 \[core_company\] テーブルからのものです。連絡先またはユーザー (問い合わせユーザー) を指定すると、そのアカウントまたは会社が自動的にチケットに入力されます。 データタイプ：文字列 |
| relatedParty.name | 関係者の名前。ケースの場合は、\[連絡先\] または \[アカウント\] フィールドにマップされます。インシデントの場合は、\[問い合わせユーザー\] または \[会社\] フィールドにマップされます。 データタイプ：文字列 |
| severity | トラブルチケットに記載されている問題の重大度。\[優先度\] フィールドにマップされます。 データタイプ：文字列 |
| status | トラブルチケットの現在のステータス。\[ステータス\] フィールドにマップされます。 データタイプ：文字列 |
| ticketType | チケットのタイプ (ケースまたはインシデント)。 データタイプ：文字列 |
[ ]
{#trouble-ticket-GET-trouble_ticket__table_n4d_yvm_5pb}
### cURL 要求
この例では、ケースの名前、説明、重大度、およびステータスを取得します。
curl "https://instance.servicenow.com/api/sn_ind_tsm_sdwan/troubleticket/case/a78e2c8cdb68b41015364c9b0b96193e?fields=name%2Cdescription%2Cseverity%2Cstatus" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'
応答本文。
{
"name": "Short description of issue",
"description": "Example description of an issue",
"severity": "2 - High",
"status": "Open"
}
## トラブルチケット - PATCH /sn_ind_tsm_sdwan/ticket/troubleTicket/{id} {#ariaid-title5}
ケース \[sn_customerservice_case\] またはインシデント \[incident\] テーブル内の指定されたレコードを更新します。
### URL 形式
デフォルトの URL：/api/sn_ind_tsm_sdwan/ticket/troubleTicket/{id}
### サポートされている要求パラメーター
{#trouble-ticket-PATCH-ticket-tt__entry__2}
| 名前 | 説明 |
|-|-|
| id | 更新するケースまたはインシデントレコードの sys_id。ケース \[sn_customerservice_case\] またはインシデント \[incident\] テーブルにあります。 データタイプ：文字列 |
[表 : 19. パスパラメーター]
{#trouble-ticket-PATCH-ticket-tt__entry__6}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 20. クエリパラメーター]
{#trouble-ticket-PATCH-ticket-tt__entry__10}
| 名前 | 説明 |
|-|-|
| channel | チケットの作成に使用された連絡方法。 データタイプ：オブジェクト "channel":{ "name": "String" } |
| channel.name | 連絡方法の名前。ケースのチャネル \[contact_type\] フィールドとインシデントの連絡先タイプ \[contact_type\] フィールドにマップされます。 有効な値は、contact_type フィールドの選択肢です。選択肢ラベルまたは値を指定できます。例： `仮想エージェント`または `virtual_agent`。 データタイプ：文字列 |
| 説明 | 問題の説明。\[説明\] フィールドにマップされます。 データタイプ：文字列 |
| name | トラブルチケットの名前 (通常は問題の簡単な説明)。\[簡単な説明\] フィールドにマップされます。 データタイプ：文字列 |
| note | チケットに追加する作業メモとコメントのリスト。 データタイプ：アレイ "note":[ { "text": "String", "@type": "String" } ] |
| note.@type | メモのタイプ。この値は、メモが \[作業メモ\] フィールドと \[追加コメント\] フィールドのどちらに記録されるかを決定します。 有効な値： * work_notes * comments {#trouble-ticket-PATCH-ticket-tt__ul_vtx_hmz_rpb} データタイプ：文字列 |
| note.text | メモのテキスト。\[作業メモ\] または \[追加コメント\] フィールドにマッピングします。 データタイプ：文字列 |
| relatedEntity | 影響を受ける資産、製品、販売済み製品 (製品インベントリ)、構成アイテム、またはサービスのリスト。 データタイプ：アレイ "relatedEntity": [ { "id": "String", "@referredType": "String" } ] |
| relatedEntity.id | 影響を受けるアイテムまたはサービスの sys_id。 この値は次のいずれかのテーブルから取得されます。 * 資産 \[alm_asset\] * 製品モデル \[cmdb_model\] * 販売済み製品 \[sn_install_base_sold_product\] * 製品インベントリ \[sn_prd_invt_product_inventory\] は、販売済み製品 \[sn_install_base_sold_product\] テーブルを拡張します。 {#trouble-ticket-PATCH-ticket-tt__ul_vl4_13c_hwb}インシデントの場合、この値は次のいずれかのテーブルから取得されます。 * 構成アイテム (CI) \[cmdb_ci\] * サービス \[cmdb_ci_service\] {#trouble-ticket-PATCH-ticket-tt__ul_lbg_b3c_hwb} データタイプ：文字列 |
| relatedEntity.@referredType | アイテムまたはサービスのタイプ。 ケースチケットの有効な値： * 資産 * product * product_inventory {#trouble-ticket-PATCH-ticket-tt__ul_bjm_lfy_wsb} インシデントチケットの有効な値： * cmdb_ci * cmdb_ci_service {#trouble-ticket-PATCH-ticket-tt__ul_sfh_g3j_5pa} データタイプ：文字列 |
| relatedParty | チケットの連絡先に関する詳細。ケースの場合、このパラメーターは、\[連絡先\] または \[アカウント\] フィールドに入力されます。インシデントの場合、このパラメーターは、\[問い合わせユーザー\] または \[会社\] フィールドに入力されます。 データタイプ：アレイ "relatedParty": [ { "id": "String", "@referredType": "String" } ] |
| relatedParty.id | 関係者の sys_id。ケースの場合、sys_id は、連絡先 \[customer_contact\] またはアカウント \[customer_account\] テーブルからのものです。インシデントの場合、sys_id は、ユーザー \[sys_user\] または会社 \[core_company\] テーブルからのものです。連絡先またはユーザー (問い合わせユーザー) を指定すると、そのアカウントまたは会社が自動的にチケットに入力されます。 データタイプ：文字列 |
| relatedParty.@referredType | 関連するパーティのタイプ。 有効な値： * customer：チケットの会社またはアカウント。 * customer_contact：チケットの問い合わせユーザーまたは連絡先。 {#trouble-ticket-PATCH-ticket-tt__ul_sfh_g3j_5pb} データタイプ：文字列 |
| severity | トラブルチケットに記載されている問題の重大度。\[優先度\] フィールドにマップされます。 有効な値： * 1：重大。 * 2：高。 * 3：中。 * 4：低。 * 5 ：計画中。インシデントのみ。 {#trouble-ticket-PATCH-ticket-tt__ul_xhd_24p_rpb}有効な値は、\[優先度\] フィールドの選択肢です。選択値のみを指定する必要があります。例では、`1`。無効な値が指定された場合、重大度は「低」に設定されます。 データタイプ：文字列 |
| status | トラブルチケットの現在のステータス。\[ステータス\] フィールドにマップされます。 有効な値は、\[ステータス\] フィールドの選択肢です。選択肢ラベルまたは値を指定できます。たとえば、「`New`」または「`1`」です。 データタイプ：文字列 |
[表 : 21. 要求本文パラメーター (JSON)]
### ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#trouble-ticket-PATCH-ticket-tt__entry__42}{#trouble-ticket-PATCH-ticket-tt__accept-JSON-only-entry-RESTAPI}{#trouble-ticket-PATCH-ticket-tt__content_type-JSON-only-entry-RESTAPI}
| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
[表 : 22. 要求ヘッダー]
{#trouble-ticket-PATCH-ticket-tt__entry__48}
| ヘッダー | 説明 |
|-|-|
| なし | |
[表 : 23. 応答ヘッダー]
### ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#trouble-ticket-PATCH-ticket-tt__entry__52}{#trouble-ticket-PATCH-ticket-tt__entry-200-status-code}
| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。次の 1 つ以上の理由で、不適切な要求タイプまたは誤った形式の要求が検出されました。 * 無効なパスパラメーター。 * 無効な URI。 {#trouble-ticket-PATCH-ticket-tt__ul_rjf_fqw_rpb} |
| 404 | レコードが見つかりません。ID に関連付けられたレコードがケース \[sn_customerservice_case\] またはインシデント \[incident\] テーブルに見つかりません。 |
[表 : 24. ステータスコード]
### 応答本文のパラメーター (JSON)
{#trouble-ticket-PATCH-ticket-tt__entry__60}
| 名前 | 説明 |
|-|-|
| channel | チケットの作成に使用された連絡方法。 データタイプ：オブジェクト "channel":{ "name": "String" } |
| channel.name | 連絡方法の名前。 データタイプ：文字列 |
| creationDate | レコードが作成された日付。 データタイプ：文字列 |
| 説明 | チケットの問題の説明。 データタイプ：文字列 |
| href | ケースまたはインシデントレコードへの相対リンク。 データタイプ：文字列 |
| id | ケースまたはインシデントレコードの sys_id。 データタイプ：文字列 |
| lastUpdate | レコードが最後に更新された日付。 データタイプ：文字列 |
| name | トラブルチケットの名前 (通常は問題の簡単な説明)。 データタイプ：文字列 |
| note | チケットのすべてのコメントのリスト。このリストには作業メモは含まれません。 データタイプ：アレイ "note":[ { "author": "String", "date": "String", "text": "String", "@type": "String" } ] |
| note.@type | メモのタイプ。(作業メモではなく) コメントのみが返されるため、この値は常に `comments` です。 データタイプ：文字列 |
| note.author | コメントを作成したユーザーの名前。 データタイプ：文字列 |
| note.date | ServiceNow インスタンスでコメントが作成された日付。 データタイプ：文字列 |
| note.text | コメントのテキスト。 データタイプ：文字列 |
| relatedEntity | 影響を受ける資産、製品、販売済み製品 (製品インベントリ)、構成アイテム、またはサービスのリスト。 データタイプ：アレイ "relatedEntity": [ { "id": "String", "href": "String", "name": "String", "role": "String", "@referredType": "String", "@type": "String" } ] |
| relatedEntity.id | 影響を受けるアイテムまたはサービスの sys_id。 この値は次のいずれかのテーブルから取得されます。 * 資産 \[alm_asset\] * 製品モデル \[cmdb_model\] * 販売済み製品 \[sn_install_base_sold_product\] * 製品インベントリ \[sn_prd_invt_product_inventory\] は、販売済み製品 \[sn_install_base_sold_product\] テーブルを拡張します。 {#trouble-ticket-PATCH-ticket-tt__ul_en1_3jc_hwb}インシデントの場合、この値は次のいずれかのテーブルから取得されます。 * 構成アイテム (CI) \[cmdb_ci\] * サービス \[cmdb_ci_service\] {#trouble-ticket-PATCH-ticket-tt__ul_fn1_3jc_hwb} データタイプ：文字列 |
| relatedEntity.href | 空の文字列を返します。 データタイプ：文字列 |
| relatedEntity.name | 影響を受けるアイテムまたはサービスの名前。 データタイプ：文字列 |
| relatedEntity.role | 影響を受けるアイテムまたはサービスの説明。 データタイプ：文字列 |
| relatedEntity.@referredType | アイテムまたはサービスのタイプ。 ケースチケットの有効な値： * 資産 * product * product_inventory {#trouble-ticket-PATCH-ticket-tt__ul_zrm_5jp_mtb} インシデントチケットの有効な値： * cmdb_ci * cmdb_ci_service {#trouble-ticket-PATCH-ticket-tt__ul_asm_5jp_mtb} データタイプ：文字列 |
| relatedEntity.@type | この値は常に `relatedEntity` です。 データタイプ：文字列 |
| relatedParty | チケットの連絡先に関する詳細。 データタイプ：アレイ "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String" } ] |
| relatedParty.id | 関係者の sys_id。sys_id は、チケットタイプと関係者タイプに応じて、次のテーブルから取得できます。 ケース： * アカウント \[customer_account\] - 関係者タイプは customer です。 * 連絡先 \[customer_contact\] - 関係者タイプは customer_contact です。 {#trouble-ticket-PATCH-ticket-tt__ul_vf5_n3g_4tb} インシデント： * 会社 \[core_company\] - 関係者タイプは customer です。 * ユーザー \[sys_user\] - 関係者タイプは customer_contact です。 {#trouble-ticket-PATCH-ticket-tt__ul_ll2_p3g_4tb} ケースまたはインシデント： * グループ \[sys_user_group\] - 関係者タイプは assignment_group です。 * ユーザー \[sys_user\] - 関係者タイプは assigned_to です。 {#trouble-ticket-PATCH-ticket-tt__ul_umf_r3g_4tb} データタイプ：文字列 |
| relatedParty.name | 関係者の名前。 データタイプ：文字列 |
| relatedParty.@referredType | 関連するパーティのタイプ。 可能な値： * assigned_to：チケットの作業にアサインされたユーザー。 * assignment_group：チケットの作業にアサインされたグループ。 * customer：チケットの会社またはアカウント。 * customer_contact：チケットの問い合わせユーザーまたは連絡先。 {#trouble-ticket-PATCH-ticket-tt__ul_bxv_jgg_4tb} データタイプ：文字列 |
| severity | トラブルチケットに記載されている問題の重大度。 データタイプ：文字列 |
| status | トラブルチケットの現在のステータス。 データタイプ：文字列 |
| ticketType | チケットのタイプ。 可能な値： * ケース * インシデント {#trouble-ticket-PATCH-ticket-tt__ul_czp_2mc_ktb} データタイプ：文字列 |
| @type | この値は常に `TroubleTicket` です。 データタイプ：文字列 |
[ ]
### cURL 要求
この例では、ケースレコードを更新します。
curl "https://instance.servicenow.com/api/sn_ind_tsm_sdwan/ticket/troubleTicket/6467508d47e345508761b955d36d43f6" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
description: "Updated description",
"note": [
{
"text": "Adding another comment",
"@type": "comments"
}
]
}" \
--user 'username':'password'
応答本文。
{
"id": "6467508d47e345508761b955d36d43f6",
"href": "/api/sn_ind_tsm_sdwan/ticket/troubleTicket/6467508d47e345508761b955d36d43f6",
"creationDate": "2022-05-16 23:38:55",
"lastUpdate": "2022-05-16 23:48:42",
"description": "Updated description",
"severity": "2 - High",
"ticketType": "Case",
"name": "Laptop problem",
"status": "New",
"channel": {
"name": "web"
},
"relatedParty": [
{
"id": "",
"name": "",
"@referredType": "customer"
},
{
"id": "62826bf03710200044e0bfc8bcbe5df1",
"name": "",
"@referredType": "customer_contact"
},
{
"id": "",
"name": "",
"@referredType": "assignment_group"
},
{
"id": "",
"name": "",
"@referredType": "assigned_to"
}
],
"relatedEntity": [
{
"id": "",
"href": "",
"name": "",
"role": "This is the product associated with the case",
"@type": "relatedEntity",
"@referredType": "product"
},
{
"id": "74a9ec0d3790200044e0bfc8bcbe5d7f",
"href": "",
"name": "P1000597 - Apple MacBook Pro 15\"",
"role": "This is the asset associated with the case",
"@type": "relatedEntity",
"@referredType": "asset"
}
{
"id": "a1913c3577b301108e191e599a5a99e8",
"href": "",
"name": "Deduplication and Compression PI0000037",
"role": "This is the product inventory associated with the case.",
"@type": "relatedEntity",
"@referredType": "product_inventory"
}
],
"note": [
{
"text": "Adding another comment",
"date": "2022-05-16 16:48:42",
"author": "admin",
"@type": "comments"
},
{
"text": "Comment about this case",
"date": "2022-05-16 16:38:55",
"author": "admin",
"@type": "comments"
}
],
"@type": "TroubleTicket"
}
## トラブルチケット - PATCH /sn_ind_tsm_sdwan/troubleticket/{ticketType}/{id} {#ariaid-title6}
ケース \[sn_customerservice_case\] またはインシデント \[incident\] テーブル内のレコードを更新します。
重要:
Tokyo リリース以降、このエンドポイントは廃止されました。このエンドポイントの新しいバージョンは [トラブルチケット - PATCH /sn_ind_tsm_sdwan/ticket/troubleTicket/{id}](https://servicenow-prod.fluidtopics.net/rlSWIL1jgyCQDoLDUt9jPg#trouble-ticket-PATCH-ticket-tt "ケース [sn_customerservice_case] またはインシデント [incident] テーブル内の指定されたレコードを更新します。") です。
### URL 形式
デフォルトの URL：/api/sn_ind_tsm_sdwan/troubleticket/{ticketType}/{id}
### サポートされている要求パラメーター
{#trouble-ticket-PATCH-trouble_ticket__entry__2}
| 名前 | 説明 |
|-|-|
| ticketType | チケットのタイプ。この値は、ケース \[sn_customerservice_case\] またはインシデント \[incident\] テーブルでレコードを更新するかどうかを決定します。 有効な値： * case * incident {#trouble-ticket-PATCH-trouble_ticket__ul_k1m_qvs_qpb} データタイプ：文字列 |
| id | 更新するケースまたはインシデントレコードの sys_id。 データタイプ：文字列 |
[表 : 25. パスパラメーター]
{#trouble-ticket-PATCH-trouble_ticket__entry__8}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 26. クエリパラメーター]
{#trouble-ticket-PATCH-trouble_ticket__entry__12}
| 名前 | 説明 |
|-|-|
| channel | チケットの作成に使用された連絡方法。 データタイプ：オブジェクト "channel":{ "name": "String" } |
| channel.name | 連絡方法の名前。ケースのチャネル \[contact_type\] フィールドとインシデントの連絡先タイプ \[contact_type\] フィールドにマップされます。 有効な値は、contact_type フィールドの選択肢です。選択肢ラベルまたは値を指定できます。例： `仮想エージェント`または `virtual_agent`。 データタイプ：文字列 |
| 説明 | 問題の説明。\[説明\] フィールドにマップされます。 データタイプ：文字列 |
| name | トラブルチケットの名前 (通常は問題の簡単な説明)。\[簡単な説明\] フィールドにマップされます。 データタイプ：文字列 |
| note | チケットに追加する作業メモとコメントのリスト。 データタイプ：アレイ "note":[ { "text": "String", "@type": "String" } ] |
| note.@type | メモのタイプ。この値は、メモが \[作業メモ\] フィールドと \[追加コメント\] フィールドのどちらに記録されるかを決定します。 有効な値： * work_notes * comments {#trouble-ticket-PATCH-trouble_ticket__ul_vtx_hmz_rpb} データタイプ：文字列 |
| note.text | メモのテキスト。\[作業メモ\] または \[追加コメント\] フィールドにマッピングします。 データタイプ：文字列 |
| relatedEntity | 影響を受ける資産、製品、販売済み製品 (製品インベントリ)、構成アイテム、またはサービスのリスト。 データタイプ：アレイ "relatedEntity": [ { "id": "String", "@referredType": "String" } ] |
| relatedEntity.id | 影響を受けるアイテムまたはサービスの sys_id。 この値は次のいずれかのテーブルから取得されます。 * 資産 \[alm_asset\] * 製品モデル \[cmdb_model\] * 販売済み製品 \[sn_install_base_sold_product\] * 製品インベントリ \[sn_prd_invt_product_inventory\] は、販売済み製品 \[sn_install_base_sold_product\] テーブルを拡張します。 {#trouble-ticket-PATCH-trouble_ticket__ul_vl4_13c_hwb}インシデントの場合、この値は次のいずれかのテーブルから取得されます。 * 構成アイテム (CI) \[cmdb_ci\] * サービス \[cmdb_ci_service\] {#trouble-ticket-PATCH-trouble_ticket__ul_lbg_b3c_hwb} データタイプ：文字列 |
| relatedEntity.@referredType | アイテムまたはサービスのタイプ。 ケースチケットの有効な値： * 資産 * product * product_inventory {#trouble-ticket-PATCH-trouble_ticket__ul_bjm_lfy_wsb} インシデントチケットの有効な値： * cmdb_ci * cmdb_ci_service {#trouble-ticket-PATCH-trouble_ticket__ul_sfh_g3j_5pa} データタイプ：文字列 |
| relatedParty | チケットの連絡先に関する詳細。ケースの場合、このパラメーターは、\[連絡先\] または \[アカウント\] フィールドに入力されます。インシデントの場合、このパラメーターは、\[問い合わせユーザー\] または \[会社\] フィールドに入力されます。 データタイプ：アレイ "relatedParty": [ { "id": "String", "@referredType": "String" } ] |
| relatedParty.@referredType | 関連するパーティのタイプ。 有効な値： * customer：チケットの会社またはアカウント。 * customer_contact：チケットの問い合わせユーザーまたは連絡先。 {#trouble-ticket-PATCH-trouble_ticket__ul_sfh_g3j_5pb} データタイプ：文字列 |
| relatedParty.id | 関係者の sys_id。ケースの場合、sys_id は、連絡先 \[customer_contact\] またはアカウント \[customer_account\] テーブルからのものです。インシデントの場合、sys_id は、ユーザー \[sys_user\] または会社 \[core_company\] テーブルからのものです。連絡先またはユーザー (問い合わせユーザー) を指定すると、そのアカウントまたは会社が自動的にチケットに入力されます。 データタイプ：文字列 |
| severity | トラブルチケットに記載されている問題の重大度。\[優先度\] フィールドにマップされます。 有効な値： * 1：重大。 * 2：高。 * 3：中。 * 4：低。 * 5 ：計画中。インシデントのみ。 {#trouble-ticket-PATCH-trouble_ticket__ul_xhd_24p_rpb}有効な値は、\[優先度\] フィールドの選択肢です。選択値のみを指定する必要があります。例では、`1`。無効な値が指定された場合、重大度は「低」に設定されます。 データタイプ：文字列 |
| status | トラブルチケットの現在のステータス。\[ステータス\] フィールドにマップされます。 有効な値は、\[ステータス\] フィールドの選択肢です。選択肢ラベルまたは値を指定できます。たとえば、「`New`」または「`1`」です。 データタイプ：文字列 |
[表 : 27. 要求本文パラメーター (XML または JSON)]
### ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#trouble-ticket-PATCH-trouble_ticket__entry__44}{#trouble-ticket-PATCH-trouble_ticket__accept-JSON-only-entry-RESTAPI}{#trouble-ticket-PATCH-trouble_ticket__content_type-JSON-only-entry-RESTAPI}
| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
[表 : 28. 要求ヘッダー]
{#trouble-ticket-PATCH-trouble_ticket__entry__50}
| ヘッダー | 説明 |
|-|-|
| なし | |
[表 : 29. 応答ヘッダー]
### ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#trouble-ticket-PATCH-trouble_ticket__entry__54}{#trouble-ticket-PATCH-trouble_ticket__entry-200-status-code}
| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。次の 1 つ以上の理由で、不適切な要求タイプまたは誤った形式の要求が検出されました。 * 無効なパスパラメーター。 * 無効な URI。 {#trouble-ticket-PATCH-trouble_ticket__ul_rjf_fqw_rpb} |
| 404 | レコードが見つかりません。ID に関連付けられたレコードがケース \[sn_customerservice_case\] またはインシデント \[incident\] テーブルに見つかりません。 |
[表 : 30. ステータスコード]
### 応答本文のパラメーター (JSON または XML)
{#trouble-ticket-PATCH-trouble_ticket__entry__62}
| 名前 | 説明 |
|-|-|
| @type | この値は常に `TroubleTicket` です。 データタイプ：文字列 |
| channel | チケットの作成に使用された連絡方法。 データタイプ：オブジェクト "channel":{ "name": "String" } |
| channel.name | 連絡方法の名前。 データタイプ：文字列 |
| creationDate | レコードが作成された日付。 データタイプ：文字列 |
| 説明 | チケットの問題の説明。 データタイプ：文字列 |
| id | ケースまたはインシデントレコードの sys_id。 データタイプ：文字列 |
| lastUpdate | レコードが最後に更新された日付。 データタイプ：文字列 |
| name | トラブルチケットの名前 (通常は問題の簡単な説明)。 データタイプ：文字列 |
| note | チケットのすべてのコメントのリスト。このリストには作業メモは含まれません。 データタイプ：アレイ "note":[ { "author": "String", "date": "String", "text": "String", "@type": "String" } ] |
| note.@type | メモのタイプ。(作業メモではなく) コメントのみが返されるため、この値は常に `comments` です。 データタイプ：文字列 |
| note.author | コメントを作成した POST または PATCH 要求を行った ServiceNow 統合ユーザーの名前。 データタイプ：文字列 |
| note.date | ServiceNow インスタンスでコメントが作成された日付。 データタイプ：文字列 |
| note.text | コメントのテキスト。 データタイプ：文字列 |
| relatedEntity | 影響を受ける資産、製品、販売済み製品 (製品インベントリ)、構成アイテム、またはサービスのリスト。 データタイプ：アレイ "relatedEntity": [ { "id": "String", "href": "String", "name": "String", "role": "String", "@referredType": "String", "@type": "String" } ] |
| relatedEntity.id | 影響を受けるアイテムまたはサービスの sys_id。 この値は次のいずれかのテーブルから取得されます。 * 資産 \[alm_asset\] * 製品モデル \[cmdb_model\] * 販売済み製品 \[sn_install_base_sold_product\] * 製品インベントリ \[sn_prd_invt_product_inventory\] は、販売済み製品 \[sn_install_base_sold_product\] テーブルを拡張します。 {#trouble-ticket-PATCH-trouble_ticket__ul_en1_3jc_hwb}インシデントの場合、この値は次のいずれかのテーブルから取得されます。 * 構成アイテム (CI) \[cmdb_ci\] * サービス \[cmdb_ci_service\] {#trouble-ticket-PATCH-trouble_ticket__ul_fn1_3jc_hwb} データタイプ：文字列 |
| relatedEntity.href | 空の文字列を返します。 データタイプ：文字列 |
| relatedEntity.name | 影響を受けるアイテムまたはサービスの名前。 データタイプ：文字列 |
| relatedEntity.role | 影響を受けるアイテムまたはサービスの説明。 データタイプ：文字列 |
| relatedEntity.@referredType | アイテムまたはサービスのタイプ。 ケースチケットの有効な値： * 資産 * product * product_inventory {#trouble-ticket-PATCH-trouble_ticket__ul_zrm_5jp_mtb} インシデントチケットの有効な値： * cmdb_ci * cmdb_ci_service {#trouble-ticket-PATCH-trouble_ticket__ul_asm_5jp_mtb} データタイプ：文字列 |
| relatedEntity.@type | この値は常に `relatedEntity` です。 データタイプ：文字列 |
| relatedParty | チケットに関連付けられている会社と連絡先の詳細。 データタイプ：アレイ "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String" } ] |
| relatedParty.@referredType | 関連するパーティのタイプ。 有効な値： * customer：チケットの会社またはアカウント。 * customer_contact：チケットの問い合わせユーザーまたは連絡先。 {#trouble-ticket-PATCH-trouble_ticket__d4359e333} データタイプ：文字列 |
| relatedParty.id | 関係者の sys_id。ケースの場合、sys_id は、連絡先 \[customer_contact\] またはアカウント \[customer_account\] テーブルからのものです。インシデントの場合、sys_id は、ユーザー \[sys_user\] または会社 \[core_company\] テーブルからのものです。連絡先またはユーザー (問い合わせユーザー) を指定すると、そのアカウントまたは会社が自動的にチケットに入力されます。 データタイプ：文字列 |
| relatedParty.name | 関係者の名前。 データタイプ：文字列 |
| severity | トラブルチケットに記載されている問題の重大度。 データタイプ：文字列 |
| status | トラブルチケットの現在のステータス。 データタイプ：文字列 |
| ticketType | チケットのタイプ (ケースまたはインシデント)。 データタイプ：文字列 |
[ ]
### cURL 要求
この例では、ケースレコードを更新します。
curl "https://instance.servicenow.com/api/sn_ind_tsm_sdwan/troubleticket/case/370415f03c20e910f8772f1bc332b31b" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
\"description\":\"Router is not working, my devices cannot detect any signals from the router. First button from the left is flashing red, all others are black. Resetting the router does not solve the problem, I need urgent assistance.\",
\"name\":\"My router is not working properly\",
\"severity\":\"2\",
\"status\":\"10\",
\"ticketType\":\"Case\",
\"channel\":{
\"id\":\"8774\",
\"name\":\"eBonding\",
\"@type\":\"Channel\"
},
\"note\":[
{
\"id\":\"77456\",
\"author\":\"Jack Smith\",
\"date\":\"2019-05-31T07:34:45.968Z\",
\"text\":\"This is a testing work notehello world and title
\",
\"@type\":\"Worknotes\"
},
{
\"id\":\"77457\",
\"author\":\"Jack Smith\",
\"date\":\"2019-05-31T07:35:45.968Z\",
\"text\":\"This is a testing comment\",
\"@type\":\"Comment\"
}
],
\"relatedParty\":[
{
\"id\":\"eaf68911c35420105252716b7d40ddde\",
\"href\":\"https://mycsp.com:8080/tmf-api/partyManagement/v1/individual/9866\",
\"name\":\"Sally Thomas\",
\"role\":\"customer\",
\"@referredType\":\"customer_contact\"
},
{
\"id\":\"ffc68911c35420105252716b7d40dd55\",
\"href\":\"https://mycsp.com:8080/tmf-api/partyManagement/v4/customer/9176\",
\"name\":\"Funco Intl\",
\"role\":\"customer\",
\"@referredType\":\"customer\"
}
],
\"relatedEntity\": [
{
\"id\": \"b7fa12c7532520103b6bddeeff7b123b\",
\"href\": \"www.google.com\",
\"name\": \"Some random name\",
\"role\": \"I dont know what this is\",
\"@type\": \"relatedEntity\",
\"@referredType\": \"product\"
},
{
\"id\": \"71e73d87c3e23010ff00ed23a140dde8\",
\"href\": \"www.google.com\",
\"name\": \"Some random name\",
\"role\": \"I dont know what this is\",
\"@type\": \"relatedEntity\",
\"@referredType\": \"asset\"
},
{
\"id\": \"a1913c3577b301108e191e599a5a99e8\",
\"href\": \"www.google.com\",
\"name\": \"Some random name\",
\"role\": \"I dont know what this is\",
\"@type\": \"relatedEntity\",
\"@referredType\": \"product_inventory\"
}
]
}" \
--user 'username':'password'
応答本文。
{
"id": "370415f03c20e910f8772f1bc332b31b",
"href": "/api/sn_ind_tsm_sdwan/ticket/troubleTicket/370415f03c20e910f8772f1bc332b31b",
"creationDate": "2023-01-19 22:39:28",
"lastUpdate": "2023-01-19 22:41:39",
"description": "Router is not working, my devices cannot detect any signals from the router. First button from the left is flashing red, all others are black. Resetting the router does not solve the problem, I need urgent assistance.",
"severity": "2 - High",
"ticketType": "Case",
"name": "My router is not working properly",
"status": "Open",
"channel": {
"name": "e_bonding"
},
"relatedParty": [
{
"id": "ffc68911c35420105252716b7d40dd55",
"name": "Funco Intl",
"@referredType": "customer"
},
{
"id": "eaf68911c35420105252716b7d40ddde",
"name": "Sally Thomas",
"@referredType": "customer_contact"
},
{
"id": "",
"name": "",
"@referredType": "assignment_group"
},
{
"id": "",
"name": "",
"@referredType": "assigned_to"
}
],
"relatedEntity": [
{
"id": "b7fa12c7532520103b6bddeeff7b123b",
"href": "",
"name": "Deduplication and Compression PRD00001965",
"role": "This is the product associated with the case.",
"@type": "relatedEntity",
"@referredType": "product"
},
{
"id": "71e73d87c3e23010ff00ed23a140dde8",
"href": "",
"name": "",
"role": "This is the asset associated with the case.",
"@type": "relatedEntity",
"@referredType": "asset"
},
{
"id": "a1913c3577b301108e191e599a5a99e8",
"href": "",
"name": "Deduplication and Compression PI0000037",
"role": "This is the product inventory associated with the case.",
"@type": "relatedEntity",
"@referredType": "product_inventory"
}
],
"note": [
{
"text": "This is a testing comment",
"date": "2023-01-19 14:41:39",
"author": "System Administrator",
"@type": "comments"
},
{
"text": "This is a testing comment",
"date": "2023-01-19 14:39:28",
"author": "System Administrator",
"@type": "comments"
}
],
"@type": "TroubleTicket"
}
## トラブルチケット - POST /sn_ind_tsm_sdwan/ticket/troubleTicket {#ariaid-title7}
ケース \[sn_customerservice_case\] またはインシデント \[incident\] テーブルにレコードを作成します。
### URL 形式
デフォルトの URL：/api/sn_ind_tsm_sdwan/ticket/troubleTicket
### サポートされている要求パラメーター
{#trouble-ticket-POST-ticket-tt__entry__2}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 31. パスパラメーター]
{#trouble-ticket-POST-ticket-tt__entry__6}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 32. クエリパラメータ]
{#trouble-ticket-POST-ticket-tt__entry__10}
| 名前 | 説明 |
|-|-|
| channel | チケットの作成に使用された連絡方法。 データタイプ：オブジェクト "channel":{ "name": "String" } |
| channel.name | 連絡方法の名前。ケースのチャネル \[contact_type\] フィールドとインシデントの連絡先タイプ \[contact_type\] フィールドにマップされます。 有効な値は、contact_type フィールドの選択肢です。選択肢ラベルまたは値を指定できます。例： `仮想エージェント`または `virtual_agent`。 データタイプ：文字列 |
| 説明 | 必須です。問題の説明。\[説明\] フィールドにマップされます。 データタイプ：文字列 |
| name | トラブルチケットの名前 (通常は問題の簡単な説明)。\[簡単な説明\] フィールドにマップされます。 データタイプ：文字列 |
| note | チケットに追加する作業メモとコメントのリスト。 データタイプ：アレイ "note":[ { "text": "String", "@type": "String" } ] |
| note.@type | メモのタイプ。この値は、メモが \[作業メモ\] フィールドと \[追加コメント\] フィールドのどちらに記録されるかを決定します。 有効な値： * work_notes * comments {#trouble-ticket-POST-ticket-tt__ul_vtx_hmz_rpb} データタイプ：文字列 |
| note.text | メモのテキスト。\[作業メモ\] または \[追加コメント\] フィールドにマッピングします。 データタイプ：文字列 |
| relatedEntity | 影響を受ける資産、製品、販売済み製品 (製品インベントリ)、構成アイテム、またはサービスのリスト。 データタイプ：アレイ "relatedEntity": [ { "id": "String", "@referredType": "String" } ] |
| relatedEntity.id | 影響を受けるアイテムまたはサービスの sys_id。 この値は次のいずれかのテーブルから取得されます。 * 資産 \[alm_asset\] * 製品モデル \[cmdb_model\] * 販売済み製品 \[sn_install_base_sold_product\] * 製品インベントリ \[sn_prd_invt_product_inventory\] は、販売済み製品 \[sn_install_base_sold_product\] テーブルを拡張します。 {#trouble-ticket-POST-ticket-tt__ul_vl4_13c_hwb}インシデントの場合、この値は次のいずれかのテーブルから取得されます。 * 構成アイテム (CI) \[cmdb_ci\] * サービス \[cmdb_ci_service\] {#trouble-ticket-POST-ticket-tt__ul_lbg_b3c_hwb} データタイプ：文字列 |
| relatedEntity.@referredType | アイテムまたはサービスのタイプ。 ケースチケットの有効な値： * 資産 * product * product_inventory {#trouble-ticket-POST-ticket-tt__ul_bjm_lfy_wsb} インシデントチケットの有効な値： * cmdb_ci * cmdb_ci_service {#trouble-ticket-POST-ticket-tt__ul_sfh_g3j_5pa} データタイプ：文字列 |
| relatedParty | チケットの連絡先に関する詳細。ケースの場合、このパラメーターは、\[連絡先\] または \[アカウント\] フィールドに入力されます。インシデントの場合、このパラメーターは、\[問い合わせユーザー\] または \[会社\] フィールドに入力されます。 データタイプ：アレイ "relatedParty": [ { "id": "String", "@referredType": "String" } ] |
| relatedParty.id | 関係者の sys_id。ケースの場合、sys_id は、連絡先 \[customer_contact\] またはアカウント \[customer_account\] テーブルからのものです。インシデントの場合、sys_id は、ユーザー \[sys_user\] または会社 \[core_company\] テーブルからのものです。連絡先またはユーザー (問い合わせユーザー) を指定すると、そのアカウントまたは会社が自動的にチケットに入力されます。 データタイプ：文字列 |
| relatedParty.@referredType | 関連するパーティのタイプ。 有効な値： * customer：チケットの会社またはアカウント。 * customer_contact：チケットの問い合わせユーザーまたは連絡先。 {#trouble-ticket-POST-ticket-tt__ul_sfh_g3j_5pb} データタイプ：文字列 |
| severity | 必須です。トラブルチケットに記載されている問題の重大度。\[優先度\] フィールドにマップされます。 有効な値： * 1：重大。 * 2：高。 * 3：中。 * 4：低。 * 5 ：計画中。インシデントのみ。 {#trouble-ticket-POST-ticket-tt__ul_xhd_24p_rpb}有効な値は、\[優先度\] フィールドの選択肢です。選択値のみを指定する必要があります。例では、`1`。無効な値が指定された場合、重大度は「低」に設定されます。 データタイプ：文字列 |
| status | 必須です。トラブルチケットの現在のステータス。\[ステータス\] フィールドにマップされます。 有効な値は、\[ステータス\] フィールドの選択肢です。選択肢ラベルまたは値を指定できます。たとえば、「`New`」または「`1`」です。無効な値を指定すると、ステータスは「New」に設定されます。 データタイプ：文字列 |
| ticketType | チケットのタイプ。この値は、ケース \[sn_customerservice_case\] またはインシデント \[incident\] テーブルにレコードを作成するかどうかを決定します。 有効な値： * ケース * インシデント {#trouble-ticket-POST-ticket-tt__ul_p44_tjp_rpb} データタイプ：文字列 デフォルト：インシデント |
[表 : 33. 要求本文パラメーター (JSON)]
### ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#trouble-ticket-POST-ticket-tt__entry__44}{#trouble-ticket-POST-ticket-tt__accept-JSON-only-entry-RESTAPI}{#trouble-ticket-POST-ticket-tt__content_type-JSON-only-entry-RESTAPI}
| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
[表 : 34. 要求ヘッダー]
{#trouble-ticket-POST-ticket-tt__entry__50}
| ヘッダー | 説明 |
|-|-|
| なし | |
[表 : 35. 応答ヘッダー]
### ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#trouble-ticket-POST-ticket-tt__entry__54}
| ステータスコード | 説明 |
|-|-|
| 201 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。次の理由のうち 1 つ以上で、不適切な要求タイプまたは誤った形式の要求が検出されました。 * 空のペイロード。 * 無効なペイロード。必須フィールドがありません。 * 無効な ticketType。 {#trouble-ticket-POST-ticket-tt__ul_rjf_fqw_rpb} |
[表 : 36. ステータスコード]
### 応答本文のパラメーター (JSON)
{#trouble-ticket-POST-ticket-tt__entry__60}
| 名前 | 説明 |
|-|-|
| @type | この値は常に `TroubleTicket` です。 データタイプ：文字列 |
| channel | チケットの作成に使用された連絡方法。 データタイプ：オブジェクト "channel":{ "name": "String" } |
| channel.name | 連絡方法の名前。 データタイプ：文字列 |
| creationDate | ケースまたはインシデントレコードが作成された日付。 データタイプ：文字列 |
| 説明 | チケットの問題の説明。 データタイプ：文字列 |
| href | ケースまたはインシデントレコードへの相対リンク。 データタイプ：文字列 |
| id | 作成されたケースまたはインシデントレコードの sys_id。 データタイプ：文字列 |
| lastUpdate | ケースまたはインシデントレコードが最後に更新された日付。 データタイプ：文字列 |
| name | トラブルチケットの名前 (通常は問題の簡単な説明)。 データタイプ：文字列 |
| note | チケットのすべてのコメントのリスト。このリストには作業メモは含まれません。 データタイプ：アレイ "note":[ { "author": "String", "date": "String", "text": "String", "@type": "String" } ] |
| note.@type | メモのタイプ。(作業メモではなく) コメントのみが返されるため、この値は常に `comments` です。 データタイプ：文字列 |
| note.author | コメントを作成したユーザーの名前。 データタイプ：文字列 |
| note.date | ServiceNow インスタンスでコメントが作成された日付。 データタイプ：文字列 |
| note.text | コメントのテキスト。 データタイプ：文字列 |
| relatedEntity | 影響を受ける資産、製品、販売済み製品 (製品インベントリ)、構成アイテム、またはサービスのリスト。 データタイプ：アレイ "relatedEntity": [ { "id": "String", "href": "String", "name": "String", "role": "String", "@referredType": "String", "@type": "String" } ] |
| relatedEntity.id | 影響を受けるアイテムまたはサービスの sys_id。 この値は次のいずれかのテーブルから取得されます。 * 資産 \[alm_asset\] * 製品モデル \[cmdb_model\] * 販売済み製品 \[sn_install_base_sold_product\] * 製品インベントリ \[sn_prd_invt_product_inventory\] は、販売済み製品 \[sn_install_base_sold_product\] テーブルを拡張します。 {#trouble-ticket-POST-ticket-tt__ul_en1_3jc_hwb}インシデントの場合、この値は次のいずれかのテーブルから取得されます。 * 構成アイテム (CI) \[cmdb_ci\] * サービス \[cmdb_ci_service\] {#trouble-ticket-POST-ticket-tt__ul_fn1_3jc_hwb} データタイプ：文字列 |
| relatedEntity.href | 空の文字列を返します。 データタイプ：文字列 |
| relatedEntity.name | 影響を受けるアイテムまたはサービスの名前。 データタイプ：文字列 |
| relatedEntity.role | 影響を受けるアイテムまたはサービスの説明。 データタイプ：文字列 |
| relatedEntity.@referredType | アイテムまたはサービスのタイプ。 ケースチケットの有効な値： * 資産 * product * product_inventory {#trouble-ticket-POST-ticket-tt__ul_zrm_5jp_mtb} インシデントチケットの有効な値： * cmdb_ci * cmdb_ci_service {#trouble-ticket-POST-ticket-tt__ul_asm_5jp_mtb} データタイプ：文字列 |
| relatedEntity.@type | この値は常に `relatedEntity` です。 データタイプ：文字列 |
| relatedParty | チケットの連絡先に関する詳細。 データタイプ：アレイ "relatedParty": [ { "id": "String", "name": "String", "@referredType": "String" } ] |
| relatedParty.id | 関係者の sys_id。sys_id は、チケットタイプと関係者タイプに応じて、次のテーブルから取得できます。 ケース： * アカウント \[customer_account\] - 関係者タイプは customer です。 * 連絡先 \[customer_contact\] - 関係者タイプは customer_contact です。 {#trouble-ticket-POST-ticket-tt__ul_vf5_n3g_4tb} インシデント： * 会社 \[core_company\] - 関係者タイプは customer です。 * ユーザー \[sys_user\] - 関係者タイプは customer_contact です。 {#trouble-ticket-POST-ticket-tt__ul_ll2_p3g_4tb} ケースまたはインシデント： * グループ \[sys_user_group\] - 関係者タイプは assignment_group です。 * ユーザー \[sys_user\] - 関係者タイプは assigned_to です。 {#trouble-ticket-POST-ticket-tt__ul_umf_r3g_4tb} データタイプ：文字列 |
| relatedParty.name | 関係者の名前。 データタイプ：文字列 |
| relatedParty.@referredType | 関連するパーティのタイプ。 可能な値： * assigned_to：チケットの作業にアサインされたユーザー。 * assignment_group：チケットの作業にアサインされたグループ。 * customer：チケットの会社またはアカウント。 * customer_contact：チケットの問い合わせユーザーまたは連絡先。 {#trouble-ticket-POST-ticket-tt__ul_bxv_jgg_4tb} データタイプ：文字列 |
| severity | トラブルチケットに記載されている問題の重大度。 データタイプ：文字列 |
| status | トラブルチケットの現在のステータス。 データタイプ：文字列 |
| ticketType | チケットのタイプ。 可能な値： * ケース * インシデント {#trouble-ticket-POST-ticket-tt__ul_czp_2mc_ktb} データタイプ：文字列 |
[ ]
### cURL 要求
この例では、トラブルチケットケースレコードを作成します。
curl "https://instance.servicenow.com/api/sn_ind_tsm_sdwan/ticket/troubleTicket" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
"name": "Laptop problem",
"description": "Laptop keeps shutting off unexpectedly",
"severity": "2",
"status": "New",
"ticketType": "Case",
"channel": {
"name": "Web"
},
"note": [
{
"text": "Work note about this case",
"@type": "work_notes"
},
{
"text": "Comment about this case",
"@type": "comments"
}
],
"relatedEntity": [
{
"id": "74a9ec0d3790200044e0bfc8bcbe5d7f",
"@referredType": "asset"
}
],
"relatedParty": [
{
"id": "62826bf03710200044e0bfc8bcbe5df1",
"@referredType": "customer_contact"
}
]
}" \
--user 'username':'password'
応答本文。
{
"id": "6467508d47e345508761b955d36d43f6",
"href": "/api/sn_ind_tsm_sdwan/ticket/troubleTicket/6467508d47e345508761b955d36d43f6",
"creationDate": "2022-05-16 23:38:55",
"lastUpdate": "2022-05-16 23:38:55",
"description": "Laptop keeps shutting off unexpectedly",
"severity": "2 - High",
"ticketType": "Case",
"name": "Laptop problem",
"status": "New",
"channel": {
"name": "web"
},
"relatedParty": [
{
"id": "",
"name": "",
"@referredType": "customer"
},
{
"id": "62826bf03710200044e0bfc8bcbe5df1",
"name": "",
"@referredType": "customer_contact"
},
{
"id": "",
"name": "",
"@referredType": "assignment_group"
},
{
"id": "",
"name": "",
"@referredType": "assigned_to"
}
],
"relatedEntity": [
{
"id": "",
"href": "",
"name": "",
"role": "This is the product associated with the case.",
"@type": "relatedEntity",
"@referredType": "product"
},
{
"id": "74a9ec0d3790200044e0bfc8bcbe5d7f",
"href": "",
"name": "P1000597 - Apple MacBook Pro 15\"",
"role": "This is the asset associated with the case.",
"@type": "relatedEntity",
"@referredType": "asset"
}
{
"id": "a1913c3577b301108e191e599a5a99e8",
"href": "",
"name": "Deduplication and Compression PI0000037",
"role": "This is the product inventory associated with the case.",
"@type": "relatedEntity",
"@referredType": "product_inventory"
}
],
"note": [
{
"text": "Comment about this case",
"date": "2022-05-16 16:38:55",
"author": "admin",
"@type": "comments"
}
],
"@type": "TroubleTicket"
}
## トラブルチケット - POST /sn_ind_tsm_sdwan/troubleticket/{ticketType} {#ariaid-title8}
ケース \[sn_customerservice_case\] またはインシデント \[incident\] テーブルにレコードを作成します。
重要:
Tokyo リリース以降、このエンドポイントは廃止されました。このエンドポイントの新しいバージョンは [トラブルチケット - POST /sn_ind_tsm_sdwan/ticket/troubleTicket ](https://servicenow-prod.fluidtopics.net/rlSWIL1jgyCQDoLDUt9jPg#trouble-ticket-POST-ticket-tt "ケース [sn_customerservice_case] またはインシデント [incident] テーブルにレコードを作成します。") です。
### URL 形式
デフォルトの URL：/api/sn_ind_tsm_sdwan/troubleticket/{ticketType}
### サポートされている要求パラメーター
{#trouble-ticket-POST-trouble_ticket__entry__2}
| 名前 | 説明 |
|-|-|
| ticketType | チケットのタイプ。この値は、ケース \[sn_customerservice_case\] またはインシデント \[incident\] テーブルにレコードを作成するかどうかを決定します。 有効な値： * case * incident {#trouble-ticket-POST-trouble_ticket__ul_k1m_qvs_qpb} データタイプ：文字列 |
[表 : 37. パスパラメーター]
{#trouble-ticket-POST-trouble_ticket__entry__6}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 38. クエリパラメーター]
{#trouble-ticket-POST-trouble_ticket__entry__10}
| 名前 | 説明 |
|-|-|
| channel | チケットの作成に使用された連絡方法。 データタイプ：オブジェクト "channel":{ "name": "String" } |
| channel.name | 連絡方法の名前。ケースのチャネル \[contact_type\] フィールドとインシデントの連絡先タイプ \[contact_type\] フィールドにマップされます。 有効な値は、contact_type フィールドの選択肢です。選択肢ラベルまたは値を指定できます。例： `仮想エージェント`または `virtual_agent`。 データタイプ：文字列 |
| 説明 | 必須です。問題の説明。\[説明\] フィールドにマップされます。 データタイプ：文字列 |
| name | トラブルチケットの名前 (通常は問題の簡単な説明)。\[簡単な説明\] フィールドにマップされます。 データタイプ：文字列 |
| note | チケットに追加する作業メモとコメントのリスト。 データタイプ：アレイ "note":[ { "text": "String", "@type": "String" } ] |
| note.@type | メモのタイプ。この値は、メモが \[作業メモ\] フィールドと \[追加コメント\] フィールドのどちらに記録されるかを決定します。 有効な値： * work_notes * comments {#trouble-ticket-POST-trouble_ticket__ul_vtx_hmz_rpb} データタイプ：文字列 |
| note.text | メモのテキスト。\[作業メモ\] または \[追加コメント\] フィールドにマッピングします。 データタイプ：文字列 |
| relatedEntity | 影響を受ける資産、製品、販売済み製品 (製品インベントリ)、構成アイテム、またはサービスのリスト。 データタイプ：アレイ "relatedEntity": [ { "id": "String", "@referredType": "String" } ] |
| relatedEntity.id | 影響を受けるアイテムまたはサービスの sys_id。 この値は次のいずれかのテーブルから取得されます。 * 資産 \[alm_asset\] * 製品モデル \[cmdb_model\] * 販売済み製品 \[sn_install_base_sold_product\] * 製品インベントリ \[sn_prd_invt_product_inventory\] は、販売済み製品 \[sn_install_base_sold_product\] テーブルを拡張します。 {#trouble-ticket-POST-trouble_ticket__ul_vl4_13c_hwb}インシデントの場合、この値は次のいずれかのテーブルから取得されます。 * 構成アイテム (CI) \[cmdb_ci\] * サービス \[cmdb_ci_service\] {#trouble-ticket-POST-trouble_ticket__ul_lbg_b3c_hwb} データタイプ：文字列 |
| relatedEntity.@referredType | アイテムまたはサービスのタイプ。 ケースチケットの有効な値： * 資産 * product * product_inventory {#trouble-ticket-POST-trouble_ticket__ul_bjm_lfy_wsb} インシデントチケットの有効な値： * cmdb_ci * cmdb_ci_service {#trouble-ticket-POST-trouble_ticket__ul_sfh_g3j_5pa} データタイプ：文字列 |
| relatedParty | チケットの連絡先に関する詳細。ケースの場合、このパラメーターは、\[連絡先\] または \[アカウント\] フィールドに入力されます。インシデントの場合、このパラメーターは、\[問い合わせユーザー\] または \[会社\] フィールドに入力されます。 データタイプ：アレイ "relatedParty": [ { "id": "String", "@referredType": "String" } ] |
| relatedParty.@referredType | 関連するパーティのタイプ。 有効な値： * customer：チケットの会社またはアカウント。 * customer_contact：チケットの問い合わせユーザーまたは連絡先。 {#trouble-ticket-POST-trouble_ticket__ul_sfh_g3j_5pb} データタイプ：文字列 |
| relatedParty.id | 関係者の sys_id。ケースの場合、sys_id は、連絡先 \[customer_contact\] またはアカウント \[customer_account\] テーブルからのものです。インシデントの場合、sys_id は、ユーザー \[sys_user\] または会社 \[core_company\] テーブルからのものです。連絡先またはユーザー (問い合わせユーザー) を指定すると、そのアカウントまたは会社が自動的にチケットに入力されます。 データタイプ：文字列 |
| severity | 必須です。トラブルチケットに記載されている問題の重大度。\[優先度\] フィールドにマップされます。 有効な値： * 1：重大。 * 2：高。 * 3：中。 * 4：低。 * 5 ：計画中。インシデントのみ。 {#trouble-ticket-POST-trouble_ticket__ul_xhd_24p_rpb}有効な値は、\[優先度\] フィールドの選択肢です。選択値のみを指定する必要があります。例では、`1`。無効な値が指定された場合、重大度は「低」に設定されます。 データタイプ：文字列 |
| status | トラブルチケットの現在のステータス。\[ステータス\] フィールドにマップされます。 有効な値は、\[ステータス\] フィールドの選択肢です。選択肢ラベルまたは値を指定できます。たとえば、「`New`」または「`1`」です。 データタイプ：文字列 デフォルト：New |
| ticketType | 必須です。チケットのタイプ。この値は、ケース \[sn_customerservice_case\] またはインシデント \[incident\] テーブルにレコードを作成するかどうかを決定します。 有効な値： * case * incident {#trouble-ticket-POST-trouble_ticket__ul_p44_tjp_rpb} データタイプ：文字列 |
[表 : 39. 要求本文パラメーター (XML または JSON)]
### ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#trouble-ticket-POST-trouble_ticket__entry__44}{#trouble-ticket-POST-trouble_ticket__accept-JSON-only-entry-RESTAPI}{#trouble-ticket-POST-trouble_ticket__content_type-JSON-only-entry-RESTAPI}
| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
[表 : 40. 要求ヘッダー]
{#trouble-ticket-POST-trouble_ticket__entry__50}
| ヘッダー | 説明 |
|-|-|
| なし | |
[表 : 41. 応答ヘッダー]
### ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#trouble-ticket-POST-trouble_ticket__entry__54}
| ステータスコード | 説明 |
|-|-|
| 201 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。次の理由のうち 1 つ以上で、不適切な要求タイプまたは誤った形式の要求が検出されました。 * 空のペイロード。 * 無効なペイロード。必須フィールドがありません。 * ticketType が無効であるか、または ticketType がパスパラメーター ticketType と一致しません。たとえば、ticketType は `case` ですが、パスパラメーターは `incident` です。 {#trouble-ticket-POST-trouble_ticket__ul_rjf_fqw_rpb} |
[表 : 42. ステータスコード]
### 応答本文のパラメーター (JSON または XML)
{#trouble-ticket-POST-trouble_ticket__entry__60}
| 名前 | 説明 |
|-|-|
| @type | この値は常に `TroubleTicket` です。 データタイプ：文字列 |
| channel | チケットの作成に使用された連絡方法。 データタイプ：オブジェクト "channel":{ "name": "String" } |
| channel.name | 連絡方法の名前。 データタイプ：文字列 |
| creationDate | ケースまたはインシデントレコードが作成された日付。 データタイプ：文字列 |
| 説明 | チケットの問題の説明。 データタイプ：文字列 |
| id | 作成されたケースまたはインシデントレコードの sys_id。 データタイプ：文字列 |
| lastUpdate | ケースまたはインシデントレコードが最後に更新された日付。 データタイプ：文字列 |
| name | トラブルチケットの名前 (通常は問題の簡単な説明)。 データタイプ：文字列 |
| note | POST 要求によってチケットに追加されたコメントと作業メモのリスト。 データタイプ：アレイ "note":[ { "author": "String", "date": "String", "text": "String", "@type": "String" } ] |
| note.@type | メモのタイプ。 有効な値： * work_notes * comments {#trouble-ticket-POST-trouble_ticket__ul_zmv_ybd_5pb} データタイプ：文字列 |
| note.author | メモを作成した POST 要求を行った ServiceNow 統合ユーザーの名前。 データタイプ：文字列 |
| note.date | ServiceNow インスタンスでメモが作成された日付。 データタイプ：文字列 |
| note.text | メモのテキスト。 データタイプ：文字列 |
| relatedEntity | 影響を受ける資産、製品、販売済み製品 (製品インベントリ)、構成アイテム、またはサービスのリスト。 データタイプ：アレイ "relatedEntity": [ { "id": "String", "href": "String", "name": "String", "role": "String", "@referredType": "String", "@type": "String" } ] |
| relatedEntity.id | 影響を受けるアイテムまたはサービスの sys_id。 この値は次のいずれかのテーブルから取得されます。 * 資産 \[alm_asset\] * 製品モデル \[cmdb_model\] * 販売済み製品 \[sn_install_base_sold_product\] * 製品インベントリ \[sn_prd_invt_product_inventory\] は、販売済み製品 \[sn_install_base_sold_product\] テーブルを拡張します。 {#trouble-ticket-POST-trouble_ticket__ul_en1_3jc_hwb}インシデントの場合、この値は次のいずれかのテーブルから取得されます。 * 構成アイテム (CI) \[cmdb_ci\] * サービス \[cmdb_ci_service\] {#trouble-ticket-POST-trouble_ticket__ul_fn1_3jc_hwb} データタイプ：文字列 |
| relatedEntity.href | 空の文字列を返します。 データタイプ：文字列 |
| relatedEntity.name | 影響を受けるアイテムまたはサービスの名前。 データタイプ：文字列 |
| relatedEntity.role | 影響を受けるアイテムまたはサービスの説明。 データタイプ：文字列 |
| relatedEntity.@referredType | アイテムまたはサービスのタイプ。 ケースチケットの有効な値： * 資産 * product * product_inventory {#trouble-ticket-POST-trouble_ticket__ul_zrm_5jp_mtb} インシデントチケットの有効な値： * cmdb_ci * cmdb_ci_service {#trouble-ticket-POST-trouble_ticket__ul_asm_5jp_mtb} データタイプ：文字列 |
| relatedEntity.@type | この値は常に `relatedEntity` です。 データタイプ：文字列 |
| relatedParty | チケットに関連付けられている会社と連絡先の詳細。 データタイプ：アレイ "relatedParty": [ { "id": "String", "@referredType": "String" } ] |
| relatedParty.id | 関係者の sys_id。ケースの場合、sys_id は、連絡先 \[customer_contact\] またはアカウント \[customer_account\] テーブルからのものです。インシデントの場合、sys_id は、ユーザー \[sys_user\] または会社 \[core_company\] テーブルからのものです。連絡先またはユーザー (問い合わせユーザー) を指定すると、そのアカウントまたは会社が自動的にチケットに入力されます。 データタイプ：文字列 |
| relatedParty.referredType | 関連するパーティのタイプ。 有効な値： * customer：チケットの会社またはアカウント。 * customer_contact：チケットの問い合わせユーザーまたは連絡先。 {#trouble-ticket-POST-trouble_ticket__d4359e333} データタイプ：文字列 |
| severity | トラブルチケットに記載されている問題の重大度。 データタイプ：文字列 |
| status | トラブルチケットの現在のステータス。 データタイプ：文字列 |
| ticketType | チケットのタイプ (ケースまたはインシデント)。 データタイプ：文字列 |
[ ]
### cURL 要求
この例では、優先度が高くオープンステータスのケースを作成します。
ccurl "https://instance.servicenow.com/api/sn_ind_tsm_sdwan/troubleticket/case" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
\"description\":\"Router is not working, my devices cannot detect any signals from the router. First button from the left is flashing red, all others are black. Resetting the router does not solve the problem, I need urgent assistance.\",
\"name\":\"My router is not working properly\",
\"severity\":\"2\",
\"status\":\"10\",
\"ticketType\":\"Case\",
\"channel\":{
\"id\":\"8774\",
\"name\":\"eBonding\",
\"@type\":\"Channel\"
},
\"note\":[
{
\"id\":\"77456\",
\"author\":\"Jack Smith\",
\"date\":\"2019-05-31T07:34:45.968Z\",
\"text\":\"This is a testing work notehello world and title
\",
\"@type\":\"Worknotes\"
},
{
\"id\":\"77457\",
\"author\":\"Jack Smith\",
\"date\":\"2019-05-31T07:35:45.968Z\",
\"text\":\"This is a testing comment\",
\"@type\":\"Comment\"
}
],
\"relatedParty\":[
{
\"id\":\"eaf68911c35420105252716b7d40ddde\",
\"href\":\"https://mycsp.com:8080/tmf-api/partyManagement/v1/individual/9866\",
\"name\":\"Sally Thomas\",
\"role\":\"customer\",
\"@referredType\":\"customer_contact\"
},
{
\"id\":\"ffc68911c35420105252716b7d40dd55\",
\"href\":\"https://mycsp.com:8080/tmf-api/partyManagement/v4/customer/9176\",
\"name\":\"Funco Intl\",
\"role\":\"customer\",
\"@referredType\":\"customer\"
}
],
\"relatedEntity\": [
{
\"id\": \"b7fa12c7532520103b6bddeeff7b123b\",
\"href\": \"www.google.com\",
\"name\": \"Some random name\",
\"role\": \"I dont know what this is\",
\"@type\": \"relatedEntity\",
\"@referredType\": \"product\"
},
{
\"id\": \"71e73d87c3e23010ff00ed23a140dde8\",
\"href\": \"www.google.com\",
\"name\": \"Some random name\",
\"role\": \"I dont know what this is\",
\"@type\": \"relatedEntity\",
\"@referredType\": \"asset\"
},
{
\"id\": \"a1913c3577b301108e191e599a5a99e8\",
\"href\": \"www.google.com\",
\"name\": \"Some random name\",
\"role\": \"I dont know what this is\",
\"@type\": \"relatedEntity\",
\"@referredType\": \"product_inventory\"
}
]
}" \
--user 'username':'password'
応答本文。
{
"id": "5bbb5cbc3c2ca910f8772f1bc332b34d",
"href": "/api/sn_ind_tsm_sdwan/ticket/troubleTicket/5bbb5cbc3c2ca910f8772f1bc332b34d",
"creationDate": "2023-01-19 18:33:24",
"lastUpdate": "2023-01-19 18:33:24",
"description": "Router is not working, my devices cannot detect any signals from the router. First button from the left is flashing red, all others are black. Resetting the router does not solve the problem, I need urgent assistance.",
"severity": "2 - High",
"ticketType": "Case",
"name": "My router is not working properly",
"status": "Open",
"channel": {
"name": "e_bonding"
},
"relatedParty": [
{
"id": "ffc68911c35420105252716b7d40dd55",
"name": "Funco Intl",
"@referredType": "customer"
},
{
"id": "eaf68911c35420105252716b7d40ddde",
"name": "Sally Thomas",
"@referredType": "customer_contact"
},
{
"id": "",
"name": "",
"@referredType": "assignment_group"
},
{
"id": "",
"name": "",
"@referredType": "assigned_to"
}
],
"relatedEntity": [
{
"id": "b7fa12c7532520103b6bddeeff7b123b",
"href": "",
"name": "Deduplication and Compression PRD00001965",
"role": "This is the product associated with the case.",
"@type": "relatedEntity",
"@referredType": "product"
},
{
"id": "71e73d87c3e23010ff00ed23a140dde8",
"href": "",
"name": "",
"role": "This is the asset associated with the case.",
"@type": "relatedEntity",
"@referredType": "asset"
},
{
"id": "a1913c3577b301108e191e599a5a99e8",
"href": "",
"name": "Deduplication and Compression PI0000037",
"role": "This is the product inventory associated with the case.",
"@type": "relatedEntity",
"@referredType": "product_inventory"
}
],
"note": [
{
"text": "This is a testing comment",
"date": "2023-01-19 10:33:24",
"author": "System Administrator",
"@type": "comments"
}
],
"@type": "TroubleTicket"
}