更新週期性約會

文章
03/04/2017

發佈日期： 2017年1月

適用對象： Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

您可以更新整個系列或更新週期性約會的執行個體。

更新週期性約會系列

您可以使用 RecurringAppointmentMaster 實體上的 IOrganizationService.Update 方法或 UpdateRequest 訊息更新週期性約會系列。您可以更新「基本」(Basic) 或「週期性」(Recurrence) 資訊。

更新基本資訊

當您更新週期性約會系列的基本資訊，例如主旨、地點或參與者時，週期性約會系列中的所有執行個體都會更新，除了在相同屬性上有例外狀況的執行個體之外。

更新週期性資訊

當您更新週期性約會系列的週期性資訊，例如模式和範圍時，會發生下列情況：

會建立具有新 RecurringAppointmentMaster.ActivityId 的新系列，其中包含與原始系列相同的資訊，而新系列的 RecurringAppointmentMaster.EffectiveEndDate 屬性中的日期會設定為原始系列中上一次發生的執行個體。原始系列的未來所有執行個體都會刪除。採用此方式時，原始系列將會結束，而過去的執行個體的歷程記錄會保留在系統中，並儲存於新系列中。
新資訊可用來建立新系列未來的執行個體，從有效的開始日期 (RecurringAppointmentMaster.EffectiveStartDate) 開始。

此外，原始系列和新系列的 RecurringAppointmentMaster.GroupId 屬性中會填入相同的值。這表示，只要更新週期性約會系列中的週期性資訊，建立的所有新系列的 RecurringAppointmentMaster.GroupId 屬性都會與更新的週期性約會系列擁有相同的值，雖然每個系列都有唯一的系列識別碼。

備註

當您更新會將所有執行個體延遲到未來發生的週期性約會系列的週期性資訊時，所有執行個體都會刪除，而新的週期性資訊會用於建立或擴充新執行個體。

若要查看更新週期性約會系列的範例程式碼，請參閱範例：重新排程和取消週期性約會。

更新週期性約會執行個體

因為週期性約會記錄會儲存為約會物件，所以您可以使用 Appointment 實體上的 IOrganizationService.Update 方法更新週期性約會執行個體。當您更新週期性約會執行個體時，執行個體會標示為週期性約會系列的例外狀況。其他資訊：建立週期性約會例外

您也可以使用 Appointment 實體的 CreateExceptionRequest 類別更新週期性約會執行個體。

提示

使用 Appointment.InstanceTypeCode 屬性可以識別週期性約會執行個體，它的值為 "2" (週期性執行個體)。其他資訊：Appointment 實體訊息和方法

另請參閱

週期性約會實體
 刪除或結束週期性約會系列或執行個體
 範例：建立、擷取、更新和刪除週期性約會
 範例：重新排程和取消週期性約會

Microsoft Dynamics 365

分享方式：