サービスカタログ API

サービスカタログ - DELETE /sn_sc/servicecatalog/cart/{cart_item_id}

指定されたアイテムを現在のカートから削除します。

URL 形式

バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/cart/{cart_item_id}

デフォルト URL: /api/sn_sc/servicecatalog/cart/{cart_item_id}

注:

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

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

表 : 1. パスパラメーター
名前	説明
api_version	オプション。アクセスするエンドポイントのバージョン。たとえば、 `v1` や `v2` などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列
cart_item_id	現在の買い物かごから削除するアイテムのSys_id。データタイプ：文字列

表 : 2. クエリパラメーター
名前	説明
なし

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

ヘッダー

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

表 : 4. 要求ヘッダー
ヘッダー	説明
なし

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

ステータスコード

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

表 : 6. ステータスコード
ステータスコード	説明
204	要求が正常に完了し、指定されたアイテムがカートから削除されたことを示します。
400	指定された cart_item_id が無効であるか、ユーザーがカートアイテムにアクセスできないことを示します。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
500	内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

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


名前	説明
なし

cURL 要求

curl "https://instance.servicenow.com/api/sn_sc/v1/servicecatalog/cart/1f4cc597db21120064301150f0b8f5fc" \
--request DELETE \
--user "username":"password"

None

サービスカタログ - DELETE /sn_sc/servicecatalog/cart/{sys_id}/empty

指定したカートとその中身を削除します。

ユーザーが削除できるもの (アイテムや買い物かご) の機能は、ユーザーが認証に使用するロールによって異なります。

買い物かごと買い物かごの内容を削除するために必要なユーザーロール:

admin/catalog_admin:ユーザーのカートを空にできます。
admin:買い物かごのすべての内容が削除された後に買い物かごを削除できます。
catalog_admin:買い物かご内のすべてのアイテムを削除できます。

URL 形式

バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/cart/{sys_id}/empty

デフォルト URL: /api/sn_sc/servicecatalog/cart/{sys_id}/empty

注:

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

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

表 : 7. パスパラメーター
名前	説明
api_version	オプション。アクセスするエンドポイントのバージョン。たとえば、 `v1` や `v2` などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列
sys_id	空にして削除する買い物かごのSys_id。データタイプ：文字列

表 : 8. クエリパラメーター
名前	説明
なし

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

ヘッダー

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

表 : 10. 要求ヘッダー
ヘッダー	説明
なし

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

ステータスコード

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

表 : 12. ステータスコード
ステータスコード	説明
204	要求が正常に完了し、買い物かごが空になったり削除されたりします。
400	次のいずれかの理由によるエラーを示します。 cartId が無効です。ユーザーにアドミン/catalog_adminロールがないか、別のユーザーのカートを空にしようとしています。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
500	内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

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


名前	説明
なし

cURL 要求

curl "https://instance.servicenow.com/api/sn_sc/servicecatalog/cart/dde34ad713426300027879d96144b072/empty" \
--request DELETE \
--user 'username':'password'

None

サービスカタログ - GET /sn_sc/servicecatalog/cart

ログインしているユーザーのカート内のアイテムの詳細を取得します。

URL 形式

バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/cart

デフォルト URL: /api/sn_sc/servicecatalog/cart

注:

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

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

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

表 : 14. クエリパラメーター
名前	説明
なし

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

ヘッダー

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

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

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

ステータスコード

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

表 : 18. ステータスコード
ステータスコード	説明
200	要求が正常に完了したことを示します。カートにアイテムがない場合は、ユーザーの基本的な買い物かご情報と価格が返されます。買い物かごにアイテムが含まれている場合は、アイテムに関する情報とその個別の価格設定も含まれます。
400	カートが空でチェックアウトできないことを示します。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
500	内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

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


パラメーター	説明
cart_id	買い物かごのSys_id。データタイプ：文字列
<recurring_frequency>	特定の繰り返し頻度を持つ買い物かご内のアイテムのリスト。可能な値は次のとおりです。日次月次年次なし (定期料金なし) データタイプ: オブジェクト `"<recurring_frequency>": { "frequency_label": "String", "items": [Array], "show_subtotal_price": "String", "subtotal_price": "String", "subtotal_recurring_frequency": "String", "subtotal_recurring_price": "String", "subtotal_title": "String", "total_title": "String"`
<recurring_frequency>.frequency_label	関連付けられた定期料金の頻度。データタイプ：文字列デフォルト：Null
<recurring_frequency>.items	指定された繰り返し頻度カテゴリに関連付けられた各アイテムの詳細を含むオブジェクトのリスト。データタイプ：アレイ "items": [{ "cart_item_id": "String", "catalog_item_id": "String", "created.by": "String", "created_on": "String", "delivery_time": "String", "item_id": "String", "item_name": "String", "localized_price": "String", "localized_recurring_price": "String", "name": "String", "order_guide": "String", "picture": "String", "price": "String", "quantity": "String", "recurring_frequency": "String", "recurring_price": "String", "recurring_subtotal": Number, "recurring_subtotal_price": "String", "short_description": "String", "show_price": Boolean, "show_quantity": Boolean, "show_recurring_price": Boolean, "subtotal": Number, "subtotal_price": "String", "sys_class_name": "String", "sys_id": "String", "updated_by": "String", "updated_on": "String", "variables": {Object} }]
<recurring_frequency>.items.cart_item_id	この買い物かごのアイテムのSys_id。データタイプ：文字列
<recurring_frequency>.items.catalog_item_id	アイテムに関連付けられたカタログのSys_id。データタイプ：文字列
<recurring_frequency>.items.created.by	最初にアイテムをカートに入れたユーザー。データタイプ：文字列
<recurring_frequency>.items.created_on	アイテムが最初にカートに入れられた日付。データタイプ：文字列
<recurring_frequency>.items.delivery_time	指定したアイテムが配送されるまでにかかる時間。データタイプ：文字列
<recurring_frequency>.items.item_id	アイテムのカタログsys_id。データタイプ：文字列
<recurring_frequency>.items.item_name	指定されたアイテムの名前。データタイプ：文字列
<recurring_frequency>.items.localized_price	現地通貨でのアイテムの価格。データタイプ：文字列
<recurring_frequency>.items.localized_recurring_price	指定されたアイテムの現地通貨での繰り返し料金。データタイプ：文字列
<recurring_frequency>.items.name	アイテム名。データタイプ：文字列
<recurring_frequency>.items.order_guide	このアイテムが関連付けられている注文ガイドの名前。データタイプ：文字列
<recurring_frequency>.items.picture	アイテムの画像のファイル名。データタイプ：文字列
<recurring_frequency>.items.price	アイテムの価格です。データタイプ：文字列
<recurring_frequency>.items.quantity	買い物かご内の指定されたアイテムの番号。データタイプ：文字列
<recurring_frequency>.items.recurring_frequency	指定されたアイテムに対して繰り返し発生する料金が請求される頻度。データタイプ：文字列デフォルト：Null
<recurring_frequency>.items.recurring_price	指定されたアイテムの繰り返し料金。データタイプ：文字列
<recurring_frequency>.items.recurring_subtotal	アイテムの繰り返し発生する料金の小計 (recurring_price x quantity)。データタイプ：数値
<recurring_frequency>.items.recurring_subtotal_price	アイテムの定期料金の小計。データタイプ：文字列
<recurring_frequency>.items.short_description	アイテムの簡単な説明。データタイプ：文字列
<recurring_frequency>.items.show_price	アイテムの価格がカートに表示されるかどうかを示すフラグ。可能な値： true:買い物かご内のアイテムの価格を表示します。 false:買い物かごにアイテムの価格を表示しません。データタイプ：ブーリアン
<recurring_frequency>.items.show_quantity	カートにアイテム数量を表示するかどうかを示すフラグ。可能な値： true:買い物かご内のアイテム数量を表示します。 false:買い物かごにアイテム数量を表示しません。データタイプ：ブーリアン
<recurring_frequency>.items.show_recurring_price	繰り返し発生する料金をカートに表示するかどうかを示すフラグ。可能な値： true:カートに繰り返し発生する料金を表示します。 false:買い物かごに繰り返し発生する料金を表示しません。データタイプ：ブーリアン
<recurring_frequency>.items.subtotal	アイテムの小計数。データタイプ：数値
<recurring_frequency>.items.subtotal_price	アイテムの小計 (price x quantity)。データタイプ：文字列
<recurring_frequency>.items.sys_class_name	アイテムのシステム分類名。データタイプ：文字列
<recurring_frequency>.items.sys_id	アイテムレコードのSys_id。データタイプ：文字列
<recurring_frequency>.items.updated_by	アイテムが最初にカートに入れられた後に更新したユーザー。データタイプ：文字列
<recurring_frequency>.items.updated_on	アイテムが最初にカートに入れられた、または更新された最後の日時。データタイプ：文字列
<recurring_frequency>.items.variables	アイテム変数の名前/値のペアのリスト。データタイプ: オブジェクト
<recurring_frequency>.show_subtotal_price	関連する定期料金カテゴリの小計を表示するかどうかを示すフラグ。可能な値： true:カートに小計を表示します。 false:カートに小計を表示しません。データタイプ：ブーリアン
<recurring_frequency>.subtotal_price	関連付けられた繰り返し頻度カテゴリのすべてのアイテムのコストの小計。データタイプ：文字列
<recurring_frequency>.subtotal_recurring_frequency	小計の繰り返し頻度のタイプ (日次、月次など)。subtotal_recurring_frequencyと同じです。データタイプ：文字列
<recurring_frequency>.subtotal_recurring_price	関連付けられた繰り返し頻度カテゴリ内のアイテムの繰り返し発生する料金の小計。データタイプ：文字列
<recurring_frequency>.subtotal_title	show_subtotal_priceが `true` に設定されている場合、関連するサブタイトルの買い物かごに表示されるテキスト。データタイプ：文字列
<recurring_frequency>.total_title	関連付けられた繰り返し頻度カテゴリの合計タイトルに表示するテキスト。データタイプ：文字列
show_subtotal_price	買い物かごに小計価格を表示するかどうかを示すフラグ。可能な値： true:カートに小計を表示します。 false:カートに小計を表示しません。データタイプ：文字列
subtotal_price	カート内のすべてのアイテムの小計 (ドル単位)。データタイプ：文字列
subtotal_recurring_frequency	小計の繰り返し頻度のタイプ (日次、月次など)。<recurring_frequency>.subtotal_recurring_frequencyと同じです。データタイプ：文字列
subtotal_recurring_price	買い物かご内のすべてのアイテムの繰り返し発生頻度料金の小計。データタイプ：文字列
subtotal_title	小計フィールドタイトルのカートに表示するテキスト。データタイプ：文字列
total_title	合計フィールドタイトルについてカートに表示するテキスト。データタイプ：文字列

cURL 要求

curl "https://instance.servicenow.com/api/sn_sc/servicecatalog/cart" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  "result": {
    "cart_id": "6d88bc29137d2300027879d96144b04b",
    "subtotal_price": "$1,598.00",
    "subtotal_recurring_frequency": "",
    "subtotal_recurring_price": "$0.00",
    "total_title": "Total",
    "none": {
      "subtotal_price": "$1,598.00",
      "subtotal_recurring_frequency": "",
      "subtotal_recurring_price": "$0.00",
      "total_title": "Total",
      "frequency_label": null,
      "items": [
      {
        "updated_on": "2018-11-15 14:24:00",
        "catalog_item_id": "07f1666b0bf00300eba42da0d5673ab0",
        "short_description": "Apple iPhone 7 ",
        "recurring_subtotal_price": "$0.00",
        "delivery_time": "2 Days",
        "sys_class_name": "sc_cat_item",
        "sys_id": "1f88bc29137d2300027879d96144b056",
        "price": "$799.00",
        "recurring_frequency": null,
        "subtotal_price": "$799.00",
        "variables": {},
        "quantity": "1",
        "item_id": "07f1666b0bf00300eba42da0d5673ab0",
        "recurring_price": "$0.00",
        "show_price": true,
        "item_name": "Apple iPhone7",
        "cart_item_id": "1f88bc29137d2300027879d96144b056",
        "recurring_subtotal": 0,
        "show_quantity": true,
        "created_by": "admin",
        "picture": "e823ee6b0bf00300eba42da0d5673a95.iix",
        "created_on": "2018-11-15 14:24:00",
        "localized_price": "$799.00",
        "subtotal": 799,
        "show_recurring_price": false,
        "name": "Apple iPhone7",
        "updated_by": "admin",
        "localized_recurring_price": "$0.00",
        "order_guide": ""
      },
    ],
    "show_subtotal_price": "true",
    "subtotal_title": "Subtotal"
   },
   "show_subtotal_price": "true",
   "subtotal_title": "Subtotal"
 }
}

サービスカタログ - GET /sn_sc/servicecatalog/cart/delivery_address/{user_id}

glide.sc.req_for.rolesプロパティとglide.sc.req_for.roles.defaultpropertyで構成されたデフォルトの動作に基づいて、指定されたユーザーの出荷先を取得します。

URL 形式

バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/cart/delivery_address/{user_id}

デフォルト URL: /api/sn_sc/servicecatalog/cart/delivery_address/{user_id}

注:

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

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

表 : 19. パスパラメーター
名前	説明
api_version	オプション。アクセスするエンドポイントのバージョン。たとえば、 `v1` や `v2` などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列
user_id	出荷先を取得するユーザーのSys_id。データタイプ：文字列テーブル：ユーザー [sys_user]

表 : 20. クエリパラメーター
名前	説明
なし

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

ヘッダー

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

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

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

ステータスコード

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

表 : 24. ステータスコード
ステータスコード	説明
200	要求が正常に完了しました。指定されたユーザーの出荷先を返します。
400	ユーザー sys_idが無効です。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
500	内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

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


名前	説明
result	指定されたユーザーのアドレス。データタイプ：文字列

cURL 要求

curl "https://instance.servicenow.com/api/sn_sc/servicecatalog/cart/delivery_address/62826bf03710200044e0bfc8bcbe5df1" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
'result': '25 New Chardon Street, Boston\nBoston, MA, 02114-1801\nUSA'
}

サービスカタログ - GET /sn_sc/servicecatalog/catalogs

渡されたパラメーターに基づいて、ユーザーがアクセスできるカタログのリストを取得します。

URL 形式

バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/catalogs

デフォルト URL: /api/sn_sc/servicecatalog/catalogs

注:

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

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

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

表 : 26. クエリパラメーター
名前	説明
sysparm_limit	返されるレコードの最大数。このレコード数を超える要求の場合は、 sysparm_offset パラメーターを使用してレコード取得をページネーションします。この制限は、ACL 評価の前に適用されます。アクセス権のあるレコードを含めて、レコードが返されない場合は、アクセス権のあるレコードが最初に返されるようにレコードの順序を並べ替えます。注: sysparm_limit値が異常に大きいと、システムのパフォーマンスに影響を与える可能性があります。データタイプ：数値デフォルト：10000
sysparm_text	利用可能なサービスカタログの [タイトル] フィールドで検索するキーワード。データタイプ：文字列
sysparm_view	アイテムを表示できるデバイス: desktop:デスクトップ上。 mobile:モバイルデバイスの場合。 both:デスクトップとモバイルデバイスの両方。データタイプ：文字列

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

ヘッダー

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

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

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

ステータスコード

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

表 : 30. ステータスコード
ステータスコード	説明
200	要求が正常に完了したことを示します。有効なクエリーが結果を返さない場合、応答本文には空の結果アレイのみが含まれます。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
500	内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

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


