使用 Microsoft Dynamics 365 Web 服务

 

发布日期： 2017年1月

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

Web 服务提供了您为 Microsoft Dynamics 365（在线或本地） 编写程序时将要使用的 API。 本主题介绍可用的 Web 服务以及为了便于理解和比较所需的基本信息。

本主题内容

Web API

组织服务

组织数据服务

Discovery Web Service

部署 Web 服务

Web API

Web API 是 Microsoft Dynamics 365（在线或本地） 的新增功能，与 Organization 服务对等。

备注

在初始发布中，实现完全对等前，还有几个问题需要解决。 有关未决问题的信息，请参阅 Microsoft Dynamics 365Web API 限制。

同Organization服务相比，Web API 能够更好地兼容各种编程语言、平台和设备。Web API 实施 OData（开放数据协议）v4。OData 是关于通过丰富的数据源构建和使用 RESTful API 的 OASIS 标准。 您可以登录OData 协议和 OASIS 标准网站了解更多信息。

由于 Web API 是构建在开放标准上的，您不需要使用 Microsoft Dynamics 365 特定的客户端库。 您可以选择撰写针对特定操作的 HTTP 请求，或使用第三方库为您要使用的任何语言或平台生成类。 查看可用库列表。

Web API 最终将取代Organization服务和Organization Data服务，但这两个现有的 Web 服务将仍然可用，以便逐步统一过渡到 Web API。 您应优先选择 Web API 进行新的开发，以支持 Microsoft Dynamics 365 和 Microsoft Dynamics 365 (online) 的未来版本。 使用 Web API 进行访问其代码不在服务器上运行的 Microsoft Dynamics 365 数据的项目，包括来自 Web 资源的 XmlHttpRequests 和在 Microsoft Dynamics 365 应用程序客户端中运行的窗体脚本。 现在，您无法将 Web API 轻松用于在服务器上运行的代码，例如插件或工作流程序集 。

详细信息：使用 Microsoft Dynamics 365 Web API。

组织服务

Organization服务，有时也称为“SOAP 终结点”，从 Microsoft Dynamics CRM 2011 开始可用。 这是大多数使用 Microsoft Dynamics 365 的开发人员已经熟悉的 Web 服务。Organization 服务已经针对 .NET 的使用进行了优化。Microsoft Dynamics 365 SDK 提供一组程序集和工具，允许您生成强类型类和代理，简化使用 Microsoft Visual Studio 时的开发流程和获得更好的开发体验。 如果您是 .NET 开发人员，不要求支持其他平台，您无需立即迁移到 Web API。 您需要使用 Organization 服务，以支持您要对使用 Microsoft Dynamics 365 以前发布的 Microsoft Dynamics 365 版本的组织部署的任何功能。

在插件中运行的业务逻辑或服务器上的工作流程序集预计将使用Organization服务。 输入和输出参数使用支持Organization服务的程序集定义的特定的类。

详细信息：使用 Microsoft Dynamics 365 组织服务

组织数据服务

Organization Data服务，有时也称为“OData”或“REST”终结点，从 Microsoft Dynamics CRM 2011 开始可用。 此服务实施 OData v2 标准。 此服务在未来的几年内将继续照样提供，我们正在使用 Microsoft Dynamics 365 取代它。Organization Data服务一直仅限于执行创建、读取、更新和删除操作，从来都不支持调用在Organization服务中使用的专用消息，因此它永远达不到组织服务的对等功能。 OData v2 和 v4 标准之间实施的更改无法将服务升级到达到一个与组织服务对等的服务的要求。 我们能够应用我们收到的有关组织数据服务的许多反馈，从而改进 Web API。

此次发布的 Microsoft Dynamics 365 SDK 不包含有关组织数据服务的信息。 您可以登录将 OData 终结点用于 Web 资源查找 Microsoft Dynamics CRM 2015 发布的文档中关于组织数据服务的信息。

Discovery Web Service

Microsoft Dynamics 365 是一个多租户应用程序。 这意味着单个部署可以托管 Dynamics 365 的多个实例，都具有自己的数据，并且通过不同的 URL 可用。 此外，尤其是当 Microsoft Dynamics 365 服务器在数据中心进行托管时，特定的服务器可以随着资源的移动或负载的平衡而改变。 Discovery Web Service 使客户端能够基于用户帐户检测到该用户可以连接到哪些服务器和组织。 您可以选择使用 Web API Discovery 服务或 IDiscoveryService Web 服务。Web API Discovery 服务提供与 Web API 相同的优势，能够更加轻松地使用各种编程语言、平台和设备。

详细信息：使用 Web API 发现组织的 URL 或 使用组织服务发现您的组织的 URL

部署 Web 服务

对于 Dynamics 365（本地），您可以执行操作，从而使用部署 Web 服务以编程的方式管理您的部署。 这些操作基本上与您使用服务器上安装的部署管理器工具客户端在服务器上执行的操作相同。 您可以创建、导入或删除组织，以及应用代码中的特定设置。 如果您正在提供托管服务或者想要自动创建测试环境，当您想要自动化特定流程时，这会很有用。

详细信息：部署 Web 服务简介。

另请参阅

连接到 Microsoft Dynamics 365
在 Microsoft Dynamics 365 中对用户进行身份验证
Use Microsoft Dynamics 365 web services
使用 XRM 工具，构建 Windows 客户端应用程序
编写移动和现代应用程序

Microsoft Dynamics 365

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