WSD 반복 예약 API

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 소요 시간: 92분

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

    이 API에 접근하려면 호출자에게 sn_wsd_core.workplace_user 역할이 있어야 하며 Workplace Safety Management(sn_wsd_core) 및 Workplace Reservation Management(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}

    지원되는 요청 매개변수

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

    데이터 유형: 문자열
    parent_id 반복 상위 예약 기록의 Sys_id입니다. 직장 예약 [sn_wsd_rsv_reservation] 테이블에 있습니다.

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

    하위 기록 내에서 연결된 반복 상위 기록의 sys_id source_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": {OObject},
  "source_reservation_requester": {Object},
  "start": "String",
  "state": {OObject},
  "sys_created_on": "String",
  "sys_id": "String",
  "sys_updated_on": "String",
  "subject": "String",
  "sub_source": {Object},
  "sync_state": {Object},
  "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_of.

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

    데이터 유형: 문자열
    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.value 예약의 현재 체크인 상태에 대한 내부 값(예: 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.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 이 예약이 상위 예약인지 여부를 나타내는 플래그입니다.
    가능한 값:
    • 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,
  "reservable_module": {Object},
  "region": {Object},
  "reservation": {Object},
  "site": {Object},
  "requested_for": {Object},
  "state": {Object},
  "sys_id": "String",
}
    결과.예약.위치.지역 위치와 연결된 영역에 대한 세부 정보입니다.

    데이터 유형: 객체

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

    데이터 유형: 부울
    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 - 빌딩1).

    데이터 유형: 문자열
    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 예약 가능한 모듈의 인라인 제목입니다. 제목은 직장 서비스 포털의 설명 텍스트와 나란히 표시됩니다.

    데이터 유형: 문자열
    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.이름 예약을 요청한 사용자의 이름입니다.

    데이터 유형: 문자열
    result.reservation.location.reservation.requested_for.sys_id 요청 대상 사용자의 Sys_id입니다. 사용자 [sys_user] 테이블에 있습니다.

    데이터 유형: 문자열
    result.reservation.location.reservation.requested_for.사용자_이름 예약을 요청한 사용자의 사용자 이름입니다.

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

    데이터 유형: 객체

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

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

    데이터 유형: 문자열
    result.reservation.location.site 위치가 속한 사이트입니다. 사이트 [sn_wsd_core_site] 테이블에 있습니다.

    데이터 유형: 객체

    "site": {
  "active": Boolean,
  "display_value": "String",
  "sys_id": "String",
}
    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 이 예약의 참석자 수입니다.

    데이터 유형: number
    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.사용자_이름 예약을 연 사용자의 사용자 이름입니다.

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

    데이터 유형: 문자열
    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.amountOfDates (금액오브데이트) 예약 가능한 항목이 예약된 날짜 수입니다.

    데이터 유형: 문자열
    result.reservation.recurring_pattern.기간
    예약 가능한 예약 시간 길이입니다.

    데이터 유형: 숫자

    단위: 초
    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(구분 기호 없음)를 전달합니다. is weekly, count is 5 및 daysOfWeek is 245인 경우 repeats 반환 결과에서 합계는 count*daysOfWeek.length (5*3=15)와 같습니다.

    데이터 유형: 문자열
    result.reservation.recurring_pattern.options입니다.모든 패턴 반복 간격. 예를 들어, 값 '2'는 속성 값 repeats 에 따라 패턴이 2일 또는 2개월마다 반복됨을 나타냅니다.
    주:
    매주 반복 간격에는 이 설정을 적용할 수 없습니다. 격주 반복 간격에 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 회의 반복의 종료 날짜 및 시간(예: "2022-07-08T14:00:00Z").

    데이터 유형: 문자열

    형식: UTC yyyy-mm-dd hh:mm:ss
    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.시작 날짜 Gdt
    "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.사용자_이름 대신 예약한 사용자의 사용자 이름입니다.

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

    데이터 유형: 문자열
    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": {JSON 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: 사용자가 사람 근처에서 예약 가능한 모듈을 탐색할 수 있도록 허용합니다.
    • 아니오: 사용자가 사람 근처에서 예약 가능한 모듈을 탐색하는 것을 허용하지 않습니다.

    데이터 유형: 부울
    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: 사용자가 사람 근처에서 예약 가능한 모듈을 탐색할 수 있도록 허용합니다.
    • 아니오: 사용자가 사람 근처에서 예약 가능한 모듈을 탐색하는 것을 허용하지 않습니다.

    데이터 유형: 부울
    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 예약 가능한 모듈의 인라인 제목입니다. 제목은 직장 서비스 포털의 설명 텍스트와 나란히 표시됩니다.

    데이터 유형: 문자열
    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.본문 프런트 엔드 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.설명 프런트 엔드 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.제목 프런트 엔드 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 카드 뷰 또는 일정 뷰와 같이 예약 가능한 모듈과 연결된 다양한 뷰에 대한 상세 정보입니다.

    예약 가능한 뷰 [sn_wsd_rsv_reservable_view] 테이블에 있습니다.

    데이터 유형: 객체

    "reservable_views": {
  "iconClass": "String",
  "isDefault": Boolean,
  "label": "String",
  "order": Number,
  "type": "String"
}
    result.reservation.reservable_module.reservable_views.icon클래스 예약 가능한 뷰의 아이콘 클래스입니다.

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

    데이터 유형: 부울
    result.reservation.reservable_module.reservable_views.레이블 예약 가능한 뷰의 이름입니다.

    데이터 유형: 문자열
    result.reservation.reservable_module.reservable_views.주문 UI에서 예약 가능한 모듈에 대한 뷰가 표시되는 순서입니다. UI에서 순서 번호가 낮을수록 먼저 표시됩니다. 동일한 주문 번호의 경우 무작위 순서가 할당됩니다.

    데이터 유형: 숫자
    result.reservation.reservable_module.reservable_views.type 예약 가능한 뷰의 백엔드 이름입니다. 내부 처리에 사용됩니다.

    데이터 유형: 문자열
    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.제목 예약 가능한 모듈의 제목입니다.

    데이터 유형: 문자열
    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입니다.

    데이터 유형: 문자열
    result.reservation.reservationAcl 연결된 예약에 설정된 사용자 접근 제어 수준(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 . 사용자가 일부 특정 필드에만 액세스할 수 있는 경우 해당 필드만 객체에서 reservationACL.write.fields true입니다.
    유효한 값은 다음과 같습니다.
    • true: 사용자가 개체에 reservationACL.write.fields 지정된 모든 필드에 쓸 수 있는지 여부를 확인합니다.
    • false: 사용자가 개체에 지정된 모든 필드에 쓸 수 있는지 확인하지 않습니다.reservationACL.write.fields

    데이터 유형: 부울
    result.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 사용자가 이 예약의 요청 대상 필드에 쓸 수 있는지 여부를 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 사용자가 요청 대상 필드에 쓸 수 있는지 확인합니다.
    • false: 사용자가 요청 대상 필드에 쓸 수 있는지 확인하지 않습니다.

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

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

    데이터 유형: 부울
    result.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.value 예약의 목적에 대한 내부 값입니다(예: company_meeting).

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

    데이터 유형: 객체

    "reservation_type": {
  "display_value": "String,"
  "value": "String"
}
    result.reservation.reservation_type.display_value 공간과 같은 예약 유형에 대한 값을 표시합니다.

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

    데이터 유형: 문자열
    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.sys_id 교대조 기록의 Sys_id입니다. 교대조 [sn_wsd_core_shift] 테이블에 있습니다.

    데이터 유형: 문자열
    결과.예약.소스 예약 소스에 대한 상세 정보(예: 직장 서비스 또는 Google Mail)입니다.

    데이터 유형: 객체

    "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.클래스 이름 소스 아이콘의 클래스 이름(쉼표로 구분됨).

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

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

    데이터 유형: 문자열
    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.이름 반복 예약 요청자의 이름입니다.

    데이터 유형: 문자열
    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 캘린더 또는 Microsoft Exchange)를 지정합니다.

    데이터 유형: 객체

    "sub_source": {
  "display_value": "String,"
  "value": "String"
}
    result.reservation.sub_source.display_value Google 달력과 같은 예약의 하위 소스에 대한 값을 표시합니다.

    데이터 유형: 문자열
    result.reservation.sub_source.value 예약의 하위 소스 필드에 대한 내부 값입니다(예: 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.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 반복 예약 - 패치 /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}

    지원되는 요청 매개변수

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

    데이터 유형: 문자열
    sys_id 전체 계열을 취소하려면 반복 상위 예약 기록의 sys_id 전달합니다. 직장 예약 [sn_wsd_rsv_reservation] 테이블에 있습니다.

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

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

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

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

    지원되는 요청 매개변수

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

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

    데이터 유형: 객체

    "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(구분 기호 없음)를 전달합니다. is weekly, count is 5 및 daysOfWeek is 245인 경우 repeats 반환 결과에서 합계는 count*daysOfWeek.length (5*3=15)와 같습니다.

    데이터 유형: 문자열
    recurringPattern.options.every 패턴 반복 간격. 예를 들어, 값 '2'는 속성 값 repeats 에 따라 패턴이 2일 또는 2개월마다 반복됨을 나타냅니다.
    주:
    매주 반복 간격에는 이 설정을 적용할 수 없습니다. 격주 반복 간격에 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입니다. 교대조 [sn_wsd_core_shift] 테이블에 있습니다. 이 매개 변수가 전달되면 end 매개 변수가 필요하지 않습니다.

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

    데이터 유형: 문자열
    예약.대상 필수
    예약과 관련된 회의의 주제입니다.

    데이터 유형: 문자열

    헤더

    다음 요청 및 응답 헤더는 이 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.is유효함 예약이 성공적으로 생성되었는지 여부를 나타내는 플래그입니다.
    가능한 값:
    • true: 성공적으로 생성되었습니다.
    • false: 작업이 실패했습니다.

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

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

    데이터 형식: 객체 배열

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

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

    데이터 유형: 문자열

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

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

    데이터 유형: 부울
    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 업데이트에 실패한 예약 목록입니다.

    데이터 형식: 객체 배열

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

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

    데이터 유형: 문자열

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

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

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