alexacrm/dynamics-webapi-toolkit

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

4.0.0-beta 2023-01-21 09:16 UTC

README

Dynamics Web API 工具包提供了一个易于使用的 PHP 封装,用于 Microsoft Dynamics 365 客户关系管理 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 返回。这意味着,在这一点上,您必须期望使用 OptionSetValue 对象代替选项列表值、状态/状态属性,布尔值代替“两个选项”属性,浮点数代替十进制和货币属性。查找属性值表示为 EntityReference 对象。当在实体中设置值时,包括 EntityReferences,也适用同样的情况。一旦组织元数据集成到工具包中,这可能会发生变化。

入门

先决条件

主要要求是 PHP 7.4 或更高版本。推荐使用 cURL,但不是必需的。《a href="https://getcomposer.org.cn/" rel="nofollow noindex noopener external ugc">Composer 是安装工具包及其依赖项所必需的。

安装

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

使用

请参阅教程,了解如何使用库。

开发

现在已提供与 PHP 8.2 及更高版本兼容的版本,版本号为 v4.x-dev。请注意,此版本仍在开发中,使用时请自行承担风险。您可以使用以下命令安装它

$ composer require alexacrm/dynamics-webapi-toolkit:v4.x-dev

构建方式

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

版本控制

工具包使用 SemVer 进行版本控制。

许可证

本项目采用 MIT 许可证 - 请参阅LICENSE 文件获取详细信息。