bordman/dynamics-webapi-toolkit

Microsoft Dynamics 365 和 Dynamics CRM 的 Web API 工具包

2.0.1 2020-09-28 10:16 UTC

This package is auto-updated.

Last update: 2024-09-28 16:10:20 UTC


README

Dynamics Web API Toolkit 提供了一个易于使用的 PHP 封装,用于 Microsoft Dynamics 365 Customer Engagement Web API。

通过兼容的 IOrganizationService 接口,轻松创建、读取、更新和删除 CRM 记录,并执行 Web API 操作和函数。

请参阅 教程 以了解如何实例化连接、创建、检索、更新和删除记录的示例代码。

此工具包仅支持 Dynamics 365 Web API。有关 Dynamics 365 SOAP 接口的 PHP 实现,请参阅 php-crm-toolkit 项目

功能 & 限制

当前版本的库不支持以下功能(在过程中提到支持的功能和场景)

  • IFD 和 On-Premises (AD) 部署的认证支持。IFD(面向互联网的部署)的支持已在 路线图 中,On-Premises 部署(使用 AD)正在考虑中。
  • IOrganizationService 接口的执行方法尚不支持。尽管提供了执行函数和操作的方法,包括绑定和未绑定的。
  • 批处理请求尚不支持。这意味着,关联/取消关联多个记录是在多个单独的请求中执行的,这可能会影响性能。
  • 组织元数据(实体和属性、全局选项集等)尚不支持,尽管可以通过内置的 OData 辅助客户端或通过 HTTP 客户端手动检索。
  • 大多数记录属性值直接从 Web API 返回。这意味着,目前您必须预期将选项值对象替换为整数、将 "Two Options" 属性替换为布尔值、将十进制和货币属性替换为浮点数。查找属性值以实体引用对象的形式呈现。当在实体中设置值时,包括实体引用,也是如此。一旦将组织元数据集成到工具包中,这种情况可能会发生变化。

入门

先决条件

主要要求是 PHP 7.4 或更高版本。推荐使用 cURL,但不是必需的。安装工具包及其依赖项需要 Composer

安装

$ composer require alexacrm/dynamics-webapi-toolkit:dev-master

消费

请参阅 教程 了解如何消费此库。

使用

  • David Yack 的 Xrm.Tools.CRMWebAPI - 部分代码作为 OData 辅助代码借用
  • Guzzle - 一个可扩展的 PHP HTTP 客户端

版本控制

目前工具包代码未标记。一旦库在 API 方面稳定,我们将使用 SemVer 进行版本控制。

许可证

此项目采用 MIT 许可证 - 有关详细信息,请参阅 LICENSE.md 文件。