WSD 予約可能モジュール API
(WSD) 予約可能モジュール API はワークプレイスサービスデリバリ、インスタンスからServiceNow予約可能モジュールの詳細を取得します。
予約可能モジュールは、類似タイプの職場アイテムをグループ化します。従業員は、これらの類似アイテムを単一のカテゴリで表示できます。たとえば、部屋は予約可能モジュールであり、会議室、カンファレンスルーム、その他の部屋といった類似の職場アイテムが含まれています。
この API にアクセスするには、問い合わせユーザーに sn_wsd_core.workplace_user ロールが必要であり、Workplace Reservation Management (sn_wsd_rsv) プラグインを有効にする必要があります。この API は sn_wsd_rsv 名前空間で実行されます。
Workplace Reservation Managementの詳細については、を参照してくださいWorkplace Reservation Management。
WSD 予約可能モジュール - GET /sn_wsd_rsv/reservable_module/{sys_id}
指定された予約可能モジュールの詳細を返します。
URL 形式
バージョニングされた URL:/ api/sn_wsd_rsv/{api_version}/reservable_module/{sys_id}
デフォルトの URL:/ api/sn_wsd_rsv/reservable_module/{sys_id}
サポートされている要求パラメーター
| 名前 | 説明 |
|---|---|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
| sys_id | 取得する可逆モジュールレコードのSys_id。予約可能なモジュール [sn_wsd_rsv_reservable_module] テーブルにあります。 データタイプ：文字列 |
| 名前 | 説明 |
|---|---|
| is_buildings_tree_data_required | 予約可能なモデルに関連付けられた建物データを返すかどうかを示すフラグ。 有効な値：
データタイプ：ブーリアン デフォルト：false |
| 近隣 | スペース管理 (sn_wsd_spc_mgmt_neighborhood) プラグインが有効になっている場合にのみ使用できます。 エンコードされたクエリで使用する近隣レコードのSys_id。近隣 [sn_wsd_spcmgmt_neighborhood] テーブルにあります。 近隣スペースの予約の詳細については、「」を参照してください Create neighborhood reservations。 エンドポイントは、近隣が有効かどうかを確認し、近隣ごとの参照パスに必要なデータを取得します。 データタイプ：文字列 |
| 名前 | 説明 |
|---|---|
| なし |
ヘッダー
次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。
| ヘッダー | 説明 |
|---|---|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
| ヘッダー | 説明 |
|---|---|
| なし |
ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。
| ステータスコード | 説明 |
|---|---|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 |
| 404 | 見つかりません。要求アイテムが見つかりませんでした。 |
| 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 |
応答本文のパラメーター (JSON または XML)
| 名前 | 説明 |
|---|---|
| results | 要求された予約可能モジュールの詳細。 データタイプ：オブジェクト |
| result.allow_invitees | 従業員が招待者を予約に追加できるどうかを示すフラグ。 有効な値：
データタイプ：ブーリアン |
| result.allow_whole_day | ユーザーが予約可能項目を終日予約できるかどうかを示すフラグ。 有効な値：
データタイプ：ブーリアン |
| result.apply_to_shift | 予約可能モジュールに対してシフトベースの予約が有効かどうかを示すフラグ。 有効な値：
データタイプ：ブーリアン |
| result.browse_by_area_enabled | ユーザーがエリア別に予約可能モジュールを検索できるかどうかを示すフラグ。 有効な値：
データタイプ：ブーリアン |
| result.browse_by_neighborhood_enabled | スペース管理 - sn_wsd_spc_mgmt プラグインがインストールされている場合にのみ使用できます。 ユーザーが予約可能モジュールを近隣で検索できるかどうかを示すフラグ。 有効な値：
データタイプ：ブーリアン |
| result.browse_near_a_person_enabled | ユーザーが特定のユーザーによって配置された予約可能モジュールを検索できるかどうかを示すフラグ。 有効な値：
データタイプ：ブーリアン |
| result.buildingTreeData | is_buildings_tree_data_required クエリパラメーターが true に設定されている場合にのみ返されます。予約可能モジュールに関連付けられた建物の階層。 階層順序：
各 children[ ] ノードは、異なる建物レベル/階層を反映します。
データタイプ：オブジェクトのアレイ |
| result.buildingsTreeData.children | 予約可能モジュールに関連付けられているサイト、敷地、または建物の詳細。すべての 子[ ] ノードの各パラメーターは同じです。これらは異なる建物エンティティにのみ適用され、このセクションでは 1 回のみ説明されます。データタイプ：オブジェクトのアレイ |
| result.buildingsTreeData.children.data | 建物エンティティの詳細。 データタイプ：オブジェクト |
| result.buildingsTreeData.children.data.sys_id | 関連付けられた建物エンティティの sys_id。 データタイプ：文字列 |
| result.buildingsTreeData.children.data.table | sys_id で識別される建物エンティティレコードが配置されているテーブルの名前。 データタイプ：文字列 |
| result.buildingsTreeData.children.data.timezone | 建物エンティティのタイムゾーンに関する詳細。 |
| result.buildingsTreeData.children.data.timezone.displayValue | タイムゾーンのレコードの表示値。 データタイプ：文字列 |
| result.buildingsTreeData.children.data.timezone.value | タイムゾーンのレコードの内部値。 データタイプ：文字列 |
| result.buildingsTreeData.children.isSelectable | 関連する建物エンティティが予約可能モデルで利用可能 (選択可能) かどうかを示すフラグ。 有効な値：
データタイプ：ブーリアン |
| result.buildingsTreeData.children.isValid | 関連する建物エンティティが予約可能モデルで有効かどうかを示すフラグ。 有効な値：
データタイプ：ブーリアン |
| result.buildingsTreeData.children.label | 建物エンティティの名前。 データタイプ：文字列 |
| result.buildingsTreeData.children.uId | 関連付けられた建物エンティティレコードの sys_id。 データタイプ：文字列 |
| result.buildingSysIds | 予約可能モジュールに関連付けられた建物の sys_id のリスト。 データタイプ：文字列のアレイ |
| result.checkin_before_minutes | ユーザーが予約にチェックインできる予約開始前の時間。 単位：分 データタイプ：数値 |
| result.display_number_of_attendees | ユーザーが予約の出席者の数を指定できるかどうかを示すフラグ。 有効な値：
データタイプ：ブーリアン |
| result.display_on_behalf_of | 他のユーザーの代わりに予約できるかどうかを示すフラグ。 有効な値：
データタイプ：ブール |
| result.display_sensitivity | ユーザーが、normal、private などの予約の機密性を設定できるかどうかを示すフラグ。 有効な値：
データタイプ：ブール |
| result.display_value | 予約可能モジュールの表示値。 データタイプ：文字列 |
| result.enable_browse_by_area | ユーザーがエリア別に予約可能モジュールを検索できるかどうかを示すフラグ。browse_by_area_enabled と同じです。 有効な値：
データタイプ：ブーリアン |
| result.enable_browse_by_neighborhood | ユーザーが近隣で予約可能モジュールを検索できるかどうかを示すフラグ。 有効な値：
データタイプ：ブーリアン |
| result.enable_browse_near_a_person | ユーザーが特定のユーザーによって配置された予約可能モジュールを検索できるかどうかを示すフラグ。 browse_near_a_person_enabled と同じです。 有効な値：
データタイプ：ブーリアン |
| result.enable_facet_filter | 職場アイテムのファセットフィルタリングが有効かどうかを示すフラグ。有効にすると、表示されるフィルターオプションは検索結果に基づきます。ユーザーは、生成された検索結果で使用可能なアイテムのみをフィルターで選択できます。 有効な値：
データタイプ：ブーリアン |
| result.enable_group_reservations | ユーザーがグループ予約できるかどうかを示すフラグ。 有効な値：
データタイプ：ブール |
| result.enable_ical_generation | ユーザーが予約の iCalendar を生成できるかどうかを示すフラグ。 有効な値：
データタイプ：ブーリアン |
| result.font_awesome_icon | 予約可能モジュールに添付されているフォントアイコンの名前。 データタイプ：文字列 |
| result.inline_title | 予約可能モジュールのインラインタイトル。タイトルは、職場サービスポータルの説明テキストとともインラインに表示されます。 データタイプ：文字列 |
| result.layout_mapping | 場所のレイアウトマッピングの構造に関する詳細。このデータを使用して、UI に情報をレイアウトします。 データタイプ: オブジェクト |
| result.layout_mapping.body | フロントエンド UI データをマッピングするためのプレースホルダー。 データタイプ：オブジェクトのアレイ |
| 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_enabledtrue に設定され、パラメーターが neighborhood クエリパラメーターに渡された場合にのみ返されます。 予約可能モジュールに関連付けられ、近隣に構成された建物のsys_idsのリスト。 データタイプ：文字列のアレイ |
| result.nbhBuildingsData | スペース管理プラグインがインストールされ、パラメーターが browse_by_neighborhood_enabledtrue に設定され、パラメーターが neighborhood クエリパラメーターに渡された場合にのみ返されます。 予約可能モジュールに関連付けられ、近隣に構成された建物のsys_idsのリスト。各建物要素には、建物で利用可能な対応するフロアsys_idsのリストも含まれています。 たとえば、次のようになります。 建物sys_idsに関連付けられたレコードは、建物 [sn_wsd_core_building] テーブルにあります。フロアsys_idsに関連付けられたレコードは、フロア [sn_wsd_core_floor] テーブルにあります。 データタイプ：オブジェクトのアレイ |
| result.nbhBuildingsTreeData | スペース管理プラグインがインストールされ、パラメーターが browse_by_neighborhood_enabledtrue に設定され、パラメーターが neighborhood クエリパラメーターに渡された場合にのみ返されます。 予約可能モジュールと近隣に関連付けられた建物の階層。 データタイプ：オブジェクトのアレイ 階層順序：
|
| result.nbhBuildingsTreeData.children | 建物に関連付けられている子の階層について説明します。 各 children[] ノードは、異なる建物レベル/階層を反映します。
データタイプ：アレイ
|
| result.nbhBuildingsTreeData.data | 関連付けられたエンティティに関する詳細。地域、サイト、敷地、または建物。 データタイプ: オブジェクト |
| result.nbhBuildingsTreeData.data.sysId | 関連付けられたエンティティレコードのSys_id。 データタイプ：文字列 |
| result.nbhBuildingsTreeData.data.table | 関連レコードが配置されているテーブル。 データタイプ：文字列 |
| result.nbhBuildingsTreeData.data.timezone | 関連付けられたエンティティが存在するタイムゾーンに関する情報。 データタイプ: オブジェクト |
| result.nbhBuildingsTreeData.data.timezone.displayValue | ユーザーインターフェイスで使用するタイムゾーン値。 データタイプ：文字列 |
| result.nbhBuildingsTreeData.data.timezone.value | 内部タイムゾーン値。 データタイプ：文字列 |
| result.nbhBuildingsTreeData.isSelectable | 関連エンティティが予約可能モデルで利用可能 (選択可能) かどうかを示すフラグ。 有効な値：
データタイプ：ブーリアン |
| result.nbhBuildingsTreeData.isValid | 関連付けられたエンティティが予約可能モデルに対して有効かどうかを示すフラグ。 有効な値：
データタイプ：ブーリアン |
| result.nbhBuildingsTreeData.label | 予約可能なビューの名前。 データタイプ：文字列 |
| result.nbhBuildingsTreeData.uId | 関連付けられたエンティティのSys_id。 データタイプ：文字列 |
| result.override_approval_policy | 承認ポリシーの実装方法を指定するオプション。選択肢は次のとおりです。
データタイプ：文字列 |
| result.require_cancel_notes | 予約可能モジュールをキャンセルする前にユーザーがキャンセルメモを入力する必要があるかどうかを示すフラグ。 有効な値：
データタイプ：ブール |
| result.require_cc_dept_check | ワークスペースアイテムとログインユーザーの間でコストセンターまたは部門の不一致があるかどうかを確認するかどうかを示すフラグ。 有効な値：
データタイプ：ブーリアン |
| result.require_subject | 予約時にユーザーが件名を入力する必要があるかどうかを示すフラグ。 有効な値：
データタイプ：ブーリアン |
| result.reservable_columns | 予約可能項目の列のリスト。職場の場所 [sn_wsd_core_workplace_location] テーブルにあります。 データタイプ：アレイ |
| result.reservable_container_field | 特定のエリアのデスクのグループなどのコンテナーのレベル。 データタイプ：文字列 |
| result.reservable_filter | 関連付けられた予約可能テーブルの予約可能アイテムのフィルタリングに使用されるフィルター条件。予約可能テーブルは、予約可能なモジュール [sn_wsd_rsv_reservable_module] テーブル内のフィールドです。これらのフィルター条件は、フィールドの予約可能テーブルに含まれるテーブルに適用されました。 データタイプ：文字列 |
| result.reservable_quantity_field | すべてのスペースの予約可能な数量。数は、エリアに近隣スペースをアサインするときに使用されます。詳細については、「 エリアへの近隣スペースの割り当て」をご参照ください。 データタイプ：文字列 |
| result.reservable_table | 予約可能な職場アイテムを含むテーブル。 データタイプ：文字列 |
| result.reservable_type | 予約可能アイテムのタイプ (場所など)。 データタイプ：文字列 |
| result.reservable_views | カードビューやスケジュールビューなど、予約可能モジュールに関連付けられたさまざまなビューに関する詳細。 予約可能なビュー [sn_wsd_rsv_reservable_module] テーブルにあります。 データタイプ：オブジェクト |
| result.reservable_views.iconClass | 予約可能なビューのアイコンクラス。 データタイプ：文字列 |
| result.reservable_views.isDefault | この予約可能なビューを予約可能なモジュールのデフォルトにするかどうかを示すフラグ。 有効な値：
データタイプ：ブーリアン |
| result.reservable_views.label | 予約可能なビューの名前。 データタイプ：文字列 |
| result.reservable_views.order | UI の予約可能モジュールのビューが表示される順序。UI では小さい順序番号が先に表示されます。同じ順序番号の場合は、ランダムな順序が割り当てられます。 データタイプ：数値 |
| result.reservable_views.type | 予約可能なビューのバックエンド名。内部処理に使用されます。 データタイプ：文字列 |
| result.reservation_paths | [すべて参照]、 [人の近くで参照する] などの予約可能なモジュールに関連付けられた予約パス。 データタイプ：オブジェクトのアレイ |
| 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 | この予約可能なモジュールのマップビューを有効にするかどうかを示すフラグ。 有効な値：
データタイプ：ブーリアン |
| result.sys_id | 予約可能モジュールの sys_id。 データタイプ：文字列 |
| result.timeSlots | 予約可能モジュールに関連付けられたタイムスロットの詳細。 データタイプ：オブジェクトのアレイ |
| 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 | 予約可能モジュールに関連付けられている仮想プロバイダーの詳細。 データタイプ：オブジェクト |
| result.virtual_meeting_provider.display_value | バーチャル会議プロバイダーの表示値。 データタイプ：文字列 |
| result.virtual_meeting_provider.sys_id | バーチャル会議プロバイダーの sys_id。 データタイプ：文字列 |
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"
}
}