---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference
Release :
- australia
ft:locale :
- ko-KR
ft:publication_title :
- 호주 API 참조
ft:clusterId :
- crapiref
bundleId :
- crapiref
workflow :
- Creator
---
# WSD 예약 가능한 모듈 API
# WSD 예약 가능한 모듈 API {#ariaid-title1}
* 릴리스 버전: Australia
*
* 업데이트 날짜 2026년 03월 12일
*
*  소요 시간: 36분
워크플레이스 서비스 제공 (WSD) 예약 가능한 모듈 API는 인스턴스에서 예약 가능한 모듈의 상세 정보를 검색할 수 있는 엔드포인트를 ServiceNow 제공합니다.
예약 가능한 모듈은 유사한 유형의 직장 항목을 그룹화합니다. 직원은 이러한 유사한 항목을 단일 범주에서 볼 수 있습니다. 예를 들어 회의실은 예약 가능한 모듈이며 회의실, 회의실 및 기타 회의실과 같은 유사한 직장 항목을 포함합니다.
이 API에 액세스하려면 호출자에게 sn_wsd_core.workplace_user 역할이 있어야 하며 워크플레이스 예약 관리(sn_wsd_rsv) 플러그인이 활성화되어 있어야 합니다. 이 API는 `sn_wsd_rsv` 네임스페이스에서 실행됩니다.
에 대한 워크플레이스 예약 관리자세한 내용은 다음 문서를 참조하십시오 [Workplace Reservation Management](https://www.servicenow.com/docs/access?context=workplace-rsv-mgmt-feat&version=australia&pubname=australia-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}
주:
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.
### 지원되는 요청 매개변수
{#wsd_resv_mod-GET-reserv_mod__entry__2}{#wsd_resv_mod-GET-reserv_mod__version-not_optional-RESTAPI}
| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| sys_id | 검색할 가역 모듈 레코드의 Sys_id입니다. 데이터 유형: 문자열 테이블: 예약 가능한 모듈 \[sn_wsd_rsv_reservable_module\] |
[표 1. 경로 매개변수]
{#wsd_resv_mod-GET-reserv_mod__entry__8}
| 이름 | 설명 |
|-|-|
| is_buildings_tree_data_required | 예약 가능한 모델과 연결된 건물 데이터를 반환할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 건물 데이터를 반환합니다. * false: 건물 데이터를 반환하지 않습니다. 데이터 유형: 부울 기본값: false |
| 인접 | sn_wsd_spc_mgmt_neighborhood(공간 관리) 플러그인이 활성화된 경우에만 사용할 수 있습니다. 인코딩된 쿼리에 사용할 인접 기록의 Sys_id입니다. 인접 공간 예약에 대한 자세한 내용은 다음 문서를 참조하십시오 [Create neighborhood reservations](https://www.servicenow.com/docs/access?context=create-neighborhood-reservations&version=australia&pubname=australia-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/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#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/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#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}
| 이름 | 설명 |
|-|-|
| 결과 | 요청된 예약 가능한 모듈에 대한 상세 정보입니다. 데이터 유형: 객체 { "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 | 사용자가 영역별로 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 예: 사용자가 예약 가능한 모듈을 영역별로 찾아볼 수 있도록 허용합니다. * 아니오: 사용자가 영역별로 예약 가능한 모듈을 찾아볼 수 없습니다. 데이터 유형: 부울 |
| result.browse_by_neighborhood_enabled | 공간 관리 - sn_wsd_spc_mgmt 플러그인이 설치된 경우에만 사용할 수 있습니다. 사용자가 예약 가능한 모듈에서 인접별로 검색할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 사용자가 인접별로 예약 가능한 모듈을 찾아볼 수 있도록 허용합니다. * 아니오: 사용자가 인접별로 예약 가능한 모듈을 찾아볼 수 없습니다. 데이터 유형: 부울 |
| result.browse_near_a_person_enabled | 사용자가 지정된 사람이 찾은 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 사용자가 사람 근처에서 예약 가능한 모듈을 탐색할 수 있도록 허용합니다. * false: 사용자가 사람 근처에서 예약 가능한 모듈을 탐색할 수 없습니다. 데이터 유형: 부울 |
| result.buildingTreeData | 쿼리 매개변수가 is_buildings_tree_data_requiredtrue로 설정된 경우에만 반환됩니다. 예약 가능한 모듈과 연결된 건물의 계층 구조입니다. 계층 구조 순서: * 지역: 지역 \[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.children: 건물 데이터 유형: 객체 배열 "buildingsTreeData": [ { "children": [Array], "data": {Object}, "isSelectable": Boolean, "isValid": Boolean, "label": "String", "uId": "String" } ] |
| result.buildingsTreeData.children | 예약 가능한 모듈과 연결된 사이트, 캠퍼스 또는 건물에 대한 상세 정보입니다. 모든 `children[ ]` 노드의 각 매개변수는 동일합니다. 이는 다른 건물 엔터티에만 적용되며 이 섹션에서는 한 번만 설명합니다. 데이터 유형: 객체 배열 "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 | 연결된 건물 엔터티가 예약 가능한 모델에 유효한지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 예: 건물 엔터티가 예약 가능한 모듈에 유효합니다. * false: 건물 엔터티가 예약 가능한 모듈에 유효하지 않습니다. 데이터 유형: 부울 |
| result.buildingsTreeData.children.label | 건물 엔터티의 이름입니다. 데이터 유형: 문자열 |
| result.buildingsTreeData.children.uId | 연결된 건물 엔터티 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| result.buildingSysIds | 예약 가능한 모듈과 연결된 건물 sys_ids 목록입니다. 데이터 유형: 문자열 배열 |
| result.checkin_before_minutes | 예약이 시작되기 전 사용자가 예약을 체크인할 수 있는 시간입니다. 단위: 분 데이터 유형: 숫자 |
| result.display_number_of_attendees | 사용자가 예약 참석자 수를 지정할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 사용자가 참석자 수를 지정할 수 있습니다. * false: 사용자가 표시 참석자 수를 지정할 수 없습니다. 데이터 유형: 부울 |
| result.display_on_behalf_of | 다른 사람을 대신하여 예약할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 지원됨을 대신합니다. * false: 지원되지 않는 대신 데이터 유형: 부울 |
| result.display_sensitivity | 사용자가 예약의 민감도(예: 일반 또는 비공개)를 설정할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 민감도를 설정할 수 있습니다. * 아니오: 민감도를 설정할 수 없습니다. 기본값은 일반입니다. 데이터 유형: 부울 |
| result.display_value | 예약 가능한 모듈의 표시 값입니다. 데이터 유형: 문자열 |
| result.enable_browse_by_area | 사용자가 영역별로 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다. 와 동일합니다.browse_by_area_enabled 유효한 값은 다음과 같습니다. * 예: 사용자가 예약 가능한 모듈을 영역별로 찾아볼 수 있도록 허용합니다. * 아니오: 사용자가 영역별로 예약 가능한 모듈을 찾아볼 수 없습니다. {#wsd_resv_mod-GET-reserv_mod__ul_unz_q1r_stb} 데이터 유형: 부울 |
| result.enable_browse_by_neighborhood | 사용자가 인접별로 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 사용자가 인접별로 예약 가능한 모듈을 찾아볼 수 있도록 허용합니다. * 아니오: 사용자가 인접별로 예약 가능한 모듈을 찾아볼 수 없습니다. 데이터 유형: 부울 |
| 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 작성이 허용됩니다. * 아니오: 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_일수 | 사용자가 예약 가능한 모듈을 예약할 수 있는 향후 최대 일수입니다. 데이터 유형: 숫자 |
| result.max_발생 | 예약 가능한 모듈에 대해 반복 예약을 사용할 수 있는 경우의 최대 반복 예약 발생 횟수입니다. 데이터 유형: 숫자 |
| result.name | 예약 가능한 모듈의 이름입니다. 데이터 유형: 문자열 |
| result.nbhBuildingIds | 공간 관리 플러그인이 설치되어 있고, 매개변수가 browse_by_neighborhood_enabledtrue로 설정되고, 매개변수가 neighborhood 쿼리 매개변수에 전달된 경우에만 반환됩니다. 예약 가능한 모듈과 연결되어 있고 인접에 대해 구성된 건물의 sys_ids 목록입니다. 데이터 유형: 문자열 배열 |
| result.nbhBuildingsData | 공간 관리 플러그인이 설치되어 있고, 매개변수가 browse_by_neighborhood_enabledtrue로 설정되고, 매개변수가 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_enabledtrue로 설정되고, 매개변수가 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": [ { "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 | 승인 정책을 구현하는 방법을 지정하는 옵션입니다. 선택: * 재정의 없음: 승인 정책은 직장 공간 또는 회의실의 승인 필요 필드에 설정된 대로 구현됩니다. * 항상 승인 필요: 직장 공간 또는 회의실의 승인 필요 필드에 설정된 내용에 관계없이 승인 정책이 필요합니다. * 승인 필요 없음: 직장 공간 또는 회의실의 승인 필요l 필드에 설정된 내용에 관계없이 승인 정책이 제거됩니다. {#wsd_resv_mod-GET-reserv_mod__ul_uhm_lpk_rcc} 데이터 유형: 문자열 |
| 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=australia&pubname=australia-employee-service-management&ft:locale=en-US)을 참고하십시오. 데이터 유형: 문자열 |
| result.reservable_table | 예약 가능한 직장 항목이 포함된 테이블입니다. 데이터 유형: 문자열 |
| result.reservable_type | 위치와 같은 예약 가능한 항목의 유형입니다. 데이터 유형: 문자열 |
| result.reservable_views | 카드 뷰 또는 일정 뷰와 같이 예약 가능한 모듈과 연결된 여러 뷰에 대한 상세 정보입니다. 데이터 유형: 객체 "reservable_views": { "iconClass": "String", "isDefault": Boolean, "label": "String", "order": Number, "type": "String" } 테이블: 예약 가능한 뷰 \[sn_wsd_rsv_reservable_view\] |
| result.reservable_views.iconClass | 예약 가능한 뷰의 아이콘 클래스입니다. 데이터 유형: 문자열 |
| result.reservable_views.is기본값 | 이 예약 가능한 뷰를 예약 가능한 모듈의 기본값으로 설정할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 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.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"
}
}