名前	説明
description	カタログの説明データタイプ：文字列
desktop_image	このカタログのデスクトップに表示される画像。データタイプ：文字列
has_categories	カタログにカテゴリが含まれているかどうかを示すフラグ。可能な値： true:カタログにカテゴリが含まれています。 false:カタログにカテゴリが含まれていません。データタイプ：ブーリアン
has_items	カタログにアイテムが含まれているかどうかを示すフラグ。可能な値： true:カタログにアイテムが含まれています。 false:カタログにアイテムが含まれていません。データタイプ：ブーリアン
sys_id	カタログのSys_id。データタイプ：文字列
タイトル	カタログタイトル。データタイプ：文字列

cURL 要求

curl "https://instance.servicenow.com/api/sn_sc/servicecatalog/catalogs?sysparm_limit=10" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  "result": [
    {
      "title": "Technical Catalog",
      "sys_id": "742ce428d7211100f2d224837e61036d",
      "has_categories": true,
      "has_items": true,
      "description": "Products and services for the IT department",
      "desktop_image": "7a7c8271475211002ee987e8dee4906d.iix"
    },
    {
      "title": "Service Catalog",
      "sys_id": "e0d08b13c3330100c8b837659bba8fb4",
      "has_categories": true,
      "has_items": true,
      "description": "Service Catalog - IT Now",
      "desktop_image": "adbcc271475211002ee987e8dee49001.iix"
    }
  ]
}

サービスカタログ - GET /sn_sc/servicecatalog/catalogs/{sys_id}/categories

指定されたカタログで利用可能なカテゴリのリストを取得します。

URL 形式

バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/catalogs/{sys_id}/categories

デフォルト URL: /api/sn_sc/servicecatalog/catalogs/{sys_id}/categories

注:

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

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

表 : 31. パスパラメーター
名前	説明
api_version	オプション。アクセスするエンドポイントのバージョン。たとえば、 `v1` や `v2` などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列
sys_id	カテゴリが要求されているカタログのSys_id。データタイプ：文字列

表 : 32. クエリパラメーター
名前	説明
sysparm_limit	返されるレコードの最大数。このレコード数を超える要求の場合は、 sysparm_offset パラメーターを使用してレコード取得をページネーションします。この制限は、ACL 評価の前に適用されます。アクセス権のあるレコードを含めて、レコードが返されない場合は、アクセス権のあるレコードが最初に返されるようにレコードの順序を並べ替えます。注: sysparm_limit値が異常に大きいと、システムのパフォーマンスに影響を与える可能性があります。データタイプ：数値デフォルト：10000
sysparm_offset	レコード取得を開始する開始レコードインデックス。この値を使用して、レコード取得をページネーションします。この機能を使用すると、レコードの数に関係なく、すべてのレコードを小さな管理可能なチャンクで取得できます。たとえば、このエンドポイントを初めて呼び出すとき、 sysparm_offset は「0」に設定されます。使用可能なすべてのレコードを単純にページングするには、すべてのレコードの最後に到達するまで `sysparm_offset=sysparm_offset+sysparm_limit` を使用します。 sysparm_offset パラメーターに負の数を渡さないでください。データタイプ：数値デフォルト：0
sysparm_top_level_only	親がカタログであるカテゴリのみを返します。有効な値： true:親がカタログであるカテゴリのみを返します。 false:すべてのカテゴリを返します。データタイプ：ブーリアン
sysparm_view	データをレンダリングする UI ビュー。応答で返されるフィールドを決定します。有効な値：デスクトップ mobile both sysparm_fields パラメーターも指定する場合は、それが優先されます。データタイプ：文字列

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

ヘッダー

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

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

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

ステータスコード

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

表 : 36. ステータスコード
ステータスコード	説明
200	カタログ内のカテゴリのリストを返します。クエリ結果がない場合は、空のアレイが返されます。
400	要求またはカタログsys_idが無効であることを示します。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
500	内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

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


名前	説明
カウント	カテゴリ内のアイテムの数。データタイプ：数値
description	カテゴリの簡単な説明。データタイプ：文字列
フル_description	カテゴリの詳細な説明。データタイプ：文字列
header_icon	カテゴリヘッダーで使用されるアイコン。データタイプ：文字列
homepage_image	カテゴリのホームページでこのカテゴリに表示される画像。データタイプ：文字列
icon	このカテゴリを示すために使用するアイコン。データタイプ：文字列
サブカテゴリ	カテゴリ内のサブカテゴリのリスト。データタイプ：アレイ `"subcategories": [ "sys_id": "String", "title": "String ]`
subcategories.sys_id	サブカテゴリのSys_id。データタイプ：文字列
subcategories.title	サブカテゴリのタイトル。データタイプ：文字列
sys_id	カテゴリの sys_id。データタイプ：文字列
タイトル	カテゴリのタイトル。データタイプ：文字列

cURL 要求

curl "https://instance.servicenow.com/api/sn_sc/servicecatalog/catalogs/e0d08b13c3330100c8b837659bba8fb4/categories?sysparm_limit=2 \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  "result": [
    {
      "title": "Can We Help You?",
      "description": "Your IT gateway. Report issues and submit requests.\n\t\t",
      "full_description": null,
      "icon": "",
      "header_icon": "",
      "homepage_image": "29f8ffa9471211002ee987e8dee4905e.iix",
      "count": 14,
      "subcategories": [],
      "sys_id": "e15706fc0a0a0aa7007fc21e1ab70c2f"
    },
    {
      "title": "Departmental Services",
      "description": "Services offered by different departments in the organization",
      "full_description": null,
      "icon": "",
      "header_icon": "",
      "homepage_image": "6fb4a1d95f2211001c9b2572f2b47748.iix",
      "count": 1,
      "subcategories": [],
      "sys_id": "95fc11615f1211001c9b2572f2b477c6"
    },
    {
      "title": "Desktops",
      "description": "Desktop computers for your work area.",
      "full_description": null,
      "icon": "",
      "header_icon": "",
      "homepage_image": "1bface31475211002ee987e8dee49095.iix",
      "count": 1,
      "subcategories": [],
      "sys_id": "900682363731300054b6a3549dbe5d5f"
    }
  ]
}

サービスカタログ - GET /sn_sc/servicecatalog/catalogs/{sys_id}

指定されたカタログの利用可能な情報を取得します。

URL 形式

バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/catalogs/{sys_id}

デフォルト URL: /api/sn_sc/servicecatalog/catalogs/{sys_id}

注:

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

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

表 : 37. パスパラメーター
名前	説明
api_version	オプション。アクセスするエンドポイントのバージョン。たとえば、 `v1` や `v2` などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列
sys_id	取得するカタログのSys_id。データタイプ：文字列

表 : 38. クエリパラメーター
名前	説明
sysparm_view	アイテムを表示できるデバイス: desktop:デスクトップ上。 mobile:モバイルデバイスの場合。 both:デスクトップとモバイルデバイスの両方。データタイプ：文字列

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

ヘッダー

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

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

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

ステータスコード

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

表 : 42. ステータスコード
ステータスコード	説明
200	要求が正常に完了したことを示し、指定されたカタログの利用可能な情報を返します。
400	次のいずれかの理由で要求が無効であることを示します。ユーザーにはカタログへのアクセス権がありません。 sys_idが無効です。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
500	内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

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


名前	説明
categories	カタログ内のカテゴリを説明するオブジェクトのリスト。データタイプ：アレイ `"categories": [ "description": "String", "header_image": "String", "sys_id": "String", "title": "String ]`
categories.description	カテゴリの説明。データタイプ：文字列
categories.header_image	カテゴリヘッダー画像。データタイプ：文字列
categories.sys_id	一意のカテゴリ識別子 (sys_id)。データタイプ：文字列
categories.title	カテゴリのタイトル。データタイプ：文字列
description	カタログの説明。データタイプ：文字列
desktop_image	デスクトップビューでカタログとともに表示される画像のソース。データタイプ：文字列
has_categories	カタログにカテゴリがあるかどうかを示すフラグ。可能な値： true:カタログにはカテゴリがあります。 false:カタログにカテゴリがありません。データタイプ：ブーリアン
has_items	カテゴリ内にアイテムがあるかどうかを示すフラグ。可能な値： true:カタログにアイテムが関連付けられています。 false:カタログに関連付けられたアイテムがありません。データタイプ：ブーリアン
sys_id	一意のカタログsys_id。データタイプ：文字列
タイトル	カタログタイトル。データタイプ：文字列

cURL 要求

curl "https://instance.servicenow.comaqsw" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  "result": {
    "title": "Customer Service",
    "sys_id": "65bcd377c3011200b12d9f2974d3aea0",
    "has_categories": true,
    "categories": [
      {
        "header_image": "",
        "sys_id": "4cb69d19c3921200b0449f2974d3ae69",
        "description": null,
        "title": "Services"
      },
      {
        "header_image": "",
        "sys_id": "1b8611d5c3921200b0449f2974d3ae12",
        "description": null,
        "title": "Support"
      }
    ],
    "has_items": true,
    "description": "Customer Service",
    "desktop_image": ""
  }
}

サービスカタログ - GET /sn_sc/servicecatalog/categories/{sys_id}

指定されたカテゴリの利用可能な情報を取得します。

URL 形式

バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/categories/{sys_id}

デフォルト URL: /api/sn_sc/servicecatalog/categories/{sys_id}

注:

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

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

表 : 43. パスパラメーター
名前	説明
api_version	オプション。アクセスするエンドポイントのバージョン。たとえば、 `v1` や `v2` などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列
sys_id	情報を返すカテゴリのSys_id。データタイプ：文字列

表 : 44. クエリパラメーター
名前	説明
sysparm_view	データをレンダリングする UI ビュー。応答で返されるフィールドを決定します。有効な値：デスクトップ mobile both sysparm_fields パラメーターも指定する場合は、それが優先されます。データタイプ：文字列

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

ヘッダー

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

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

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

ステータスコード

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

表 : 48. ステータスコード
ステータスコード	説明
200	成功。要求が正常に処理されました。
400	次のいずれかの理由で要求が無効であることを示します。ユーザーにはカテゴリへのアクセス権がありません。 sys_idが無効です。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
500	内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

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


名前	説明
child_categories	このカテゴリに属する子カテゴリを説明するオブジェクトのリスト。データタイプ：アレイ `"child_categories": [ "count": Number, "isParentCategory": "String", "parent": "String", "subcategories": [Array], "sys_id": "String", "title": "String" ]`
child_categories.count	子カテゴリ内のアイテムの数。データタイプ：数値
child_categories.isParentCategory	これが親カテゴリであるかどうかを示すフラグ。可能な値： true:親カテゴリ。 false:親カテゴリではありません。データタイプ：ブーリアン
child_categories.parent	子カテゴリの親のSys_id。データタイプ：文字列
child_categories.subcategories	この子カテゴリのサブカテゴリを説明するオブジェクトのリスト。データタイプ：アレイ `"subcategories": [ "sys_id": "String", "title": "String" ]`
child_categories.subcategories.sys_id	子サブカテゴリのSys_id。データタイプ：文字列
child_categories.subcategories.title	子サブカテゴリのタイトル。データタイプ：文字列
child_categories.sys_id	子カテゴリのSys_id。データタイプ：文字列
child_categories.title	子カテゴリのタイトル。データタイプ：文字列
description	簡単なカテゴリの説明。データタイプ：文字列
full_description	カテゴリの詳細な説明。データタイプ：文字列
header_icon	カテゴリがトップレベルのカテゴリにリストされているときにカテゴリヘッダーの横に表示されるアイコンのソース。データタイプ：文字列
homepage_image	カテゴリのホームページ画像のソース。データタイプ：文字列
icon	カテゴリがサブカテゴリとしてリストされている場合、カテゴリ名の横に表示される小さなアイコンのソース。データタイプ：文字列
sys_id	カテゴリの sys_id。データタイプ：文字列
タイトル	カテゴリのタイトル。データタイプ：文字列

cURL 要求

curl "https://instance.servicenow.com/api/sn_sc/servicecatalog/categories/b0fdfb01932002009ca87a75e57ffbe9" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  "result": {
    "title": "Office",
    "description": "Office services such as printing, supplies requisition\n\t\t\tand document shipping and delivery.\n\t\t",
    "full_description": null,
    "icon": "",
    "header_icon": "",
    "homepage_image": "498b0271475211002ee987e8dee490ea.iix",
    "sys_id": "109cdff8c6112276003b17991a09ad65",
    "child_categories": [
      {
        "sys_id": "109f0438c6112276003ae8ac13e7009d",
        "title": "Services",
        "count": 16,
        "parent": "109cdff8c6112276003b17991a09ad65",
        "subcategories": [],
        "isParentCategory": false
      }
    ]
  }
}

サービスカタログ - GET /sn_sc/servicecatalog/items

指定されたパラメーターに基づいてカタログアイテムのリストを取得します。

URL 形式

バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/items

デフォルト URL: /api/sn_sc/servicecatalog/items

注:

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

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

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

表 : 50. クエリパラメーター
名前	説明
sysparm_catalog	アイテムのカタログsys_id。このパラメーターを使用して、特定のカタログ内のアイテムを検索します。データタイプ：文字列
sysparm_category	アイテムのカテゴリsys_id。このパラメーターを使用して、特定のカテゴリのカタログアイテムを検索します。データタイプ：文字列
sysparm_limit	返されるレコードの最大数。このレコード数を超える要求の場合は、 sysparm_offset パラメーターを使用してレコード取得をページネーションします。この制限は、ACL 評価の前に適用されます。アクセス権のあるレコードを含めて、レコードが返されない場合は、アクセス権のあるレコードが最初に返されるようにレコードの順序を並べ替えます。注: sysparm_limit値が異常に大きいと、システムのパフォーマンスに影響を与える可能性があります。データタイプ：数値デフォルト：10000
sysparm_offset	レコード取得を開始する開始レコードインデックス。この値を使用して、レコード取得をページネーションします。この機能を使用すると、レコードの数に関係なく、すべてのレコードを小さな管理可能なチャンクで取得できます。たとえば、このエンドポイントを初めて呼び出すとき、 sysparm_offset は「0」に設定されます。使用可能なすべてのレコードを単純にページングするには、すべてのレコードの最後に到達するまで `sysparm_offset=sysparm_offset+sysparm_limit` を使用します。 sysparm_offset パラメーターに負の数を渡さないでください。データタイプ：数値デフォルト：0
sysparm_text	カテゴリアイテムで検索する特定のテキスト。たとえば、 `sysparm_text="iPhone"` や `sysparm_text="Mobile devices"` などです。データタイプ：文字列
sysparm_type	アイテムのタイプ。有効な検索値: レコードプロデューサー注文ガイド他の値が渡された場合、その情報は無視されます。データタイプ：文字列
sysparm_view	データをレンダリングする UI ビュー。応答で返されるフィールドを決定します。有効な値：デスクトップ mobile both sysparm_fields パラメーターも指定する場合は、それが優先されます。データタイプ：文字列

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

ヘッダー

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

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

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

ステータスコード

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

表 : 54. ステータスコード
ステータスコード	説明
200	指定されたパラメーターに基づいて、カタログとアイテムのリストを返します。有効なクエリーの結果がアイテムも生成されない場合、応答本文には空の結果アレイのみが含まれます。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
500	内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

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


