发布自定义项

发布日期： 2017年1月

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

通过发布自定义项，可以使 Web 应用程序了解对影响用户界面的数据的更改。

何时发布自定义项

在创建新项或删除现有项时自动发布自定义项。

在更新影响用户界面的架构元数据或实体后，必须发布更改。可以决定等待一起发布一组相关更改。

只随解决方案导出已发布的自定义项。在导出解决方案之前，应始终发布自定义项。

当执行将显示在适用于平板电脑的 Microsoft Dynamics 365 中的自定义项时，您应始终明确发布自定义项，以确保每个项与适用于平板电脑的 Dynamics 365 应用程序同步。

备注

发布自定义项会干扰常规系统运行。在生产环境中，建议您安排在对用户干扰最小时发布自定义项。

下表列出了可用于发布自定义项的两个消息。

消息	说明
PublishAllXmlRequest	发布所有自定义项。
PublishXmlRequest	发布指定自定义项。

使用 PublishXmlRequest 消息时，通过 ParameterXml 参数指定要发布哪些项。 ParameterXML 必须符合 Publish request schema。

如果要创建应用程序以编辑 Microsoft Dynamics 365 中的可自定义项，必须检索这些项的所有未发布的定义。如果开发人员定义一些更改但不发布它们，则您的应用程序必须能够检索它们才能在用户界面中显示它们。

使用以下两个方法来检索未发布的元数据：

RetrieveAsIfPublished 参数
使用以下消息检索实体、属性、实体关系和选项集数据：
RetrieveUnpublished 请求
使用以下消息检索用户界面项，例如窗体、模板、可视化项和 Web 资源定义：
- RetrieveUnpublishedRequest
- RetrieveUnpublishedMultipleRequest

Microsoft Dynamics 365