---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference
Release :
- xanadu
ft:locale :
- ja-JP
ft:publication_title :
- Xanadu API リファレンス
ft:clusterId :
- crapiref
bundleId :
- crapiref
workflow :
- Creator
---
# WSD 予約可能モジュール API
# WSD 予約可能モジュール API {#ariaid-title1}
* リリースバージョン: Xanadu
*
* 更新日 2024年08月01日
*
*  所要時間：38分
ワークプレイスサービスデリバリ (WSD) 予約可能モジュール API は、ServiceNowインスタンスから予約可能モジュールの詳細を取得するためのエンドポイントを提供します。
予約可能モジュールは、類似タイプの職場アイテムをグループ化します。従業員は、これらの類似アイテムを 1 つのカテゴリで表示できます。たとえば、部屋は予約可能モジュールであり、会議室、会議室、その他の部屋などの類似の職場アイテムが含まれています。
この API にアクセスするには、問い合わせユーザーに sn_wsd_core.workplace_user ロールが必要であり、Workplace Reservation Management (sn_wsd_rsv) プラグインを有効にする必要があります。この API は `sn_wsd_rsv` 名前空間で実行されます。
ワークプレイス予約管理の詳細については、「[Workplace Reservation Management](https://www.servicenow.com/docs/access?context=workplace-rsv-mgmt-feat&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US)」を参照してください。
## WSD 予約可能モジュール:GET /sn_wsd_rsv/reservable_module/{sys_id} {#ariaid-title2}
指定された予約可能モジュールの詳細を返します。
### URL 形式 {#wsd_resv_mod-GET-reserv_mod__section_vt2_5vz_qtb}
バージョン管理された URL: /api/sn_wsd_rsv/{api_version}/reservable_module/{sys_id}
デフォルト URL: /api/sn_wsd_rsv/reservable_module/{sys_id}
### サポートされている要求パラメーター
{#wsd_resv_mod-GET-reserv_mod__entry__2}{#wsd_resv_mod-GET-reserv_mod__version-RESTAPI}
| 名前 | 説明 |
|-|-|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
| sys_id | 取得する取り消し可能なモジュールレコードのSys_id。予約可能なモジュール \[sn_wsd_rsv_reservable_module\] テーブルにあります。 データタイプ：文字列 |
[表 : 1. パスパラメーター]
{#wsd_resv_mod-GET-reserv_mod__entry__8}
| 名前 | Description (説明) |
|-|-|
| is_buildings_tree_data_required | 予約可能モデルに関連付けられた建物データを返すかどうかを示すフラグ。 有効な値： * true:建物データを返します。 * false:建物データを返しません。 データタイプ：ブーリアン デフォルト値：false |
| 近隣 | スペース管理 (sn_wsd_spc_mgmt_neighborhood) プラグインが有効になっている場合にのみ使用できます。 エンコードクエリで使用する近隣レコードのSys_id。近隣 \[sn_wsd_spcmgmt_neighborhood\] テーブルにあります。 近隣スペースの予約の詳細については、「 [Create neighborhood reservations](https://www.servicenow.com/docs/access?context=create-neighborhood-reservations&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US)」を参照してください。 エンドポイントは、近隣が有効かどうかをチェックし、近隣で参照パスに必要なデータを取得します。 データタイプ：文字列 |
[表 : 2. クエリパラメーター]
{#wsd_resv_mod-GET-reserv_mod__entry__14}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 3. 要求本文パラメーター (XML または JSON)]
### ヘッダー {#wsd_resv_mod-GET-reserv_mod__section_k3d_swn_1yb}
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#wsd_resv_mod-GET-reserv_mod__table_l3d_swn_1yb__entry__2}{#wsd_resv_mod-GET-reserv_mod__accept-RESTAPI}
| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 4. 要求ヘッダー]
{#wsd_resv_mod-GET-reserv_mod__table_l3d_swn_1yb} {#wsd_resv_mod-GET-reserv_mod__table_m3d_swn_1yb__entry__2}
| ヘッダー | 説明 |
|-|-|
| なし | |
[表 : 5. 応答ヘッダー]
{#wsd_resv_mod-GET-reserv_mod__table_m3d_swn_1yb}
### ステータスコード {#wsd_resv_mod-GET-reserv_mod__section_scs_twn_1yb}
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#wsd_resv_mod-GET-reserv_mod__table_tcs_twn_1yb__entry__2}{#wsd_resv_mod-GET-reserv_mod__entry-200-status-code}{#wsd_resv_mod-GET-reserv_mod__entry-400-status-code}{#wsd_resv_mod-GET-reserv_mod__entry-401-status-code}{#wsd_resv_mod-GET-reserv_mod__entry-404-status-code}{#wsd_resv_mod-GET-reserv_mod__entry-500-status-code}
| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 |
| 404 | 見つかりません。要求アイテムが見つかりませんでした。 |
| 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 |
[表 : 6. ステータスコード]
{#wsd_resv_mod-GET-reserv_mod__table_tcs_twn_1yb}
### 応答本文のパラメーター (JSON または XML)
{#wsd_resv_mod-GET-reserv_mod__id_w24_zwn_1yb__entry__2}{#wsd_resv_mod-GET-reserv_mod__allow_invitees-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__allow_whole_day-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__apply_to_shift-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__browse_by_area_enabled-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__browse_near_a_person_enabled-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__buildingTreeData-reserv_mod-row}{#wsd_resv_mod-GET-reserv_mod__buildingSysIds-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__checkin_before_minutes-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__display_number_of_attendees-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__display_on_behalf_of-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__display_sensitivity-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__display_value-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__enable_browse_by_area-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__enable_browse_near_a_person-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__enable_facet_filter-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__enable_group_reservations-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__enable_ical_generation-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__font_awesome_icon-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__inline_title-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_body-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_body_field-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_body_field_to_display-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_body_icon-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_body_label-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_description-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_image-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_subtitle-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_subtitle_asc-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_title-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__max_days_in_future-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__max_occurrences-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__name-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__nbh_avail-reserv_mod-ph}{#wsd_resv_mod-GET-reserv_mod__override_approval_policy-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__require_cancel_notes-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__require_cc_dept_check-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__require_subject-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_columns-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_container_field-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_filter-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_quantity_field-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_table-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_type-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_views-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_views_iconClass-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_views_isDefault-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_views_label-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_views_order-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_views_type-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservation_paths-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservation_paths_displayValue-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservation_paths_value-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__search_limit-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__selection_type-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__short_description-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__show_map_view-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__sys_id-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__timeSlots-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__timeSlots_name-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__timeSlots_short_description-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__timeSlots_slot_end-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__timeSlots_slot_start-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__timeSlots_slot_sys_id-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__title-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__virtual_meeting_provider-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__virtual_meeting_provider_display_value-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__virtual_meeting_provider_sys_id-reserv_mod-entry}
| 名前 | 説明 |
|-|-|
| results | 要求された予約可能モジュールの詳細。 データタイプ：オブジェクト { "result": { "allow_invitees": Boolean, "allow_whole_day": Boolean, "apply_to_shift": Boolean, "browse_by_area_enabled": Boolean, "browse_by_neighborhood_enabled": Boolean, "browse_near_a_person_enabled": Boolean, "buildingsTreeData": [Array], "buildingSysIds": [Array], "checkin_before_minutes": Number, "display_number_of_attendees": Boolean, "display_on_behalf_of": Boolean, "display_sensitivity": Boolean, "display_value": "String", "enable_browse_by_area": Boolean, "enable_browse_by_neighborhood": Boolean, "enable_browse_near_a_person": Boolean, "enable_facet_filter": Boolean, "enable_group_reservations": Boolean, "enable_ical_generation": Boolean, "font_awesome_icon": "String", "inline_title": "String", "layout_mapping": {JSON Object}, "max_days_in_future": Number, "max_occurrences": Number, "name": "String", "nbhBuildingIds": [Array], "nbhBuildingsData": [Array]; "nbhBuildingsTreeData": [Array], "override_approval_policy": "String", "require_cancel_notes": Boolean, "require_cc_dept_check": Boolean, "require_subject": Boolean, "reservable_columns": [Array], "reservable_container_field": "String", "reservable_filter": "String", "reservable_quantity_field": "String", "reservable_table": "String", "reservable_type": "String", "reservable_views": [Array], "reservation_paths": [Array], "search_limit": Number, "selection_type": "String", "short_description": "String", "show_map_view": Boolean, "sys_id": "String", "timeSlots": [Array], "title": "String", "virtual_meeting_provider": {Object} } } |
| result.allow_invitees | 従業員が招待者を予約に追加できるどうかを示すフラグ。 有効な値： * true：従業員が招待者を予約に追加できるようにします。 * false:従業員が招待者を予約に追加できないようにします。 データタイプ：ブーリアン |
| result.allow_whole_day | ユーザーが予約可能項目を終日予約できるかどうかを示すフラグ。 有効な値： * true：ユーザーが終日予約できるようにします。 * false:ユーザーに終日の予約を許可しません。 データタイプ：ブーリアン |
| result.apply_to_shift | 予約可能モジュールに対してシフトベースの予約が有効かどうかを示すフラグ。 有効な値： * true：シフトベースの予約を許可します。 * false:シフトベースの予約を許可しません。 データタイプ：ブーリアン |
| result.browse_by_area_enabled | ユーザーがエリア別に予約可能モジュールを検索できるかどうかを示すフラグ。 有効な値： * true：ユーザーがエリア別に予約可能モジュールを参照できるようにします。 * false:予約可能モジュールをエリア別に参照することをユーザーに許可しません。 データタイプ：ブーリアン |
| result.browse_by_neighborhood_enabled | 「スペース管理 - sn_wsd_spc_mgmt」プラグインがインストールされている場合のみ使用できます。 ユーザーが予約可能モジュール内を近隣で検索できるかどうかを示すフラグ。 有効な値： * true:ユーザーが近隣別に予約可能モジュールを参照できるようにします。 * false:予約可能モジュールを近隣別に参照することをユーザーに許可しません。 データタイプ：ブーリアン |
| result.browse_near_a_person_enabled | ユーザーが特定のユーザーによって配置された予約可能モジュールを検索できるかどうかを示すフラグ。 有効な値： * true：ユーザーが特定のユーザーに近い予約可能モジュールを参照できるようにします。 * false:ユーザーが人の近くにある予約可能なモジュールを参照できないようにします。 データタイプ：ブーリアン |
| result.buildingTreeData | is_buildings_tree_data_required クエリパラメーターが true に設定されている場合にのみ返されます。予約可能モジュールに関連付けられた建物の階層。 階層順序： * リージョン：リージョン \[sn_wsd_core_region\] テーブルにあります。 * サイト：サイト \[sn_wsd_core_site\] テーブルにあります。 * 敷地：敷地 \[sn_wsd_core_campus\] テーブルにあります。 * 建物：建物 \[sn_wsd_core_building\] テーブルにあります。 {#wsd_resv_mod-GET-reserv_mod__ul_ppq_h34_stb} 各 `children[ ]` ノードは、異なる建物レベル/階層を反映します。 * buildingsTreeData：リージョン * buildingsTreeData.children：サイト * buildingsTreeData.children.children：敷地 * buildingsTreeData.children.children：建物 データタイプ：オブジェクトのアレイ "buildingsTreeData": [ { "children": [Array], "data": {Object}, "isSelectable": Boolean, "isValid": Boolean, "label": "String", "uId": "String" } ] |
| result.buildingsTreeData.children | 予約可能モジュールに関連付けられているサイト、敷地、または建物の詳細。すべての `children[ ]` ノードの各パラメータは同じです。これらは異なる建築エンティティにのみ適用され、このセクションでは 1 回だけ説明します。 データタイプ：オブジェクトのアレイ "children": [ { "children": [Array], "data": {Object}, "isSelectable": Boolean, "isValid": Boolean, "label": "String", "uId": "String" } ] |
| result.buildingsTreeData.children.data | 建物エンティティの詳細。 データタイプ：オブジェクト "data": { "sysId": "String", "table": "String", "timezone": {Object} } |
| result.buildingsTreeData.children.data.sys_id | 関連付けられた建物エンティティの sys_id。 データタイプ：文字列 |
| result.buildingsTreeData.children.data.table | sys_id で識別される建物エンティティレコードが配置されているテーブルの名前。 データタイプ：文字列 |
| result.buildingsTreeData.children.data.timezone | 建物エンティティのタイムゾーンに関する詳細。 "timezone": { "displayValue": "String", "value": "String" } |
| result.buildingsTreeData.children.data.timezone.displayValue | タイムゾーンのレコードの表示値。 データタイプ：文字列 |
| result.buildingsTreeData.children.data.timezone.value | タイムゾーンのレコードの内部値。 データタイプ：文字列 |
| result.buildingsTreeData.children.isSelectable | 関連する建物エンティティが予約可能モデルで利用可能 (選択可能) かどうかを示すフラグ。 有効な値： * true：予約可能モジュールで建物エンティティが利用可能です。 * false:予約可能モジュールでエンティティの作成を使用できません。 データタイプ：ブーリアン |
| result.buildingsTreeData.children.isValid | 関連する建物エンティティが予約可能モデルで有効かどうかを示すフラグ。 有効な値： * true：予約可能モジュールで建物エンティティが有効です。 * false:建物エンティティは予約可能モジュールに対して有効ではありません。 データタイプ：ブーリアン |
| result.buildingsTreeData.children.label | 建物エンティティの名前。 データタイプ：文字列 |
| result.buildingsTreeData.children.uId | 関連付けられた建物エンティティレコードの sys_id。 データタイプ：文字列 |
| result.buildingSysIds | 予約可能モジュールに関連付けられた建物の sys_id のリスト。 データタイプ：文字列のアレイ |
| result.checkin_before_minutes | ユーザーが予約にチェックインできる予約開始前の時間。 単位：分 データタイプ：数値 |
| result.display_number_of_attendees | ユーザーが予約の出席者の数を指定できるかどうかを示すフラグ。 有効な値： * true：ユーザーは出席者の数を指定できます。 * false:ユーザーは出席者の表示数を指定できません。 データタイプ：ブーリアン |
| result.display_on_behalf_of | 他のユーザーの代わりに予約できるかどうかを示すフラグ。 有効な値： * true：代理がサポートされます。 * false：代理はサポートされません。 データタイプ：ブール |
| result.display_sensitivity | ユーザーが、normal、private などの予約の機密性を設定できるかどうかを示すフラグ。 有効な値： * true：機密性を設定できます。 * false：機密性を設定できません。デフォルトは normal です。 データタイプ：ブール |
| result.display_value | 予約可能モジュールの表示値。 データタイプ：文字列 |
| result.enable_browse_by_area | ユーザーがエリア別に予約可能モジュールを検索できるかどうかを示すフラグ。browse_by_area_enabled と同じです。 有効な値： * true：ユーザーがエリア別に予約可能モジュールを参照できるようにします。 * false:予約可能モジュールをエリア別に参照することをユーザーに許可しません。 {#wsd_resv_mod-GET-reserv_mod__ul_unz_q1r_stb} データタイプ：ブーリアン |
| result.enable_browse_by_neighborhood | ユーザーが予約可能なモジュールを近隣で検索できるかどうかを示すフラグ。 有効な値： * true:ユーザーが近隣別に予約可能モジュールを参照できるようにします。 * false:予約可能モジュールを近隣別に参照することをユーザーに許可しません。 データタイプ：ブーリアン |
| result.enable_browse_near_a_person | ユーザーが特定のユーザーによって配置された予約可能モジュールを検索できるかどうかを示すフラグ。 browse_near_a_person_enabled と同じです。 有効な値： * true：ユーザーが特定のユーザーに近い予約可能モジュールを参照できるようにします。 * false:ユーザーが人の近くにある予約可能なモジュールを参照できないようにします。 {#wsd_resv_mod-GET-reserv_mod__ul_zx4_s1r_stb} データタイプ：ブーリアン |
| result.enable_facet_filter | 職場アイテムのファセットフィルタリングが有効かどうかを示すフラグ。有効にすると、表示されるフィルターオプションは検索結果に基づきます。ユーザーは、生成された検索結果で使用可能なアイテムのみをフィルターで選択できます。 有効な値： * true：ファセットフィルターは有効です。 * false:ファセットフィルターは有効ではありません。 データタイプ：ブーリアン |
| result.enable_group_reservations | ユーザーがグループ予約できるかどうかを示すフラグ。 有効な値： * true：グループ予約ができます。 * false：グループ予約はできません。 データタイプ：ブール |
| result.enable_ical_generation | ユーザーが予約の iCalendar を生成できるかどうかを示すフラグ。 有効な値： * true：iCalendar の生成を許可します。 * false:iCalendar の生成は許可されません。 データタイプ：ブーリアン |
| result.font_awesome_icon | 予約可能モジュールに添付されているフォントアイコンの名前。 データタイプ：文字列 |
| result.inline_title | 予約可能モジュールのインラインタイトル。タイトルは、職場サービスポータルの説明テキストとともインラインに表示されます。 データタイプ：文字列 |
| result.layout_mapping | 場所のレイアウトマッピングの構造に関する詳細。このデータを使用して、UI に情報をレイアウトします。 データタイプ: オブジェクト "layout_mapping": { "body": [Array], "description": [Array], "image": "String", "subtitle": [Array], "subtitle_asc": [Array], "title": [Array] } |
| result.layout_mapping.body | フロントエンド UI データをマッピングするためのプレースホルダー。 データタイプ：オブジェクトのアレイ "body": [ { "field": "String", "field_to_display": "String", "icon": "String", "label": "String" } ] |
| result.layout_mapping.body.field | フロントエンド UI データをマッピングするためのプレースホルダー。 データタイプ：文字列 |
| result.layout_mapping.body.field_to_display | フロントエンド UI データをマッピングするためのプレースホルダー。 データタイプ：文字列 |
| result.layout_mapping.body.icon | フロントエンド UI データをマッピングするためのプレースホルダー。 データタイプ：文字列 |
| result.layout_mapping.body.label | フロントエンド UI データをマッピングするためのプレースホルダー。 データタイプ：文字列 |
| result.layout_mapping.description | フロントエンド UI データをマッピングするためのプレースホルダー。レイアウトマッピングの説明。 データタイプ：アレイ |
| result.layout_mapping.image | フロントエンド UI データをマッピングするためのプレースホルダー。 データタイプ：文字列 |
| result.layout_mapping.subtitle | フロントエンド UI データをマッピングするためのプレースホルダー。 データタイプ：アレイ |
| result.layout_mapping.subtitle_asc | フロントエンド UI データをマッピングするためのプレースホルダー。 データタイプ：アレイ |
| result.layout_mapping.title | フロントエンド UI データをマッピングするためのプレースホルダー。 データタイプ：アレイ |
| result.max_days_in_future | ユーザーが予約可能モジュールを予約できる、今後の最大日数。 データタイプ：数値 |
| result.max_occurrences | 予約可能モジュールの繰り返し予約が利用可能な場合の繰り返し予約の最大発生回数。 データタイプ：数値 |
| result.name | 予約可能モジュールの名前。 データタイプ：文字列 |
| result.nbhBuildingIds | スペース管理プラグインがインストールされていて、 browse_by_neighborhood_enabled パラメーターが true に設定されていて、 neighborhood パラメーターがクエリパラメーターで渡される場合にのみ返されます。 予約可能モジュールに関連付けられ、近隣用に構成されている建物のsys_idsのリスト。 データタイプ：文字列のアレイ |
| result.nbhBuildingsData | スペース管理プラグインがインストールされていて、 browse_by_neighborhood_enabled パラメーターが true に設定されていて、 neighborhood パラメーターがクエリパラメーターで渡される場合にのみ返されます。 予約可能モジュールに関連付けられ、近隣用に構成されている建物のsys_idsのリスト。各建物要素には、建物で利用可能な対応するフロアのsys_idsのリストも含まれています。 例： "nbhBuildingsData": { "4703a4cedb3650106c731dcd13961945": [ "0f9e304edb7650106c731dcd13961911" ], "6c0364cedb3650106c731dcd13961927": [ "b23328cedb3650106c731dcd139619f9" ] } 建物sys_idsに関連付けられたレコードは、建物 \[sn_wsd_core_building\] テーブルにあります。フロアsys_idsに関連付けられたレコードは、フロア \[sn_wsd_core_floor\] テーブルにあります。 データタイプ：オブジェクトのアレイ |
| result.nbhBuildingsTreeData | スペース管理プラグインがインストールされていて、 browse_by_neighborhood_enabled パラメーターが true に設定されていて、 neighborhood パラメーターがクエリパラメーターで渡される場合にのみ返されます。 予約可能なモジュールと近隣に関連付けられた建物の階層。 データタイプ：オブジェクトのアレイ "buildingsTreeData": [ { "children": [Array], "data": {Object}, "isSelectable": Boolean, "isValid": Boolean, "label": "String", "uId": "String" } ] 階層順序： * リージョン：リージョン \[sn_wsd_core_region\] テーブルにあります。 * サイト：サイト \[sn_wsd_core_site\] テーブルにあります。 * 敷地：敷地 \[sn_wsd_core_campus\] テーブルにあります。 * 建物：建物 \[sn_wsd_core_building\] テーブルにあります。 |
| result.nbhBuildingsTreeData.children | 建物に関連付けられた子の階層を示します。 各 `children[]` ノードは、異なる建物レベル/階層を反映しています。 * buildingsTreeData：リージョン * buildingsTreeData.children：サイト * buildingsTreeData.children.children：敷地 * buildingsTreeData.children.children：建物 データタイプ：アレイ "children": [ { "children": [Array], "data": {Object}, "isSelectable": Boolean, "isValid": Boolean, "label": "String", "uId": "String" } ] `children[]` 配列のパラメーターは、関連する場所タイプ (地域、サイト、敷地、または建物) に対してのみ、nbhBuildingsTreeData オブジェクトのパラメーターと同じです。 |
| result.nbhBuildingsTreeData.data | 関連付けられたエンティティに関する詳細。地域、サイト、敷地、または建物。 データタイプ: オブジェクト "data": { "sys_id": "String", "table": "String", "timezone": {Object} } |
| result.nbhBuildingsTreeData.data.sysId | 関連付けられたエンティティレコードのSys_id。 データタイプ：文字列 |
| result.nbhBuildingsTreeData.data.table | 関連するレコードが配置されているテーブル。 データタイプ：文字列 |
| result.nbhBuildingsTreeData.data.timezone | 関連付けられたエンティティが存在するタイムゾーンに関する情報。 データタイプ: オブジェクト "timezone": { "displayValue": "String", "value": "String" } |
| result.nbhBuildingsTreeData.data.timezone.displayValue | ユーザーインターフェイスで使用するタイムゾーン値。 データタイプ：文字列 |
| result.nbhBuildingsTreeData.data.timezone.value | 内部タイムゾーン値。 データタイプ：文字列 |
| result.nbhBuildingsTreeData.isSelectable | 関連付けられたエンティティが予約可能モデルで利用可能 (選択可能) かどうかを示すフラグ。 有効な値： * true:エンティティは予約可能モジュールで使用できます。 * false:エンティティは予約可能モジュールで使用できません。 データタイプ：ブーリアン |
| result.nbhBuildingsTreeData.isValid | 関連付けられたエンティティが予約可能モデルに対して有効かどうかを示すフラグ。 有効な値： * true:エンティティは予約可能モジュールに対して有効です。 * false:エンティティは予約可能モジュールに対して有効ではありません。 データタイプ：ブーリアン |
| result.nbhBuildingsTreeData.label | 予約可能なビューの名前。 データタイプ：文字列 |
| result.nbhBuildingsTreeData.uId | 関連付けられたエンティティのSys_id。 データタイプ：文字列 |
| result.override_approval_policy | 承認ポリシーの実装方法を指定するオプション。選択肢は次のとおりです。 * 上書きなし：承認ポリシーは、職場スペースまたは部屋の \[承認が必要\] フィールドの設定に従って実装されます。 * 常に承認が必要：職場スペースまたは部屋の \[承認が必要\] フィールドの設定に関係なく、承認ポリシーが必要です。 * 承認の必要なし：職場スペースまたは部屋の \[承認が必要\] フィールドの設定に関係なく、承認ポリシーが削除されます。 データタイプ：文字列 |
| result.require_cancel_notes | 予約可能モジュールをキャンセルする前にユーザーがキャンセルメモを入力する必要があるかどうかを示すフラグ。 有効な値： * true：キャンセルメモが必要です。 * false：キャンセルメモは必要ありません。 データタイプ：ブール |
| result.require_cc_dept_check | ワークスペースアイテムとログインユーザーの間にコストセンターまたは部門の不一致があるかどうかを確認するかどうかを示すフラグ。 有効な値： * true：不一致を確認します。 * false:不一致をチェックしません。 データタイプ：ブーリアン |
| result.require_subject | 予約時にユーザーが件名を入力する必要があるかどうかを示すフラグ。 有効な値： * true：件名が必要です。 * false:件名は必須ではありません。 データタイプ：ブーリアン |
| result.reservable_columns | 予約可能項目の列のリスト。職場の場所 \[sn_wsd_core_workplace_location\] テーブルにあります。 データタイプ：アレイ |
| result.reservable_container_field | 特定のエリアのデスクのグループなどのコンテナーのレベル。 データタイプ：文字列 |
| result.reservable_filter | 関連付けられた予約可能テーブルの予約可能アイテムのフィルタリングに使用されるフィルター条件。予約可能テーブルは、予約可能なモジュール \[sn_wsd_rsv_reservable_module\] テーブル内のフィールドです。これらのフィルター条件は、フィールドの予約可能テーブルに含まれるテーブルに適用されました。 データタイプ：文字列 |
| result.reservable_quantity_field | すべてのスペースの予約可能な数量。数は、エリアに近隣スペースをアサインするときに使用されます。詳細については、「 [エリアへの近隣スペースの割り当て](https://www.servicenow.com/docs/access?context=add-neighbourhood-spaces-to-an-area&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US)」を参照してください。 データタイプ：文字列 |
| result.reservable_table | 予約可能な職場アイテムを含むテーブル。 データタイプ：文字列 |
| result.reservable_type | 予約可能アイテムのタイプ (場所など)。 データタイプ：文字列 |
| result.reservable_views | カードビューやスケジュールビューなど、予約可能モジュールに関連付けられたさまざまなビューに関する詳細。 予約可能なビュー \[sn_wsd_rsv_reservable_module\] テーブルにあります。 データタイプ：オブジェクト "reservable_views": { "iconClass": "String", "isDefault": Boolean, "label": "String", "order": Number, "type": "String" } |
| result.reservable_views.iconClass | 予約可能なビューのアイコンクラス。 データタイプ：文字列 |
| result.reservable_views.isDefault | この予約可能なビューを予約可能なモジュールのデフォルトにするかどうかを示すフラグ。 有効な値： * true：デフォルトにします。 * false:デフォルトにしません。 データタイプ：ブーリアン |
| result.reservable_views.label | 予約可能なビューの名前。 データタイプ：文字列 |
| result.reservable_views.order | UI の予約可能モジュールのビューが表示される順序。UI では小さい順序番号が先に表示されます。同じ順序番号の場合は、ランダムな順序が割り当てられます。 データタイプ：数値 |
| result.reservable_views.type | 予約可能なビューのバックエンド名。内部処理に使用されます。 データタイプ：文字列 |
| result.reservation_paths | \[すべて参照\]、 \[人の近くで参照する\] などの予約可能なモジュールに関連付けられた予約パス。 データタイプ：オブジェクトのアレイ "reservation_paths": [ { "displayValue": "String", "value": "String" } |
| result.reservation_paths.displayValue | \[人の近くで参照する\] などの予約パスの表示値。 データタイプ：文字列 |
| result.reservation_paths.value | 「browse_near_a_person」などの予約パスの内部値。 データタイプ：文字列 |
| result.search_limit | ユーザーが職場の場所を検索するときに返される検索結果の最大数。 データタイプ：数値 |
| result.selection_type | 検索結果に表示する選択のタイプ。 次のいずれかのオプションを指定できます。 * \[特定の単位\]：検索結果には、すべての職場アイテムが表示されます。 * \[コンテナー\]：検索結果には、職場アイテムの親またはコンテナーが表示されます。 データタイプ：文字列 |
| result.short_description | 予約可能なモジュールの簡単な説明。 データタイプ：文字列 |
| result.show_map_view | この予約可能なモジュールのマップビューを有効にするかどうかを示すフラグ。 有効な値： * true：マップビューを有効にします。 * false:マップビューを有効にしません。 {#wsd_resv_mod-GET-reserv_mod__ul_dsq_ftg_rtb} データタイプ：ブーリアン |
| result.sys_id | 予約可能モジュールの sys_id。 データタイプ：文字列 |
| result.timeSlots | 予約可能モジュールに関連付けられたタイムスロットの詳細。 データタイプ：オブジェクトのアレイ [ { "name": "String", "short_description": "String", "slot_end": "String", "slot_start": "String", "sys_id": "String" } ] |
| result.timeSlots.name | タイムスロットの名前 データタイプ：文字列 |
| result.timeSlots.short_description | タイムスロットの簡単な説明。 データタイプ：文字列 |
| result.timeSlots.slot_end | タイムスロットの終了時間 データタイプ：文字列 |
| result.timeSlots.slot_start | スロットの開始時間。 データタイプ：文字列 |
| result.timeSlots.sys_id | タイムスロットレコードの sys_id。 タイムスロット \[sn_wsd_rsv_time_slot\] テーブルにあります。 データタイプ：文字列 |
| result.title | 予約可能なモジュールのタイトル。 データタイプ：文字列 |
| result.virtual_meeting_provider | 予約可能モジュールに関連付けられている仮想プロバイダーの詳細。 データタイプ：オブジェクト "virtual_meeting_provider": { "display_value": "String", "sys_id": "String" } |
| result.virtual_meeting_provider.display_value | バーチャル会議プロバイダーの表示値。 データタイプ：文字列 |
| result.virtual_meeting_provider.sys_id | バーチャル会議プロバイダーの sys_id。 データタイプ：文字列 |
[ ]
{#wsd_resv_mod-GET-reserv_mod__id_w24_zwn_1yb}
### cURL 要求
このコード例は、建物のツリーデータを使用して予約可能なモジュールを要求する方法を示しています。
curl "http://instance.servicenow.com/api/sn_wsd_rsv/reservable_module/5db44502dbb650106c731dcd13961937&is_buildings_tree_data_required=true" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
応答本文：
{
"result": {
"sys_id": "5db44502dbb650106c731dcd13961937", "name": "Desks",
"title": "Desks",
"inline_title": "desk",
"font_awesome_icon": "fa-desktop",
"reservable_table": "sn_wsd_core_space",
"reservable_filter": "active=true^is_reservable=true^location_type=5f017383eb512010b89bfdfc9c5228c8^building.is_reservable=true^floor.is_reservable=true^EQ",
"short_description": "Reserve a single desks",
"reservable_type": "location",
"require_subject": null,
"require_cancel_notes": false,
"virtual_meeting_provider": {
"sys_id": "e33d9e6853c201103cf7ddeeff7b1205",
"display_value": "Template"
},
"allow_invitees": null,
"display_number_of_attendees": null,
"display_on_behalf_of": null,
"display_sensitivity": null,
"max_days_in_future": "90",
"allow_whole_day": "1",
"selection_type": "unit",
"reservable_container_field": null,
"reservable_quantity_field": null,
"apply_to_shift": null,
"max_occurrences": "90",
"enable_facet_filter": false,
"search_limit": 10000,
"enable_ical_generation": null,
"enable_group_reservations": null,
"enable_browse_near_a_person": "1",
"enable_browse_by_area": "1",
"enable_browse_by_neighborhood": "1",
"show_map_view": false,
"require_cc_dept_check": false,
"display_value": "Desks",
"browse_near_a_person_enabled": true,
"browse_by_area_enabled": true,
"browse_by_neighborhood_enabled": true,
"reservable_columns": [
"sys_id",
"external_id",
"email",
"name",
"title",
"description",
"image",
"number",
"site",
"campus",
"building",
"floor",
"area",
"capacity",
"reservable_quantity",
"location_type",
"order",
"requires_check_in",
"is_reservable"
],
"layout_mapping": {
"title": [
"name"
],
"description": [
"description"
],
"subtitle": [
"campus",
"building",
"floor",
"area"
],
"subtitle_asc": [
"area",
"floor",
"building",
"campus"
],
"image": "image",
"body": [
{
"label": "Capacity",
"icon": "fa-users",
"field": "capacity",
"field_to_display": ""
},
{
"label": "Standard services",
"icon": "fa-check",
"field": "standard_services",
"field_to_display": "name"
},
{
"label": "Reservable purposes",
"icon": "fa-tags",
"field": "reservable_purposes",
"field_to_display": "name"
}
]
},
"timeSlots": [
{
"sys_id": "d5331cf2dbb5f01038e42b24ca961906",
"name": "All day",
"short_description": "8am - 6pm",
"slot_start": "08:00",
"slot_end": "18:00"
},
{
"sys_id": "de131cf2dbb5f01038e42b24ca961931",
"name": "Before noon",
"short_description": "8am - 12pm",
"slot_start": "08:00",
"slot_end": "12:00"
},
{
"sys_id": "6e99ab5ddbb930102e8e853e68961929",
"name": "After noon",
"short_description": "1pm - 6pm",
"slot_start": "13:00",
"slot_end": "18:00"
}
],
"buildingSysIds": [
"9e0364cedb3650106c731dcd1396192b"
],
"buildingsTreeData": [
{
"isValid": true,
"label": "Europe",
"uId": "2d626c4edb3650106c731dcd1396194b",
"isSelectable": false,
"children": [
{
"isValid": true,
"label": "Western Europe",
"uId": "b17220cedb3650106c731dcd1396197a",
"isSelectable": false,
"children": [
{
"isValid": true,
"label": "Amsterdam Campus",
"uId": "44d2e0cedb3650106c731dcd13961988",
"isSelectable": false,
"children": [
{
"isValid": true,
"label": "AMS-B1",
"uId": "9e0364cedb3650106c731dcd1396192b",
"isSelectable": true,
"children": [],
"data": {
"sysId": "9e0364cedb3650106c731dcd1396192b",
"table": "sn_wsd_core_building",
"timezone": {
"value": "Europe/Amsterdam",
"displayValue": "Europe/Amsterdam"
}
}
}
],
"data": {
"sysId": "44d2e0cedb3650106c731dcd13961988",
"table": "sn_wsd_core_campus",
"timezone": null
}
}
],
"data": {
"sysId": "b17220cedb3650106c731dcd1396197a",
"table": "sn_wsd_core_site",
"timezone": null
}
}
],
"data": {
"sysId": "2d626c4edb3650106c731dcd1396194b",
"table": "sn_wsd_core_region",
"timezone": null
}
}
],
"reservable_views": [
{
"type": "card",
"label": "Card view",
"iconClass": "fa-th-large",
"isDefault": true,
"order": "1"
},
{
"type": "schedule",
"label": "Schedule view",
"iconClass": "fa-calendar-o",
"isDefault": false,
"order": "2"
}
],
"checkin_before_minutes": 30,
"reservation_paths": [
{
"value": "browse_all",
"displayValue": "Browse all"
},
{
"value": "browse_near_a_person",
"displayValue": "Browse near a person"
},
{
"value": "browse_by_area",
"displayValue": "Browse by area"
}
],
"override_approval_policy": "never_required"
}
}