パラメーター	説明
catalogs	このアイテムを含むカタログを説明するオブジェクトのリスト。データタイプ：アレイ `"catalogs": [{ "sys_id": "String", "title": "String" }]`
catalogs.sys_id	カタログのSys_id。データタイプ：文字列
catalogs.title	カタログタイトル。データタイプ：文字列
category	このアイテムを含むカテゴリについて説明します。データタイプ: オブジェクト `"catalogs": { "sys_id": "String", "title": "String" }`
category.sys_id	カテゴリの sys_id。データタイプ：文字列
category.title	カテゴリのタイトル。データタイプ：文字列
content_type	コンテンツのタイプ。データタイプ：文字列
description	アイテムの詳細な説明。データタイプ：文字列
icon	アイテム名の横に表示される小さなアイコンのソース。データタイプ：文字列
kb_article	アイテムに関連付けられたナレッジベースの記事。データタイプ：文字列
local_currency	現地通貨の国通貨コード。データタイプ：文字列
localized_price	local_currency で定義された通貨で表されたアイテムの価格。データタイプ：文字列
localized_recurring_price	local_currency で定義された通貨で表された繰り返し発生料金の価格。データタイプ：文字列
name	アイテムの名前。データタイプ：文字列
order	アイテムが属する事前定義された注文。データタイプ：数値
画像	アイテムに表示する画像へのパス。データタイプ：文字列
価格	price_currency で定義された通貨で表示されるアイテムの価格。データタイプ：文字列
price_currency	アイテム価格を表す国通貨コード。データタイプ：文字列
recurring_frequency	日次、月次、年次など、定期料金が適用される頻度。アイテムに料金がかからない場合は null。データタイプ：文字列
recurring_price	アイテムに関連付けられている繰り返し発生する料金の金額。データタイプ：文字列
recurring_price_currency	繰り返し発生する料金を表す国の通貨コード。データタイプ：文字列
short_description	アイテムの簡単な説明。データタイプ：文字列
show_price	買い物かごにアイテムの価格を表示するかどうかを示すフラグ。可能な値： true:名前と値のペアが応答パラメーターに返されます。 false:名前と値のペアは応答パラメーターに返されません。データタイプ：ブーリアン
show_quantity	カートにアイテム数量を表示するかどうかを示すフラグ。可能な値： true:買い物かご内のアイテム数量を表示します。 false:買い物かごにアイテム数量を表示しません。データタイプ：ブーリアン
sys_class_name	sc_cat_item_producer など、レコードが属するテーブル。データタイプ：文字列
sys_id	アイテムのSys_id。データタイプ：文字列
type	アイテムのタイプ。データタイプ：文字列
url	アイテムの URL。データタイプ：文字列

cURL 要求

curl "https://instance.servicenow.com/api/sn_sc/servicecatalog/items?sysparm_catalog=e0d08b13c3330100c8b837659bba8fb4&sysparm_limit=2" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  "result": [
    {
      "short_description": null,
      "kb_article": "",
      "icon": "images/icons/catalog_item.gifx",
      "description": "<p class=\"p1\"><font size=\"2\"><span class=\"s1\">Request an existing Standard Change Template is made unavailable when it is no longer required or no longer acceptable as a Standard Change.  This will be confirmed by your Change Management team.</span></font></p>",
      "show_price": false,
      "type": "record_producer",
      "show_quantity": true,
      "sys_class_name": "sc_cat_item_producer",
      "picture": "",
      "url": "",
      "sys_id": "011f117a9f3002002920bde8132e7020",
      "content_type": "",
      "catalogs": [
        {
          "sys_id": "e0d08b13c3330100c8b837659bba8fb4",
          "title": "Service Catalog"
        }
      ],
      "name": "Retire a Standard Change Template",
      "category": {
        "sys_id": "00728916937002002dcef157b67ffb6d",
        "title": "Template Management"
      },
      "order": 30
    },
    {
      "short_description": null,
      "kb_article": "",
      "icon": "4cc3ec3d471211002ee987e8dee490d0.iix",
      "description": "<p><font size=\"3\" color=\"#808080\" face=\"arial,helvetica,sans-serif\">A role delegator may delegate any role they have to any member of the specified group</font></p>",
      "show_price": false,
      "type": "record_producer",
      "show_quantity": true,
      "sys_class_name": "sc_cat_item_producer",
      "picture": "ed44b5804f889200086eeed18110c7ca.iix",
      "url": "",
      "sys_id": "01205b180a0a0b3000b6efd641d24b75",
      "content_type": "",
      "catalogs": [
        {
          "sys_id": "e0d08b13c3330100c8b837659bba8fb4",
          "title": "Service Catalog"
        }
      ],
      "name": "Grant role delegation rights within a group",
      "category": {
        "sys_id": "496a3a7e0a0a0bc00089b39df14eb56e",
        "title": "Role Delegation"
      },
      "order": 100
    }
  ]
}

サービスカタログ - GET /sn_sc/servicecatalog/items/{item_sys_id}/delegation/{user_sys_id}

指定された委任されたユーザーが、指定されたサービスカタログアイテムに対する取得権限を持っているかどうかを確認します。

URL 形式

バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/items/{item_sys_id}/delegation/{user_sys_id}

デフォルト URL: /api/sn_sc/servicecatalog/items/{item_sys_id}/delegation/{user_sys_id}

注:

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

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

表 : 55. パスパラメーター
名前	説明
api_version	オプション。アクセスするエンドポイントのバージョン。たとえば、 `v1` や `v2` などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列
item_sys_id	指定されたユーザーが権利取得を持っているかどうかを確認するためのサービスカタログアイテムのSys_id。データタイプ：文字列テーブル:サービスカタログ [sc_catalog]
user_sys_id	指定されたサービスカタログアイテムに対する取得権限を持っているかどうかを確認するユーザーのSys_id。データタイプ：文字列テーブル:ユーザー [sys_users]

表 : 56. クエリパラメーター
名前	説明
なし

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

ヘッダー

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

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

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

ステータスコード

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

表 : 60. ステータスコード
ステータスコード	説明
200	成功。要求が正常に処理されました。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
500	内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

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


名前	説明
result	指定されたユーザーが、指定されたサービスカタログアイテムに対する取得権限を持っているかどうかを示すフラグ。有効な値： true:ユーザーには取得権限があります。 false:ユーザーに取得権限がありません。

cURL 要求

curl "https://instance.servicenow.com/api/sn_sc/servicecatalog/items/5c7e9fd20f1010108af26b198b767eb8/delegation/62826bf03710200044e0bfc8bcbe5df1" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  "result": {
    "result": true
  }
}

サービスカタログ - GET /sn_sc/servicecatalog/items/{sys_id}

指定されたカタログアイテムを取得します。

URL 形式

バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/items/{sys_id}

デフォルト URL: /api/sn_sc/servicecatalog/items/{sys_id}

注:

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

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

表 : 61. パスパラメーター
名前	説明
api_version	オプション。アクセスするエンドポイントのバージョン。たとえば、 `v1` や `v2` などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列
sys_id	返されるカタログアイテムのSys_id。データタイプ：文字列

表 : 62. クエリパラメーター
名前	説明
sysparm_view	データをレンダリングする UI ビュー。応答で返されるフィールドを決定します。有効な値：デスクトップ mobile both sysparm_fields パラメーターも指定する場合は、それが優先されます。データタイプ：文字列

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

ヘッダー

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

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

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

ステータスコード

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

表 : 66. ステータスコード
ステータスコード	説明
200	要求が正常に完了したことを示し、カタログアイテムの詳細を返します。
400	次のいずれかの理由で要求が無効であることを示します。ユーザーにはカタログアイテムへのアクセス権がありません。 sys_idが無効です。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
500	内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

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


名前	説明
catalogs	このアイテムを含むカタログを説明するオブジェクトのリスト。データタイプ：アレイ `"catalogs": [{ "sys_id": "String", "title": "String" }]`
catalogs.sys_id	カタログのSys_id。データタイプ：文字列
catalogs.title	カタログタイトル。データタイプ：文字列
categories	このアイテムを含むカテゴリを説明するオブジェクトのリスト。データタイプ：アレイ `"categories": [{ "active": Boolean, "category": {Object}, "sys_id": "String", "title": "String" }]`
categories.active	カテゴリがアクティブかどうかを示すフラグ。可能な値： true:カテゴリはアクティブです。 false:カテゴリは非アクティブです。データタイプ：ブーリアン
categories.category	関連するカテゴリについて説明します。データタイプ: オブジェクト `"category": { "active": Boolean, "sys_id": "String", "title": "String" }`
categories.category.active	カテゴリがアクティブかどうかを示すフラグ。可能な値： true:カテゴリはアクティブです。 false:カテゴリは非アクティブです。データタイプ：ブーリアン
categories.category.sys_id	カテゴリの sys_id。データタイプ：文字列
categories.category.title	カテゴリのタイトル。データタイプ：文字列
categories.sys_id	categories.categoryで指定されたカテゴリの親カテゴリ。データタイプ：文字列
category	アイテムが属するプライマリカテゴリ。データタイプ: オブジェクト `"category": { "sys_id": "String", "title": "String" }`
category.sys_id	プライマリカテゴリのSys_id。データタイプ：文字列
category.title	プライマリカテゴリのタイトル。データタイプ：文字列
client_script	カタログアイテムで定義されているすべてのカタログクライアントスクリプトのリスト。データタイプ: オブジェクト `"client_script": { "onChange": [Array], "onLoad": [Array], "onSubmit": [Array] }`
client_script.onChange	アイテムに関連付けられた onChange クライアントスクリプトのリスト。データタイプ：アレイ
client_script.onSubmit	アイテムに関連付けられた onSubmit クライアントスクリプトのリスト。データタイプ：アレイ
client_script.onLoad	アイテムに関連付けられた onLoad クライアントスクリプトのリスト。データタイプ：アレイ
content_type	コンテンツのタイプ。データタイプ：文字列
data_lookup	カタログアイテムで定義されているデータルックアップのリスト。データタイプ：アレイ
description	アイテムの詳細な説明。データタイプ：文字列
icon	アイテム名の横に表示される小さなアイコンのソース。データタイプ：文字列
kb_article	アイテムに関連付けられたナレッジベースの記事。データタイプ：文字列
local_currency	現地通貨の国通貨コード。データタイプ：文字列
localized_price	local_currency で定義された通貨で表されたアイテムの価格。データタイプ：文字列
localized_recurring_price	local_currency で定義された通貨で表された繰り返し発生料金の価格。データタイプ：文字列
name	アイテムの名前。データタイプ：文字列
order	アイテムの注文数。データタイプ：数値
画像	アイテムに表示する画像のファイル名。データタイプ：文字列
価格	price_currency で定義された通貨で表示されるアイテムの価格。データタイプ：文字列
price_currency	アイテム価格を表す国通貨コード。データタイプ：文字列
recurring_frequency	日次、月次、年次など、繰り返し発生する料金が適用される頻度。データタイプ：文字列
recurring_price	アイテムに関連付けられている繰り返し発生する料金の金額データタイプ：文字列
recurring_price_currency	繰り返し発生する料金を表す国の通貨コード。データタイプ：文字列
short_description	アイテムの簡単な説明。データタイプ：文字列
show_price	買い物かごにアイテムの価格を表示するかどうかを示すフラグ。可能な値： true:価格名/値のペアが応答パラメーターに返されます。 false:価格設定名/値のペアは応答パラメーターに返されません。データタイプ：ブーリアン
show_quantity	カートにアイテム数量を表示するかどうかを示すフラグ。可能な値： true:買い物かご内のアイテム数量を表示します。 false:買い物かごにアイテム数量を表示しません。データタイプ：ブーリアン
sys_class_name	このレコードが属するテーブルの名前。データタイプ：文字列
sys_id	アイテムのSys_id。データタイプ：文字列
type	アイテムのタイプ。データタイプ：文字列
ui_policy	アイテムに関連付けられた UI ポリシーのリスト。データタイプ：アレイ
url	アイテム画像の URL。データタイプ：文字列
variables	アイテムに関連付けられている利用可能な変数のリスト。データタイプ：アレイ

cURL 要求

curl "https://instance.servicenow.com/api/sn_sc/servicecatalog/items/0cf7477237153000158bbfc8bcbe5dec" \
  --request GET \
  --header "Accept:application/json" \
  --user "username":"password"

{
  "result": {
    "short_description": "Apple iPad 3",
    "kb_article": "",
    "icon": "e6b3bc0647311200e0ef563dbb9a71fc.iix",
    "description": "\n\t\t\t<p>\n\t\t\t\t<font size=\"3\">\n\t\t\t\t\t<span style=\"color: gray;\">\n\t\t\t\t\t\tiPad with Retina display Wi-Fi 16GB - Black </span>\n\t\t\t\t</font>\n\t\t\t</p>\n\t\t\t<p>\n\t\t\t\t<span style=\"color: gray;\">Key Features:</span>\n\t\t\t</p>\n\t\t\t<ul><li style=\"color: gray;\">\n\t\t\t\t\t<span style=\"font-size: 10.0pt;\">Retina display (2048x1536 resolution)</span>\n\t\t\t\t</li><li style=\"color: gray;\">\n\t\t\t\t\t<span style=\"font-size: 10.0pt;\">16GB storage</span>\n\t\t\t\t</li><li style=\"color: gray;\">\n\t\t\t\t\t<span style=\"font-size: 10.0pt;\">Wi-Fi enabled</span>\n\t\t\t\t</li><li style=\"color: gray;\">\n\t\t\t\t\t<span style=\"font-size: 10.0pt;\">Built-in speaker, microphone and camera</span>\n\t\t\t\t</li><li style=\"color: gray;\">\n\t\t\t\t\t<span style=\"font-size: 10.0pt;\">Up to 10 hours battery life</span>\n\t\t\t\t</li></ul>",
    "show_price": true,
    "recurring_price": "$0.00",
    "type": "catalog_item",
    "show_quantity": true,
    "local_currency": "USD",
    "sys_class_name": "pc_hardware_cat_item",
    "picture": "5b977690cb921200f2de77a4634c9c6a.iix",
    "url": "",
    "sys_id": "060f3afa3731300054b6a3549dbe5d3e",
    "recurring_price_currency": "USD",
    "content_type": "",
    "localized_price": "$600.00",
    "price": "$600.00",
    "catalogs": [
      {
        "sys_id": "e0d08b13c3330100c8b837659bba8fb4",
         "title": "Service Catalog"
      }
    ],
    "recurring_frequency": null,
    "name": "Apple iPad 3",
    "localized_recurring_price": "$0.00",
    "category": {
      "sys_id": "b06546f23731300054b6a3549dbe5dd8",
      "title": "Tablets"
    },
    "price_currency": "USD",
    "order": 0,
    "categories": [
      {
        "sys_id": "d258b953c611227a0146101fb1be7c31",
        "active": true,
        "category": {
          "sys_id": "b06546f23731300054b6a3549dbe5dd8",
          "active": true,
          "title": "Tablets"
        },
        "title": "Hardware"
      }
    ],
    "variables": [],
    "ui_policy": [],
    "client_script": {
      "onChange": [],
      "onSubmit": [],
      "onLoad": []
    },
    "data_lookup": []
  }
}

サービスカタログ - GET /sn_sc/servicecatalog/wishlist

ログインしているユーザーのウィッシュリスト内のアイテムのリストを取得します。

URL 形式

バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/wishlist

デフォルト URL: /api/sn_sc/servicecatalog/wishlist

注:

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

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

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

表 : 68. クエリパラメーター
名前	説明
なし

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

ヘッダー

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

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

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

ステータスコード

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

表 : 72. ステータスコード
ステータスコード	説明
200	成功。要求が正常に処理されました。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
500	内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

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


