healthierjacobsen / dynamics-webapi-toolkit
微软Dynamics 365和Dynamics CRM的Web API工具包
2.0.1
2020-09-28 10:16 UTC
Requires
- php: ^7.4
- alexacrm/strong-serializer: ^2.0
- elao/enum: ^1.6
- guzzlehttp/guzzle: ^6.5
- psr/cache: ^1.0
- psr/log: ^1.0
Requires (Dev)
- phpunit/phpunit: ^8.1
This package is not auto-updated.
Last update: 2024-09-30 05:17:26 UTC
README
Dynamics Web API Toolkit提供了一个易于使用的PHP包装器,用于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返回。这意味着,在这一点上,您必须期望整数代替选项值对象,用于选择列表值、状态/状态属性,布尔值用于“两个选项”属性,浮点数用于十进制和货币属性。查找属性值以实体引用对象形式呈现。在设置实体值时也适用,包括实体引用。一旦将组织元数据集成到工具包中,这可能会改变。
入门指南
先决条件
主要要求是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文件了解详细信息。