创建定期约会系列、实例或异常

发布日期： 2017年1月

适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online

在您创建定期约会母版（系列）时，这样，Microsoft Dynamics 365 会基于指定的定期信息创建个人约会实例。您还可以创建个人定期约会实例以及针对这些实例的例外情况，并且您可以将约会转换为定期约会。

本主题内容

创建定期约会系列

创建定期约会实例

创建定期约会例外

将约会转换为定期约会

若要创建定期约会系列（RecurringAppointmentMaster 记录），您可以使用 BookRequest 消息、CreateRequest 消息或 IOrganizationService.Create 方法。

当您创建定期约会系列时，会发生下列情况：

会创建一个包含关于定期约会系列的基本信息和定期信息的 RecurringAppointmentMaster 记录（定期约会系列）。每个记录可以使用 RecurringAppointmentMaster.ActivityId 属性来唯一标识。此外，此定期约会系列还会作为活动 (ActivityPointer) 记录进行创建和存储。活动记录可以使用 ActivityPointer.ActivityId 属性来唯一标识。
个人定期约会实例是基于定期信息来创建，并且会被存储为 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 类。

定期约会就是含有定期信息的约会。您可以通过使用 AddRecurrenceRequest 将 Microsoft Dynamics 365 内的现有约会转换为定期约会。当您将现有约会转换为定期约会时，来自现有约会的数据会被复制至新的定期约会母版实例，现有约会会被删除。

Microsoft Dynamics 365