名前	説明
cart_id	ウィッシュリストの買い物かごのSys_id。データタイプ：文字列
アイテム	ウィッシュリストの買い物かご内のアイテムを説明するオブジェクトのリスト。データタイプ：アレイ "items": [{ "cart_item_id": "String", "catalog_item_id": "String", "created_by": "String", "created_on": "String", "delivery_time": "String", "item_id": "String", "item_name": "String", "localized_price": "String", "localized_recurring_price": "String", "name": "String", "order_guide": "String", "picture": "String", "price": "String", "quantity": "String", "recurring_frequency": "String", "recurring_price": "String", "recurring_subtotal": Number, "recurring_subtotal_price": "String", "short_descriptions": "String", "show_price": Boolean, "show_quantity": Boolean, "show_recurring_price": Boolean, "subtotal": Number, "subtotal_price": "String", "sys_class_name": "String", "sys_id": "String", "updated_by": "String", "updated_on": "String", "variables": {Object} }]
items.cart_item_id	アイテムのSys_id。items.sys_idと同じです。データタイプ：文字列
items.catalog_item_id	ウィッシュリストの買い物かごにあるこのアイテムのカタログ識別子のSys_id。items.item_idと同じです。データタイプ：文字列
items.created_by	最初にウィッシュリストの買い物かごにアイテムを入れたユーザー。データタイプ：文字列
items.created_on	アイテムが最初にウィッシュリストカートに入れられた日時。データタイプ：文字列
items.delivery_time	アイテムの配送に要する時間。データタイプ：文字列
items.item_id	ウィッシュリストの買い物かご内のこのアイテムの一意のカタログ識別子 (sys_id)。items.catalog_item_idと同じです。データタイプ：文字列
items.item_name	アイテムの名前。データタイプ：文字列
items.localized_price	現地通貨で表示されたアイテムの価格。データタイプ：文字列
items.localized_recurring_price	現地通貨で表示された繰り返し発生する料金の価格。データタイプ：文字列
items.name	アイテムの名前。データタイプ：文字列
items.order_guide	アイテムが関連付けられている注文ガイド。データタイプ：文字列
items.picture	アイテムに表示する画像へのパス。データタイプ：文字列
items.price	アイテムの価格。データタイプ：文字列
items.quantity	ウィッシュリストのカート内のこのアイテムの番号。データタイプ：文字列
items.recurring_frequency	日次、月次、年次など、繰り返し発生する料金が適用される頻度。このアイテムに繰り返し発生する料金がない場合は null。データタイプ：文字列
items.recurring_price	アイテムに関連付けられている繰り返し発生する料金の金額。データタイプ：文字列
items.recurring_subtotal	このアイテムの定期料金の小計 (recurring_price x 数量)。データタイプ：数値
items.recurring_subtotal_price	このアイテムの定期料金の小計 (recurring_price x 数量)。データタイプ：文字列
items.short_description	アイテムの簡単な説明。データタイプ：文字列
items.show_price	買い物かごにアイテムの価格を表示するかどうかを示すフラグ。このパラメーターが「false」に設定されている場合、価格設定名/値のペアは応答パラメーターに返されません。データタイプ：ブーリアン
items.show_quantity	カートにアイテム数量を表示するかどうかを示すフラグ。データタイプ：ブーリアン
items.show_recurring_price	カートに繰り返し発生する料金を表示するかどうかを示すフラグ。データタイプ：ブーリアン
items.subtotal	このアイテムの小計:セント (価格 x 数量) は含まれません。データタイプ：数値
items.subtotal_price	このアイテムの小計:セント (価格 x 数量) を含む。データタイプ：文字列
items.sys_class_name	関連付けられたアイテムレコードが属する子クラス。データタイプ：文字列
items.sys_id	アイテムの一意の識別子 (sys_id)。items.cart_item_idと同じです。データタイプ：文字列
items.updated_by	ウィッシュリストのカートでこのアイテムを更新したユーザー。データタイプ：文字列
items.updated_on	アイテムがウィッシュリストに追加された日時。データタイプ：文字列
items.variables	アイテムに関連付けられた変数の名前と値のペア。データタイプ: オブジェクト

cURL 要求

curl "http://instance.servicenow.com/api/sn_sc/servicecatalog/wishlist" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

{
  "result": {
    "cart_id": "3a68c46013f12300027879d96144b0ce",
    "items": [
      {
        "updated_on": "2018-11-16 05:54:41",
        "catalog_item_id": "774906834fbb4200086eeed18110c737",
        "short_description": "Macbook Pro",
        "recurring_subtotal_price": "$100.00",
        "delivery_time": "5 Days 0 seconds",
        "sys_class_name": "sc_cat_item",
        "sys_id": "3b8d887113b5a300027879d96144b0c2",
        "price": "$1,499.00",
        "recurring_frequency": "Annually",
        "subtotal_price": "$1,499.00",
        "variables": {
          "Adobe Photoshop": "false",
          "Adobe Acrobat": "false",
          "Optional Software": "true",
          "Additional software requirements": "",
          "Eclipse IDE": "true"
        },
        "quantity": "1",
        "item_id": "774906834fbb4200086eeed18110c737",
        "recurring_price": "$100.00",
        "show_price": true,
        "item_name": "Developer Laptop (Mac)",
        "cart_item_id": "3b8d887113b5a300027879d96144b0c2",
        "recurring_subtotal": 100,
        "show_quantity": true,
        "created_by": "admin",
        "picture": "4e4efd444f889200086eeed18110c7e6.iix",
        "created_on": "2018-11-16 05:54:41",
        "localized_price": "$1,499.00",
        "subtotal": 1499,
        "show_recurring_price": true,
        "name": "Developer Laptop (Mac)",
        "updated_by": "admin",
        "localized_recurring_price": "$100.00",
        "order_guide": ""
      }
    ]
  }
}

サービスカタログ - GET /sn_sc/servicecatalog/wishlist/{cart_item_id}

ウィッシュリストの買い物かごに保存されている指定されたアイテムの詳細を取得します。

URL 形式

バージョニングされた URL: /api/sn_sc/v1/servicecatalog/wishlist/{cart_item_id}

デフォルト URL: /api/sn_sc/servicecatalog/wishlist/{cart_item_id}

注:

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

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

表 : 73. パスパラメーター
名前	説明
cart_item_id	取得するウィッシュリストのカートアイテムのSys_id。データタイプ：文字列

表 : 74. クエリパラメーター
名前	説明
なし

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

ヘッダー

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

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

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

ステータスコード

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

表 : 78. ステータスコード
ステータスコード	説明
200	成功。要求が正常に処理されました。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
404	失敗した要求を示します。カートアイテム ID が正しくないか、アイテムがウィッシュリストのカートに存在しません。
500	内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

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


名前	説明
cart_item_id	アイテムのSys_id。データタイプ：文字列
catalog_item_id	ウィッシュリストの買い物かごにあるこのアイテムのカタログ識別子のSys_id。データタイプ：文字列
delivery_time	アイテムの配送に要する時間。データタイプ：文字列
item_name	アイテムの名前。データタイプ：文字列
localized_price	現地通貨で表示されたアイテムの価格。データタイプ：文字列
localized_recurring_price	現地通貨で表示された繰り返し発生する料金の価格。データタイプ：文字列
価格	アイテムの価格。データタイプ：文字列
数量	ウィッシュリストのカート内のこのアイテムの番号。データタイプ：文字列
recurring_frequency	日次、月次、年次など、繰り返し発生する料金が適用される頻度。このアイテムに繰り返し発生する料金がない場合は null。データタイプ：文字列
recurring_price	アイテムに関連付けられている繰り返し発生する料金の金額。データタイプ：文字列
variables	アイテムに関連付けられた変数の名前と値のペア。データタイプ: オブジェクト

cURL 要求

curl "http://instance.servicenow.com/api/sn_sc/servicecatalog/wishlist/774906834fbb4200086eeed18110c737" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  "result": {
    "catalog_item_id": "04b7e94b4f7b4200086eeed18110c7fd",
    "variables": {
      "Adobe Photoshop": "",
      "Adobe Acrobat": "",
      "Optional Software": "",
      "Additional software requirements": ""
    },
    "quantity": "1",
    "localized_price": "$1,100.00",
    "price": "$1,100.00",
    "recurring_frequency": "Annually",
    "localized_recurring_price": "$100.00",
    "recurring_price": "$100.00",
    "item_name": "Standard Laptop &",
    "cart_item_id": "d31be364c3012200d68d3b0ac3d3aecf",
    "delivery_time": "5 Days"
  }
}

サービスカタログ - POST /sn_sc/servicecatalog/cart/checkout

2 ステップ精算プロセスが有効かどうかに基づいて、現在の買い物かごの精算を取得して処理します。

ワンステップチェックアウトの場合、このメソッドはカートをチェックアウト (保存) し、要求番号と要求オーダー ID を返します。2 ステップチェックアウトの場合、このメソッドは買い物かごの注文ステータスと、2 ステップチェックアウトに必要なすべての情報を返します。

URL 形式

バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/cart/checkout

デフォルト URL: /api/sn_sc/servicecatalog/cart/checkout

注:

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

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

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

表 : 80. クエリパラメーター
名前	説明
なし

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

ヘッダー

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

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

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

ステータスコード

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

表 : 84. ステータスコード
ステータスコード	説明
200	要求が正常に完了したことを示します。合計と小計の情報、および買い物かご内のアイテムに関する情報を返します。ワンステップチェックアウトの場合、このメソッドはカートをチェックアウト (保存) し、要求番号と要求オーダー ID を返します。2 ステップチェックアウトの場合、このメソッドは買い物かごの注文ステータスと、2 ステップチェックアウトに必要なすべての情報を返します。
400	カートが空でチェックアウトできないことを示します。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
500	内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

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


パラメーター	説明
cart_id	買い物かごのSys_id。データタイプ：文字列
delivery_address	カートアイテムの配送先の住所。データタイプ：文字列
<recurring_frequency>	特定の繰り返し頻度を持つ買い物かご内のアイテムのリスト。可能な値は次のとおりです。日次月次年次なし (定期料金なし) データタイプ: オブジェクト `"<recurring_frequency>": { "frequency_label": "String", "items": [Array], "show_subtotal_price": "String", "subtotal_price": "String", "subtotal_recurring_frequency": "String", "subtotal_recurring_price": "String", "subtotal_title": "String", "total_title": "String" }`
<recurring_frequency>.frequency_label	関連付けられた定期料金の頻度。アイテムに繰り返し発生する料金がない場合、このパラメーターには「null」が含まれます。データタイプ：文字列
<recurring_frequency>.items	指定された繰り返し頻度カテゴリに関連付けられた各アイテムの詳細を含むオブジェクトのアレイ。データタイプ：アレイ "items": [{ "cart_item_id": "String", "catalog_item_id": "String", "created.by": "String", "created_on": "String", "delivery_time": "String", "item_id": "String", "item_name": "String", "localized_price": "String", "localized_recurring_price": "String", "name": "String", "order_guide": "String", "picture": "String", "price": "String", "quantity": "String", "recurring_frequency": "String", "recurring_price": "String", "recurring_subtotal": Number, "recurring_subtotal_price": "String", "short_description": "String", "show_price": Boolean, "show_quantity": Boolean, "show_recurring_price": Boolean, "subtotal": Number, "subtotal_price": "String", "sys_class_name": "String", "sys_id": "String", "updated_by": "String", "updated_on": "String", "variables": {Object} }]
<recurring_frequency>.items.cart_item_id	この買い物かごのアイテムのSys_id。データタイプ：文字列
<recurring_frequency>.items.catalog_item_id	アイテムのカタログsys_id。データタイプ：文字列
<recurring_frequency>.items.created.by	最初にアイテムをカートに入れたユーザー。データタイプ：文字列
<recurring_frequency>.items.created_on	アイテムが最初にカートに入れられた日付。データタイプ：文字列
<recurring_frequency>.items.delivery_time	指定したアイテムが配送されるまでにかかる時間。データタイプ：文字列
<recurring_frequency>.items.item_id	アイテムのSys_id。データタイプ：文字列
<recurring_frequency>.items.item_name	指定されたアイテムの名前。データタイプ：文字列
<recurring_frequency>.items.localized_price	現地通貨でのアイテムの価格。データタイプ：文字列
<recurring_frequency>.items.localized_recurring_price	指定されたアイテムの現地通貨での繰り返し料金。データタイプ：文字列
<recurring_frequency>.items.name	アイテム名。データタイプ：文字列
<recurring_frequency>.items.order_guide	このアイテムが関連付けられている注文ガイドの名前。このアイテムが注文ガイドに関連付けられていない場合、このパラメーターには空の文字列が含まれます。データタイプ：文字列
<recurring_frequency>.items.picture	アイテムの画像のファイル名。データタイプ：文字列
<recurring_frequency>.items.price	アイテムの価格です。データタイプ：文字列
<recurring_frequency>.items.quantity	買い物かご内の指定されたアイテムの番号。データタイプ：文字列
<recurring_frequency>.items.recurring_frequency	指定されたアイテムに対して繰り返し発生する料金が請求される頻度。アイテムに繰り返し発生する料金がない場合、このパラメーターには「null」が含まれます。データタイプ：文字列
<recurring_frequency>.items.recurring_price	指定されたアイテムの繰り返し料金。データタイプ：文字列
<recurring_frequency>.items.recurring_subtotal	アイテムの繰り返し発生する料金の小計 (recurring_price x quantity)。データタイプ：数値
<recurring_frequency>.items.recurring_subtotal_price	アイテムの定期料金の小計。データタイプ：文字列
<recurring_frequency>.items.short_description	アイテムの簡単な説明。データタイプ：文字列
<recurring_frequency>.items.show_price	アイテムの価格がカートに表示されるかどうかを示すフラグ。可能な値： true:買い物かご内のアイテムの価格を表示します。 false:買い物かごにアイテムの価格を表示しません。データタイプ：ブーリアン
<recurring_frequency>.items.show_quantity	カートにアイテム数量を表示するかどうかを示すフラグ。可能な値： true:買い物かご内のアイテム数量を表示します。 false:買い物かごにアイテム数量を表示しません。データタイプ：ブーリアン
<recurring_frequency>.items.show_recurring_price	繰り返し発生する料金をカートに表示するかどうかを示すフラグ。可能な値： true:カートに繰り返し発生する料金を表示します。 false:買い物かごに繰り返し発生する料金を表示しません。データタイプ：ブーリアン
<recurring_frequency>.items.subtotal	アイテムの小計数。データタイプ：数値
<recurring_frequency>.items.subtotal_price	アイテムの小計 (price x quantity)。データタイプ：文字列
<recurring_frequency>.items.sys_class_name	アイテムのシステム分類名。データタイプ：文字列
<recurring_frequency>.items.sys_id	アイテムレコードのSys_id。データタイプ：文字列
<recurring_frequency>.items.updated_by	アイテムが最初にカートに入れられた後に更新したユーザー。データタイプ：文字列
<recurring_frequency>.items.updated_on	アイテムが最初にカートに入れられた、または更新された最後の日時。データタイプ：文字列
<recurring_frequency>.items.variables	アイテム変数の名前と値のペアのリスト。データタイプ: オブジェクト
<recurring_frequency>.show_subtotal_price	関連する定期料金カテゴリの小計を表示するかどうかを示すフラグ。可能な値： true:カートに小計を表示します。 false:カートに小計を表示しません。データタイプ：ブーリアン
<recurring_frequency>.subtotal_price	関連付けられた繰り返し頻度カテゴリのすべてのアイテムのコストの小計。データタイプ：文字列
<recurring_frequency>.subtotal_recurring_frequency	小計の繰り返し頻度のタイプ (日次、月次など)。subtotal_recurring_frequencyと同じです。データタイプ：文字列
<recurring_frequency>.subtotal_recurring_price	関連付けられた繰り返し頻度カテゴリ内のアイテムの繰り返し発生する料金の小計。データタイプ：文字列
<recurring_frequency>.subtotal_title	show_subtotal_priceが `true` に設定されている場合、関連するサブタイトルの買い物かごに表示されるテキスト。データタイプ：文字列
<recurring_frequency>.total_title	関連付けられた繰り返し頻度カテゴリの合計タイトルに表示するテキスト。データタイプ：文字列
requested_for	アイテムが注文されたユーザーのSys_id。データタイプ：文字列
requested_for_user	他のユーザーの代わりにアイテムを要求したユーザー。データタイプ：文字列
show_subtotal_price	買い物かごに小計価格を表示するかどうかを示すフラグ。可能な値： true:カートに小計を表示します。 false:カートに小計を表示しません。データタイプ：文字列
special_instructions	アイテムに関して顧客から与えられた指示。データタイプ：文字列
subtotal_price	カート内のすべてのアイテムの小計 (ドル単位)。データタイプ：文字列
subtotal_recurring_frequency	小計の繰り返し頻度のタイプ (日次、月次など)。<recurring_frequency>.subtotal_recurring_frequencyと同じです。データタイプ：文字列
subtotal_recurring_price	買い物かご内のすべてのアイテムの繰り返し発生頻度料金の小計。データタイプ：文字列
subtotal_title	小計フィールドタイトルのカートに表示するテキスト。データタイプ：文字列
total_title	合計フィールドタイトルについてカートに表示するテキスト。データタイプ：文字列

