다음을 통해 공유


되풀이 약속 시리즈, 인스턴스 또는 예외 만들기

 

게시 날짜: 2017년 1월

적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

되풀이 약속 마스터(시리즈)를 만들 때 Microsoft Dynamics 365에서는 지정된 되풀이 정보에 따라 개별 약속 인스턴스를 만듭니다. 개별 되풀이 약속 인스턴스와 해당 인스턴스에 대한 예외도 만들 수 있으며 약속을 되풀이 약속으로 변환할 수 있습니다.

이 항목의 내용

되풀이 약속 시리즈 만들기

되풀이 약속 인스턴스 만들기

되풀이 약속 예외 만들기

약속을 되풀이 약속으로 변환합니다.

되풀이 약속 시리즈 만들기

되풀이 약속 시리즈를 만들려면(RecurringAppointmentMaster 레코드) BookRequest 메시지, CreateRequest 메시지 또는 IOrganizationService.Create 메서드를 사용할 수 있습니다.

되풀이 약속 시리즈를 만들 때 다음과 같은 동작이 발생합니다.

  1. 되풀이 약속 시리즈에 대한 기본 및 되풀이 정보가 포함된 RecurringAppointmentMaster 레코드(되풀이 약속 시리즈)가 만들어집니다.RecurringAppointmentMaster.ActivityId 속성을 사용하여 각 레코드를 고유하게 식별할 수 있습니다. 또한 이 되풀이 약속 시리즈는 활동(ActivityPointer) 레코드로도 만들어지고 저장됩니다.ActivityPointer.ActivityId 속성을 사용하여 활동 레코드를 고유하게 식별할 수 있습니다.

  2. 개별 되풀이 약속 인스턴스는 되풀이 정보에 따라 만들어지고 Appointment 레코드로 저장됩니다. 이러한 약속 개체는 Appointment.SeriesId 속성을 사용하여 상위 되풀이 약속 시리즈에 연결되고 상위 되풀이 약속 시리즈 ID(ActivityPointer.SeriesId)와 동일한 값을 사용합니다.

    Appointment.InstanceTypeCode 속성의 값은 이러한 약속 개체에 대해 되풀이 인스턴스(선택 목록 값 2)로 설정됩니다.

    참고

    되풀이 약속 인스턴스는 확장 모델과 확장 모델을 정의하는 매개 변수를 기반으로 생성됩니다.추가 정보:되풀이 약속 부분 확장 모델.

되풀이 약속 시리즈를 만드는 방법을 보여 주는 샘플 코드는 샘플: 되풀이 약속 만들기, 검색, 업데이트 및 삭제를 참조하십시오.

되풀이 약속 인스턴스 만들기

되풀이 약속 인스턴스(RecurringAppointmentMaster 레코드)를 만들기 위해 CreateInstanceRequest를 사용할 수 있습니다. 이 메시지는 두 개의 매개 변수를 사용합니다. 만들어지는 인스턴스 수와 인스턴스를 만들어야 하는 되풀이 약속 시리즈입니다.

되풀이 약속 시리즈의 마지막 인스턴스 후 인스턴스가 만들어집니다. 또한 만들기 위해 지정한 인스턴스 수와 상관 없이 인스턴스는 이후 인스턴스 마감 날짜까지만 만들어집니다.

되풀이 약속 예외 만들기

되풀이 약속의 인스턴스를 업데이트하거나 삭제할 때 예외가 만들어집니다. 되풀이 약속 인스턴스는 다른 약속처럼 약속 레코드로 저장되고 약속 레코드의 Appointment.InstanceTypeCode 특성을 사용하여 되풀이 인스턴스(선택 목록 값 2)의 값을 갖는 되풀이 약속 인스턴스를 식별할 수 있습니다.

다음과 같은 방법으로 예외를 만들 수 있습니다.

  • Appointment 엔터티에 UpdateRequest 클래스를 사용하여 되풀이 약속 인스턴스를 업데이트하고 Appointment.InstanceTypeCode 특성의 값을 되풀이 예외(선택 목록 값 3)로 설정합니다.

  • Appointment 엔터티에 DeleteRequest 클래스를 사용하여 되풀이 약속 인스턴스를 삭제합니다. 약속 인스턴스를 삭제하면 상위 약속 시리즈 개체에 대해 RecurringAppointmentMaster.DeletedExceptionsList 특성에서 인스턴스의 항목을 만들어 예외로 표시합니다.

  • Appointment 엔터티에 CreateExceptionRequest 클래스를 사용합니다.

약속을 되풀이 약속으로 변환합니다.

되풀이 약속은 되풀이 정보가 포함된 약속입니다.Microsoft Dynamics 365의 기존 약속을 AddRecurrenceRequest를 사용하여 되풀이 약속으로 변환할 수 있습니다. 기존 약속을 되풀이 약속으로 변환하면 기존 약속의 데이터는 새 되풀이 약속 마스터 인스턴스에 복사되고 기존 약속은 삭제됩니다.

참고 항목

되풀이 약속 엔터티
되풀이 약속 업데이트
샘플: 되풀이 약속 만들기, 검색, 업데이트 및 삭제
샘플: 되풀이 약속으로 약속 변환

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 저작권 정보