WSD 반복 예약 API

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 92분

    • (WSD) 반복 예약 API는 워크플레이스 서비스 제공 동시에 발생하지만 날짜가 다른 예약을 관리하기 위한 엔드포인트를 제공합니다.

    이 API에 액세스하려면 호출자에게 sn_wsd_core.workplace_user 역할이 있어야 하며 sn_wsd_core(Workplace Safety Management) 및 sn_wsd_rsv(Workplace Reservation Management) 플러그인이 활성화되어 있어야 합니다.

    이 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}

    주:
    사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

    지원되는 요청 매개변수

    표 1. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다.

    데이터 유형: 문자열
    parent_id 반복 상위 예약 기록의 Sys_id입니다.

    반복 예약이 생성되면 하나의 반복 상위 기록과 하나 이상의 하위 예약 기록이 생성됩니다. 예약 기록에는 예약 기록의 유형을 나타내는 reservation_subtype이라는 필드가 포함되어 있습니다. 반복되는 상위 기록의 경우 이 필드는 "반복되는 상위"로 설정됩니다. 하위 기록의 경우 이 필드는 "발생"으로 설정됩니다.

    하위 기록 내에서 연결된 반복 상위 기록의 sys_id source_reservation 필드에 있습니다.

    데이터 유형: 문자열

    테이블: 직장 예약 [sn_wsd_rsv_reservation]
    표 2. 쿼리 매개변수
    이름 설명
    end_index 반복 기록 세트를 페이지 매김할 때 발생 기록 반환을 중지할 0부터 시작하는 기록 번호입니다.
    주:
    반복 발생 수가 6보다 작으면 엔드포인트는 모든 발생을 반환하고, 그렇지 않으면 처음 6개를 반환합니다. 6개 이상의 발생을 검색하려면 end_index 매개변수를 적절하게 전달해야 합니다.

    데이터 유형: 숫자
    occurrence_sys_id 반환하지 않을 반복 계열의 발생 기록 Sys_id.

    데이터 유형: 문자열

    테이블: 직장 예약 [sn_wsd_rsv_reservation]
    start_index 반복 기록 세트를 페이지 매김할 때 발생 기록 반환을 시작할 0부터 시작하는 기록 번호입니다.

    데이터 유형: 숫자

    기본값: 0
    표 3. 요청 본문 매개변수
    이름 설명
    없음

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.

    표 4. 요청 헤더
    헤더 설명
    수용 요청 본문의 데이터 형식입니다. 지원되는 유형: application/json, application/xml 또는, text/xml.

    기본값: application/json
    표 5. 응답 헤더
    헤더 설명
    없음

    상태 코드

    다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

    표 6. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    401 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

    응답 본문 매개변수

    이름 설명
    결과 요청된 반복 예약에 대한 결과를 반환합니다.

    데이터 유형: 객체

    "result": {
  "occurencesTotalCount": "String",
  "reservation": {Object}
}
    result.occurencesTotalCount 반복 계열의 총 회의 발생 수입니다.

    데이터 유형: 문자열
    결과.예약 요청된 반복 예약에 대한 상세 정보입니다.

    데이터 유형: 객체

    "reservation": {
  "active": Boolean,
  "attendees": [Array],
  "check_in_state": {Object},
  "edit_restriction": {Object},
  "end": "String",
  "external_ical": "String",
  "external_id": "String",
  "is_parent": Boolean,
  "last_updated_sub_source": {Object},
  "location": {Object},
  "notification_custom_message": "String",
  "notification_recipients": [Array],
  "number": "String",
  "number_of_attendees": Number,
  "opened_by": {Object},
  "recording_details": [Array],
  "recurring_pattern": {Object},
  "requested_for": {Object},
  "reservable_module": {Object},
  "sensitivity": {Object},
  "shift": {Object},
  "source": {Object},
  "source_icon": {Object},
  "source_reservation": {Object},
  "source_reservation_requester": {Object},
  "start": "String",
  "state": {Object},
  "subject": "String",
  "sub_source": {Object},
  "sync_state": {Object},
  "sys_created_on": "String",
  "sys_id": "String",
  "sys_updated_on": "String",
  "virtual_meeting": "String"
}
    result.reservation.active 예약이 활성 상태인지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 예약이 활성 상태입니다.
    • false: 예약이 비활성 상태입니다.

    데이터 유형: 부울
    결과.예약.참석자 예약 참석자 목록입니다.

    데이터 유형: 객체 배열

    "attendees": [
  {
    "avatar": "String",
    "displayValue": "String",
    "display_value": "String",
    "email": "String",
    "initials": "String",
    "label": "String",
    "name": "String",
    "sys_id": "String",
    "table": "String",
    "user_name": "String",
    "value": "String"
  }
]
    결과.예약.참석자.아바타 참석자와 연결된 아바타의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 첨부 파일 [sys_attachment]
    result.reservation.attendees.displayValue 참석자에 대한 표시 값입니다.

    데이터 유형: 문자열
    result.reservation.attendees.display_value 참석자의 표시 값입니다. 와 displayValue같습니다.

    데이터 유형: 문자열
    result.reservation.attendees.email 참석자의 이메일 주소입니다.

    데이터 유형: 문자열
    결과.예약.참석자.초기 참석자의 이니셜입니다.

    데이터 유형: 문자열
    result.reservation.attendees.name 참석자의 이름입니다.

    데이터 유형: 문자열
    result.reservation.attendees.sys_id 참석자 기록의 Sys_id입니다.

    데이터 유형: 문자열
    결과.예약.참석자.테이블 참석자 기록이 있는 테이블입니다.

    데이터 유형: 문자열
    result.reservation.attendees.user_name 참석자의 사용자 이름입니다.

    데이터 유형: 문자열
    결과.예약.참석자.값 참석자의 내부 값입니다.

    데이터 유형: 문자열
    result.reservation.check_in_state 예약의 체크인 상태에 대한 상세 정보입니다.

    데이터 유형: 객체

    "check_in_state": {
  "display_value": "String",
  "value": "String"
}
    result.reservation.check_in_state.display_value 예약의 현재 체크인 상태에 대한 표시 값(예: 진행 중 또는 완료)입니다.

    데이터 유형: 문자열
    result.reservation.check_in_state.값 예약의 현재 체크인 상태에 대한 내부 값입니다(예: 2).

    데이터 유형: 문자열
    result.reservation.edit_restriction 예약에 대한 사용자 편집 제한(예: no_restrictions, service_only, fully_restricted)에 대한 설명입니다.

    데이터 유형: 객체

    "edit_restriction": {
  "display_value": "String",
  "value": "String"
}
    result.reservation.edit_restriction.display_value 예약 편집 제한에 대한 표시 값(예: 제한 없음)입니다.

    데이터 유형: 문자열
    result.reservation.edit_restriction.값 예약에 대한 편집 제한의 내부 값입니다(예: 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 이 예약이 상위 예약인지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 상위 예약입니다.
    • false: 상위 예약이 아닙니다.

    데이터 유형: 부울
    result.reservation.last_updated_sub_source 예약의 마지막 업데이트된 하위 소스에 대한 상세 정보입니다. 하위 원본은 예약을 외부 달력과 통합할 때 사용됩니다. 이 객체에는 "servicenow_workplace_service_delivery", "google_calendar" 또는 "microsoft_exchange"와 같은 정보가 포함되어 있습니다.

    데이터 유형: 객체

    "last_updated_sub_source": {
  "display_value": "String",
  "value": "String"
}
    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과 같은 외부 서비스와 통합할 때 사용됩니다.

    데이터 유형: 문자열
    결과.예약.위치 예약과 연결된 위치에 대한 상세 정보입니다.

    데이터 유형: 객체

    "location": {
  "area": {Object},
  "building": {Object},
  "campus": {Object},
  "capacity": Number,
  "description": "String",
  "display_value": "String",
  "email": "String",
  "floor": {Object},
  "label_value": "String",
  "name": "String",
  "number": "String",
  "number_of_attendees": Boolean,
  "region": {Object},
  "requested_for": {Object},
  "reservable_module": {Object},
  "reservation": {Object},
  "site": {Object},
  "state": {Object},
  "sys_id": "String"
}
    결과.예약.위치.영역 위치와 연결된 영역에 대한 상세 정보입니다.

    데이터 유형: 객체

    "area": {
  "active": Boolean,
  "display_value": "String",
  "sys_id": "String"
}
    result.reservation.location.area.active 영역이 활성 상태인지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 영역이 활성 상태입니다.
    • false: 영역이 비활성 상태입니다.

    데이터 유형: 부울
    result.reservation.location.area.display_value 책상 A2와 같이 이 위치가 속한 영역의 표시 값입니다.

    데이터 유형: 문자열
    result.reservation.location.area.sys_id 이 위치가 속한 지역의 Sys_id입니다.

    데이터 유형: 문자열

    표: 영역 [sn_wsd_core_area]
    결과.예약.위치.건물 위치와 연결된 건물에 대한 상세 정보입니다.

    데이터 유형: 객체

    "building": {
  "active": Boolean,
  "display_value": "String",
  "sys_id": "String",
  "timezone": {Object}
}
    result.reservation.location.building.active 건물이 활성 상태인지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 건물이 활성 상태입니다.
    • false: 건물이 비활성 상태입니다.

    데이터 유형: 부울
    result.reservation.location.building.display_value 이 위치가 속한 건물의 표시 값(예: AMS - Bld1)입니다.

    데이터 유형: 문자열
    result.reservation.location.building.sys_id 이 위치가 속한 건물의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 건물 [sn_wsd_core_building]
    결과.예약.위치.건물.시간대 건물의 표준 시간대에 대한 상세 정보입니다.

    데이터 유형: 객체

    "timezone": {
  "displayValue": "String",
  "value": "String"
}
    result.reservation.location.building.timezone.display_value 연결된 건물이 위치한 시간대의 표시 값입니다.

    데이터 유형: 문자열
    결과.예약.위치.건물.시간대.값 이 위치가 속한 시간대의 내부 값입니다.

    데이터 유형: 문자열
    결과.예약.위치.캠퍼스 위치와 연결된 캠퍼스에 대한 상세 정보입니다.

    데이터 유형: 객체

    "campus": {
  "active": Boolean,
  "display_value": "String",
  "sys_id": "String"
}
    result.reservation.location.campus.active 캠퍼스가 활성 상태인지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 캠퍼스가 활성 상태입니다.
    • false: 캠퍼스가 비활성 상태입니다.

    데이터 유형: 부울
    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 위치의 이메일 주소입니다.

    데이터 유형: 문자열
    결과.예약.위치.층 위치와 연결된 층에 대한 상세 정보입니다.

    데이터 유형: 객체

    "floor": {
  "active": Boolean,
  "display_value": "String",
  "sys_id": "String"
}
    result.reservation.location.floor.active 층이 활성 상태인지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 층이 활성 상태입니다.
    • false: 층이 비활성 상태입니다.

    데이터 유형: 부울
    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 예약과 연결된 예약 가능한 모듈에 대한 상세 정보입니다.

    데이터 유형: 객체

    "reservable_module": {
  "inline_title": "String",
  "name": "String",
  "sys_id": "String",
  "title": "String"
}
    result.reservation.location.reservable_module.inline_title 예약 가능한 모듈의 인라인 제목입니다. 제목은 Workplace 서비스 포털의 설명 텍스트와 나란히 표시됩니다.

    데이터 유형: 문자열
    result.reservation.location.reservable_module.이름 예약 가능한 모듈의 이름입니다.

    데이터 유형: 문자열
    result.reservation.location.reservable_module.sys_id 예약 가능한 모듈의 Sys_id입니다.

    데이터 유형: 문자열
    result.reservation.location.reservable_module.타이틀 예약 가능한 모듈의 제목입니다.

    데이터 유형: 문자열
    결과.예약.위치.지역 위치와 연결된 지역에 대한 상세 정보입니다.

    데이터 유형: 객체

    "region": {
  "active": Boolean,
  "display_value": "String",
  "sys_id": "String"
}
    result.reservation.location.region.active 지역이 활성 상태인지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 영역이 활성 상태입니다.
    • false: 영역이 비활성 상태입니다.

    데이터 유형: 부울
    result.reservation.location.region.display_value 유럽과 같이 이 위치가 속한 지역의 값을 표시합니다.

    데이터 유형: 문자열
    result.reservation.location.region.sys_id 이 위치가 속한 지역의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 지역[sn_wsd_core_region]
    결과.예약.위치.예약 위치와 연결된 예약에 대한 상세 정보입니다.

    데이터 유형: 객체

    "reservation": {
  "active": Boolean,
  "number": "String",
  "number_of_attendees": Number,
  "requested_for": {Object},
  "state": {Object},
  "sys_id": "String"
}
    result.reservation.location.reservation.active 예약이 활성 상태인지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 예약이 활성 상태입니다.
    • false: 예약이 비활성 상태입니다.

    데이터 유형: 부울
    결과.예약.위치.예약.번호 예약 번호입니다.

    데이터 유형: 문자열
    result.reservation.location.reservation.number_of_attendees 예약의 참석자 수입니다.

    데이터 유형: 숫자
    result.reservation.location.reservation.requested_for 대신 예약을 요청한 사람에 대한 상세 정보입니다.

    데이터 유형: 객체

    "requested_for": {
  "name": "String",
  "sys_id": "String",
  "user_name": "String"
}
    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 예약을 요청한 사용자의 사용자 이름입니다.

    데이터 유형: 문자열
    결과.예약.위치.예약.상태 위치 예약 상태에 대한 상세 정보입니다.

    데이터 유형: 객체

    "state": {
  "display_value": "String",
  "value": "String"
}
    result.reservation.location.reservation..state.display_value 예약의 현재 상태에 대한 표시 값(예: 확인됨)입니다.

    데이터 유형: 문자열
    결과.예약.위치.예약..상태.값 예약의 현재 상태에 대한 내부 값입니다(예: 2).

    데이터 유형: 문자열
    result.reservation.location.site 위치가 속한 사이트입니다.

    데이터 유형: 객체

    "site": {
  "active": Boolean,
  "display_value": "String",
  "sys_id": "String"
}

    테이블: 사이트 [sn_wsd_core_site]
    result.reservation.location.site.active 사이트가 활성 상태인지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 사이트가 활성 상태입니다.
    • false: 사이트가 비활성 상태입니다.

    데이터 유형: 부울
    result.reservation.location.site.display_value 이 위치가 속한 사이트의 표시 값(예: 서유럽)입니다.

    데이터 유형: 문자열
    result.reservation.location.site.sys_id 이 위치가 속한 사이트의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 사이트 [sn_wsd_core_site]
    result.reservation.location.standard_services 사용 가능한 표준 서비스입니다.

    데이터 유형: 문자열
    결과.예약.위치.상태 위치 예약 상태에 대한 상세 정보입니다.

    데이터 유형: 객체

    "state": {
  "display_value": "String",
  "value": "String"
}
    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 예약에 대한 알림을 받는 수신자 목록입니다.

    데이터 유형: 객체 배열

    "notification_recipients":[
  {
    "name": "String",
    "sys_id": "String",
    "user_name": "String"
  }
]
    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 예약을 생성한 사용자에 대한 상세 정보입니다.

    데이터 유형: 객체

    "opened_by": {
  "avatar": "String",
  "displayValue": "String",
  "display_value": "String",
  "email": "String",
  "initials": "String",
  "label": "String",
  "name": "String",
  "sys_id": "String",
  "table": "String",
  "user_name": "String",
  "value": "String"
}
    result.reservation.opened_by.아바타 예약을 연 사용자의 아바타입니다.

    데이터 유형: 문자열
    result.reservation.opened_by.displayValue 사용자가 연 표시 값입니다.

    데이터 유형: 문자열
    result.reservation.opened_by.display_value 사용자가 연 표시 값입니다.

    데이터 유형: 문자열
    result.reservation.opened_by.email 예약을 연 사용자의 이메일 주소입니다.

    데이터 유형: 문자열
    result.reservation.opened_by.이니셜 예약을 연 사용자의 이니셜입니다.

    데이터 유형: 문자열
    result.reservation.opened_by.name 예약을 시작한 사용자의 이름입니다.

    데이터 유형: 문자열
    result.reservation.opened_by.user_name 예약을 시작한 사용자의 사용자 이름입니다.

    데이터 유형: 문자열
    result.reservation.opened_by.값 예약을 연 사용자의 내부 값입니다.

    데이터 유형: 문자열
    result.reservation.recording_details 예약(회의)과 연결된 기록에 대한 상세 정보입니다.

    데이터 유형: 객체 배열

    "recording_details": [
  "recording_url": "String"
]
    result.reservation.recording_details.recording_url 예약과 연결된 녹화의 URL입니다.

    데이터 유형: 문자열
    result.reservation.recurring_pattern 예약의 반복 패턴에 대한 상세 정보입니다.

    데이터 유형: 객체

    "recurring_pattern": {
  "amountOfDates": "String",
  "duration": Number,
  "label": "String",
  "options": {Object},
  "repeats": "String",
  "startDate":"String",
  "startDateGdt": {Object}
}
    result.reservation.recurring_pattern.날짜의양 예약 가능한 날짜가 예약된 날짜 수입니다.

    데이터 유형: 문자열
    result.reservation.recurring_pattern.duration
    예약 가능 항목을 예약할 시간입니다.

    데이터 유형: 숫자

    단위: 초
    result.reservation.recurring_pattern.레이블 반복 예약에 대한 설명이 포함된 이름입니다.

    데이터 유형: 문자열
    result.reservation.recurring_pattern.옵션 반복 예약과 연결된 옵션에 대한 상세 정보입니다.

    데이터 유형: 객체

    "options": {
  "count": Number,
  "daysOfWeek": "String",
  "every": Number,
  "endDate": "String"
  "endDateGdt": {Object}
}
    result.reservation.recurring_pattern.options입니다.세다

    패턴을 반복하는 횟수입니다.

    데이터 유형: 숫자
    result.reservation.recurring_pattern.options입니다.daysOfWeek

    예약 가능한 요일입니다.

    유효한 값은 다음과 같습니다.
    • 1 = 월요일
    • 2 = 화요일
    • 3 = 수요일
    • 4 = 목요일
    • 5 = 금요일
    • 6 = 토요일
    • 7 = 일요일

    예를 들어 화요일, 목요일, 금요일을 지정하려면 245(구분 기호 없음)를 전달합니다. repeats주별count이고 5이고 daysOfWeek 245이면 반환 결과에서 합계는 count*daysOfWeek.length (5*3=15)와 같습니다.

    데이터 유형: 문자열
    result.reservation.recurring_pattern.options입니다.모든 패턴 반복 간격입니다. 예를 들어, 값 '2'는 속성 값에 따라 패턴이 2일 또는 2개월마다 반복됨을 repeats 나타냅니다.
    주:
    이 설정은 매주 반복 간격에 적용할 수 없습니다. 격주 반복 간격에 repeats 대해 속성을 매일 로 설정하고 이 값을 14 로 설정할 수 있습니다.

    데이터 유형: 숫자

    기본값: 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.반복

    예약 가능한 항목에 대한 반복 패턴입니다.

    유효한 값: (대/소문자 구분)
    • 매일
    • 월별
    • 주별
    주:
    패턴 반복 간격은 속성에 설정됩니다 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 대신 예약한 사용자에 대한 상세 정보입니다.

    데이터 유형: 객체

    "requested_for": {
  "avatar": "String",
  "displayValue": "String",
  "display_value": "String",
  "email": "String",
  "initials": "String",
  "label": "String",
  "name": "String",
  "sys_id": "String",
  "table": "String",
  "user_name": "String",
  "value": "String"
}
    result.reservation.requested_for.아바타 대신 예약한 사용자의 아바타입니다.

    데이터 유형: 문자열
    result.reservation.requested_for.displayValue 대신 예약이 이루어진 사용자의 표시 값입니다.

    데이터 유형: 문자열
    result.reservation.requested_for.display_value 대신 예약이 이루어진 사용자의 표시 값입니다. displayValue와 동일합니다.

    데이터 유형: 문자열
    result.reservation.requested_for.email 대신 예약한 사용자의 이메일 주소입니다.

    데이터 유형: 문자열
    result.reservation.requested_for.이니셜 대신 예약한 사용자의 이니셜입니다.

    데이터 유형: 문자열
    result.reservation.requested_for.레이블 대신 예약이 이루어진 사용자의 레이블입니다.

    데이터 유형: 문자열
    result.reservation.requested_for.name 대신 예약한 사용자의 이름입니다.

    데이터 유형: 문자열
    result.rservation.requested_for.sys_id 대신 예약한 사용자를 Sys_id_of.

    데이터 유형: 문자열

    테이블: 사용자 [sys_user]
    result.rservation.requested_for.테이블 사용자 기록이 포함된 테이블입니다.

    데이터 유형: 문자열
    result.reservation.requested_for.user_name 대신 예약한 사용자의 사용자 이름입니다.

    데이터 유형: 문자열
    result.reservation.requested_for.값 대신 예약한 사용자의 내부 값입니다.

    데이터 유형: 문자열
    result.reservation.reservable_module 요청된 예약 가능한 모듈에 대한 상세 정보입니다.

    데이터 유형: 객체

    "reservable_module": {
  "allow_invitees": Boolean,
  "allow_whole_day": Boolean,
  "apply_to_shift": Boolean,
  "browse_by_area_enabled": Boolean,
  "browse_near_a_person_enabled": Boolean,
  "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_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": {Object},
  "max_days_in_future": Number,
  "max_occurrences": Number,
  "name": "String",
  "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.reservation.reservable_module.allow_invitees 직원이 예약에 초대 대상자를 추가할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 직원이 예약에 초대 대상자를 추가할 수 있도록 허용합니다.
    • false: 직원이 예약에 초대 대상자를 추가할 수 없습니다.

    데이터 유형: 부울
    result.reservation.reservable_module.allow_whole_day 사용자가 하루 종일 예약 가능을 예약할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 사용자가 하루 종일 예약할 수 있도록 허용합니다.
    • false: 사용자가 하루 종일 예약할 수 없도록 합니다.

    데이터 유형: 부울
    result.reservation.reservable_module.apply_to_shift 예약 가능한 모듈에 교대조 기반 예약이 사용되었는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 교대조 기반 예약을 허용합니다.
    • false: 교대조 기반 예약을 허용하지 않습니다.

    데이터 유형: 부울
    result.reservation.reservable_module.browse_by_area_enabled 사용자가 영역별로 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 사용자가 영역별로 예약 가능한 모듈을 찾아볼 수 있도록 허용합니다.
    • false: 사용자가 영역별로 예약 가능한 모듈을 탐색하는 것을 허용하지 않습니다.

    데이터 유형: 부울
    result.reservation.reservable_module.browse_near_a_person_enabled 사용자가 특정인이 찾은 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 사용자가 사람 근처에서 예약 가능한 모듈을 탐색할 수 있도록 허용합니다.
    • false: 사용자가 사람 근처에서 예약 가능한 모듈을 탐색하는 것을 허용하지 않습니다.

    데이터 유형: 부울
    result.reservation.reservable_module.buildingSysIds 예약 가능한 모듈과 연결된 sys_ids 건물 목록입니다.

    데이터 유형: 문자열 배열
    result.reservation.reservable_module.checkin_before_minutes 예약이 시작되기 전에 사용자가 예약을 체크인할 수 있는 시간입니다.

    단위: 분

    데이터 유형: 숫자
    result.reservation.reservable_module.display_number_of_attendees 사용자가 예약의 참석자 수를 지정할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 사용자가 참석자 수를 지정할 수 있습니다.
    • false: 사용자가 참석자 표시 수를 지정할 수 없습니다.

    데이터 유형: 부울
    result.reservation.reservable_module.display_on_behalf_of 다른 사람을 대신해 예약할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 지원을 대신합니다.
    • false: 대신 지원되지 않습니다.

    데이터 유형: 부울
    result.reservation.reservable_module.display_sensitivity 사용자가 예약의 민감도(예: 일반 또는 비공개)를 설정할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 감도를 설정할 수 있습니다.
    • false: 감도를 설정할 수 없습니다. 기본값은 normal입니다.

    데이터 유형: 부울
    result.reservation.reservable_module.display_value 예약 가능한 모듈의 표시 값입니다.

    데이터 유형: 문자열
    result.reservation.reservable_module.enable_browse_by_area 사용자가 영역별로 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다. 와 browse_by_area_enabled같습니다.
    유효한 값은 다음과 같습니다.
    • true: 사용자가 영역별로 예약 가능한 모듈을 찾아볼 수 있도록 허용합니다.
    • false: 사용자가 영역별로 예약 가능한 모듈을 탐색하는 것을 허용하지 않습니다.

    데이터 유형: 부울
    result.reservation.reservable_module.enable_browse_near_a_person 사용자가 특정인이 찾은 예약 가능한 모듈을 검색할 수 있는지 여부를 나타내는 플래그입니다. 와 browse_near_a_person_enabled 동일합니다.
    유효한 값은 다음과 같습니다.
    • true: 사용자가 사람 근처에서 예약 가능한 모듈을 탐색할 수 있도록 허용합니다.
    • false: 사용자가 사람 근처에서 예약 가능한 모듈을 탐색하는 것을 허용하지 않습니다.

    데이터 유형: 부울
    result.reservation.reservable_module.enable_facet_filter 직장 항목에 대한 패싯 필터링을 사용할 수 있는지 여부를 나타내는 플래그입니다. 이 옵션을 사용하면 나타나는 필터 옵션은 검색 결과를 기반으로 합니다. 사용자는 생성된 검색 결과에서 사용할 수 있는 항목만 필터에서 선택할 수 있습니다.
    유효한 값은 다음과 같습니다.
    • true: 패싯 필터가 활성화됩니다.
    • false: 패싯 필터를 사용할 수 없습니다.

    데이터 유형: 부울
    result.reservation.reservable_module.enable_group_reservations 사용자가 그룹을 예약할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 단체 예약이 가능합니다.
    • false: 단체 예약을 할 수 없습니다.

    데이터 유형: 부울
    result.reservation.reservable_module.enable_ical_generation 사용자가 예약에 대한 iCalendar를 생성할 수 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: iCalendar 생성이 허용됩니다.
    • false: iCalendar 생성이 허용되지 않습니다.

    데이터 유형: 부울
    result.reservation.reservable_module.font_awesome_icon 예약 가능한 모듈에 첨부된 글꼴 아이콘의 이름입니다.

    데이터 유형: 문자열
    result.reservation.reservable_module.inline_title 예약 가능한 모듈의 인라인 제목입니다. 제목은 Workplace 서비스 포털의 설명 텍스트와 나란히 표시됩니다.

    데이터 유형: 문자열
    result.reservation.reservable_module.layout_mapping 위치의 레이아웃 매핑 구조에 대한 상세 정보입니다. 이 데이터를 사용하여 UI에 정보를 배치합니다.

    데이터 유형: 객체

    "layout_mapping": {
  "body": [Array],
  "description": [Array],
  "image": "String",
  "subtitle": [Array],
  "subtitle_asc": [Array],
  "title": [Array]
}
    result.reservation.reservable_module.layout_mapping.body 프론트엔드 UI 데이터를 매핑하기 위한 자리 표시자입니다.

    데이터 유형: 객체 배열

    "body": [
  {
    "field": "String",
    "field_to_display": "String",
    "icon": "String",
    "label": "String"
  }
]
    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 승인 정책을 구현하는 방법을 지정하는 옵션입니다.
    선택:
    • 무효화 없음: 승인 정책은 직장 공간 또는 방의 승인 필요 필드에 설정된 대로 구현됩니다.
    • 항상 승인 필요: 직장 공간이나 방의 승인 필요 필드에 설정된 항목에 관계없이 승인 정책이 필요합니다.
    • 승인 필요 없음: 직장 공간 또는 회의실의 승인 필요l 필드에 설정된 항목에 관계없이 승인 정책이 제거됩니다.

    데이터 유형: 문자열
    result.reservation.reservable_module.require_cancel_notes 사용자가 예약 가능한 모듈을 취소하기 전에 취소 메모를 입력해야 하는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 취소 메모가 필요합니다.
    • false: 취소 메모가 필요하지 않습니다.

    데이터 유형: 부울
    result.reservation.reservable_module.require_cc_dept_check 작업 공간 항목과 로그인한 사용자 간에 비용 센터 또는 부서 불일치가 있는지 확인할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 불일치를 확인합니다.
    • false: 불일치를 확인하지 않습니다.

    데이터 유형: 부울
    result.reservation.reservable_module.require_subject 사용자가 예약할 때 제목을 입력해야 하는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 제목이 필수입니다.
    • false: 제목이 필요하지 않습니다.

    데이터 유형: 부울
    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 카드 뷰 또는 일정 뷰와 같이 예약 가능한 모듈과 연관된 여러 뷰에 대한 상세 정보입니다.

    데이터 유형: 객체

    "reservable_views": {
  "iconClass": "String",
  "isDefault": Boolean,
  "label": "String",
  "order": Number,
  "type": "String"
}

    테이블: 예약 가능한 뷰 [sn_wsd_rsv_reservable_view]
    result.reservation.reservable_module.reservable_views.icon클래스 예약 가능한 뷰의 아이콘 클래스입니다.

    데이터 유형: 문자열
    result.reservation.reservable_module.reservable_views.is기본값 이 예약 가능한 뷰를 예약 가능한 모듈의 기본값으로 설정할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 기본값으로 설정합니다.
    • false: 기본값으로 지정하지 않습니다.

    데이터 유형: 부울
    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 모두 찾아보기, 사람 근처 탐색과 같은 예약 가능한 모듈과 연결된 예약 경로입니다.

    데이터 유형: 객체 배열

    "reservation_paths": [
  {
    "displayValue": "String",
    "value": "String"
  }
]
    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 예약 가능한 모듈에 대해 맵 뷰를 사용할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 맵 뷰를 활성화합니다.
    • false: 맵 뷰를 활성화하지 마십시오.

    데이터 유형: 부울
    result.reservation.reservable_module.sys_id 예약 가능한 모듈의 Sys_id입니다.

    데이터 유형: 문자열
    result.reservation.reservable_module.timeSlots 예약 가능한 모듈과 연결된 시간 슬롯에 대한 상세 정보입니다.

    데이터 유형: 객체 배열

    [
  {
    "name": "String",
    "short_description": "String",
    "slot_end": "String",
    "slot_start": "String",
    "sys_id": "String"
  }
]
    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 예약 가능한 모듈과 연결된 가상 제공자에 대한 상세 정보입니다.

    데이터 유형: 객체

    "virtual_meeting_provider": {
  "display_value": "String",
  "sys_id": "String"
}
    result.reservation.reservable_module.virtual_meeting_provider.display_value 가상 회의 제공자의 표시 값입니다.

    데이터 유형: 문자열
    result.reservation.reservable_module.virtual_meeting_provider.sys_id 가상 회의 제공자의 Sys_id입니다.

    데이터 유형: 문자열
    결과.예약.예약 ACL 연결된 예약에 설정된 사용자 ACL(접근 통제 수준) 검사의 상세 정보입니다.

    데이터 유형: 객체

    "reservationAcl": {
  "read": Boolean,
  "write": {Object}
}
    result.reservation.reservationAcl.read 사용자가 이 예약을 읽을 수 있는지 확인할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 사용자가 예약을 읽을 수 있는지 확인합니다.
    • false: 사용자가 예약을 읽을 수 있는지 확인하지 않습니다.

    데이터 유형: 부울
    result.reservation.reservationAcl.write 연결된 예약에 대한 사용자의 쓰기 기능에 대한 상세 정보입니다.

    데이터 유형: 객체

    "write": {
  "allFields": Boolean,
  "fields": {Object},
  "record": Boolean
}
    result.reservation.reservationAcl.write.allFields 사용자가 객체에 지정된 모든 필드에 쓸 수 있는지 여부를 확인할지 여부를 나타내는 플래그입니다 reservationACL.write.fields . 사용자가 일부 특정 필드에만 액세스할 수 있는 경우 객체에서는 해당 필드만 true입니다 reservationACL.write.fields .
    유효한 값은 다음과 같습니다.
    • 예: 사용자가 객체에 지정된 reservationACL.write.fields 모든 필드에 쓸 수 있는지 확인합니다.
    • false: 사용자가 객체에 지정된 reservationACL.write.fields 모든 필드에 쓸 수 있는지 확인하지 않음

    데이터 유형: 부울
    결과.reservation.reservationAcl.write.fields 예약의 다양한 필드에 대한 접근 통제의 상세 정보입니다.

    데이터 유형: 객체

    "fields": {
  "location": Boolean,
  "number_of_attendees": Boolean,
  "requested_for": Boolean,
  "sensitivity": Boolean,
  "subject": Boolean
}
    result.reservation.reservationAcl.write.fields.location 사용자가 이 예약의 위치 필드에 쓸 수 있는지 확인할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 사용자가 위치 필드에 쓸 수 있는지 확인합니다.
    • false: 사용자가 위치 필드에 쓸 수 있는지 확인하지 않습니다.

    데이터 유형: 부울
    result.reservation.reservationAcl.write.fields.number_of_attendees 사용자가 이 예약의 참석자 수 필드에 쓸 수 있는지 확인할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • 예: 사용자가 참석자 수 필드에 쓸 수 있는지 확인합니다.
    • 아니오: 사용자가 참석자 수 필드에 쓸 수 있는지 확인하지 않습니다.

    데이터 유형: 부울
    result.reservation.reservationAcl.write.fields.requested_for 사용자가 이 예약의 요청 대상 필드에 쓸 수 있는지 확인할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • 예: 사용자가 요청 대상 필드에 쓸 수 있는지 확인합니다.
    • 아니오: 사용자가 요청 대상 필드에 쓸 수 있는지 확인하지 않습니다.

    데이터 유형: 부울
    결과.예약.예약Acl.쓰기.필드.민감도 사용자가 이 예약의 민감도 필드에 쓸 수 있는지 여부를 확인할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 사용자가 민감도 필드에 쓸 수 있는지 확인합니다.
    • false: 사용자가 민감도 필드에 쓸 수 있는지 확인하지 마세요.

    데이터 유형: 부울
    결과.reservation.reservationAcl.write.fields.subject 사용자가 이 예약의 제목 필드에 쓸 수 있는지 확인할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 사용자가 제목 필드에 쓸 수 있는지 확인합니다.
    • false: 사용자가 제목 필드에 쓸 수 있는지 확인하지 않습니다.

    데이터 유형: 부울
    결과.reservation.reservationAcl.write.record 사용자가 전체 예약 기록에 쓸 수 있는지 확인할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 사용자가 전체 예약 기록에 쓸 수 있는지 확인합니다.
    • false: 사용자가 전체 예약 기록에 쓸 수 있는지 확인하지 않습니다.

    데이터 유형: 부울
    result.reservation.reservation_purpose 예약 목적에 대한 상세 정보입니다.

    데이터 유형: 객체

    "reservation_purpose": {
  "display_value": "String",
  "value": "String"
}
    result.reservation.reservation_purpose.display_value 회사 회의와 같은 예약 목적의 값을 표시합니다.

    데이터 유형: 문자열
    result.reservation.reservation_purpose.값 예약 목적의 내부 값입니다(예: company_meeting).

    데이터 유형: 문자열
    result.reservation.reservation_type 예약 유형에 대한 상세 정보입니다.

    데이터 유형: 객체

    "reservation_type": {
  "display_value": "String",
  "value": "String"
}
    result.reservation.reservation_type.display_value 예약 유형에 대한 표시 값(예: 공간)입니다.

    데이터 유형: 문자열
    result.reservation.reservation_type.값 공간과 같은 예약 유형에 대한 내부 값입니다.

    데이터 유형: 문자열
    result.reservation.reservation_subtype 예약의 하위 유형에 대한 상세 정보입니다. 하위 유형은 단일, 다중 상위, 다중 하위, 반복 상위 또는 발생과 같은 예약 유형을 나타냅니다.

    데이터 유형: 객체

    "reservation_subtype": {
  "display_value": "String",
  "value": "String"
}
    result.reservation.reservation_subtype.display_value 예약의 하위 유형에 대한 표시 값(예: 단일)입니다.

    데이터 유형: 문자열
    result.reservation.reservation_subtype.값 예약의 하위 유형에 대한 내부 값입니다(예: 단일).

    데이터 유형: 문자열
    결과.예약.민감도 예약의 민감도에 대한 상세 정보입니다.

    데이터 유형: 객체

    "sensitivity": {
  "display_value": "String",
  "value": "String"
}
    result.reservation.sensitivity.display_value 예약의 민감도에 대한 표시 값(예: 높음 또는 낮음)입니다.

    데이터 유형: 문자열
    결과.예약.민감도.값 예약의 민감도에 대한 내부 값(예: 1 또는 3)입니다.

    데이터 유형: 문자열
    결과.예약.교대조 예약에 적용된 교대조에 대한 상세 정보입니다.

    데이터 유형: 객체

    "shift": {
  "display_value": "String",
  "name": "String",
  "shiftDetails": "String",
  "sys_id": "String"
}
    result.reservation.shift.display_value 교대조의 표시 값입니다.

    데이터 유형: 문자열
    result.reservation.shift.name 교대조의 이름입니다. 와 display_value같습니다.

    데이터 유형: 문자열
    Result.reservation.shift.shiftDetails 교대조의 상세 정보입니다.

    데이터 유형: 문자열
    result.reservation.shift.sys_id 교대조 기록의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 교대조 [sn_wsd_core_shift]
    결과.예약.소스 예약의 소스에 대한 상세 정보(예: 직장 서비스 또는 Google 메일)입니다.

    데이터 유형: 객체

    "source": {
  "display_value": "String",
  "value": "String"
}
    result.reservation.source.display_value 직장 서비스와 같은 예약 소스에 대한 값을 표시합니다.

    데이터 유형: 문자열
    결과.예약.소스.값 예약 소스의 내부 값입니다(예: ServiceNow).

    데이터 유형: 문자열
    result.reservation.source_icon 예약에 사용된 아이콘의 소스에 대한 상세 정보입니다. 이 아이콘은 UI에서 사용됩니다.

    데이터 유형: 객체

    "source_icon": {
  "classNames": "String",
  "imgSrc": "String",
  "tooltip": "String"
}
    result.reservation.source_icon.classNames 소스 아이콘의 쉼표로 구분된 클래스 이름입니다.

    데이터 유형: 문자열
    result.reservation.source_icon.imgSrc 소스 아이콘의 이미지 소스 이름입니다. 이 아이콘은 이미지 [db_image] 테이블에 저장됩니다.

    데이터 유형: 문자열
    result.reservation.source_icon.도구 설명 소스 아이콘과 연결된 도구 설명입니다.

    데이터 유형: 문자열
    result.reservation.source_reservation 현재 예약의 소스 예약입니다. 예를 들어, 반복 예약의 경우 반복 상위 예약은 발생 예약 시리즈의 소스입니다.

    데이터 유형: 객체

    "source_reservation": {
  "display_value": "String",
  "name": "String",
  "sys_id": "String"
}
    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 반복 예약을 요청한 사용자입니다.

    데이터 유형: 객체

    "source_reservation": {
  "name": "String",
  "sys_id": "String",
  "user_name": "String"
}
    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)
    결과.예약.상태 예약 상태에 대한 상세 정보입니다.

    데이터 유형: 객체

    "state": {
  "display_value": "String",
  "value": "String"
}
    result.reservation.state.display_value 예약의 현재 상태에 대한 표시 값(예: 확인됨)입니다.

    데이터 유형: 문자열
    결과.예약.상태.값 예약의 현재 상태에 대한 내부 값입니다(예: 2).

    데이터 유형: 문자열
    결과.예약.제목 예약의 제목입니다.

    데이터 유형: 문자열
    result.reservation.sub_source 예약의 하위 소스에 대한 상세 정보입니다. 하위 원본은 예약이 시작된 위치를 지정합니다(예: Google Calendar 또는 Microsoft Exchange).

    데이터 유형: 객체

    "sub_source": {
  "display_value": "String",
  "value": "String"
}
    result.reservation.sub_source.display_value 예약의 하위 소스(예: Google 달력)에 대한 표시 값입니다.

    데이터 유형: 문자열
    result.reservation.sub_source.값 예약의 하위 소스 필드에 대한 내부 값입니다(예: google_calendar).

    데이터 유형: 문자열
    result.reservation.sync_state 다른 서비스에서 예약의 동기화 상태에 대한 상세 정보(예: "sync_enqueued" 또는 "동기화됨")입니다.

    데이터 유형: 객체

    "sync_state": {
  "display_value": "String",
  "value": "String"
}
    result.reservation.sync_state.display_value 예약의 현재 동기화 상태에 대한 표시 값(예: 동기화됨)입니다.

    데이터 유형: 문자열
    result.reservation.sync_state.값 예약의 현재 동기화 상태에 대한 내부 값입니다(예: 동기화됨).

    데이터 유형: 문자열
    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}

    주:
    사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

    지원되는 요청 매개변수

    표 7. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다.

    데이터 유형: 문자열
    sys_id 전체 계열을 취소하려면 반복 상위 예약 기록의 sys_id 전달합니다.

    특정 계열 발생을 취소하려면 계열 발생 sys_id 전달합니다.

    반복되는 상위 기록에는 되풀이 상위로 설정된 열 reservation_subtype 있습니다. 개별 발생 기록에는 reservation_subtype 필드가 발생으로 설정되어 있습니다.

    발생 기록에서 반복되는 상위 예약에 대한 상세 정보를 얻으려면 발생 기록의 source_reservation 필드 sys_id 참조하십시오.

    데이터 유형: 문자열

    테이블: 직장 예약 [sn_wsd_rsv_reservation]
    표 8. 쿼리 매개변수
    이름 설명
    cancel_notes 예약 취소 이유입니다.

    데이터 유형: 문자열
    표 9. 요청 본문 매개변수
    이름 설명
    없음

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.

    표 10. 요청 헤더
    헤더 설명
    수용 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json
    컨텐츠-형식 요청 본문의 데이터 형식입니다. application/json만 지원합니다.
    표 11. 응답 헤더
    헤더 설명
    없음

    상태 코드

    다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

    표 12. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    401 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

    응답 본문 매개변수

    이름 설명
    결과 반복 예약 취소 요청에 대한 결과를 반환합니다.

    데이터 유형: 객체

    "result": {
  "failedToCancelOccurrenceReservations": [Array],
  "seriesId": "String",
  "success": Boolean,
  "successCanceledOccurrences": [Array],
  "user_msg": "String"
}
    result.failedToCancelOccurrenceReservations 취소하지 못한 개별 회의 발생 기록의 sys_ids 목록입니다.

    데이터 유형: 문자열 배열
    result.seriesId 전체 계열이 취소된 경우 반복되는 상위 항목의 Sys_id, 단일 항목이 취소된 경우 특정 발생의 sys_id입니다.

    데이터 유형: 문자열
    결과.성공 예약이 성공적으로 취소되었는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 성공적으로 취소되었습니다.
    • false: 작업이 실패했습니다.

    데이터 유형: 부울
    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

    주:
    사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

    지원되는 요청 매개변수

    표 13. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다.

    데이터 유형: 문자열
    표 14. 쿼리 매개변수
    이름 설명
    없음
    표 15. 요청 본문 매개변수
    이름 설명
    반복 패턴 예약의 반복 패턴에 대한 상세 정보입니다.

    데이터 유형: 객체

    "recurringPattern": {
  "duration": Number,
  "label": "String",
  "options": {Object},
  "repeats": "String",
  "startDate": "String"
}
    recurringPattern.duration 교대조 기반 예약이 아닌 경우 필요합니다.
    예약 가능 항목을 예약할 시간입니다.

    데이터 유형: 숫자

    단위: 초
    recurringPattern.label 반복 예약에 대한 설명이 포함된 이름입니다.

    데이터 유형: 문자열
    recurringPattern.options 필수
    반복 패턴에 대해 설정된 옵션에 대한 상세 정보입니다.

    데이터 유형: 객체

    "options": {
  "count": Number,
  "daysOfWeek": "String",
  "every": Number,
  "endDate": "String"
}
    recurringPattern.options.count 교대조 기반 예약이 아닌 경우 필수입니다. 교대조 기반 예약에 대해서는 무시됩니다.

    패턴을 반복하는 횟수입니다.

    데이터 유형: 숫자
    recurringPattern.options.daysOfWeek 매개변수가 repeats매주로 설정된 경우 필수입니다.

    예약 가능한 요일입니다.

    유효한 값은 다음과 같습니다.
    • 1 = 월요일
    • 2 = 화요일
    • 3 = 수요일
    • 4 = 목요일
    • 5 = 금요일
    • 6 = 토요일
    • 7 = 일요일

    예를 들어 화요일, 목요일, 금요일을 지정하려면 245(구분 기호 없음)를 전달합니다. repeats주별count이고 5이고 daysOfWeek 245이면 반환 결과에서 합계는 count*daysOfWeek.length (5*3=15)와 같습니다.

    데이터 유형: 문자열
    recurringPattern.options.every 패턴 반복 간격입니다. 예를 들어, 값 '2'는 속성 값에 따라 패턴이 2일 또는 2개월마다 반복됨을 repeats 나타냅니다.
    주:
    이 설정은 매주 반복 간격에 적용할 수 없습니다. 격주 반복 간격에 repeats 대해 속성을 매일 로 설정하고 이 값을 14 로 설정할 수 있습니다.

    데이터 유형: 숫자

    기본값: 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": Boolean,
  "location": "String",
  "reservable_module": "String",
  "shift": "String",
  "subject": "String"
}
    reservation.is_private 예약이 비공개인지 여부를 나타내는 플래그입니다. 비공개인 경우 예약은 소유자 외에는 누구에게도 표시되지 않습니다.

    이러한 개인 정보 설정에 대한 자세한 내용은 위치 개인 정보 설정 및 영향을 참조하십시오.

    유효한 값은 다음과 같습니다.
    • true: 예약은 비공개입니다.
    • false: 예약은 비공개가 아닙니다.

    데이터 유형: 부울

    기본값: 시스템 속성에서 개인정보 보호에 대해 설정된 값입니다.
    예약.위치 필수
    예약할 위치의 Sys_id입니다.

    데이터 유형: 문자열

    표: 직장 위치 [sn_wsd_core_workplace_location]
    reservation.reservable_module 필수 예약과 연결할 예약 가능한 모듈의 Sys_id입니다. 예약 가능한 모듈은 예약에 필요한 직장 항목을 정의합니다.

    데이터 유형: 문자열

    테이블: 예약 가능한 모듈 [sn_wsd_rsv_reservable_module]
    예약.교대조
    예약과 연결할 교대조의 Sys_id입니다. 이 매개 변수가 전달 end 되면 매개 변수가 필요하지 않습니다.

    교대조 기반 예약에 대한 자세한 내용은 교대조 기반 예약 사용을 참조하세요.

    데이터 유형: 문자열

    테이블: 교대조 [sn_wsd_core_shift]
    예약.subject 필수
    예약과 관련된 회의의 주제입니다.

    데이터 유형: 문자열

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.

    표 16. 요청 헤더
    헤더 설명
    수용 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json
    컨텐츠-형식 요청 본문의 데이터 형식입니다. application/json만 지원합니다.
    표 17. 응답 헤더
    헤더 설명
    없음

    상태 코드

    다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

    표 18. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    401 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다.
    500 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

    응답 본문 매개변수

    이름 설명
    결과 다중 예약 생성 또는 업데이트의 결과를 반환합니다.

    데이터 유형: 객체

    "result": {
  "isValid": Boolean,
  "parent": "String",
  "successfulReservations": [Array],
  "unSuccessfulReservations": [Array]
}
    result.isValid 예약이 성공적으로 생성되었는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 성공적으로 생성되었습니다.
    • false: 작업이 실패했습니다.

    데이터 유형: 부울
    결과.부모 업데이트된 상위 예약의 Sys_id입니다.

    데이터 유형: 문자열
    result.successfulReservations 성공적으로 업데이트된 예약 목록입니다.

    데이터 유형: 객체 배열

    "successfulReservations": [
  {
    "collision": Boolean,
    "end": "String",
    "error": "String",
    "inserted": Boolean,
    "start": "String"
    "sys_id": "String"
  }
]
    result.successfulReservations.collision 지정된 시간에 예약이 이미 존재하는지, 현재 예약과 상충하는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 충돌.
    • false: 충돌이 없습니다.

    데이터 유형: 부울
    result.successfulReservations.end 예약 종료 날짜 및 시간입니다.

    데이터 유형: 문자열

    형식: UTC: yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z)
    result.successfulReservations.error 예약을 생성하는 동안 문제가 발생한 경우의 오류 메시지입니다.

    데이터 유형: 문자열
    result.successfulReservations.inserted 예약이 성공적으로 삽입되었는지 여부를 나타내는 플래그입니다. 예약이 추가되는 경우와 같습니다.
    가능한 값:
    • true: 성공적으로 삽입했습니다.
    • false: 작업이 실패했습니다.

    데이터 유형: 부울
    결과.성공예약.시작 예약 시작 날짜 및 시간입니다.

    데이터 유형: 문자열

    형식: UTC - yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z)
    result.successfulReservations.sys_id 생성된 예약의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 직장 예약 [sn_wsd_rsv_reservation]
    result.unSuccessfulReservations 업데이트에 실패한 예약 목록입니다.

    데이터 유형: 객체 배열

    "unSuccessfulReservations": [
  {
    "collision": Boolean,
    "end": "String",
    "error": "String",
    "inserted": Boolean,
    "start": "String"
    "sys_id": "String"
  }
]
    result.unSuccessfulReservations.collision 지정된 시간에 예약이 이미 존재하는지, 현재 예약과 상충하는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 충돌.
    • false: 충돌이 없습니다.

    데이터 유형: 부울
    result.unSuccessfulReservations.end 예약 종료 날짜 및 시간입니다.

    데이터 유형: 문자열

    형식: UTC: yyyy-mm-ddThh:mm:ssZ(예: 2021-02-05T18:00:00Z)
    result.unSuccessfulReservations.error 예약을 생성하는 동안 문제가 발생한 경우의 오류 메시지입니다.

    데이터 유형: 문자열
    result.unSuccessfulReservations.inserted 예약이 성공적으로 삽입되었는지 여부를 나타내는 플래그입니다. 예약이 추가되는 경우와 같습니다.
    가능한 값:
    • true: 성공적으로 삽입했습니다.
    • false: 작업이 실패했습니다.

    데이터 유형: 부울
    결과.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"
      }
    ]
  }
}