cURL 要求

curl "https://instance.servicenow.com/api/sn_sc/servicecatalog/cart/checkout" \
--request POST \
--header "Accept:application/json" \
--user "username":"password"

{
  "result": {
    "cart_id": "0830db8413a56300397533e2e144b0ba",
    "subtotal_price": "$1,598.00",
    "subtotal_recurring_frequency": "",
    "delivery_address": "",
    "special_instructions": "",
    "subtotal_recurring_price": "$0.00",
    "total_title": "Total",
    "requested_for_user": "System Administrator",
    "none": {
      "subtotal_price": "$1,598.00",
      "subtotal_recurring_frequency": "",
      "subtotal_recurring_price": "$0.00",
      "total_title": "Total",
      "frequency_label": null,
      "items": [
        {
          "updated_on": "2018-11-06 17:01:21",
          "catalog_item_id": "07f1666b0bf00300eba42da0d5673ab0",
          "short_description": "Apple iPhone 7 ",
          "recurring_subtotal_price": "$0.00",
          "delivery_time": "2 Days",
          "sys_class_name": "sc_cat_item",
          "sys_id": "a846872a1369e300027879d96144b07e",
          "price": "$799.00",
          "recurring_frequency": null,
          "subtotal_price": "$799.00",
          "variables": {},
          "quantity": "1",
          "item_id": "07f1666b0bf00300eba42da0d5673ab0",
          "recurring_price": "$0.00",
          "show_price": true,
          "item_name": "Apple iPhone7",
          "cart_item_id": "a846872a1369e300027879d96144b07e",
          "recurring_subtotal": 0,
          "show_quantity": true,
          "created_by": "admin",
          "picture": "e823ee6b0bf00300eba42da0d5673a95.iix",
          "created_on": "2018-11-06 17:01:21",
          "localized_price": "$799.00",
          "subtotal": 799,
          "show_recurring_price": false,
          "name": "Apple iPhone7",
          "updated_by": "admin",
          "localized_recurring_price": "$0.00",
          "order_guide": ""
        },
        {
          "updated_on": "2018-11-06 17:34:15",
          "catalog_item_id": "07f1666b0bf00300eba42da0d5673ab0",
          "short_description": "Apple iPhone 7 ",
          "recurring_subtotal_price": "$0.00",
          "delivery_time": "2 Days",
          "sys_class_name": "sc_cat_item",
          "sys_id": "7d138fa21329e300027879d96144b065",
          "price": "$799.00",
          "recurring_frequency": null,
          "subtotal_price": "$799.00",
          "variables": {},
          "quantity": "1",
          "item_id": "07f1666b0bf00300eba42da0d5673ab0",
          "recurring_price": "$0.00",
          "show_price": true,
          "item_name": "Apple iPhone7",
          "cart_item_id": "7d138fa21329e300027879d96144b065",
          "recurring_subtotal": 0,
          "show_quantity": true,
          "created_by": "admin",
          "picture": "e823ee6b0bf00300eba42da0d5673a95.iix",
          "created_on": "2018-11-06 16:47:30",
          "localized_price": "$799.00",
          "subtotal": 799,
          "show_recurring_price": false,
          "name": "Apple iPhone7",
          "updated_by": "admin",
          "localized_recurring_price": "$0.00",
          "order_guide": ""
        }
      ],
      "show_subtotal_price": "true",
      "subtotal_title": "Subtotal"
    },
    "requested_for": "6816f79cc0a8016401c5a33be04be441",
    "show_subtotal_price": "true",
    "subtotal_title": "Subtotal"
  }
}

サービスカタログ - POST /sn_sc/servicecatalog/cart/submit_order

現在のチェックアウトタイプ (1 ステップまたは 2 ステップ) に基づいて、ユーザーのカートをチェックアウトします。

ワンステップチェックアウトの場合、このメソッドはカートをチェックアウト (保存) し、要求番号と要求オーダー ID を返します。2 ステップチェックアウトの場合、このメソッドは買い物かごの注文ステータスと、2 ステップチェックアウトに必要なすべての情報を返します。

URL 形式

バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/cart/submit_order

デフォルト URL: /api/sn_sc/servicecatalog/cart/submit_order

注:

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

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

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

表 : 86. クエリパラメーター
名前	説明
なし

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

ヘッダー

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

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

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

ステータスコード

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

表 : 90. ステータスコード
ステータスコード	説明
200	要求が正常に完了し、買い物かごのアイテムが正常にチェックアウトされたことを示します。ワンステップチェックアウトの場合、このメソッドはカートをチェックアウト (保存) し、要求番号と要求オーダー ID を返します。2 ステップチェックアウトの場合、このメソッドは買い物かごの注文ステータスと、2 ステップチェックアウトに必要なすべての情報を返します。
400	ユーザーの買い物かごが空であることを示します。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
500	内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

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


名前	説明
parent_id	利用可能な場合、要求の作成元の親レコードのsys_id。詳細については、「要求の親マッピングの構成」を参照してください。データタイプ：文字列
parent_table	親テーブルの名前。データタイプ：文字列
request_id	生成された注文要求のSys_id。データタイプ：文字列
request_number	生成された要求の数。データタイプ：文字列

cURL 要求

curl "https://instance.servicenow.com /api/sn_sc/v1/servicecatalog/cart/submit_order " \
--request POST \
--header "Accept:application/json" \
--user "username":"password"

{
  "result": {
    "request_number": "REQ0010010",
    "request_id": "f89ed597db21120064301150f0b8f5ff"
  }
}

サービスカタログ - POST /sn_sc/servicecatalog/items/{sys_id}/add_to_cart

指定されたアイテムを現在のユーザーのカートに追加します。

URL 形式

バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/items/{sys_id}/add_to_cart

デフォルト URL: /api/sn_sc/servicecatalog/items/{sys_id}/add_to_cart

注:

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

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

表 : 91. パスパラメーター
名前	説明
api_version	オプション。アクセスするエンドポイントのバージョン。たとえば、 `v1` や `v2` などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列
sys_id	現在の買い物かごに追加するアイテムのSys_id。データタイプ：文字列

表 : 92. クエリパラメーター
名前	説明
なし

表 : 93. 要求本文パラメーター (XML または JSON)
名前	説明
sysparm_also_request_for	指定されたアイテムを注文するユーザー sys_ids他のユーザーのカンマ区切り文字列。アイテムを受け取る追加ユーザーを 50 人を超えるように指定することはできません。リスト内のユーザーがそのアイテムの対象外となる場合、要求全体が却下されます。関連アイテムに requested_for 変数が設定されていない場合、要求は却下されます。関連アイテムに requested_for 変数セットがあるが、[ 追加要求も有効化 ] 変数が設定されていないか、呼び出し元ユーザーに適切なロールがない場合、要求は却下されます。テーブル：ユーザー [sys_user]
sysparm_quantity	必須です。アイテムの数量。負の数にすることはできません。データタイプ：数値
sysparm_requested_for	指定されたアイテムを注文するユーザーのSys_id。データタイプ：文字列テーブル：ユーザー [sys_user]
variables	すべての必須カートアイテム変数の名前と値のペア。必須変数は、関連するフォームで定義されています。データタイプ：文字列

ヘッダー

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

表 : 94. 要求ヘッダー
ヘッダー	説明
なし

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

ステータスコード

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

表 : 96. ステータスコード
ステータスコード	説明
200	成功。要求が正常に処理されました。
400	次のエラーが発生する可能性があります。無効な数量値:sysparm_quantityパラメーターが指定されていないか、無効な値が含まれていることを示します。セキュリティ上の制約により、次のアイテムの順序付けができません: パスパラメーターで指定された買い物かごアイテムsys_idが無効であるか、ユーザーがアイテムへのアクセス権を持っていないことを示します。必須の変数は必須です: 1 つ以上の必須変数が要求で指定されていないことを示します。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
500	内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

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


名前	説明
cart_id	買い物かごsys_id。データタイプ：文字列
アイテム	買い物かご内のすべてのアイテムの詳細。データタイプ：アレイ `"items":[ { "cart_item_id":"String", "catalog_item_id":"String", "item_name":"String", "localized_recurring_price":"String", "localized_price":"String", "price":"String", "quantity":"String", "recurring_frequency":"String", "recurring_price":"String" } ]`
items.cart_item_id	アイテムのSys_id。データタイプ：文字列
items.catalog_item_id	アイテムのカタログsys_id。データタイプ：文字列
items.item_name	アイテムの名前。データタイプ：文字列
items.localized_price	ユーザーの現地通貨でのアイテムの価格。データタイプ：文字列
items.localized_recurring_price	ユーザーの現地通貨でのアイテムの繰り返し発生料金。データタイプ：文字列
items.price	基本価格。データタイプ：文字列
items.quantity	買い物かご内のアイテムの数量。データタイプ：文字列
items.recurring_frequency	繰り返し発生する料金が適用される頻度。データタイプ：文字列
items.recurring_price	反復課金。データタイプ：文字列
小計	買い物かごのアイテムの小計。データタイプ：文字列

サンプル cURL 要求と応答

curl "https://instance.servicenow.com/api/sn_sc/servicecatalog/items/0d08837237153000158bbfc8bcbe5d02/add_to_cart" \
--request POST \
--header "Accept:application/json" \
--data "{ 'sysparm_quantity' : '1',
  'variables' : {
    'acrobat' : 'true'
  }
}" \
--user "username":"password"

{
  "result": {
    "cart_id": "0951c597db21120064301150f0b8f5cf",
    "subtotal": "$1,599.98",
    "items": [
      {
        "catalog_item_id": "0d08837237153000158bbfc8bcbe5d02",
        "quantity": "1",
        "localized_price": "$799.99",
        "price": "$799.99",
        "recurring_frequency": "Monthly",
        "localized_recurring_price": "$30.00",
        "recurring_price": "$29.00",
        "item_name": "Apple iPhone 5",
        "cart_item_id": "ac61c597db21120064301150f0b8f5f9"
      }
    ]
  }
}

サービスカタログ - POST /sn_sc/servicecatalog/items/{sys_id}/add_to_wishlist

指定されたアイテムをウィッシュリストのカートに追加します。

URL 形式

バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/items/{sys_id}/add_to_wishlist

デフォルト URL: /api/sn_sc/ servicecatalog/items/{sys_id}/add_to_wishlist

注:

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

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

表 : 97. パスパラメーター
名前	説明
api_version	オプション。アクセスするエンドポイントのバージョン。たとえば、 `v1` や `v2` などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列
sys_id	ウィッシュリストに追加するアイテムのSys_id。データタイプ：文字列

表 : 98. クエリパラメーター
名前	説明
なし

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

ヘッダー

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

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

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

ステータスコード

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

表 : 102. ステータスコード
ステータスコード	説明
200	成功。要求が正常に処理されました。
400	失敗した要求を示します。要求データが無効であるか、ユーザーがウィッシュリストにアイテムを追加できません。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
500	内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

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


名前	説明
なし

cURL 要求

curl "http://instance.servicenow.com/api/sn_sc/servicecatalog/items/04b7e94b4f7b4200086eeed18110c7fd/add_to_wishlist" \
 --request POST \
 --header "Accept:application/json" \
 --header "Content-Type:application/json" \
 --data "{\"sysparm_quantity\":\"1\"}" \
 --user "username":"password"

{
  "result": {
    "cart_id": "02a559a7c3b02200d68d3b0ac3d3ae5d",
    "items": [
      {
        "catalog_item_id": "04b7e94b4f7b4200086eeed18110c7fd",
        "variables": {
          "Adobe Photoshop": "",
          "Adobe Acrobat": "",
          "Optional Software": "",
          "Additional software requirements": ""
        },
        "quantity": "1",
        "localized_price": "$1,100.00",
        "price": "$1,100.00",
        "recurring_frequency": "Annually",
        "localized_recurring_price": "$100.00",
        "recurring_price": "$100.00",
        "item_name": "Standard Laptop &",
        "cart_item_id": "d31be364c3012200d68d3b0ac3d3aecf",
        "delivery_time": "5 Days"
      }
    ]
  }
}

サービスカタログ - POST /sn_sc/servicecatalog/items/{sys_id}/checkout_guide

チェックアウト用に要求されたコンテンツのアレイを取得します。

URL 形式

バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/items/{sys_id}/checkout_guide

デフォルト URL: /api/sn_sc/servicecatalog/items/{sys_id}/checkout_guide

注:

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

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

表 : 103. パスパラメーター
名前	説明
api_version	オプション。アクセスするエンドポイントのバージョン。たとえば、 `v1` や `v2` などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列
sys_id	情報を返すチェックアウトガイドのSys_id。データタイプ：文字列

表 : 104. クエリパラメーター
名前	説明
なし

表 : 105. 要求本文パラメーター (XML または JSON)
名前	説明
アイテム	チェックアウトが要求されたアイテムを説明するオブジェクトのリスト。データタイプ：アレイ `"items": [{ "sys_id": "String", "sysparm_quantity": "String", "variables": {Object} }]`
items.sys_id	必須です。カタログアイテムのSys_id。データタイプ：文字列
items.sysparm_quantity	アイテムの数。データタイプ：文字列デフォルト値：1
items.variables	アイテムに関連付けられた変数の名前と値のペア。データタイプ: オブジェクトデフォルト:変数なし

ヘッダー

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

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

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

ステータスコード

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

表 : 108. ステータスコード
ステータスコード	説明
200	要求が正常に完了したことを示します。 2 ステップではありません: アイテムがカートに追加され、カートの内容物が返されます。 2 ステップ: チェックアウト後に要求番号と要求sys_idを返します。
400	要求が無効であることを示します。次のいずれかの理由が考えられます。送信された 1 つ以上のアイテムが存在しません。ユーザーには、1 つ以上のアイテムへのアクセス権がありません。 1 つ以上のアイテムの必須変数に回答していません。(必須として定義された変数のみが優先されます)。数量値が送信され、正の整数ではありません。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
500	内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

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

