README

此 SDK 目前处于预览阶段。请继续提供反馈，我们将在向生产支持的库迭代的过程中不断改进。

对于 WordPress 用户，请参阅我们的Gravity Forms Dynamics 365 扩展插件。

安装 SDK

您可以使用 Composer 安装 PHP SDK。

{
    "require": {
        "Microsoft/Dynamics": "0.1.*"
    }
}

开始使用 Microsoft Dynamics 365

注册您的应用程序

通过以下支持的认证门户之一注册您的应用程序以使用 Microsoft Dynamics 365 API：

• Microsoft Azure Active Directory：在您的租户的 Active Directory 中注册一个新的应用程序，以支持您的租户或多个租户的工作或学校用户。
• Microsoft 应用程序注册门户 (即将推出)：注册一个新的应用程序，该应用程序使用 v2.0 认证端点进行认证。此端点可认证个人（Microsoft）和工作或学校（Azure Active Directory）帐户。

使用 Microsoft Graph 服务进行认证

Microsoft Dynamics 365 SDK for PHP 不包括任何默认的认证实现。相反，您可以使用您选择的库进行认证。

在认证时，您只需使用 Azure AD 的 resource 参数请求访问您的 Dynamics 365 实例 URL。

调用 Microsoft Dynamics 365

以下示例展示了如何调用 Microsoft Dynamics 365 Web API。

use Microsoft\Dynamics\Dynamics;
use Microsoft\Dynamics\Model;

class UsageExample
{
    $instanceUrl = 'https://contoso.crm.dynamics.com';
    $accessToken = 'xxx';

    $dynamics = new Dynamics();
    $dynamics->setInstanceUrl($instanceUrl)
             ->setAccessToken($accessToken);

    $leads = $dynamics->createRequest("GET", "/leads")
                  ->setReturnType(Model\Lead::class)
                  ->execute();

    $lead = $leads[0];

    echo "Hello, I am $lead->getFirstName() ";

    // OR GET a specific lead by ID

    $lead = $dynamics->createRequest("GET", "/leads(xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)")
                  ->setReturnType(Model\Lead::class)
                  ->execute();

    echo "Hello, I am $lead->getFirstName() ";
}

开发

运行测试

从基本目录运行 vendor/bin/phpunit。

文档和资源

• 文档

• Wiki

• 示例

• Microsoft Dynamics 365 网站

• Microsoft Dynamics 365 Web API 文档

问题

在仓库的 问题 选项卡中查看或记录问题。

版权和许可

版权（c）Saint Systems, LLC。保留所有权利。在 MIT 许可下授权。