ケース API

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:310分
  • ケース 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 ロールが必要です。

    注:
    フルネームまたは短縮名 (sysparm_ プリフィックスなし) を使用して、すべての sysparm クエリパラメーターを参照できます。たとえば、sysparm_limit の場合は limit も使用できます。

    URL 形式

    バージョニングされた URL:/api/sn_customerservice/{api_version}/case/{id}/activities

    デフォルトの URL:/api/sn_customerservice/case/{id}/activities

    注:
    利用可能なバージョンは、 REST API エクスプローラーで指定されます。スクリプト済み REST API の場合、[ スクリプト済み REST サービス] フォームに追加のバージョン情報があります。

    サポートされている要求パラメーター

    表 : 1. パスパラメーター
    名前 説明
    api_version オプションアクセスするエンドポイントのバージョン。たとえば、v1v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。

    データタイプ:文字列

    ID 取得するケースの sys_id またはケース番号。指定されたケース番号が複数のケースで共有されている場合、結果は予測できません。

    データタイプ:文字列

    テーブル:ケース [sn_customerservice_case]

    表 : 2. クエリパラメーター
    名前 説明
    sysparm_activity_type アクティビティストリームから返すアクティビティのタイプをフィルターします。entries.element パラメーターには、各アクティビティのアクティビティタイプが含まれています。
    例:
    • sysparm_activity_type=attachment
    • sysparm_activity_type=work_notes
    • sysparm_activity_type=attachment,work_notes
    • sysparm_ activity_type=attachment,work_notes,comments

    データタイプ:文字列

    デフォルト:すべてのタイプのアクティビティを返します。

    sysparm_limit 返されるレコードの最大数。異常に大きい sysparm_limit 値はシステムパフォーマンスに影響する可能性があります。このレコード数を超える要求の場合は、sysparm_offset パラメーターを使用してレコード取得をページネーションします。

    データタイプ:数値

    sysparm_offset レコード取得を開始するレコードのインデックス。この値を使用して、レコード取得をページネーションします。この機能により、レコード数に関係なく、管理しやすい小さなチャンクに分割してすべてのレコードを取得できます。

    たとえば、このエンドポイントを初めて呼び出すときに、sysparm_offset は「0」に設定されます。単に利用可能なすべてのレコードをページングするには、すべてのレコードの終わりに達するまで「sysparm_offset=sysparm_offset+sysparm_limit」を使用します。

    sysparm_offset パラメーターには負数を指定しないでください。

    データタイプ:数値

    デフォルト:0

    表 : 3. 要求本文パラメーター (XML または JSON)
    名前 説明
    なし

    ヘッダー

    次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 4. 要求ヘッダー
    ヘッダー 説明
    承認 応答本文のデータフォーマット。サポートされるタイプ:application/json または application/xml

    デフォルト: application/json

    表 : 5. 応答ヘッダー
    ヘッダー 説明
    リンク REST 応答データは、複数の結果セットに分割できます。応答ヘッダーには、必要に応じて最初のセット、前のセット、次のセット、最後のセットのレコードに対する各種リンクがあります。

    例:

    https://<インスタンス名>.service-now.com/api/now/table/cmdb_ci?sysparm_offset=40&sysparm_limit=1000>;rel="next"

    https://<インスタンス名>.service-now.com/api/now/table/cmdb_ci?sysparm_offset=40&sysparm_limit=1000>;rel="prev"

    https://<インスタンス名>.service-now.com/api/now/table/cmdb_ci?sysparm_offset=0&sysparm_limit=1000>;rel="first"

    https://<インスタンス名>.service-now.com/api/now/table/cmdb_ci?sysparm_offset=2780&sysparm_limit=1000>;rel="last"

    X-Total-Count sysparm_limit または sysparm_offset クエリパラメーターが指定されている場合、要求に一致するレコードの合計数を示す応答ヘッダー。

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 6. ステータスコード
    ステータスコード 説明
    200 成功。要求が正常に処理されました。
    401 権限がありません。ユーザー資格情報が間違っているか、渡されていません。
    404 見つかりません。要求されたアイテムが見つかりませんでした。
    500 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。

    応答本文のパラメーター (JSON または XML)

    名前 説明
    display_value CSM ケースのケース番号。

    データタイプ:文字列

    エントリー CSM ケースのアクティビティストリームエントリを表すリスト。

    データタイプ:オブジェクトのアレイ

    "entries": [
      {
        "attachment": {Object},
        "contains_code": Boolean,
        "element": "String",
        "field_label": "String",
        "initials": "String",
        "login_name": "String",
        "name": "String",
        "sys_created_on": "String",
        "sys_created_on_adjusted": "String",
        "sys_id": "String",
        "user_sys_id": "String",
        "value": "String"
      }
    ]
    entries.attachment アクティビティストリームエントリの CSM ケースに添付されたファイルの説明。

    データタイプ:オブジェクト

    "attachment": {
      "average_image_color": "String",
      "content_type": "String",
      "file_name": "String",
      "image_height": Number,
      "image_path": "String",
      "image_width": Number,
      "path": "String",
      "size": "String",
      "size_bytes": Number,
      "state": "String",
      "sys_id": "String",
      "thumbnail_path": "String"
    }
    entries.attachment.average_image_color 画像添付ファイルの平均色の 16 進数表現。

    データタイプ:文字列

    entries.attachment.content_type 添付ファイルの MIME タイプ。
    例:
    • application/pdf
    • image/jpeg
    • message/rfc822

    データタイプ:文字列

    entries.attachment.file_name 添付ファイルのファイル名。

    データタイプ:文字列

    entries.attachment.image_height 画像添付ファイルの高さ (ピクセル)。

    データタイプ:数値

    entries.attachment.image_path 画像添付ファイルの直接ダウンロードリンク。

    データタイプ:文字列

    entries.attachment.image_width 画像添付ファイルの幅 (ピクセル)。

    データタイプ:数値

    entries.attachment.path 添付ファイルへの直接リンク。

    データタイプ:文字列

    entries.attachment.size 添付ファイルのサイズ。
    例:
    • 157.7 KB
    • 2.2 MB

    データタイプ:文字列

    entries.attachment.size_bytes 添付ファイルのサイズ。

    データタイプ:数値

    単位:バイト

    entries.attachment.state 添付ファイルレコードのステータス。
    可能な値:
    • 利用可能
    • 条件付きで利用可能
    • 利用不可
    • 処理待ち

    データタイプ:文字列

    テーブル:添付ファイル [sys_attachment]

    entries.attachment.sys_id 添付ファイルの sys_id。

    データタイプ:文字列

    テーブル:添付ファイル [sys_attachment]

    entries.attachment.thumbnail_path 画像添付ファイルのサムネイルの直接ダウンロードリンク。

    データタイプ:文字列

    entries.contains_code アクティビティストリームエントリにコードが含まれているかどうかを示すフラグ。
    可能な値:
    • true:アクティビティストリームエントリにコードが含まれています。
    • false:アクティビティストリームエントリにはコードが含まれていません。

    データタイプ:ブーリアン

    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": Boolean,
        "can_write": Boolean,
        "color": "String",
        "label": "String",
        "name": "String"
      }
    ]
    journal_fields.can_read ログインしているユーザーがこのジャーナルフィールドを読み取れるかどうかを示すフラグ。
    可能な値:
    • true:ログインしているユーザーはこのジャーナルフィールドを読み取ることができます。
    • false:ログインしているユーザーは、このジャーナルフィールドを読み取ることができません。

    データタイプ:ブーリアン

    journal_fields.can_write ログインしているユーザーがジャーナルフィールドに書き込みできるかどうかを示すフラグ。
    可能な値:
    • true:ログインしているユーザーはこのジャーナルフィールドに書き込むことができます。
    • false:ログインしているユーザーは、このジャーナルフィールドに書き込むことができません。

    データタイプ:ブーリアン

    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 クエリパラメーターを使用して依存関係の親フィールドの値を指定し、それに応じて返されるフィールド値を制限できます。依存フィールドの詳細については、「 フィールドに依存する」を参照してください。

    注:
    フルネームまたは短縮名 (sysparm_ プリフィックスなし) を使用して、すべての sysparm クエリパラメーターを参照できます。たとえば、sysparm_limit の場合は limit も使用できます。

    URL 形式

    バージョニングされた URL:/api/sn_customerservice/{api_version}/case/field_values/{field_name}

    デフォルトの URL:/api/sn_customerservice/case/field_values/{field_name}

    注:
    利用可能なバージョンは、 REST API エクスプローラーで指定されます。スクリプト済み REST API の場合、[ スクリプト済み REST サービス] フォームに追加のバージョン情報があります。

    サポートされている要求パラメーター

    表 : 7. パスパラメーター
    名前 説明
    api_version オプションアクセスするエンドポイントのバージョン。たとえば、v1v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。

    データタイプ:文字列

    field_name 選択肢または参照フィールドの名前。

    データタイプ:文字列

    テーブル:ケース [sn_customerservice_case]

    表 : 8. クエリパラメーター
    名前 説明
    sysparm_dependent_value 要求されたフィールドが依存しているケース [sn_customerservice_case] テーブル選択フィールドで選択する値。別のフィールドに依存する選択フィールドを要求する場合にのみ使用します。

    例として、デフォルトの Channel 選択フィールドに依存するカスタムチャネルインスタンス選択フィールドをケーステーブルに作成するとします。sysparm_dependent_value が指定されていない場合、このエンドポイントはカスタムフィールドの値の完全なセットを返します。代わりに、Channel フィールドから Phone CSM チャネルが選択されたときに利用可能なカスタムフィールド値のサブセットのみを返すには、次のように指定します。

    sysparm_dependent_value=Phone

    データタイプ:文字列

    sysparm_limit 返されるレコードの最大数。異常に大きい sysparm_limit 値はシステムパフォーマンスに影響する可能性があります。このレコード数を超える要求の場合は、sysparm_offset パラメーターを使用してレコード取得をページネーションします。

    データタイプ:数値

    sysparm_offset レコード取得を開始するレコードのインデックス。この値を使用して、レコード取得をページネーションします。この機能により、レコード数に関係なく、管理しやすい小さなチャンクに分割してすべてのレコードを取得できます。

    たとえば、このエンドポイントを初めて呼び出すときに、sysparm_offset は「0」に設定されます。単に利用可能なすべてのレコードをページングするには、すべてのレコードの終わりに達するまで「sysparm_offset=sysparm_offset+sysparm_limit」を使用します。

    sysparm_offset パラメーターには負数を指定しないでください。

    データタイプ:数値

    デフォルト:0

    sysparm_reference_field_columns 応答で返される、指定した参照フィールドのテーブルからの列名のカンマ区切りリスト。たとえば、指定した参照フィールドが連絡先である場合、連絡先テーブルにあるすべてのフィールドのリストが含まれます。

    データタイプ:文字列

    sysparm_query 結果セットのフィルタリングに使用されるエンコードされたクエリ。このパラメーターを使用して定義されたクエリは、参照修飾子によって生成されたエンコードされたクエリに追加されます。

    例:

    (sysparm_query=caller_id=javascript:gs.getUserID()^active=true)

    エンコードされたクエリは、 順序 をサポートしています。特定のフィールドに基づいて回答を並べ替えるには、ORDERBYORDERBYDESC の句を sysparm_query で使用します。たとえば、sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory はすべてのアクティブなレコードをフィルタリングし、最初に番号によって昇順に、次にカテゴリによって降順に結果を並び替えます。

    フィールド名が無効というようにクエリの一部が無効であると、インスタンスは無効な部分を無視します。次に、クエリの有効部分のみを使用して行を返します。この動作は glide.invalid_query.returns_no_rows プロパティを使用してコントロールできます。無効なクエリに行を返さないようにするには、このプロパティを true に設定します。
    注:
    glide.invalid_query.returns_no_rows プロパティは、リスト、スクリプト (GlideRecord.query())、Web サービス API など、インスタンスのすべてのクエリの動作を管理します。

    データタイプ:文字列

    sysparm_ref_qual_input JavaScript 関数を使用する参照修飾子に渡す、現在のオブジェクトを表すエンコードされたフィールド値のセット。参照フィールドを要求する場合にのみ使用します。

    たとえば、 Asset フィールドから値を要求する場合、指定されたケースに関連付けられた製品に属する資産ではなく、指定された製品に属する資産のみを返すようにこのクエリパラメーター値を設定できます。

    sysparm_ref_qual_input=product=5d1b7bb053401010dc25ddeeff7b129d

    データタイプ:文字列

    構文:{field1}={value1}^{field2}={value2}[…]

    表 : 9. 要求本文パラメーター (XML または JSON)
    名前 説明
    なし

    ヘッダー

    次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 10. 要求ヘッダー
    ヘッダー 説明
    承認 応答本文のデータフォーマット。サポートされるタイプ:application/json または application/xml

    デフォルト: application/json

    表 : 11. 応答ヘッダー
    ヘッダー 説明
    リンク REST 応答データは、複数の結果セットに分割できます。応答ヘッダーには、必要に応じて最初のセット、前のセット、次のセット、最後のセットのレコードに対する各種リンクがあります。

    例:

    https://<インスタンス名>.service-now.com/api/now/table/cmdb_ci?sysparm_offset=40&sysparm_limit=1000>;rel="next"

    https://<インスタンス名>.service-now.com/api/now/table/cmdb_ci?sysparm_offset=40&sysparm_limit=1000>;rel="prev"

    https://<インスタンス名>.service-now.com/api/now/table/cmdb_ci?sysparm_offset=0&sysparm_limit=1000>;rel="first"

    https://<インスタンス名>.service-now.com/api/now/table/cmdb_ci?sysparm_offset=2780&sysparm_limit=1000>;rel="last"

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 12. ステータスコード
    ステータスコード 説明
    200 成功。要求が正常に処理されました。
    400 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。
    401 権限がありません。ユーザー資格情報が間違っているか、渡されていません。
    500 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。

    応答本文のパラメーター (JSON または XML)

    名前 説明
    結果 要求されたフィールドの値のリスト。

    データタイプ:オブジェクトのアレイ

    "result": [
      {
        "label": "String",
        "value": "String"
      }
    ]
    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 クエリパラメーターを使用して、依存関係の親フィールドからの選択を上書きできます。例については、以下のクエリパラメーターのリストを参照してください。

    注:
    フルネームまたは短縮名 (sysparm_ プリフィックスなし) を使用して、すべての sysparm クエリパラメーターを参照できます。たとえば、sysparm_limit の場合は limit も使用できます。

    URL 形式

    バージョニングされた URL:/api/sn_customerservice/{api_version}/case/{id}/field_values/{field_name}

    デフォルトの URL:/api/sn_customerservice/case/{id}/field_values/{field_name}

    注:
    利用可能なバージョンは、 REST API エクスプローラーで指定されます。スクリプト済み REST API の場合、[ スクリプト済み REST サービス] フォームに追加のバージョン情報があります。

    サポートされている要求パラメーター

    表 : 13. パスパラメーター
    名前 説明
    api_version オプションアクセスするエンドポイントのバージョン。たとえば、v1v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。

    データタイプ:文字列

    field_name 選択肢または参照フィールドの名前。

    データタイプ:文字列

    テーブル:ケース [sn_customerservice_case]

    ID 参照修飾子を評価するときに使用するレコードのSys_id。

    データタイプ:文字列

    テーブル:ケース [sn_customerservice_case]

    表 : 14. クエリパラメーター
    名前 説明
    sysparm_dependent_value 要求されたフィールドが依存しているケース [sn_customerservice_case] テーブル選択フィールドで選択する値。別のフィールドに依存する選択フィールドを要求する場合にのみ使用します。

    例として、デフォルトの Channel 選択フィールドに依存するカスタムチャネルインスタンス選択フィールドをケーステーブルに作成するとします。sysparm_dependent_value が指定されていない場合、このエンドポイントはカスタムフィールドの値の完全なセットを返します。代わりに、Channel フィールドから Phone CSM チャネルが選択されたときに利用可能なカスタムフィールド値のサブセットのみを返すには、次のように指定します。

    sysparm_dependent_value=Phone

    データタイプ:文字列

    sysparm_limit 返されるレコードの最大数。異常に大きい sysparm_limit 値はシステムパフォーマンスに影響する可能性があります。このレコード数を超える要求の場合は、sysparm_offset パラメーターを使用してレコード取得をページネーションします。

    データタイプ:数値

    sysparm_offset レコード取得を開始するレコードのインデックス。この値を使用して、レコード取得をページネーションします。この機能により、レコード数に関係なく、管理しやすい小さなチャンクに分割してすべてのレコードを取得できます。

    たとえば、このエンドポイントを初めて呼び出すときに、sysparm_offset は「0」に設定されます。単に利用可能なすべてのレコードをページングするには、すべてのレコードの終わりに達するまで「sysparm_offset=sysparm_offset+sysparm_limit」を使用します。

    sysparm_offset パラメーターには負数を指定しないでください。

    データタイプ:数値

    デフォルト:0

    sysparm_query 結果セットのフィルタリングに使用されるエンコードされたクエリ。このパラメーターを使用して定義されたクエリは、参照修飾子によって生成されたエンコードされたクエリに追加されます。

    例:

    (sysparm_query=caller_id=javascript:gs.getUserID()^active=true)

    エンコードされたクエリは、 順序 をサポートしています。特定のフィールドに基づいて回答を並べ替えるには、ORDERBYORDERBYDESC の句を sysparm_query で使用します。たとえば、sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory はすべてのアクティブなレコードをフィルタリングし、最初に番号によって昇順に、次にカテゴリによって降順に結果を並び替えます。

    フィールド名が無効というようにクエリの一部が無効であると、インスタンスは無効な部分を無視します。次に、クエリの有効部分のみを使用して行を返します。この動作は 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 フィールドから値を要求する場合、指定されたケースに関連付けられた製品に属する資産ではなく、指定された製品に属する資産のみを返すようにこのクエリパラメーター値を設定できます。

    sysparm_ref_qual_input=product=5d1b7bb053401010dc25ddeeff7b129d

    データタイプ:文字列

    構文:{field1}={value1}^{field2}={value2}[…]

    表 : 15. 要求本文パラメーター (XML または JSON)
    名前 説明
    なし

    ヘッダー

    次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 16. 要求ヘッダー
    ヘッダー 説明
    承認 応答本文のデータフォーマット。サポートされるタイプ:application/json または application/xml

    デフォルト: application/json

    表 : 17. 応答ヘッダー
    ヘッダー 説明
    リンク REST 応答データは、複数の結果セットに分割できます。応答ヘッダーには、必要に応じて最初のセット、前のセット、次のセット、最後のセットのレコードに対する各種リンクがあります。

    例:

    https://<インスタンス名>.service-now.com/api/now/table/cmdb_ci?sysparm_offset=40&sysparm_limit=1000>;rel="next"

    https://<インスタンス名>.service-now.com/api/now/table/cmdb_ci?sysparm_offset=40&sysparm_limit=1000>;rel="prev"

    https://<インスタンス名>.service-now.com/api/now/table/cmdb_ci?sysparm_offset=0&sysparm_limit=1000>;rel="first"

    https://<インスタンス名>.service-now.com/api/now/table/cmdb_ci?sysparm_offset=2780&sysparm_limit=1000>;rel="last"

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 18. ステータスコード
    ステータスコード 説明
    200 成功。要求が正常に処理されました。
    400 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。
    401 権限がありません。ユーザー資格情報が間違っているか、渡されていません。
    500 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。

    応答本文のパラメーター (JSON または XML)

    名前 説明
    結果 要求されたフィールドの値のリスト。

    データタイプ:オブジェクトのアレイ

    "result": [
      {
        "label": "String",
        "value": "String"
      }
    ]
    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 ロールが必要です。

    注:
    フルネームまたは短縮名 (sysparm_ プリフィックスなし) を使用して、すべての sysparm クエリパラメーターを参照できます。たとえば、sysparm_limit の場合は limit も使用できます。

    URL 形式

    バージョニングされた URL:/api/sn_customerservice/{api_version}/case/{id}

    デフォルトの URL:/api/sn_customerservice/case/{id}

    注:
    利用可能なバージョンは、 REST API エクスプローラーで指定されます。スクリプト済み REST API の場合、[ スクリプト済み REST サービス] フォームに追加のバージョン情報があります。

    サポートされている要求パラメーター

    表 : 19. パスパラメーター
    名前 説明
    api_version オプションアクセスするエンドポイントのバージョン。たとえば、v1v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。

    データタイプ:文字列

    id 取得するケースの sys_id またはケース番号。指定されたケース番号が複数のケースで共有されている場合、結果は予測できません。

    データタイプ:文字列

    テーブル:ケース [sn_customerservice_case]

    表 : 20. クエリパラメーター
    名前 説明
    sysparm_display_value 返されるデータ (データベースからの実際の値またはフィールドの表示値) のタイプを決定します。表示値は、データベース内の実際の値と、ユーザーやシステムの設定と環境設定に基づいて操作されます。
    表示値を返す場合、返される値はフィールドタイプに依存します。
    • 選択肢フィールド:データベース値は数値にできますが、表示値の方がわかりやすくなります。
    • 日付フィールド:データベース値は UTC 形式で、表示値はユーザーのタイムゾーンに基づいたものになります。
    • 暗号化テキスト:データベース値は暗号化されますが、表示値はユーザーの暗号化コンテキストに基づいて非暗号化されます。
    • 参照フィールド:データベース値は sys_id ですが、表示値は参照レコードの表示フィールドになります。

    データタイプ:文字列

    有効な値:

    • true:すべてのフィールドに対して表示値が返されます。
    • false:データベースから実際の値が返されます。
    • all:実際の値と表示値の両方が返されます。

    デフォルト値:false

    注:
    このパラメーター設定に推奨方法はありません。ただし、表示値を指定すると、データベースから直接読み取られず、その他のフィールドやレコードを参照することがあるため、パフォーマンスに問題が発生する可能性があります。表示値と実際の値の詳細については、「テーブル API FAQ (KB0534905)」を参照してください。
    表 : 21. 要求本文パラメーター (XML または JSON)
    名前 説明
    なし

    ヘッダー

    次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 22. 要求ヘッダー
    ヘッダー 説明
    承認 応答本文のデータフォーマット。サポートされるタイプ:application/json または application/xml

    デフォルト: application/json

    表 : 23. 応答ヘッダー
    ヘッダー 説明
    なし

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 24. ステータスコード
    ステータスコード 説明
    200 成功。要求が正常に処理されました。
    404 要求が無効であることを示します。次のいずれかの理由が考えられます。
    • 要求されたケースが存在しません。
    • ユーザーにはケースへのアクセス権がありません。

    応答本文のパラメーター (JSON または XML)

    要素 説明
    account
    ケースに関連付けられたアカウントレコードの sys_id。

    データタイプ:文字列

    テーブル:アカウント [customer_account]

    account アカウントの詳細。

    データタイプ:オブジェクト

    "account": {
      "account_code": "String",
      "account_parent": "String",
      "account_path": "String",
      "active_escalation": "String",
      "apple_icon": Image,
      "banner_image": Image,
      "banner_image_light": Image,
      "banner_text": "String",
      "city": "String",
      "contact": "String",
      "country": "String",
      "customer": "String",
      "discount": "String",
      "fax_phone": "String",
      "fiscal_year": "String",
      "lat_long_error": "String",
      "latitude": "String",
      "longitude": "String",
      "market_cap": "String",
      "name": "String",
      "notes": "String",
      "num_employees": Number,
      "number": "String",
      "parent": "String",
      "partner": "String",
      "phone": "String",
      "primary": Boolean,
      "primary_contact": "String",
      "profits": Number,
      "publicly_traded": Boolean,
      "rank_tier": "String",
      "registration_code": "String",
      "revenue_per_year": Number,
      "state": "String",
      "stock_price": "String",
      "stock_symbol": "String",
      "street": "String",
      "sys_class_name": "String",
      "sys_created_by": "String",
      "sys_created_on": "String",
      "sys_id": "String",
      "sys_mod_count": Number,
      "sys_updated_by": "String",
      "sys_updated_on": "String",
      "theme": "String",
      "vendor": Boolean,
      "vendor_manager": "String",
      "vendor_type": "String",
      "website": "String",
      "zip": "String
    }
    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 アカウントがパートナーアカウントではなく、顧客アカウントであるかどうかを示すフラグ。
    可能な値:
    • true:顧客アカウント
    • false:パートナーアカウント

    データタイプ:ブール

    デフォルト値: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 このアカウントに関連付けられている会社が商品を製造しているかどうかを示すフラグ。

    可能な値:

    • true:商品を製造している
    • false:商品を製造していない

    データタイプ:ブール

    デフォルト値: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 アカウントがパートナーアカウントか顧客アカウントかを示すフラグ。

    可能な値:

    • true:パートナーアカウント
    • false:顧客アカウント

    データタイプ:ブール

    デフォルト値:false

    account.phone 会社の主要な電話番号。

    データタイプ:文字列

    account.primary これがプライマリアカウントであるかどうかを示すフラグ。

    可能な値:

    • true:プライマリアカウント
    • false:セカンダリアカウント

    データタイプ:ブール

    デフォルト値:false

    account.primary_contact アカウントの主連絡先の sys_id。

    データタイプ:文字列

    テーブル:連絡先 [customer_contact]

    account.profits このアカウントに対して入力された利益情報。

    データタイプ:数値 (通貨)

    最大長:40

    account.publicly_traded このアカウントに関連付けられている会社の株式が証券取引所で公開されているかどうかを示すフラグ。

    可能な値:

    • true:株式公開
    • false:株式非公開会社

    データタイプ:ブール

    account.rank_tier アカウントのタイプ。

    可能な値:

    • blacklist
    • その他
    • strategic
    • tactical
    • valued

    データタイプ:文字列

    最大長: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 このアカウントに関連付けられている会社がベンダーかどうかを示すフラグ。

    可能な値:

    • true:ベンダー
    • false:ベンダーではない

    データタイプ:ブール

    デフォルト値: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:ケースはアクティブです。
    • false:ケースはクローズされました。

    データタイプ:ブール

    デフォルト: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 必要な承認のタイプを説明する文字列。

    可能な値:

    • approved
    • cancelled
    • duplicate
    • not_required
    • not requested
    • rejected
    • requested

    データタイプ:文字列

    最大文字数: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 ケースカテゴリ。

    可能な値:

    • 0:質問
    • 1:問題
    • 2:機能

    データタイプ:数値 (整数)

    デフォルト値:1

    cause 問題の原因に関する詳細。

    データタイプ:文字列

    最大長:4,000

    caused_by ケースが作成される原因となった変更要求の sys_id。

    データタイプ:文字列

    テーブル:変更要求 [change_request]

    変更 ケースが作成される原因となった変更要求の sys_id。

    データタイプ:文字列

    テーブル:変更要求 [change_request]

    child_case_creation_progress ケースが重大なケースから作成された子ケースであるかどうかを示すフラグ。

    可能な値:

    • true:重大なケースから作成された子ケース
    • false:子ケースではありません

    データタイプ:ブール

    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:コンシューマーがアクティブ
    • false:コンシューマーが非アクティブ

    データタイプ:ブール

    デフォルト:true

    consumer.business_phone コンシューマーの勤務先電話番号。

    データタイプ:文字列

    最大長:40

    consumer.city コンシューマーが居住する市区町村。

    データタイプ:文字列

    最大長:100

    consumer.country コンシューマーが居住する国。

    データタイプ:文字列

    最大長:40

    consumer.date_format 日付を表示する形式。

    有効な値:

    • dd-mm-yyyy
    • dd/mm/yyyy
    • dd.mm.yyyy
    • mm-dd-yyyy
    • yyyy-mm-dd

    データタイプ:文字列

    最大長: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 コンシューマーが通知を受信するかどうかを示します。

    有効な値:

    • 1:無効
    • 2:有効

    データタイプ:数値 (整数)

    最大長:40

    デフォルト値:2

    consumer.number コンシューマーに関連付けられた一意の番号。

    データタイプ:文字列

    最大長:40

    consumer.photo コンシューマーの写真。

    データタイプ:画像

    consumer.preferred_language コンシューマーのプライマリ言語。

    データタイプ:文字列

    最大長:3

    consumer.prefix Dr.、Mr.、Mrs.、Ms. などのコンシューマー名のプリフィックス

    データタイプ:文字列

    最大長:40

    consumer.primary これがプライマリコンシューマーであるかどうかを示すフラグ。

    可能な値:

    • true:プライマリコンシューマー
    • false:プライマリコンシューマーではない

    データタイプ:ブール

    デフォルト値: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 時間を表示する形式。

    有効な値:

    • hh.mm.ss a: hh.mm.ss (12 時間制)
    • hh:mm:ss a: hh:mm:ss (12 時間制)
    • HH.mm.ss: hh.mm.ss (24 時間制)
    • HH:mm:ss: hh:mm:ss (24 時間制)

    データタイプ:文字列

    最大長: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:連絡先はアクティブです。
    • false:連絡先は非アクティブです。

    データタイプ:ブール

    デフォルト: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 連絡先に日付を表示する形式。

    有効な値:

    • dd/mm/yyyy
    • dd-mm-yyyy
    • dd.mm.yyyy
    • mm-dd-yyyy
    • yyyy-mm-dd

    データタイプ:文字列

    最大長: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 連絡先がサービスポータルにログインするためにマルチファクター認証が必要かどうかを示すフラグ。

    可能な値:

    • true:マルチファクター認証が有効
    • false:マルチファクター認証が無効

    データタイプ:ブール

    デフォルト値:false

    contact.failed_attempts 失敗したログイン試行回数。

    データタイプ:数値 (整数)

    contact.first_name 連絡先の名。

    データタイプ:文字列

    最大長:50

    contact.gender 連絡先の性別。

    データタイプ:文字列

    最大長:40

    contact.geolocation_tracked 連絡先の場所が位置情報追跡によって取得されたかどうかを示すフラグ。

    可能な値:

    • true:連絡先の場所は位置情報追跡によって取得された
    • false:連絡先の場所は位置情報追跡によって取得されていない

    データタイプ:ブール

    デフォルト値:false

    contact.home_phone 連絡先の自宅電話番号。

    データタイプ:文字列

    最大長:40

    contact.internal_integration_user 連絡先が内部統合ユーザーかどうかを示すフラグ。

    可能な値:

    • true:内部統合ユーザー
    • false:他のタイプのユーザー

    データタイプ:ブール

    デフォルト値: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 連絡先がロックアウトされているかどうかを示すフラグ。

    可能な値:

    • true:連絡先がロックアウトされました
    • false:連絡先はロックアウトされていません

    データタイプ:ブール

    デフォルト値:false

    contact.longitude 連絡先の経度座標。

    データタイプ:数値 (浮動小数点)

    最大長:40

    contact.manager 連絡先の直属の上司を説明するレコードのSys_id。

    データタイプ:文字列

    テーブル:ユーザー [sys_user]

    contact.middle_name 連絡先のミドルネーム。

    データタイプ:数値 (浮動小数点)

    最大長:50

    contact.mobile_phone 連絡先の携帯電話番号。

    データタイプ:文字列

    最大長:40
    contact.name 連絡先のフルネーム。

    データタイプ:文字列

    最大長:151

    contact.notification 連絡先が通知を受信するかどうかを示します。

    有効な値:

    • 1:無効
    • 2:有効

    データタイプ:数値 (整数)

    デフォルト値:2

    contact.on_schedule ディスパッチされたサービス担当者の適時性を示します。

    有効な値:

    • Ahead:スケジュールの前倒し。
    • behind_less30:スケジュール遅延 (ただし 30 分未満)。
    • behind_30to60:スケジュール遅延 (30 ~ 60 分)。
    • behind_more60:スケジュール遅延 (60 分超)。
    • on_time:スケジュールどおり。

    データタイプ:文字列

    最大長: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 時間を表示する形式。

    有効な値:

    • hh.mm.ss a: hh.mm.ss (12 時間制)
    • hh:mm:ss a: hh:mm:ss (12 時間制)
    • HH.mm.ss: hh.mm.ss (24 時間制)
    • HH:mm:ss: hh:mm:ss (24 時間制)

    データタイプ:文字列

    最大長: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 ステータスかどうかを示すフラグ。

    可能な値:

    • true:VIP
    • false:VIP ではない

    データタイプ:ブール

    デフォルト値:false

    contact.web_service_access_only 連絡先が Web 経由でのみサービスにアクセスできるかどうかを示すフラグ。

    可能な値:

    • true:Web アクセスのみ
    • false:利用可能なすべての方法によるアクセス

    データタイプ:ブール

    デフォルト値:false

    contact.zip 連絡先の郵便番号。

    データタイプ:文字列

    最大長:40

    contact_local_time 連絡先の現地時間。

    データタイプ:文字列

    最大長:70

    contact_time_zone ケースに関連付けられた連絡先のタイムゾーン。

    データタイプ:文字列

    最大長:40

    contact_type ケースが最初にレポートされた方法。
    可能な値:
    • chat
    • email
    • phone
    • social
    • web

    データタイプ:文字列

    最大長: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:通常
    • 1:中
    • 2:高
    • 3:期限切れ

    データタイプ:数値 (整数)

    デフォルト:0

    expected_start ケースの作業開始予定日時。

    データタイプ:文字列

    first_response_time ケースに対して最初のアクションが実行された日時。

    データタイプ:文字列

    follow_the_sun ケースをグローバルフォローアップに渡す必要があるかどうかを示すフラグ。

    顧客が [優先度 1:重大] または [優先度 2 - 高] のケースにさらにコメントを入力した場合、またはケースが昇格された場合は、このフラグが自動的に true に設定されます。

    可能な値:

    • true:ケースをグローバルフォローアップに渡す必要があります
    • false:ケースをグローバルフォローアップに渡すべきではありません

    データタイプ:ブーリアン

    デフォルト値:false

    follow_up 次のフォローアップアクションの日時。

    データタイプ:文字列

    group_list ケースに関連付けられたグループレコードの sys_id のリスト。

    データタイプ:アレイ

    テーブル: Group [sys_user_group]

    影響 顧客への影響。

    可能な値:

    • 1 :高
    • 2 :中
    • 3:低

    データタイプ:数値 (整数)

    デフォルト値:3

    ナレッジ 指定された問題に利用可能なナレッジベース記事があるかどうかを示すフラグ。

    可能な値:

    • true:この問題に利用可能なナレッジベース記事があります
    • false:この問題に利用可能なナレッジベース記事がありません

    データタイプ:ブール

    デフォルト値:false

    location 会社の場所を説明するレコードの sys_id。

    データタイプ:文字列

    テーブル:場所 [cmn_location]

    made_sla ケースが関連するサービスレベルアグリーメントに従って解決されたかどうかを示すフラグ。

    可能な値:

    • true:SLA に従ってケースが解決されました
    • false:ケースは SLA に従って解決されませんでした

    データタイプ:ブーリアン

    デフォルト:true

    major_case_state 重大なケースの現在のステータス。

    可能な値:

    • accepted:マネージャーが重大なケースを作成したとき、またはマネージャーが候補ケースを昇格させたときの初期ステータス。
    • canceled:ケースがキャンセルされました。
    • proposed:エージェントまたはマネージャーが候補ケースを作成または提案したときの初期ステータス。
    • rejected:マネージャーが候補ケースを却下しました。

    データタイプ:文字列

    最大長:40

    needs_attention ケースに注意が必要かどうかを示すフラグ。

    可能な値:

    • true:ケースに追加の注意が必要です
    • false:ケースに追加の注意は必要ありません

    データタイプ:ブーリアン

    デフォルト値:false

    notes_to_comments 解決メモをコメントに追加するかどうかを示すフラグ。

    可能な値:

    • true:解決メモを追加すると、コメントにも追加されます
    • false:コメントに解決メモを含める必要はありません

    データタイプ:ブーリアン

    notify 連絡先/コンシューマーに通知するために使用する方法。

    可能な値:

    • 1:通知しない
    • 2:メール送信
    • 3:電話

    データタイプ:数値 (整数)

    デフォルト値: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 ケースの優先度。
    可能な値:
    • 1:重大
    • 2:高
    • 3:中
    • 4:低

    データタイプ:数値 (整数)

    デフォルト: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": "String",
        "value": "String"
      }
    ]
    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": "String",
        "channel": [Array],
        "contact": {Object},
        "consumer": {Object},
        "created_on": "String",
        "profile": "String",
        "profile_url": "String",
        "social_id": "String",
        "source": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_mod_count": Number,
        "sys_tags": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    sn_app_cs_social_social_profile.account ソーシャルメディアプロファイルのアカウント情報を含むレコードの一意の識別子。アカウント [customer_account] テーブルにあります。

    データタイプ:文字列

    sn_app_cs_social_social_profile.channel 関連するソーシャルメディアプロファイルチャネルの詳細。

    データタイプ:オブジェクト

    "channel": {
      "name": "String",
      "sys_class_name": "String",
      "sys_created_by": "String",
      "sys_created_on": "String",
      "sys_mod_count": Number,
      "sys_package": "String",
      "sys_policy": "String",
      "sys_scope": "String",
      "sys_tags": "String",
      "sys_update_name": "String",
      "sys_updated_by": "String",
      "sys_updated_on": "String"
    }
    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 企業/消費者間ケースの場合。ケースに関連付けられたコンシューマーの詳細。
    データタイプ:オブジェクト
    "consumer": {
      "active": Boolean,
      "business_phone": "String",
      "city": "String",
      "country": "String",
      "date_format": "String",
      "email": "String",
      "fax": "String",
      "first_name": "String",
      "gender": "String",
      "home_phone": "String",
      "household": "String",
      "last_name": "String",
      "middle_name": "String",
      "mobile_phone": "String",
      "name": "String",
      "notes": "String",
      "notification": Number,
      "number": "String",
      "photo": Image,
      "preferred_language": "String",
      "prefix": "String",
      "primary": Boolean,
      "state": "String",
      "street": "String",
      "suffix": "String",
      "sys_created_by": "String",
      "sys_created_on": "String",
      "sys_domain": "String",
      "sys_id": "String",
      "sys_mod_count": Number,
      "sys_tags": "String",
      "sys_updated_by": "String",
      "sys_updated_on": "String",
      "time_format": "String",
      "time_zone": "String",
      "title": "String",
      "user": "String",
      "zip": "String"
    }
    sn_app_cs_social_social_profile.consumer.active コンシューマーがアクティブかどうかを示すフラグ。

    可能な値:

    • true:コンシューマーがアクティブ
    • false:コンシューマーが非アクティブ

    データタイプ:ブール

    デフォルト: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 日付を表示する形式。

    有効な値:

    • dd-mm-yyyy
    • dd/mm/yyyy
    • dd.mm.yyyy
    • mm-dd-yyyy
    • yyyy-mm-dd

    データタイプ:文字列

    最大長: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 コンシューマーが通知を受信するかどうかを示します。

    有効な値:

    • 1:無効
    • 2:有効

    データタイプ:数値 (整数)

    最大長: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 これがプライマリコンシューマーであるかどうかを示すフラグ。

    可能な値:

    • true:プライマリコンシューマー
    • false:プライマリコンシューマーではない

    データタイプ:ブール

    デフォルト値: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 時間を表示する形式。

    有効な値:

    • hh.mm.ss a: hh.mm.ss (12 時間制)
    • hh:mm:ss a: hh:mm:ss (12 時間制)
    • HH.mm.ss: hh.mm.ss (24 時間制)
    • HH:mm:ss: hh:mm:ss (24 時間制)

    データタイプ:文字列

    最大長: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:連絡先はアクティブです。
    • false:連絡先は非アクティブです。

    データタイプ:ブール

    デフォルト: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 連絡先に日付を表示する形式。

    有効な値:

    • dd/mm/yyyy
    • dd-mm-yyyy
    • dd.mm.yyyy
    • mm-dd-yyyy
    • yyyy-mm-dd

    データタイプ:文字列

    最大長: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 連絡先がサービスポータルにログインするためにマルチファクター認証が必要かどうかを示すフラグ。

    可能な値:

    • true:マルチファクター認証が有効
    • false:マルチファクター認証が無効

    データタイプ:ブール

    デフォルト値: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 連絡先の場所が位置情報追跡によって取得されたかどうかを示すフラグ。

    可能な値:

    • true:連絡先の場所は位置情報追跡によって取得された
    • false:連絡先の場所は位置情報追跡によって取得されていない

    データタイプ:ブール

    デフォルト値:false

    sn_app_cs_social_social_profile.contact.home_phone 連絡先の自宅電話番号。

    データタイプ:文字列

    最大長:40

    sn_app_cs_social_social_profile.contact.internal_itegration_user 連絡先が内部統合ユーザーかどうかを示すフラグ。

    可能な値:

    • true:内部統合ユーザー
    • false:他のタイプのユーザー

    データタイプ:ブール

    デフォルト値: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 連絡先がロックアウトされているかどうかを示すフラグ。

    可能な値:

    • true:連絡先がロックアウトされました
    • false:連絡先はロックアウトされていません

    データタイプ:ブール

    デフォルト値: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 連絡先が通知を受信するかどうかを示します。

    有効な値:

    • 1:無効
    • 2:有効

    データタイプ:数値 (整数)

    デフォルト値:2

    sn_app_cs_social_social_profile.contact.on_schedule ディスパッチされたサービス担当者の適時性を示します。

    有効な値:

    • Ahead:スケジュールの前倒し。
    • behind_less30:スケジュール遅延 (ただし 30 分未満)。
    • behind_30to60:スケジュール遅延 (30 ~ 60 分)。
    • behind_more60:スケジュール遅延 (60 分超)。
    • on_time:スケジュールどおり。

    データタイプ:文字列

    最大長: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 時間を表示する形式。

    有効な値:

    • hh.mm.ss a: hh.mm.ss (12 時間制)
    • hh:mm:ss a: hh:mm:ss (12 時間制)
    • HH.mm.ss: hh.mm.ss (24 時間制)
    • HH:mm:ss: hh:mm:ss (24 時間制)

    データタイプ:文字列

    最大長: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 ステータスかどうかを示すフラグ。

    可能な値:

    • true:VIP
    • false:VIP ではない

    データタイプ:ブール

    デフォルト値:false

    sn_app_cs_social_social_profile.contact.web_service_access_only 連絡先が Web 経由でのみサービスにアクセスできるかどうかを示すフラグ。

    可能な値:

    • true:Web アクセスのみ
    • false:利用可能なすべての方法によるアクセス

    データタイプ:ブール

    デフォルト値: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:新規
    • 3:クローズ済み
    • 6:解決済み
    • 10:オープン
    • 18:情報待ち

    データタイプ:数値 (整数)

    デフォルト値:1

    subcategory ケースのサブカテゴリ。

    可能な値:

    0:質問

    データタイプ:数値 (整数)

    デフォルト:0

    support_manager ケースにアサインされた CSM マネージャーの sys_id。

    データタイプ:文字列

    テーブル:ユーザー [sys_user]

    sync_driver ドライバーの同期があるかどうかを示すフラグ。

    可能な値:

    • true:ドライバーは同期されています
    • false:ドライバーが同期されていません

    データタイプ:ブーリアン

    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 ケースが承認された場合に実行するアクション。

    可能な値:

    • do_nothing
    • proceed

    データタイプ:文字列

    最大長:40

    デフォルト:proceed

    upon_reject ケースが却下された場合に実行するアクション。

    可能な値:

    • cancel
    • goto

    データタイプ:文字列

    最大長:40

    デフォルト:cancel

    urgency ケースの緊急度。

    可能な値:

    • 1 :高
    • 2 :中
    • 3:低

    データタイプ:数値 (整数)

    デフォルト値: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 degradation​CS0000871",
        "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 ロールが必要です。

    注:
    フルネームまたは短縮名 (sysparm_ プリフィックスなし) を使用して、すべての sysparm クエリパラメーターを参照できます。たとえば、sysparm_limit の場合は limit も使用できます。

    URL 形式

    バージョニングされた URL:/api/sn_customerservice/{api_version}/case

    デフォルトの URL:/api/sn_customerservice/case

    注:
    利用可能なバージョンは、 REST API エクスプローラーで指定されます。スクリプト済み REST API の場合、[ スクリプト済み REST サービス] フォームに追加のバージョン情報があります。

    サポートされている要求パラメーター

    表 : 25. パスパラメーター
    名前 説明
    api_version オプションアクセスするエンドポイントのバージョン。たとえば、v1v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。

    データタイプ:文字列

    表 : 26. クエリパラメーター
    名前 説明
    sysparm_display_value 参照フィールドと選択フィールドのデータ取得操作。

    この値に基づいてデータベースから表示値や実際の値を取得します。

    データタイプ:文字列

    有効な値:
    • true:すべてのフィールドに対して表示値が返されます。
    • false:データベースから実際の値が返されます。
    • all:実際の値と表示値の両方が返されます。

    デフォルト値:false

    注:
    このパラメーター設定に推奨方法はありません。ただし、表示値を指定すると、データベースから直接読み取られず、その他のフィールドやレコードを参照することがあるため、パフォーマンスに問題が発生する可能性があります。表示値と実際の値の詳細については、「テーブル API FAQ (KB0534905)」を参照してください。
    sysparm_fields 応答で返すカンマ区切りのフィールドのリストです。無効なフィールドは無視されます。

    データタイプ:文字列

    デフォルト:すべてのフィールドを返します。

    sysparm_limit 返されるレコードの最大数。異常に大きい sysparm_limit 値はシステムパフォーマンスに影響する可能性があります。このレコード数を超える要求の場合は、sysparm_offset パラメーターを使用してレコード取得をページネーションします。

    データタイプ:数値

    sysparm_offset レコード取得を開始するレコードのインデックス。この値を使用して、レコード取得をページネーションします。この機能により、レコード数に関係なく、管理しやすい小さなチャンクに分割してすべてのレコードを取得できます。

    たとえば、このエンドポイントを初めて呼び出すときに、sysparm_offset は「0」に設定されます。単に利用可能なすべてのレコードをページングするには、すべてのレコードの終わりに達するまで「sysparm_offset=sysparm_offset+sysparm_limit」を使用します。

    sysparm_offset パラメーターには負数を指定しないでください。

    データタイプ:数値

    デフォルト:0

    sysparm_query 結果セットのフィルタリングに使用されるエンコードされたクエリ。

    例:

    (sysparm_query=caller_id=javascript:gs.getUserID()^active=true)

    エンコードされたクエリは、 順序 をサポートしています。特定のフィールドに基づいて回答を並べ替えるには、ORDERBYORDERBYDESC の句を sysparm_query で使用します。たとえば、sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory はすべてのアクティブなレコードをフィルタリングし、最初に番号によって昇順に、次にカテゴリによって降順に結果を並び替えます。

    フィールド名が無効というようにクエリの一部が無効であると、インスタンスは無効な部分を無視します。次に、クエリの有効部分のみを使用して行を返します。この動作は 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.
    表 : 27. 要求本文パラメーター (XML または JSON)
    名前 説明
    なし

    ヘッダー

    次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 28. 要求ヘッダー
    ヘッダー 説明
    承認 応答本文のデータフォーマット。サポートされるタイプ:application/json または application/xml

    デフォルト: application/json

    表 : 29. 応答ヘッダー
    ヘッダー 説明
    リンク REST 応答データは、複数の結果セットに分割できます。応答ヘッダーには、必要に応じて最初のセット、前のセット、次のセット、最後のセットのレコードに対する各種リンクがあります。

    例:

    https://<インスタンス名>.service-now.com/api/now/table/cmdb_ci?sysparm_offset=40&sysparm_limit=1000>;rel="next"

    https://<インスタンス名>.service-now.com/api/now/table/cmdb_ci?sysparm_offset=40&sysparm_limit=1000>;rel="prev"

    https://<インスタンス名>.service-now.com/api/now/table/cmdb_ci?sysparm_offset=0&sysparm_limit=1000>;rel="first"

    https://<インスタンス名>.service-now.com/api/now/table/cmdb_ci?sysparm_offset=2780&sysparm_limit=1000>;rel="last"

    X-Total-Count sysparm_limit または sysparm_offset クエリパラメーターが指定されている場合、要求に一致するレコードの合計数を示す応答ヘッダー。

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 30. ステータスコード
    ステータスコード 説明
    200 成功。要求が正常に処理されました。
    401 権限がありません。ユーザー資格情報が間違っているか、渡されていません。
    500 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。

    応答本文のパラメーター (JSON または XML)

    要素 説明
    account
    ケースに関連付けられたアカウントレコードの sys_id。

    データタイプ:文字列

    テーブル:アカウント [customer_account]

    account アカウントの詳細。

    データタイプ:オブジェクト

    "account": {
      "account_code": "String",
      "account_parent": "String",
      "account_path": "String",
      "active_escalation": "String",
      "apple_icon": Image,
      "banner_image": Image,
      "banner_image_light": Image,
      "banner_text": "String",
      "city": "String",
      "contact": "String",
      "country": "String",
      "customer": "String",
      "discount": "String",
      "fax_phone": "String",
      "fiscal_year": "String",
      "lat_long_error": "String",
      "latitude": "String",
      "longitude": "String",
      "market_cap": "String",
      "name": "String",
      "notes": "String",
      "num_employees": Number,
      "number": "String",
      "parent": "String",
      "partner": "String",
      "phone": "String",
      "primary": Boolean,
      "primary_contact": "String",
      "profits": Number,
      "publicly_traded": Boolean,
      "rank_tier": "String",
      "registration_code": "String",
      "revenue_per_year": Number,
      "state": "String",
      "stock_price": "String",
      "stock_symbol": "String",
      "street": "String",
      "sys_class_name": "String",
      "sys_created_by": "String",
      "sys_created_on": "String",
      "sys_id": "String",
      "sys_mod_count": Number,
      "sys_updated_by": "String",
      "sys_updated_on": "String",
      "theme": "String",
      "vendor": Boolean,
      "vendor_manager": "String",
      "vendor_type": "String",
      "website": "String",
      "zip": "String
    }
    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 アカウントがパートナーアカウントではなく、顧客アカウントであるかどうかを示すフラグ。
    可能な値:
    • true:顧客アカウント
    • false:パートナーアカウント

    データタイプ:ブール

    デフォルト値: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 このアカウントに関連付けられている会社が商品を製造しているかどうかを示すフラグ。

    可能な値:

    • true:商品を製造している
    • false:商品を製造していない

    データタイプ:ブール

    デフォルト値: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 アカウントがパートナーアカウントか顧客アカウントかを示すフラグ。

    可能な値:

    • true:パートナーアカウント
    • false:顧客アカウント

    データタイプ:ブール

    デフォルト値:false

    account.phone 会社の主要な電話番号。

    データタイプ:文字列

    account.primary これがプライマリアカウントであるかどうかを示すフラグ。

    可能な値:

    • true:プライマリアカウント
    • false:セカンダリアカウント

    データタイプ:ブール

    デフォルト値:false

    account.primary_contact アカウントの主連絡先の sys_id。

    データタイプ:文字列

    テーブル:連絡先 [customer_contact]

    account.profits このアカウントに対して入力された利益情報。

    データタイプ:数値 (通貨)

    最大長:40

    account.publicly_traded このアカウントに関連付けられている会社の株式が証券取引所で公開されているかどうかを示すフラグ。

    可能な値:

    • true:株式公開
    • false:株式非公開会社

    データタイプ:ブール

    account.rank_tier アカウントのタイプ。

    可能な値:

    • blacklist
    • その他
    • strategic
    • tactical
    • valued

    データタイプ:文字列

    最大長: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 このアカウントに関連付けられている会社がベンダーかどうかを示すフラグ。

    可能な値:

    • true:ベンダー
    • false:ベンダーではない

    データタイプ:ブール

    デフォルト値: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:ケースはアクティブです。
    • false:ケースはクローズされました。

    データタイプ:ブール

    デフォルト: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 必要な承認のタイプを説明する文字列。

    可能な値:

    • approved
    • cancelled
    • duplicate
    • not_required
    • not requested
    • rejected
    • requested

    データタイプ:文字列

    最大文字数: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 ケースカテゴリ。

    可能な値:

    • 0:質問
    • 1:問題
    • 2:機能

    データタイプ:数値 (整数)

    デフォルト値:1

    cause 問題の原因に関する詳細。

    データタイプ:文字列

    最大長:4,000

    caused_by ケースが作成される原因となった変更要求の sys_id。

    データタイプ:文字列

    テーブル:変更要求 [change_request]

    変更 ケースが作成される原因となった変更要求の sys_id。

    データタイプ:文字列

    テーブル:変更要求 [change_request]

    child_case_creation_progress ケースが重大なケースから作成された子ケースであるかどうかを示すフラグ。

    可能な値:

    • true:重大なケースから作成された子ケース
    • false:子ケースではありません

    データタイプ:ブール

    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:コンシューマーがアクティブ
    • false:コンシューマーが非アクティブ

    データタイプ:ブール

    デフォルト:true

    consumer.business_phone コンシューマーの勤務先電話番号。

    データタイプ:文字列

    最大長:40

    consumer.city コンシューマーが居住する市区町村。

    データタイプ:文字列

    最大長:100

    consumer.country コンシューマーが居住する国。

    データタイプ:文字列

    最大長:40

    consumer.date_format 日付を表示する形式。

    有効な値:

    • dd-mm-yyyy
    • dd/mm/yyyy
    • dd.mm.yyyy
    • mm-dd-yyyy
    • yyyy-mm-dd

    データタイプ:文字列

    最大長: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 コンシューマーが通知を受信するかどうかを示します。

    有効な値:

    • 1:無効
    • 2:有効

    データタイプ:数値 (整数)

    最大長:40

    デフォルト値:2

    consumer.number コンシューマーに関連付けられた一意の番号。

    データタイプ:文字列

    最大長:40

    consumer.photo コンシューマーの写真。

    データタイプ:画像

    consumer.preferred_language コンシューマーのプライマリ言語。

    データタイプ:文字列

    最大長:3

    consumer.prefix Dr.、Mr.、Mrs.、Ms. などのコンシューマー名のプリフィックス

    データタイプ:文字列

    最大長:40

    consumer.primary これがプライマリコンシューマーであるかどうかを示すフラグ。

    可能な値:

    • true:プライマリコンシューマー
    • false:プライマリコンシューマーではない

    データタイプ:ブール

    デフォルト値: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 時間を表示する形式。

    有効な値:

    • hh.mm.ss a: hh.mm.ss (12 時間制)
    • hh:mm:ss a: hh:mm:ss (12 時間制)
    • HH.mm.ss: hh.mm.ss (24 時間制)
    • HH:mm:ss: hh:mm:ss (24 時間制)

    データタイプ:文字列

    最大長: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:連絡先はアクティブです。
    • false:連絡先は非アクティブです。

    データタイプ:ブール

    デフォルト: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 連絡先に日付を表示する形式。

    有効な値:

    • dd/mm/yyyy
    • dd-mm-yyyy
    • dd.mm.yyyy
    • mm-dd-yyyy
    • yyyy-mm-dd

    データタイプ:文字列

    最大長: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 連絡先がサービスポータルにログインするためにマルチファクター認証が必要かどうかを示すフラグ。

    可能な値:

    • true:マルチファクター認証が有効
    • false:マルチファクター認証が無効

    データタイプ:ブール

    デフォルト値:false

    contact.failed_attempts 失敗したログイン試行回数。

    データタイプ:数値 (整数)

    contact.first_name 連絡先の名。

    データタイプ:文字列

    最大長:50

    contact.gender 連絡先の性別。

    データタイプ:文字列

    最大長:40

    contact.geolocation_tracked 連絡先の場所が位置情報追跡によって取得されたかどうかを示すフラグ。

    可能な値:

    • true:連絡先の場所は位置情報追跡によって取得された
    • false:連絡先の場所は位置情報追跡によって取得されていない

    データタイプ:ブール

    デフォルト値:false

    contact.home_phone 連絡先の自宅電話番号。

    データタイプ:文字列

    最大長:40

    contact.internal_integration_user 連絡先が内部統合ユーザーかどうかを示すフラグ。

    可能な値:

    • true:内部統合ユーザー
    • false:他のタイプのユーザー

    データタイプ:ブール

    デフォルト値: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 連絡先がロックアウトされているかどうかを示すフラグ。

    可能な値:

    • true:連絡先がロックアウトされました
    • false:連絡先はロックアウトされていません

    データタイプ:ブール

    デフォルト値:false

    contact.longitude 連絡先の経度座標。

    データタイプ:数値 (浮動小数点)

    最大長:40

    contact.manager 連絡先の直属の上司を説明するレコードのSys_id。

    データタイプ:文字列

    テーブル:ユーザー [sys_user]

    contact.middle_name 連絡先のミドルネーム。

    データタイプ:数値 (浮動小数点)

    最大長:50

    contact.mobile_phone 連絡先の携帯電話番号。

    データタイプ:文字列

    最大長:40
    contact.name 連絡先のフルネーム。

    データタイプ:文字列

    最大長:151

    contact.notification 連絡先が通知を受信するかどうかを示します。

    有効な値:

    • 1:無効
    • 2:有効

    データタイプ:数値 (整数)

    デフォルト値:2

    contact.on_schedule ディスパッチされたサービス担当者の適時性を示します。

    有効な値:

    • Ahead:スケジュールの前倒し。
    • behind_less30:スケジュール遅延 (ただし 30 分未満)。
    • behind_30to60:スケジュール遅延 (30 ~ 60 分)。
    • behind_more60:スケジュール遅延 (60 分超)。
    • on_time:スケジュールどおり。

    データタイプ:文字列

    最大長: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 時間を表示する形式。

    有効な値:

    • hh.mm.ss a: hh.mm.ss (12 時間制)
    • hh:mm:ss a: hh:mm:ss (12 時間制)
    • HH.mm.ss: hh.mm.ss (24 時間制)
    • HH:mm:ss: hh:mm:ss (24 時間制)

    データタイプ:文字列

    最大長: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 ステータスかどうかを示すフラグ。

    可能な値:

    • true:VIP
    • false:VIP ではない

    データタイプ:ブール

    デフォルト値:false

    contact.web_service_access_only 連絡先が Web 経由でのみサービスにアクセスできるかどうかを示すフラグ。

    可能な値:

    • true:Web アクセスのみ
    • false:利用可能なすべての方法によるアクセス

    データタイプ:ブール

    デフォルト値:false

    contact.zip 連絡先の郵便番号。

    データタイプ:文字列

    最大長:40

    contact_local_time 連絡先の現地時間。

    データタイプ:文字列

    最大長:70

    contact_time_zone ケースに関連付けられた連絡先のタイムゾーン。

    データタイプ:文字列

    最大長:40

    contact_type ケースが最初にレポートされた方法。
    可能な値:
    • chat
    • email
    • phone
    • social
    • web

    データタイプ:文字列

    最大長: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:通常
    • 1:中
    • 2:高
    • 3:期限切れ

    データタイプ:数値 (整数)

    デフォルト:0

    expected_start ケースの作業開始予定日時。

    データタイプ:文字列

    first_response_time ケースに対して最初のアクションが実行された日時。

    データタイプ:文字列

    follow_the_sun ケースをグローバルフォローアップに渡す必要があるかどうかを示すフラグ。

    顧客が [優先度 1:重大] または [優先度 2 - 高] のケースにさらにコメントを入力した場合、またはケースが昇格された場合は、このフラグが自動的に true に設定されます。

    可能な値:

    • true:ケースをグローバルフォローアップに渡す必要があります
    • false:ケースをグローバルフォローアップに渡すべきではありません

    データタイプ:ブーリアン

    デフォルト値:false

    follow_up 次のフォローアップアクションの日時。

    データタイプ:文字列

    group_list ケースに関連付けられたグループレコードの sys_id のリスト。

    データタイプ:アレイ

    テーブル: Group [sys_user_group]

    影響 顧客への影響。

    可能な値:

    • 1 :高
    • 2 :中
    • 3:低

    データタイプ:数値 (整数)

    デフォルト値:3

    ナレッジ 指定された問題に利用可能なナレッジベース記事があるかどうかを示すフラグ。

    可能な値:

    • true:この問題に利用可能なナレッジベース記事があります
    • false:この問題に利用可能なナレッジベース記事がありません

    データタイプ:ブール

    デフォルト値:false

    location 会社の場所を説明するレコードの sys_id。

    データタイプ:文字列

    テーブル:場所 [cmn_location]

    made_sla ケースが関連するサービスレベルアグリーメントに従って解決されたかどうかを示すフラグ。

    可能な値:

    • true:SLA に従ってケースが解決されました
    • false:ケースは SLA に従って解決されませんでした

    データタイプ:ブーリアン

    デフォルト:true

    major_case_state 重大なケースの現在のステータス。

    可能な値:

    • accepted:マネージャーが重大なケースを作成したとき、またはマネージャーが候補ケースを昇格させたときの初期ステータス。
    • canceled:ケースがキャンセルされました。
    • proposed:エージェントまたはマネージャーが候補ケースを作成または提案したときの初期ステータス。
    • rejected:マネージャーが候補ケースを却下しました。

    データタイプ:文字列

    最大長:40

    needs_attention ケースに注意が必要かどうかを示すフラグ。

    可能な値:

    • true:ケースに追加の注意が必要です
    • false:ケースに追加の注意は必要ありません

    データタイプ:ブーリアン

    デフォルト値:false

    notes_to_comments 解決メモをコメントに追加するかどうかを示すフラグ。

    可能な値:

    • true:解決メモを追加すると、コメントにも追加されます
    • false:コメントに解決メモを含める必要はありません

    データタイプ:ブーリアン

    notify 連絡先/コンシューマーに通知するために使用する方法。

    可能な値:

    • 1:通知しない
    • 2:メール送信
    • 3:電話

    データタイプ:数値 (整数)

    デフォルト値: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 ケースの優先度。
    可能な値:
    • 1:重大
    • 2:高
    • 3:中
    • 4:低

    データタイプ:数値 (整数)

    デフォルト: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": "String",
        "value": "String"
      }
    ]
    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": "String",
        "channel": [Array],
        "contact": {Object},
        "consumer": {Object},
        "created_on": "String",
        "profile": "String",
        "profile_url": "String",
        "social_id": "String",
        "source": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_mod_count": Number,
        "sys_tags": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    sn_app_cs_social_social_profile.account ソーシャルメディアプロファイルのアカウント情報を含むレコードの一意の識別子。アカウント [customer_account] テーブルにあります。

    データタイプ:文字列

    sn_app_cs_social_social_profile.channel 関連するソーシャルメディアプロファイルチャネルの詳細。

    データタイプ:オブジェクト

    "channel": {
      "name": "String",
      "sys_class_name": "String",
      "sys_created_by": "String",
      "sys_created_on": "String",
      "sys_mod_count": Number,
      "sys_package": "String",
      "sys_policy": "String",
      "sys_scope": "String",
      "sys_tags": "String",
      "sys_update_name": "String",
      "sys_updated_by": "String",
      "sys_updated_on": "String"
    }
    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 企業/消費者間ケースの場合。ケースに関連付けられたコンシューマーの詳細。
    データタイプ:オブジェクト
    "consumer": {
      "active": Boolean,
      "business_phone": "String",
      "city": "String",
      "country": "String",
      "date_format": "String",
      "email": "String",
      "fax": "String",
      "first_name": "String",
      "gender": "String",
      "home_phone": "String",
      "household": "String",
      "last_name": "String",
      "middle_name": "String",
      "mobile_phone": "String",
      "name": "String",
      "notes": "String",
      "notification": Number,
      "number": "String",
      "photo": Image,
      "preferred_language": "String",
      "prefix": "String",
      "primary": Boolean,
      "state": "String",
      "street": "String",
      "suffix": "String",
      "sys_created_by": "String",
      "sys_created_on": "String",
      "sys_domain": "String",
      "sys_id": "String",
      "sys_mod_count": Number,
      "sys_tags": "String",
      "sys_updated_by": "String",
      "sys_updated_on": "String",
      "time_format": "String",
      "time_zone": "String",
      "title": "String",
      "user": "String",
      "zip": "String"
    }
    sn_app_cs_social_social_profile.consumer.active コンシューマーがアクティブかどうかを示すフラグ。

    可能な値:

    • true:コンシューマーがアクティブ
    • false:コンシューマーが非アクティブ

    データタイプ:ブール

    デフォルト: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 日付を表示する形式。

    有効な値:

    • dd-mm-yyyy
    • dd/mm/yyyy
    • dd.mm.yyyy
    • mm-dd-yyyy
    • yyyy-mm-dd

    データタイプ:文字列

    最大長: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 コンシューマーが通知を受信するかどうかを示します。

    有効な値:

    • 1:無効
    • 2:有効

    データタイプ:数値 (整数)

    最大長: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 これがプライマリコンシューマーであるかどうかを示すフラグ。

    可能な値:

    • true:プライマリコンシューマー
    • false:プライマリコンシューマーではない

    データタイプ:ブール

    デフォルト値: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 時間を表示する形式。

    有効な値:

    • hh.mm.ss a: hh.mm.ss (12 時間制)
    • hh:mm:ss a: hh:mm:ss (12 時間制)
    • HH.mm.ss: hh.mm.ss (24 時間制)
    • HH:mm:ss: hh:mm:ss (24 時間制)

    データタイプ:文字列

    最大長: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:連絡先はアクティブです。
    • false:連絡先は非アクティブです。

    データタイプ:ブール

    デフォルト: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 連絡先に日付を表示する形式。

    有効な値:

    • dd/mm/yyyy
    • dd-mm-yyyy
    • dd.mm.yyyy
    • mm-dd-yyyy
    • yyyy-mm-dd

    データタイプ:文字列

    最大長: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 連絡先がサービスポータルにログインするためにマルチファクター認証が必要かどうかを示すフラグ。

    可能な値:

    • true:マルチファクター認証が有効
    • false:マルチファクター認証が無効

    データタイプ:ブール

    デフォルト値: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 連絡先の場所が位置情報追跡によって取得されたかどうかを示すフラグ。

    可能な値:

    • true:連絡先の場所は位置情報追跡によって取得された
    • false:連絡先の場所は位置情報追跡によって取得されていない

    データタイプ:ブール

    デフォルト値:false

    sn_app_cs_social_social_profile.contact.home_phone 連絡先の自宅電話番号。

    データタイプ:文字列

    最大長:40

    sn_app_cs_social_social_profile.contact.internal_itegration_user 連絡先が内部統合ユーザーかどうかを示すフラグ。

    可能な値:

    • true:内部統合ユーザー
    • false:他のタイプのユーザー

    データタイプ:ブール

    デフォルト値: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 連絡先がロックアウトされているかどうかを示すフラグ。

    可能な値:

    • true:連絡先がロックアウトされました
    • false:連絡先はロックアウトされていません

    データタイプ:ブール

    デフォルト値: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 連絡先が通知を受信するかどうかを示します。

    有効な値:

    • 1:無効
    • 2:有効

    データタイプ:数値 (整数)

    デフォルト値:2

    sn_app_cs_social_social_profile.contact.on_schedule ディスパッチされたサービス担当者の適時性を示します。

    有効な値:

    • Ahead:スケジュールの前倒し。
    • behind_less30:スケジュール遅延 (ただし 30 分未満)。
    • behind_30to60:スケジュール遅延 (30 ~ 60 分)。
    • behind_more60:スケジュール遅延 (60 分超)。
    • on_time:スケジュールどおり。

    データタイプ:文字列

    最大長: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 時間を表示する形式。

    有効な値:

    • hh.mm.ss a: hh.mm.ss (12 時間制)
    • hh:mm:ss a: hh:mm:ss (12 時間制)
    • HH.mm.ss: hh.mm.ss (24 時間制)
    • HH:mm:ss: hh:mm:ss (24 時間制)

    データタイプ:文字列

    最大長: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 ステータスかどうかを示すフラグ。

    可能な値:

    • true:VIP
    • false:VIP ではない

    データタイプ:ブール

    デフォルト値:false

    sn_app_cs_social_social_profile.contact.web_service_access_only 連絡先が Web 経由でのみサービスにアクセスできるかどうかを示すフラグ。

    可能な値:

    • true:Web アクセスのみ
    • false:利用可能なすべての方法によるアクセス

    データタイプ:ブール

    デフォルト値: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:新規
    • 3:クローズ済み
    • 6:解決済み
    • 10:オープン
    • 18:情報待ち

    データタイプ:数値 (整数)

    デフォルト値:1

    subcategory ケースのサブカテゴリ。

    可能な値:

    0:質問

    データタイプ:数値 (整数)

    デフォルト:0

    support_manager ケースにアサインされた CSM マネージャーの sys_id。

    データタイプ:文字列

    テーブル:ユーザー [sys_user]

    sync_driver ドライバーの同期があるかどうかを示すフラグ。

    可能な値:

    • true:ドライバーは同期されています
    • false:ドライバーが同期されていません

    データタイプ:ブーリアン

    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 ケースが承認された場合に実行するアクション。

    可能な値:

    • do_nothing
    • proceed

    データタイプ:文字列

    最大長:40

    デフォルト:proceed

    upon_reject ケースが却下された場合に実行するアクション。

    可能な値:

    • cancel
    • goto

    データタイプ:文字列

    最大長:40

    デフォルト:cancel

    urgency ケースの緊急度。

    可能な値:

    • 1 :高
    • 2 :中
    • 3:低

    データタイプ:数値 (整数)

    デフォルト値: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 noise​CS0000009",
        "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 値と同等に設定されます。以下で定義するパラメーターのリスト (ベースシステムにあるパラメーターを定義するもの) に加えて、エンドポイントでは、インスタンスで構成されたカスタムケースフィールドと追加のケースフィールドも受け入れます。これらの要素の詳細については、特定のテーブル定義[システム定義 > テーブル].

    警告:
    このエンドポイントでパラメーターの検証を実行すると、過度のオーバーヘッドが発生する可能性があるため、パラメーターの検証を実行しません。要求パラメーターが、スペルが間違っている、ケースのタイプに対して有効ではない、またはエンドポイントでサポートされていない場合、警告なしで無視されるか予期しない結果が生じる可能性があります。たとえば、間違ったタイプのケースに対してコンシューマーまたは連絡先を作成した場合、または連絡先とアカウントが一致しない場合などです。
    警告:
    デフォルトでは、sn_customerservice.customer または sn_customerservice.consumer ロールを持つ外部ユーザーはこのエンドポイントを使用して、account、asset、comments、consumer、contact、contact_type、partner、partner_contact、priority、product、short_description、および state のフィールドのみを設定できます。
    注:
    フルネームまたは短縮名 (sysparm_ プリフィックスなし) を使用して、すべての sysparm クエリパラメーターを参照できます。たとえば、sysparm_limit の場合は limit も使用できます。

    URL 形式

    バージョニングされた URL:/api/sn_customerservice/{api_version}/case

    デフォルトの URL:/api/sn_customerservice/case

    注:
    利用可能なバージョンは、 REST API エクスプローラーで指定されます。スクリプト済み REST API の場合、[ スクリプト済み REST サービス] フォームに追加のバージョン情報があります。

    サポートされている要求パラメーター

    表 : 31. パスパラメーター
    名前 説明
    api_version オプションアクセスするエンドポイントのバージョン。たとえば、v1v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。

    データタイプ:文字列

    表 : 32. クエリパラメーター
    名前 説明
    なし
    表 : 33. 要求本文パラメーター (XML または JSON)
    要素 説明
    account ケースに関連付けられたアカウントの sys_id。

    データタイプ:文字列

    デフォルト: contact を指定すると、連絡先レコードで指定されたアカウントがデフォルトになります。

    テーブル:アカウント [customer_account]

    アクティブ ケースがオープンかアクティブかを示すフラグ。

    可能な値:

    • true:ケースはアクティブです。
    • false:ケースはクローズされました。

    データタイプ:ブール

    デフォルト: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 必要な承認のタイプを説明する文字列。

    可能な値:

    • approved
    • cancelled
    • duplicate
    • not_required
    • not requested
    • rejected
    • requested

    データタイプ:文字列

    最大文字数: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 ケースカテゴリ。

    可能な値:

    • 0:質問
    • 1:問題
    • 2:機能

    データタイプ:数値 (整数)

    デフォルト値:1

    cause 問題の原因に関する詳細。

    データタイプ:文字列

    最大長:4,000

    caused_by ケースが作成される原因となった変更要求の sys_id。

    データタイプ:文字列

    テーブル:変更要求 [change_request]

    変更 ケースが作成される原因となった変更要求の sys_id。

    データタイプ:文字列

    テーブル:変更要求 [change_request]

    child_case_creation_progress ケースが重大なケースから作成された子ケースであるかどうかを示すフラグ。

    可能な値:

    • true:重大なケースから作成された子ケース
    • false:子ケースではありません

    データタイプ:ブール

    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 ケースが最初にレポートされた方法。
    可能な値:
    • chat
    • email
    • phone
    • social
    • web

    データタイプ:文字列

    最大長: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:通常
    • 1:中
    • 2:高
    • 3:期限切れ

    データタイプ:数値 (整数)

    デフォルト:0

    expected_start ケースの作業開始予定日時。

    データタイプ:文字列

    first_response_time ケースに対して最初のアクションが実行された日時。

    データタイプ:文字列

    follow_the_sun ケースをグローバルフォローアップに渡す必要があるかどうかを示すフラグ。

    顧客が [優先度 1:重大] または [優先度 2 - 高] のケースにさらにコメントを入力した場合、またはケースが昇格された場合は、このフラグが自動的に true に設定されます。

    可能な値:

    • true:ケースをグローバルフォローアップに渡す必要があります
    • false:ケースをグローバルフォローアップに渡すべきではありません

    データタイプ:ブーリアン

    デフォルト値:false

    group_list ケースに関連付けられたグループレコードの sys_id のリスト。

    データタイプ:アレイ

    テーブル: Group [sys_user_group]

    影響 顧客への影響。

    可能な値:

    • 1 :高
    • 2 :中
    • 3:低

    データタイプ:数値 (整数)

    デフォルト値:3

    ナレッジ 指定された問題に利用可能なナレッジベース記事があるかどうかを示すフラグ。

    可能な値:

    • true:この問題に利用可能なナレッジベース記事があります
    • false:この問題に利用可能なナレッジベース記事がありません

    データタイプ:ブール

    デフォルト値:false

    location 会社の場所を説明するレコードの sys_id。

    データタイプ:文字列

    テーブル:場所 [cmn_location]

    made_sla ケースが関連するサービスレベルアグリーメントに従って解決されたかどうかを示すフラグ。

    可能な値:

    • true:SLA に従ってケースが解決されました
    • false:ケースは SLA に従って解決されませんでした

    データタイプ:ブーリアン

    デフォルト:true

    major_case_state 重大なケースの現在のステータス。

    可能な値:

    • accepted:マネージャーが重大なケースを作成したとき、またはマネージャーが候補ケースを昇格させたときの初期ステータス。
    • canceled:ケースがキャンセルされました。
    • proposed:エージェントまたはマネージャーが候補ケースを作成または提案したときの初期ステータス。
    • rejected:マネージャーが候補ケースを却下しました。

    データタイプ:文字列

    最大長:40

    notes_to_comments 解決メモをコメントに追加するかどうかを示すフラグ。

    可能な値:

    • true:解決メモを追加すると、コメントにも追加されます
    • false:コメントに解決メモを含める必要はありません

    データタイプ:ブーリアン

    notify 連絡先/コンシューマーに通知するために使用する方法。

    可能な値:

    • 1:通知しない
    • 2:メール送信
    • 3:電話

    データタイプ:数値 (整数)

    デフォルト値: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 ケースの優先度。
    可能な値:
    • 1:重大
    • 2:高
    • 3:中
    • 4:低

    データタイプ:数値 (整数)

    デフォルト: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 ソーシャルメディアプロファイルを関連付けるケースのタイプ。

    有効な値:

    • account
    • consumer
    • 連絡先

    データタイプ:文字列

    social_handle_url ユーザーのソーシャルメディアハンドルの URL。

    データタイプ:文字列

    social_post_url ケースの生成元のソーシャルメッセージの URL。

    データタイプ:文字列

    state ケースの現在のステータス。

    可能な値:

    • 1:新規
    • 3:クローズ済み
    • 6:解決済み
    • 10:オープン
    • 18:情報待ち

    データタイプ:数値 (整数)

    デフォルト値:1

    subcategory ケースのサブカテゴリ。

    可能な値:

    0:質問

    データタイプ:数値 (整数)

    デフォルト:0

    support_manager ケースにアサインされた CSM マネージャーの sys_id。

    データタイプ:文字列

    テーブル:ユーザー [sys_user]

    sync_driver ドライバーの同期があるかどうかを示すフラグ。

    可能な値:

    • true:ドライバーは同期されています
    • false:ドライバーが同期されていません

    データタイプ:ブーリアン

    sys_domain_path ドメインパス。

    データタイプ:文字列

    最大長:255

    デフォルト:/

    time_worked ケースの合計作業時間。

    データタイプ:文字列

    upon_approval ケースが承認された場合に実行するアクション。

    可能な値:

    • do_nothing
    • proceed

    データタイプ:文字列

    最大長:40

    デフォルト:proceed

    upon_reject ケースが却下された場合に実行するアクション。

    可能な値:

    • cancel
    • goto

    データタイプ:文字列

    最大長:40

    デフォルト:cancel

    urgency ケースの緊急度。

    可能な値:

    • 1 :高
    • 2 :中
    • 3:低

    データタイプ:数値 (整数)

    デフォルト値: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 ヘッダー」を参照してください。

    表 : 34. 要求ヘッダー
    ヘッダー 説明
    承認 応答本文のデータフォーマット。application/json のみをサポートします。
    Content-Type 要求本文のデータ形式。application/json のみをサポートします。
    表 : 35. 応答ヘッダー
    ヘッダー 説明
    なし

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 36. ステータスコード
    ステータスコード 説明
    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) ケースを更新します。

    警告:
    このエンドポイントでパラメーターの検証を実行すると、過度のオーバーヘッドが発生する可能性があるため、パラメーターの検証を実行しません。要求パラメーターが、スペルが間違っている、ケースのタイプに対して有効ではない、またはエンドポイントでサポートされていない場合、警告なしで無視されるか予期しない結果が生じる可能性があります。たとえば、間違ったタイプのケースに対してコンシューマーまたは連絡先を作成した場合、または連絡先とアカウントが一致しない場合などです。
    警告:
    デフォルトでは、sn_customerservice.customer または sn_customerservice.consumer ロールを持つ外部ユーザーは、このエンドポイントを使用してコメントとステータスのフィールドのみを設定できます。管理者は、CaseRESTAPIValidatorForExternalUser スクリプトインクルードで定義された UPDATE_ALLOWED_FIELDS アレイにフィールド名を指定することで、外部ユーザーが追加のフィールドを設定できるようにすることができます。このアレイに新しいフィールドを追加するときは、これらのフィールドに入力するための既存のバリデーターがない可能性があるため注意してください。スクリプトインクルードの詳細については、「スクリプトインクルード」を参照してください。
    注:
    フルネームまたは短縮名 (sysparm_ プリフィックスなし) を使用して、すべての sysparm クエリパラメーターを参照できます。たとえば、sysparm_limit の場合は limit も使用できます。

    URL 形式

    バージョニングされた URL:/api/sn_customerservice/{api_version}/case/{id}

    デフォルトの URL:/api/sn_customerservice/case/{id}

    注:
    利用可能なバージョンは、 REST API エクスプローラーで指定されます。スクリプト済み REST API の場合、[ スクリプト済み REST サービス] フォームに追加のバージョン情報があります。

    サポートされている要求パラメーター

    表 : 37. パスパラメーター
    名前 説明
    api_version オプションアクセスするエンドポイントのバージョン。たとえば、v1v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。

    データタイプ:文字列

    id 更新するケースの sys_id。

    テーブル:ケース [sn_customerservice_case]

    表 : 38. クエリパラメーター
    名前 説明
    sysparm_display_value 返されるデータ (データベースからの実際の値またはフィールドの表示値) のタイプを決定します。表示値は、データベース内の実際の値と、ユーザーやシステムの設定と環境設定に基づいて操作されます。
    表示値を返す場合、返される値はフィールドタイプに依存します。
    • 選択肢フィールド:データベース値は数値にできますが、表示値の方がわかりやすくなります。
    • 日付フィールド:データベース値は UTC 形式で、表示値はユーザーのタイムゾーンに基づいたものになります。
    • 暗号化テキスト:データベース値は暗号化されますが、表示値はユーザーの暗号化コンテキストに基づいて非暗号化されます。
    • 参照フィールド:データベース値は sys_id ですが、表示値は参照レコードの表示フィールドになります。

    データタイプ:文字列

    有効な値:

    • true:すべてのフィールドに対して表示値が返されます。
    • false:データベースから実際の値が返されます。
    • all:実際の値と表示値の両方が返されます。

    デフォルト値:false

    注:
    このパラメーター設定に推奨方法はありません。ただし、表示値を指定すると、データベースから直接読み取られず、その他のフィールドやレコードを参照することがあるため、パフォーマンスに問題が発生する可能性があります。表示値と実際の値の詳細については、「テーブル API FAQ (KB0534905)」を参照してください。
    sysparm_fields 応答で返すカンマ区切りのフィールドのリストです。無効なフィールドは無視されます。

    データタイプ:文字列

    デフォルト:すべてのフィールドを返します。

    sysparm_get_case_details 更新されたケースレコードを返すかどうかを示すフラグ。

    有効な値:

    • true:更新されたケースレコードを返します。
    • false:更新されたケースレコードを返しません。

    データタイプ:ブール

    デフォルト値:false

    表 : 39. 要求本文パラメーター (XML または JSON)
    要素 説明
    account ケースに関連付けられたアカウントの sys_id。

    データタイプ:文字列

    デフォルト: contact を指定すると、連絡先レコードで指定されたアカウントがデフォルトになります。

    テーブル:アカウント [customer_account]

    アクティブ ケースがオープンかアクティブかを示すフラグ。

    可能な値:

    • true:ケースはアクティブです。
    • false:ケースはクローズされました。

    データタイプ:ブール

    デフォルト: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 必要な承認のタイプを説明する文字列。

    可能な値:

    • approved
    • cancelled
    • duplicate
    • not_required
    • not requested
    • rejected
    • requested

    データタイプ:文字列

    最大文字数: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 ケースカテゴリ。

    可能な値:

    • 0:質問
    • 1:問題
    • 2:機能

    データタイプ:数値 (整数)

    デフォルト値:1

    cause 問題の原因に関する詳細。

    データタイプ:文字列

    最大長:4,000

    caused_by ケースが作成される原因となった変更要求の sys_id。

    データタイプ:文字列

    テーブル:変更要求 [change_request]

    変更 ケースが作成される原因となった変更要求の sys_id。

    データタイプ:文字列

    テーブル:変更要求 [change_request]

    child_case_creation_progress ケースが重大なケースから作成された子ケースであるかどうかを示すフラグ。

    可能な値:

    • true:重大なケースから作成された子ケース
    • false:子ケースではありません

    データタイプ:ブール

    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 ケースが最初にレポートされた方法。
    可能な値:
    • chat
    • email
    • phone
    • social
    • web

    データタイプ:文字列

    最大長: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:通常
    • 1:中
    • 2:高
    • 3:期限切れ

    データタイプ:数値 (整数)

    デフォルト:0

    expected_start ケースの作業開始予定日時。

    データタイプ:文字列

    first_response_time ケースに対して最初のアクションが実行された日時。

    データタイプ:文字列

    follow_the_sun ケースをグローバルフォローアップに渡す必要があるかどうかを示すフラグ。

    顧客が [優先度 1:重大] または [優先度 2 - 高] のケースにさらにコメントを入力した場合、またはケースが昇格された場合は、このフラグが自動的に true に設定されます。

    可能な値:

    • true:ケースをグローバルフォローアップに渡す必要があります
    • false:ケースをグローバルフォローアップに渡すべきではありません

    データタイプ:ブーリアン

    デフォルト値:false

    group_list ケースに関連付けられたグループレコードの sys_id のリスト。

    データタイプ:アレイ

    テーブル: Group [sys_user_group]

    影響 顧客への影響。

    可能な値:

    • 1 :高
    • 2 :中
    • 3:低

    データタイプ:数値 (整数)

    デフォルト値:3

    ナレッジ 指定された問題に利用可能なナレッジベース記事があるかどうかを示すフラグ。

    可能な値:

    • true:この問題に利用可能なナレッジベース記事があります
    • false:この問題に利用可能なナレッジベース記事がありません

    データタイプ:ブール

    デフォルト値:false

    location 会社の場所を説明するレコードの sys_id。

    データタイプ:文字列

    テーブル:場所 [cmn_location]

    made_sla ケースが関連するサービスレベルアグリーメントに従って解決されたかどうかを示すフラグ。

    可能な値:

    • true:SLA に従ってケースが解決されました
    • false:ケースは SLA に従って解決されませんでした

    データタイプ:ブーリアン

    デフォルト:true

    major_case_state 重大なケースの現在のステータス。

    可能な値:

    • accepted:マネージャーが重大なケースを作成したとき、またはマネージャーが候補ケースを昇格させたときの初期ステータス。
    • canceled:ケースがキャンセルされました。
    • proposed:エージェントまたはマネージャーが候補ケースを作成または提案したときの初期ステータス。
    • rejected:マネージャーが候補ケースを却下しました。

    データタイプ:文字列

    最大長:40

    notes_to_comments 解決メモをコメントに追加するかどうかを示すフラグ。

    可能な値:

    • true:解決メモを追加すると、コメントにも追加されます
    • false:コメントに解決メモを含める必要はありません

    データタイプ:ブーリアン

    notify 連絡先/コンシューマーに通知するために使用する方法。

    可能な値:

    • 1:通知しない
    • 2:メール送信
    • 3:電話

    データタイプ:数値 (整数)

    デフォルト値: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 ケースの優先度。
    可能な値:
    • 1:重大
    • 2:高
    • 3:中
    • 4:低

    データタイプ:数値 (整数)

    デフォルト: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 ソーシャルメディアプロファイルを関連付けるケースのタイプ。

    有効な値:

    • account
    • 連絡先
    • consumer

    データタイプ:文字列

    social_handle_url ユーザーのソーシャルメディアハンドルの URL。

    データタイプ:文字列

    social_post_url ケースの生成元のソーシャルメッセージの URL。

    データタイプ:文字列

    state ケースの現在のステータス。

    可能な値:

    • 1:新規
    • 3:クローズ済み
    • 6:解決済み
    • 10:オープン
    • 18:情報待ち

    データタイプ:数値 (整数)

    デフォルト値:1

    subcategory ケースのサブカテゴリ。

    可能な値:

    0:質問

    データタイプ:数値 (整数)

    デフォルト:0

    support_manager ケースにアサインされた CSM マネージャーの sys_id。

    データタイプ:文字列

    テーブル:ユーザー [sys_user]

    sync_driver ドライバーの同期があるかどうかを示すフラグ。

    可能な値:

    • true:ドライバーは同期されています
    • false:ドライバーが同期されていません

    データタイプ:ブーリアン

    sys_domain_path ドメインパス。

    データタイプ:文字列

    最大長:255

    デフォルト:/

    time_worked ケースの合計作業時間。

    データタイプ:文字列

    upon_approval ケースが承認された場合に実行するアクション。

    可能な値:

    • do_nothing
    • proceed

    データタイプ:文字列

    最大長:40

    デフォルト:proceed

    upon_reject ケースが却下された場合に実行するアクション。

    可能な値:

    • cancel
    • goto

    データタイプ:文字列

    最大長:40

    デフォルト:cancel

    urgency ケースの緊急度。

    可能な値:

    • 1 :高
    • 2 :中
    • 3:低

    データタイプ:数値 (整数)

    デフォルト値: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 ヘッダー」を参照してください。

    表 : 40. 要求ヘッダー
    ヘッダー 説明
    承認 応答本文のデータフォーマット。application/json のみをサポートします。
    Content-Type 要求本文のデータ形式。application/json のみをサポートします。
    表 : 41. 応答ヘッダー
    ヘッダー 説明
    なし

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 42. ステータスコード
    ステータスコード 説明
    201 成功。
    400 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。
    401 権限がありません。ユーザー資格情報が間違っているか、渡されていません。
    500 内部サーバーエラー。サーバー側のコードで論理エラーが発生しました。

    応答本文のパラメーター (JSON または XML)

    要素 説明
    account
    ケースに関連付けられたアカウントレコードの sys_id。

    データタイプ:文字列

    テーブル:アカウント [customer_account]

    account アカウントの詳細。

    データタイプ:オブジェクト

    "account": {
      "account_code": "String",
      "account_parent": "String",
      "account_path": "String",
      "active_escalation": "String",
      "apple_icon": Image,
      "banner_image": Image,
      "banner_image_light": Image,
      "banner_text": "String",
      "city": "String",
      "contact": "String",
      "country": "String",
      "customer": "String",
      "discount": "String",
      "fax_phone": "String",
      "fiscal_year": "String",
      "lat_long_error": "String",
      "latitude": "String",
      "longitude": "String",
      "market_cap": "String",
      "name": "String",
      "notes": "String",
      "num_employees": Number,
      "number": "String",
      "parent": "String",
      "partner": "String",
      "phone": "String",
      "primary": Boolean,
      "primary_contact": "String",
      "profits": Number,
      "publicly_traded": Boolean,
      "rank_tier": "String",
      "registration_code": "String",
      "revenue_per_year": Number,
      "state": "String",
      "stock_price": "String",
      "stock_symbol": "String",
      "street": "String",
      "sys_class_name": "String",
      "sys_created_by": "String",
      "sys_created_on": "String",
      "sys_id": "String",
      "sys_mod_count": Number,
      "sys_updated_by": "String",
      "sys_updated_on": "String",
      "theme": "String",
      "vendor": Boolean,
      "vendor_manager": "String",
      "vendor_type": "String",
      "website": "String",
      "zip": "String
    }
    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 アカウントがパートナーアカウントではなく、顧客アカウントであるかどうかを示すフラグ。
    可能な値:
    • true:顧客アカウント
    • false:パートナーアカウント

    データタイプ:ブール

    デフォルト値: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 このアカウントに関連付けられている会社が商品を製造しているかどうかを示すフラグ。

    可能な値:

    • true:商品を製造している
    • false:商品を製造していない

    データタイプ:ブール

    デフォルト値: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 アカウントがパートナーアカウントか顧客アカウントかを示すフラグ。

    可能な値:

    • true:パートナーアカウント
    • false:顧客アカウント

    データタイプ:ブール

    デフォルト値:false

    account.phone 会社の主要な電話番号。

    データタイプ:文字列

    account.primary これがプライマリアカウントであるかどうかを示すフラグ。

    可能な値:

    • true:プライマリアカウント
    • false:セカンダリアカウント

    データタイプ:ブール

    デフォルト値:false

    account.primary_contact アカウントの主連絡先の sys_id。

    データタイプ:文字列

    テーブル:連絡先 [customer_contact]

    account.profits このアカウントに対して入力された利益情報。

    データタイプ:数値 (通貨)

    最大長:40

    account.publicly_traded このアカウントに関連付けられている会社の株式が証券取引所で公開されているかどうかを示すフラグ。

    可能な値:

    • true:株式公開
    • false:株式非公開会社

    データタイプ:ブール

    account.rank_tier アカウントのタイプ。

    可能な値:

    • blacklist
    • その他
    • strategic
    • tactical
    • valued

    データタイプ:文字列

    最大長: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 このアカウントに関連付けられている会社がベンダーかどうかを示すフラグ。

    可能な値:

    • true:ベンダー
    • false:ベンダーではない

    データタイプ:ブール

    デフォルト値: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:ケースはアクティブです。
    • false:ケースはクローズされました。

    データタイプ:ブール

    デフォルト: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 必要な承認のタイプを説明する文字列。

    可能な値:

    • approved
    • cancelled
    • duplicate
    • not_required
    • not requested
    • rejected
    • requested

    データタイプ:文字列

    最大文字数: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 ケースカテゴリ。

    可能な値:

    • 0:質問
    • 1:問題
    • 2:機能

    データタイプ:数値 (整数)

    デフォルト値:1

    cause 問題の原因に関する詳細。

    データタイプ:文字列

    最大長:4,000

    caused_by ケースが作成される原因となった変更要求の sys_id。

    データタイプ:文字列

    テーブル:変更要求 [change_request]

    変更 ケースが作成される原因となった変更要求の sys_id。

    データタイプ:文字列

    テーブル:変更要求 [change_request]

    child_case_creation_progress ケースが重大なケースから作成された子ケースであるかどうかを示すフラグ。

    可能な値:

    • true:重大なケースから作成された子ケース
    • false:子ケースではありません

    データタイプ:ブール

    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:コンシューマーがアクティブ
    • false:コンシューマーが非アクティブ

    データタイプ:ブール

    デフォルト:true

    consumer.business_phone コンシューマーの勤務先電話番号。

    データタイプ:文字列

    最大長:40

    consumer.city コンシューマーが居住する市区町村。

    データタイプ:文字列

    最大長:100

    consumer.country コンシューマーが居住する国。

    データタイプ:文字列

    最大長:40

    consumer.date_format 日付を表示する形式。

    有効な値:

    • dd-mm-yyyy
    • dd/mm/yyyy
    • dd.mm.yyyy
    • mm-dd-yyyy
    • yyyy-mm-dd

    データタイプ:文字列

    最大長: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 コンシューマーが通知を受信するかどうかを示します。

    有効な値:

    • 1:無効
    • 2:有効

    データタイプ:数値 (整数)

    最大長:40

    デフォルト値:2

    consumer.number コンシューマーに関連付けられた一意の番号。

    データタイプ:文字列

    最大長:40

    consumer.photo コンシューマーの写真。

    データタイプ:画像

    consumer.preferred_language コンシューマーのプライマリ言語。

    データタイプ:文字列

    最大長:3

    consumer.prefix Dr.、Mr.、Mrs.、Ms. などのコンシューマー名のプリフィックス

    データタイプ:文字列

    最大長:40

    consumer.primary これがプライマリコンシューマーであるかどうかを示すフラグ。

    可能な値:

    • true:プライマリコンシューマー
    • false:プライマリコンシューマーではない

    データタイプ:ブール

    デフォルト値: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 時間を表示する形式。

    有効な値:

    • hh.mm.ss a: hh.mm.ss (12 時間制)
    • hh:mm:ss a: hh:mm:ss (12 時間制)
    • HH.mm.ss: hh.mm.ss (24 時間制)
    • HH:mm:ss: hh:mm:ss (24 時間制)

    データタイプ:文字列

    最大長: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:連絡先はアクティブです。
    • false:連絡先は非アクティブです。

    データタイプ:ブール

    デフォルト: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 連絡先に日付を表示する形式。

    有効な値:

    • dd/mm/yyyy
    • dd-mm-yyyy
    • dd.mm.yyyy
    • mm-dd-yyyy
    • yyyy-mm-dd

    データタイプ:文字列

    最大長: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 連絡先がサービスポータルにログインするためにマルチファクター認証が必要かどうかを示すフラグ。

    可能な値:

    • true:マルチファクター認証が有効
    • false:マルチファクター認証が無効

    データタイプ:ブール

    デフォルト値:false

    contact.failed_attempts 失敗したログイン試行回数。

    データタイプ:数値 (整数)

    contact.first_name 連絡先の名。

    データタイプ:文字列

    最大長:50

    contact.gender 連絡先の性別。

    データタイプ:文字列

    最大長:40

    contact.geolocation_tracked 連絡先の場所が位置情報追跡によって取得されたかどうかを示すフラグ。

    可能な値:

    • true:連絡先の場所は位置情報追跡によって取得された
    • false:連絡先の場所は位置情報追跡によって取得されていない

    データタイプ:ブール

    デフォルト値:false

    contact.home_phone 連絡先の自宅電話番号。

    データタイプ:文字列

    最大長:40

    contact.internal_integration_user 連絡先が内部統合ユーザーかどうかを示すフラグ。

    可能な値:

    • true:内部統合ユーザー
    • false:他のタイプのユーザー

    データタイプ:ブール

    デフォルト値: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 連絡先がロックアウトされているかどうかを示すフラグ。

    可能な値:

    • true:連絡先がロックアウトされました
    • false:連絡先はロックアウトされていません

    データタイプ:ブール

    デフォルト値:false

    contact.longitude 連絡先の経度座標。

    データタイプ:数値 (浮動小数点)

    最大長:40

    contact.manager 連絡先の直属の上司を説明するレコードのSys_id。

    データタイプ:文字列

    テーブル:ユーザー [sys_user]

    contact.middle_name 連絡先のミドルネーム。

    データタイプ:数値 (浮動小数点)

    最大長:50

    contact.mobile_phone 連絡先の携帯電話番号。

    データタイプ:文字列

    最大長:40
    contact.name 連絡先のフルネーム。

    データタイプ:文字列

    最大長:151

    contact.notification 連絡先が通知を受信するかどうかを示します。

    有効な値:

    • 1:無効
    • 2:有効

    データタイプ:数値 (整数)

    デフォルト値:2

    contact.on_schedule ディスパッチされたサービス担当者の適時性を示します。

    有効な値:

    • Ahead:スケジュールの前倒し。
    • behind_less30:スケジュール遅延 (ただし 30 分未満)。
    • behind_30to60:スケジュール遅延 (30 ~ 60 分)。
    • behind_more60:スケジュール遅延 (60 分超)。
    • on_time:スケジュールどおり。

    データタイプ:文字列

    最大長: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 時間を表示する形式。

    有効な値:

    • hh.mm.ss a: hh.mm.ss (12 時間制)
    • hh:mm:ss a: hh:mm:ss (12 時間制)
    • HH.mm.ss: hh.mm.ss (24 時間制)
    • HH:mm:ss: hh:mm:ss (24 時間制)

    データタイプ:文字列

    最大長: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 ステータスかどうかを示すフラグ。

    可能な値:

    • true:VIP
    • false:VIP ではない

    データタイプ:ブール

    デフォルト値:false

    contact.web_service_access_only 連絡先が Web 経由でのみサービスにアクセスできるかどうかを示すフラグ。

    可能な値:

    • true:Web アクセスのみ
    • false:利用可能なすべての方法によるアクセス

    データタイプ:ブール

    デフォルト値:false

    contact.zip 連絡先の郵便番号。

    データタイプ:文字列

    最大長:40

    contact_local_time 連絡先の現地時間。

    データタイプ:文字列

    最大長:70

    contact_time_zone ケースに関連付けられた連絡先のタイムゾーン。

    データタイプ:文字列

    最大長:40

    contact_type ケースが最初にレポートされた方法。
    可能な値:
    • chat
    • email
    • phone
    • social
    • web

    データタイプ:文字列

    最大長: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:通常
    • 1:中
    • 2:高
    • 3:期限切れ

    データタイプ:数値 (整数)

    デフォルト:0

    expected_start ケースの作業開始予定日時。

    データタイプ:文字列

    first_response_time ケースに対して最初のアクションが実行された日時。

    データタイプ:文字列

    follow_the_sun ケースをグローバルフォローアップに渡す必要があるかどうかを示すフラグ。

    顧客が [優先度 1:重大] または [優先度 2 - 高] のケースにさらにコメントを入力した場合、またはケースが昇格された場合は、このフラグが自動的に true に設定されます。

    可能な値:

    • true:ケースをグローバルフォローアップに渡す必要があります
    • false:ケースをグローバルフォローアップに渡すべきではありません

    データタイプ:ブーリアン

    デフォルト値:false

    follow_up 次のフォローアップアクションの日時。

    データタイプ:文字列

    group_list ケースに関連付けられたグループレコードの sys_id のリスト。

    データタイプ:アレイ

    テーブル: Group [sys_user_group]

    影響 顧客への影響。

    可能な値:

    • 1 :高
    • 2 :中
    • 3:低

    データタイプ:数値 (整数)

    デフォルト値:3

    ナレッジ 指定された問題に利用可能なナレッジベース記事があるかどうかを示すフラグ。

    可能な値:

    • true:この問題に利用可能なナレッジベース記事があります
    • false:この問題に利用可能なナレッジベース記事がありません

    データタイプ:ブール

    デフォルト値:false

    location 会社の場所を説明するレコードの sys_id。

    データタイプ:文字列

    テーブル:場所 [cmn_location]

    made_sla ケースが関連するサービスレベルアグリーメントに従って解決されたかどうかを示すフラグ。

    可能な値:

    • true:SLA に従ってケースが解決されました
    • false:ケースは SLA に従って解決されませんでした

    データタイプ:ブーリアン

    デフォルト:true

    major_case_state 重大なケースの現在のステータス。

    可能な値:

    • accepted:マネージャーが重大なケースを作成したとき、またはマネージャーが候補ケースを昇格させたときの初期ステータス。
    • canceled:ケースがキャンセルされました。
    • proposed:エージェントまたはマネージャーが候補ケースを作成または提案したときの初期ステータス。
    • rejected:マネージャーが候補ケースを却下しました。

    データタイプ:文字列

    最大長:40

    needs_attention ケースに注意が必要かどうかを示すフラグ。

    可能な値:

    • true:ケースに追加の注意が必要です
    • false:ケースに追加の注意は必要ありません

    データタイプ:ブーリアン

    デフォルト値:false

    notes_to_comments 解決メモをコメントに追加するかどうかを示すフラグ。

    可能な値:

    • true:解決メモを追加すると、コメントにも追加されます
    • false:コメントに解決メモを含める必要はありません

    データタイプ:ブーリアン

    notify 連絡先/コンシューマーに通知するために使用する方法。

    可能な値:

    • 1:通知しない
    • 2:メール送信
    • 3:電話

    データタイプ:数値 (整数)

    デフォルト値: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 ケースの優先度。
    可能な値:
    • 1:重大
    • 2:高
    • 3:中
    • 4:低

    データタイプ:数値 (整数)

    デフォルト: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": "String",
        "value": "String"
      }
    ]
    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": "String",
        "channel": [Array],
        "contact": {Object},
        "consumer": {Object},
        "created_on": "String",
        "profile": "String",
        "profile_url": "String",
        "social_id": "String",
        "source": "String",
        "sys_created_by": "String",
        "sys_created_on": "String",
        "sys_id": "String",
        "sys_mod_count": Number,
        "sys_tags": "String",
        "sys_updated_by": "String",
        "sys_updated_on": "String"
      }
    ]
    sn_app_cs_social_social_profile.account ソーシャルメディアプロファイルのアカウント情報を含むレコードの一意の識別子。アカウント [customer_account] テーブルにあります。

    データタイプ:文字列

    sn_app_cs_social_social_profile.channel 関連するソーシャルメディアプロファイルチャネルの詳細。

    データタイプ:オブジェクト

    "channel": {
      "name": "String",
      "sys_class_name": "String",
      "sys_created_by": "String",
      "sys_created_on": "String",
      "sys_mod_count": Number,
      "sys_package": "String",
      "sys_policy": "String",
      "sys_scope": "String",
      "sys_tags": "String",
      "sys_update_name": "String",
      "sys_updated_by": "String",
      "sys_updated_on": "String"
    }
    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 企業/消費者間ケースの場合。ケースに関連付けられたコンシューマーの詳細。
    データタイプ:オブジェクト
    "consumer": {
      "active": Boolean,
      "business_phone": "String",
      "city": "String",
      "country": "String",
      "date_format": "String",
      "email": "String",
      "fax": "String",
      "first_name": "String",
      "gender": "String",
      "home_phone": "String",
      "household": "String",
      "last_name": "String",
      "middle_name": "String",
      "mobile_phone": "String",
      "name": "String",
      "notes": "String",
      "notification": Number,
      "number": "String",
      "photo": Image,
      "preferred_language": "String",
      "prefix": "String",
      "primary": Boolean,
      "state": "String",
      "street": "String",
      "suffix": "String",
      "sys_created_by": "String",
      "sys_created_on": "String",
      "sys_domain": "String",
      "sys_id": "String",
      "sys_mod_count": Number,
      "sys_tags": "String",
      "sys_updated_by": "String",
      "sys_updated_on": "String",
      "time_format": "String",
      "time_zone": "String",
      "title": "String",
      "user": "String",
      "zip": "String"
    }
    sn_app_cs_social_social_profile.consumer.active コンシューマーがアクティブかどうかを示すフラグ。

    可能な値:

    • true:コンシューマーがアクティブ
    • false:コンシューマーが非アクティブ

    データタイプ:ブール

    デフォルト: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 日付を表示する形式。

    有効な値:

    • dd-mm-yyyy
    • dd/mm/yyyy
    • dd.mm.yyyy
    • mm-dd-yyyy
    • yyyy-mm-dd

    データタイプ:文字列

    最大長: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 コンシューマーが通知を受信するかどうかを示します。

    有効な値:

    • 1:無効
    • 2:有効

    データタイプ:数値 (整数)

    最大長: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 これがプライマリコンシューマーであるかどうかを示すフラグ。

    可能な値:

    • true:プライマリコンシューマー
    • false:プライマリコンシューマーではない

    データタイプ:ブール

    デフォルト値: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 時間を表示する形式。

    有効な値:

    • hh.mm.ss a: hh.mm.ss (12 時間制)
    • hh:mm:ss a: hh:mm:ss (12 時間制)
    • HH.mm.ss: hh.mm.ss (24 時間制)
    • HH:mm:ss: hh:mm:ss (24 時間制)

    データタイプ:文字列

    最大長: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:連絡先はアクティブです。
    • false:連絡先は非アクティブです。

    データタイプ:ブール

    デフォルト: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 連絡先に日付を表示する形式。

    有効な値:

    • dd/mm/yyyy
    • dd-mm-yyyy
    • dd.mm.yyyy
    • mm-dd-yyyy
    • yyyy-mm-dd

    データタイプ:文字列

    最大長: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 連絡先がサービスポータルにログインするためにマルチファクター認証が必要かどうかを示すフラグ。

    可能な値:

    • true:マルチファクター認証が有効
    • false:マルチファクター認証が無効

    データタイプ:ブール

    デフォルト値: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 連絡先の場所が位置情報追跡によって取得されたかどうかを示すフラグ。

    可能な値:

    • true:連絡先の場所は位置情報追跡によって取得された
    • false:連絡先の場所は位置情報追跡によって取得されていない

    データタイプ:ブール

    デフォルト値:false

    sn_app_cs_social_social_profile.contact.home_phone 連絡先の自宅電話番号。

    データタイプ:文字列

    最大長:40

    sn_app_cs_social_social_profile.contact.internal_itegration_user 連絡先が内部統合ユーザーかどうかを示すフラグ。

    可能な値:

    • true:内部統合ユーザー
    • false:他のタイプのユーザー

    データタイプ:ブール

    デフォルト値: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 連絡先がロックアウトされているかどうかを示すフラグ。

    可能な値:

    • true:連絡先がロックアウトされました
    • false:連絡先はロックアウトされていません

    データタイプ:ブール

    デフォルト値: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 連絡先が通知を受信するかどうかを示します。

    有効な値:

    • 1:無効
    • 2:有効

    データタイプ:数値 (整数)

    デフォルト値:2

    sn_app_cs_social_social_profile.contact.on_schedule ディスパッチされたサービス担当者の適時性を示します。

    有効な値:

    • Ahead:スケジュールの前倒し。
    • behind_less30:スケジュール遅延 (ただし 30 分未満)。
    • behind_30to60:スケジュール遅延 (30 ~ 60 分)。
    • behind_more60:スケジュール遅延 (60 分超)。
    • on_time:スケジュールどおり。

    データタイプ:文字列

    最大長: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 時間を表示する形式。

    有効な値:

    • hh.mm.ss a: hh.mm.ss (12 時間制)
    • hh:mm:ss a: hh:mm:ss (12 時間制)
    • HH.mm.ss: hh.mm.ss (24 時間制)
    • HH:mm:ss: hh:mm:ss (24 時間制)

    データタイプ:文字列

    最大長: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 ステータスかどうかを示すフラグ。

    可能な値:

    • true:VIP
    • false:VIP ではない

    データタイプ:ブール

    デフォルト値:false

    sn_app_cs_social_social_profile.contact.web_service_access_only 連絡先が Web 経由でのみサービスにアクセスできるかどうかを示すフラグ。

    可能な値:

    • true:Web アクセスのみ
    • false:利用可能なすべての方法によるアクセス

    データタイプ:ブール

    デフォルト値: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:新規
    • 3:クローズ済み
    • 6:解決済み
    • 10:オープン
    • 18:情報待ち

    データタイプ:数値 (整数)

    デフォルト値:1

    subcategory ケースのサブカテゴリ。

    可能な値:

    0:質問

    データタイプ:数値 (整数)

    デフォルト:0

    support_manager ケースにアサインされた CSM マネージャーの sys_id。

    データタイプ:文字列

    テーブル:ユーザー [sys_user]

    sync_driver ドライバーの同期があるかどうかを示すフラグ。

    可能な値:

    • true:ドライバーは同期されています
    • false:ドライバーが同期されていません

    データタイプ:ブーリアン

    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 ケースが承認された場合に実行するアクション。

    可能な値:

    • do_nothing
    • proceed

    データタイプ:文字列

    最大長:40

    デフォルト:proceed

    upon_reject ケースが却下された場合に実行するアクション。

    可能な値:

    • cancel
    • goto

    データタイプ:文字列

    最大長:40

    デフォルト:cancel

    urgency ケースの緊急度。

    可能な値:

    • 1 :高
    • 2 :中
    • 3:低

    データタイプ:数値 (整数)

    デフォルト値: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"
      }
    }