表 : 109. 2 ステップチェックアウトが false の場合に応答本文で返される要素
名前	説明
cart_id	買い物かごのSys_id。データタイプ：文字列
アイテム	買い物かご内のすべてのアイテムの詳細を含むオブジェクトのリスト。データタイプ：アレイ `"items": [{ "cart_item_id": "String", "catalog_item_id": "String", "delivery_time": "String", "item_name": "String", "localized_price": "String", "localized_recurring_price": "String", "price": "String", "quantity": "String", "recurring_frequency": "String", "recurring_price": "String", "variables": {Object} }]`
items.cart_item_id	買い物かご内のアイテムのSys_id。データタイプ：文字列
items.catalog_item_id	買い物かご内のカタログアイテムのSys_id。データタイプ：文字列
items.delivery_time	アイテムの配送に要する時間。データタイプ：文字列
items.item_name	買い物かごのアイテムの名前。データタイプ：文字列
items.localized_price	現地通貨でのアイテムの価格。データタイプ：文字列
items.localized_recurring_price	現地通貨でのアイテムの繰り返し発生料金。データタイプ：文字列
items.price	アイテムの価格です。データタイプ：文字列
items.quantity	買い物かご内のアイテムの番号。データタイプ：文字列
items.recurring_frequency	アイテムの繰り返しの頻度。データタイプ：文字列
items.recurring_price	アイテムの反復課金。データタイプ：文字列
items.variables	買い物かごのアイテムに関連付けられた名前と値のペア。データタイプ: オブジェクト
parent_id	利用可能な場合、要求の作成元の親レコードのsys_id。詳細については、「要求の親マッピングの構成」を参照してください。データタイプ：文字列
parent_table	親テーブルの名前 (大文字と小文字を区別)。データタイプ：文字列
request_number	要求レコード番号。データタイプ：文字列
request_id	要求のSys_id。データタイプ：文字列
subtotal_price	買い物かごの小計。データタイプ：文字列
subtotal_price	現在の頻度ブロックの小計。データタイプ：文字列
subtotal_recurring_frequency	買い物かごの繰り返し頻度の小計。データタイプ：文字列
subtotal_recurring_frequency	現在の頻度ブロックの繰り返し頻度小計。データタイプ：文字列
subtotal_recurring_price	買い物かごの繰り返し発生料金の小計。データタイプ：文字列
subtotal_recurring_price	現在の頻度ブロックの繰り返し発生料金の小計データタイプ：文字列
total_title	ページの合計フィールドのタイトル。データタイプ：文字列
total_title	現在の頻度ブロックの合計フィールドのタイトル。データタイプ：文字列

cURL 要求

curl "https://instance.servicenow.com/api/sn_sc/v1/servicecatalog/items/6690750f4f7b4200086eeed18110c761/checkout_guide" \
--request POST \
--header "Accept:application/json"  \
--header "Content-Type:application/json" \
--data "{\"items\":[{
  \"sys_id\":\"04b7e94b4f7b4200086eeed18110c7fd\",
  \"variables\":{
    \"acrobat\":\"true\",
    \"Additional_software_requirements\":\"MS Office 2007\"
  },
  \"sysparm_quantity\":\"3\"
},
{
  \"sys_id\":\"e1be6dcb4f7b4200086eeed18110c74c\"
},
{
  \"sys_id\":\"186d917a6fab7980575967ddbb3ee4f2\",
  \"variables\":{
    \"new_email\":\"abel.tuter@example.com\"
  }
},
{
  \"sys_id\":\"8b3ae7fedc1be1004ece5c08239e522b\"
},
{
  \"sys_id\":\"962967674ff38200086eeed18110c7e7\",
  \"variables\":{
    \"ergonomic_office\":\"Office chair should have lumbar support\"
  }
}]}" \
--user "username":"password"

<!--Case-1: if two-step is false:-->
{
  "result": {
    "cart_id": "0d8c7a32c3211200d68d3b0ac3d3aeba",
    "subtotal_price": "$3,350.00",
    "subtotal_recurring_frequency": "",
    "subtotal_recurring_price": "$300.00",
    "total_title": "Total",
    "monthly": {
      "subtotal_price": "$50.00",
      "subtotal_recurring_frequency": "Monthly",
      "subtotal_recurring_price": "$0.00",
      "total_title": "Total",
      "items": [
        {
          "catalog_item_id": "90af095bcd38798071a208d710d1b64f",
          "variables": {},
          "quantity": "1",
          "localized_price": "$50.00",
          "price": "$50.00",
          "recurring_frequency": "Monthly",
          "localized_recurring_price": "$0.00",
          "recurring_price": "$0.00",
          "item_name": "Belkin iPad Mini Case",
          "cart_item_id": "cb6e485fc3211200d68d3b0ac3d3ae35",
          "delivery_time": "2 Days"
        }
      ],
      "show_subtotal_price": "true",
      "subtotal_title": "Subtotal"
    },
    "none": {
      "subtotal_price": "-",
      "subtotal_recurring_frequency": "",
      "subtotal_recurring_price": "$0.00",
      "total_title": "Total",
      "items": [
        {
          "catalog_item_id": "186d917a6fab7980575967ddbb3ee4f2",
          "variables": {
            "Preferred Email address": "abel.tuter@example.com"
          },
          "quantity": "1",
          "localized_price": "$0.00",
          "price": "$0.00",
          "recurring_frequency": "",
          "localized_recurring_price": "$0.00",
          "recurring_price": "$0.00",
          "item_name": "New Email Account",
          "cart_item_id": "17c5241fc3211200d68d3b0ac3d3ae7f",
          "delivery_time": "global.Workflow"
        },
        {
          "catalog_item_id": "8b3ae7fedc1be1004ece5c08239e522b",
          "variables": {},
          "quantity": "1",
          "localized_price": "$0.00",
          "price": "$0.00",
          "recurring_frequency": "",
          "localized_recurring_price": "$0.00",
          "recurring_price": "$0.00",
          "item_name": "Corp VPN",
          "cart_item_id": "97c5241fc3211200d68d3b0ac3d3ae7f",
          "delivery_time": "2 Days"
        },
        {
          "catalog_item_id": "e1be6dcb4f7b4200086eeed18110c74c",
          "variables": {},
          "quantity": "1",
          "localized_price": "$0.00",
          "price": "$0.00",
          "recurring_frequency": "",
          "localized_recurring_price": "$0.00",
          "recurring_price": "$0.00",
          "item_name": "External Monitor",
          "cart_item_id": "d3c5241fc3211200d68d3b0ac3d3ae7f",
          "delivery_time": "2 Days"
        },
        {
          "catalog_item_id": "962967674ff38200086eeed18110c7e7",
          "variables": {
            "Please describe any ergonomic requirements\n\t\t": "Office chair should have lumbar support"
          },
          "quantity": "1",
          "localized_price": "$0.00",
          "price": "$0.00",
          "recurring_frequency": "",
          "localized_recurring_price": "$0.00",
          "recurring_price": "$0.00",
          "item_name": "Desk Set Up",
          "cart_item_id": "d7c5241fc3211200d68d3b0ac3d3ae7f",
          "delivery_time": "5 Days"
        }
      ],
      "show_subtotal_price": "false",
      "subtotal_title": "Subtotal"
    },
    "yearly": {
      "subtotal_price": "$3,300.00",
      "subtotal_recurring_frequency": "Annually",
      "subtotal_recurring_price": "$300.00",
      "total_title": "Total",
      "items": [
        {
          "catalog_item_id": "04b7e94b4f7b4200086eeed18110c7fd",
          "variables": {
            "Adobe Photoshop": "",
            "Adobe Acrobat": "true",
            "Optional Software": "",
            "Additional software requirements": "MS Office 2007"
          },
          "quantity": "3",
          "localized_price": "$1,100.00",
          "price": "$1,100.00",
          "recurring_frequency": "Annually",
          "localized_recurring_price": "$100.00",
          "recurring_price": "$100.00",
          "item_name": "Standard Laptop",
          "cart_item_id": "9fc5241fc3211200d68d3b0ac3d3ae7e",
          "delivery_time": "5 Days"
        }
      ],
      "show_subtotal_price": "true",
      "subtotal_title": "Subtotal"
    },
    "show_subtotal_price": "true",
    "subtotal_title": "Subtotal"
  }
}

Case-2: if two-step is true:
{
  "result": {
    "request_number": "REQ0010001",
    "request_id": "82a7e89fc3211200d68d3b0ac3d3ae0a"
  }
}

サービスカタログ - POST /sn_sc/servicecatalog/items/{item_sys_id}/get_invalid_delegated_users

指定されたアイテムの要求を委任できない (別のユーザーによって要求された) ユーザーのリストを返します。

他のユーザーの代わりにサービスカタログアイテムを要求できるようにする、サービスカタログ API - POST /sn_sc/servicecatalog/items/{sys_id}/add_to_cart やサービスカタログ API - POST /sn_sc/servicecatalog/items/{sys_id}/order_now などのエンドポイントを呼び出す前に、このエンドポイントを呼び出すことができます。これらの呼び出しは、関連付けられたアイテムに対して許可されていないユーザーを渡した場合に失敗します。このエンドポイントを使用すると、アイテムを注文したり、アイテムをカートに追加しようとするエンドポイントを呼び出したりする前に、ユーザーのリストを確認できます。

URL 形式

バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/items/{item_sys_id}/get_invalid_delegated_users

デフォルト URL: /api/sn_sc/servicecatalog/items/{item_sys_id}/get_invalid_delegated_users

注:

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

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

表 : 110. パスパラメーター
名前	説明
api_version	オプション。アクセスするエンドポイントのバージョン。たとえば、 `v1` や `v2` などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列
item_sys_id	指定されたユーザーが権利取得を持っているかどうかを確認するためのサービスカタログアイテムのSys_id。データタイプ：文字列テーブル:サービスカタログ [sc_catalog]

表 : 111. クエリパラメーター
名前	説明
なし

表 : 112. 要求本文パラメーター (XML または JSON)
名前	説明
sysparm_also_request_for	有効なユーザー sys_idsのカンマ区切り文字列。エンドポイントは、これらのユーザーが指定されたサービスカタログアイテムに対する取得権限を持っていることを確認します。データタイプ：文字列テーブル:ユーザー [sys_users]

ヘッダー

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

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

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

ステータスコード

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

表 : 115. ステータスコード
ステータスコード	説明
200	成功。要求が正常に処理されました。
400	要求に失敗しました。処理の要求が正しくありません。エラーの詳細については、返される結果のメッセージを参照してください。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
500	内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

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


名前	説明
エラーコード	エラーに関連付けられた番号。エンドポイントが失敗した場合にのみ返されます。データタイプ：文字列
errMsg	エンドポイントが失敗したときに発生したエラーの説明。
無効なユーザー	指定されたカタログアイテムを要求できないユーザーの名前。データタイプ：アレイ

cURL 要求

