在 Microsoft Dynamics 365 以后的版本中提供重要的更改

  • 项目

 

发布日期： 2017年1月

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

在为 Microsoft Dynamics 365 的未来版本计划软件开发时可以使用本主题中的信息。 有关管理员和 IT 专家应考虑为 Dynamics 365 的未来版本做更改的信息，请参阅 TechNet：Microsoft Dynamics CRM 未来版本中的重要更改。

已弃用意味着我们想要在 Dynamics 365 的未来任何“主要”版本中删除功能或特性。 功能或特性被正式删除前将继续有效并完全受支持。 此弃用通知可以跨几年。 删除后的功能或特性不再运行。 我们现在通知您，以便在删除功能或特性前，您有充足的时间计划和更新您的代码。

本主题内容

Microsoft Dynamics 365 的 SDK 扩展

Microsoft Dynamics CRM 2011 终结点

一些知识管理实体

移除旧窗体呈现选项

更新至 Dynamics 365 SDK 程序集

引用实体类型代码的功能区参数

Microsoft Dynamics 365 的 SDK 扩展

自 2017 年 2 月 起，Microsoft Dynamics 365 的 SDK 扩展已弃用，将不在 Dynamics 365、版本 9.0 和更高版本的未来版本中受支持。 这些扩展在 Dynamics CRM 2013 中添加，为解决方案和 Web 门户功能提供简化的连接类、强类型生成。 这些已被较新功能代替。 您应使用 XRM 工具程序集为 Dynamics 365 构建您的 Windows 应用程序。详细信息：.NET 开发：使用 XRM 工具程序集。 关于门户功能，请参阅 Microsoft Dynamics 365 门户功能的管理员指南。

如果要查找 SDK 扩展文档的早期版本，请参阅 Microsoft Dynamics CRM 2015 的 SDK 扩展。 可以通过下载 SDK 扩展 NuGet 包 获取 Dynamics CRM 早期版本支持的门户程序集和工具。 这些可与 2016 年 12 月的 Microsoft Dynamics 365（联机和本地）更新结合使用。

Microsoft Dynamics CRM 2011 终结点

从 Dynamics 365 (8.0) 版本开始，新的 OData 4 终结点已添加到 Dynamics 365 应用程序堆栈。 该终结点被称为 Web API。 Web API 提供可跨各种编程语言、平台和设备使用的开发体验。 Web API 可替换 CRM 2011 终结点，也称为 SOAP 终结点， 用于访问 Dynamics 365 组织 Web 服务和其他所提供的 Web 服务。

自发布 Microsoft Dynamics CRM Online 2016 更新 1 和 Microsoft Dynamics CRM 2016 Service Pack 1 (8.1.0)，CRM 2011 终结点已被弃用。 2011 终结点将在 Dynamics 365 版本 9 发布后的某个时间被移除。 我们计划在未来几次次要发布中提供 Dynamics 365 SDK 程序集和工具的更新，重新定向为使用 Web API 替代 2011 终结点。

强烈鼓励开发人员在编写应用程序代码时，使用 Web API 访问 Dynamics 365 Web 服务。 您必须更新现有应用程序，以便从现在起到 2011 终结点被移除前使用 Dynamics 365 Web API 访问 Dynamics 365 Web 服务。 在开发插件和自定义工作流活动时，请继续链接这些项目到 Dynamics 365 SDK 程序集。Dynamics 365 SDK 程序集将更新为使用 Web API。 此更新将对您完全透明，并且将支持使用 SDK 本身编写的代码。

其他详细信息将在未来的 SDK 版本中发布。 有关 Web API 的详细信息，请参阅 使用 Microsoft Dynamics 365 Web API。

一些知识管理实体

在 Dynamics 365 中进行知识管理的一些实体被弃用：KbArticle、KbArticleComment 和 KbArticleTemplate。 必须使用更新的 KnowledgeArticle 实体（在 CRM Online 2016 更新 和 Dynamics 365 中引入）在 Dynamics 365 中进行知识管理。详细信息：知识管理实体

