.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 {#ariaid-title25}
注文ガイドに記載されているニーズに基づいて、アイテムのリストを取得します。
### URL 形式 {#servicecat-PUT-items-submit_guide__section_axz_3kp_bmb}
バージョニングされた URL: /api/sn_sc/{api_version}/servicecatalog/items/{sys_id}/submit_guide
デフォルト URL: /api/sn_sc/servicecatalog/items/{sys_id}/submit_guide
注:
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。
### サポートされている要求パラメーター
{#servicecat-PUT-items-submit_guide__entry__2}{#servicecat-PUT-items-submit_guide__version-not_optional-RESTAPI}
| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
| sys_id | アイテムを取得する注文ガイドのSys_id。 データタイプ：文字列 テーブル:注文ガイド \[sc_cat_item_guide\] |
[表 : 140. パスパラメーター]
{#servicecat-PUT-items-submit_guide__entry__8}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 141. クエリパラメーター]
{#servicecat-PUT-items-submit_guide__entry__12}
| 名前 | 説明 |
|-|-|
| variables | アイテムに対して要求された変数。各変数は、名前と値のペアで構成される JSON オブジェクトです。 データタイプ：アレイ |
[表 : 142. 要求本文パラメーター (XML または JSON)]
### ヘッダー
次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#servicecat-PUT-items-submit_guide__entry__16}{#servicecat-PUT-items-submit_guide__accept-RESTAPI}{#servicecat-PUT-items-submit_guide__content_type-RESTAPI}
| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
| Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 143. 要求ヘッダー]
{#servicecat-PUT-items-submit_guide__entry__22}
| ヘッダー | 説明 |
|-|-|
| なし | |
[表 : 144. 応答ヘッダー]
### ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#servicecat-PUT-items-submit_guide__entry__26}{#servicecat-PUT-items-submit_guide__entry-401-status-code}
| ステータスコード | 説明 |
|-|-|
| 200 | 要求が正常に完了したことを示します。渡された変数リストに基づいてアイテムのリストを返します。結果セットにアイテムが含まれていない場合は、空の配列が返されます。 |
| 400 | 要求が無効であることを示します。次のいずれかの理由が考えられます。 * ユーザーにはアイテムへのアクセス権がありません。 * 1 つ以上のアイテムの必須変数に回答していません。(必須として定義された変数のみが優先されます)。 {#servicecat-PUT-items-submit_guide__ul_ubm_1jl_3v} |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 500 | 選択したオプションに応じて、アイテムの計算中に内部エラーが発生しました。 |
[表 : 145. ステータスコード]
### 応答本文のパラメーター (JSON または XML)
{#servicecat-PUT-items-submit_guide__entry__36}
| 名前 | 説明 |
|-|-|
| 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 {#servicecat-PUT-items-submit_guide__ul_dhd_ft1_mv} データタイプ：ブーリアン |
| sys_id | カタログアイテムのSys_id。 データタイプ：文字列 |
| type | アイテムタイプ。 可能な値： * カタログアイテム * 注文ガイド * レコードプロデューサーアイテム {#servicecat-PUT-items-submit_guide__ul_phl_zr1_mv} データタイプ：文字列 |
| 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": "x1 Carbon
\nThe 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.
\nTechnical Specs:
\n- Intel core i5 processor
- 512GB solid state drive (SSD)
- Backlit keyboard
",
"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": "
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.
\nItem Specs:
\n- Screen Size: 27"
- Resolution: 1920 x 1080
- Aspect Ratio: 16:9
- Brightness: 250 cd/m2
- Supports Split Screen
",
"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": "Service Overview:
\n\tCreation of a new email account within our Microsoft Exchange environment. Creation of your email address will also create your Active Directory account.
\n\t
",
"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": "Corp VPN Account
\n- Corp VPN provides VPN (Virtual Private Network) access to all Internal Corporate Systems and to IP Restricted Customer Instances
- By utilizing Corp VPN, users will be provided a similar experience to being within one of the Corporate office locations, while offsite
\n
\nPlease reference the CORP VPN Installation and Support Documentation for instructions on installation, usage and FAQ's. For all other questions, please contact IT Support.
\n
\n
",
"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": "The facilities organization will set up your new desk with the following configuration:
\n- Docking Station
- Power Station
- Phone
- Office Chair
",
"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": []
}
]
}