curl "https://instance.servicenow.com/api/sn_sc/servicecatalog/items/04b7e94b4f7b4200086eeed18110c7fd/get_invalid_delegated_users" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{\"sysparm_also_request_for\":\"a8f98bb0eb32010045e1a5115206fe3a,62826bf03710200044e0bfc8bcbe5df1\"}" \
--user "username":"password"

{
  "result": {
    "invalidUsers": [
      "Abel Tuter"
    ]
  }
}

cURL 要求

curl "https://instance.servicenow.com /api/sn_sc/servicecatalog/items/04b7e94b4f7b4200086eeed18110c7fd/get_invalid_delegated_users" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{\"sysparm_also_request_for\":\"a8f98bb0eb32010045e1a5115206fe3a,62826bf03710200044e0bfc8bcbe5df1\"}" \
--user "username":"password"

{
  "result": {
    "errCode": "42202",
    "errMsg": "This item cannot be submitted for multiple people as it is not configured with Requested For"
  }
}

サービスカタログ - POST /sn_sc/servicecatalog/items/{sys_id}/order_now

指定されたカタログアイテムを注文します。

URL 形式

バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/items/{sys_id}/order_now

デフォルト URL: /api/sn_sc/servicecatalog/items/{sys_id}/order_now

注:

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

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

表 : 116. パスパラメーター
名前	説明
api_version	オプション。アクセスするエンドポイントのバージョン。たとえば、 `v1` や `v2` などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列
sys_id	サービスカタログアイテムのSys_id。データタイプ：文字列テーブル:カタログアイテム [sc_cat_item]

表 : 117. クエリパラメーター
名前	説明
なし

表 : 118. 要求本文パラメーター (XML または JSON)
名前	説明
sysparm_also_request_for	指定されたアイテムを注文するユーザー sys_ids他のユーザーのカンマ区切り文字列。アイテムを受け取る追加ユーザーを 50 人を超えるように指定することはできません。リスト内のユーザーがそのアイテムの対象外となる場合、要求全体が却下されます。関連アイテムに requested_for 変数が設定されていない場合、要求は却下されます。関連アイテムに requested_for 変数セットがあるが、[ 追加要求も有効化 ] 変数が設定されていないか、呼び出し元ユーザーに適切なロールがない場合、要求は却下されます。テーブル：ユーザー [sys_user]
sysparm_quantity	必須です。アイテムの数量。負の数にすることはできません。データタイプ：数値
sysparm_requested_for	指定されたアイテムを注文するユーザーのSys_id。 glide.sc.req_for.rolesプロパティとglide.sc.req_for.roles.defaultプロパティの設定によって、ユーザーがアイテムを要求できるレベルが決まります。 glide.sc.req_for.rolesプロパティに値が指定されている場合、システムは、ユーザーが他のユーザーの情報を要求するために指定されたロールを持っているかどうかを確認します。 glide.sc.req_for.rolesプロパティ値が空で、glide.sc.req_for.roles.defaultプロパティ値が `deny` の場合、ユーザーは他のユーザーのアイテムを要求できません。 glide.sc.req_for.rolesプロパティ値が空で、glide.sc.req_for.roles.defaultプロパティ値が `allow` の場合、どのユーザーも他のユーザーのアイテムを要求できます。データタイプ：文字列
variables	すべての必須カートアイテム変数の名前と値のペア。必須変数は、関連するフォームで定義されています。データタイプ：文字列

ヘッダー

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

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

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

ステータスコード

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

表 : 121. ステータスコード
ステータスコード	説明
200	成功。要求が正常に処理されました。
400	数量値が無効であり、要求が行われていないことを示します。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
500	内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

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


名前	説明
number	生成された要求の番号。データタイプ：文字列
parent_id	利用可能な場合、要求の作成元の親レコードのsys_id。詳細については、「要求の親マッピングの構成」を参照してください。データタイプ：文字列
parent_table	利用可能な場合、要求の作成元の親テーブルの名前。データタイプ：文字列
request_id	注文要求のSys_id。データタイプ：文字列
request_number	要求番号。データタイプ：文字列
sys_id	注文のSys_id。データタイプ：文字列
table	要求のテーブル名。データタイプ：文字列

cURL 要求のサンプル

curl "https://instance.servicenow.com/api/sn_sc/servicecatalog/items/d82ea08510247200964f77ffeec6c4ee/order_now" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
  sysparm_quantity: 1,
  variables: {
    replacement: 'Yes',
    originalnumber: '1640000',
    data_plan: '500MB'
  }
}" \
--user "username":"password"

{
  "result": {
    "sys_id": "cf56a3fcdb3a2300e890f71fbf9619ac",
    "number": "REQ0010012",
    "request_number": "REQ0010012",
    "request_id": "cf56a3fcdb3a2300e890f71fbf9619ac",
    "table": "sc_request"
  }
}

サービスカタログ - POST /sn_sc/servicecatalog/items/{sys_id}/submit_producer

レコードを作成し、作成されたレコードにアクセスするためのテーブル API の相対パスとリダイレクト URL を返します。

URL 形式

バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/items/{sys_id}/submit_producer

デフォルト URL: /api/sn_sc/servicecatalog/items/{sys_id}/submit_producer

注:

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

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

表 : 122. パスパラメーター
名前	説明
api_version	オプション。アクセスするエンドポイントのバージョン。たとえば、 `v1` や `v2` などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列
sys_id	レコードプロデューサーを作成するテーブルのSys_id。データタイプ：文字列

表 : 123. クエリパラメーター
名前	説明
sysparm_view	データをレンダリングする UI ビュー。応答で返されるフィールドを決定します。有効な値：デスクトップ mobile both sysparm_fields パラメーターも指定する場合は、それが優先されます。データタイプ：文字列

表 : 124. 要求本文パラメーター (XML または JSON)
名前	説明
variables	定義するプロデューサーレコードの変数の名前と値のペア。

ヘッダー

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

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

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

ステータスコード

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

表 : 127. ステータスコード
ステータスコード	説明
200	要求が成功したことを示し、作成されたレコードにアクセスするためのテーブル API と URL で構成される応答オブジェクトを返します。
400	要求メッセージが正しくないため、要求は処理されません。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
404	要求されたリソースが見つかりません。
500	内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

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


名前	説明
number	レコードプロデューサーに関連付けられているチケットの番号。データタイプ：文字列
parent_id	利用可能な場合、要求の作成元の親レコードのsys_id。詳細については、「要求の親マッピングの構成」を参照してください。データタイプ：文字列
parent_table	親テーブルの名前。データタイプ：文字列
レコード	新しく作成されたレコードプロデューサーのテーブル API 相対パス。データタイプ：文字列
redirect_portal_url	サービスポータルのリダイレクト先の URL。データタイプ：文字列
redirect_to	リダイレクト値。データタイプ：文字列
redirect_url	作成されたレコードプロデューサーにアクセスするためのリダイレクト URL。データタイプ：文字列
sys_id	作成されたレコードのSys_id。データタイプ：文字列
table	要求が行われたテーブルの名前。データタイプ：文字列

cURL 要求

curl "https://instance.servicenow.com/api/sn_sc/servicecatalog/items/3f1dd0320a0a0b99000a53f7604a2ef9/submit_producer" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{'variables':{'urgency':'2','comments':'This is sample incident'}}" \
--user "username":"password"

{
  "result": {
    "sys_id": "6baf4e1ddbba2300e890f71fbf961963",
    "number": "INC0010006",
    "parent_id": null,
    "record": "api/now/table/incident/6baf4e1ddbba2300e890f71fbf961963",
    "redirect_portal_url": "",
    "parent_table": "task",
    "redirect_url": "incident.do?sys_id=6baf4e1ddbba2300e890f71fbf961963&sysparm_view=ess",
    "table": "incident",
    "redirect_to": ""
  }
}

サービスカタログ - POST /sn/sc/servicecatalog/variables/{sys_id}/display_value

指定された変数の表示値を返します。

URL 形式

バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/variables/{sys_id}/display_value

デフォルト URL: /api/sn_sc/servicecatalog/variables/{sys_id}/display_value

注:

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

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

表 : 128. パスパラメーター
名前	説明
api_version	オプション。アクセスするエンドポイントのバージョン。たとえば、 `v1` や `v2` などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列
sys_id	表示値を返す変数のSys_id。データタイプ：文字列

表 : 129. クエリパラメーター
名前	説明
なし

表 : 130. 要求本文パラメーター (XML または JSON)
名前	説明
sysparm_value	返す表示値を含むレコードのSys_id。データタイプ：文字列

ヘッダー

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

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

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

ステータスコード

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

表 : 133. ステータスコード
ステータスコード	説明
200	成功。要求が正常に処理されました。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
404	見つかりません。要求されたアイテムが見つかりませんでした。
500	内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

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


名前	説明
result	変数の表示値。データタイプ：文字列

cURL 要求


 curl "https://instance.servicenow.com/api/sn_sc/servicecatalog/variables/2a3947a10a0a020e007f12648f8790c0/display_value" \ 
--request POST \ 
--header "Accept:application/json" \ 
--header "Content-Type:application/json" \ 
--data "{\"sysparm_value\":\"62826bf03710200044e0bfc8bcbe5df1\"}" \ 
--user "username":"password"

{
  "result": "Abel Tuter (Architect)"
}

サービスカタログ - PUT /sn_sc/servicecatalog/cart/{cart_item_id}

ログインしているユーザーのカート内の指定されたアイテムを更新します。

URL 形式

バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/cart/{cart_item_id}

デフォルト URL: /api/sn_sc/servicecatalog/cart/{cart_item_id}

注:

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

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

表 : 134. パスパラメーター
名前	説明
api_version	オプション。アクセスするエンドポイントのバージョン。たとえば、 `v1` や `v2` などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列
cart_item_id	更新する買い物かごアイテムのSys_id。データタイプ：文字列

表 : 135. クエリパラメーター
名前	説明
なし

表 : 136. 要求本文パラメーター (XML または JSON)
名前	説明
sysparm_quantity	必須です。買い物かごを更新するアイテムの数量。データタイプ：文字列
variables	アイテムに必須の変数が指定されている場合は必須です。すべての必須変数の名前と値のペアで構成されるオブジェクト。データタイプ: オブジェクト

ヘッダー

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

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

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

ステータスコード

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

表 : 139. ステータスコード
ステータスコード	説明
201	要求が正常に完了し、アイテムがカートに追加されたことを示します。
400	次の 3 つのエラーが発生する可能性があります。無効な数量値:sysparm_quantityパラメーターが指定されていないか、無効な値が含まれていることを示します。セキュリティ上の制約により、次のアイテムの順序付けができません:パスパラメーターで指定されたアイテム ID が無効であるか、ユーザーがアイテムへのアクセス権を持っていないことを示します。必須の変数は必須です:1 つ以上の必須変数値が要求で指定されていないことを示します。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
500	内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。

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


名前	説明
cart_id	買い物かごのSys_id。データタイプ：文字列
<recurring_frequency>	特定の繰り返し頻度を持つ買い物かご内のアイテムについて説明します。可能な値は次のとおりです。日次月次年次なし (定期料金なし) データタイプ: オブジェクト `"<recurring_frequency>": { "frequency_label": "String", "items": [Array], "show_subtotal_price": "String", "subtotal_price": "String", "subtotal_recurring_frequency": "String", "subtotal_recurring_price": "String", "subtotal_title": "String", "total_title": "String" }`
<recurring_frequency>.frequency_label	関連付けられた定期料金の頻度。アイテムに繰り返し発生する料金がない場合、このパラメーターには「null」が含まれます。データタイプ：文字列
<recurring_frequency>.items	指定された繰り返し頻度カテゴリに関連付けられた各アイテムを説明するオブジェクトのリスト。データタイプ：アレイ "items": [{ "cart_item_id": "String", "catalog_item_id": "String", "created.by": "String", "created_on": "String", "delivery_time": "String", "item_id": "String", "item_name": "String", "localized_price": "String", "localized_recurring_price": "String", "name": "String", "order_guide": "String", "picture": "String", "price": "String", "quantity": "String", "recurring_frequency": "String", "recurring_price": "String", "recurring_subtotal": Number, "recurring_subtotal_price": "String", "short_description": "String", "show_price": Boolean, "show_quantity": Boolean, "show_recurring_price": Boolean, "subtotal": Number, "subtotal_price": "String", "sys_class_name": "String", "sys_id": "String", "updated_by": "String", "updated_on": "String", "variables": {Object} }]
<recurring_frequency>.items.cart_item_id	この買い物かごのアイテムのSys_id。データタイプ：文字列
<recurring_frequency>.items.catalog_item_id	アイテムのカタログsys_id。データタイプ：文字列
<recurring_frequency>.items.created.by	最初にアイテムをカートに入れたユーザー。データタイプ：文字列
<recurring_frequency>.items.created_on	アイテムが最初にカートに入れられた日付。データタイプ：文字列
<recurring_frequency>.items.delivery_time	指定したアイテムが配送されるまでにかかる時間。データタイプ：文字列
<recurring_frequency>.items.item_id	アイテムsys_id。データタイプ：文字列
<recurring_frequency>.items.item_name	指定されたアイテムの名前。データタイプ：文字列
<recurring_frequency>.items.localized_price	アイテムの価格 (現地通貨)。データタイプ：文字列
<recurring_frequency>.items.localized_recurring_price	指定されたアイテムの繰り返し料金 (現地通貨)。データタイプ：文字列
<recurring_frequency>.items.name	アイテム名。データタイプ：文字列
<recurring_frequency>.items.order_guide	このアイテムが関連付けられている注文ガイドの名前。このアイテムが注文ガイドに関連付けられていない場合、このパラメーターには空の文字列が含まれます。データタイプ：文字列
<recurring_frequency>.items.picture	アイテムの画像のファイル名。データタイプ：文字列
<recurring_frequency>.items.price	アイテムの価格です。データタイプ：文字列
<recurring_frequency>.items.quantity	買い物かご内の指定されたアイテムの番号。データタイプ：文字列
<recurring_frequency>.items.recurring_frequency	指定されたアイテムに対して繰り返し発生する料金が請求される頻度。データタイプ：文字列デフォルト：Null
<recurring_frequency>.items.recurring_price	指定されたアイテムの繰り返し料金。データタイプ：文字列
<recurring_frequency>.items.recurring_subtotal	アイテムの繰り返し発生する料金の小計 (recurring_price x quantity)。データタイプ：数値
<recurring_frequency>.items.recurring_subtotal_price	アイテムの定期料金の小計。データタイプ：文字列
<recurring_frequency>.items.short_description	アイテムの簡単な説明。データタイプ：文字列
<recurring_frequency>.items.show_price	アイテムの価格がカートに表示されるかどうかを示すフラグ。可能な値： true:買い物かご内のアイテムの価格を表示します。 false:買い物かごにアイテムの価格を表示しません。データタイプ：ブーリアン
<recurring_frequency>.items.show.quantity	カートにアイテム数量を表示するかどうかを示すフラグ。可能な値： true:買い物かご内のアイテム数量を表示します。 false:買い物かごにアイテム数量を表示しません。データタイプ：ブーリアン
<recurring_frequency>.items.show_recurring_price	繰り返し発生する料金をカートに表示するかどうかを示すフラグ。可能な値： true:カートに繰り返し発生する料金を表示します。 false:買い物かごに繰り返し発生する料金を表示しません。データタイプ：ブーリアン
<recurring_frequency>.items.subtotal	アイテム数の小計。データタイプ：数値
<recurring_frequency>.items.subtotal_price	アイテムの小計 (price x quantity)。データタイプ：文字列
<recurring_frequency>.items.sys_class_name	アイテムのシステム分類名。データタイプ：文字列
<recurring_frequency>.items.sys_id	アイテムのSys_id。データタイプ：文字列
<recurring_frequency>.items.updated_by	アイテムが最初にカートに入れられた後に更新したユーザー。データタイプ：文字列
<recurring_frequency>.items.updated_on	アイテムが最初にカートに入れられた、または更新された最後の日時。データタイプ：文字列
<recurring_frequency>.items.variables	アイテム変数の名前と値のペア。データタイプ: オブジェクト
<recurring_frequency>.show_subtotal_price	関連する定期料金カテゴリの小計を表示するかどうかを示すフラグ。データタイプ：文字列
<recurring_frequency>.subtotal_price	関連付けられた繰り返し頻度カテゴリのすべてのアイテムのコストの小計。データタイプ：文字列
<recurring_frequency>.subtotal_recurring_frequency	小計の繰り返し頻度のタイプ (日次、月次など)。データタイプ：文字列
<recurring_frequency>.subtotal_recurring_price	関連付けられた繰り返し頻度カテゴリ内のアイテムの繰り返し発生する料金の小計。データタイプ：文字列
<recurring_frequency>.subtotal_title	show_subtotal_priceが `true` に設定されている場合、関連するサブタイトルの買い物かごに表示されるテキスト。データタイプ：文字列
<recurring_frequency>.total_title	関連付けられた繰り返し頻度カテゴリの合計タイトルに表示するテキスト。データタイプ：文字列
show_subtotal_price	買い物かごに小計価格を表示するかどうかを示すフラグ。可能な値： true:カートに小計を表示します。 false:カートに小計を表示しません。データタイプ：文字列
subtotal_price	買い物かご内のすべてのアイテムの小計。データタイプ：文字列
subtotal_recurring_frequency	小計の繰り返し頻度のタイプ (日次、月次など)。<recurring_frequency>.subtotal_recurring_frequencyと同じです。データタイプ：文字列
subtotal_recurring_price	買い物かご内のすべてのアイテムの繰り返し発生頻度料金の小計。データタイプ：文字列
subtotal_title	小計フィールドタイトルのカートに表示するテキスト。データタイプ：文字列
total_title	合計フィールドタイトルについてカートに表示するテキスト。データタイプ：文字列

cURL 要求

curl "https://instance.servicenow.com/api/sn_sc/v1/servicecatalog/cart/7d138fa21329e300027879d96144b065" \
--request PUT \
--header "Accept:application/json" \
--data "{\"sysparm_quantity\": \"2\" }" \
--user "username":"password"

{
  "result": {
    "cart_id": "0830db8413a56300397533e2e144b0ba",
    "subtotal_price": "$2,397.00",
    "subtotal_recurring_frequency": "",
    "subtotal_recurring_price": "$0.00",
    "total_title": "Total",
    "none": {
      "subtotal_price": "$2,397.00",
      "subtotal_recurring_frequency": "",
      "subtotal_recurring_price": "$0.00",
      "total_title": "Total",
      "frequency_label": null,
      "items": [
        {
          "updated_on": "2018-11-06 17:01:21",
          "catalog_item_id": "07f1666b0bf00300eba42da0d5673ab0",
          "short_description": "Apple iPhone 7 ",
          "recurring_subtotal_price": "$0.00",
          "delivery_time": "2 Days",
          "sys_class_name": "sc_cat_item",
          "sys_id": "a846872a1369e300027879d96144b07e",
          "price": "$799.00",
          "recurring_frequency": null,
          "subtotal_price": "$799.00",
          "variables": {},
          "quantity": "1",
          "item_id": "07f1666b0bf00300eba42da0d5673ab0",
          "recurring_price": "$0.00",
          "show_price": true,
          "item_name": "Apple iPhone7",
          "cart_item_id": "a846872a1369e300027879d96144b07e",
          "recurring_subtotal": 0,
          "show_quantity": true,
          "created_by": "admin",
          "picture": "e823ee6b0bf00300eba42da0d5673a95.iix",
          "created_on": "2018-11-06 17:01:21",
          "localized_price": "$799.00",
          "subtotal": 799,
          "show_recurring_price": false,
          "name": "Apple iPhone7",
          "updated_by": "admin",
          "localized_recurring_price": "$0.00",
          "order_guide": ""
        },
        {
          "updated_on": "2018-11-06 17:21:08",
          "catalog_item_id": "07f1666b0bf00300eba42da0d5673ab0",
          "short_description": "Apple iPhone 7 ",
          "recurring_subtotal_price": "$0.00",
          "delivery_time": "2 Days",
          "sys_class_name": "sc_cat_item",
          "sys_id": "7d138fa21329e300027879d96144b065",
          "price": "$799.00",
          "recurring_frequency": null,
          "subtotal_price": "$1,598.00",
          "variables": {},
          "quantity": "2",
          "item_id": "07f1666b0bf00300eba42da0d5673ab0",
          "recurring_price": "$0.00",
          "show_price": true,
          "item_name": "Apple iPhone7",
          "cart_item_id": "7d138fa21329e300027879d96144b065",
          "recurring_subtotal": 0,
          "show_quantity": true,
          "created_by": "admin",
          "picture": "e823ee6b0bf00300eba42da0d5673a95.iix",
          "created_on": "2018-11-06 16:47:30",
          "localized_price": "$799.00",
          "subtotal": 1598,
          "show_recurring_price": false,
          "name": "Apple iPhone7",
          "updated_by": "admin",
          "localized_recurring_price": "$0.00",
          "order_guide": ""
        }
      ],
      "show_subtotal_price": "true",
      "subtotal_title": "Subtotal"
    },
    "show_subtotal_price": "true",
    "subtotal_title": "Subtotal"
  }
}

サービスカタログ - PUT /sn_sc/servicecatalog/items/{sys_id}/submit_guide

注文ガイドに記載されているニーズに基づいて、アイテムのリストを取得します。

URL 形式

バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/items/{sys_id}/submit_guide

デフォルト URL: /api/sn_sc/servicecatalog/items/{sys_id}/submit_guide

注:

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

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

表 : 140. パスパラメーター
名前	説明
api_version	オプション。アクセスするエンドポイントのバージョン。たとえば、 `v1` や `v2` などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列
sys_id	アイテムを取得する注文ガイドのSys_id。データタイプ：文字列テーブル:注文ガイド [sc_cat_item_guide]

表 : 141. クエリパラメーター
名前	説明
なし

表 : 142. 要求本文パラメーター (XML または JSON)
名前	説明
variables	アイテムに対して要求された変数。各変数は、名前と値のペアで構成される JSON オブジェクトです。データタイプ：アレイ

ヘッダー

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

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

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

ステータスコード

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

表 : 145. ステータスコード
ステータスコード	説明
200	要求が正常に完了したことを示します。渡された変数リストに基づいてアイテムのリストを返します。結果セットにアイテムが含まれていない場合は、空の配列が返されます。
400	要求が無効であることを示します。次のいずれかの理由が考えられます。ユーザーにはアイテムへのアクセス権がありません。 1 つ以上のアイテムの必須変数に回答していません。(必須として定義された変数のみが優先されます)。
401	権限がありません。ユーザー認証情報が正しくないか、渡されていません。
500	選択したオプションに応じて、アイテムの計算中に内部エラーが発生しました。

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


名前	説明
catalogs	アイテムが属するオブジェクトのリストと、カタログの各カタログタイトルとsys_id。データタイプ：オブジェクトのアレイ `"catalogs": [ { "sys_id": "String", "title": "String" } ]`
catalogs.sys_id	カタログのSys_id。データタイプ：文字列
catalogs.title	カタログタイトル。データタイプ：文字列
category	このアイテムを含むカテゴリ。データタイプ: オブジェクト `"catalogs": { "sys_id": "String", "title": "String" }`
category.sys_id	カテゴリの sys_id。データタイプ：文字列
category.title	カテゴリのタイトル。データタイプ：文字列
client_script	カタログアイテムで定義されているすべてのカタログクライアントスクリプトのリスト。データタイプ: オブジェクト `"client_script": { "onChange": [Array], "onLoad": [Array], "onSubmit": [Array] }`
client_script.onChange	アイテムに関連付けられた onChange クライアントスクリプトのリスト。データタイプ：アレイ
client_script.onLoad	アイテムに関連付けられた onLoad クライアントスクリプトのリスト。データタイプ：アレイ
client_script.onSubmit	アイテムに関連付けられた onSubmit クライアントスクリプトのリスト。データタイプ：アレイ
data_lookup	カタログアイテムで定義されたデータルックアップ。データタイプ：アレイ
description	カタログアイテムの完全な説明。データタイプ：文字列
icon	カタログアイテムの横にアイコンとして表示される画像のパス。データタイプ：文字列
name	カタログアイテムの名前。データタイプ：文字列
short_description	サービスカタログホームページまたは検索結果ページのテキスト、またはカタログアイテムの注文フォームのタイトル。データタイプ：文字列
show_price	価格の詳細を表示するかどうかを示すフラグ。true の場合、次の詳細が返されます。 local_currency localized_price localized_recurring_price 価格 price_currency recurring_frequency recurring_price recurring_price_currency データタイプ：ブーリアン
sys_id	カタログアイテムのSys_id。データタイプ：文字列
type	アイテムタイプ。可能な値：カタログアイテム注文ガイドレコードプロデューサーアイテムデータタイプ：文字列
variables	カタログアイテムに関連付けられているすべての変数の名前と値のペア。データタイプ：アレイ
ui_policy	カタログアイテムで定義されているすべてのカタログ UI ポリシーのリスト。データタイプ：アレイ

cURL 要求

curl "https://instance.servicenow.com/api/sn_sc/v1/servicecatalog/items/6690750f4f7b4200086eeed18110c761/submit_guide" \
--request PUT \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
  \"variables\":{
    \"hiring_manager\":\"6816f79cc0a8016401c5a33be04be441\",
    \"hiring_group\":\"221f3db5c6112284009f4becd3039cc9\",
    \"remote\":\"No\",
    \"standard_package\":\"No\",
    \"laptop_type\":\"developer\"
  }
}" \
--user "username":"password"

