ケース API
ケース API は、カスタマーサービス管理 (CSM) ケースレコードの取得と更新を可能にするエンドポイントを提供します。
さらに、ケースの作成時に新しいソーシャルメディアプロファイルレコードを生成できます。
ケース API は Customer Service プラグイン (com.sn_customerservice) を必要とし、sn_customerservice 名前空間内で提供されます。
ユーザーが API にフルアクセスするためには、csm_ws_integration ロールを持っている必要があります。sn_customerservice.customer または sn_customerservice.consumer ロールを持つ外部ユーザーもエンドポイントにアクセスできます。
ケース - GET /sn_customerservice/case/{id}/activities
指定された カスタマーサービス管理 (CSM) ケースのアクティビティストリームを取得します。
このエンドポイントを使用して、ケース [sn_customerservice_case] テーブルの指定されたレコードのアクティビティストリームからすべてのエントリを取得します。
このエンドポイントを使用するには、csm_ws_integration、sn_customerservice.customer、または sn_customerservice.consumer ロールが必要です。
URL 形式
バージョニングされた URL:/api/sn_customerservice/{api_version}/case/{id}/activities
デフォルトの URL:/api/sn_customerservice/case/{id}/activities
サポートされている要求パラメーター
| 名前 | 説明 |
|---|---|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ:文字列 |
| ID | 取得するケースの sys_id またはケース番号。指定されたケース番号が複数のケースで共有されている場合、結果は予測できません。 データタイプ:文字列 テーブル:ケース [sn_customerservice_case] |
| 名前 | 説明 |
|---|---|
| sysparm_activity_type | アクティビティストリームから返すアクティビティのタイプをフィルターします。entries.element パラメーターには、各アクティビティのアクティビティタイプが含まれています。 例:
データタイプ:文字列 デフォルト:すべてのタイプのアクティビティを返します。 |
| sysparm_limit | 返されるレコードの最大数。異常に大きい sysparm_limit 値はシステムパフォーマンスに影響する可能性があります。このレコード数を超える要求の場合は、sysparm_offset パラメーターを使用してレコード取得をページネーションします。 データタイプ:数値 |
| sysparm_offset | レコード取得を開始するレコードのインデックス。この値を使用して、レコード取得をページネーションします。この機能により、レコード数に関係なく、管理しやすい小さなチャンクに分割してすべてのレコードを取得できます。 たとえば、このエンドポイントを初めて呼び出すときに、sysparm_offset は「0」に設定されます。単に利用可能なすべてのレコードをページングするには、すべてのレコードの終わりに達するまで「 データタイプ:数値 デフォルト:0 |
| 名前 | 説明 |
|---|---|
| なし |
ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。
| ヘッダー | 説明 |
|---|---|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ:application/json または application/xml。 デフォルト: application/json |
| ヘッダー | 説明 |
|---|---|
| リンク | REST 応答データは、複数の結果セットに分割できます。応答ヘッダーには、必要に応じて最初のセット、前のセット、次のセット、最後のセットのレコードに対する各種リンクがあります。 例:
|
| X-Total-Count | sysparm_limit または sysparm_offset クエリパラメーターが指定されている場合、要求に一致するレコードの合計数を示す応答ヘッダー。 |
ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。
| ステータスコード | 説明 |
|---|---|
| 200 | 成功。要求が正常に処理されました。 |
| 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 |
| 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 |
| 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 |
応答本文のパラメーター (JSON または XML)
| 名前 | 説明 |
|---|---|
| display_value | CSM ケースのケース番号。 データタイプ:文字列 |
| エントリー | CSM ケースのアクティビティストリームエントリを表すリスト。 データタイプ:オブジェクトのアレイ |
| entries.attachment | アクティビティストリームエントリの CSM ケースに添付されたファイルの説明。 データタイプ:オブジェクト |
| entries.attachment.average_image_color | 画像添付ファイルの平均色の 16 進数表現。 データタイプ:文字列 |
| entries.attachment.content_type | 添付ファイルの MIME タイプ。 例:
データタイプ:文字列 |
| entries.attachment.file_name | 添付ファイルのファイル名。 データタイプ:文字列 |
| entries.attachment.image_height | 画像添付ファイルの高さ (ピクセル)。 データタイプ:数値 |
| entries.attachment.image_path | 画像添付ファイルの直接ダウンロードリンク。 データタイプ:文字列 |
| entries.attachment.image_width | 画像添付ファイルの幅 (ピクセル)。 データタイプ:数値 |
| entries.attachment.path | 添付ファイルへの直接リンク。 データタイプ:文字列 |
| entries.attachment.size | 添付ファイルのサイズ。 例:
データタイプ:文字列 |
| entries.attachment.size_bytes | 添付ファイルのサイズ。 データタイプ:数値 単位:バイト |
| entries.attachment.state | 添付ファイルレコードのステータス。 可能な値:
データタイプ:文字列 テーブル:添付ファイル [sys_attachment] |
| entries.attachment.sys_id | 添付ファイルの sys_id。 データタイプ:文字列 テーブル:添付ファイル [sys_attachment] |
| entries.attachment.thumbnail_path | 画像添付ファイルのサムネイルの直接ダウンロードリンク。 データタイプ:文字列 |
| entries.contains_code | アクティビティストリームエントリにコードが含まれているかどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン |
| entries.element | アクティビティストリームエントリに関連付けられたジャーナルフィールドの名前。 データタイプ:文字列 テーブル: 辞書エントリ [sys_dictionary] |
| entries.field_label | アクティビティストリームエントリに関連付けられたジャーナルフィールドの表示名。 データタイプ:文字列 |
| entries.initials | アクティビティストリームエントリを作成したユーザーのイニシャル。 データタイプ:文字列 |
| entries.login_name | アクティビティストリームエントリを作成したユーザーの完全なユーザー名。 データタイプ:文字列 |
| entries.name | アクティビティストリームエントリを作成したユーザーの完全なユーザー名。 データタイプ:文字列 |
| entries.sys_created_on | アクティビティストリームエントリの作成日時 (GMT タイムゾーン表記)。 データタイプ:文字列 形式:YYYY-MM-DD hh:mm:ss |
| entries.sys_created_on_adjusted | アクティビティストリームエントリの作成日時 (ログインユーザーのタイムゾーン表記)。 データタイプ:文字列 形式:YYYY-MM-DD hh:mm:ss |
| entries.sys_id | アクティビティストリームエントリの sys_id。 データタイプ:文字列 |
| entries.user_sys_id | アクティビティストリームエントリを作成したユーザーの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| entries.value | このジャーナルエントリの値。 データタイプ:文字列 |
| journal_fields | アクティビティエントリーが取得されるケーステーブルに存在するジャーナルフィールドのリスト。 データタイプ:オブジェクトのアレイ |
| journal_fields.can_read | ログインしているユーザーがこのジャーナルフィールドを読み取れるかどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン |
| journal_fields.can_write | ログインしているユーザーがジャーナルフィールドに書き込みできるかどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン |
| journal_fields.color | Now Platform のケースアクティビティストリームのジャーナルフィールドを表す色。 データタイプ:文字列 |
| journal_fields.label | ジャーナルフィールドの名前を表示します。 データタイプ:文字列 |
| journal_fields.name | ジャーナルフィールドの名前。 データタイプ:文字列 テーブル: 辞書エントリ [sys_dictionary] |
| label | CSM ケースレコードが表示されるテーブルのラベルを表示します。 可能な値:ケース データタイプ:文字列 |
| number | CSM ケースのケース番号。 データタイプ:文字列 |
| short_description | CSM ケースの簡単な説明。 データタイプ:文字列 |
| sys_created_on | ケースの作成日時 (GMT タイムゾーン表記)。 データタイプ:文字列 形式:YYYY-MM-DD hh:mm:ss |
| sys_created_on_adjusted | ケースの作成日時 (ログインユーザーのタイムゾーン表記)。 データタイプ:文字列 形式:YYYY-MM-DD hh:mm:ss |
| sys_id | CSM ケースの sys_id。 データタイプ:文字列 テーブル:ケース [sn_customerservice_case] |
| テーブル | CSM ケースが表示されるテーブルの名前。 可能な値:sn_customerservice_case データタイプ:文字列 |
| thumbnail_path | 添付ファイルのサムネイルを取得するための直接リンク (画像タイプの添付ファイルのみ) データタイプ:文字列 |
| user_full_name | ログインしているユーザーのフルネーム。 データタイプ:文字列 |
| user_login | ログインしているユーザーのユーザー ID。 データタイプ:文字列 |
| user_sys_id | ログインしているユーザーの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
cURL 要求
CSM ケースの完全なアクティビティストリームを sys_id で取得します。
curl --request GET 'https://instance.servicenow.com/api/sn_customerservice/case/f352dc9387632300d6b0a7da0acb0b60/activities' \
--request GET \
--header 'Accept: application/json' \
--user 'username':'password'
応答には、指定されたケースの単一のアクティビティストリームエントリ、エージェントによって送信された Additional comments ジャーナルエントリが表示されます。
{
"result": {
"display_value": "CS0001401",
"sys_id": "f352dc9387632300d6b0a7da0acb0b60",
"short_description": "Laptop is not working properly",
"number": "CS0001401",
"entries": [
{
"sys_created_on_adjusted": "2020-05-04 14:15:44",
"sys_id": "600b6e4adb241010d045232d1396196a",
"login_name": "John Jason",
"user_sys_id": "da419c1fc312310015519f2974d3ae15",
"initials": "JJ",
"sys_created_on": "2020-05-04 21:15:44",
"contains_code": "false",
"field_label": "Additional comments",
"name": "John Jason",
"value": "Hi, Alex. Can you please send me a photo of the label on your laptop so we can send you the correct replacement?",
"element": "comments"
}
],
"user_sys_id": "b1e0989f87232300d6b0a7da0acb0beb",
"user_full_name": "Mark Johnson",
"user_login": "admin",
"label": "Case",
"table": "sn_customerservice_case",
"journal_fields": [
{
"can_read": true,
"color": "transparent",
"can_write": true,
"name": "comments",
"label": "Additional comments"
},
{
"can_read": true,
"color": "gold",
"can_write": true,
"name": "work_notes",
"label": "Work notes"
}
],
"sys_created_on": "2019-02-15 21:57:04",
"sys_created_on_adjusted": "2019-02-15 13:57:04"
}
}
ケース - GET /sn_customerservice/case/field_values/{field_name}
ケース [sn_customerservice_case] テーブルの選択肢または参照フィールドの可能なフィールド値のリストを取得します。
このエンドポイントを使用するには、csm_ws_integration、sn_customerservice.customer、または sn_customerservice.consumer ロールが必要です。
このエンドポイントを使用して、ケース作成フォームのフィールド値リストを入力します。
参照フィールドの値を要求すると、辞書エントリ [sys_dictionary] テーブルの要求されたフィールドに対して定義された参照修飾子が適用されます。参照修飾子の詳細については、「 参照修飾子」を参照してください。
sysparm_ref_qual_input クエリパラメーターを使用して、JavaScript 参照修飾子を評価するときに使用するフィールド値を指定できます。例については、以下のクエリパラメーターのリストを参照してください。
別のフィールドに依存する選択フィールドの値を要求する場合は、sysparm_dependent_value クエリパラメーターを使用して依存関係の親フィールドの値を指定し、それに応じて返されるフィールド値を制限できます。依存フィールドの詳細については、「 フィールドに依存する」を参照してください。
URL 形式
バージョニングされた URL:/api/sn_customerservice/{api_version}/case/field_values/{field_name}
デフォルトの URL:/api/sn_customerservice/case/field_values/{field_name}
サポートされている要求パラメーター
| 名前 | 説明 |
|---|---|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ:文字列 |
| field_name | 選択肢または参照フィールドの名前。 データタイプ:文字列 テーブル:ケース [sn_customerservice_case] |
| 名前 | 説明 |
|---|---|
| sysparm_dependent_value | 要求されたフィールドが依存しているケース [sn_customerservice_case] テーブル選択フィールドで選択する値。別のフィールドに依存する選択フィールドを要求する場合にのみ使用します。 例として、デフォルトの Channel 選択フィールドに依存するカスタムチャネルインスタンス選択フィールドをケーステーブルに作成するとします。sysparm_dependent_value が指定されていない場合、このエンドポイントはカスタムフィールドの値の完全なセットを返します。代わりに、Channel フィールドから Phone CSM チャネルが選択されたときに利用可能なカスタムフィールド値のサブセットのみを返すには、次のように指定します。
データタイプ:文字列 |
| sysparm_limit | 返されるレコードの最大数。異常に大きい sysparm_limit 値はシステムパフォーマンスに影響する可能性があります。このレコード数を超える要求の場合は、sysparm_offset パラメーターを使用してレコード取得をページネーションします。 データタイプ:数値 |
| sysparm_offset | レコード取得を開始するレコードのインデックス。この値を使用して、レコード取得をページネーションします。この機能により、レコード数に関係なく、管理しやすい小さなチャンクに分割してすべてのレコードを取得できます。 たとえば、このエンドポイントを初めて呼び出すときに、sysparm_offset は「0」に設定されます。単に利用可能なすべてのレコードをページングするには、すべてのレコードの終わりに達するまで「 データタイプ:数値 デフォルト:0 |
| sysparm_reference_field_columns | 応答で返される、指定した参照フィールドのテーブルからの列名のカンマ区切りリスト。たとえば、指定した参照フィールドが連絡先である場合、連絡先テーブルにあるすべてのフィールドのリストが含まれます。 データタイプ:文字列 |
| sysparm_query | 結果セットのフィルタリングに使用されるエンコードされたクエリ。このパラメーターを使用して定義されたクエリは、参照修飾子によって生成されたエンコードされたクエリに追加されます。 例:
エンコードされたクエリは、 順序 をサポートしています。特定のフィールドに基づいて回答を並べ替えるには、ORDERBY と ORDERBYDESC の句を sysparm_query で使用します。たとえば、 フィールド名が無効というようにクエリの一部が無効であると、インスタンスは無効な部分を無視します。次に、クエリの有効部分のみを使用して行を返します。この動作は glide.invalid_query.returns_no_rows プロパティを使用してコントロールできます。無効なクエリに行を返さないようにするには、このプロパティを true に設定します。 注: glide.invalid_query.returns_no_rows プロパティは、リスト、スクリプト (GlideRecord.query())、Web サービス API など、インスタンスのすべてのクエリの動作を管理します。 データタイプ:文字列 |
| sysparm_ref_qual_input | JavaScript 関数を使用する参照修飾子に渡す、現在のオブジェクトを表すエンコードされたフィールド値のセット。参照フィールドを要求する場合にのみ使用します。 たとえば、 Asset フィールドから値を要求する場合、指定されたケースに関連付けられた製品に属する資産ではなく、指定された製品に属する資産のみを返すようにこのクエリパラメーター値を設定できます。
データタイプ:文字列 構文: |
| 名前 | 説明 |
|---|---|
| なし |
ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。
| ヘッダー | 説明 |
|---|---|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ:application/json または application/xml。 デフォルト: application/json |
| ヘッダー | 説明 |
|---|---|
| リンク | REST 応答データは、複数の結果セットに分割できます。応答ヘッダーには、必要に応じて最初のセット、前のセット、次のセット、最後のセットのレコードに対する各種リンクがあります。 例:
|
ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。
| ステータスコード | 説明 |
|---|---|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 |
| 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 |
応答本文のパラメーター (JSON または XML)
| 名前 | 説明 |
|---|---|
| 結果 | 要求されたフィールドの値のリスト。 データタイプ:オブジェクトのアレイ |
| result.label | フィールド値の表示値。 データタイプ:文字列 |
| result.value | フィールド値。 データタイプ:文字列 |
cURL 要求
すべてのケースから連絡先参照フィールドの値を取得します。
curl 'https://instance.servicenow.com/api/sn_customerservice/case/field_values/contact' \
--request GET \
--header 'Accept: application/json' \
--user 'username':'password'
応答には、一致する連絡先のラベルと値が表示されます。
{
"result": [
{
"label": "Amy Pascal",
"value": "268e22b0d7300200e5982cf65e6103d3"
},
{
"label": "Marta Hoch",
"value": "8c974d254fb81200025ba3618110c707"
},
{
"label": "Charlie Brown",
"value": "078d399dd7600200e5982cf65e6103a2"
},
{
"label": "Alex Linde",
"value": "60beb5e7d7600200e5982cf65e6103ad"
},
{
"label": "Crissy Stark",
"value": "00189b324f1e0200c0adfe618110c76d"
},
{
"label": "Denis Koch",
"value": "07e6fa386f0331003b3c498f5d3ee4a1"
}
]
}
ケース - GET /sn_customerservice/case/{id}/field_values/{field_name}
ケース [sn_customerservice_case] テーブルの指定されたレコードの選択肢または参照フィールドの可能なフィールド値のリストを取得します。
このエンドポイントを使用するには、csm_ws_integration、sn_customerservice.customer、または sn_customerservice.consumer ロールが必要です。
このエンドポイントを使用して、ケース更新フォームのフィールド値リストを入力します。
参照フィールドの値を要求すると、指定されたケースレコードの値を使用して、辞書エントリ [sys_dictionary] テーブルの要求されたフィールドに対して定義された参照修飾子が適用されます。参照修飾子の詳細については、「 参照修飾子」を参照してください。
sysparm_ref_qual_input クエリパラメーターを使用して、JavaScript 参照修飾子を評価するときに指定されたケースからの値より優先される値を指定できます。例については、以下のクエリパラメーターのリストを参照してください。
別のフィールドに依存する選択フィールドの値を要求すると、このエンドポイントは、指定されたケースレコードで選択された依存関係の親フィールド値に基づいて返されるフィールド値を制限します。依存フィールドの詳細については、「 フィールドに依存する」を参照してください。
sysparm_dependent_value クエリパラメーターを使用して、依存関係の親フィールドからの選択を上書きできます。例については、以下のクエリパラメーターのリストを参照してください。
URL 形式
バージョニングされた URL:/api/sn_customerservice/{api_version}/case/{id}/field_values/{field_name}
デフォルトの URL:/api/sn_customerservice/case/{id}/field_values/{field_name}
サポートされている要求パラメーター
| 名前 | 説明 |
|---|---|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ:文字列 |
| field_name | 選択肢または参照フィールドの名前。 データタイプ:文字列 テーブル:ケース [sn_customerservice_case] |
| ID | 参照修飾子を評価するときに使用するレコードのSys_id。 データタイプ:文字列 テーブル:ケース [sn_customerservice_case] |
| 名前 | 説明 |
|---|---|
| sysparm_dependent_value | 要求されたフィールドが依存しているケース [sn_customerservice_case] テーブル選択フィールドで選択する値。別のフィールドに依存する選択フィールドを要求する場合にのみ使用します。 例として、デフォルトの Channel 選択フィールドに依存するカスタムチャネルインスタンス選択フィールドをケーステーブルに作成するとします。sysparm_dependent_value が指定されていない場合、このエンドポイントはカスタムフィールドの値の完全なセットを返します。代わりに、Channel フィールドから Phone CSM チャネルが選択されたときに利用可能なカスタムフィールド値のサブセットのみを返すには、次のように指定します。
データタイプ:文字列 |
| sysparm_limit | 返されるレコードの最大数。異常に大きい sysparm_limit 値はシステムパフォーマンスに影響する可能性があります。このレコード数を超える要求の場合は、sysparm_offset パラメーターを使用してレコード取得をページネーションします。 データタイプ:数値 |
| sysparm_offset | レコード取得を開始するレコードのインデックス。この値を使用して、レコード取得をページネーションします。この機能により、レコード数に関係なく、管理しやすい小さなチャンクに分割してすべてのレコードを取得できます。 たとえば、このエンドポイントを初めて呼び出すときに、sysparm_offset は「0」に設定されます。単に利用可能なすべてのレコードをページングするには、すべてのレコードの終わりに達するまで「 データタイプ:数値 デフォルト:0 |
| sysparm_query | 結果セットのフィルタリングに使用されるエンコードされたクエリ。このパラメーターを使用して定義されたクエリは、参照修飾子によって生成されたエンコードされたクエリに追加されます。 例:
エンコードされたクエリは、 順序 をサポートしています。特定のフィールドに基づいて回答を並べ替えるには、ORDERBY と ORDERBYDESC の句を sysparm_query で使用します。たとえば、 フィールド名が無効というようにクエリの一部が無効であると、インスタンスは無効な部分を無視します。次に、クエリの有効部分のみを使用して行を返します。この動作は glide.invalid_query.returns_no_rows プロパティを使用してコントロールできます。無効なクエリに行を返さないようにするには、このプロパティを true に設定します。 注: glide.invalid_query.returns_no_rows プロパティは、リスト、スクリプト (GlideRecord.query())、Web サービス API など、インスタンスのすべてのクエリの動作を管理します。 データタイプ:文字列 |
| sysparm_reference_field_columns | 応答で返される、指定した参照フィールドのテーブルからの列名のカンマ区切りリスト。たとえば、指定した参照フィールドが連絡先である場合、連絡先テーブルにあるすべてのフィールドのリストが含まれます。 データタイプ:文字列 |
| sysparm_ref_qual_input | JavaScript 関数を使用する参照修飾子に渡す、現在のオブジェクトを表すエンコードされたフィールド値のセット。参照フィールドを要求する場合にのみ使用します。 たとえば、 Asset フィールドから値を要求する場合、指定されたケースに関連付けられた製品に属する資産ではなく、指定された製品に属する資産のみを返すようにこのクエリパラメーター値を設定できます。
データタイプ:文字列 構文: |
| 名前 | 説明 |
|---|---|
| なし |
ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。
| ヘッダー | 説明 |
|---|---|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ:application/json または application/xml。 デフォルト: application/json |
| ヘッダー | 説明 |
|---|---|
| リンク | REST 応答データは、複数の結果セットに分割できます。応答ヘッダーには、必要に応じて最初のセット、前のセット、次のセット、最後のセットのレコードに対する各種リンクがあります。 例:
|
ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。
| ステータスコード | 説明 |
|---|---|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 |
| 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 |
応答本文のパラメーター (JSON または XML)
| 名前 | 説明 |
|---|---|
| 結果 | 要求されたフィールドの値のリスト。 データタイプ:オブジェクトのアレイ |
| result.label | フィールド値の表示値。 データタイプ:文字列 |
| result.value | フィールド値。 データタイプ:文字列 |
cURL 要求
既存のケースの連絡先参照フィールドの値を取得します。
curl 'https://instance.servicenow.com/api/sn_customerservice/case/f352dc9387632300d6b0a7da0acb0b60/field_values/contact' \
--request GET \
--header 'Accept: application/json' \
--user 'username':'password'
応答には、指定されたケースに割り当てられた連絡先のラベルと値が表示されます。
{
"result": [
{
"label": "Alex Linde",
"value": "60beb5e7d7600200e5982cf65e6103ad"
}
]
}
ケース - GET /sn_customerservice/case/{id}
指定された カスタマーサービス管理 (CSM) ケースを取得します。
このエンドポイントを使用するには、csm_ws_integration、sn_customerservice.customer、または sn_customerservice.consumer ロールが必要です。
URL 形式
バージョニングされた URL:/api/sn_customerservice/{api_version}/case/{id}
デフォルトの URL:/api/sn_customerservice/case/{id}
サポートされている要求パラメーター
| 名前 | 説明 |
|---|---|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ:文字列 |
| id | 取得するケースの sys_id またはケース番号。指定されたケース番号が複数のケースで共有されている場合、結果は予測できません。 データタイプ:文字列 テーブル:ケース [sn_customerservice_case] |
| 名前 | 説明 |
|---|---|
| sysparm_display_value | 返されるデータ (データベースからの実際の値またはフィールドの表示値) のタイプを決定します。表示値は、データベース内の実際の値と、ユーザーやシステムの設定と環境設定に基づいて操作されます。 表示値を返す場合、返される値はフィールドタイプに依存します。
データタイプ:文字列 有効な値:
デフォルト値:false 注: このパラメーター設定に推奨方法はありません。ただし、表示値を指定すると、データベースから直接読み取られず、その他のフィールドやレコードを参照することがあるため、パフォーマンスに問題が発生する可能性があります。表示値と実際の値の詳細については、「テーブル API FAQ (KB0534905)」を参照してください。 |
| 名前 | 説明 |
|---|---|
| なし |
ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。
| ヘッダー | 説明 |
|---|---|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ:application/json または application/xml。 デフォルト: application/json |
| ヘッダー | 説明 |
|---|---|
| なし |
ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。
| ステータスコード | 説明 |
|---|---|
| 200 | 成功。要求が正常に処理されました。 |
| 404 | 要求が無効であることを示します。次のいずれかの理由が考えられます。
|
応答本文のパラメーター (JSON または XML)
| 要素 | 説明 |
|---|---|
| account |
ケースに関連付けられたアカウントレコードの sys_id。
データタイプ:文字列 テーブル:アカウント [customer_account] |
| account | アカウントの詳細。 データタイプ:オブジェクト |
| account.account_code | アプリケーションが予算予測と予算計画を識別するために使用する値の一意の組み合わせ。 データタイプ:文字列 最大長:255 |
| account.account_parent | このアカウントの親アカウントの sys_id。アカウント [customer_account] テーブルにあります。 データタイプ:文字列 |
| account.account_path | アカウント階層内の親アカウントから子アカウントへのパス。 データタイプ:文字列 最大長:255 |
| account.active_escalation | アカウントに関連付けられたアクティブなエスカレーションの sys_id。 データタイプ:文字列 テーブル:エスカレーション [sn_customerservice_escalation] |
| account.apple_icon | iPhone ホームページのブックマークのアイコン。 データタイプ:画像 |
| account.banner_image | カスタマーポータルに表示されるバナー画像。 データタイプ:画像 |
| account.banner_image_light | 小さなバナー画像。 データタイプ:画像 |
| account.banner_text | カスタマーポータルに表示されるバナーテキスト。 データタイプ:文字列 最大長:4,000 |
| account.city | このアカウントに関連付けられている会社が所在する市。 データタイプ:文字列 最大長:50 |
| account.contact | このアカウントに関連付けられた連絡先レコードの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| account.country | このアカウントに関連付けられている会社が所在する国。 データタイプ:文字列 最大長:40 デフォルト: USA |
| account.customer | アカウントがパートナーアカウントではなく、顧客アカウントであるかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| account.discount | 購入時にアカウントに付与される割引。 データタイプ:数値 最大長:15 |
| account.fax_phone | このアカウントに関連付けられている会社の主要な FAX 電話番号。 データタイプ:文字列 最大長:40 |
| account.fiscal_year | アカウントに関連付けられている会社の会計年度。 データタイプ:文字列 |
| account.lat_long_error | 緯度および経度情報と比較した実際の場所の差。 データタイプ:文字列 最大長:1,000 |
| account.latitude | このアカウントに関連付けられている会社の緯度。 データタイプ:数値 (浮動小数点) 最大長:40 |
| account.longitude | このアカウントに関連付けられている会社の経度。 データタイプ:数値 (浮動小数点) 最大長:40 |
| account.manufacturer | このアカウントに関連付けられている会社が商品を製造しているかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| account.market_cap | 関連付けられている会社の公開株式の時価。 データタイプ:数値 (通貨) 最大長:20 |
| account.name | このアカウントに関連付けられている会社の名前。 データタイプ:文字列 最大長:80 |
| account.notes | 会社に関する補足情報。 データタイプ:文字列 最大長:4,000 |
| account.num_employees | 会社に雇用されている人数。 データタイプ:数値 (整数) 最大長:40 |
| account.number | このアカウントを識別する番号。 データタイプ:文字列 最大長:40 |
| account.parent | このアカウントの親アカウントの sys_id。 データタイプ:文字列 テーブル:会社 [core_company] |
| account.partner | アカウントがパートナーアカウントか顧客アカウントかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| account.phone | 会社の主要な電話番号。 データタイプ:文字列 |
| account.primary | これがプライマリアカウントであるかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| account.primary_contact | アカウントの主連絡先の sys_id。 データタイプ:文字列 テーブル:連絡先 [customer_contact] |
| account.profits | このアカウントに対して入力された利益情報。 データタイプ:数値 (通貨) 最大長:40 |
| account.publicly_traded | このアカウントに関連付けられている会社の株式が証券取引所で公開されているかどうかを示すフラグ。 可能な値:
データタイプ:ブール |
| account.rank_tier | アカウントのタイプ。 可能な値:
データタイプ:文字列 最大長:40 |
| account.registration_code | 顧客がカスタマーポータルでログインを要求するときに使用する一意のコード。このコードは、アクセス権を付与する前に会社で顧客を検証する方法を提供します。 データタイプ:文字列 最大長:40 |
| account.revenue_per_year | このアカウントに関連付けられている会社が生み出した収益。 データタイプ:数値 (通貨) 最大長:20 |
| account.state | 会社が所在する都道府県。 データタイプ:文字列 最大長:40 |
| account.stock_price | 会社の株価。 データタイプ:文字列 最大長:40 |
| account.stock_symbol | 会社の銘柄記号。 データタイプ:文字列 最大長:40 |
| account.street | 会社の番地 データタイプ:文字列 最大長:255 |
| account.sys_class_name | 関連するアカウントレコードを含むテーブル。 データタイプ:文字列 |
| account.sys_created_by | 最初にアカウントを作成したユーザー。 データタイプ:文字列 最大長:40 |
| account.sys_created_on | アカウントが最初に作成された日時。 データタイプ:文字列 |
| account.sys_id | アカウントレコードの sys_id。 データタイプ:文字列 |
| account.sys_mod_count | アカウント情報が更新された回数。 データタイプ:数値 (整数) |
| account.sys_updated_by | アカウント情報を最後に変更したユーザー。 データタイプ:文字列 最大長:40 |
| account.sys_updated_on | アカウント情報が最後に更新された日時。 データタイプ:文字列 |
| account.theme | このアカウントで使用されるカスタマーポータルテーマの sys_id。 データタイプ:文字列 テーブル:テーマ [sys_ui_theme] |
| account.vendor | このアカウントに関連付けられている会社がベンダーかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| account.vendor_manager | アカウントのベンダーマネージャーの sys_id のリスト。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| account.vendor_type | アプリケーション、ハードウェア、サービス、ソフトウェアなどのベンダーのタイプの sys_id のリスト。 データタイプ:文字列 テーブル:ベンダータイプ [vendor_type] |
| account.website | 会社の Web サイトの URL。 データタイプ:文字列 最大長:1,024 |
| account.zip | 会社の郵便番号。 データタイプ:文字列 最大長:40 |
| アクティブ | ケースがオープンかアクティブかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト:true |
| active_account_escalation | ケースに関連付けられたアクティブなアカウントエスカレーションの sys_id。 データタイプ:文字列 テーブル:エスカレーション [sn_customerservice_escalation] |
| active_escalation | ケースに関連付けられたアクティブなエスカレーションレコードのSys_id。 データタイプ:文字列 テーブル:エスカレーション [sn_customerservice_escalation] |
| activity_due | 関連付けられたケースの完了予定日。 データタイプ:文字列 |
| additional_assignee_list | アカウントにアサインされた追加のユーザー (プライマリアサイニーを除く) のsys_idsのリスト。 データタイプ:アレイ 最大:4,000 テーブル:ユーザー [sys_user] |
| approval | 必要な承認のタイプを説明する文字列。 可能な値:
データタイプ:文字列 最大文字数:40 デフォルト:not requested |
| approval_history | ケースに関連付けられているすべての承認のリスト。 データタイプ:文字列 最大文字数:4,000 |
| approval_set | 関連するアクションが承認された日時。 データタイプ:文字列 |
| 資産 | ケースに関連付けられた資産レコードの sys_id。 データタイプ:文字列 テーブル:資産 [alm_asset] |
| assigned_to |
ケースにアサインされたユーザーの sys_id。
テーブル:ユーザー [sys_user] データタイプ:文字列 |
| assignment_group | ケースにアサインされたカスタマーサービスエージェントグループの sys_id。 データタイプ:文字列 テーブル: Group [sys_user_group] |
| business_duration | ケースの完了までにかかったカレンダー上の作業時間、作業日数、および作業週数。 データタイプ:文字列 |
| business_impact | 関連する顧客に対する問題の影響。 データタイプ:文字列 最大文字数:4,000 |
| business_service | ケースに関連付けられたサービスレコードの sys_id。 データタイプ:文字列 テーブル:サービス [cmdb_ci_service] |
| case | ケースの簡単な説明とケース番号。 データタイプ:文字列 最大長:300 |
| case_report | 関連するケースレポートの sys_id。 データタイプ:文字列 テーブル:ケースレポート [sn_customerservice_case_report] |
| category | ケースカテゴリ。 可能な値:
データタイプ:数値 (整数) デフォルト値:1 |
| cause | 問題の原因に関する詳細。 データタイプ:文字列 最大長:4,000 |
| caused_by | ケースが作成される原因となった変更要求の sys_id。 データタイプ:文字列 テーブル:変更要求 [change_request] |
| 変更 | ケースが作成される原因となった変更要求の sys_id。 データタイプ:文字列 テーブル:変更要求 [change_request] |
| child_case_creation_progress | ケースが重大なケースから作成された子ケースであるかどうかを示すフラグ。 可能な値:
データタイプ:ブール |
| closed_at | ケースがクローズされた日時。 データタイプ:文字列 |
| closed_by | ケースをクローズしたユーザーの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| close_notes | ケースがクローズされたときに作成されたメモ。 データタイプ:文字列 最大長:4,000 |
| cmdb_ci | ケースに関連付けられた構成アイテムの sys_id。 データタイプ:文字列 テーブル:構成アイテム [cmdb_ci] |
| コメント | ケースに関する追加のコメント。 データタイプ:文字列 最大長:4,000 |
| comments_and_work_notes | ケースに対して入力されたコメントと作業メモ。 データタイプ:文字列 最大長:4,000 |
| company | ケースに関連付けられた会社の sys_id。 データタイプ:文字列 テーブル:会社 [core_company] |
| consumer | 企業/消費者間ケースのみ。このケースに関して連絡先となる人のSys_id。 データタイプ:文字列 テーブル:コンシューマー [csm_consumer] |
| consumer | 企業/消費者間ケースのパラメーターのアレイ。 |
| consumer.active | コンシューマーがアクティブかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト:true |
| consumer.business_phone | コンシューマーの勤務先電話番号。 データタイプ:文字列 最大長:40 |
| consumer.city | コンシューマーが居住する市区町村。 データタイプ:文字列 最大長:100 |
| consumer.country | コンシューマーが居住する国。 データタイプ:文字列 最大長:40 |
| consumer.date_format | 日付を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム日付形式) |
| consumer.email | コンシューマーのメールアドレス。 データタイプ:文字列 最大長:100 |
| consumer.fax | コンシューマーのファックス番号。 データタイプ:文字列 最大長:40 |
| consumer.first_name | コンシューマーの名。 データタイプ:文字列 最大長:50 |
| consumer.gender | コンシューマーの性別。 データタイプ:文字列 最大長:40 |
| consumer.home_phone | コンシューマーの自宅電話番号。 データタイプ:文字列 最大長:40 |
| consumer.household | 世帯の特性を説明するレコードの sys_id。 データタイプ:文字列 テーブル:世帯 [csm_household] |
| consumer.last_name | コンシューマーの姓。 データタイプ:文字列 最大長:50 |
| consumer.middle_name | コンシューマーのミドルネーム。 データタイプ:文字列 最大長:50 |
| consumer.mobile_phone | コンシューマーの携帯電話番号。 データタイプ:文字列 最大長:40 |
| consumer.name | コンシューマーのフルネーム。 first_name+middle_name+last_name。 データタイプ:文字列 最大長:152 |
| consumer.notes | コンシューマーに関するメモ。 データタイプ:文字列 最大長:4,000 |
| consumer.notification | コンシューマーが通知を受信するかどうかを示します。 有効な値:
データタイプ:数値 (整数) 最大長:40 デフォルト値:2 |
| consumer.number | コンシューマーに関連付けられた一意の番号。 データタイプ:文字列 最大長:40 |
| consumer.photo | コンシューマーの写真。 データタイプ:画像 |
| consumer.preferred_language | コンシューマーのプライマリ言語。 データタイプ:文字列 最大長:3 |
| consumer.prefix | Dr.、Mr.、Mrs.、Ms. などのコンシューマー名のプリフィックス データタイプ:文字列 最大長:40 |
| consumer.primary | これがプライマリコンシューマーであるかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| consumer.state | コンシューマーが居住する都道府県。 データタイプ:文字列 最大長:100 |
| consumer.street | コンシューマーの番地。 データタイプ:文字列 最大長:255 |
| consumer.suffix | Jr.、Sr.、II などのコンシューマー名のサフィックス。 データタイプ:文字列 |
| consumer.sys_created_by | コンシューマーレコードを作成したユーザー。 データタイプ:文字列 最大長:40 |
| consumer.sys_created_on | コンシューマーレコードが最初に作成された日時。 データタイプ:文字列 |
| consumer.sys_domain | コンシューマー情報が存在する ServiceNow ドメイン。 データタイプ:文字列 |
| consumer.sys_id | コンシューマーの一意の識別子。 データタイプ:文字列 |
| consumer.sys_mod_count | 関連するコンシューマー情報が変更された回数。 データタイプ:数値 (整数) |
| consumer.sys_updated_by | コンシューマー情報を最後に更新したユーザー。 データタイプ:文字列 最大長:40 |
| consumer.sys_updated_on | コンシューマー情報が最後に更新された日時。 データタイプ:文字列 |
| consumer.time_format | 時間を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム時間形式) |
| consumer.time_zone | コンシューマーのタイムゾーン (カナダ/中央または米国/東部)。 データタイプ:文字列 最大長:40 |
| consumer.title | マネージャー、ソフトウェア開発者、請負業者などのコンシューマーのビジネスタイトル。 データタイプ:文字列 最大長:60 |
| consumer.user | コンシューマーユーザーの sys_id。 データタイプ:文字列 テーブル:コンシューマーユーザー [csm_consumer_user] |
| consumer.zip | コンシューマーの郵便番号。 データタイプ:文字列 最大長:40 |
| 連絡先 | 企業間ベースのケースのみ。このケースに関する連絡担当者の sys_id。 データタイプ:文字列 テーブル:連絡先 [customer_contact] |
| contact | 企業/企業間ケースの連絡先パラメーターのアレイ。 |
| contact.account | 連絡先が関連付けられているアカウントレコードのSys_id。 データタイプ:文字列 テーブル:アカウント [customer_account] |
| contact.active | システム内で連絡先がアクティブかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト:true |
| contact.agent_status | エージェントのステータス。 可能な値:
データタイプ:文字列 最大長:40 |
| contact.building | 連絡先が所在する建物を説明するレコードのSys_id。 データタイプ:文字列 テーブル:建物 [cmn_building] |
| contact.calendar_integration | 連絡先が使用するカレンダーアプリケーション。 1:Outlook データタイプ:数値 (整数) デフォルト値:1 |
| contact.city | 連絡先が居住する市区町村。 データタイプ:文字列 最大長:40 |
| contact.company | 連絡先が関連付けられている会社レコードのSys_id。 データタイプ:文字列 テーブル:会社 [core_company] |
| contact.cost_center | 連絡先に関連付けられたコストセンターのSys_id。 データタイプ:文字列 テーブル:コストセンター [cmn_cost_center] |
| contact.country | 連絡先が居住する国の国コード。 データタイプ:文字列 最大長:3 |
| contact.date_format | 連絡先に日付を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム日付形式) |
| contact.default_perspective | 連絡先のデフォルトの視点の sys_id。 データタイプ:文字列 テーブル:メニューリスト [sys_perspective] |
| contact.department | 連絡先に関連付けられた部門の sys_id。 データタイプ:文字列 テーブル:部門 [cmn_department] |
| contact.edu_status | 関連付けられた連絡先の学歴ステータス。 データタイプ:文字列 最大長:40 デフォルト:faculty |
| contact.email | 連絡先のメールアドレス。 データタイプ:文字列 |
| contact.employee_number | 連絡先の従業員番号。 データタイプ:文字列 |
| contact.enable_multifactor_authn | 連絡先がサービスポータルにログインするためにマルチファクター認証が必要かどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| contact.failed_attempts | 失敗したログイン試行回数。 データタイプ:数値 (整数) |
| contact.first_name | 連絡先の名。 データタイプ:文字列 最大長:50 |
| contact.gender | 連絡先の性別。 データタイプ:文字列 最大長:40 |
| contact.geolocation_tracked | 連絡先の場所が位置情報追跡によって取得されたかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| contact.home_phone | 連絡先の自宅電話番号。 データタイプ:文字列 最大長:40 |
| contact.internal_integration_user | 連絡先が内部統合ユーザーかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| contact.introduction | 前書き データタイプ:文字列 最大長:40 |
| contact.last_login | 連絡先が最後にシステムにログインした日付。 データタイプ:文字列 (日付) |
| contact.last_login_device | コンシューマーが最後にシステムにログインしたときに使用したデバイス。 データタイプ:文字列 最大長:40 |
| contact.last_login_time | 連絡先がシステムにログインした日時。 データタイプ:文字列 (日付/時間) |
| contact.last_name | 連絡先の姓。 データタイプ:文字列 最大長:50 |
| contact.last_position_update | 位置が最後に更新された日時。 データタイプ:文字列 (日付/時間) |
| contact.latitude | 連絡先の緯度座標。 データタイプ:数値 (浮動小数点) 最大長:40 |
| contact.ldap_server | 連絡先がシステムへの最終ログインに使用する LDAP サーバーのSys_id。 データタイプ:文字列 テーブル:LDAP サーバー [ldap_server_config] |
| contact.location | 連絡先の場所を説明するレコードのSys_id データタイプ:文字列 テーブル:場所 [cmn_location] |
| contact.locked_out | 連絡先がロックアウトされているかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| contact.longitude | 連絡先の経度座標。 データタイプ:数値 (浮動小数点) 最大長:40 |
| contact.manager | 連絡先の直属の上司を説明するレコードのSys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| contact.middle_name | 連絡先のミドルネーム。 データタイプ:数値 (浮動小数点) 最大長:50 |
| contact.mobile_phone | 連絡先の携帯電話番号。 データタイプ:文字列 最大長:40 |
| contact.name | 連絡先のフルネーム。 データタイプ:文字列 最大長:151 |
| contact.notification | 連絡先が通知を受信するかどうかを示します。 有効な値:
データタイプ:数値 (整数) デフォルト値:2 |
| contact.on_schedule | ディスパッチされたサービス担当者の適時性を示します。 有効な値:
データタイプ:文字列 最大長:40 |
| contact.phone | 連絡先の勤務先電話番号。 データタイプ:文字列 最大長:40 |
| contact.photo | 連絡先の写真画像。 データタイプ:文字列 |
| contact.preferred_language | 連絡先のプライマリ言語の国コード。 データタイプ:文字列 最大長:3 |
| contact.roles | 連絡先に関連付けられているユーザーロールのリスト。 データタイプ:文字列 最大長:40 |
| contact.schedule | 関連付けられた連絡先の作業スケジュールを説明するレコードのSys_id。 データタイプ:文字列 テーブル:スケジュール [cmn_schedule] |
| contact.source | 連絡先のソース。 データタイプ:文字列 最大長:255 |
| contact.state | 連絡先が居住する都道府県。 データタイプ:文字列 最大長:40 |
| contact.street | 連絡先の番地。 データタイプ:文字列 最大長:255 |
| contact.sys_class_name | 連絡先レコードを含むテーブル。 データタイプ:文字列 最大長:80 |
| contact.sys_created_by | 関連付けられた連絡先レコードを最初に作成したユーザー。 データタイプ:文字列 最大長:40 |
| contact.sys_created_on | 関連付けられた連絡先が最初に作成された日時。 データタイプ:文字列 (日付/時間) |
| contact.sys_domain | 関連付けられた連絡先レコードの ServiceNow インスタンスドメイン。 データタイプ:文字列 |
| contact.sys_domain_path | 連絡先レコードのドメインパス。 データタイプ:文字列 最大長:255 デフォルト:/ (global) |
| contact.sys_id | 関連付けられた連絡先レコードの一意の識別子。 データタイプ:文字列 |
| contact.sys_mod_count | 関連付けられた連絡先レコードが変更された回数。 データタイプ:数値 (整数) |
| contact.sys_tags | コンテンツのシステムタグ。 データタイプ:文字列 |
| contact.sys_updated_by | 関連付けられた連絡先情報を最後に更新したユーザー。 データタイプ:文字列 最大長:40 |
| contact.sys_updated_on | 関連付けられた連絡先情報が更新された日時。 データタイプ:文字列 (日付/時間) |
| contact.time_format | 時間を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム時間形式) |
| contact.time_sheet_policy | 関連付けられた連絡先のタイムシートポリシーを含むレコードのSys_id。 データタイプ:文字列 テーブル:タイムシートポリシー [time_sheet_policy] |
| contact.time_zone | 連絡先が居住するタイムゾーン (カナダ/中央または米国/東部)。 データタイプ:文字列 最大長:40 |
| contact.title | マネージャー、ソフトウェア開発者、請負業者などの連絡先のビジネスタイトル。 データタイプ:文字列 最大長:60 |
| contact.user_name | 連絡先のユーザー ID。 データタイプ:文字列 最大長:40 |
| contact.vip | 関連付けられた連絡先が VIP ステータスかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| contact.web_service_access_only | 連絡先が Web 経由でのみサービスにアクセスできるかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| contact.zip | 連絡先の郵便番号。 データタイプ:文字列 最大長:40 |
| contact_local_time | 連絡先の現地時間。 データタイプ:文字列 最大長:70 |
| contact_time_zone | ケースに関連付けられた連絡先のタイムゾーン。 データタイプ:文字列 最大長:40 |
| contact_type | ケースが最初にレポートされた方法。 可能な値:
データタイプ:文字列 最大長:40 |
| contract | ケースに関連付けられた契約の sys_id。この契約には、ケースに関連付けられた会社に提供されるサポートのタイプに関する情報が含まれています。契約には会社と連絡先、および対象となる特定の資産が含まれる場合があります。1 つの契約に、複数のサービスエンタイトルメントと SLA を含めることもできます。 データタイプ:文字列 テーブル:契約 [ast_contract] |
| correlation_display | 相関ディスプレイ。 データタイプ:文字列 最大長:100 |
| correlation_id | 相関識別子。 データタイプ:文字列 最大長:100 |
| delivery_plan | このケースの親実行計画の sys_id。 データタイプ:文字列 テーブル:実行計画 [sc_cat_item_delivery_plan] |
| delivery_task | 実行計画タスクの sys_id。 データタイプ:文字列 テーブル:実行計画タスク [sc_cat_item_delivery_task] |
| 説明 | ケースに関連する問題の詳細な説明。 データタイプ:文字列 最大長:4,000 |
| due_date | ケースのクローズ予定日。 データタイプ:文字列 |
| エンタイトルメント | ケースに関連付けられたエンタイトルメントレコードの sys_id。エンタイトルメントによって、顧客が受けるサポートのタイプやサポートされるコミュニケーションチャネルが定義されます。エンタイトルメントは、製品、資産、アカウント、契約に関連付けることができます。 データタイプ:文字列 テーブル:エンタイトルメント [service_entitlement] |
| escalation | 現在のエスカレーションレベル。 可能な値:
データタイプ:数値 (整数) デフォルト:0 |
| expected_start | ケースの作業開始予定日時。 データタイプ:文字列 |
| first_response_time | ケースに対して最初のアクションが実行された日時。 データタイプ:文字列 |
| follow_the_sun | ケースをグローバルフォローアップに渡す必要があるかどうかを示すフラグ。 顧客が [優先度 1:重大] または [優先度 2 - 高] のケースにさらにコメントを入力した場合、またはケースが昇格された場合は、このフラグが自動的に true に設定されます。 可能な値:
データタイプ:ブーリアン デフォルト値:false |
| follow_up | 次のフォローアップアクションの日時。 データタイプ:文字列 |
| group_list | ケースに関連付けられたグループレコードの sys_id のリスト。 データタイプ:アレイ テーブル: Group [sys_user_group] |
| 影響 | 顧客への影響。 可能な値:
データタイプ:数値 (整数) デフォルト値:3 |
| ナレッジ | 指定された問題に利用可能なナレッジベース記事があるかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| location | 会社の場所を説明するレコードの sys_id。 データタイプ:文字列 テーブル:場所 [cmn_location] |
| made_sla | ケースが関連するサービスレベルアグリーメントに従って解決されたかどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン デフォルト:true |
| major_case_state | 重大なケースの現在のステータス。 可能な値:
データタイプ:文字列 最大長:40 |
| needs_attention | ケースに注意が必要かどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン デフォルト値:false |
| notes_to_comments | 解決メモをコメントに追加するかどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン |
| notify | 連絡先/コンシューマーに通知するために使用する方法。 可能な値:
データタイプ:数値 (整数) デフォルト値:1 |
| number | ケース番号。 データタイプ:文字列 最大長:40 |
| open_at | ケースがオープンされた日時。 データタイプ:文字列 |
| opened_by | ケースを最初にオープンしたユーザーの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| 順序 | ケースの順序。 データタイプ:数値 (整数) |
| parent | このケース (子) が関連付けられている親ケースの sys_id。 データタイプ:文字列 テーブル:タスク [task] |
| partner | ケースに関連付けられたパートナーの sys_id。 データタイプ:文字列 テーブル:アカウント [customer_account] |
| partner_contact | ケースに関連付けられたパートナーの連絡先の sys_id。 データタイプ:文字列 テーブル:連絡先 [customer_contact] |
| priority | ケースの優先度。 可能な値:
データタイプ:数値 (整数) デフォルト:4 |
| probable_cause | ケースに関連する問題の考えられる原因。 データタイプ:文字列 最大長:4,000 |
| 問題 | 顧客に発生している問題の sys_id。 データタイプ:文字列 テーブル:問題 [problem] |
| 製品 | ケースに関連付けられた資産の製品モデルの sys_id。モデルとは、「Apple Mac Book Pro」など、資産の特定のバージョンや構成のことです。 データタイプ:文字列 テーブル:製品モデル [cmdb_model] |
| reassignment_count | ケースを進行させる担当者にケースが再アサインされた回数。 データタイプ:数値 (整数) デフォルト:0 |
| recipient_list | このケースに関するコミュニケーションの受信者のリストを含むレコードの sys_id。 データタイプ:文字列 テーブル:受信者リスト [sn_publications_recipients_list] |
| rejection_goto | ケースが却下された場合に実行するタスクの sys_id。 データタイプ:文字列 テーブル:タスク [task] |
| resolution_code | ケースの解決ステータス (「Solved - サポートによって解決/ガイダンスの提供」など)。 データタイプ:文字列 最大長:40 |
| resolved_at | ケースが解決された日時。 データタイプ:文字列 |
| resolved_by | ケースを解決したユーザーの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| 結果 | 要求されたフィールドの値のリスト。 データタイプ:オブジェクトのアレイ |
| result.label | フィールド値の表示値。 データタイプ:文字列 |
| result.value | フィールド値。 データタイプ:文字列 |
| short_description | ケースの簡潔な説明。 データタイプ:文字列 最大長:160 |
| skills | ケースを完了するために必要なスキルの一意の識別子 (sys_id) のリスト。 データタイプ:文字列 テーブル:スキル [cmn_skill] |
| sla_due | 関連するサービスレベルアグリーメントに基づいてケースをクローズする必要がある日時。 データタイプ:文字列 |
| sn_app_cs_social_social_profile | Facebook、Twitter、YouTube などの特定のソーシャルメディアプロファイルの詳細。 データタイプ:オブジェクトのアレイ |
| sn_app_cs_social_social_profile.account | ソーシャルメディアプロファイルのアカウント情報を含むレコードの一意の識別子。アカウント [customer_account] テーブルにあります。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.channel | 関連するソーシャルメディアプロファイルチャネルの詳細。 データタイプ:オブジェクト |
| sn_app_cs_social_social_profile.channel.name | ソーシャルメディアチャネルの名前。 データタイプ:文字列 最大長:100 |
| sn_app_cs_social_social_profile.channel.sys_class_name | ソーシャルメディアチャネルレコードを含むテーブル。 データタイプ:文字列 最大長:80 |
| sn_app_cs_social_social_profile.channel.sys_created_by | ソーシャルメディアチャネルを作成した人物。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.channel.sys_created_on | ソーシャルメディアプロファイルが作成された日時。 データタイプ: 日付/時刻 最大長:40 |
| sn_app_cs_social_social_profile.channel.sys_id | 関連付けられたソーシャルメディアプロファイルチャネルの一意の識別子。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.channel.sys_mod_count | 関連付けられたソーシャルメディアプロファイルチャネルの情報が変更された回数。 データタイプ:整数 |
| sn_app_cs_social_social_profile.channel.sys_name | チャネルのシステム名。 データタイプ:文字列 最大長:255 |
| sn_app_cs_social_social_profile.channel.sys_package | プロファイルに関連付けられたパッケージに関する情報を含むレコードの一意の識別子。パッケージ [sys_package] テーブル。 データタイプ:参照 |
| sn_app_cs_social_social_profile.channel.sys_policy | システム保護ポリシー。 可能な値:
データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.channel.sys_scope | ソーシャルプロファイルの範囲に関する情報を含むレコードの一意の識別子。アプリケーション [sys_scope] テーブル。 データタイプ:参照 |
| sn_app_cs_social_social_profile.channel.sys_tags | チャネルに関連付けられたシステムタグ。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.channel.sys_update_name | ソーシャルメディアプロファイルチャネルを最後に更新したユーザーの名前。 データタイプ:文字列 最大長:250 |
| sn_app_cs_social_social_profile.channel.sys_updated_by | ソーシャルメディアプロファイルチャネルを最後に更新したユーザー。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.channel.sys_updated_on | ソーシャルメディアプロファイルチャネルが最後に更新された日時。 データタイプ: 日付/時刻 最大長:40 |
| sn_app_cs_social_social_profile.consumer | 企業/消費者間ケースの場合。ケースに関連付けられたコンシューマーの詳細。 データタイプ:オブジェクト |
| sn_app_cs_social_social_profile.consumer.active | コンシューマーがアクティブかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト:true |
| sn_app_cs_social_social_profile.consumer.business_phone | コンシューマーの勤務先電話番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.city | コンシューマーが居住する市区町村。 データタイプ:文字列 最大長:100 |
| sn_app_cs_social_social_profile.consumer.country | コンシューマーが居住する国。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.date_format | 日付を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム日付形式) |
| sn_app_cs_social_social_profile.consumer.email | コンシューマーのメールアドレス。 データタイプ:文字列 最大長:100 |
| sn_app_cs_social_social_profile.consumer.fax | コンシューマーのファックス番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.first_name | コンシューマーの名。 データタイプ:文字列 最大長:50 |
| sn_app_cs_social_social_profile.consumer.gender | コンシューマーの性別。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.home_phone | コンシューマーの自宅電話番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.household | 世帯の特性を説明するレコードの sys_id。 データタイプ:文字列 テーブル:世帯 [csm_household] |
| sn_app_cs_social_social_profile.consumer.last_name | コンシューマーの姓。 データタイプ:文字列 最大長:50 |
| sn_app_cs_social_social_profile.consumer.middle_name | コンシューマーのミドルネーム。 データタイプ:文字列 最大長:50 |
| sn_app_cs_social_social_profile.consumer.mobile_phone | コンシューマーの携帯電話番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.name | コンシューマーのフルネーム。 first_name+middle_name+last_name。 データタイプ:文字列 最大長:152 |
| sn_app_cs_social_social_profile.consumer.notes | コンシューマーに関するメモ。 データタイプ:文字列 最大長:4,000 |
| sn_app_cs_social_social_profile.consumer.notification | コンシューマーが通知を受信するかどうかを示します。 有効な値:
データタイプ:数値 (整数) 最大長:40 デフォルト値:2 |
| sn_app_cs_social_social_profile.consumer.number | コンシューマーに関連付けられた一意の番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.photo | コンシューマーの写真。 データタイプ:画像 |
| sn_app_cs_social_social_profile.consumer.preferred_language | コンシューマーのプライマリ言語。 データタイプ:文字列 最大長:3 |
| sn_app_cs_social_social_profile.consumer.prefix | Dr.、Mr.、Mrs.、Ms. などのコンシューマー名のプリフィックス データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.primary | これがプライマリコンシューマーであるかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| sn_app_cs_social_social_profile.consumer.state | コンシューマーが居住する都道府県。 データタイプ:文字列 最大長:100 |
| sn_app_cs_social_social_profile.consumer.street | コンシューマーの番地。 データタイプ:文字列 最大長:255 |
| sn_app_cs_social_social_profile.consumer.suffix | Jr.、Sr.、II などのコンシューマー名のサフィックス。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.consumer.sys_created_by | コンシューマーレコードを作成したユーザー。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.sys_created_on | コンシューマーレコードが最初に作成された日時。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.consumer.sys_domain | コンシューマー情報が存在する ServiceNow ドメイン。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.consumer.sys_id | コンシューマーの一意の識別子。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.consumer.sys_mod_count | 関連するコンシューマー情報が変更された回数。 データタイプ:数値 (整数) |
| sn_app_cs_social_social_profile.consumer.sys_tags | コンシューマーシステムタグ。 |
| sn_app_cs_social_social_profile.consumer.sys_updated_by | コンシューマー情報を最後に更新したユーザー。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.sys_updated_on | コンシューマー情報が最後に更新された日時。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.consumer.time_format | 時間を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム時間形式) |
| sn_app_cs_social_social_profile.consumer.time_zone | コンシューマーのタイムゾーン (カナダ/中央または米国/東部)。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.title | マネージャー、ソフトウェア開発者、請負業者などのコンシューマーのビジネスタイトル。 データタイプ:文字列 最大長:60 |
| sn_app_cs_social_social_profile.consumer.user | コンシューマーユーザーの sys_id。 データタイプ:文字列 テーブル:コンシューマーユーザー [csm_consumer_user] |
| sn_app_cs_social_social_profile.consumer.zip | コンシューマーの郵便番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact | 企業間ケースの場合。ケースに関連付けられた連絡先に属するソーシャルメディアプロファイルの詳細を含むレコードの一意の識別子。連絡先 [customer_contact] テーブルにあります。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.contact.account | 連絡先が関連付けられているアカウントレコードのSys_id。 データタイプ:文字列 テーブル:アカウント [customer_account] |
| sn_app_cs_social_social_profile.contact.active | システム内で連絡先がアクティブかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト:true |
| sn_app_cs_social_social_profile.contact.agent_status | エージェントのステータス。 可能な値:
データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.building | 連絡先が所在する建物を説明するレコードのSys_id。 データタイプ:文字列 テーブル:建物 [cmn_building] |
| sn_app_cs_social_social_profile.contact.calendar_integration | 連絡先が使用するカレンダーアプリケーション。 1:Outlook データタイプ:数値 (整数) デフォルト値:1 |
| sn_app_cs_social_social_profile.contact.city | 連絡先が居住する市区町村。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.company | 連絡先が関連付けられている会社レコードのSys_id。 データタイプ:文字列 テーブル:会社 [core_company] |
| sn_app_cs_social_social_profile.contact.cost_center | 連絡先に関連付けられたコストセンターのSys_id。 データタイプ:文字列 テーブル:コストセンター [cmn_cost_center] |
| sn_app_cs_social_social_profile.contact.country | 連絡先が居住する国の国コード。 データタイプ:文字列 最大長:3 |
| sn_app_cs_social_social_profile.contact.date_format | 連絡先に日付を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム日付形式) |
| sn_app_cs_social_social_profile.contact.default_perspective | 連絡先のデフォルトの視点の sys_id。 データタイプ:文字列 テーブル:メニューリスト [sys_perspective] |
| sn_app_cs_social_social_profile.contact.department | 連絡先に関連付けられた部門の sys_id。 データタイプ:文字列 テーブル:部門 [cmn_department] |
| sn_app_cs_social_social_profile.contact.edu_status | 関連付けられた連絡先の学歴ステータス。 データタイプ:文字列 最大長:40 デフォルト:faculty |
| sn_app_cs_social_social_profile.contact.email | 連絡先のメールアドレス。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.contact.employee_number | 連絡先の従業員番号。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.contact.enable_multifactor_authn | 連絡先がサービスポータルにログインするためにマルチファクター認証が必要かどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| sn_app_cs_social_social_profile.contact.failed_attempts | 失敗したログイン試行回数。 データタイプ:数値 (整数) |
| sn_app_cs_social_social_profile.contact.first_name | 連絡先の名。 データタイプ:文字列 最大長:50 |
| sn_app_cs_social_social_profile.contact.gender | 連絡先の性別。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.geolocation_tracked | 連絡先の場所が位置情報追跡によって取得されたかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| sn_app_cs_social_social_profile.contact.home_phone | 連絡先の自宅電話番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.internal_itegration_user | 連絡先が内部統合ユーザーかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| sn_app_cs_social_social_profile.contact.introduction | 前書き データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.last_login | 連絡先が最後にシステムにログインした日付。 データタイプ:文字列 (日付) |
| sn_app_cs_social_social_profile.contact.last_login_device | コンシューマーが最後にシステムにログインしたときに使用したデバイス。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.last_login_time | 連絡先がシステムにログインした日時。 データタイプ:文字列 (日付/時間) |
| sn_app_cs_social_social_profile.contact.last_name | 連絡先の姓。 データタイプ:文字列 最大長:50 |
| sn_app_cs_social_social_profile.contact.last_position_update | 位置が最後に更新された日時。 データタイプ:文字列 (日付/時間) |
| sn_app_cs_social_social_profile.contact.latitude | 連絡先の緯度座標。 データタイプ:数値 (浮動小数点) 最大長:40 |
| sn_app_cs_social_social_profile.contact.ldap_server | 連絡先がシステムへの最終ログインに使用する LDAP サーバーのSys_id。 データタイプ:文字列 テーブル:LDAP サーバー [ldap_server_config] |
| sn_app_cs_social_social_profile.contact.location | 連絡先の場所を説明するレコードのSys_id データタイプ:文字列 テーブル:場所 [cmn_location] |
| sn_app_cs_social_social_profile.contact.locked_out | 連絡先がロックアウトされているかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| sn_app_cs_social_social_profile.contact.longitude | 連絡先の経度座標。 データタイプ:数値 (浮動小数点) 最大長:40 |
| sn_app_cs_social_social_profile.contact.manager | 連絡先の直属の上司を説明するレコードのSys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| sn_app_cs_social_social_profile.contact.middle_name | 連絡先のミドルネーム。 データタイプ:数値 (浮動小数点) 最大長:50 |
| sn_app_cs_social_social_profile.contact.mobile_phone | 連絡先の携帯電話番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.name | 連絡先のフルネーム。 データタイプ:文字列 最大長:151 |
| sn_app_cs_social_social_profile.contact.notification | 連絡先が通知を受信するかどうかを示します。 有効な値:
データタイプ:数値 (整数) デフォルト値:2 |
| sn_app_cs_social_social_profile.contact.on_schedule | ディスパッチされたサービス担当者の適時性を示します。 有効な値:
データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.phone | 連絡先の勤務先電話番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.photo | 連絡先の写真画像。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.contact.preferred_language | 連絡先のプライマリ言語の国コード。 データタイプ:文字列 最大長:3 |
| sn_app_cs_social_social_profile.contact.roles | 連絡先に関連付けられているユーザーロールのリスト。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.schedule | 関連付けられた連絡先の作業スケジュールを説明するレコードのSys_id。 データタイプ:文字列 テーブル:スケジュール [cmn_schedule] |
| sn_app_cs_social_social_profile.contact.source | 連絡先のソース。 データタイプ:文字列 最大長:255 |
| sn_app_cs_social_social_profile.contact.state | 連絡先が居住する都道府県。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.street | 連絡先の番地。 データタイプ:文字列 最大長:255 |
| sn_app_cs_social_social_profile.contact.sys_class_name | 連絡先レコードを含むテーブル。 データタイプ:文字列 最大長:80 |
| sn_app_cs_social_social_profile.contact.sys_created_by | 関連付けられた連絡先レコードを最初に作成したユーザー。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.sys_created_on | 関連付けられた連絡先が最初に作成された日時。 データタイプ:文字列 (日付/時間) |
| sn_app_cs_social_social_profile.contact.sys_domain | 関連付けられた連絡先レコードの ServiceNow インスタンスドメイン。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.contact.sys_domain_path | 連絡先レコードのドメインパス。 データタイプ:文字列 最大長:255 デフォルト:/ (global) |
| sn_app_cs_social_social_profile.contact.sys_id | 関連付けられた連絡先レコードの一意の識別子。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.contact.sys_mod_count | 関連付けられた連絡先レコードが変更された回数。 データタイプ:数値 (整数) |
| sn_app_cs_social_social_profile.contact.sys_tags | 連絡先システムタグ。 |
| sn_app_cs_social_social_profile.contact.sys_updated_by | 関連付けられた連絡先情報を最後に更新したユーザー。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.sys_updated_on | 関連付けられた連絡先情報が更新された日時。 データタイプ:文字列 (日付/時間) |
| sn_app_cs_social_social_profile.contact.time_format | 時間を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム時間形式) |
| sn_app_cs_social_social_profile.contact.time_sheet_policy | 関連付けられた連絡先のタイムシートポリシーを含むレコードのSys_id。 データタイプ:文字列 テーブル:タイムシートポリシー [time_sheet_policy] |
| sn_app_cs_social_social_profile.contact.time_zone | 連絡先が居住するタイムゾーン (カナダ/中央または米国/東部)。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.title | マネージャー、ソフトウェア開発者、請負業者などの連絡先のビジネスタイトル。 データタイプ:文字列 最大長:60 |
| sn_app_cs_social_social_profile.contact.user_name | 連絡先のユーザー ID。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.vip | 関連付けられた連絡先が VIP ステータスかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| sn_app_cs_social_social_profile.contact.web_service_access_only | 連絡先が Web 経由でのみサービスにアクセスできるかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| sn_app_cs_social_social_profile.contact.zip | 連絡先の郵便番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.created_on | 関連するソーシャルメディアプロファイルが最初に作成された日時。 |
| sn_app_cs_social_social_profile.profile | ソーシャルプロファイル。 データタイプ:文字列 最大長:255 |
| sn_app_cs_social_social_profile.profile_url | ソーシャルメディアプロファイルへのアクセスに使用する URL。 データタイプ:文字列 最大長:1,024 |
| sn_app_cs_social_social_profile.social_id | 関連付けられたソーシャルメディアアカウントの一意のソーシャルメディアアカウントプロバイダー識別子。 データタイプ:文字列 最大長:100 |
| sn_app_cs_social_social_profile.source | ソーシャルプロファイルのソース。 データタイプ:文字列 最大長:255 |
| sn_app_cs_social_social_profile.sys_created_by | ソーシャルメディアプロファイルを最初に作成したユーザー。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.sys_created_on | ソーシャルメディアプロファイルが最初に作成された日時。 データタイプ:文字列 (日付/時間) |
| sn_app_cs_social_social_profile.sys_id | ソーシャルメディアプロファイルの一意の識別子。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.sys_mod_count | 関連付けられたソーシャルメディアプロファイルの情報が変更された回数。 データタイプ:数値 (整数) |
| sn_app_cs_social_social_profile.sys_tags | プロファイルシステムタグ。 |
| sn_app_cs_social_social_profile.sys_updated_by | ソーシャルメディアプロファイルを最初に作成したユーザー。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.sys_updated_on | ソーシャルメディアプロファイルを最初に作成したユーザー。 データタイプ:文字列 最大長:40 |
| state | ケースの現在のステータス。 可能な値:
データタイプ:数値 (整数) デフォルト値:1 |
| subcategory | ケースのサブカテゴリ。 可能な値: 0:質問データタイプ:数値 (整数) デフォルト:0 |
| support_manager | ケースにアサインされた CSM マネージャーの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| sync_driver | ドライバーの同期があるかどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン |
| sys_class_name | ケースレコードを含むテーブル。 データタイプ:文字列 最大長:80 |
| sys_created_by | ケースを最初にオープンしたユーザー。 データタイプ:文字列 最大長:40 |
| sys_created_on | ケースが最初に作成された日時。 データタイプ:文字列 |
| sys_domain | ケースに関連付けられたドメイン。 データタイプ:文字列 最大長:32 デフォルト:global |
| sys_domain_path | ドメインパス。 データタイプ:文字列 最大長:255 デフォルト:/ |
| sys_id | ケースの一意の識別子。 データタイプ:文字列 最大長:32 |
| sys_mod_count | ケースが最初に作成されてからの更新回数。 データタイプ:数値 (整数) |
| sys_tags | システムタグ。 |
| sys_updated_by | ケースを最後に更新したユーザー。 データタイプ:文字列 最大長:40 |
| sys_updated_on | ケースが最後に更新された日時。 データタイプ:文字列 |
| time_worked | ケースの合計作業時間。 データタイプ:文字列 |
| upon_approval | ケースが承認された場合に実行するアクション。 可能な値:
データタイプ:文字列 最大長:40 デフォルト:proceed |
| upon_reject | ケースが却下された場合に実行するアクション。 可能な値:
データタイプ:文字列 最大長:40 デフォルト:cancel |
| urgency | ケースの緊急度。 可能な値:
データタイプ:数値 (整数) デフォルト値:3 |
| user_input | 追加のユーザー入力。 データタイプ:文字列 最大長:4,000 |
| variable_pool | 変数のグループ化。 |
| variables | ケースに関連付けられた変数の名前と値のペア。 データタイプ:文字列 最大長:40 |
| watch_list | 追加のコメントが追加された場合、またはケースのステータスが「解決済み」または「クローズ済み」に変更された場合に、このケースに関する通知を受信するユーザーの sys_id のリスト。 データタイプ:アレイ テーブル:ユーザー [sys_user] |
| wf_activity | ケースに関連付けられたワークフローアクティビティレコードの sys_id。 データタイプ:文字列 テーブル:ワークフローアクティビティ [wf_activity] |
| work_end | ケースの作業が終了した日時。 データタイプ:文字列 |
| work_notes | ケースの解決方法に関する情報、またはケースの解決手順。 データタイプ:文字列 最大長:4,000 |
| work_notes_list | 作業メモが追加されたときに、このケースについての通知を受け取る内部ユーザーの sys_id のリスト。 データタイプ:アレイ テーブル:ユーザー [sys_user] |
| work_start | ケースの作業が開始された日時。 データタイプ:文字列 |
cURL 要求
curl "https://instance.servicenow.com/api/sn_customerservice/case/ba325dbe64f01300964fae39b050e9a6" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
{
"result": {
"parent": "",
"caused_by": "",
"watch_list": "",
"active_escalation": "",
"upon_reject": "cancel",
"sys_updated_on": "2018-06-18 00:14:43",
"support_manager": "",
"approval_history": "",
"skills": "",
"number": "CS0000871",
"problem": "",
"state": "10",
"case": "Acme Analytics performance degradationCS0000871",
"sys_created_by": "john.jason",
"knowledge": "false",
"order": "",
"cmdb_ci": "",
"delivery_plan": "",
"impact": "3",
"contract": "",
"active": "true",
"work_notes_list": "",
"auto_created_case": "false",
"priority": "1",
"sys_domain_path": "/",
"rejection_goto": "",
"first_response_time": "",
"business_duration": "",
"group_list": "",
"child_case_creation_progress": "false",
"sync_driver": "false",
"approval_set": "",
"wf_activity": "",
"short_description": "Acme Analytics performance degradation",
"correlation_display": "",
"delivery_task": "",
"work_start": "",
"recipient_list": "",
"additional_assignee_list": "",
"notify": "1",
"sys_class_name": "sn_customerservice_case",
"closed_by": "",
"follow_up": "",
"contact_local_time": "",
"sn_app_cs_social_social_profile": "",
"reassignment_count": "0",
"contact_time_zone": "",
"notes_to_comments": "false",
"assigned_to": "da419c1fc312310015519f2974d3ae15",
"product": "4c84a024c3211200bb779f2974d3aef6",
"variables": "",
"variable_pool": "",
"hierarchical_variables": "variable_pool",
"sla_due": "",
"change": "",
"comments_and_work_notes": "",
"partner": "",
"escalation": "0",
"upon_approval": "proceed",
"partner_contact": "",
"correlation_id": "",
"asset": "",
"made_sla": "true",
"resolved_by": "",
"sys_updated_by": "john.jason",
"opened_by": "da419c1fc312310015519f2974d3ae15",
"user_input": "",
"sys_created_on": "2018-06-18 00:14:39",
"contact": "",
"sys_domain": "global",
"closed_at": "",
"follow_the_sun": "false",
"entitlement": "",
"business_service": "",
"business_impact": "Acme Anaytics performance is extremely slow. Customers are not able to use it. ",
"time_worked": "",
"expected_start": "",
"opened_at": "2018-06-18 00:14:39",
"work_end": "",
"resolved_at": "",
"case_report": "27329dbe64f01300964fae39b050e93c",
"subcategory": "0",
"work_notes": "",
"assignment_group": "",
"cause": "",
"description": "",
"calendar_duration": "",
"close_notes": "",
"sys_id": "ba325dbe64f01300964fae39b050e9a6",
"contact_type": "web",
"resolution_code": "",
"probable_cause": "",
"urgency": "3",
"company": "",
"major_case_state": "accepted",
"consumer": "",
"activity_due": "",
"comments": "",
"approval": "not requested",
"due_date": "",
"sys_mod_count": "2",
"sys_tags": "",
"active_account_escalation": "",
"location": "",
"category": "1",
"account": ""
}
}
ケース - GET /sn_customerservice/case
カスタマーサービス管理 (CSM) ケースの指定されたセットを取得します。
このエンドポイントを使用するには、csm_ws_integration、sn_customerservice.customer、または sn_customerservice.consumer ロールが必要です。
URL 形式
バージョニングされた URL:/api/sn_customerservice/{api_version}/case
デフォルトの URL:/api/sn_customerservice/case
サポートされている要求パラメーター
| 名前 | 説明 |
|---|---|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ:文字列 |
| 名前 | 説明 |
|---|---|
| sysparm_display_value | 参照フィールドと選択フィールドのデータ取得操作。 この値に基づいてデータベースから表示値や実際の値を取得します。 データタイプ:文字列 有効な値:
デフォルト値:false 注: このパラメーター設定に推奨方法はありません。ただし、表示値を指定すると、データベースから直接読み取られず、その他のフィールドやレコードを参照することがあるため、パフォーマンスに問題が発生する可能性があります。表示値と実際の値の詳細については、「テーブル API FAQ (KB0534905)」を参照してください。 |
| sysparm_fields | 応答で返すカンマ区切りのフィールドのリストです。無効なフィールドは無視されます。 データタイプ:文字列 デフォルト:すべてのフィールドを返します。 |
| sysparm_limit | 返されるレコードの最大数。異常に大きい sysparm_limit 値はシステムパフォーマンスに影響する可能性があります。このレコード数を超える要求の場合は、sysparm_offset パラメーターを使用してレコード取得をページネーションします。 データタイプ:数値 |
| sysparm_offset | レコード取得を開始するレコードのインデックス。この値を使用して、レコード取得をページネーションします。この機能により、レコード数に関係なく、管理しやすい小さなチャンクに分割してすべてのレコードを取得できます。 たとえば、このエンドポイントを初めて呼び出すときに、sysparm_offset は「0」に設定されます。単に利用可能なすべてのレコードをページングするには、すべてのレコードの終わりに達するまで「 データタイプ:数値 デフォルト:0 |
| sysparm_query | 結果セットのフィルタリングに使用されるエンコードされたクエリ。 例:
エンコードされたクエリは、 順序 をサポートしています。特定のフィールドに基づいて回答を並べ替えるには、ORDERBY と ORDERBYDESC の句を sysparm_query で使用します。たとえば、 フィールド名が無効というようにクエリの一部が無効であると、インスタンスは無効な部分を無視します。次に、クエリの有効部分のみを使用して行を返します。この動作は glide.invalid_query.returns_no_rows プロパティを使用してコントロールできます。無効なクエリに行を返さないようにするには、このプロパティを true に設定します。 注: glide.invalid_query.returns_no_rows プロパティは、リスト、スクリプト (GlideRecord.query())、Web サービス API など、インスタンスのすべてのクエリの動作を管理します。 データタイプ:文字列 |
| sysparm_reference_fields | アカウント、連絡先、コンシューマー、sn_app_cs_social_social_profile などの参照テーブルからフィールドを取得するかどうか。デフォルトでは、ユーザーがフィールドへの読み取りアクセス権を持っている場合はこれらのフィールドが返されますが、これによりパフォーマンスのオーバーヘッドが増加します。多数のケースレコードを取得する場合は、sysparm_reference_fields=false を設定することでこのオーバーヘッドを排除できます。データタイプ:ブーリアン デフォルト:true 注: このエンドポイントを使用する場合は、このクエリパラメーターの sysparm_ プリフィックスを省略して reference_fields. |
| 名前 | 説明 |
|---|---|
| なし |
ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。
| ヘッダー | 説明 |
|---|---|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ:application/json または application/xml。 デフォルト: application/json |
| ヘッダー | 説明 |
|---|---|
| リンク | REST 応答データは、複数の結果セットに分割できます。応答ヘッダーには、必要に応じて最初のセット、前のセット、次のセット、最後のセットのレコードに対する各種リンクがあります。 例:
|
| X-Total-Count | sysparm_limit または sysparm_offset クエリパラメーターが指定されている場合、要求に一致するレコードの合計数を示す応答ヘッダー。 |
ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。
| ステータスコード | 説明 |
|---|---|
| 200 | 成功。要求が正常に処理されました。 |
| 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 |
| 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 |
応答本文のパラメーター (JSON または XML)
| 要素 | 説明 |
|---|---|
| account |
ケースに関連付けられたアカウントレコードの sys_id。
データタイプ:文字列 テーブル:アカウント [customer_account] |
| account | アカウントの詳細。 データタイプ:オブジェクト |
| account.account_code | アプリケーションが予算予測と予算計画を識別するために使用する値の一意の組み合わせ。 データタイプ:文字列 最大長:255 |
| account.account_parent | このアカウントの親アカウントの sys_id。アカウント [customer_account] テーブルにあります。 データタイプ:文字列 |
| account.account_path | アカウント階層内の親アカウントから子アカウントへのパス。 データタイプ:文字列 最大長:255 |
| account.active_escalation | アカウントに関連付けられたアクティブなエスカレーションの sys_id。 データタイプ:文字列 テーブル:エスカレーション [sn_customerservice_escalation] |
| account.apple_icon | iPhone ホームページのブックマークのアイコン。 データタイプ:画像 |
| account.banner_image | カスタマーポータルに表示されるバナー画像。 データタイプ:画像 |
| account.banner_image_light | 小さなバナー画像。 データタイプ:画像 |
| account.banner_text | カスタマーポータルに表示されるバナーテキスト。 データタイプ:文字列 最大長:4,000 |
| account.city | このアカウントに関連付けられている会社が所在する市。 データタイプ:文字列 最大長:50 |
| account.contact | このアカウントに関連付けられた連絡先レコードの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| account.country | このアカウントに関連付けられている会社が所在する国。 データタイプ:文字列 最大長:40 デフォルト: USA |
| account.customer | アカウントがパートナーアカウントではなく、顧客アカウントであるかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| account.discount | 購入時にアカウントに付与される割引。 データタイプ:数値 最大長:15 |
| account.fax_phone | このアカウントに関連付けられている会社の主要な FAX 電話番号。 データタイプ:文字列 最大長:40 |
| account.fiscal_year | アカウントに関連付けられている会社の会計年度。 データタイプ:文字列 |
| account.lat_long_error | 緯度および経度情報と比較した実際の場所の差。 データタイプ:文字列 最大長:1,000 |
| account.latitude | このアカウントに関連付けられている会社の緯度。 データタイプ:数値 (浮動小数点) 最大長:40 |
| account.longitude | このアカウントに関連付けられている会社の経度。 データタイプ:数値 (浮動小数点) 最大長:40 |
| account.manufacturer | このアカウントに関連付けられている会社が商品を製造しているかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| account.market_cap | 関連付けられている会社の公開株式の時価。 データタイプ:数値 (通貨) 最大長:20 |
| account.name | このアカウントに関連付けられている会社の名前。 データタイプ:文字列 最大長:80 |
| account.notes | 会社に関する補足情報。 データタイプ:文字列 最大長:4,000 |
| account.num_employees | 会社に雇用されている人数。 データタイプ:数値 (整数) 最大長:40 |
| account.number | このアカウントを識別する番号。 データタイプ:文字列 最大長:40 |
| account.parent | このアカウントの親アカウントの sys_id。 データタイプ:文字列 テーブル:会社 [core_company] |
| account.partner | アカウントがパートナーアカウントか顧客アカウントかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| account.phone | 会社の主要な電話番号。 データタイプ:文字列 |
| account.primary | これがプライマリアカウントであるかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| account.primary_contact | アカウントの主連絡先の sys_id。 データタイプ:文字列 テーブル:連絡先 [customer_contact] |
| account.profits | このアカウントに対して入力された利益情報。 データタイプ:数値 (通貨) 最大長:40 |
| account.publicly_traded | このアカウントに関連付けられている会社の株式が証券取引所で公開されているかどうかを示すフラグ。 可能な値:
データタイプ:ブール |
| account.rank_tier | アカウントのタイプ。 可能な値:
データタイプ:文字列 最大長:40 |
| account.registration_code | 顧客がカスタマーポータルでログインを要求するときに使用する一意のコード。このコードは、アクセス権を付与する前に会社で顧客を検証する方法を提供します。 データタイプ:文字列 最大長:40 |
| account.revenue_per_year | このアカウントに関連付けられている会社が生み出した収益。 データタイプ:数値 (通貨) 最大長:20 |
| account.state | 会社が所在する都道府県。 データタイプ:文字列 最大長:40 |
| account.stock_price | 会社の株価。 データタイプ:文字列 最大長:40 |
| account.stock_symbol | 会社の銘柄記号。 データタイプ:文字列 最大長:40 |
| account.street | 会社の番地 データタイプ:文字列 最大長:255 |
| account.sys_class_name | 関連するアカウントレコードを含むテーブル。 データタイプ:文字列 |
| account.sys_created_by | 最初にアカウントを作成したユーザー。 データタイプ:文字列 最大長:40 |
| account.sys_created_on | アカウントが最初に作成された日時。 データタイプ:文字列 |
| account.sys_id | アカウントレコードの sys_id。 データタイプ:文字列 |
| account.sys_mod_count | アカウント情報が更新された回数。 データタイプ:数値 (整数) |
| account.sys_updated_by | アカウント情報を最後に変更したユーザー。 データタイプ:文字列 最大長:40 |
| account.sys_updated_on | アカウント情報が最後に更新された日時。 データタイプ:文字列 |
| account.theme | このアカウントで使用されるカスタマーポータルテーマの sys_id。 データタイプ:文字列 テーブル:テーマ [sys_ui_theme] |
| account.vendor | このアカウントに関連付けられている会社がベンダーかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| account.vendor_manager | アカウントのベンダーマネージャーの sys_id のリスト。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| account.vendor_type | アプリケーション、ハードウェア、サービス、ソフトウェアなどのベンダーのタイプの sys_id のリスト。 データタイプ:文字列 テーブル:ベンダータイプ [vendor_type] |
| account.website | 会社の Web サイトの URL。 データタイプ:文字列 最大長:1,024 |
| account.zip | 会社の郵便番号。 データタイプ:文字列 最大長:40 |
| アクティブ | ケースがオープンかアクティブかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト:true |
| active_account_escalation | ケースに関連付けられたアクティブなアカウントエスカレーションの sys_id。 データタイプ:文字列 テーブル:エスカレーション [sn_customerservice_escalation] |
| active_escalation | ケースに関連付けられたアクティブなエスカレーションレコードのSys_id。 データタイプ:文字列 テーブル:エスカレーション [sn_customerservice_escalation] |
| activity_due | 関連付けられたケースの完了予定日。 データタイプ:文字列 |
| additional_assignee_list | アカウントにアサインされた追加のユーザー (プライマリアサイニーを除く) のsys_idsのリスト。 データタイプ:アレイ 最大:4,000 テーブル:ユーザー [sys_user] |
| approval | 必要な承認のタイプを説明する文字列。 可能な値:
データタイプ:文字列 最大文字数:40 デフォルト:not requested |
| approval_history | ケースに関連付けられているすべての承認のリスト。 データタイプ:文字列 最大文字数:4,000 |
| approval_set | 関連するアクションが承認された日時。 データタイプ:文字列 |
| 資産 | ケースに関連付けられた資産レコードの sys_id。 データタイプ:文字列 テーブル:資産 [alm_asset] |
| assigned_to |
ケースにアサインされたユーザーの sys_id。
テーブル:ユーザー [sys_user] データタイプ:文字列 |
| assignment_group | ケースにアサインされたカスタマーサービスエージェントグループの sys_id。 データタイプ:文字列 テーブル: Group [sys_user_group] |
| business_duration | ケースの完了までにかかったカレンダー上の作業時間、作業日数、および作業週数。 データタイプ:文字列 |
| business_impact | 関連する顧客に対する問題の影響。 データタイプ:文字列 最大文字数:4,000 |
| business_service | ケースに関連付けられたサービスレコードの sys_id。 データタイプ:文字列 テーブル:サービス [cmdb_ci_service] |
| case | ケースの簡単な説明とケース番号。 データタイプ:文字列 最大長:300 |
| case_report | 関連するケースレポートの sys_id。 データタイプ:文字列 テーブル:ケースレポート [sn_customerservice_case_report] |
| category | ケースカテゴリ。 可能な値:
データタイプ:数値 (整数) デフォルト値:1 |
| cause | 問題の原因に関する詳細。 データタイプ:文字列 最大長:4,000 |
| caused_by | ケースが作成される原因となった変更要求の sys_id。 データタイプ:文字列 テーブル:変更要求 [change_request] |
| 変更 | ケースが作成される原因となった変更要求の sys_id。 データタイプ:文字列 テーブル:変更要求 [change_request] |
| child_case_creation_progress | ケースが重大なケースから作成された子ケースであるかどうかを示すフラグ。 可能な値:
データタイプ:ブール |
| closed_at | ケースがクローズされた日時。 データタイプ:文字列 |
| closed_by | ケースをクローズしたユーザーの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| close_notes | ケースがクローズされたときに作成されたメモ。 データタイプ:文字列 最大長:4,000 |
| cmdb_ci | ケースに関連付けられた構成アイテムの sys_id。 データタイプ:文字列 テーブル:構成アイテム [cmdb_ci] |
| コメント | ケースに関する追加のコメント。 データタイプ:文字列 最大長:4,000 |
| comments_and_work_notes | ケースに対して入力されたコメントと作業メモ。 データタイプ:文字列 最大長:4,000 |
| company | ケースに関連付けられた会社の sys_id。 データタイプ:文字列 テーブル:会社 [core_company] |
| consumer | 企業/消費者間ケースのみ。このケースに関して連絡先となる人のSys_id。 データタイプ:文字列 テーブル:コンシューマー [csm_consumer] |
| consumer | 企業/消費者間ケースのパラメーターのアレイ。 |
| consumer.active | コンシューマーがアクティブかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト:true |
| consumer.business_phone | コンシューマーの勤務先電話番号。 データタイプ:文字列 最大長:40 |
| consumer.city | コンシューマーが居住する市区町村。 データタイプ:文字列 最大長:100 |
| consumer.country | コンシューマーが居住する国。 データタイプ:文字列 最大長:40 |
| consumer.date_format | 日付を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム日付形式) |
| consumer.email | コンシューマーのメールアドレス。 データタイプ:文字列 最大長:100 |
| consumer.fax | コンシューマーのファックス番号。 データタイプ:文字列 最大長:40 |
| consumer.first_name | コンシューマーの名。 データタイプ:文字列 最大長:50 |
| consumer.gender | コンシューマーの性別。 データタイプ:文字列 最大長:40 |
| consumer.home_phone | コンシューマーの自宅電話番号。 データタイプ:文字列 最大長:40 |
| consumer.household | 世帯の特性を説明するレコードの sys_id。 データタイプ:文字列 テーブル:世帯 [csm_household] |
| consumer.last_name | コンシューマーの姓。 データタイプ:文字列 最大長:50 |
| consumer.middle_name | コンシューマーのミドルネーム。 データタイプ:文字列 最大長:50 |
| consumer.mobile_phone | コンシューマーの携帯電話番号。 データタイプ:文字列 最大長:40 |
| consumer.name | コンシューマーのフルネーム。 first_name+middle_name+last_name。 データタイプ:文字列 最大長:152 |
| consumer.notes | コンシューマーに関するメモ。 データタイプ:文字列 最大長:4,000 |
| consumer.notification | コンシューマーが通知を受信するかどうかを示します。 有効な値:
データタイプ:数値 (整数) 最大長:40 デフォルト値:2 |
| consumer.number | コンシューマーに関連付けられた一意の番号。 データタイプ:文字列 最大長:40 |
| consumer.photo | コンシューマーの写真。 データタイプ:画像 |
| consumer.preferred_language | コンシューマーのプライマリ言語。 データタイプ:文字列 最大長:3 |
| consumer.prefix | Dr.、Mr.、Mrs.、Ms. などのコンシューマー名のプリフィックス データタイプ:文字列 最大長:40 |
| consumer.primary | これがプライマリコンシューマーであるかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| consumer.state | コンシューマーが居住する都道府県。 データタイプ:文字列 最大長:100 |
| consumer.street | コンシューマーの番地。 データタイプ:文字列 最大長:255 |
| consumer.suffix | Jr.、Sr.、II などのコンシューマー名のサフィックス。 データタイプ:文字列 |
| consumer.sys_created_by | コンシューマーレコードを作成したユーザー。 データタイプ:文字列 最大長:40 |
| consumer.sys_created_on | コンシューマーレコードが最初に作成された日時。 データタイプ:文字列 |
| consumer.sys_domain | コンシューマー情報が存在する ServiceNow ドメイン。 データタイプ:文字列 |
| consumer.sys_id | コンシューマーの一意の識別子。 データタイプ:文字列 |
| consumer.sys_mod_count | 関連するコンシューマー情報が変更された回数。 データタイプ:数値 (整数) |
| consumer.sys_updated_by | コンシューマー情報を最後に更新したユーザー。 データタイプ:文字列 最大長:40 |
| consumer.sys_updated_on | コンシューマー情報が最後に更新された日時。 データタイプ:文字列 |
| consumer.time_format | 時間を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム時間形式) |
| consumer.time_zone | コンシューマーのタイムゾーン (カナダ/中央または米国/東部)。 データタイプ:文字列 最大長:40 |
| consumer.title | マネージャー、ソフトウェア開発者、請負業者などのコンシューマーのビジネスタイトル。 データタイプ:文字列 最大長:60 |
| consumer.user | コンシューマーユーザーの sys_id。 データタイプ:文字列 テーブル:コンシューマーユーザー [csm_consumer_user] |
| consumer.zip | コンシューマーの郵便番号。 データタイプ:文字列 最大長:40 |
| 連絡先 | 企業間ベースのケースのみ。このケースに関する連絡担当者の sys_id。 データタイプ:文字列 テーブル:連絡先 [customer_contact] |
| contact | 企業/企業間ケースの連絡先パラメーターのアレイ。 |
| contact.account | 連絡先が関連付けられているアカウントレコードのSys_id。 データタイプ:文字列 テーブル:アカウント [customer_account] |
| contact.active | システム内で連絡先がアクティブかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト:true |
| contact.agent_status | エージェントのステータス。 可能な値:
データタイプ:文字列 最大長:40 |
| contact.building | 連絡先が所在する建物を説明するレコードのSys_id。 データタイプ:文字列 テーブル:建物 [cmn_building] |
| contact.calendar_integration | 連絡先が使用するカレンダーアプリケーション。 1:Outlook データタイプ:数値 (整数) デフォルト値:1 |
| contact.city | 連絡先が居住する市区町村。 データタイプ:文字列 最大長:40 |
| contact.company | 連絡先が関連付けられている会社レコードのSys_id。 データタイプ:文字列 テーブル:会社 [core_company] |
| contact.cost_center | 連絡先に関連付けられたコストセンターのSys_id。 データタイプ:文字列 テーブル:コストセンター [cmn_cost_center] |
| contact.country | 連絡先が居住する国の国コード。 データタイプ:文字列 最大長:3 |
| contact.date_format | 連絡先に日付を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム日付形式) |
| contact.default_perspective | 連絡先のデフォルトの視点の sys_id。 データタイプ:文字列 テーブル:メニューリスト [sys_perspective] |
| contact.department | 連絡先に関連付けられた部門の sys_id。 データタイプ:文字列 テーブル:部門 [cmn_department] |
| contact.edu_status | 関連付けられた連絡先の学歴ステータス。 データタイプ:文字列 最大長:40 デフォルト:faculty |
| contact.email | 連絡先のメールアドレス。 データタイプ:文字列 |
| contact.employee_number | 連絡先の従業員番号。 データタイプ:文字列 |
| contact.enable_multifactor_authn | 連絡先がサービスポータルにログインするためにマルチファクター認証が必要かどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| contact.failed_attempts | 失敗したログイン試行回数。 データタイプ:数値 (整数) |
| contact.first_name | 連絡先の名。 データタイプ:文字列 最大長:50 |
| contact.gender | 連絡先の性別。 データタイプ:文字列 最大長:40 |
| contact.geolocation_tracked | 連絡先の場所が位置情報追跡によって取得されたかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| contact.home_phone | 連絡先の自宅電話番号。 データタイプ:文字列 最大長:40 |
| contact.internal_integration_user | 連絡先が内部統合ユーザーかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| contact.introduction | 前書き データタイプ:文字列 最大長:40 |
| contact.last_login | 連絡先が最後にシステムにログインした日付。 データタイプ:文字列 (日付) |
| contact.last_login_device | コンシューマーが最後にシステムにログインしたときに使用したデバイス。 データタイプ:文字列 最大長:40 |
| contact.last_login_time | 連絡先がシステムにログインした日時。 データタイプ:文字列 (日付/時間) |
| contact.last_name | 連絡先の姓。 データタイプ:文字列 最大長:50 |
| contact.last_position_update | 位置が最後に更新された日時。 データタイプ:文字列 (日付/時間) |
| contact.latitude | 連絡先の緯度座標。 データタイプ:数値 (浮動小数点) 最大長:40 |
| contact.ldap_server | 連絡先がシステムへの最終ログインに使用する LDAP サーバーのSys_id。 データタイプ:文字列 テーブル:LDAP サーバー [ldap_server_config] |
| contact.location | 連絡先の場所を説明するレコードのSys_id データタイプ:文字列 テーブル:場所 [cmn_location] |
| contact.locked_out | 連絡先がロックアウトされているかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| contact.longitude | 連絡先の経度座標。 データタイプ:数値 (浮動小数点) 最大長:40 |
| contact.manager | 連絡先の直属の上司を説明するレコードのSys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| contact.middle_name | 連絡先のミドルネーム。 データタイプ:数値 (浮動小数点) 最大長:50 |
| contact.mobile_phone | 連絡先の携帯電話番号。 データタイプ:文字列 最大長:40 |
| contact.name | 連絡先のフルネーム。 データタイプ:文字列 最大長:151 |
| contact.notification | 連絡先が通知を受信するかどうかを示します。 有効な値:
データタイプ:数値 (整数) デフォルト値:2 |
| contact.on_schedule | ディスパッチされたサービス担当者の適時性を示します。 有効な値:
データタイプ:文字列 最大長:40 |
| contact.phone | 連絡先の勤務先電話番号。 データタイプ:文字列 最大長:40 |
| contact.photo | 連絡先の写真画像。 データタイプ:文字列 |
| contact.preferred_language | 連絡先のプライマリ言語の国コード。 データタイプ:文字列 最大長:3 |
| contact.roles | 連絡先に関連付けられているユーザーロールのリスト。 データタイプ:文字列 最大長:40 |
| contact.schedule | 関連付けられた連絡先の作業スケジュールを説明するレコードのSys_id。 データタイプ:文字列 テーブル:スケジュール [cmn_schedule] |
| contact.source | 連絡先のソース。 データタイプ:文字列 最大長:255 |
| contact.state | 連絡先が居住する都道府県。 データタイプ:文字列 最大長:40 |
| contact.street | 連絡先の番地。 データタイプ:文字列 最大長:255 |
| contact.sys_class_name | 連絡先レコードを含むテーブル。 データタイプ:文字列 最大長:80 |
| contact.sys_created_by | 関連付けられた連絡先レコードを最初に作成したユーザー。 データタイプ:文字列 最大長:40 |
| contact.sys_created_on | 関連付けられた連絡先が最初に作成された日時。 データタイプ:文字列 (日付/時間) |
| contact.sys_domain | 関連付けられた連絡先レコードの ServiceNow インスタンスドメイン。 データタイプ:文字列 |
| contact.sys_domain_path | 連絡先レコードのドメインパス。 データタイプ:文字列 最大長:255 デフォルト:/ (global) |
| contact.sys_id | 関連付けられた連絡先レコードの一意の識別子。 データタイプ:文字列 |
| contact.sys_mod_count | 関連付けられた連絡先レコードが変更された回数。 データタイプ:数値 (整数) |
| contact.sys_tags | コンテンツのシステムタグ。 データタイプ:文字列 |
| contact.sys_updated_by | 関連付けられた連絡先情報を最後に更新したユーザー。 データタイプ:文字列 最大長:40 |
| contact.sys_updated_on | 関連付けられた連絡先情報が更新された日時。 データタイプ:文字列 (日付/時間) |
| contact.time_format | 時間を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム時間形式) |
| contact.time_sheet_policy | 関連付けられた連絡先のタイムシートポリシーを含むレコードのSys_id。 データタイプ:文字列 テーブル:タイムシートポリシー [time_sheet_policy] |
| contact.time_zone | 連絡先が居住するタイムゾーン (カナダ/中央または米国/東部)。 データタイプ:文字列 最大長:40 |
| contact.title | マネージャー、ソフトウェア開発者、請負業者などの連絡先のビジネスタイトル。 データタイプ:文字列 最大長:60 |
| contact.user_name | 連絡先のユーザー ID。 データタイプ:文字列 最大長:40 |
| contact.vip | 関連付けられた連絡先が VIP ステータスかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| contact.web_service_access_only | 連絡先が Web 経由でのみサービスにアクセスできるかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| contact.zip | 連絡先の郵便番号。 データタイプ:文字列 最大長:40 |
| contact_local_time | 連絡先の現地時間。 データタイプ:文字列 最大長:70 |
| contact_time_zone | ケースに関連付けられた連絡先のタイムゾーン。 データタイプ:文字列 最大長:40 |
| contact_type | ケースが最初にレポートされた方法。 可能な値:
データタイプ:文字列 最大長:40 |
| contract | ケースに関連付けられた契約の sys_id。この契約には、ケースに関連付けられた会社に提供されるサポートのタイプに関する情報が含まれています。契約には会社と連絡先、および対象となる特定の資産が含まれる場合があります。1 つの契約に、複数のサービスエンタイトルメントと SLA を含めることもできます。 データタイプ:文字列 テーブル:契約 [ast_contract] |
| correlation_display | 相関ディスプレイ。 データタイプ:文字列 最大長:100 |
| correlation_id | 相関識別子。 データタイプ:文字列 最大長:100 |
| delivery_plan | このケースの親実行計画の sys_id。 データタイプ:文字列 テーブル:実行計画 [sc_cat_item_delivery_plan] |
| delivery_task | 実行計画タスクの sys_id。 データタイプ:文字列 テーブル:実行計画タスク [sc_cat_item_delivery_task] |
| 説明 | ケースに関連する問題の詳細な説明。 データタイプ:文字列 最大長:4,000 |
| due_date | ケースのクローズ予定日。 データタイプ:文字列 |
| エンタイトルメント | ケースに関連付けられたエンタイトルメントレコードの sys_id。エンタイトルメントによって、顧客が受けるサポートのタイプやサポートされるコミュニケーションチャネルが定義されます。エンタイトルメントは、製品、資産、アカウント、契約に関連付けることができます。 データタイプ:文字列 テーブル:エンタイトルメント [service_entitlement] |
| escalation | 現在のエスカレーションレベル。 可能な値:
データタイプ:数値 (整数) デフォルト:0 |
| expected_start | ケースの作業開始予定日時。 データタイプ:文字列 |
| first_response_time | ケースに対して最初のアクションが実行された日時。 データタイプ:文字列 |
| follow_the_sun | ケースをグローバルフォローアップに渡す必要があるかどうかを示すフラグ。 顧客が [優先度 1:重大] または [優先度 2 - 高] のケースにさらにコメントを入力した場合、またはケースが昇格された場合は、このフラグが自動的に true に設定されます。 可能な値:
データタイプ:ブーリアン デフォルト値:false |
| follow_up | 次のフォローアップアクションの日時。 データタイプ:文字列 |
| group_list | ケースに関連付けられたグループレコードの sys_id のリスト。 データタイプ:アレイ テーブル: Group [sys_user_group] |
| 影響 | 顧客への影響。 可能な値:
データタイプ:数値 (整数) デフォルト値:3 |
| ナレッジ | 指定された問題に利用可能なナレッジベース記事があるかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| location | 会社の場所を説明するレコードの sys_id。 データタイプ:文字列 テーブル:場所 [cmn_location] |
| made_sla | ケースが関連するサービスレベルアグリーメントに従って解決されたかどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン デフォルト:true |
| major_case_state | 重大なケースの現在のステータス。 可能な値:
データタイプ:文字列 最大長:40 |
| needs_attention | ケースに注意が必要かどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン デフォルト値:false |
| notes_to_comments | 解決メモをコメントに追加するかどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン |
| notify | 連絡先/コンシューマーに通知するために使用する方法。 可能な値:
データタイプ:数値 (整数) デフォルト値:1 |
| number | ケース番号。 データタイプ:文字列 最大長:40 |
| open_at | ケースがオープンされた日時。 データタイプ:文字列 |
| opened_by | ケースを最初にオープンしたユーザーの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| 順序 | ケースの順序。 データタイプ:数値 (整数) |
| parent | このケース (子) が関連付けられている親ケースの sys_id。 データタイプ:文字列 テーブル:タスク [task] |
| partner | ケースに関連付けられたパートナーの sys_id。 データタイプ:文字列 テーブル:アカウント [customer_account] |
| partner_contact | ケースに関連付けられたパートナーの連絡先の sys_id。 データタイプ:文字列 テーブル:連絡先 [customer_contact] |
| priority | ケースの優先度。 可能な値:
データタイプ:数値 (整数) デフォルト:4 |
| probable_cause | ケースに関連する問題の考えられる原因。 データタイプ:文字列 最大長:4,000 |
| 問題 | 顧客に発生している問題の sys_id。 データタイプ:文字列 テーブル:問題 [problem] |
| 製品 | ケースに関連付けられた資産の製品モデルの sys_id。モデルとは、「Apple Mac Book Pro」など、資産の特定のバージョンや構成のことです。 データタイプ:文字列 テーブル:製品モデル [cmdb_model] |
| reassignment_count | ケースを進行させる担当者にケースが再アサインされた回数。 データタイプ:数値 (整数) デフォルト:0 |
| recipient_list | このケースに関するコミュニケーションの受信者のリストを含むレコードの sys_id。 データタイプ:文字列 テーブル:受信者リスト [sn_publications_recipients_list] |
| rejection_goto | ケースが却下された場合に実行するタスクの sys_id。 データタイプ:文字列 テーブル:タスク [task] |
| resolution_code | ケースの解決ステータス (「Solved - サポートによって解決/ガイダンスの提供」など)。 データタイプ:文字列 最大長:40 |
| resolved_at | ケースが解決された日時。 データタイプ:文字列 |
| resolved_by | ケースを解決したユーザーの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| 結果 | 要求されたフィールドの値のリスト。 データタイプ:オブジェクトのアレイ |
| result.label | フィールド値の表示値。 データタイプ:文字列 |
| result.value | フィールド値。 データタイプ:文字列 |
| short_description | ケースの簡潔な説明。 データタイプ:文字列 最大長:160 |
| skills | ケースを完了するために必要なスキルの一意の識別子 (sys_id) のリスト。 データタイプ:文字列 テーブル:スキル [cmn_skill] |
| sla_due | 関連するサービスレベルアグリーメントに基づいてケースをクローズする必要がある日時。 データタイプ:文字列 |
| sn_app_cs_social_social_profile | Facebook、Twitter、YouTube などの特定のソーシャルメディアプロファイルの詳細。 データタイプ:オブジェクトのアレイ |
| sn_app_cs_social_social_profile.account | ソーシャルメディアプロファイルのアカウント情報を含むレコードの一意の識別子。アカウント [customer_account] テーブルにあります。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.channel | 関連するソーシャルメディアプロファイルチャネルの詳細。 データタイプ:オブジェクト |
| sn_app_cs_social_social_profile.channel.name | ソーシャルメディアチャネルの名前。 データタイプ:文字列 最大長:100 |
| sn_app_cs_social_social_profile.channel.sys_class_name | ソーシャルメディアチャネルレコードを含むテーブル。 データタイプ:文字列 最大長:80 |
| sn_app_cs_social_social_profile.channel.sys_created_by | ソーシャルメディアチャネルを作成した人物。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.channel.sys_created_on | ソーシャルメディアプロファイルが作成された日時。 データタイプ: 日付/時刻 最大長:40 |
| sn_app_cs_social_social_profile.channel.sys_id | 関連付けられたソーシャルメディアプロファイルチャネルの一意の識別子。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.channel.sys_mod_count | 関連付けられたソーシャルメディアプロファイルチャネルの情報が変更された回数。 データタイプ:整数 |
| sn_app_cs_social_social_profile.channel.sys_name | チャネルのシステム名。 データタイプ:文字列 最大長:255 |
| sn_app_cs_social_social_profile.channel.sys_package | プロファイルに関連付けられたパッケージに関する情報を含むレコードの一意の識別子。パッケージ [sys_package] テーブル。 データタイプ:参照 |
| sn_app_cs_social_social_profile.channel.sys_policy | システム保護ポリシー。 可能な値:
データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.channel.sys_scope | ソーシャルプロファイルの範囲に関する情報を含むレコードの一意の識別子。アプリケーション [sys_scope] テーブル。 データタイプ:参照 |
| sn_app_cs_social_social_profile.channel.sys_tags | チャネルに関連付けられたシステムタグ。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.channel.sys_update_name | ソーシャルメディアプロファイルチャネルを最後に更新したユーザーの名前。 データタイプ:文字列 最大長:250 |
| sn_app_cs_social_social_profile.channel.sys_updated_by | ソーシャルメディアプロファイルチャネルを最後に更新したユーザー。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.channel.sys_updated_on | ソーシャルメディアプロファイルチャネルが最後に更新された日時。 データタイプ: 日付/時刻 最大長:40 |
| sn_app_cs_social_social_profile.consumer | 企業/消費者間ケースの場合。ケースに関連付けられたコンシューマーの詳細。 データタイプ:オブジェクト |
| sn_app_cs_social_social_profile.consumer.active | コンシューマーがアクティブかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト:true |
| sn_app_cs_social_social_profile.consumer.business_phone | コンシューマーの勤務先電話番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.city | コンシューマーが居住する市区町村。 データタイプ:文字列 最大長:100 |
| sn_app_cs_social_social_profile.consumer.country | コンシューマーが居住する国。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.date_format | 日付を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム日付形式) |
| sn_app_cs_social_social_profile.consumer.email | コンシューマーのメールアドレス。 データタイプ:文字列 最大長:100 |
| sn_app_cs_social_social_profile.consumer.fax | コンシューマーのファックス番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.first_name | コンシューマーの名。 データタイプ:文字列 最大長:50 |
| sn_app_cs_social_social_profile.consumer.gender | コンシューマーの性別。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.home_phone | コンシューマーの自宅電話番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.household | 世帯の特性を説明するレコードの sys_id。 データタイプ:文字列 テーブル:世帯 [csm_household] |
| sn_app_cs_social_social_profile.consumer.last_name | コンシューマーの姓。 データタイプ:文字列 最大長:50 |
| sn_app_cs_social_social_profile.consumer.middle_name | コンシューマーのミドルネーム。 データタイプ:文字列 最大長:50 |
| sn_app_cs_social_social_profile.consumer.mobile_phone | コンシューマーの携帯電話番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.name | コンシューマーのフルネーム。 first_name+middle_name+last_name。 データタイプ:文字列 最大長:152 |
| sn_app_cs_social_social_profile.consumer.notes | コンシューマーに関するメモ。 データタイプ:文字列 最大長:4,000 |
| sn_app_cs_social_social_profile.consumer.notification | コンシューマーが通知を受信するかどうかを示します。 有効な値:
データタイプ:数値 (整数) 最大長:40 デフォルト値:2 |
| sn_app_cs_social_social_profile.consumer.number | コンシューマーに関連付けられた一意の番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.photo | コンシューマーの写真。 データタイプ:画像 |
| sn_app_cs_social_social_profile.consumer.preferred_language | コンシューマーのプライマリ言語。 データタイプ:文字列 最大長:3 |
| sn_app_cs_social_social_profile.consumer.prefix | Dr.、Mr.、Mrs.、Ms. などのコンシューマー名のプリフィックス データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.primary | これがプライマリコンシューマーであるかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| sn_app_cs_social_social_profile.consumer.state | コンシューマーが居住する都道府県。 データタイプ:文字列 最大長:100 |
| sn_app_cs_social_social_profile.consumer.street | コンシューマーの番地。 データタイプ:文字列 最大長:255 |
| sn_app_cs_social_social_profile.consumer.suffix | Jr.、Sr.、II などのコンシューマー名のサフィックス。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.consumer.sys_created_by | コンシューマーレコードを作成したユーザー。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.sys_created_on | コンシューマーレコードが最初に作成された日時。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.consumer.sys_domain | コンシューマー情報が存在する ServiceNow ドメイン。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.consumer.sys_id | コンシューマーの一意の識別子。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.consumer.sys_mod_count | 関連するコンシューマー情報が変更された回数。 データタイプ:数値 (整数) |
| sn_app_cs_social_social_profile.consumer.sys_tags | コンシューマーシステムタグ。 |
| sn_app_cs_social_social_profile.consumer.sys_updated_by | コンシューマー情報を最後に更新したユーザー。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.sys_updated_on | コンシューマー情報が最後に更新された日時。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.consumer.time_format | 時間を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム時間形式) |
| sn_app_cs_social_social_profile.consumer.time_zone | コンシューマーのタイムゾーン (カナダ/中央または米国/東部)。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.title | マネージャー、ソフトウェア開発者、請負業者などのコンシューマーのビジネスタイトル。 データタイプ:文字列 最大長:60 |
| sn_app_cs_social_social_profile.consumer.user | コンシューマーユーザーの sys_id。 データタイプ:文字列 テーブル:コンシューマーユーザー [csm_consumer_user] |
| sn_app_cs_social_social_profile.consumer.zip | コンシューマーの郵便番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact | 企業間ケースの場合。ケースに関連付けられた連絡先に属するソーシャルメディアプロファイルの詳細を含むレコードの一意の識別子。連絡先 [customer_contact] テーブルにあります。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.contact.account | 連絡先が関連付けられているアカウントレコードのSys_id。 データタイプ:文字列 テーブル:アカウント [customer_account] |
| sn_app_cs_social_social_profile.contact.active | システム内で連絡先がアクティブかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト:true |
| sn_app_cs_social_social_profile.contact.agent_status | エージェントのステータス。 可能な値:
データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.building | 連絡先が所在する建物を説明するレコードのSys_id。 データタイプ:文字列 テーブル:建物 [cmn_building] |
| sn_app_cs_social_social_profile.contact.calendar_integration | 連絡先が使用するカレンダーアプリケーション。 1:Outlook データタイプ:数値 (整数) デフォルト値:1 |
| sn_app_cs_social_social_profile.contact.city | 連絡先が居住する市区町村。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.company | 連絡先が関連付けられている会社レコードのSys_id。 データタイプ:文字列 テーブル:会社 [core_company] |
| sn_app_cs_social_social_profile.contact.cost_center | 連絡先に関連付けられたコストセンターのSys_id。 データタイプ:文字列 テーブル:コストセンター [cmn_cost_center] |
| sn_app_cs_social_social_profile.contact.country | 連絡先が居住する国の国コード。 データタイプ:文字列 最大長:3 |
| sn_app_cs_social_social_profile.contact.date_format | 連絡先に日付を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム日付形式) |
| sn_app_cs_social_social_profile.contact.default_perspective | 連絡先のデフォルトの視点の sys_id。 データタイプ:文字列 テーブル:メニューリスト [sys_perspective] |
| sn_app_cs_social_social_profile.contact.department | 連絡先に関連付けられた部門の sys_id。 データタイプ:文字列 テーブル:部門 [cmn_department] |
| sn_app_cs_social_social_profile.contact.edu_status | 関連付けられた連絡先の学歴ステータス。 データタイプ:文字列 最大長:40 デフォルト:faculty |
| sn_app_cs_social_social_profile.contact.email | 連絡先のメールアドレス。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.contact.employee_number | 連絡先の従業員番号。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.contact.enable_multifactor_authn | 連絡先がサービスポータルにログインするためにマルチファクター認証が必要かどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| sn_app_cs_social_social_profile.contact.failed_attempts | 失敗したログイン試行回数。 データタイプ:数値 (整数) |
| sn_app_cs_social_social_profile.contact.first_name | 連絡先の名。 データタイプ:文字列 最大長:50 |
| sn_app_cs_social_social_profile.contact.gender | 連絡先の性別。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.geolocation_tracked | 連絡先の場所が位置情報追跡によって取得されたかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| sn_app_cs_social_social_profile.contact.home_phone | 連絡先の自宅電話番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.internal_itegration_user | 連絡先が内部統合ユーザーかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| sn_app_cs_social_social_profile.contact.introduction | 前書き データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.last_login | 連絡先が最後にシステムにログインした日付。 データタイプ:文字列 (日付) |
| sn_app_cs_social_social_profile.contact.last_login_device | コンシューマーが最後にシステムにログインしたときに使用したデバイス。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.last_login_time | 連絡先がシステムにログインした日時。 データタイプ:文字列 (日付/時間) |
| sn_app_cs_social_social_profile.contact.last_name | 連絡先の姓。 データタイプ:文字列 最大長:50 |
| sn_app_cs_social_social_profile.contact.last_position_update | 位置が最後に更新された日時。 データタイプ:文字列 (日付/時間) |
| sn_app_cs_social_social_profile.contact.latitude | 連絡先の緯度座標。 データタイプ:数値 (浮動小数点) 最大長:40 |
| sn_app_cs_social_social_profile.contact.ldap_server | 連絡先がシステムへの最終ログインに使用する LDAP サーバーのSys_id。 データタイプ:文字列 テーブル:LDAP サーバー [ldap_server_config] |
| sn_app_cs_social_social_profile.contact.location | 連絡先の場所を説明するレコードのSys_id データタイプ:文字列 テーブル:場所 [cmn_location] |
| sn_app_cs_social_social_profile.contact.locked_out | 連絡先がロックアウトされているかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| sn_app_cs_social_social_profile.contact.longitude | 連絡先の経度座標。 データタイプ:数値 (浮動小数点) 最大長:40 |
| sn_app_cs_social_social_profile.contact.manager | 連絡先の直属の上司を説明するレコードのSys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| sn_app_cs_social_social_profile.contact.middle_name | 連絡先のミドルネーム。 データタイプ:数値 (浮動小数点) 最大長:50 |
| sn_app_cs_social_social_profile.contact.mobile_phone | 連絡先の携帯電話番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.name | 連絡先のフルネーム。 データタイプ:文字列 最大長:151 |
| sn_app_cs_social_social_profile.contact.notification | 連絡先が通知を受信するかどうかを示します。 有効な値:
データタイプ:数値 (整数) デフォルト値:2 |
| sn_app_cs_social_social_profile.contact.on_schedule | ディスパッチされたサービス担当者の適時性を示します。 有効な値:
データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.phone | 連絡先の勤務先電話番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.photo | 連絡先の写真画像。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.contact.preferred_language | 連絡先のプライマリ言語の国コード。 データタイプ:文字列 最大長:3 |
| sn_app_cs_social_social_profile.contact.roles | 連絡先に関連付けられているユーザーロールのリスト。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.schedule | 関連付けられた連絡先の作業スケジュールを説明するレコードのSys_id。 データタイプ:文字列 テーブル:スケジュール [cmn_schedule] |
| sn_app_cs_social_social_profile.contact.source | 連絡先のソース。 データタイプ:文字列 最大長:255 |
| sn_app_cs_social_social_profile.contact.state | 連絡先が居住する都道府県。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.street | 連絡先の番地。 データタイプ:文字列 最大長:255 |
| sn_app_cs_social_social_profile.contact.sys_class_name | 連絡先レコードを含むテーブル。 データタイプ:文字列 最大長:80 |
| sn_app_cs_social_social_profile.contact.sys_created_by | 関連付けられた連絡先レコードを最初に作成したユーザー。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.sys_created_on | 関連付けられた連絡先が最初に作成された日時。 データタイプ:文字列 (日付/時間) |
| sn_app_cs_social_social_profile.contact.sys_domain | 関連付けられた連絡先レコードの ServiceNow インスタンスドメイン。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.contact.sys_domain_path | 連絡先レコードのドメインパス。 データタイプ:文字列 最大長:255 デフォルト:/ (global) |
| sn_app_cs_social_social_profile.contact.sys_id | 関連付けられた連絡先レコードの一意の識別子。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.contact.sys_mod_count | 関連付けられた連絡先レコードが変更された回数。 データタイプ:数値 (整数) |
| sn_app_cs_social_social_profile.contact.sys_tags | 連絡先システムタグ。 |
| sn_app_cs_social_social_profile.contact.sys_updated_by | 関連付けられた連絡先情報を最後に更新したユーザー。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.sys_updated_on | 関連付けられた連絡先情報が更新された日時。 データタイプ:文字列 (日付/時間) |
| sn_app_cs_social_social_profile.contact.time_format | 時間を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム時間形式) |
| sn_app_cs_social_social_profile.contact.time_sheet_policy | 関連付けられた連絡先のタイムシートポリシーを含むレコードのSys_id。 データタイプ:文字列 テーブル:タイムシートポリシー [time_sheet_policy] |
| sn_app_cs_social_social_profile.contact.time_zone | 連絡先が居住するタイムゾーン (カナダ/中央または米国/東部)。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.title | マネージャー、ソフトウェア開発者、請負業者などの連絡先のビジネスタイトル。 データタイプ:文字列 最大長:60 |
| sn_app_cs_social_social_profile.contact.user_name | 連絡先のユーザー ID。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.vip | 関連付けられた連絡先が VIP ステータスかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| sn_app_cs_social_social_profile.contact.web_service_access_only | 連絡先が Web 経由でのみサービスにアクセスできるかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| sn_app_cs_social_social_profile.contact.zip | 連絡先の郵便番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.created_on | 関連するソーシャルメディアプロファイルが最初に作成された日時。 |
| sn_app_cs_social_social_profile.profile | ソーシャルプロファイル。 データタイプ:文字列 最大長:255 |
| sn_app_cs_social_social_profile.profile_url | ソーシャルメディアプロファイルへのアクセスに使用する URL。 データタイプ:文字列 最大長:1,024 |
| sn_app_cs_social_social_profile.social_id | 関連付けられたソーシャルメディアアカウントの一意のソーシャルメディアアカウントプロバイダー識別子。 データタイプ:文字列 最大長:100 |
| sn_app_cs_social_social_profile.source | ソーシャルプロファイルのソース。 データタイプ:文字列 最大長:255 |
| sn_app_cs_social_social_profile.sys_created_by | ソーシャルメディアプロファイルを最初に作成したユーザー。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.sys_created_on | ソーシャルメディアプロファイルが最初に作成された日時。 データタイプ:文字列 (日付/時間) |
| sn_app_cs_social_social_profile.sys_id | ソーシャルメディアプロファイルの一意の識別子。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.sys_mod_count | 関連付けられたソーシャルメディアプロファイルの情報が変更された回数。 データタイプ:数値 (整数) |
| sn_app_cs_social_social_profile.sys_tags | プロファイルシステムタグ。 |
| sn_app_cs_social_social_profile.sys_updated_by | ソーシャルメディアプロファイルを最初に作成したユーザー。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.sys_updated_on | ソーシャルメディアプロファイルを最初に作成したユーザー。 データタイプ:文字列 最大長:40 |
| state | ケースの現在のステータス。 可能な値:
データタイプ:数値 (整数) デフォルト値:1 |
| subcategory | ケースのサブカテゴリ。 可能な値: 0:質問データタイプ:数値 (整数) デフォルト:0 |
| support_manager | ケースにアサインされた CSM マネージャーの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| sync_driver | ドライバーの同期があるかどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン |
| sys_class_name | ケースレコードを含むテーブル。 データタイプ:文字列 最大長:80 |
| sys_created_by | ケースを最初にオープンしたユーザー。 データタイプ:文字列 最大長:40 |
| sys_created_on | ケースが最初に作成された日時。 データタイプ:文字列 |
| sys_domain | ケースに関連付けられたドメイン。 データタイプ:文字列 最大長:32 デフォルト:global |
| sys_domain_path | ドメインパス。 データタイプ:文字列 最大長:255 デフォルト:/ |
| sys_id | ケースの一意の識別子。 データタイプ:文字列 最大長:32 |
| sys_mod_count | ケースが最初に作成されてからの更新回数。 データタイプ:数値 (整数) |
| sys_tags | システムタグ。 |
| sys_updated_by | ケースを最後に更新したユーザー。 データタイプ:文字列 最大長:40 |
| sys_updated_on | ケースが最後に更新された日時。 データタイプ:文字列 |
| time_worked | ケースの合計作業時間。 データタイプ:文字列 |
| upon_approval | ケースが承認された場合に実行するアクション。 可能な値:
データタイプ:文字列 最大長:40 デフォルト:proceed |
| upon_reject | ケースが却下された場合に実行するアクション。 可能な値:
データタイプ:文字列 最大長:40 デフォルト:cancel |
| urgency | ケースの緊急度。 可能な値:
データタイプ:数値 (整数) デフォルト値:3 |
| user_input | 追加のユーザー入力。 データタイプ:文字列 最大長:4,000 |
| variable_pool | 変数のグループ化。 |
| variables | ケースに関連付けられた変数の名前と値のペア。 データタイプ:文字列 最大長:40 |
| watch_list | 追加のコメントが追加された場合、またはケースのステータスが「解決済み」または「クローズ済み」に変更された場合に、このケースに関する通知を受信するユーザーの sys_id のリスト。 データタイプ:アレイ テーブル:ユーザー [sys_user] |
| wf_activity | ケースに関連付けられたワークフローアクティビティレコードの sys_id。 データタイプ:文字列 テーブル:ワークフローアクティビティ [wf_activity] |
| work_end | ケースの作業が終了した日時。 データタイプ:文字列 |
| work_notes | ケースの解決方法に関する情報、またはケースの解決手順。 データタイプ:文字列 最大長:4,000 |
| work_notes_list | 作業メモが追加されたときに、このケースについての通知を受け取る内部ユーザーの sys_id のリスト。 データタイプ:アレイ テーブル:ユーザー [sys_user] |
| work_start | ケースの作業が開始された日時。 データタイプ:文字列 |
cURL 要求
特定のアカウントに対してリストされている 3 番目と 4 番目の CSM ケースを取得します。
curl "https://instance.servicenow.com/api/sn_customerservice/case?sysparm_query=account=86837a386f0331003b3c498f5d3ee4ca&sysparm_limit=2&sysparm_offset=2" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
応答には 2 つのケースが表示されます。
{
"result": [{
"parent": "",
"caused_by": "",
"watch_list": "",
"active_escalation": "",
"upon_reject": "cancel",
"sys_updated_on": "2017-06-17 16:37:13",
"support_manager": "",
"approval_history": "",
"skills": "a6d64b11d772120058c92cf65e610357,9b178b11d772120058c92cf65e610382,1c76ec15d703120058c92cf65e61034a",
"number": "CS0000009",
"problem": "",
"state": "18",
"case": "Advanced and large routers making noiseCS0000009",
"sys_created_by": "alex linde",
"knowledge": "false",
"order": "",
"cmdb_ci": "",
"delivery_plan": "",
"impact": "3",
"contract": "",
"active": "true",
"work_notes_list": "",
"auto_created_case": "false",
"priority": "3",
"sys_domain_path": "/",
"rejection_goto": "",
"first_response_time": "",
"business_duration": "",
"group_list": "",
"child_case_creation_progress": "false",
"sync_driver": "false",
"approval_set": "",
"wf_activity": "",
"short_description": "Advanced and large routers making noise",
"correlation_display": "",
"delivery_task": "",
"work_start": "",
"recipient_list": "",
"additional_assignee_list": "",
"notify": "1",
"sys_class_name": "sn_customerservice_case",
"closed_by": "",
"follow_up": "",
"contact_local_time": "",
"sn_app_cs_social_social_profile": "",
"reassignment_count": "1",
"contact_time_zone": "",
"notes_to_comments": "false",
"assigned_to": "85453c616fc331003b3c498f5d3ee4fa",
"product": "5f5fbcc3c0a8010e00f3b27814f3b96b",
"variables": "",
"variable_pool": "",
"hierarchical_variables": "variable_pool",
"sla_due": "",
"change": "",
"comments_and_work_notes": "",
"partner": "",
"escalation": "0",
"upon_approval": "proceed",
"partner_contact": "",
"correlation_id": "",
"asset": "a8fb6024d7700200e5982cf65e61034d",
"made_sla": "true",
"resolved_by": "",
"sys_updated_by": "admin",
"opened_by": "60beb5e7d7600200e5982cf65e6103ad",
"user_input": "",
"sys_created_on": "2016-09-19 16:49:18",
"contact": {
"country": "",
"calendar_integration": "1",
"last_position_update": "",
"last_login_time": "2018-05-10 19:50:26",
"last_login_device": "0:0:0:0:0:0:0:1%0",
"source": "",
"sys_updated_on": "2018-02-16 21:30:03",
"building": "",
"web_service_access_only": "false",
"notification": "1",
"sys_updated_by": "venki",
"enable_multifactor_authn": "false",
"sys_created_on": "2018-02-16 21:29:11",
"sys_domain": "global",
"agent_status": "",
"state": "",
"vip": "false",
"sys_created_by": "venki",
"longitude": "",
"zip": "",
"home_phone": "",
"time_format": "",
"last_login": "",
"default_perspective": "",
"geolocation_tracked": "false",
"active": "true",
"time_sheet_policy": "",
"sys_domain_path": "/",
"phone": "(626) 722-6969",
"cost_center": "",
"name": "Julie Lewis",
"employee_number": "",
"gender": "",
"city": "",
"user_name": "julie.lewis",
"failed_attempts": "",
"edu_status": "faculty",
"latitude": "",
"roles": "",
"title": "Operations Manager",
"sys_class_name": "customer_contact",
"sys_id": "4d147a386f0331003b3c498f5d3ee437",
"internal_integration_user": "false",
"ldap_server": "",
"mobile_phone": "",
"street": "",
"company": "86837a386f0331003b3c498f5d3ee4ca",
"department": "",
"first_name": "Julie",
"preferred_language": "en",
"introduction": "",
"email": "julie.lewis@mailinator.com",
"manager": "",
"locked_out": "false",
"sys_mod_count": "1",
"last_name": "Lewis",
"photo": "",
"sys_tags": "",
"middle_name": "",
"time_zone": "",
"schedule": "",
"on_schedule": "",
"date_format": "",
"location": "",
"account": "86837a386f0331003b3c498f5d3ee4ca"
},
"sys_domain": "global",
"closed_at": "",
"follow_the_sun": "false",
"entitlement": "",
"business_service": "",
"business_impact": "",
"time_worked": "",
"expected_start": "",
"opened_at": "2016-09-19 16:49:18",
"work_end": "",
"resolved_at": "",
"case_report": "",
"subcategory": "0",
"work_notes": "",
"assignment_group": "6a42f4616fc331003b3c498f5d3ee46f",
"cause": "",
"description": "",
"calendar_duration": "",
"close_notes": "",
"sys_id": "dccc6024d7700200e5982cf65e6103e5",
"contact_type": "web",
"resolution_code": "",
"probable_cause": "",
"urgency": "3",
"company": "",
"major_case_state": "",
"consumer": "",
"activity_due": "",
"comments": "",
"approval": "not requested",
"due_date": "",
"sys_mod_count": "5",
"sys_tags": "",
"active_account_escalation": "",
"location": "",
"category": "1",
"account": {
"banner_image_light": "",
"country": "USA",
"parent": "",
"notes": "",
"stock_symbol": "",
"discount": "",
"active_escalation": "",
"sys_updated_on": "2019-01-03 19:37:35",
"apple_icon": "",
"number": "ACCT0000001",
"sys_updated_by": "admin",
"fiscal_year": "",
"sys_created_on": "2018-02-20 21:29:16",
"contact": "4d147a386f0331003b3c498f5d3ee437",
"stock_price": "",
"state": "",
"banner_image": "",
"sys_created_by": "venki",
"longitude": "-122.4005464",
"zip": "94103",
"profits": "0",
"phone": "(626) 722-6999",
"fax_phone": "",
"name": "Boxeo",
"banner_text": "",
"account_code": "~~~~1",
"primary": "false",
"city": "San Francisco",
"latitude": "37.7838391",
"sys_class_name": "customer_account",
"manufacturer": "false",
"account_parent": "",
"sys_id": "86837a386f0331003b3c498f5d3ee4ca",
"market_cap": "0",
"num_employees": "",
"rank_tier": "",
"street": "747 Howard St",
"vendor": "false",
"lat_long_error": "",
"theme": "",
"vendor_type": "",
"website": "www.boxeo.com",
"revenue_per_year": "0",
"publicly_traded": "false",
"sys_mod_count": "9",
"sys_tags": "",
"partner": "false",
"registration_code": "BOXEO",
"vendor_manager": "",
"account_path": "~~~~1",
"primary_contact": "4d147a386f0331003b3c498f5d3ee437",
"customer": "true"
}
}, {
"parent": "",
"caused_by": "",
"watch_list": "",
"active_escalation": "",
"upon_reject": "cancel",
"sys_updated_on": "2019-01-15 23:28:00",
"support_manager": "",
"approval_history": "",
"skills": "a6d64b11d772120058c92cf65e610357,9b178b11d772120058c92cf65e610382,1c76ec15d703120058c92cf65e61034a",
"number": "CS0000005",
"problem": "",
"state": "6",
"case": "Urgent issue, need help ...CS0000005",
"sys_created_by": "admin",
"knowledge": "false",
"order": "",
"cmdb_ci": "",
"delivery_plan": "",
"impact": "",
"contract": "495e16b96f0731003b3c498f5d3ee4af",
"active": "true",
"work_notes_list": "",
"auto_created_case": "false",
"priority": "1",
"sys_domain_path": "/",
"rejection_goto": "",
"first_response_time": "",
"business_duration": "",
"group_list": "",
"child_case_creation_progress": "false",
"sync_driver": "false",
"approval_set": "",
"wf_activity": "",
"short_description": "Urgent issue, need help ...",
"correlation_display": "",
"delivery_task": "",
"work_start": "",
"recipient_list": "",
"additional_assignee_list": "",
"notify": "",
"sys_class_name": "sn_customerservice_case",
"closed_by": "",
"follow_up": "",
"contact_local_time": "",
"sn_app_cs_social_social_profile": "",
"reassignment_count": "",
"contact_time_zone": "",
"notes_to_comments": "false",
"assigned_to": "85453c616fc331003b3c498f5d3ee4fa",
"product": "9068b0a16fc331003b3c498f5d3ee438",
"variables": "",
"variable_pool": "",
"hierarchical_variables": "variable_pool",
"sla_due": "",
"change": "",
"comments_and_work_notes": "",
"partner": "",
"escalation": "",
"upon_approval": "proceed",
"partner_contact": "",
"correlation_id": "",
"asset": "b8defca16fc331003b3c498f5d3ee4e7",
"made_sla": "false",
"resolved_by": "",
"sys_updated_by": "jodi.seals",
"opened_by": "ddce70866f9331003b3c498f5d3ee417",
"user_input": "",
"sys_created_on": "2019-01-02 20:00:00",
"contact": {
"country": "",
"calendar_integration": "1",
"last_position_update": "",
"last_login_time": "2018-03-10 21:48:11",
"last_login_device": "",
"source": "",
"sys_updated_on": "2019-01-03 05:49:34",
"building": "",
"web_service_access_only": "false",
"notification": "2",
"sys_updated_by": "system",
"enable_multifactor_authn": "false",
"sys_created_on": "2018-03-04 20:26:32",
"sys_domain": "global",
"agent_status": "",
"state": "",
"vip": "false",
"sys_created_by": "admin",
"longitude": "",
"zip": "",
"home_phone": "",
"time_format": "",
"last_login": "",
"default_perspective": "",
"geolocation_tracked": "false",
"active": "true",
"time_sheet_policy": "",
"sys_domain_path": "/",
"phone": "+1 858 287 7834",
"cost_center": "",
"name": "George Warren",
"employee_number": "",
"gender": "",
"city": "",
"user_name": "george.warren",
"failed_attempts": "",
"edu_status": "",
"latitude": "",
"roles": "",
"title": "Network Administrator",
"sys_class_name": "customer_contact",
"sys_id": "ddce70866f9331003b3c498f5d3ee417",
"internal_integration_user": "false",
"ldap_server": "",
"mobile_phone": "+1 858 867 7857",
"street": "",
"company": "86837a386f0331003b3c498f5d3ee4ca",
"department": "",
"first_name": "George",
"preferred_language": "",
"introduction": "",
"email": "geo.warren@mailinator.com",
"manager": "",
"locked_out": "false",
"sys_mod_count": "3",
"last_name": "Warren",
"photo": "",
"sys_tags": "",
"middle_name": "",
"time_zone": "",
"schedule": "",
"on_schedule": "",
"date_format": "",
"location": "25ab8e460a0a0bb300857304ff811af5",
"account": "86837a386f0331003b3c498f5d3ee4ca"
},
"sys_domain": "global",
"closed_at": "",
"follow_the_sun": "false",
"entitlement": "1eb7893a6f1b31003b3c498f5d3ee4dd",
"business_service": "",
"business_impact": "",
"time_worked": "",
"expected_start": "",
"opened_at": "2019-01-02 20:00:00",
"work_end": "",
"resolved_at": "",
"case_report": "",
"subcategory": "0",
"work_notes": "",
"assignment_group": "0df0c400c322310015519f2974d3ae23",
"cause": "",
"description": "",
"calendar_duration": "",
"close_notes": "",
"sys_id": "cf866683c3033100b12d9f2974d3ae1f",
"contact_type": "web",
"resolution_code": "",
"probable_cause": "",
"urgency": "3",
"company": "",
"major_case_state": "",
"consumer": "",
"activity_due": "",
"comments": "",
"approval": "",
"due_date": "2016-08-04 20:36:23",
"sys_mod_count": "0",
"sys_tags": "",
"active_account_escalation": "",
"location": "",
"category": "1",
"account": {
"banner_image_light": "",
"country": "USA",
"parent": "",
"notes": "",
"stock_symbol": "",
"discount": "",
"active_escalation": "",
"sys_updated_on": "2019-01-03 19:37:35",
"apple_icon": "",
"number": "ACCT0000001",
"sys_updated_by": "admin",
"fiscal_year": "",
"sys_created_on": "2018-02-20 21:29:16",
"contact": "4d147a386f0331003b3c498f5d3ee437",
"stock_price": "",
"state": "",
"banner_image": "",
"sys_created_by": "venki",
"longitude": "-122.4005464",
"zip": "94103",
"profits": "0",
"phone": "(626) 722-6999",
"fax_phone": "",
"name": "Boxeo",
"banner_text": "",
"account_code": "~~~~1",
"primary": "false",
"city": "San Francisco",
"latitude": "37.7838391",
"sys_class_name": "customer_account",
"manufacturer": "false",
"account_parent": "",
"sys_id": "86837a386f0331003b3c498f5d3ee4ca",
"market_cap": "0",
"num_employees": "",
"rank_tier": "",
"street": "747 Howard St",
"vendor": "false",
"lat_long_error": "",
"theme": "",
"vendor_type": "",
"website": "www.boxeo.com",
"revenue_per_year": "0",
"publicly_traded": "false",
"sys_mod_count": "9",
"sys_tags": "",
"partner": "false",
"registration_code": "BOXEO",
"vendor_manager": "",
"account_path": "~~~~1",
"primary_contact": "4d147a386f0331003b3c498f5d3ee437",
"customer": "true"
}
}]
}
ケース - POST /sn_customerservice/case
新しい カスタマーサービス管理 (CSM) ケースを作成します。
このエンドポイントを使用するには、csm_ws_integration、sn_customerservice.customer、または sn_customerservice.consumer ロールが必要です。
企業間 (B2B) と企業 - 消費者間 (B2C) 環境のどちらで作業しているか、または注文または製品のケースを作成しているかに応じて、さまざまなタイプのケースを作成できます。
- social_channel
- social_handle
- social_handle_type
- social_handle_url
- social_post_url
要求本文パラメーターはすべてオプションです。一部のパラメーターは、いずれかの環境 (B2B または B2C) でのみ有効であり、要求本文パラメーターの説明にそのように記載されています。連絡先を指定すると、アカウント、ケースレポート、契約、およびエンタイトルメントパラメーターは、連絡先/アカウントレコードで定義された値にデフォルト設定されます。アカウントを指定すると、ケースレポート、契約、およびエンタイトルメントパラメーターは、アカウントレコードで定義された値にデフォルト設定されます (渡されたパラメーターの方が優先される場合を除く)。エンドポイントにパラメーターを渡さない場合は、デフォルトの情報 (以下のテーブルで定義) とインスタンスで生成された値 (sys_*) のみでケースレコードが作成されます。他のパラメーターはすべて、null 値と同等に設定されます。以下で定義するパラメーターのリスト (ベースシステムにあるパラメーターを定義するもの) に加えて、エンドポイントでは、インスタンスで構成されたカスタムケースフィールドと追加のケースフィールドも受け入れます。これらの要素の詳細については、特定のテーブル定義[].
URL 形式
バージョニングされた URL:/api/sn_customerservice/{api_version}/case
デフォルトの URL:/api/sn_customerservice/case
サポートされている要求パラメーター
| 名前 | 説明 |
|---|---|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ:文字列 |
| 名前 | 説明 |
|---|---|
| なし |
| 要素 | 説明 |
|---|---|
| account | ケースに関連付けられたアカウントの sys_id。 データタイプ:文字列 デフォルト: contact を指定すると、連絡先レコードで指定されたアカウントがデフォルトになります。 テーブル:アカウント [customer_account] |
| アクティブ | ケースがオープンかアクティブかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト:true |
| active_account_escalation | ケースに関連付けられたアクティブなアカウントエスカレーションの sys_id。 データタイプ:文字列 テーブル:エスカレーション [sn_customerservice_escalation] |
| active_escalation | ケースに関連付けられたアクティブなエスカレーションレコードのSys_id。 データタイプ:文字列 テーブル:エスカレーション [sn_customerservice_escalation] |
| activity_due | 関連付けられたケースの完了予定日。 データタイプ:文字列 |
| additional_assignee_list | アカウントにアサインされた追加のユーザー (プライマリアサイニーを除く) のsys_idsのリスト。 データタイプ:アレイ 最大:4,000 テーブル:ユーザー [sys_user] |
| approval | 必要な承認のタイプを説明する文字列。 可能な値:
データタイプ:文字列 最大文字数:40 デフォルト:not requested |
| assigned_to |
ケースにアサインされたユーザーの sys_id。
テーブル:ユーザー [sys_user] データタイプ:文字列 |
| assignment_group | ケースにアサインされたカスタマーサービスエージェントグループの sys_id。 データタイプ:文字列 テーブル: Group [sys_user_group] |
| business_duration | ケースの完了までにかかったカレンダー上の作業時間、作業日数、および作業週数。 データタイプ:文字列 |
| business_impact | 関連する顧客に対する問題の影響。 データタイプ:文字列 最大文字数:4,000 |
| business_service | ケースに関連付けられたサービスレコードの sys_id。 データタイプ:文字列 テーブル:サービス [cmdb_ci_service] |
| category | ケースカテゴリ。 可能な値:
データタイプ:数値 (整数) デフォルト値:1 |
| cause | 問題の原因に関する詳細。 データタイプ:文字列 最大長:4,000 |
| caused_by | ケースが作成される原因となった変更要求の sys_id。 データタイプ:文字列 テーブル:変更要求 [change_request] |
| 変更 | ケースが作成される原因となった変更要求の sys_id。 データタイプ:文字列 テーブル:変更要求 [change_request] |
| child_case_creation_progress | ケースが重大なケースから作成された子ケースであるかどうかを示すフラグ。 可能な値:
データタイプ:ブール |
| close_notes | ケースがクローズされたときに作成されたメモ。 データタイプ:文字列 最大長:4,000 |
| closed_at | ケースがクローズされた日時。 データタイプ:文字列 |
| closed_by | ケースをクローズしたユーザーの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| cmdb_ci | ケースに関連付けられた構成アイテムの sys_id。 データタイプ:文字列 テーブル:構成アイテム [cmdb_ci] |
| コメント | ケースに関する追加のコメント。 データタイプ:文字列 最大長:4,000 |
| company | ケースに関連付けられた会社の sys_id。 データタイプ:文字列 テーブル:会社 [core_company] |
| consumer | 企業/消費者間ケースのみ。このケースに関して連絡先となる人のSys_id。 データタイプ:文字列 テーブル:コンシューマー [csm_consumer] |
| 連絡先 | 企業間ベースのケースのみ。このケースに関する連絡担当者の sys_id。 データタイプ:文字列 テーブル:連絡先 [customer_contact] |
| contact_time_zone | ケースに関連付けられた連絡先のタイムゾーン。 データタイプ:文字列 最大長:40 |
| contact_type | ケースが最初にレポートされた方法。 可能な値:
データタイプ:文字列 最大長:40 |
| contract | ケースに関連付けられた契約の sys_id。この契約には、ケースに関連付けられた会社に提供されるサポートのタイプに関する情報が含まれています。契約には会社と連絡先、および対象となる特定の資産が含まれる場合があります。1 つの契約に、複数のサービスエンタイトルメントと SLA を含めることもできます。 データタイプ:文字列 テーブル:契約 [ast_contract] |
| correlation_display | 相関ディスプレイ。 データタイプ:文字列 最大長:100 |
| correlation_id | 相関識別子。 データタイプ:文字列 最大長:100 |
| delivery_plan | このケースの親実行計画の sys_id。 データタイプ:文字列 テーブル:実行計画 [sc_cat_item_delivery_plan] |
| delivery_task | 実行計画タスクの sys_id。 データタイプ:文字列 テーブル:実行計画タスク [sc_cat_item_delivery_task] |
| 説明 | ケースに関連する問題の詳細な説明。 データタイプ:文字列 最大長:4,000 |
| due_date | ケースのクローズ予定日。 データタイプ:文字列 |
| エンタイトルメント | ケースに関連付けられたエンタイトルメントレコードの sys_id。エンタイトルメントによって、顧客が受けるサポートのタイプやサポートされるコミュニケーションチャネルが定義されます。エンタイトルメントは、製品、資産、アカウント、契約に関連付けることができます。 データタイプ:文字列 テーブル:エンタイトルメント [service_entitlement] |
| escalation | 現在のエスカレーションレベル。 可能な値:
データタイプ:数値 (整数) デフォルト:0 |
| expected_start | ケースの作業開始予定日時。 データタイプ:文字列 |
| first_response_time | ケースに対して最初のアクションが実行された日時。 データタイプ:文字列 |
| follow_the_sun | ケースをグローバルフォローアップに渡す必要があるかどうかを示すフラグ。 顧客が [優先度 1:重大] または [優先度 2 - 高] のケースにさらにコメントを入力した場合、またはケースが昇格された場合は、このフラグが自動的に true に設定されます。 可能な値:
データタイプ:ブーリアン デフォルト値:false |
| group_list | ケースに関連付けられたグループレコードの sys_id のリスト。 データタイプ:アレイ テーブル: Group [sys_user_group] |
| 影響 | 顧客への影響。 可能な値:
データタイプ:数値 (整数) デフォルト値:3 |
| ナレッジ | 指定された問題に利用可能なナレッジベース記事があるかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| location | 会社の場所を説明するレコードの sys_id。 データタイプ:文字列 テーブル:場所 [cmn_location] |
| made_sla | ケースが関連するサービスレベルアグリーメントに従って解決されたかどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン デフォルト:true |
| major_case_state | 重大なケースの現在のステータス。 可能な値:
データタイプ:文字列 最大長:40 |
| notes_to_comments | 解決メモをコメントに追加するかどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン |
| notify | 連絡先/コンシューマーに通知するために使用する方法。 可能な値:
データタイプ:数値 (整数) デフォルト値:1 |
| number | ケース番号。 データタイプ:文字列 最大長:40 |
| open_at | ケースがオープンされた日時。 データタイプ:文字列 |
| opened_by | ケースを最初にオープンしたユーザーの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| 順序 | ケースの順序。 データタイプ:数値 (整数) |
| parent | このケース (子) が関連付けられている親ケースの sys_id。 データタイプ:文字列 テーブル:タスク [task] |
| partner | ケースに関連付けられたパートナーの sys_id。 データタイプ:文字列 テーブル:アカウント [customer_account] |
| partner_contact | ケースに関連付けられたパートナーの連絡先の sys_id。 データタイプ:文字列 テーブル:連絡先 [customer_contact] |
| priority | ケースの優先度。 可能な値:
データタイプ:数値 (整数) デフォルト:4 |
| probable_cause | ケースに関連する問題の考えられる原因。 データタイプ:文字列 最大長:4,000 |
| 問題 | 顧客に発生している問題の sys_id。 データタイプ:文字列 テーブル:問題 [problem] |
| 製品 | ケースに関連付けられた資産の製品モデルの sys_id。モデルとは、「Apple Mac Book Pro」など、資産の特定のバージョンや構成のことです。 データタイプ:文字列 テーブル:製品モデル [cmdb_model] |
| reassignment_count | ケースを進行させる担当者にケースが再アサインされた回数。 データタイプ:数値 (整数) デフォルト:0 |
| recipient_list | このケースに関するコミュニケーションの受信者のリストを含むレコードの sys_id。 データタイプ:文字列 テーブル:受信者リスト [sn_publications_recipients_list] |
| rejection_goto | ケースが却下された場合に実行するタスクの sys_id。 データタイプ:文字列 テーブル:タスク [task] |
| resolution_code | ケースの解決ステータス (「Solved - サポートによって解決/ガイダンスの提供」など)。 データタイプ:文字列 最大長:40 |
| resolved_at | ケースが解決された日時。 データタイプ:文字列 |
| resolved_by | ケースを解決したユーザーの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| short_description | ケースの簡潔な説明。 データタイプ:文字列 最大長:160 |
| skills | ケースを完了するために必要なスキルの一意の識別子 (sys_id) のリスト。 データタイプ:文字列 テーブル:スキル [cmn_skill] |
| sla_due | 関連するサービスレベルアグリーメントに基づいてケースをクローズする必要がある日時。 データタイプ:文字列 |
| social_channel | ソーシャルメディアチャネルのタイプ (Twitter、Facebook、Instagram など)。 データタイプ:文字列 |
| social_handle | チャネルのユーザーハンドル。 データタイプ:文字列 |
| social_handle_type | ソーシャルメディアプロファイルを関連付けるケースのタイプ。 有効な値:
データタイプ:文字列 |
| social_handle_url | ユーザーのソーシャルメディアハンドルの URL。 データタイプ:文字列 |
| social_post_url | ケースの生成元のソーシャルメッセージの URL。 データタイプ:文字列 |
| state | ケースの現在のステータス。 可能な値:
データタイプ:数値 (整数) デフォルト値:1 |
| subcategory | ケースのサブカテゴリ。 可能な値: 0:質問データタイプ:数値 (整数) デフォルト:0 |
| support_manager | ケースにアサインされた CSM マネージャーの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| sync_driver | ドライバーの同期があるかどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン |
| sys_domain_path | ドメインパス。 データタイプ:文字列 最大長:255 デフォルト:/ |
| time_worked | ケースの合計作業時間。 データタイプ:文字列 |
| upon_approval | ケースが承認された場合に実行するアクション。 可能な値:
データタイプ:文字列 最大長:40 デフォルト:proceed |
| upon_reject | ケースが却下された場合に実行するアクション。 可能な値:
データタイプ:文字列 最大長:40 デフォルト:cancel |
| urgency | ケースの緊急度。 可能な値:
データタイプ:数値 (整数) デフォルト値:3 |
| user_input | 追加のユーザー入力。 データタイプ:文字列 最大長:4,000 |
| variables | ケースに関連付けられた変数の名前と値のペア。 データタイプ:文字列 最大長:40 |
| watch_list | 追加のコメントが追加された場合、またはケースのステータスが「解決済み」または「クローズ済み」に変更された場合に、このケースに関する通知を受信するユーザーの sys_id のリスト。 データタイプ:アレイ テーブル:ユーザー [sys_user] |
| wf_activity | ケースに関連付けられたワークフローアクティビティレコードの sys_id。 データタイプ:文字列 テーブル:ワークフローアクティビティ [wf_activity] |
| work_end | ケースの作業が終了した日時。 データタイプ:文字列 |
| work_notes_list | 作業メモが追加されたときに、このケースについての通知を受け取る内部ユーザーの sys_id のリスト。 データタイプ:アレイ テーブル:ユーザー [sys_user] |
| work_start | ケースの作業が開始された日時。 データタイプ:文字列 |
ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。
| ヘッダー | 説明 |
|---|---|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
| ヘッダー | 説明 |
|---|---|
| なし |
ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。
| ステータスコード | 説明 |
|---|---|
| 201 | 新しいケースレコードが正常に作成されました。 |
| 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 |
| 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 |
応答本文のパラメーター (JSON または XML)
| 要素 | 説明 |
|---|---|
| number | 関連ケース番号。 データタイプ:文字列 |
| sys_id | ケース [sn_customerservice_case] テーブルに作成された新しいケースレコードの sys_id。 データタイプ:文字列 |
cURL 要求
次の例では、コンシューマーに基づいてケースを作成する方法と、そのケースに関連付けられた新しいソーシャルメディアアカウントを作成する方法も示しています。
curl "https://instance.servicenow.com/api/sn_customerservice/case" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{ \
consumer: \"cd97ef1ddb8bc7006b7a9646db9619ac\", \
contact_type: \"social\", \
priority: \"4\", \
short_description: \"Consumer Test Case\", \
social_channel: \"TWITTER\", \
social_handle: \"consumertwo\", \
social_handle_type: \"Consumer\", \
social_handle_url: \"https://www.twitter.com/consumertwo\", \
social_post_url: \"https://twitter.com/MuleSoft/status/829092185022750720\"}" \
--user "username":"password"
{
"result": {
"sys_id": "0397c743db436f0057c3fd441d96197f",
"number": "CS0001005"
}
}
cURL 要求
次の例は、アカウントのケースを作成する方法を示しています。
curl "https://instance.servicenow.com/api/sn_customerservice/case" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{ \
account: \"051f62b0d7300200e5982cf65e610333\", \
contact_type: \"phone\", \
priority: \"1\", \
short_description: \"Power Outage\"}" \
--user "username":"password"
{
"result": {
"sys_id": "b88366ffdb1b0b00216e9ee6db96190b",
"number": "CS0001021"
}
}
cURL 要求
次の例は、特定の連絡先のケースを作成する方法を示しています。連絡先レコード内でアカウントが指定されている場合、そのアカウントは自動的にケースにアサインされます。
curl "https://instance.servicenow.com/api/sn_customerservice/case" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{ \
contact: \"62fe1c97db76c3006b7a9646db961999\", \
contact_type: \"phone\", \
priority: \"3\", \
short_description: \"Power Outage\"}" \
--user "username":"password"
{
"result": {
"sys_id": "bf916affdb1b0b00216e9ee6db961937",
"number": "CS0001013"
}
}
ケース - PUT /sn_customerservice/case/{id}
渡されたパラメーターで、指定された既存の カスタマーサービス管理 (CSM) ケースを更新します。
URL 形式
バージョニングされた URL:/api/sn_customerservice/{api_version}/case/{id}
デフォルトの URL:/api/sn_customerservice/case/{id}
サポートされている要求パラメーター
| 名前 | 説明 |
|---|---|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ:文字列 |
| id | 更新するケースの sys_id。 テーブル:ケース [sn_customerservice_case] |
| 名前 | 説明 |
|---|---|
| sysparm_display_value | 返されるデータ (データベースからの実際の値またはフィールドの表示値) のタイプを決定します。表示値は、データベース内の実際の値と、ユーザーやシステムの設定と環境設定に基づいて操作されます。 表示値を返す場合、返される値はフィールドタイプに依存します。
データタイプ:文字列 有効な値:
デフォルト値:false 注: このパラメーター設定に推奨方法はありません。ただし、表示値を指定すると、データベースから直接読み取られず、その他のフィールドやレコードを参照することがあるため、パフォーマンスに問題が発生する可能性があります。表示値と実際の値の詳細については、「テーブル API FAQ (KB0534905)」を参照してください。 |
| sysparm_fields | 応答で返すカンマ区切りのフィールドのリストです。無効なフィールドは無視されます。 データタイプ:文字列 デフォルト:すべてのフィールドを返します。 |
| sysparm_get_case_details | 更新されたケースレコードを返すかどうかを示すフラグ。 有効な値:
データタイプ:ブール デフォルト値:false |
| 要素 | 説明 |
|---|---|
| account | ケースに関連付けられたアカウントの sys_id。 データタイプ:文字列 デフォルト: contact を指定すると、連絡先レコードで指定されたアカウントがデフォルトになります。 テーブル:アカウント [customer_account] |
| アクティブ | ケースがオープンかアクティブかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト:true |
| active_account_escalation | ケースに関連付けられたアクティブなアカウントエスカレーションの sys_id。 データタイプ:文字列 テーブル:エスカレーション [sn_customerservice_escalation] |
| active_escalation | ケースに関連付けられたアクティブなエスカレーションレコードのSys_id。 データタイプ:文字列 テーブル:エスカレーション [sn_customerservice_escalation] |
| activity_due | 関連付けられたケースの完了予定日。 データタイプ:文字列 |
| additional_assignee_list | アカウントにアサインされた追加のユーザー (プライマリアサイニーを除く) のsys_idsのリスト。 データタイプ:アレイ 最大:4,000 テーブル:ユーザー [sys_user] |
| approval | 必要な承認のタイプを説明する文字列。 可能な値:
データタイプ:文字列 最大文字数:40 デフォルト:not requested |
| assigned_to |
ケースにアサインされたユーザーの sys_id。
テーブル:ユーザー [sys_user] データタイプ:文字列 |
| assignment_group | ケースにアサインされたカスタマーサービスエージェントグループの sys_id。 データタイプ:文字列 テーブル: Group [sys_user_group] |
| business_duration | ケースの完了までにかかったカレンダー上の作業時間、作業日数、および作業週数。 データタイプ:文字列 |
| business_impact | 関連する顧客に対する問題の影響。 データタイプ:文字列 最大文字数:4,000 |
| business_service | ケースに関連付けられたサービスレコードの sys_id。 データタイプ:文字列 テーブル:サービス [cmdb_ci_service] |
| category | ケースカテゴリ。 可能な値:
データタイプ:数値 (整数) デフォルト値:1 |
| cause | 問題の原因に関する詳細。 データタイプ:文字列 最大長:4,000 |
| caused_by | ケースが作成される原因となった変更要求の sys_id。 データタイプ:文字列 テーブル:変更要求 [change_request] |
| 変更 | ケースが作成される原因となった変更要求の sys_id。 データタイプ:文字列 テーブル:変更要求 [change_request] |
| child_case_creation_progress | ケースが重大なケースから作成された子ケースであるかどうかを示すフラグ。 可能な値:
データタイプ:ブール |
| close_notes | ケースがクローズされたときに作成されたメモ。 データタイプ:文字列 最大長:4,000 |
| closed_at | ケースがクローズされた日時。 データタイプ:文字列 |
| closed_by | ケースをクローズしたユーザーの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| cmdb_ci | ケースに関連付けられた構成アイテムの sys_id。 データタイプ:文字列 テーブル:構成アイテム [cmdb_ci] |
| コメント | ケースに関する追加のコメント。 データタイプ:文字列 最大長:4,000 |
| company | ケースに関連付けられた会社の sys_id。 データタイプ:文字列 テーブル:会社 [core_company] |
| consumer | 企業/消費者間ケースのみ。このケースに関して連絡先となる人のSys_id。 データタイプ:文字列 テーブル:コンシューマー [csm_consumer] |
| 連絡先 | 企業間ベースのケースのみ。このケースに関する連絡担当者の sys_id。 データタイプ:文字列 テーブル:連絡先 [customer_contact] |
| contact_time_zone | ケースに関連付けられた連絡先のタイムゾーン。 データタイプ:文字列 最大長:40 |
| contact_type | ケースが最初にレポートされた方法。 可能な値:
データタイプ:文字列 最大長:40 |
| contract | ケースに関連付けられた契約の sys_id。この契約には、ケースに関連付けられた会社に提供されるサポートのタイプに関する情報が含まれています。契約には会社と連絡先、および対象となる特定の資産が含まれる場合があります。1 つの契約に、複数のサービスエンタイトルメントと SLA を含めることもできます。 データタイプ:文字列 テーブル:契約 [ast_contract] |
| correlation_display | 相関ディスプレイ。 データタイプ:文字列 最大長:100 |
| correlation_id | 相関識別子。 データタイプ:文字列 最大長:100 |
| delivery_plan | このケースの親実行計画の sys_id。 データタイプ:文字列 テーブル:実行計画 [sc_cat_item_delivery_plan] |
| delivery_task | 実行計画タスクの sys_id。 データタイプ:文字列 テーブル:実行計画タスク [sc_cat_item_delivery_task] |
| 説明 | ケースに関連する問題の詳細な説明。 データタイプ:文字列 最大長:4,000 |
| due_date | ケースのクローズ予定日。 データタイプ:文字列 |
| エンタイトルメント | ケースに関連付けられたエンタイトルメントレコードの sys_id。エンタイトルメントによって、顧客が受けるサポートのタイプやサポートされるコミュニケーションチャネルが定義されます。エンタイトルメントは、製品、資産、アカウント、契約に関連付けることができます。 データタイプ:文字列 テーブル:エンタイトルメント [service_entitlement] |
| escalation | 現在のエスカレーションレベル。 可能な値:
データタイプ:数値 (整数) デフォルト:0 |
| expected_start | ケースの作業開始予定日時。 データタイプ:文字列 |
| first_response_time | ケースに対して最初のアクションが実行された日時。 データタイプ:文字列 |
| follow_the_sun | ケースをグローバルフォローアップに渡す必要があるかどうかを示すフラグ。 顧客が [優先度 1:重大] または [優先度 2 - 高] のケースにさらにコメントを入力した場合、またはケースが昇格された場合は、このフラグが自動的に true に設定されます。 可能な値:
データタイプ:ブーリアン デフォルト値:false |
| group_list | ケースに関連付けられたグループレコードの sys_id のリスト。 データタイプ:アレイ テーブル: Group [sys_user_group] |
| 影響 | 顧客への影響。 可能な値:
データタイプ:数値 (整数) デフォルト値:3 |
| ナレッジ | 指定された問題に利用可能なナレッジベース記事があるかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| location | 会社の場所を説明するレコードの sys_id。 データタイプ:文字列 テーブル:場所 [cmn_location] |
| made_sla | ケースが関連するサービスレベルアグリーメントに従って解決されたかどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン デフォルト:true |
| major_case_state | 重大なケースの現在のステータス。 可能な値:
データタイプ:文字列 最大長:40 |
| notes_to_comments | 解決メモをコメントに追加するかどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン |
| notify | 連絡先/コンシューマーに通知するために使用する方法。 可能な値:
データタイプ:数値 (整数) デフォルト値:1 |
| number | ケース番号。 データタイプ:文字列 最大長:40 |
| open_at | ケースがオープンされた日時。 データタイプ:文字列 |
| opened_by | ケースを最初にオープンしたユーザーの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| 順序 | ケースの順序。 データタイプ:数値 (整数) |
| parent | このケース (子) が関連付けられている親ケースの sys_id。 データタイプ:文字列 テーブル:タスク [task] |
| partner | ケースに関連付けられたパートナーの sys_id。 データタイプ:文字列 テーブル:アカウント [customer_account] |
| partner_contact | ケースに関連付けられたパートナーの連絡先の sys_id。 データタイプ:文字列 テーブル:連絡先 [customer_contact] |
| priority | ケースの優先度。 可能な値:
データタイプ:数値 (整数) デフォルト:4 |
| probable_cause | ケースに関連する問題の考えられる原因。 データタイプ:文字列 最大長:4,000 |
| 問題 | 顧客に発生している問題の sys_id。 データタイプ:文字列 テーブル:問題 [problem] |
| 製品 | ケースに関連付けられた資産の製品モデルの sys_id。モデルとは、「Apple Mac Book Pro」など、資産の特定のバージョンや構成のことです。 データタイプ:文字列 テーブル:製品モデル [cmdb_model] |
| reassignment_count | ケースを進行させる担当者にケースが再アサインされた回数。 データタイプ:数値 (整数) デフォルト:0 |
| recipient_list | このケースに関するコミュニケーションの受信者のリストを含むレコードの sys_id。 データタイプ:文字列 テーブル:受信者リスト [sn_publications_recipients_list] |
| rejection_goto | ケースが却下された場合に実行するタスクの sys_id。 データタイプ:文字列 テーブル:タスク [task] |
| resolution_code | ケースの解決ステータス (「Solved - サポートによって解決/ガイダンスの提供」など)。 データタイプ:文字列 最大長:40 |
| resolved_at | ケースが解決された日時。 データタイプ:文字列 |
| resolved_by | ケースを解決したユーザーの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| short_description | ケースの簡潔な説明。 データタイプ:文字列 最大長:160 |
| skills | ケースを完了するために必要なスキルの一意の識別子 (sys_id) のリスト。 データタイプ:文字列 テーブル:スキル [cmn_skill] |
| sla_due | 関連するサービスレベルアグリーメントに基づいてケースをクローズする必要がある日時。 データタイプ:文字列 |
| social_channel | ソーシャルメディアチャネルのタイプ (Twitter、Facebook、Instagram など)。 データタイプ:文字列 |
| social_handle | チャネルのユーザーハンドル。 データタイプ:文字列 |
| social_handle_type | ソーシャルメディアプロファイルを関連付けるケースのタイプ。 有効な値:
データタイプ:文字列 |
| social_handle_url | ユーザーのソーシャルメディアハンドルの URL。 データタイプ:文字列 |
| social_post_url | ケースの生成元のソーシャルメッセージの URL。 データタイプ:文字列 |
| state | ケースの現在のステータス。 可能な値:
データタイプ:数値 (整数) デフォルト値:1 |
| subcategory | ケースのサブカテゴリ。 可能な値: 0:質問データタイプ:数値 (整数) デフォルト:0 |
| support_manager | ケースにアサインされた CSM マネージャーの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| sync_driver | ドライバーの同期があるかどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン |
| sys_domain_path | ドメインパス。 データタイプ:文字列 最大長:255 デフォルト:/ |
| time_worked | ケースの合計作業時間。 データタイプ:文字列 |
| upon_approval | ケースが承認された場合に実行するアクション。 可能な値:
データタイプ:文字列 最大長:40 デフォルト:proceed |
| upon_reject | ケースが却下された場合に実行するアクション。 可能な値:
データタイプ:文字列 最大長:40 デフォルト:cancel |
| urgency | ケースの緊急度。 可能な値:
データタイプ:数値 (整数) デフォルト値:3 |
| user_input | 追加のユーザー入力。 データタイプ:文字列 最大長:4,000 |
| variables | ケースに関連付けられた変数の名前と値のペア。 データタイプ:文字列 最大長:40 |
| watch_list | 追加のコメントが追加された場合、またはケースのステータスが「解決済み」または「クローズ済み」に変更された場合に、このケースに関する通知を受信するユーザーの sys_id のリスト。 データタイプ:アレイ テーブル:ユーザー [sys_user] |
| wf_activity | ケースに関連付けられたワークフローアクティビティレコードの sys_id。 データタイプ:文字列 テーブル:ワークフローアクティビティ [wf_activity] |
| work_end | ケースの作業が終了した日時。 データタイプ:文字列 |
| work_notes_list | 作業メモが追加されたときに、このケースについての通知を受け取る内部ユーザーの sys_id のリスト。 データタイプ:アレイ テーブル:ユーザー [sys_user] |
| work_start | ケースの作業が開始された日時。 データタイプ:文字列 |
ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。
| ヘッダー | 説明 |
|---|---|
| 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 |
| Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 |
| ヘッダー | 説明 |
|---|---|
| なし |
ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。
| ステータスコード | 説明 |
|---|---|
| 201 | 成功。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 |
| 500 | 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。 |
応答本文のパラメーター (JSON または XML)
| 要素 | 説明 |
|---|---|
| account |
ケースに関連付けられたアカウントレコードの sys_id。
データタイプ:文字列 テーブル:アカウント [customer_account] |
| account | アカウントの詳細。 データタイプ:オブジェクト |
| account.account_code | アプリケーションが予算予測と予算計画を識別するために使用する値の一意の組み合わせ。 データタイプ:文字列 最大長:255 |
| account.account_parent | このアカウントの親アカウントの sys_id。アカウント [customer_account] テーブルにあります。 データタイプ:文字列 |
| account.account_path | アカウント階層内の親アカウントから子アカウントへのパス。 データタイプ:文字列 最大長:255 |
| account.active_escalation | アカウントに関連付けられたアクティブなエスカレーションの sys_id。 データタイプ:文字列 テーブル:エスカレーション [sn_customerservice_escalation] |
| account.apple_icon | iPhone ホームページのブックマークのアイコン。 データタイプ:画像 |
| account.banner_image | カスタマーポータルに表示されるバナー画像。 データタイプ:画像 |
| account.banner_image_light | 小さなバナー画像。 データタイプ:画像 |
| account.banner_text | カスタマーポータルに表示されるバナーテキスト。 データタイプ:文字列 最大長:4,000 |
| account.city | このアカウントに関連付けられている会社が所在する市。 データタイプ:文字列 最大長:50 |
| account.contact | このアカウントに関連付けられた連絡先レコードの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| account.country | このアカウントに関連付けられている会社が所在する国。 データタイプ:文字列 最大長:40 デフォルト: USA |
| account.customer | アカウントがパートナーアカウントではなく、顧客アカウントであるかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| account.discount | 購入時にアカウントに付与される割引。 データタイプ:数値 最大長:15 |
| account.fax_phone | このアカウントに関連付けられている会社の主要な FAX 電話番号。 データタイプ:文字列 最大長:40 |
| account.fiscal_year | アカウントに関連付けられている会社の会計年度。 データタイプ:文字列 |
| account.lat_long_error | 緯度および経度情報と比較した実際の場所の差。 データタイプ:文字列 最大長:1,000 |
| account.latitude | このアカウントに関連付けられている会社の緯度。 データタイプ:数値 (浮動小数点) 最大長:40 |
| account.longitude | このアカウントに関連付けられている会社の経度。 データタイプ:数値 (浮動小数点) 最大長:40 |
| account.manufacturer | このアカウントに関連付けられている会社が商品を製造しているかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| account.market_cap | 関連付けられている会社の公開株式の時価。 データタイプ:数値 (通貨) 最大長:20 |
| account.name | このアカウントに関連付けられている会社の名前。 データタイプ:文字列 最大長:80 |
| account.notes | 会社に関する補足情報。 データタイプ:文字列 最大長:4,000 |
| account.num_employees | 会社に雇用されている人数。 データタイプ:数値 (整数) 最大長:40 |
| account.number | このアカウントを識別する番号。 データタイプ:文字列 最大長:40 |
| account.parent | このアカウントの親アカウントの sys_id。 データタイプ:文字列 テーブル:会社 [core_company] |
| account.partner | アカウントがパートナーアカウントか顧客アカウントかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| account.phone | 会社の主要な電話番号。 データタイプ:文字列 |
| account.primary | これがプライマリアカウントであるかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| account.primary_contact | アカウントの主連絡先の sys_id。 データタイプ:文字列 テーブル:連絡先 [customer_contact] |
| account.profits | このアカウントに対して入力された利益情報。 データタイプ:数値 (通貨) 最大長:40 |
| account.publicly_traded | このアカウントに関連付けられている会社の株式が証券取引所で公開されているかどうかを示すフラグ。 可能な値:
データタイプ:ブール |
| account.rank_tier | アカウントのタイプ。 可能な値:
データタイプ:文字列 最大長:40 |
| account.registration_code | 顧客がカスタマーポータルでログインを要求するときに使用する一意のコード。このコードは、アクセス権を付与する前に会社で顧客を検証する方法を提供します。 データタイプ:文字列 最大長:40 |
| account.revenue_per_year | このアカウントに関連付けられている会社が生み出した収益。 データタイプ:数値 (通貨) 最大長:20 |
| account.state | 会社が所在する都道府県。 データタイプ:文字列 最大長:40 |
| account.stock_price | 会社の株価。 データタイプ:文字列 最大長:40 |
| account.stock_symbol | 会社の銘柄記号。 データタイプ:文字列 最大長:40 |
| account.street | 会社の番地 データタイプ:文字列 最大長:255 |
| account.sys_class_name | 関連するアカウントレコードを含むテーブル。 データタイプ:文字列 |
| account.sys_created_by | 最初にアカウントを作成したユーザー。 データタイプ:文字列 最大長:40 |
| account.sys_created_on | アカウントが最初に作成された日時。 データタイプ:文字列 |
| account.sys_id | アカウントレコードの sys_id。 データタイプ:文字列 |
| account.sys_mod_count | アカウント情報が更新された回数。 データタイプ:数値 (整数) |
| account.sys_updated_by | アカウント情報を最後に変更したユーザー。 データタイプ:文字列 最大長:40 |
| account.sys_updated_on | アカウント情報が最後に更新された日時。 データタイプ:文字列 |
| account.theme | このアカウントで使用されるカスタマーポータルテーマの sys_id。 データタイプ:文字列 テーブル:テーマ [sys_ui_theme] |
| account.vendor | このアカウントに関連付けられている会社がベンダーかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| account.vendor_manager | アカウントのベンダーマネージャーの sys_id のリスト。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| account.vendor_type | アプリケーション、ハードウェア、サービス、ソフトウェアなどのベンダーのタイプの sys_id のリスト。 データタイプ:文字列 テーブル:ベンダータイプ [vendor_type] |
| account.website | 会社の Web サイトの URL。 データタイプ:文字列 最大長:1,024 |
| account.zip | 会社の郵便番号。 データタイプ:文字列 最大長:40 |
| アクティブ | ケースがオープンかアクティブかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト:true |
| active_account_escalation | ケースに関連付けられたアクティブなアカウントエスカレーションの sys_id。 データタイプ:文字列 テーブル:エスカレーション [sn_customerservice_escalation] |
| active_escalation | ケースに関連付けられたアクティブなエスカレーションレコードのSys_id。 データタイプ:文字列 テーブル:エスカレーション [sn_customerservice_escalation] |
| activity_due | 関連付けられたケースの完了予定日。 データタイプ:文字列 |
| additional_assignee_list | アカウントにアサインされた追加のユーザー (プライマリアサイニーを除く) のsys_idsのリスト。 データタイプ:アレイ 最大:4,000 テーブル:ユーザー [sys_user] |
| approval | 必要な承認のタイプを説明する文字列。 可能な値:
データタイプ:文字列 最大文字数:40 デフォルト:not requested |
| approval_history | ケースに関連付けられているすべての承認のリスト。 データタイプ:文字列 最大文字数:4,000 |
| approval_set | 関連するアクションが承認された日時。 データタイプ:文字列 |
| 資産 | ケースに関連付けられた資産レコードの sys_id。 データタイプ:文字列 テーブル:資産 [alm_asset] |
| assigned_to |
ケースにアサインされたユーザーの sys_id。
テーブル:ユーザー [sys_user] データタイプ:文字列 |
| assignment_group | ケースにアサインされたカスタマーサービスエージェントグループの sys_id。 データタイプ:文字列 テーブル: Group [sys_user_group] |
| business_duration | ケースの完了までにかかったカレンダー上の作業時間、作業日数、および作業週数。 データタイプ:文字列 |
| business_impact | 関連する顧客に対する問題の影響。 データタイプ:文字列 最大文字数:4,000 |
| business_service | ケースに関連付けられたサービスレコードの sys_id。 データタイプ:文字列 テーブル:サービス [cmdb_ci_service] |
| case | ケースの簡単な説明とケース番号。 データタイプ:文字列 最大長:300 |
| case_report | 関連するケースレポートの sys_id。 データタイプ:文字列 テーブル:ケースレポート [sn_customerservice_case_report] |
| category | ケースカテゴリ。 可能な値:
データタイプ:数値 (整数) デフォルト値:1 |
| cause | 問題の原因に関する詳細。 データタイプ:文字列 最大長:4,000 |
| caused_by | ケースが作成される原因となった変更要求の sys_id。 データタイプ:文字列 テーブル:変更要求 [change_request] |
| 変更 | ケースが作成される原因となった変更要求の sys_id。 データタイプ:文字列 テーブル:変更要求 [change_request] |
| child_case_creation_progress | ケースが重大なケースから作成された子ケースであるかどうかを示すフラグ。 可能な値:
データタイプ:ブール |
| closed_at | ケースがクローズされた日時。 データタイプ:文字列 |
| closed_by | ケースをクローズしたユーザーの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| close_notes | ケースがクローズされたときに作成されたメモ。 データタイプ:文字列 最大長:4,000 |
| cmdb_ci | ケースに関連付けられた構成アイテムの sys_id。 データタイプ:文字列 テーブル:構成アイテム [cmdb_ci] |
| コメント | ケースに関する追加のコメント。 データタイプ:文字列 最大長:4,000 |
| comments_and_work_notes | ケースに対して入力されたコメントと作業メモ。 データタイプ:文字列 最大長:4,000 |
| company | ケースに関連付けられた会社の sys_id。 データタイプ:文字列 テーブル:会社 [core_company] |
| consumer | 企業/消費者間ケースのみ。このケースに関して連絡先となる人のSys_id。 データタイプ:文字列 テーブル:コンシューマー [csm_consumer] |
| consumer | 企業/消費者間ケースのパラメーターのアレイ。 |
| consumer.active | コンシューマーがアクティブかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト:true |
| consumer.business_phone | コンシューマーの勤務先電話番号。 データタイプ:文字列 最大長:40 |
| consumer.city | コンシューマーが居住する市区町村。 データタイプ:文字列 最大長:100 |
| consumer.country | コンシューマーが居住する国。 データタイプ:文字列 最大長:40 |
| consumer.date_format | 日付を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム日付形式) |
| consumer.email | コンシューマーのメールアドレス。 データタイプ:文字列 最大長:100 |
| consumer.fax | コンシューマーのファックス番号。 データタイプ:文字列 最大長:40 |
| consumer.first_name | コンシューマーの名。 データタイプ:文字列 最大長:50 |
| consumer.gender | コンシューマーの性別。 データタイプ:文字列 最大長:40 |
| consumer.home_phone | コンシューマーの自宅電話番号。 データタイプ:文字列 最大長:40 |
| consumer.household | 世帯の特性を説明するレコードの sys_id。 データタイプ:文字列 テーブル:世帯 [csm_household] |
| consumer.last_name | コンシューマーの姓。 データタイプ:文字列 最大長:50 |
| consumer.middle_name | コンシューマーのミドルネーム。 データタイプ:文字列 最大長:50 |
| consumer.mobile_phone | コンシューマーの携帯電話番号。 データタイプ:文字列 最大長:40 |
| consumer.name | コンシューマーのフルネーム。 first_name+middle_name+last_name。 データタイプ:文字列 最大長:152 |
| consumer.notes | コンシューマーに関するメモ。 データタイプ:文字列 最大長:4,000 |
| consumer.notification | コンシューマーが通知を受信するかどうかを示します。 有効な値:
データタイプ:数値 (整数) 最大長:40 デフォルト値:2 |
| consumer.number | コンシューマーに関連付けられた一意の番号。 データタイプ:文字列 最大長:40 |
| consumer.photo | コンシューマーの写真。 データタイプ:画像 |
| consumer.preferred_language | コンシューマーのプライマリ言語。 データタイプ:文字列 最大長:3 |
| consumer.prefix | Dr.、Mr.、Mrs.、Ms. などのコンシューマー名のプリフィックス データタイプ:文字列 最大長:40 |
| consumer.primary | これがプライマリコンシューマーであるかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| consumer.state | コンシューマーが居住する都道府県。 データタイプ:文字列 最大長:100 |
| consumer.street | コンシューマーの番地。 データタイプ:文字列 最大長:255 |
| consumer.suffix | Jr.、Sr.、II などのコンシューマー名のサフィックス。 データタイプ:文字列 |
| consumer.sys_created_by | コンシューマーレコードを作成したユーザー。 データタイプ:文字列 最大長:40 |
| consumer.sys_created_on | コンシューマーレコードが最初に作成された日時。 データタイプ:文字列 |
| consumer.sys_domain | コンシューマー情報が存在する ServiceNow ドメイン。 データタイプ:文字列 |
| consumer.sys_id | コンシューマーの一意の識別子。 データタイプ:文字列 |
| consumer.sys_mod_count | 関連するコンシューマー情報が変更された回数。 データタイプ:数値 (整数) |
| consumer.sys_updated_by | コンシューマー情報を最後に更新したユーザー。 データタイプ:文字列 最大長:40 |
| consumer.sys_updated_on | コンシューマー情報が最後に更新された日時。 データタイプ:文字列 |
| consumer.time_format | 時間を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム時間形式) |
| consumer.time_zone | コンシューマーのタイムゾーン (カナダ/中央または米国/東部)。 データタイプ:文字列 最大長:40 |
| consumer.title | マネージャー、ソフトウェア開発者、請負業者などのコンシューマーのビジネスタイトル。 データタイプ:文字列 最大長:60 |
| consumer.user | コンシューマーユーザーの sys_id。 データタイプ:文字列 テーブル:コンシューマーユーザー [csm_consumer_user] |
| consumer.zip | コンシューマーの郵便番号。 データタイプ:文字列 最大長:40 |
| 連絡先 | 企業間ベースのケースのみ。このケースに関する連絡担当者の sys_id。 データタイプ:文字列 テーブル:連絡先 [customer_contact] |
| contact | 企業/企業間ケースの連絡先パラメーターのアレイ。 |
| contact.account | 連絡先が関連付けられているアカウントレコードのSys_id。 データタイプ:文字列 テーブル:アカウント [customer_account] |
| contact.active | システム内で連絡先がアクティブかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト:true |
| contact.agent_status | エージェントのステータス。 可能な値:
データタイプ:文字列 最大長:40 |
| contact.building | 連絡先が所在する建物を説明するレコードのSys_id。 データタイプ:文字列 テーブル:建物 [cmn_building] |
| contact.calendar_integration | 連絡先が使用するカレンダーアプリケーション。 1:Outlook データタイプ:数値 (整数) デフォルト値:1 |
| contact.city | 連絡先が居住する市区町村。 データタイプ:文字列 最大長:40 |
| contact.company | 連絡先が関連付けられている会社レコードのSys_id。 データタイプ:文字列 テーブル:会社 [core_company] |
| contact.cost_center | 連絡先に関連付けられたコストセンターのSys_id。 データタイプ:文字列 テーブル:コストセンター [cmn_cost_center] |
| contact.country | 連絡先が居住する国の国コード。 データタイプ:文字列 最大長:3 |
| contact.date_format | 連絡先に日付を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム日付形式) |
| contact.default_perspective | 連絡先のデフォルトの視点の sys_id。 データタイプ:文字列 テーブル:メニューリスト [sys_perspective] |
| contact.department | 連絡先に関連付けられた部門の sys_id。 データタイプ:文字列 テーブル:部門 [cmn_department] |
| contact.edu_status | 関連付けられた連絡先の学歴ステータス。 データタイプ:文字列 最大長:40 デフォルト:faculty |
| contact.email | 連絡先のメールアドレス。 データタイプ:文字列 |
| contact.employee_number | 連絡先の従業員番号。 データタイプ:文字列 |
| contact.enable_multifactor_authn | 連絡先がサービスポータルにログインするためにマルチファクター認証が必要かどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| contact.failed_attempts | 失敗したログイン試行回数。 データタイプ:数値 (整数) |
| contact.first_name | 連絡先の名。 データタイプ:文字列 最大長:50 |
| contact.gender | 連絡先の性別。 データタイプ:文字列 最大長:40 |
| contact.geolocation_tracked | 連絡先の場所が位置情報追跡によって取得されたかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| contact.home_phone | 連絡先の自宅電話番号。 データタイプ:文字列 最大長:40 |
| contact.internal_integration_user | 連絡先が内部統合ユーザーかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| contact.introduction | 前書き データタイプ:文字列 最大長:40 |
| contact.last_login | 連絡先が最後にシステムにログインした日付。 データタイプ:文字列 (日付) |
| contact.last_login_device | コンシューマーが最後にシステムにログインしたときに使用したデバイス。 データタイプ:文字列 最大長:40 |
| contact.last_login_time | 連絡先がシステムにログインした日時。 データタイプ:文字列 (日付/時間) |
| contact.last_name | 連絡先の姓。 データタイプ:文字列 最大長:50 |
| contact.last_position_update | 位置が最後に更新された日時。 データタイプ:文字列 (日付/時間) |
| contact.latitude | 連絡先の緯度座標。 データタイプ:数値 (浮動小数点) 最大長:40 |
| contact.ldap_server | 連絡先がシステムへの最終ログインに使用する LDAP サーバーのSys_id。 データタイプ:文字列 テーブル:LDAP サーバー [ldap_server_config] |
| contact.location | 連絡先の場所を説明するレコードのSys_id データタイプ:文字列 テーブル:場所 [cmn_location] |
| contact.locked_out | 連絡先がロックアウトされているかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| contact.longitude | 連絡先の経度座標。 データタイプ:数値 (浮動小数点) 最大長:40 |
| contact.manager | 連絡先の直属の上司を説明するレコードのSys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| contact.middle_name | 連絡先のミドルネーム。 データタイプ:数値 (浮動小数点) 最大長:50 |
| contact.mobile_phone | 連絡先の携帯電話番号。 データタイプ:文字列 最大長:40 |
| contact.name | 連絡先のフルネーム。 データタイプ:文字列 最大長:151 |
| contact.notification | 連絡先が通知を受信するかどうかを示します。 有効な値:
データタイプ:数値 (整数) デフォルト値:2 |
| contact.on_schedule | ディスパッチされたサービス担当者の適時性を示します。 有効な値:
データタイプ:文字列 最大長:40 |
| contact.phone | 連絡先の勤務先電話番号。 データタイプ:文字列 最大長:40 |
| contact.photo | 連絡先の写真画像。 データタイプ:文字列 |
| contact.preferred_language | 連絡先のプライマリ言語の国コード。 データタイプ:文字列 最大長:3 |
| contact.roles | 連絡先に関連付けられているユーザーロールのリスト。 データタイプ:文字列 最大長:40 |
| contact.schedule | 関連付けられた連絡先の作業スケジュールを説明するレコードのSys_id。 データタイプ:文字列 テーブル:スケジュール [cmn_schedule] |
| contact.source | 連絡先のソース。 データタイプ:文字列 最大長:255 |
| contact.state | 連絡先が居住する都道府県。 データタイプ:文字列 最大長:40 |
| contact.street | 連絡先の番地。 データタイプ:文字列 最大長:255 |
| contact.sys_class_name | 連絡先レコードを含むテーブル。 データタイプ:文字列 最大長:80 |
| contact.sys_created_by | 関連付けられた連絡先レコードを最初に作成したユーザー。 データタイプ:文字列 最大長:40 |
| contact.sys_created_on | 関連付けられた連絡先が最初に作成された日時。 データタイプ:文字列 (日付/時間) |
| contact.sys_domain | 関連付けられた連絡先レコードの ServiceNow インスタンスドメイン。 データタイプ:文字列 |
| contact.sys_domain_path | 連絡先レコードのドメインパス。 データタイプ:文字列 最大長:255 デフォルト:/ (global) |
| contact.sys_id | 関連付けられた連絡先レコードの一意の識別子。 データタイプ:文字列 |
| contact.sys_mod_count | 関連付けられた連絡先レコードが変更された回数。 データタイプ:数値 (整数) |
| contact.sys_tags | コンテンツのシステムタグ。 データタイプ:文字列 |
| contact.sys_updated_by | 関連付けられた連絡先情報を最後に更新したユーザー。 データタイプ:文字列 最大長:40 |
| contact.sys_updated_on | 関連付けられた連絡先情報が更新された日時。 データタイプ:文字列 (日付/時間) |
| contact.time_format | 時間を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム時間形式) |
| contact.time_sheet_policy | 関連付けられた連絡先のタイムシートポリシーを含むレコードのSys_id。 データタイプ:文字列 テーブル:タイムシートポリシー [time_sheet_policy] |
| contact.time_zone | 連絡先が居住するタイムゾーン (カナダ/中央または米国/東部)。 データタイプ:文字列 最大長:40 |
| contact.title | マネージャー、ソフトウェア開発者、請負業者などの連絡先のビジネスタイトル。 データタイプ:文字列 最大長:60 |
| contact.user_name | 連絡先のユーザー ID。 データタイプ:文字列 最大長:40 |
| contact.vip | 関連付けられた連絡先が VIP ステータスかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| contact.web_service_access_only | 連絡先が Web 経由でのみサービスにアクセスできるかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| contact.zip | 連絡先の郵便番号。 データタイプ:文字列 最大長:40 |
| contact_local_time | 連絡先の現地時間。 データタイプ:文字列 最大長:70 |
| contact_time_zone | ケースに関連付けられた連絡先のタイムゾーン。 データタイプ:文字列 最大長:40 |
| contact_type | ケースが最初にレポートされた方法。 可能な値:
データタイプ:文字列 最大長:40 |
| contract | ケースに関連付けられた契約の sys_id。この契約には、ケースに関連付けられた会社に提供されるサポートのタイプに関する情報が含まれています。契約には会社と連絡先、および対象となる特定の資産が含まれる場合があります。1 つの契約に、複数のサービスエンタイトルメントと SLA を含めることもできます。 データタイプ:文字列 テーブル:契約 [ast_contract] |
| correlation_display | 相関ディスプレイ。 データタイプ:文字列 最大長:100 |
| correlation_id | 相関識別子。 データタイプ:文字列 最大長:100 |
| delivery_plan | このケースの親実行計画の sys_id。 データタイプ:文字列 テーブル:実行計画 [sc_cat_item_delivery_plan] |
| delivery_task | 実行計画タスクの sys_id。 データタイプ:文字列 テーブル:実行計画タスク [sc_cat_item_delivery_task] |
| 説明 | ケースに関連する問題の詳細な説明。 データタイプ:文字列 最大長:4,000 |
| due_date | ケースのクローズ予定日。 データタイプ:文字列 |
| エンタイトルメント | ケースに関連付けられたエンタイトルメントレコードの sys_id。エンタイトルメントによって、顧客が受けるサポートのタイプやサポートされるコミュニケーションチャネルが定義されます。エンタイトルメントは、製品、資産、アカウント、契約に関連付けることができます。 データタイプ:文字列 テーブル:エンタイトルメント [service_entitlement] |
| escalation | 現在のエスカレーションレベル。 可能な値:
データタイプ:数値 (整数) デフォルト:0 |
| expected_start | ケースの作業開始予定日時。 データタイプ:文字列 |
| first_response_time | ケースに対して最初のアクションが実行された日時。 データタイプ:文字列 |
| follow_the_sun | ケースをグローバルフォローアップに渡す必要があるかどうかを示すフラグ。 顧客が [優先度 1:重大] または [優先度 2 - 高] のケースにさらにコメントを入力した場合、またはケースが昇格された場合は、このフラグが自動的に true に設定されます。 可能な値:
データタイプ:ブーリアン デフォルト値:false |
| follow_up | 次のフォローアップアクションの日時。 データタイプ:文字列 |
| group_list | ケースに関連付けられたグループレコードの sys_id のリスト。 データタイプ:アレイ テーブル: Group [sys_user_group] |
| 影響 | 顧客への影響。 可能な値:
データタイプ:数値 (整数) デフォルト値:3 |
| ナレッジ | 指定された問題に利用可能なナレッジベース記事があるかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| location | 会社の場所を説明するレコードの sys_id。 データタイプ:文字列 テーブル:場所 [cmn_location] |
| made_sla | ケースが関連するサービスレベルアグリーメントに従って解決されたかどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン デフォルト:true |
| major_case_state | 重大なケースの現在のステータス。 可能な値:
データタイプ:文字列 最大長:40 |
| needs_attention | ケースに注意が必要かどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン デフォルト値:false |
| notes_to_comments | 解決メモをコメントに追加するかどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン |
| notify | 連絡先/コンシューマーに通知するために使用する方法。 可能な値:
データタイプ:数値 (整数) デフォルト値:1 |
| number | ケース番号。 データタイプ:文字列 最大長:40 |
| open_at | ケースがオープンされた日時。 データタイプ:文字列 |
| opened_by | ケースを最初にオープンしたユーザーの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| 順序 | ケースの順序。 データタイプ:数値 (整数) |
| parent | このケース (子) が関連付けられている親ケースの sys_id。 データタイプ:文字列 テーブル:タスク [task] |
| partner | ケースに関連付けられたパートナーの sys_id。 データタイプ:文字列 テーブル:アカウント [customer_account] |
| partner_contact | ケースに関連付けられたパートナーの連絡先の sys_id。 データタイプ:文字列 テーブル:連絡先 [customer_contact] |
| priority | ケースの優先度。 可能な値:
データタイプ:数値 (整数) デフォルト:4 |
| probable_cause | ケースに関連する問題の考えられる原因。 データタイプ:文字列 最大長:4,000 |
| 問題 | 顧客に発生している問題の sys_id。 データタイプ:文字列 テーブル:問題 [problem] |
| 製品 | ケースに関連付けられた資産の製品モデルの sys_id。モデルとは、「Apple Mac Book Pro」など、資産の特定のバージョンや構成のことです。 データタイプ:文字列 テーブル:製品モデル [cmdb_model] |
| reassignment_count | ケースを進行させる担当者にケースが再アサインされた回数。 データタイプ:数値 (整数) デフォルト:0 |
| recipient_list | このケースに関するコミュニケーションの受信者のリストを含むレコードの sys_id。 データタイプ:文字列 テーブル:受信者リスト [sn_publications_recipients_list] |
| rejection_goto | ケースが却下された場合に実行するタスクの sys_id。 データタイプ:文字列 テーブル:タスク [task] |
| resolution_code | ケースの解決ステータス (「Solved - サポートによって解決/ガイダンスの提供」など)。 データタイプ:文字列 最大長:40 |
| resolved_at | ケースが解決された日時。 データタイプ:文字列 |
| resolved_by | ケースを解決したユーザーの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| 結果 | 要求されたフィールドの値のリスト。 データタイプ:オブジェクトのアレイ |
| result.label | フィールド値の表示値。 データタイプ:文字列 |
| result.value | フィールド値。 データタイプ:文字列 |
| short_description | ケースの簡潔な説明。 データタイプ:文字列 最大長:160 |
| skills | ケースを完了するために必要なスキルの一意の識別子 (sys_id) のリスト。 データタイプ:文字列 テーブル:スキル [cmn_skill] |
| sla_due | 関連するサービスレベルアグリーメントに基づいてケースをクローズする必要がある日時。 データタイプ:文字列 |
| sn_app_cs_social_social_profile | Facebook、Twitter、YouTube などの特定のソーシャルメディアプロファイルの詳細。 データタイプ:オブジェクトのアレイ |
| sn_app_cs_social_social_profile.account | ソーシャルメディアプロファイルのアカウント情報を含むレコードの一意の識別子。アカウント [customer_account] テーブルにあります。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.channel | 関連するソーシャルメディアプロファイルチャネルの詳細。 データタイプ:オブジェクト |
| sn_app_cs_social_social_profile.channel.name | ソーシャルメディアチャネルの名前。 データタイプ:文字列 最大長:100 |
| sn_app_cs_social_social_profile.channel.sys_class_name | ソーシャルメディアチャネルレコードを含むテーブル。 データタイプ:文字列 最大長:80 |
| sn_app_cs_social_social_profile.channel.sys_created_by | ソーシャルメディアチャネルを作成した人物。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.channel.sys_created_on | ソーシャルメディアプロファイルが作成された日時。 データタイプ: 日付/時刻 最大長:40 |
| sn_app_cs_social_social_profile.channel.sys_id | 関連付けられたソーシャルメディアプロファイルチャネルの一意の識別子。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.channel.sys_mod_count | 関連付けられたソーシャルメディアプロファイルチャネルの情報が変更された回数。 データタイプ:整数 |
| sn_app_cs_social_social_profile.channel.sys_name | チャネルのシステム名。 データタイプ:文字列 最大長:255 |
| sn_app_cs_social_social_profile.channel.sys_package | プロファイルに関連付けられたパッケージに関する情報を含むレコードの一意の識別子。パッケージ [sys_package] テーブル。 データタイプ:参照 |
| sn_app_cs_social_social_profile.channel.sys_policy | システム保護ポリシー。 可能な値:
データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.channel.sys_scope | ソーシャルプロファイルの範囲に関する情報を含むレコードの一意の識別子。アプリケーション [sys_scope] テーブル。 データタイプ:参照 |
| sn_app_cs_social_social_profile.channel.sys_tags | チャネルに関連付けられたシステムタグ。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.channel.sys_update_name | ソーシャルメディアプロファイルチャネルを最後に更新したユーザーの名前。 データタイプ:文字列 最大長:250 |
| sn_app_cs_social_social_profile.channel.sys_updated_by | ソーシャルメディアプロファイルチャネルを最後に更新したユーザー。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.channel.sys_updated_on | ソーシャルメディアプロファイルチャネルが最後に更新された日時。 データタイプ: 日付/時刻 最大長:40 |
| sn_app_cs_social_social_profile.consumer | 企業/消費者間ケースの場合。ケースに関連付けられたコンシューマーの詳細。 データタイプ:オブジェクト |
| sn_app_cs_social_social_profile.consumer.active | コンシューマーがアクティブかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト:true |
| sn_app_cs_social_social_profile.consumer.business_phone | コンシューマーの勤務先電話番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.city | コンシューマーが居住する市区町村。 データタイプ:文字列 最大長:100 |
| sn_app_cs_social_social_profile.consumer.country | コンシューマーが居住する国。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.date_format | 日付を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム日付形式) |
| sn_app_cs_social_social_profile.consumer.email | コンシューマーのメールアドレス。 データタイプ:文字列 最大長:100 |
| sn_app_cs_social_social_profile.consumer.fax | コンシューマーのファックス番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.first_name | コンシューマーの名。 データタイプ:文字列 最大長:50 |
| sn_app_cs_social_social_profile.consumer.gender | コンシューマーの性別。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.home_phone | コンシューマーの自宅電話番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.household | 世帯の特性を説明するレコードの sys_id。 データタイプ:文字列 テーブル:世帯 [csm_household] |
| sn_app_cs_social_social_profile.consumer.last_name | コンシューマーの姓。 データタイプ:文字列 最大長:50 |
| sn_app_cs_social_social_profile.consumer.middle_name | コンシューマーのミドルネーム。 データタイプ:文字列 最大長:50 |
| sn_app_cs_social_social_profile.consumer.mobile_phone | コンシューマーの携帯電話番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.name | コンシューマーのフルネーム。 first_name+middle_name+last_name。 データタイプ:文字列 最大長:152 |
| sn_app_cs_social_social_profile.consumer.notes | コンシューマーに関するメモ。 データタイプ:文字列 最大長:4,000 |
| sn_app_cs_social_social_profile.consumer.notification | コンシューマーが通知を受信するかどうかを示します。 有効な値:
データタイプ:数値 (整数) 最大長:40 デフォルト値:2 |
| sn_app_cs_social_social_profile.consumer.number | コンシューマーに関連付けられた一意の番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.photo | コンシューマーの写真。 データタイプ:画像 |
| sn_app_cs_social_social_profile.consumer.preferred_language | コンシューマーのプライマリ言語。 データタイプ:文字列 最大長:3 |
| sn_app_cs_social_social_profile.consumer.prefix | Dr.、Mr.、Mrs.、Ms. などのコンシューマー名のプリフィックス データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.primary | これがプライマリコンシューマーであるかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| sn_app_cs_social_social_profile.consumer.state | コンシューマーが居住する都道府県。 データタイプ:文字列 最大長:100 |
| sn_app_cs_social_social_profile.consumer.street | コンシューマーの番地。 データタイプ:文字列 最大長:255 |
| sn_app_cs_social_social_profile.consumer.suffix | Jr.、Sr.、II などのコンシューマー名のサフィックス。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.consumer.sys_created_by | コンシューマーレコードを作成したユーザー。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.sys_created_on | コンシューマーレコードが最初に作成された日時。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.consumer.sys_domain | コンシューマー情報が存在する ServiceNow ドメイン。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.consumer.sys_id | コンシューマーの一意の識別子。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.consumer.sys_mod_count | 関連するコンシューマー情報が変更された回数。 データタイプ:数値 (整数) |
| sn_app_cs_social_social_profile.consumer.sys_tags | コンシューマーシステムタグ。 |
| sn_app_cs_social_social_profile.consumer.sys_updated_by | コンシューマー情報を最後に更新したユーザー。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.sys_updated_on | コンシューマー情報が最後に更新された日時。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.consumer.time_format | 時間を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム時間形式) |
| sn_app_cs_social_social_profile.consumer.time_zone | コンシューマーのタイムゾーン (カナダ/中央または米国/東部)。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.consumer.title | マネージャー、ソフトウェア開発者、請負業者などのコンシューマーのビジネスタイトル。 データタイプ:文字列 最大長:60 |
| sn_app_cs_social_social_profile.consumer.user | コンシューマーユーザーの sys_id。 データタイプ:文字列 テーブル:コンシューマーユーザー [csm_consumer_user] |
| sn_app_cs_social_social_profile.consumer.zip | コンシューマーの郵便番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact | 企業間ケースの場合。ケースに関連付けられた連絡先に属するソーシャルメディアプロファイルの詳細を含むレコードの一意の識別子。連絡先 [customer_contact] テーブルにあります。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.contact.account | 連絡先が関連付けられているアカウントレコードのSys_id。 データタイプ:文字列 テーブル:アカウント [customer_account] |
| sn_app_cs_social_social_profile.contact.active | システム内で連絡先がアクティブかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト:true |
| sn_app_cs_social_social_profile.contact.agent_status | エージェントのステータス。 可能な値:
データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.building | 連絡先が所在する建物を説明するレコードのSys_id。 データタイプ:文字列 テーブル:建物 [cmn_building] |
| sn_app_cs_social_social_profile.contact.calendar_integration | 連絡先が使用するカレンダーアプリケーション。 1:Outlook データタイプ:数値 (整数) デフォルト値:1 |
| sn_app_cs_social_social_profile.contact.city | 連絡先が居住する市区町村。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.company | 連絡先が関連付けられている会社レコードのSys_id。 データタイプ:文字列 テーブル:会社 [core_company] |
| sn_app_cs_social_social_profile.contact.cost_center | 連絡先に関連付けられたコストセンターのSys_id。 データタイプ:文字列 テーブル:コストセンター [cmn_cost_center] |
| sn_app_cs_social_social_profile.contact.country | 連絡先が居住する国の国コード。 データタイプ:文字列 最大長:3 |
| sn_app_cs_social_social_profile.contact.date_format | 連絡先に日付を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム日付形式) |
| sn_app_cs_social_social_profile.contact.default_perspective | 連絡先のデフォルトの視点の sys_id。 データタイプ:文字列 テーブル:メニューリスト [sys_perspective] |
| sn_app_cs_social_social_profile.contact.department | 連絡先に関連付けられた部門の sys_id。 データタイプ:文字列 テーブル:部門 [cmn_department] |
| sn_app_cs_social_social_profile.contact.edu_status | 関連付けられた連絡先の学歴ステータス。 データタイプ:文字列 最大長:40 デフォルト:faculty |
| sn_app_cs_social_social_profile.contact.email | 連絡先のメールアドレス。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.contact.employee_number | 連絡先の従業員番号。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.contact.enable_multifactor_authn | 連絡先がサービスポータルにログインするためにマルチファクター認証が必要かどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| sn_app_cs_social_social_profile.contact.failed_attempts | 失敗したログイン試行回数。 データタイプ:数値 (整数) |
| sn_app_cs_social_social_profile.contact.first_name | 連絡先の名。 データタイプ:文字列 最大長:50 |
| sn_app_cs_social_social_profile.contact.gender | 連絡先の性別。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.geolocation_tracked | 連絡先の場所が位置情報追跡によって取得されたかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| sn_app_cs_social_social_profile.contact.home_phone | 連絡先の自宅電話番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.internal_itegration_user | 連絡先が内部統合ユーザーかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| sn_app_cs_social_social_profile.contact.introduction | 前書き データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.last_login | 連絡先が最後にシステムにログインした日付。 データタイプ:文字列 (日付) |
| sn_app_cs_social_social_profile.contact.last_login_device | コンシューマーが最後にシステムにログインしたときに使用したデバイス。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.last_login_time | 連絡先がシステムにログインした日時。 データタイプ:文字列 (日付/時間) |
| sn_app_cs_social_social_profile.contact.last_name | 連絡先の姓。 データタイプ:文字列 最大長:50 |
| sn_app_cs_social_social_profile.contact.last_position_update | 位置が最後に更新された日時。 データタイプ:文字列 (日付/時間) |
| sn_app_cs_social_social_profile.contact.latitude | 連絡先の緯度座標。 データタイプ:数値 (浮動小数点) 最大長:40 |
| sn_app_cs_social_social_profile.contact.ldap_server | 連絡先がシステムへの最終ログインに使用する LDAP サーバーのSys_id。 データタイプ:文字列 テーブル:LDAP サーバー [ldap_server_config] |
| sn_app_cs_social_social_profile.contact.location | 連絡先の場所を説明するレコードのSys_id データタイプ:文字列 テーブル:場所 [cmn_location] |
| sn_app_cs_social_social_profile.contact.locked_out | 連絡先がロックアウトされているかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| sn_app_cs_social_social_profile.contact.longitude | 連絡先の経度座標。 データタイプ:数値 (浮動小数点) 最大長:40 |
| sn_app_cs_social_social_profile.contact.manager | 連絡先の直属の上司を説明するレコードのSys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| sn_app_cs_social_social_profile.contact.middle_name | 連絡先のミドルネーム。 データタイプ:数値 (浮動小数点) 最大長:50 |
| sn_app_cs_social_social_profile.contact.mobile_phone | 連絡先の携帯電話番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.name | 連絡先のフルネーム。 データタイプ:文字列 最大長:151 |
| sn_app_cs_social_social_profile.contact.notification | 連絡先が通知を受信するかどうかを示します。 有効な値:
データタイプ:数値 (整数) デフォルト値:2 |
| sn_app_cs_social_social_profile.contact.on_schedule | ディスパッチされたサービス担当者の適時性を示します。 有効な値:
データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.phone | 連絡先の勤務先電話番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.photo | 連絡先の写真画像。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.contact.preferred_language | 連絡先のプライマリ言語の国コード。 データタイプ:文字列 最大長:3 |
| sn_app_cs_social_social_profile.contact.roles | 連絡先に関連付けられているユーザーロールのリスト。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.schedule | 関連付けられた連絡先の作業スケジュールを説明するレコードのSys_id。 データタイプ:文字列 テーブル:スケジュール [cmn_schedule] |
| sn_app_cs_social_social_profile.contact.source | 連絡先のソース。 データタイプ:文字列 最大長:255 |
| sn_app_cs_social_social_profile.contact.state | 連絡先が居住する都道府県。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.street | 連絡先の番地。 データタイプ:文字列 最大長:255 |
| sn_app_cs_social_social_profile.contact.sys_class_name | 連絡先レコードを含むテーブル。 データタイプ:文字列 最大長:80 |
| sn_app_cs_social_social_profile.contact.sys_created_by | 関連付けられた連絡先レコードを最初に作成したユーザー。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.sys_created_on | 関連付けられた連絡先が最初に作成された日時。 データタイプ:文字列 (日付/時間) |
| sn_app_cs_social_social_profile.contact.sys_domain | 関連付けられた連絡先レコードの ServiceNow インスタンスドメイン。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.contact.sys_domain_path | 連絡先レコードのドメインパス。 データタイプ:文字列 最大長:255 デフォルト:/ (global) |
| sn_app_cs_social_social_profile.contact.sys_id | 関連付けられた連絡先レコードの一意の識別子。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.contact.sys_mod_count | 関連付けられた連絡先レコードが変更された回数。 データタイプ:数値 (整数) |
| sn_app_cs_social_social_profile.contact.sys_tags | 連絡先システムタグ。 |
| sn_app_cs_social_social_profile.contact.sys_updated_by | 関連付けられた連絡先情報を最後に更新したユーザー。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.sys_updated_on | 関連付けられた連絡先情報が更新された日時。 データタイプ:文字列 (日付/時間) |
| sn_app_cs_social_social_profile.contact.time_format | 時間を表示する形式。 有効な値:
データタイプ:文字列 最大長:40 デフォルト:空 (システム時間形式) |
| sn_app_cs_social_social_profile.contact.time_sheet_policy | 関連付けられた連絡先のタイムシートポリシーを含むレコードのSys_id。 データタイプ:文字列 テーブル:タイムシートポリシー [time_sheet_policy] |
| sn_app_cs_social_social_profile.contact.time_zone | 連絡先が居住するタイムゾーン (カナダ/中央または米国/東部)。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.title | マネージャー、ソフトウェア開発者、請負業者などの連絡先のビジネスタイトル。 データタイプ:文字列 最大長:60 |
| sn_app_cs_social_social_profile.contact.user_name | 連絡先のユーザー ID。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.contact.vip | 関連付けられた連絡先が VIP ステータスかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| sn_app_cs_social_social_profile.contact.web_service_access_only | 連絡先が Web 経由でのみサービスにアクセスできるかどうかを示すフラグ。 可能な値:
データタイプ:ブール デフォルト値:false |
| sn_app_cs_social_social_profile.contact.zip | 連絡先の郵便番号。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.created_on | 関連するソーシャルメディアプロファイルが最初に作成された日時。 |
| sn_app_cs_social_social_profile.profile | ソーシャルプロファイル。 データタイプ:文字列 最大長:255 |
| sn_app_cs_social_social_profile.profile_url | ソーシャルメディアプロファイルへのアクセスに使用する URL。 データタイプ:文字列 最大長:1,024 |
| sn_app_cs_social_social_profile.social_id | 関連付けられたソーシャルメディアアカウントの一意のソーシャルメディアアカウントプロバイダー識別子。 データタイプ:文字列 最大長:100 |
| sn_app_cs_social_social_profile.source | ソーシャルプロファイルのソース。 データタイプ:文字列 最大長:255 |
| sn_app_cs_social_social_profile.sys_created_by | ソーシャルメディアプロファイルを最初に作成したユーザー。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.sys_created_on | ソーシャルメディアプロファイルが最初に作成された日時。 データタイプ:文字列 (日付/時間) |
| sn_app_cs_social_social_profile.sys_id | ソーシャルメディアプロファイルの一意の識別子。 データタイプ:文字列 |
| sn_app_cs_social_social_profile.sys_mod_count | 関連付けられたソーシャルメディアプロファイルの情報が変更された回数。 データタイプ:数値 (整数) |
| sn_app_cs_social_social_profile.sys_tags | プロファイルシステムタグ。 |
| sn_app_cs_social_social_profile.sys_updated_by | ソーシャルメディアプロファイルを最初に作成したユーザー。 データタイプ:文字列 最大長:40 |
| sn_app_cs_social_social_profile.sys_updated_on | ソーシャルメディアプロファイルを最初に作成したユーザー。 データタイプ:文字列 最大長:40 |
| state | ケースの現在のステータス。 可能な値:
データタイプ:数値 (整数) デフォルト値:1 |
| subcategory | ケースのサブカテゴリ。 可能な値: 0:質問データタイプ:数値 (整数) デフォルト:0 |
| support_manager | ケースにアサインされた CSM マネージャーの sys_id。 データタイプ:文字列 テーブル:ユーザー [sys_user] |
| sync_driver | ドライバーの同期があるかどうかを示すフラグ。 可能な値:
データタイプ:ブーリアン |
| sys_class_name | ケースレコードを含むテーブル。 データタイプ:文字列 最大長:80 |
| sys_created_by | ケースを最初にオープンしたユーザー。 データタイプ:文字列 最大長:40 |
| sys_created_on | ケースが最初に作成された日時。 データタイプ:文字列 |
| sys_domain | ケースに関連付けられたドメイン。 データタイプ:文字列 最大長:32 デフォルト:global |
| sys_domain_path | ドメインパス。 データタイプ:文字列 最大長:255 デフォルト:/ |
| sys_id | ケースの一意の識別子。 データタイプ:文字列 最大長:32 |
| sys_mod_count | ケースが最初に作成されてからの更新回数。 データタイプ:数値 (整数) |
| sys_tags | システムタグ。 |
| sys_updated_by | ケースを最後に更新したユーザー。 データタイプ:文字列 最大長:40 |
| sys_updated_on | ケースが最後に更新された日時。 データタイプ:文字列 |
| time_worked | ケースの合計作業時間。 データタイプ:文字列 |
| upon_approval | ケースが承認された場合に実行するアクション。 可能な値:
データタイプ:文字列 最大長:40 デフォルト:proceed |
| upon_reject | ケースが却下された場合に実行するアクション。 可能な値:
データタイプ:文字列 最大長:40 デフォルト:cancel |
| urgency | ケースの緊急度。 可能な値:
データタイプ:数値 (整数) デフォルト値:3 |
| user_input | 追加のユーザー入力。 データタイプ:文字列 最大長:4,000 |
| variable_pool | 変数のグループ化。 |
| variables | ケースに関連付けられた変数の名前と値のペア。 データタイプ:文字列 最大長:40 |
| watch_list | 追加のコメントが追加された場合、またはケースのステータスが「解決済み」または「クローズ済み」に変更された場合に、このケースに関する通知を受信するユーザーの sys_id のリスト。 データタイプ:アレイ テーブル:ユーザー [sys_user] |
| wf_activity | ケースに関連付けられたワークフローアクティビティレコードの sys_id。 データタイプ:文字列 テーブル:ワークフローアクティビティ [wf_activity] |
| work_end | ケースの作業が終了した日時。 データタイプ:文字列 |
| work_notes | ケースの解決方法に関する情報、またはケースの解決手順。 データタイプ:文字列 最大長:4,000 |
| work_notes_list | 作業メモが追加されたときに、このケースについての通知を受け取る内部ユーザーの sys_id のリスト。 データタイプ:アレイ テーブル:ユーザー [sys_user] |
| work_start | ケースの作業が開始された日時。 データタイプ:文字列 |
要求本文パラメーターに関する注意事項
要求本文パラメーターはすべてオプションです。すべてのパラメーターがすべてのケースタイプ (B2B と B2C、注文と製品) に適用されるわけではありません。設定するパラメーターが競合していないことを確認してください (アカウントと連絡先またはコンシューマーの間の不一致など)。以下で定義する要素のリスト (ベースシステムにある要素を定義するもの) に加えて、エンドポイントでは、インスタンスで構成されたカスタムケースフィールドと追加のケースフィールドも受け入れます。これらの要素の詳細については、特定のテーブル定義[].
cURL 要求
次の例は、コンシューマーベースのケースを更新する方法を示しています。
curl "https://instance.servicenow.com/api/sn_cusomerservice/case/0397c743db436f0057c3fd441d96197f" \
--request PUT \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{ \
consumer: \"cd97ef1ddb8bc7006b7a9646db9619ac\", \
contact_type: \"phone\", \
priority: \"4\", \
short_description: \"Consumer Test Case\"}" \
--user "username":"password"
{
"result": {
"sys_id": "0397c743db436f0057c3fd441d96197f",
"number": "CS0001005"
}
}