tangkoko/dynamics-sdk-php

Saint Systems Microsoft Dynamics 365 SDK for PHP

0.1.0 2021-03-09 16:14 UTC

This package is auto-updated.

Last update: 2024-09-18 20:33:36 UTC


README

此SDK目前处于预览阶段。请继续提供反馈,我们将在迭代过程中逐步将其发展成为生产支持的库。反馈

Build Status

安装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服务进行认证

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

在认证时,您只需使用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

文档和资源

问题

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

版权和许可证

版权(c)Saint Systems, LLC。保留所有权利。在MIT 许可证下授权。