WSD 반복 예약 API

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기92분

    • (WSD) 반복 예약 API는 Workplace Service Delivery 동시에 발생하지만 날짜가 다른 예약을 관리하기 위한 엔드포인트를 제공합니다.

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

    이 API는 sn_wsd_rsv 네임스페이스에서 실행됩니다.

    에 대한 Workplace Reservation Management자세한 내용은 Workplace Reservation Management를 참조하십시오.

    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, 또는, text/xmlapplication/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.값 예약의 현재 체크인 상태에 대한 내부 값입니다(예: 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 Workplace Service Delivery 또는 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: 영역이 활성 상태입니다.
    • 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 예약 가능한 모듈의 인라인 제목입니다. 제목은 직장 서비스 포털의 설명 텍스트와 나란히 나타납니다.

    데이터 유형: 문자열
    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 확인됨 등 예약의 현재 상태에 대한 값을 표시합니다.

    데이터 유형: 문자열
    결과.reservation.location.reservation..state.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 이 예약의 참석자 수입니다.

    데이터 유형: 숫자
    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.값 예약을 연 사용자의 내부 값입니다.

    데이터 유형: 문자열
    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.옵션.횟수

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

    데이터 유형: 숫자
    result.reservation.recurring_pattern.옵션.daysOfWeek

    예약 가능한 항목이 필요한 요일입니다.

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

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

    데이터 유형: 문자열
    result.reservation.recurring_pattern.옵션.모든 패턴 반복 간격입니다. 예를 들어, 이 값이 2이면 매개변수의 선택 repeats 에 따라 격일로 또는 격주로 패턴을 반복합니다.

    데이터 유형: 숫자
    result.reservation.recurring_pattern.옵션.Enddate 회의가 반복되는 종료 날짜 및 시간입니다(예: "2022-07-08T14:00:00Z").

    데이터 유형: 문자열

    형식: UTC yyyy-mm-dd hh:mm:ss
    result.reservation.recurring_pattern.옵션.endDateGdt 회의가 반복되는 종료 날짜 및 시간입니다(예: "2022-07-08T14:00:00Z").

    데이터 유형: 문자열

    형식: UTC yyyy-mm-dd hh:mm:ss
    result.reservation.recurring_pattern.반복

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

    유효한 값은 다음과 같습니다. (대/소문자 구분)
    • 매일
    • 월별
    • 주별
    • 매년

    데이터 유형: 문자열
    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.가치 대신 예약이 이루어진 사용자의 내부 값입니다.

    데이터 유형: 문자열
    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: 사용자가 사람 근처에 있는 예약 가능한 모듈을 찾아볼 수 있도록 허용합니다.
    • 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: 민감도를 설정할 수 없습니다. 일반이 기본값으로 설정됩니다.

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

    데이터 유형: 문자열
    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.자막_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.iconClass 예약 가능한 뷰의 아이콘 클래스입니다.

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

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

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

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

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

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

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

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

    데이터 유형: 부울
    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.가치 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.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.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 캘린더 또는 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 반복 예약 - 패치 /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(구분 기호 없음)를 전달합니다. 주별이고 count 5이고 daysOfWeek 245인 경우 repeats 반환 결과에서 합계는 count*daysOfWeek.length(5*3=15)와 같습니다.

    데이터 유형: 문자열
    recurringPattern.options.every 패턴 반복 간격입니다. 예를 들어, 이 값이 2이면 매개변수의 선택 repeats 에 따라 격일로 또는 격주로 패턴을 반복합니다.

    데이터 유형: 숫자
    recurringPattern.options.endDate 회의가 반복되는 종료 날짜 및 시간입니다(예: "2022-07-08T14:00:00Z").

    데이터 유형: 문자열

    형식: UTC yyyy-mm-dd hh:mm:ss
    recurringPattern.options.repeats 교대조 기반 예약이 아닌 경우 필요합니다.

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

    유효한 값은 다음과 같습니다. (대/소문자 구분)
    • 매일
    • 월별
    • 주별
    • 매년

    데이터 유형: 문자열
    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: 예약이 비공개가 아닙니다.

    데이터 유형: 부울

    기본값: 시스템 속성에서 개인정보 보호를 위해 설정된 값입니다.
    reservation.location 필수
    예약할 위치의 Sys_id입니다. 직장 위치[sn_wsd_core_workplace_location] 테이블에 있습니다.

    데이터 유형: 문자열
    reservation.reservable_module 필수 예약과 연결할 예약 가능한 모듈의 Sys_id입니다. 예약 가능한 모듈은 예약 에 필요한 직장 항목을 정의합니다. 예약 가능한 모듈 [sn_wsd_rsv_reservable_module] 테이블에 있습니다.

    데이터 유형: 문자열
    예약.교대
    예약과 연결할 교대조의 Sys_id입니다. 교대조 [sn_wsd_core_shift] 테이블에 있습니다. 이 매개 변수가 전달 end 되면 매개 변수가 필요하지 않습니다.

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

    데이터 유형: 문자열
    reservation.제목 필수
    예약과 연결된 회의의 주제입니다.

    데이터 유형: 문자열

    헤더

    다음 요청 및 응답 헤더는 이 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: 충돌이 없습니다.

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

    데이터 유형: 문자열

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

    데이터 유형: 문자열
    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)
    결과.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"
      }
    ]
  }
}