WSD 정기 예약 API
워크플레이스 서비스 제공 (WSD) 반복 예약 API는 동시에 발생하지만 날짜가 다른 예약을 관리하기 위한 엔드포인트를 제공합니다.
이 API에 액세스하려면 호출자에게 sn_wsd_core.workplace_user 역할이 있어야 하며 워크플레이스 안전 관리(sn_wsd_core) 및 워크플레이스 예약 관리(sn_wsd_rsv) 플러그인이 활성화되어 있어야 합니다.
이 API는 sn_wsd_rsv 네임스페이스에서 실행됩니다.
에 대한 워크플레이스 예약 관리자세한 내용은 워크플레이스 예약 관리를 참조하십시오.
WSD 정기 예약 - GET /api/sn_wsd_rsv/recurring_reservation/list/{parent_id}
지정된 반복 예약을 반환합니다.
예약에 6개 이상의 반복 회의 발생이 가능한 경우 쿼리 매개변수를 사용하여 발생한 항목을 페이지 매김할 수 있습니다. 반환하지 않도록 발생 기록을 지정할 수도 있습니다.
URL 형식
버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/recurring_reservation/list/{parent_id}
기본 URL: /api/sn_wsd_rsv/recurring_reservation/list/{parent_id}
지원되는 요청 매개변수
| 이름 | 설명 |
|---|---|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| parent_id | 반복 상위 예약 기록의 Sys_id입니다. 반복 예약이 생성되면 하나의 반복 상위 기록과 하나 이상의 하위 예약 기록이 생성됩니다. 예약 기록에는 예약 기록의 유형을 나타내는 reservation_subtype라는 필드가 있습니다. 반복되는 상위 기록의 경우 이 필드는 "되풀이 상위 항목"으로 설정됩니다. 하위 기록의 경우 이 필드는 "발생"으로 설정됩니다. 하위 기록 내에서 연결된 반복 상위 기록의 sys_id은 source_reservation 필드에 있습니다. 데이터 유형: 문자열 테이블: 직장 예약 [sn_wsd_rsv_reservation] |
| 이름 | 설명 |
|---|---|
| end_index | 반복 기록 세트를 통해 페이지 매김할 때 발생 기록 반환을 중지할 0부터 시작하는 기록 번호입니다. 주: 반복 발생 횟수가 6개 미만이면 엔드포인트는 모든 발생을 반환하고, 그렇지 않으면 처음 6개 항목을 반환합니다. 6회를 초과하는 발생을 검색하려면 그에 따라 end_index 매개변수를 전달해야 합니다. 데이터 유형: 숫자 |
| occurrence_sys_id | 반복 계열의 발생 기록이 반환되지 않는 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 예약 [sn_wsd_rsv_reservation] |
| start_index | 반복 기록 세트를 페이지 매김할 때 발생 기록 반환을 시작할 0부터 시작하는 기록 번호입니다. 데이터 유형: 숫자 기본값: 0 |
| 이름 | 설명 |
|---|---|
| 안 함 |
헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.
| 머리글 | 설명 |
|---|---|
| 수용 | 요청 본문의 데이터 형식입니다. 지원되는 유형: application/json, 또 application/xml 는, text/xml. 기본값: application/json |
| 머리글 | 설명 |
|---|---|
| 안 함 |
상태 코드
이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.
| 상태 코드 | 설명 |
|---|---|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
응답 본문 매개변수
| 이름 | 설명 |
|---|---|
| 결과 | 요청된 반복 예약에 대한 결과를 반환합니다. 데이터 유형: 객체 |
| result.occurencesTotalCount | 반복 계열의 총 회의 발생 횟수입니다. 데이터 유형: 문자열 |
| 결과.예약 | 요청된 반복 예약에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.active | 예약이 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| 결과.예약.참석자 | 예약 참석자 목록입니다. 데이터 유형: 객체 배열 |
| 결과.예약.참석자.아바타 | 참석자와 연결된 아바타의 Sys_id입니다. 데이터 유형: 문자열 테이블: 첨부 파일 [sys_attachment] |
| result.reservation.attendees.displayValue | 참석자에 대한 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.attendees.display_value | 참석자의 값을 표시합니다. 와 동일합니다.displayValue 데이터 유형: 문자열 |
| result.reservation.attendees.email | 참석자의 이메일 주소입니다. 데이터 유형: 문자열 |
| result.reservation.attendees.initials | 참석자의 이니셜입니다. 데이터 유형: 문자열 |
| result.reservation.attendees.name | 참석자 이름입니다. 데이터 유형: 문자열 |
| result.reservation.attendees.sys_id | 참석자 기록의 Sys_id입니다. 데이터 유형: 문자열 |
| result.reservation.attendees.table | 참석자 기록이 있는 테이블입니다. 데이터 유형: 문자열 |
| result.reservation.attendees.user_name | 참석자의 사용자 이름입니다. 데이터 유형: 문자열 |
| 결과.예약.참석자.값 | 참석자의 내부 값입니다. 데이터 유형: 문자열 |
| result.reservation.check_in_state | 예약의 체크인 상태에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.check_in_state.display_value | 예약의 현재 체크인 상태에 대한 값을 표시합니다(예: 진행 중 또는 완료). 데이터 유형: 문자열 |
| result.reservation.check_in_state.value | 예약의 현재 체크인 상태에 대한 내부 값입니다(예: 2). 데이터 유형: 문자열 |
| result.reservation.edit_restriction | 예약에 대한 사용자 편집 제한(예: no_restrictions, service_only 또는 fully_restricted)에 대한 설명입니다. 데이터 유형: 객체 |
| result.reservation.edit_restriction.display_value | 예약에 대한 편집 제한에 대한 값(예: 제한 없음)을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.edit_restriction.value | 예약에 대한 편집 제한의 내부 값입니다( 예: no_restriction). 데이터 유형: 문자열 |
| 결과.예약.종료 | 예약 종료 날짜 및 시간입니다. 데이터 유형: 문자열 형식: UTC: yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z) |
| result.reservation.external_ical | 예약에 대한 고유한 외부 iCalendar ID입니다. 달력 동기화 관련 예약인 경우 이 값을 사용하여 예약을 식별합니다. 데이터 유형: 문자열 |
| result.reservation.external_id | 예약의 고유 외부 ID입니다. 달력 동기화 관련 예약인 경우 이 값을 사용하여 예약을 식별합니다. 데이터 유형: 문자열 |
| result.reservation.is_parent | 이 예약이 상위 예약인지 여부를 나타내는 플래그입니다. 가능한 값:
데이터 유형: 부울 |
| result.reservation.last_updated_sub_source | 예약에 대해 마지막으로 업데이트된 하위 소스에 대한 상세 정보입니다. 하위 소스는 예약을 외부 달력과 통합할 때 사용됩니다. 이 객체에는 "servicenow_workplace_service_delivery", "google_calendar" 또는 "microsoft_exchange"과 같은 정보가 포함됩니다. 데이터 유형: 객체 |
| result.reservation.last_updated_sub_source.display_value | 마지막으로 업데이트된 예약의 하위 소스에 대한 값( 예: ServiceNow 워크플레이스 서비스 제공 또는 Google 달력)을 표시합니다. 예약을 Google 달력 또는 Microsoft Outlook과 같은 외부 서비스와 통합할 때 사용됩니다. 데이터 유형: 문자열 |
| result.reservation.last_updated_sub_source.값 | 예약의 마지막 업데이트된 하위 소스에 대한 내부 값입니다( 예: servicenow_workplace_service_delivery 또는 google_calendar). 예약을 Google 달력 또는 Microsoft Outlook과 같은 외부 서비스와 통합할 때 사용됩니다. 데이터 유형: 문자열 |
| 결과.예약.위치 | 예약과 관련된 위치에 대한 상세 정보입니다. 데이터 유형: 객체 |
| 결과.예약.위치.영역 | 위치와 연결된 영역에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.area.active | 영역이 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.location.area.display_value | 책상 A2와 같이 이 위치가 속한 영역의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.location.area.sys_id | 이 위치가 속한 영역의 Sys_id입니다. 데이터 유형: 문자열 테이블: 영역 [sn_wsd_core_area] |
| 결과.예약.위치.건물 | 위치와 연결된 건물에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.building.active | 건물이 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.location.building.display_value | 이 위치가 속한 건물의 값을 표시합니다(예: AMS - Bld1). 데이터 유형: 문자열 |
| result.reservation.location.building.sys_id | 이 위치가 속한 건물의 Sys_id입니다. 데이터 유형: 문자열 테이블: 건물 [sn_wsd_core_building] |
| 결과.예약.위치.건물.시간대 | 건물의 표준 시간대에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.building.timezone.display_value | 관련된 건물이 위치한 시간대의 값을 표시합니다. 데이터 유형: 문자열 |
| 결과.예약.위치.건물.시간대.값 | 이 위치가 속한 시간대의 내부 값입니다. 데이터 유형: 문자열 |
| 결과.예약.위치.캠퍼스 | 위치와 연결된 캠퍼스에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.campus.active | 캠퍼스가 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.location.campus.display_value | 암스테르담 캠퍼스와 같이 이 위치가 속한 캠퍼스의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.location.campus.sys_id | 이 위치가 속한 캠퍼스의 Sys_id입니다. 데이터 유형: 문자열 테이블: 캠퍼스 [sn_wsd_core_campus] |
| 결과.예약.위치.용량 | 위치의 최대 거주 수입니다. 데이터 유형: 숫자 |
| 결과.예약.위치.설명 | 위치에 대한 간략한 설명입니다. 데이터 유형: 문자열 |
| result.reservation.location.display_value | 이 위치에 대해 UI에 표시할 값입니다. 데이터 유형: 문자열 |
| result.reservation.location.email | 위치의 이메일 주소입니다. 데이터 유형: 문자열 |
| 결과.예약.위치.층 | 위치와 연결된 층에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.floor.active | 층이 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.location.floor.display_value | 이 위치가 속한 층의 값을 표시합니다(예: 1층). 데이터 유형: 문자열 |
| result.reservation.location.floor.sys_id | 이 위치가 속한 층의 Sys_id입니다. 데이터 유형: 문자열 테이블: 층 [sn_wsd_core_floor] |
| result.reservation.location.label_value | 매개변수에 name 지정된 값의 유형입니다(예: 방 이름). 데이터 유형: 문자열 |
| result.reservation.location.name | 위치 이름입니다. 데이터 유형: 문자열 |
| 결과.예약.위치.번호 | 예약 번호입니다. 데이터 유형: 문자열 |
| result.reservation.location.number_of_attendees | 예약 참석자 수입니다. 데이터 유형: 숫자 |
| result.reservation.location.reservable_module | 예약과 관련된 예약 가능한 모듈에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.reservable_module.inline_title | 예약 가능한 모듈의 인라인 제목입니다. 제목은 직장 서비스 포털의 설명 텍스트와 함께 나타납니다. 데이터 유형: 문자열 |
| result.reservation.location.reservable_module.이름 | 예약 가능한 모듈의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.location.reservable_module.sys_id | 예약 가능한 모듈의 Sys_id입니다. 데이터 유형: 문자열 |
| result.reservation.location.reservable_module.타이틀 | 예약 가능한 모듈의 제목입니다. 데이터 유형: 문자열 |
| 결과.예약.위치.지역 | 위치와 연결된 지역에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.region.active | 지역이 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.location.region.display_value | 이 위치가 속한 지역의 값을 표시합니다(예: 유럽). 데이터 유형: 문자열 |
| result.reservation.location.region.sys_id | 이 위치가 속한 지역의 Sys_id입니다. 데이터 유형: 문자열 테이블: 지역 [sn_wsd_core_region] |
| 결과.예약.위치.예약 | 위치와 관련된 예약에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.reservation.active | 예약이 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| 결과.예약.위치.예약.번호 | 예약 번호입니다. 데이터 유형: 문자열 |
| result.reservation.location.reservation.number_of_attendees | 예약 참석자 수입니다. 데이터 유형: 숫자 |
| result.reservation.location.reservation.requested_for | 예약을 대신하여 요청한 사람에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.reservation.requested_for.name | 예약이 요청된 사용자의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.location.reservation.requested_for.sys_id | 요청 대상 사용자의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사용자 [sys_user] |
| result.reservation.location.reservation.requested_for.user_name | 예약이 요청된 사용자의 사용자 이름입니다. 데이터 유형: 문자열 |
| 결과.예약.위치.예약.상태 | 해당 위치의 예약 상태에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.reservation..state.display_value | 예약의 현재 상태에 대한 값(예: 확인됨)을 표시합니다. 데이터 유형: 문자열 |
| 결과.예약.위치.예약..상태.값 | 예약의 현재 상태에 대한 내부 값입니다(예: 2). 데이터 유형: 문자열 |
| result.reservation.location.site | 위치가 속한 사이트입니다. 데이터 유형: 객체 테이블: 사이트 [sn_wsd_core_site] |
| result.reservation.location.site.active | 사이트가 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.location.site.display_value | 이 위치가 속한 사이트의 값을 표시합니다(예: 서유럽). 데이터 유형: 문자열 |
| result.reservation.location.site.sys_id | 이 위치가 속한 사이트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사이트 [sn_wsd_core_site] |
| result.reservation.location.standard_services | 사용 가능한 표준 서비스입니다. 데이터 유형: 문자열 |
| 결과.예약.위치.상태 | 해당 위치의 예약 상태에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.location.state.display_value | 예약의 현재 상태에 대한 값(예: 확인됨)을 표시합니다. 데이터 유형: 문자열 |
| 결과.예약.위치.상태.값 | 예약의 현재 상태에 대한 내부 값입니다(예: 2). 데이터 유형: 문자열 |
| result.reservation.location.sys_id | 연결된 위치 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 위치 [sn_wsd_core_workplace_location] |
| result.reservation.notification_custom_message | 에 나열된 수신자에게 전송되는 알림에 대한 사용자 지정 메시지입니다.reservation.notification_recipients 데이터 유형: 문자열 |
| result.reservation.notification_recipients | 예약에 대한 알림을 받는 수신자 목록입니다. 데이터 유형: 객체 배열 |
| result.reservation.notification_recipients.name | 수신자 이름입니다. 데이터 유형: 문자열 |
| result.reservation.notification_recipients.sys_id | 수신자의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사용자 [sys_user] |
| result.reservation.notification_recipients.user_name | 수신자의 사용자 이름입니다. 데이터 유형: 문자열 |
| 결과.예약.번호 | 예약 기록의 고유 번호입니다. 이 값을 사용하여 예약을 쿼리할 수 있습니다. 데이터 유형: 문자열 테이블: 직장 예약 [sn_wsd_rsv_reservation] |
| result.reservation.number_of_attendees | 이 예약의 참석자 수입니다. 데이터 유형: 숫자 |
| result.reservation.opened_by | 예약을 생성한 사용자에 대한 세부 정보입니다. 데이터 유형: 객체 |
| result.reservation.opened_by.avatar | 예약을 연 사용자의 아바타입니다. 데이터 유형: 문자열 |
| result.reservation.opened_by.displayValue | 사용자가 연 값의 표시 값입니다. 데이터 유형: 문자열 |
| result.reservation.opened_by.display_value | 사용자가 연 값의 표시 값입니다. 데이터 유형: 문자열 |
| result.reservation.opened_by.email | 예약을 연 사용자의 이메일 주소입니다. 데이터 유형: 문자열 |
| result.reservation.opened_by.initials | 예약을 연 사용자의 이니셜입니다. 데이터 유형: 문자열 |
| result.reservation.opened_by.name | 예약을 연 사용자의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.opened_by.user_name | 예약을 연 사용자의 사용자 이름입니다. 데이터 유형: 문자열 |
| result.reservation.opened_by.value | 예약을 연 사용자의 내부 값입니다. 데이터 유형: 문자열 |
| result.reservation.recording_details | 예약(회의)과 관련된 기록에 대한 상세 정보입니다. 데이터 유형: 객체 배열 |
| result.reservation.recording_details.recording_url | 예약과 관련된 기록의 URL입니다. 데이터 유형: 문자열 |
| result.reservation.recurring_pattern | 예약의 반복 패턴에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.recurring_pattern.날짜의양 | 예약 가능 항목이 예약되는 날짜 수입니다. 데이터 유형: 문자열 |
| result.reservation.recurring_pattern.duration |
예약 가능한 항목을 예약할 시간입니다.
데이터 유형: 숫자 단위: 초 |
| result.reservation.recurring_pattern.label | 반복 예약에 대한 설명이 포함된 이름입니다. 데이터 유형: 문자열 |
| result.reservation.recurring_pattern.options | 반복 예약과 관련된 옵션에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.recurring_pattern.options입니다.세다 |
패턴을 반복하는 횟수입니다. 데이터 유형: 숫자 |
| result.reservation.recurring_pattern.options입니다.daysOfWeek |
예약 가능한 요일입니다. 유효한 값은 다음과 같습니다.
예를 들어 화요일, 목요일, 금요일을 지정하려면 245(구분 기호 없음)를 전달합니다. repeats is weekly이고, count5이고, daysOfWeek 245이면 반환 결과에서 합계는 데이터 유형: 문자열 |
| result.reservation.recurring_pattern.options입니다.모든 | 패턴 반복 간격입니다. 예를 들어 값 '2'는 속성 값 repeats 에 따라 패턴이 2일 또는 2개월마다 반복됨을 나타냅니다. 주:
이 설정은 매주 반복 간격에는 적용되지 않습니다. 격주 반복 간격으로 속성을 매일로 설정하고 이 값을 14로 설정할 repeats 수 있습니다.데이터 유형: 숫자 기본값: 1 |
| result.reservation.recurring_pattern.options입니다.종료 날짜 | 회의 반복의 종료 날짜 및 시간입니다(예: "2022-07-08T14:00:00Z"). 데이터 유형: 문자열 형식: UTC yyyy-mm-dd hh:mm:ss |
| result.reservation.recurring_pattern.options입니다.endDateGdt | 회의가 반복되는 종료 날짜 및 시간입니다. 데이터 유형: 문자열 형식: GDT(예: "2022-07-08T14:00:00Z") |
| result.reservation.recurring_pattern.repeats |
예약 가능한 반복 패턴입니다. 유효한 값: (대/소문자 구분)
주: 패턴 반복 간격은 속성에 options.every 설정되어 있습니다. 주간 패턴에 대해 유일하게 유효한 반복 간격은 1입니다. 데이터 유형: 문자열 |
| result.reservation.recurring_pattern.startDate |
반복 패턴의 시작 날짜 및 시간입니다(예: "2022-07-08T14:00:00Z").
데이터 유형: 문자열 형식: UTC yyyy-mm-dd hh:mm:ss |
| result.reservation.recurring_pattern.startDateGdt |
반복 패턴의 시작 날짜 및 시간입니다(예: "2022-07-08T14:00:00Z").
데이터 유형: 문자열 형식: UTC yyyy-mm-dd hh:mm:ss |
| result.reservation.requested_for | 예약을 대신한 사용자에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.requested_for.avatar | 예약을 대신하여 이루어진 사용자의 아바타입니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.displayValue | 예약을 대신하여 이루어진 사용자의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.display_value | 예약을 대신하여 이루어진 사용자의 값을 표시합니다. displayValue와 동일합니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.email | 예약을 대신한 사용자의 이메일 주소입니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.initials | 예약을 대신하여 이루어진 사용자의 이니셜입니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.label | 예약을 대신하여 이루어진 사용자의 레이블입니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.name | 예약을 대신하여 이루어진 사용자의 이름입니다. 데이터 유형: 문자열 |
| result.rservation.requested_for.sys_id | Sys_id_of 예약을 대신한 사용자입니다. 데이터 유형: 문자열 테이블: 사용자 [sys_user] |
| result.rservation.requested_for.table | 사용자 기록이 포함된 테이블입니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.user_name | 예약을 대신한 사용자의 사용자 이름입니다. 데이터 유형: 문자열 |
| result.reservation.requested_for.value | 예약을 대신하여 이루어진 사용자의 내부 값입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module | 요청된 예약 가능한 모듈에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.reservable_module.allow_invitees | 직원이 초대 대상자를 예약에 추가할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.allow_whole_day | 사용자가 하루 종일 예약 가능한 항목을 예약할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.apply_to_shift | 예약 가능한 모듈에 대해 교대조 기반 예약이 활성화되어 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.browse_by_area_enabled | 사용자가 영역별로 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.browse_near_a_person_enabled | 사용자가 지정된 사람이 찾은 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.buildingSysIds | 예약 가능한 모듈과 연결된 건물 sys_ids 목록입니다. 데이터 유형: 문자열 배열 |
| result.reservation.reservable_module.checkin_before_minutes | 예약이 시작되기 전 사용자가 예약을 체크인할 수 있는 시간입니다. 단위: 분 데이터 유형: 숫자 |
| result.reservation.reservable_module.display_number_of_attendees | 사용자가 예약 참석자 수를 지정할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.display_on_behalf_of | 다른 사람을 대신하여 예약할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.display_sensitivity | 사용자가 예약의 민감도(예: 일반 또는 비공개)를 설정할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.display_value | 예약 가능한 모듈의 표시 값입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.enable_browse_by_area | 사용자가 영역별로 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다. 와 동일합니다.browse_by_area_enabled 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.enable_browse_near_a_person | 사용자가 지정된 사람이 찾은 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다. 다음과 같습니다. browse_near_a_person_enabled 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.enable_facet_filter | 직장 항목에 대한 패싯 필터링이 활성화되어 있는지 여부를 나타내는 플래그입니다. 활성화하면 검색 결과에 따라 표시되는 필터 옵션이 표시됩니다. 사용자는 생성된 검색 결과에서 사용할 수 있는 항목만 필터에서 선택하여 사용할 수 있습니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.enable_group_reservations | 사용자가 그룹 예약을 할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.enable_ical_generation | 사용자가 예약에 대한 iCalendar를 생성할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.font_awesome_icon | 예약 가능한 모듈에 첨부된 글꼴 아이콘의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.inline_title | 예약 가능한 모듈의 인라인 제목입니다. 제목은 직장 서비스 포털의 설명 텍스트와 함께 나타납니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.layout_mapping | 위치의 레이아웃 매핑 구조에 대한 상세 정보입니다. 이 데이터를 사용하여 UI에 정보를 배치합니다. 데이터 유형: 객체 |
| result.reservation.reservable_module.layout_mapping.body | 프론트엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 객체 배열 |
| result.reservation.reservable_module.layout_mapping.body.field | 프론트엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.layout_mapping.body.field_to_display | 프론트엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.layout_mapping.body.icon | 프론트엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.layout_mapping.body.label | 프론트엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.layout_mapping.description | 프론트엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 레이아웃 매핑에 대한 설명입니다. 데이터 유형: 배열 |
| result.reservation.reservable_module.layout_mapping.이미지 | 프론트엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.layout_mapping.부제목 | 프론트엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 배열 |
| result.reservation.reservable_module.layout_mapping.subtitle_asc | 프론트엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 배열 |
| result.reservation.reservable_module.layout_mapping.title | 프론트엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다. 데이터 유형: 배열 |
| result.reservation.reservable_module.max_days_in_future | 사용자가 예약 가능한 모듈을 예약할 수 있는 향후 최대 일수입니다. 데이터 유형: 숫자 |
| result.reservation.reservable_module.max_occurrences | 예약 가능한 모듈에 대해 반복 예약을 사용할 수 있는 경우의 최대 반복 예약 발생 횟수입니다. 데이터 유형: 숫자 |
| result.reservation.reservable_module.name | 예약 가능한 모듈의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.override_approval_policy | 승인 정책을 구현하는 방법을 지정하는 옵션입니다. 선택:
데이터 유형: 문자열 |
| result.reservation.reservable_module.require_cancel_notes | 예약 가능한 모듈을 취소하기 전에 사용자가 취소 메모를 입력해야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.require_cc_dept_check | 작업 공간 항목과 로그인한 사용자 간에 비용 센터 또는 부서 불일치가 있는지 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.require_subject | 예약 시 사용자가 제목을 입력해야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.reservable_columns | 예약 가능한 열의 목록입니다. 데이터 유형: 배열 테이블: 직장 위치 [sn_wsd_core_workplace_location] |
| result.reservation.reservable_module.reservable_container_field | 특정 영역의 책상 그룹과 같은 컨테이너의 수준입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservable_filter | 연결된 예약 가능한 테이블에서 예약 가능한 항목을 필터링하는 데 사용되는 필터 조건입니다. 예약 가능한 테이블은 예약 가능한 모듈[sn_wsd_rsv_reservable_module] 테이블의 필드입니다. 이러한 필터 조건은 예약 가능한 테이블 필드에 포함된 테이블에 적용되었습니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservable_quantity_field | 모든 공간의 예약 가능한 수량입니다. 이 수량은 지역에 인접 공간을 할당할 때 사용됩니다. 자세한 내용은 영역에 인접 공간 할당을 참고하십시오. 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservable_table | 예약 가능한 직장 항목이 포함된 테이블입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservable_type | 위치와 같은 예약 가능한 항목의 유형입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservable_views | 카드 뷰 또는 일정 뷰와 같이 예약 가능한 모듈과 연결된 여러 뷰에 대한 상세 정보입니다. 데이터 유형: 객체 테이블: 예약 가능한 뷰 [sn_wsd_rsv_reservable_view] |
| result.reservation.reservable_module.reservable_views.icon클래스 | 예약 가능한 뷰의 아이콘 클래스입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservable_views.is기본값 | 이 예약 가능한 뷰를 예약 가능한 모듈의 기본값으로 설정할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.reservable_views.레이블 | 예약 가능한 뷰의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservable_views.order | UI에서 예약 가능한 모듈의 뷰가 표시되는 순서입니다. UI에서는 낮은 순서 숫자가 먼저 옵니다. 주문 번호가 동일한 경우 임의의 순서가 할당됩니다. 데이터 유형: 숫자 |
| result.reservation.reservable_module.reservable_views.유형 | 예약 가능한 뷰의 백엔드 이름입니다. 내부 처리에 사용됩니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservation_paths | 모두 찾아보기, 사람 주변 탐색 등 예약 가능한 모듈과 연결된 예약 경로입니다. 데이터 유형: 객체 배열 |
| result.reservation.reservable_module.reservation_paths.display_value | 예약 경로에 대한 값(예: "사람 주변 탐색")을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.reservation_paths.값 | 예약 경로의 내부 값입니다(예: "browse_near_a_person"). 데이터 유형: 문자열 |
| result.reservation.reservable_module.search_limit | 사용자가 직장 위치를 검색할 때 반환할 최대 검색 결과 수입니다. 데이터 유형: 숫자 |
| result.reservation.reservable_module.selection_type | 검색 결과에 표시할 선택 항목의 유형입니다. 다음 옵션 중 하나일 수 있습니다.
데이터 유형: 문자열 |
| result.reservation.reservable_module.short_description | 예약 가능한 모듈에 대한 간략한 설명입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.show_map_view | 예약 가능한 모듈에 대해 맵 뷰를 사용할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservable_module.sys_id | 예약 가능한 모듈의 Sys_id입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.timeSlots | 예약 가능한 모듈에 연결된 시간 슬롯에 대한 상세 정보입니다. 데이터 유형: 객체 배열 |
| result.reservation.reservable_module.timeSlots.name | 시간 슬롯의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.timeSlots.short_description | 시간 슬롯에 대한 간략한 설명입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.timeSlots.slot_end | 시간 슬롯의 종료 시간입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.timeSlots.slot_start | 슬롯의 시작 시간입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.timeSlots.sys_id | 시간 슬롯 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 시간 슬롯 [sn_wsd_rsv_time_slot] |
| result.reservation.reservable_module.title | 예약 가능한 모듈의 제목입니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.virtual_meeting_provider | 예약 가능한 모듈과 연결된 가상 제공자에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.reservable_module.virtual_meeting_provider.display_value | 가상 회의 제공자의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.reservable_module.virtual_meeting_provider.sys_id | 가상 회의 제공자의 Sys_id입니다. 데이터 유형: 문자열 |
| result.reservation.reservationAcl. | 연결된 예약에 설정된 사용자 접근 제어 수준(ACL) 검사에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.reservationAcl.read | 사용자가 이 예약을 읽을 수 있는지 확인할지 여부를 표시하는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservationAcl.write | 연결된 예약에 대한 사용자의 쓰기 기능에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.reservationAcl.write.allFields | 사용자가 객체에 지정된 reservationACL.write.fields 모든 필드에 쓸 수 있는지 확인할지 여부를 나타내는 플래그입니다. 사용자가 일부 특정 필드에만 액세스할 수 있는 경우 해당 필드만 객체에서 reservationACL.write.fields true입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservationAcl.write.fields | 예약의 다양한 필드에 대한 접근 통제에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.reservationAcl.write.fields.location | 사용자가 이 예약의 위치 필드에 쓸 수 있는지 확인할지 여부를 표시하는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservationAcl.write.fields.number_of_attendees | 사용자가 이 예약의 참석자 수 필드에 쓸 수 있는지 확인할지 여부를 표시하는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservationAcl.write.fields.requested_for | 사용자가 이 예약의 요청 대상 필드에 쓸 수 있는지 확인할지 여부를 표시하는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| 결과.예약.예약Acl.쓰기.필드.민감도 | 사용자가 이 예약의 민감도 필드에 쓸 수 있는지 확인할지 여부를 표시하는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| 결과.reservation.reservationAcl.write.fields.subject | 사용자가 이 예약의 제목 필드에 쓸 수 있는지 확인할지 여부를 표시하는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservationAcl.write.record | 사용자가 전체 예약 기록에 쓸 수 있는지 확인할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 |
| result.reservation.reservation_purpose | 예약 목적에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.reservation_purpose.display_value | 회사 회의와 같은 예약 목적의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.reservation_purpose.value | 예약 목적의 내부 값입니다(예: company_meeting). 데이터 유형: 문자열 |
| result.reservation.reservation_type | 예약 유형에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.reservation_type.display_value | 공간과 같은 예약 유형에 대한 표시 값입니다. 데이터 유형: 문자열 |
| result.reservation.reservation_type.value | 공간과 같은 예약 유형의 내부 값입니다. 데이터 유형: 문자열 |
| result.reservation.reservation_subtype | 예약의 하위 유형에 대한 상세 정보입니다. 하위 유형은 예약의 유형(예: 단일, 다중 상위, 다중 하위, 반복되는 상위 항목 또는 발생)을 나타냅니다. 데이터 유형: 객체 |
| result.reservation.reservation_subtype.display_value | 예약의 하위 유형에 대한 값(예: 단일)을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.reservation_subtype.value | 예약의 하위 유형에 대한 내부 값입니다(예: 단일). 데이터 유형: 문자열 |
| 결과.예약.민감도 | 예약의 민감도에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.sensitivity.display_value | 예약의 민감도에 대한 값(예: 높음 또는 낮음)을 표시합니다. 데이터 유형: 문자열 |
| 결과.예약.민감도.값 | 예약 민감도의 내부 값(예: 1 또는 3)입니다. 데이터 유형: 문자열 |
| 결과.예약.교대조 | 예약에 적용된 교대조에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.shift.display_value | 교대조의 값을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.shift.name | 교대조의 이름입니다. 와 동일합니다.display_value 데이터 유형: 문자열 |
| 결과.예약.교대조.교대조 상세 정보 | 교대조의 상세 정보입니다. 데이터 유형: 문자열 |
| result.reservation.shift.sys_id | 교대조 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 교대조 [sn_wsd_core_shift] |
| 결과.예약.소스 | 예약 소스에 대한 상세 정보(예: 직장 서비스 또는 Google 메일)입니다. 데이터 유형: 객체 |
| result.reservation.source.display_value | 직장 서비스와 같은 예약 소스에 대한 값을 표시합니다. 데이터 유형: 문자열 |
| 결과.예약.소스.값 | ServiceNow와 같은 예약 소스의 내부 값입니다. 데이터 유형: 문자열 |
| result.reservation.source_icon | 예약에 사용된 아이콘의 소스에 대한 상세 정보입니다. 이 아이콘은 UI에서 사용됩니다. 데이터 유형: 객체 |
| result.reservation.source_icon.classNames | 소스 아이콘의 쉼표로 구분된 클래스 이름입니다. 데이터 유형: 문자열 |
| result.reservation.source_icon.imgSrc | 소스 아이콘의 이미지 소스 이름입니다. 이 아이콘은 이미지 [db_image] 테이블에 저장됩니다. 데이터 유형: 문자열 |
| result.reservation.source_icon.tooltip | 소스 아이콘과 관련된 도구 설명입니다. 데이터 유형: 문자열 |
| result.reservation.source_reservation | 현재 예약의 소스 예약입니다. 예를 들어 반복 예약의 경우 반복 상위 예약은 일련의 발생 예약의 소스입니다. 데이터 유형: 객체 |
| result.reservation.source_reservation.display_value | 소스 예약의 표시 값입니다. 데이터 유형: 문자열 |
| result.reservation.source_reservation.name | 소스 예약의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.source_reservation.sys_id | 소스 예약 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블:직장 예약 [sn_wsd_rsv_reservation] |
| result.reservation.source_reservation_requester | 반복 예약을 요청한 사용자입니다. 데이터 유형: 객체 |
| result.reservation.source_reservation_requester.name | 반복 예약 요청자의 이름입니다. 데이터 유형: 문자열 |
| result.reservation.source_reservation_requester.sys_id | 반복 예약을 요청한 사용자의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사용자 [sys_user] |
| result.reservation.source_reservation_requester.사용자_이름 | 반복 예약 요청자의 사용자 이름입니다. 데이터 유형: 문자열 |
| 결과.예약.시작 | 예약 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: UTC - yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z) |
| 결과.예약.상태 | 예약 상태에 대한 상세 정보입니다. 데이터 유형: 객체 |
| result.reservation.state.display_value | 예약의 현재 상태에 대한 값(예: 확인됨)을 표시합니다. 데이터 유형: 문자열 |
| 결과.예약.상태.값 | 예약의 현재 상태에 대한 내부 값입니다(예: 2). 데이터 유형: 문자열 |
| 결과.예약.제목 | 예약의 제목입니다. 데이터 유형: 문자열 |
| result.reservation.sub_source | 예약의 하위 소스에 대한 상세 정보입니다. 하위 소스는 예약이 시작된 위치를 지정합니다(예: Google 달력 또는 Microsoft Exchange). 데이터 유형: 객체 |
| result.reservation.sub_source.display_value | 예약의 하위 소스에 대한 값(예: Google 달력)을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.sub_source.value | 예약의 하위 소스 필드의 내부 값입니다(예: google_calendar). 데이터 유형: 문자열 |
| result.reservation.sync_state | 다른 서비스에서 예약의 동기화 상태에 대한 상세 정보입니다(예: "sync_enqueued" 또는 "동기화됨"). 데이터 유형: 객체 |
| result.reservation.sync_state.display_value | 예약의 현재 동기화 상태에 대한 값(예: 동기화됨)을 표시합니다. 데이터 유형: 문자열 |
| result.reservation.sync_state.value | 예약의 현재 동기화 상태(예: 동기화됨)의 내부 값입니다. 데이터 유형: 문자열 |
| result.reservation.sys_created_on | 예약이 생성된 날짜 및 시간입니다. 데이터 유형: 문자열 |
| result.reservation.sys_id |
예약 기록의 Sys_id입니다.
데이터 유형: 문자열 테이블: 직장 예약 [sn_wsd_rsv_reservation] |
| Result.reservation.sys_updated_on | 예약이 마지막으로 업데이트된 날짜 및 시간입니다. 데이터 유형: 문자열 |
| result.reservation.virtual_meeting | 가상 회의 링크의 URL입니다. 데이터 유형: 문자열 |
cURL 요청
다음 코드 예제에서는 특정 반복 예약을 검색하는 방법을 보여 줍니다.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/recurring_reservation/list/d98a381587b789506342b846dabb3563" \
--request GET \
--header "Accept:application/json" \
--user "username": "password"
반환 결과:
{
"result": {
"reservations": [
{
"sys_id": "198a381587b789506342b846dabb3565",
"number": "WRES0001247",
"location": {
"sys_id": "fe1f744edb7650106c731dcd139619ca",
"name": "Aspen",
"description": "A room with large windows, dark leather seats and a large wooden table.",
"display_value": "Aspen",
"capacity": 16,
"label_value": "Room name",
"email": null,
"reservable_module": {
"sys_id": "c31241cedb7650106c731dcd13961917",
"name": "Meeting rooms",
"title": "Meeting rooms",
"inline_title": "meeting room"
},
"region": {
"sys_id": "3752ac8edb3650106c731dcd139619e0",
"display_value": "Americas",
"active": true
},
"site": {
"sys_id": "628eec06db7650106c731dcd139619dd",
"display_value": "North America",
"active": true
},
"campus": {
"sys_id": "82b2a0cedb3650106c731dcd139619e9",
"display_value": "California Campus",
"active": true
},
"building": {
"sys_id": "94e264cedb3650106c731dcd13961919",
"display_value": "CAL-B1",
"active": true,
"timezone": {
"value": "US/Pacific",
"displayValue": "US/Pacific"
}
},
"floor": {
"sys_id": "2f554296dbba10106c731dcd139619ed",
"display_value": "Floor 2",
"active": true
},
"area": {
"sys_id": "",
"display_value": "",
"active": false
},
"reservation": {
"sys_id": "198a381587b789506342b846dabb3565",
"number_of_attendees": 1,
"state": {
"value": "confirmed",
"display_value": "Confirmed"
},
"requested_for": {
"sys_id": "2de07e1887cb89106342b846dabb35fe",
"name": "Workplace User",
"user_name": "workplace_user"
},
"number": "WRES0001247",
"active": true
},
"number_of_attendees": 1,
"state": {
"value": "confirmed",
"display_value": "Confirmed"
},
"number": "WRES0001247",
"requested_for": {
"sys_id": "2de07e1887cb89106342b846dabb35fe",
"name": "Workplace User",
"user_name": "workplace_user"
}
},
"start": "2022-06-11T13:00:00Z",
"end": "2022-06-11T14:00:00Z",
"sys_created_on": "2022-05-30T07:06:37Z",
"sys_updated_on": "2022-05-30T07:06:40Z",
"source_reservation": {
"sys_id": "d98a381587b789506342b846dabb3563",
"display_value": "WRES0001246",
"name": "WRES0001246"
},
"check_in_state": {
"value": "not_required",
"display_value": "Not required"
},
"external_id": null,
"external_ical": null,
"active": true,
"state": {
"value": "confirmed",
"display_value": "Confirmed"
},
"sensitivity": {
"value": "normal",
"display_value": "Normal"
},
"reservation_type": {
"value": "space",
"display_value": "Space"
},
"reservation_subtype": {
"value": "occurrence",
"display_value": "Occurrence"
},
"reservation_purpose": {
"value": "meeting",
"display_value": "Meeting"
},
"attendees": null,
"number_of_attendees": 1,
"is_parent": false,
"subject": "Rec 1",
"virtual_meeting": null,
"recording_details": [],
"sync_state": {
"value": "not_required",
"display_value": "Synchronization not required"
},
"sub_source": {
"value": "servicenow_workplace_service_delivery",
"display_value": "ServiceNow Workplace Service Delivery"
},
"last_updated_sub_source": {
"value": "servicenow_workplace_service_delivery",
"display_value": "ServiceNow Workplace Service Delivery"
},
"reservable_module": {
"sys_id": "c31241cedb7650106c731dcd13961917",
"name": "Meeting rooms",
"title": "Meeting rooms",
"inline_title": "meeting room",
"font_awesome_icon": "fa-building",
"reservable_table": "sn_wsd_core_room",
"reservable_filter": "active=true^is_reservable=true^building!=6c0364cedb3650106c731dcd13961927^building.is_reservable=true^floor.is_reservable=true^EQ",
"short_description": "Reserve a meeting room",
"reservable_type": "location",
"require_subject": "1",
"require_cancel_notes": true,
"virtual_meeting_provider": {
"sys_id": "e33d9e6853c201103cf7ddeeff7b1205",
"display_value": "Template"
},
"allow_invitees": "1",
"display_number_of_attendees": "1",
"display_on_behalf_of": "1",
"display_sensitivity": "1",
"max_days_in_future": "180",
"allow_recurring": "1",
"allow_whole_day": "1",
"require_whole_day": null,
"selection_type": "unit",
"reservable_container_field": null,
"reservable_quantity_field": null,
"apply_to_shift": null,
"max_occurrences": "180",
"enable_facet_filter": false,
"search_limit": 10000,
"enable_ical_generation": "1",
"enable_group_reservations": null,
"enable_browse_near_a_person": "1",
"enable_browse_by_area": "1",
"enable_floor_search": "1",
"display_value": "Meeting rooms",
"browse_near_a_person_enabled": true,
"browse_by_area_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": [],
"buildingSysIds": [
"4703a4cedb3650106c731dcd13961945",
"6c0364cedb3650106c731dcd13961927",
"94e264cedb3650106c731dcd13961919",
"9e0364cedb3650106c731dcd1396192b"
],
"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",
"availableFor": true
},
{
"value": "browse_favorites",
"displayValue": "Browse favorites",
"availableFor": false
},
{
"value": "browse_near_a_person",
"displayValue": "Browse near a person",
"availableFor": true
},
{
"value": "browse_by_area",
"displayValue": "Browse by area",
"availableFor": true
}
],
"override_approval_policy": "never_required"
},
"notification_recipients": null,
"notification_custom_message": null,
"opened_by": {
"sys_id": "2de07e1887cb89106342b846dabb35fe",
"value": "2de07e1887cb89106342b846dabb35fe",
"displayValue": "Workplace User",
"display_value": "Workplace User",
"name": "Workplace User",
"user_name": "workplace_user",
"table": "sys_user",
"avatar": null,
"initials": "WU",
"email": "workplace_user@example.com",
"label": ""
},
"requested_for": {
"sys_id": "2de07e1887cb89106342b846dabb35fe",
"value": "2de07e1887cb89106342b846dabb35fe",
"displayValue": "Workplace User",
"display_value": "Workplace User",
"name": "Workplace User",
"user_name": "workplace_user",
"table": "sys_user",
"avatar": null,
"initials": "WU",
"email": "workplace_user@example.com",
"label": ""
},
"edit_restriction": {
"value": "no_restriction",
"display_value": "No restriction"
},
"source": {
"value": "servicenow",
"display_value": "Workplace Services"
},
"source_reservation_requester": {
"sys_id": "2de07e1887cb89106342b846dabb35fe",
"name": "Workplace User",
"user_name": "workplace_user"
},
"source_icon": {
"classNames": "fa fa-calendar-check-o",
"tooltip": "Reservation is confirmed",
"imgSrc": ""
},
"shift": null,
"recurring_pattern": {
"duration": "3600000",
"repeats": "daily",
"options": {
"count": 3,
"daysOfWeek": "",
"every": 1,
"endDate": "2022-06-13 14:00:00",
"endDateGdt": {}
},
"label": "Repeats daily, 3 times",
"startDate": "2022-06-11 13:00:00",
"startDateGdt": "{}",
"amountOfDates": "3"
},
"reservationAcl": {
"write": {
"record": true,
"fields": {
"subject": true,
"sensitivity": true,
"requested_for": true,
"number_of_attendees": true,
"location": true
},
"allFields": true
},
"read": true
}
}
],
"occurencesTotalCount": "1"
}
}
WSD 정기 예약 - PATCH /api/sn_wsd_rsv/recurring_reservation/cancel_series/{sys_id}
지정된 전체 반복 계열 예약 또는 계열 내의 특정 회의 발생을 취소합니다.
URL 형식
버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/recurring_reservation/cancel_series/{sys_id}
기본 URL: /api/sn_wsd_rsv/recurring_reservation/cancel_series/{sys_id}
지원되는 요청 매개변수
| 이름 | 설명 |
|---|---|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| sys_id | 전체 계열을 취소하려면 반복 상위 예약 기록의 sys_id을 전달합니다. 특정 계열의 발생을 취소하려면 계열의 발생 sys_id을 전달합니다. 반복 상위 기록의 열 reservation_subtype은 반복 상위로 설정되어 있습니다. 개별 발생 기록에는 reservation_subtype 필드가 발생으로 설정되어 있습니다. 발생 기록에서 반복되는 상위 예약의 상세 정보를 얻으려면 발생 기록의 source_reservation 필드 sys_id를 참조하십시오. 데이터 유형: 문자열 테이블: 직장 예약 [sn_wsd_rsv_reservation] |
| 이름 | 설명 |
|---|---|
| cancel_notes | 예약을 취소하는 이유입니다. 데이터 유형: 문자열 |
| 이름 | 설명 |
|---|---|
| 안 함 |
헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.
| 머리글 | 설명 |
|---|---|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
| 머리글 | 설명 |
|---|---|
| 안 함 |
상태 코드
이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.
| 상태 코드 | 설명 |
|---|---|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
응답 본문 매개변수
| 이름 | 설명 |
|---|---|
| 결과 | 반복 예약 취소 요청 결과를 반환합니다. 데이터 유형: 객체 |
| result.failedToCancelOccurrenceReservations | 취소하지 못한 개별 회의 발생 기록의 sys_ids 목록입니다. 데이터 유형: 문자열 배열 |
| result.seriesId | 전체 계열이 취소되는 경우 반복되는 상위 항목의 Sys_id 또는 단일 발생이 취소되는 경우 특정 발생의 sys_id입니다. 데이터 유형: 문자열 |
| 결과.성공 | 예약이 성공적으로 취소되었는지 여부를 나타내는 플래그입니다. 가능한 값:
데이터 유형: 부울 |
| result.failedToCancelOccurrenceReservations | 성공적으로 취소된 개별 회의 발생 기록의 sys_ids 목록입니다. 데이터 유형: 문자열 배열 |
| result.user_msg | 요청에 대한 메시지입니다. 데이터 유형: 문자열 |
cURL 요청
다음 코드 예제에서는 전체 반복 예약을 취소하는 방법을 보여 줍니다.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/recurring_reservation/cancel_series/f64983a347274550003a4587746d43b8" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--user "username":"password"
반환 결과:
{
"result": {
"failedToCancelOccurrenceReservations": [],
"successCanceledOccurrences": [
"cb4983a347274550003a4587746d43bd",
"cf4983a347274550003a4587746d43ba"
],
"user_msg": "Your Recurring reservation has been canceled successfully!",
"seriesId": "f64983a347274550003a4587746d43b8",
"success": true
}
}
WSD 반복 예약 - POST /api/sn_wsd_rsv/recurring_reservation/create_series
매주, 매월 또는 격주처럼 같은 시간에 다른 날짜에 대한 직장 예약을 생성합니다.
URL 형식
버전이 지정된 URL: /api/sn_wsd_rsv/{api_version}/recurring_reservation/create_series
기본 URL: /api/sn_wsd_rsv/recurring_reservation/create_series
지원되는 요청 매개변수
| 이름 | 설명 |
|---|---|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| 이름 | 설명 |
|---|---|
| 없음 |
| 이름 | 설명 |
|---|---|
| recurringPattern | 예약의 반복 패턴에 대한 상세 정보입니다. 데이터 유형: 객체 |
| recurringPattern.duration | 교대조 기반 예약이 아닌 경우 필수입니다. 예약 가능한 항목을 예약할 시간입니다. 데이터 유형: 숫자 단위: 초 |
| recurringPattern.label | 반복 예약에 대한 설명이 포함된 이름입니다. 데이터 유형: 문자열 |
| recurringPattern.options | 필수 반복 패턴에 대해 설정된 옵션에 대한 상세 정보입니다. 데이터 유형: 객체
|
| recurringPattern.options.count | 교대조 기반 예약이 아닌 경우 필수입니다. 교대조 기반 예약의 경우 무시됩니다. 패턴을 반복하는 횟수입니다. 데이터 유형: 숫자 |
| recurringPattern.options.daysOfWeek | 매개변수가 repeats매주로 설정된 경우 필요합니다. 예약 가능한 요일입니다. 유효한 값은 다음과 같습니다.
예를 들어 화요일, 목요일, 금요일을 지정하려면 245(구분 기호 없음)를 전달합니다. repeats is weekly이고, count5이고, daysOfWeek 245이면 반환 결과에서 합계는 데이터 유형: 문자열 |
| recurringPattern.options.every | 패턴 반복 간격입니다. 예를 들어 값 '2'는 속성 값 repeats 에 따라 패턴이 2일 또는 2개월마다 반복됨을 나타냅니다. 주:
이 설정은 매주 반복 간격에는 적용되지 않습니다. 격주 반복 간격으로 속성을 매일로 설정하고 이 값을 14로 설정할 repeats 수 있습니다.데이터 유형: 숫자 기본값: 1 |
| recurringPattern.options.endDate | 회의 반복의 종료 날짜 및 시간입니다(예: "2022-07-08T14:00:00Z"). 데이터 유형: 문자열 형식: UTC yyyy-mm-dd hh:mm:ss |
| recurringPattern.repeats | 교대조 기반 예약이 아닌 경우 필수입니다. 예약 가능한 반복 패턴입니다. 유효한 값: (대/소문자 구분)
주: 패턴 반복 간격은 속성에 options.every 설정되어 있습니다. 주간 패턴에 대해 유일하게 유효한 반복 간격은 1입니다. 데이터 유형: 문자열 |
| recurringPattern.startDate | 필수 반복 패턴의 시작 날짜 및 시간입니다(예: "2022-07-08T14:00:00Z"). 데이터 유형: 문자열 형식: UTC yyyy-mm-dd hh:mm:ss |
| 예약 | 생성할 반복 예약에 대한 상세 정보입니다. 데이터 유형: 객체 |
| reservation.is_private | 예약이 비공개인지 여부를 나타내는 플래그입니다. 비공개인 경우 예약은 소유자를 제외한 누구에게도 표시되지 않습니다. 이러한 개인 정보 설정에 대한 자세한 내용은 위치 개인 정보 보호 설정 및 영향을 참조하세요. 유효한 값은 다음과 같습니다.
데이터 유형: 부울 기본값: 시스템 속성에서 개인정보에 대해 설정된 값입니다. |
| 예약.위치 | 필수 예약할 위치의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 위치 [sn_wsd_core_workplace_location] |
| reservation.reservable_module | 필수 예약과 연결할 예약 가능한 모듈의 Sys_id입니다. 예약 가능한 모듈은 예약에 필요한 직장 항목을 정의합니다. 데이터 유형: 문자열 테이블: 예약 가능한 모듈 [sn_wsd_rsv_reservable_module] |
| reservation.shift | 예약과 연결할 교대조의 Sys_id입니다. 이 매개변수가 전달되면 매개변수가 end 필요하지 않습니다. 교대조 기반 예약에 대한 자세한 내용은 교대조 기반 예약 사용을 참조하십시오. 데이터 유형: 문자열 테이블: 교대조 [sn_wsd_core_shift] |
| reservation.subject | 필수 예약과 관련된 회의의 주제입니다. 데이터 유형: 문자열 |
헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.
| 머리글 | 설명 |
|---|---|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
| 머리글 | 설명 |
|---|---|
| 안 함 |
상태 코드
이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.
| 상태 코드 | 설명 |
|---|---|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
응답 본문 매개변수
| 이름 | 설명 |
|---|---|
| 결과 | 다중 예약 생성 또는 업데이트의 결과를 반환합니다. 데이터 유형: 객체 |
| result.isValid | 예약이 성공적으로 생성되었는지 여부를 나타내는 플래그입니다. 가능한 값:
데이터 유형: 부울 |
| 결과.상위 | 업데이트된 상위 예약의 Sys_id입니다. 데이터 유형: 문자열 |
| result.successfulReservations | 성공적으로 업데이트된 예약 목록입니다. 데이터 유형: 객체 배열 |
| result.successfulReservations.collision | 지정된 시간 동안 예약이 이미 존재하고 현재 예약과 충돌하는지 여부를 나타내는 플래그입니다. 가능한 값:
데이터 유형: 부울 |
| result.successfulReservations.end | 예약 종료 날짜 및 시간입니다. 데이터 유형: 문자열 형식: UTC: yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z) |
| result.successfulReservations.error | 예약을 생성하는 동안 문제가 발생한 경우의 오류 메시지입니다. 데이터 유형: 문자열 |
| result.successfulReservations.inserted | 예약이 성공적으로 삽입되었는지 여부를 나타내는 플래그입니다. 예: 예약이 추가되는 경우. 가능한 값:
데이터 유형: 부울 |
| result.successfulReservations.start | 예약 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: UTC - yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z) |
| result.successfulReservations.sys_id | 생성된 예약의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 예약 [sn_wsd_rsv_reservation] |
| result.unSuccessfulReservations | 업데이트하지 못한 예약 목록입니다. 데이터 유형: 객체 배열 |
| result.unSuccessfulReservations.collision | 지정된 시간 동안 예약이 이미 존재하고 현재 예약과 충돌하는지 여부를 나타내는 플래그입니다. 가능한 값:
데이터 유형: 부울 |
| result.unSuccessfulReservations.end | 예약 종료 날짜 및 시간입니다. 데이터 유형: 문자열 형식: UTC: yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z) |
| result.unSuccessfulReservations.error | 예약을 생성하는 동안 문제가 발생한 경우의 오류 메시지입니다. 데이터 유형: 문자열 |
| result.unSuccessfulReservations.inserted | 예약이 성공적으로 삽입되었는지 여부를 나타내는 플래그입니다. 예: 예약이 추가되는 경우. 가능한 값:
데이터 유형: 부울 |
| result.unSuccessfulReservations.start | 예약 시작 날짜 및 시간입니다. 데이터 유형: 문자열 형식: UTC - yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z) |
| result.unSuccessfulReservations.sys_id | 예약 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 직장 예약 [sn_wsd_rsv_reservation] |
cURL 요청
다음 코드 예제에서는 2일 연속으로 매일 반복 예약을 만드는 방법을 보여 줍니다.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/recurring_reservation/create_series" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
\"reservation\": {
\"reservable_module\": \"5db44502dbb650106c731dcd13961937\",
\"subject\": \"Test-123\",
\"reservation_purpose\": \"meeting\",
\"timezone\": \"US/Pacific\",
\"requested_for\": \"6816f79cc0a8016401c5a33be04be441\",
\"location\": \"6a11a94adb7210106c731dcd1396194e\",
\"attendees\": \"6816f79cc0a8016401c5a33be04be441\",
\"is_private\": false
},
\"recurringPattern\": {
\"duration\": 3600000,
\"repeats\": \"daily\",
\"options\": {
\"count\": 2,
\"daysOfWeek\": \"\",
\"every\": 1
},
\"label\": \"Repeats daily, 2 times\",
\"startDate\": \"2023-01-12T12:00:00Z\"
}
}" \
반환 결과:
{
"result": {
"isValid": true,
"parent": "1e5f65ca87586550cfaa99b73cbb3513",
"successfulReservations": [
{
"inserted": true,
"collision": false,
"sys_id": "9e5f65ca87586550cfaa99b73cbb3517",
"error": null,
"start": "2023-01-13T12:00:00Z",
"end": "2023-01-13T13:00:00Z"
}
],
"unSuccessfulReservations": [
{
"inserted": true,
"collision": true,
"sys_id": "5e5f65ca87586550cfaa99b73cbb3515",
"error": null,
"start": "2023-01-12T12:00:00Z",
"end": "2023-01-12T13:00:00Z"
}
]
}
}