建立週期性約會系列、執行個體或例外

發行︰ 2016年11月

適用於： Dynamics CRM 2015

當您建立主要週期性約會 (系列)，Microsoft Dynamics 365 會依據指定週期資訊建立個別的約會執行個體。您也可以建立個別的週期性約會執行個體和這些執行個體的例外，以及將約會轉換為週期性約會。

本主題內容

建立週期性約會系列

建立週期性約會執行個體

建立週期性約會例外

將約會轉換成週期性約會

若要建立週期性約會系列 (RecurringAppointmentMaster 記錄)，您可以使用 BookRequest 訊息、CreateRequest 訊息或 IOrganizationService.Create 方法。

當您建立週期性約會系列時，會發生下列事項：

建立 RecurringAppointmentMaster 記錄 (週期性約會系列)，其中包含週期性約會系列的基本和週期資訊。使用 RecurringAppointmentMaster.ActivityId 屬性，每個記錄可唯一識別。進一步，此週期性約會系列也會建立並儲存為活動 (ActivityPointer) 記錄。使用 ActivityPointer.ActivityId 屬性，活動記錄可唯一識別。
個別的週期性約會執行個體根據週期資訊建立並儲存為 Appointment 記錄。這些約會物件使用 Appointment.SeriesId 屬性與上層週期性約會系列相關聯，而且有與上層週期性約會系列識別碼 (ActivityPointer.SeriesId) 相同的值。

Appointment.InstanceTypeCode 屬性的值設為這些約會物件的 [週期性執行個體] (挑選清單值 2)。

注意

週期性約會執行個體根據擴充模型與定義參數建立。其他資訊：週期性約會部分擴充模型。

如需示範如何建立週期性約會系列的範例程式碼，請參閱範例：建立、擷取、更新和刪除週期性約會。

若要建立週期性約會執行個體 (RecurringAppointmentMaster 記錄)，您可以使用 CreateInstanceRequest。此訊息接受兩個參數：要建立的執行個體數目和必須建立執行個體的週期性約會系列。

在週期性約會系列中的最後執行個體之後，建立執行個體。此外，執行個體僅建立在未來的執行個體截期日期之前，不論您指定要建立的執行個體數目為何。

更新或刪除週期性約會執行個體時，建立例外。週期性約會執行個體儲存為約會記錄如同其他約會，而且使用約會記錄的 Appointment.InstanceTypeCode 屬性，其具有 [週期性執行個體] (挑選清單值 2) 的值，您將識別週期性約會執行個體。

您可以用下列方式建立例外：

使用 Appointment 實體的 UpdateRequest 類別更新週期性約會執行個體，並將 Appointment.InstanceTypeCode 屬性的值設定為 [週期性例外] (挑選清單值 3)。
使用 Appointment 實體的 DeleteRequest 類別刪除週期性約會執行個體。刪除約會執行個體，會透過在上層約會系列物件的 RecurringAppointmentMaster.DeletedExceptionsList 屬性中建立執行個體項目，將其標記為例外。
使用 Appointment 實體的 CreateExceptionRequest 類別。

週期性約會是具有週期資訊的約會。使用 AddRecurrenceRequest，您會將 Microsoft Dynamics 365 的現有約會轉換為週期性約會。當您將現有的約會轉換為週期性約會時，從現有約會的資料將複製到新的主要週期性約會執行個體，以及刪除現有約會。