{
  "result": [
    {
      "short_description": "Lenovo - Carbon x1",
      "icon": "1195c2084f889200086eeed18110c74a.iix",
      "description": "<p class=\"p1\"><font size=\"3\" color=\"#808080\"><span class=\"s1\">x1 Carbon</span></font></p>\n<p class=\"p1\"><font size=\"2\" color=\"#808080\" face=\"arial,helvetica,sans-serif\"><span class=\"s1\">The x1 Carbon is Lenovo's lightest ThinkPad yet. It provides a QHD display that fights glare and weighs less than three pounds. Ideal for most computing tasks, and highly mobile. </span></font></p>\n<p class=\"p2\"><font size=\"2\" color=\"#808080\" face=\"arial,helvetica,sans-serif\"><span class=\"s1\">Technical Specs:</span></font></p>\n<ul class=\"ul1\"><li class=\"li3\"><font size=\"2\" color=\"#808080\"><span class=\"s1\">Intel core i5 processor</span></font></li><li class=\"li3\"><font size=\"2\" color=\"#808080\"><span class=\"s1\">512GB solid state drive (SSD) </span></font></li><li class=\"li3\"><font size=\"2\" color=\"#808080\"><span class=\"s1\">Backlit keyboard</span></font></li></ul>",
      "show_price": true,
      "recurring_price": "$100.00",
      "type": "catalog_item",
      "local_currency": "USD",
      "sys_id": "04b7e94b4f7b4200086eeed18110c7fd",
      "recurring_price_currency": "USD",
      "localized_price": "$1,100.00",
      "price": "$1,100.00",
      "catalogs": [
       {
         "sys_id": "e0d08b13c3330100c8b837659bba8fb4",
         "title": "Service Catalog"
       }
      ],
      "recurring_frequency": "Annually",
      "name": "Standard Laptop",
      "localized_recurring_price": "$100.00",
      "category": {
        "sys_id": "d258b953c611227a0146101fb1be7c31",
        "title": "Hardware"
      },
      "price_currency": "USD",
      "show_quantity": false,
      "quantity": "1",
      "order": "100",
      "variables": [
        {
          "label": "Optional Software",
          "type": 0,
          "mandatory": false,
          "displayvalue": "",
          "friendly_type": "container_start",
          "render_label": true,
          "read_only": false,
          "children": [
            {
              "label": "Adobe Acrobat",
              "type": 7,
              "mandatory": false,
              "displayvalue": "false",
              "friendly_type": "check_box",
              "display_type": "CheckBox",
              "render_label": true,
              "read_only": false,
              "pricing_implications": false,
              "name": "acrobat",
              "attributes": "edge_encryption_enabled=true",
              "id": "90b72d4b4f7b4200086eeed18110c701",
              "value": false,
              "help_text": "",
              "max_length": 0
            },
            {
              "label": "Adobe Photoshop",
              "type": 7,
              "mandatory": false,
              "displayvalue": "false",
              "friendly_type": "check_box",
              "display_type": "CheckBox",
              "render_label": true,
              "read_only": false,
              "pricing_implications": false,
              "name": "photoshop",
              "attributes": "edge_encryption_enabled=true",
              "id": "a8b72d4b4f7b4200086eeed18110c701",
              "value": false,
              "help_text": "",
              "max_length": 0
            }
          ],
          "name": "optional_label",
          "attributes": "edge_encryption_enabled=true",
          "id": "10b72d4b4f7b4200086eeed18110c700",
          "value": "",
          "help_text": "",
          "max_length": 0
        },
        {
          "label": "Additional software requirements",
          "type": 2,
          "mandatory": false,
          "displayvalue": "",
          "friendly_type": "multi_line_text",
          "display_type": "Multi Line Text",
          "render_label": true,
          "read_only": false,
          "name": "Additional_software_requirements",
          "attributes": "edge_encryption_enabled=true",
          "id": "a8b72d4b4f7b4200086eeed18110c702",
          "value": "",
          "help_text": "",
          "max_length": 0
        }
      ],
      "ui_policy": [],
      "client_script": {
        "onChange": [],
        "onSubmit": [],
        "onLoad": []
      },
      "data_lookup": []
    },
    {
      "sys_id": "e1be6dcb4f7b4200086eeed18110c74c",
      "short_description": "LG IPS 27\" Monitor",
      "catalogs": [
        {
          "sys_id": "e0d08b13c3330100c8b837659bba8fb4",
          "title": "Service Catalog"
        }
      ],
      "name": "External Monitor",
      "icon": "08569a4c4f889200086eeed18110c77b.iix",
      "description": "<p><font size=\"2\"><span style=\"color: #485563;\"><br /> <font size=\"3\" color=\"#808080\">The striking design of the LG Cinema Screen incorporates an ultra-narrow bezel, so virtually all you see is picture. The viewing experience is more immersive for your favorite movies and games. Make the most of your time, with an LG Full HD LED monitor. </font></span></font></p>\n<p><font size=\"2\" color=\"#808080\">Item Specs:</font></p>\n<ul><li style=\"color: #485563;\"><font size=\"2\" color=\"#808080\">Screen Size: 27"</font></li><li style=\"color: #485563;\"><font size=\"2\" color=\"#808080\">Resolution: 1920 x 1080</font></li><li style=\"color: #485563;\"><font size=\"2\" color=\"#808080\">Aspect Ratio: 16:9</font></li><li style=\"color: #485563;\"><font size=\"2\" color=\"#808080\">Brightness: 250 cd/m2</font></li><li style=\"color: #485563;\"><font size=\"2\" color=\"#808080\">Supports Split Screen</font></li></ul>",
      "show_price": false,
      "type": "catalog_item",
      "category": {
        "sys_id": "2c0b59874f7b4200086eeed18110c71f",
        "title": "Peripherals"
      },
      "show_quantity": false,
      "quantity": "1",
      "order": "200",
      "variables": [],
      "ui_policy": [],
      "client_script": {
        "onChange": [],
        "onSubmit": [],
        "onLoad": []
      },
      "data_lookup": []
    },
    {
      "sys_id": "186d917a6fab7980575967ddbb3ee4f2",
      "short_description": "New Email Creation",
      "catalogs": [
        {
          "sys_id": "e0d08b13c3330100c8b837659bba8fb4",
          "title": "Service Catalog"
        }
      ],
      "name": "New Email Account",
      "icon": "b630e97e6fab7980575967ddbb3ee4d2.iix",
      "description": "<p style=\"font-size: 13px;\"><font size=\"4\"><span style=\"color: #485563;\">Service Overview:</span></font></p>\n\t<p style=\"font-size: 13px;\"><font size=\"3\">Creation of a new email account within our Microsoft Exchange environment.  Creation of your email address will also create your Active Directory account. </font></p>\n\t<p> </p>",
      "show_price": false,
      "type": "catalog_item",
      "category": {
        "sys_id": "109f0438c6112276003ae8ac13e7009d",
        "title": "Services"
      },
      "show_quantity": false,
      "quantity": "1",
      "order": "300",
      "variables": [
        {
          "label": "Preferred Email address",
          "type": 6,
          "mandatory": true,
          "displayvalue": "",
          "friendly_type": "single_line_text",
          "display_type": "Single Line Text",
          "render_label": true,
          "read_only": false,
          "name": "new_email",
          "attributes": "edge_encryption_enabled=true",
          "id": "65865e474fbb4200086eeed18110c7dd",
          "value": "",
          "help_text": "",
          "max_length": 0
        }
      ],
      "ui_policy": [],
      "client_script": {
        "onChange": [],
        "onSubmit": [],
        "onLoad": []
      },
      "data_lookup": []
    },
    {
      "sys_id": "8b3ae7fedc1be1004ece5c08239e522b",
      "short_description": "Remote access to Internal Corporate Systems\n\t\t",
      "catalogs": [
        {
          "sys_id": "e0d08b13c3330100c8b837659bba8fb4",
          "title": "Service Catalog"
        }
      ],
      "name": "Corp VPN",
      "icon": "11dc8df74f778200086eeed18110c78e.iix",
      "description": "<p><font size=\"3\"><span style=\"color: #485563;\">Corp VPN Account</span></font></p>\n<ul><li style=\"color: #485563;\"><font size=\"2\">Corp VPN provides VPN (Virtual Private Network) access to all Internal Corporate Systems and to IP Restricted Customer Instances</font></li><li style=\"color: #485563;\"><font size=\"2\">By utilizing Corp VPN, users will be provided a similar experience to being within one of the Corporate office locations, while offsite</font></li></ul>\n<p><font size=\"2\"><span style=\"color: #485563;\"> </span></font></p>\n<p><font size=\"2\"><span style=\"color: #485563;\">Please reference the <span style=\"color: #485563;\">CORP VPN </span><span style=\"color: #485563;\">Installation</span><span style=\"color: #485563;\"> and Support Documentation</span> for instructions on installation, usage and FAQ’s. For all other questions, please contact <span style=\"color: #485563;\">IT Support.</span></span></font></p>\n<p> </p>\n<p><span style=\"font-size: 10pt; font-family: tahoma, arial, helvetica, sans-serif;\"><br /><br /></span></p>",
      "show_price": false,
      "type": "catalog_item",
      "category": {
        "sys_id": "d2f7cae4c611227a018ddc481b34e099",
        "title": "Security and Access"
      },
      "show_quantity": false,
      "quantity": "1",
      "order": "600",
      "variables": [],
      "ui_policy": [],
      "client_script": {
        "onChange": [],
        "onSubmit": [],
        "onLoad": []
      },
      "data_lookup": []
    },
    {
      "sys_id": "962967674ff38200086eeed18110c7e7",
      "short_description": "Desk Set Up for New Hires or Employee Moves\n\t\t",
      "catalogs": [
        {
          "sys_id": "",
          "title": "Service Catalog"
        }
      ],
      "name": "Desk Set Up",
      "icon": "aa6b08ff4ff38200086eeed18110c7ed.iix",
      "description": "<p><font size=\"3\" face=\"arial, helvetica, sans-serif\">The facilities organization will set up your new desk with the following configuration:</font></p>\n<ul><li><font size=\"3\" face=\"arial, helvetica, sans-serif\">Docking Station</font></li><li><font size=\"3\" face=\"arial, helvetica, sans-serif\">Power Station</font></li><li><font size=\"3\" face=\"arial, helvetica, sans-serif\">Phone</font></li><li><font size=\"3\" face=\"arial, helvetica, sans-serif\">Office Chair</font></li></ul>",
      "show_price": false,
      "type": "catalog_item",
      "category": {
        "sys_id": "",
        "title": null
      },
      "show_quantity": false,
      "quantity": "1",
      "order": "900",
      "variables": [
        {
          "label": "Please describe any ergonomic requirements\n\t\t",
          "type": 2,
          "mandatory": false,
          "displayvalue": "",
          "friendly_type": "multi_line_text",
          "display_type": "Multi Line Text",
          "render_label": true,
          "read_only": false,
          "name": "ergonomic_office",
          "attributes": "edge_encryption_enabled=true",
          "id": "b0b9ab674ff38200086eeed18110c755",
          "value": "",
          "help_text": "",
          "max_length": 0
        }
      ],
      "ui_policy": [],
      "client_script": {
        "onChange": [],
        "onSubmit": [],
        "onLoad": []
      },
      "data_lookup": []
    }
  ]
}