更新定期约会

项目
03/04/2017

发布日期： 2017年1月

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

可以更新整个系列或更新定期约会的一个实例。

更新定期约会系列

可以使用 RecurringAppointmentMaster 实体中的 IOrganizationService.Update 方法或 UpdateRequest 消息更新定期约会系列。您可以更新基本或定期信息。

更新基本信息

在更新定期约会系列的基本信息（如主题、位置或与会者）时，除了在同一属性中存在异常的实例外，会更新定期约会系列中的所有实例。

更新定期信息

在更新定期约会系列的定期信息（如模式和范围）时，会出现以下情况：

创建一个具有新 RecurringAppointmentMaster.ActivityId 的新系列，该系列与原始系列包含相同信息，并且新系列的 RecurringAppointmentMaster.EffectiveEndDate 属性中的日期设置为原始系列的最后一个过去的实例。将删除原始系列的所有将来实例。这样，原始系列将结束，过去实例的历史记录通过存储在新系列中而保留在系统中。
新信息用于从有效的开始日期 (RecurringAppointmentMaster.EffectiveStartDate) 创建新系列的未来实例。

而且，原始系列和新系列的 RecurringAppointmentMaster.GroupId 属性会用同一个值来填充。这意味着只要更新定期约会系列中的定期信息，创建的所有新系列将与更新的定期约会系列具有相同的 RecurringAppointmentMaster.GroupId 属性值（尽管每个系列具有唯一的系列 ID）。

备注

在更新所有实例都计划于将来发生的定期约会系列的定期信息时，会删除所有实例，新定期信息将用于创建或扩展新实例。

若要查看用于更新定期约会系列的示例代码，请参阅示例：重新计划和取消定期约会。

更新定期约会实例

由于定期约会记录存储为约会对象，因此可以使用 Appointment 实体中的 IOrganizationService.Update 方法更新定期约会实例。更新定期约会实例时，会将该实例标记为定期约会系列的例外。详细信息：创建定期约会例外

也可以使用 Appointment 实体中的 CreateExceptionRequest 类更新定期约会实例。

提示

可以使用 Appointment.InstanceTypeCode 属性（其值将为“2”（定期实例））标识定期约会实例。详细信息：约会实体消息和方法

另请参阅

定期约会实体
 删除或结束定期约会系列或实例
 示例：创建、检索、更新和删除定期约会
 示例：重新计划和取消定期约会

Microsoft Dynamics 365

通过