移除旧窗体呈现选项

在 Microsoft Dynamics CRM Online 2015 更新 1，我们推出了新的 窗体呈现引擎（有时称为“涡轮窗体”），提供改进性能。 新的呈现引擎对使用 Microsoft Dynamics CRM Online 2016 更新和 Microsoft Dynamics CRM 2016（本地）进行本地部署的客户可用。

由于此类更改可能引入窗体脚本中的不同行为，我们目前在"系统设置"中提供“使用旧窗体呈现”选项，以便组织在检测到问题时可以选择退出。 这是一个临时解决方案。 如 TechNet：Microsoft Dynamics CRM 2015 和 CRM Online 中面向管理员和定制员的新增功能和 MSDN：编写 Microsoft Dynamics CRM 窗体代码中所记载，我们建议尽快解决问题。

“使用旧窗体呈现”选项将在下一个主要版本中被移除。 旧窗体呈现（有时称为”刷新窗体“）被弃用，将不再可用。 将仅移除呈现选项；仍支持窗体定义。 为使用新窗体呈现引擎解决自定义问题的组织应立即采取行动，以便升级到下一个主要版本。

如果已打开旧窗体呈现，请将其关闭并测试脚本。 在测试过程中，如果看到使用：

  • 客户端编程参考中支持的客户端 API 对象和方法文档，报告给 Microsoft Dynamics 365 技术支持。

  • 不受支持的窗体对象或方法；移除这些自定义或查找其他方法获得您想要的结果。

更新至 Dynamics 365 SDK 程序集

由于 Dynamics 365（在线） 及其支持系统的基本安全构架发生变化，目前使用 Microsoft Dynamics CRM 2011 终结点验证 Dynamics 365（在线） 身份提供商的应用程序必须使用最新发布的 Microsoft Dynamics 365 程序集进行重构，以免将来出现服务中断。 对于使用 Microsoft Dynamics 365 构建的应用程序，将这些应用程序链接到版本 8.1.0 或更高版本的 SDK 程序集。 计划更新 Microsoft Dynamics CRM 2011 SDK、Microsoft Dynamics CRM 2013 SDK 和 Microsoft Dynamics CRM 2015 SDK 解决此问题将通过 CRM 团队博客 公告。 依赖任何当前集合的应用程序需要再次链接到更新后的程序集才能够正常运行。

重要

这仅适用于 Microsoft Dynamics 365 (online)。

引用实体类型代码的功能区参数

用于创建自定义功能区命令和规则的 <CrmParameter> (RibbonDiffXml) 元素中包含一些属性，这些属性提供上下文信息供命令或规则评估。 其中三个引用对引用自定义实体的解决方案有问题的实体类型代码。 自定义实体的实体类型代码值是在组织中创建该实体时分派的。 此值从 10,000 开始，为组织中创建的每个实体以 1 为增量增加。 这意味着此值在不同组织中可能不同。 请改用实体逻辑名称，而不是依赖这个不可靠的值。

下面的 CrmParameter 属性已弃用：

  • PrimaryEntityTypeCode已弃用。 改为使用 PrimaryEntityTypeName。 一个数字，表示特定 Microsoft Dynamics 365 部署的实体的唯一类型。 对于自定义实体来说，此值对每个组织都不同。

  • SelectedEntityTypeCode已弃用。 改为使用 SelectedEntityTypeName。 一个数字，表示网格中选定的记录的实体的唯一类型。 实体类型代码将因部署而异。 对于自定义实体来说，此值对每个组织都不同。

  • EntityReference.TypeCode 请改用 EntityReference.TypeName。

另请参阅

针对管理员的新增功能：Microsoft Dynamics 365
Microsoft Dynamics 365（联机）和 Dynamics 365（内部部署）的软件开发套件

Microsoft Dynamics 365

© 2017 Microsoft。 保留所有权利。 版权