README

由 DoIT Cloud Consulting 制作的 Salesforce Toolkit for Laravel

入门指南

非常感谢您对这款包的兴趣，这对我们来说非常有趣，保持一个开放的社区以实现 Salesforce 集成。该包的工作由 DoIT Cloud Consulting 赞助，并且公司非常重视您的反馈，请通过官方网站与我们联系以提供反馈或提出问题。

先决条件

在本教程中，我们假设您已安装 PHP 和 composer。创建一个 Laravel 项目，运行以下命令

$ composer create-project --prefer-dist laravel/laravel SalesforceConnectionProject

$ cd SalesforceConnectionProject

安装

在您拥有一个 Laravel 项目后，您需要运行以下命令来安装我们的包

composer require doitcloudconsulting/salesforce

稍等片刻，您将在 composer.json 中看到一个新元素

 "require": {
     ....
        "doitcloudconsulting/salesforce": "^0.0.0",
     ....
    }

现在，您需要添加服务提供者，转到 config/app.php 并在 providers 数组中添加以下行

 DoITCloudConsulting\Salesforce\SalesforceServiceProvider::class,

要初始化会话，需要添加一些参数和一个 wsdl 文件，将凭据设置在 config 文件 app/SalesforceConfig.php 中。您必须运行以下命令才能在配置文件夹中看到该文件。

$ php artisan vendor:publish --tag=config

####### Result #######

Copied File [/myProject/DoITCloudConsulting/Salesforce/src/config/SalesforceConfig.php] To [/config/SalesforceConfig.php]

设置凭据

return [

	/*
    |--------------------------------------------------------------------------
    | Data Access
    |--------------------------------------------------------------------------
    |
    | Set credenctials to login on salesforce platform.
    | 
    */

	'Username' => '********@doitcloud.consulting',
	'Password' => '**********',
	'Token' => '******************************',

现在，将演示文件导出以通过 wsdl 连接。它将在 config/partner.wsdl.xml 中显示一个 wsdl 文件，您只需将其替换即可。运行以下命令

$ php artisan vendor:publish --tag=wsdlconfig

转到设置 >[在查找框中写入] API > 下载 Partner / Enterprise，然后您将下载一个 xml 文件，该文件必须替换在 config/partner.wsdl.xml 中

根据所选的连接类型，在 config/SalesforceConfig.php 中，您必须设置您想使用的连接类型。

    /*
    |--------------------------------------------------------------------------
    | WSDL 
    |--------------------------------------------------------------------------
    |
    | To connect to salesforce definition objects is necessary set a connect 
    | mode, partner or enterprise is the options. Download the WSDL from 
    | Salesforce > Settings > API. Click on the option that you need and 
    | replace the files demo on the package.
    | 
    */


    'Mode' => 'partner',

运行一些示例

插入

$salesforce = new Salesforce();
$salesforce->insert(array('Name' => 'DoIT Acc FROM ToolKit'), 'Account');

更新

$salesforce = new Salesforce();
$salesforce->update(array('Name' => 'DoIT Acc ', 'id' => '001f400000yNY0LAAW'), 'Account');

删除

$salesforce = new Salesforce();
$salesforce->delete(array('001f400000yNY0LAAW', '001f400130TMY0L5AW', ...));

撤销删除

$salesforce = new Salesforce();
$salesforce->delete(array('001f400000yNY0LAAW', '001f400130TMY0L5AW', ...));

Upsert

$salesforce = new Salesforce();
$salesforce->upsert(array(
	array('Name' => 'Acc1'),
	array('Name' => 'Acc2'),
	array('Name' => 'Acc2', 'Phone' => 192837465, 'id' => '001f400000yNY0LAAW'),
	), 'Account');

查询

$salesforce = new Salesforce();
$salesforce->query('select Id, Name from Account limit 10');

搜索 / SOSL

$salesforce = new Salesforce();
$salesforce->sosl('Find {doit} Returning Account(name), lead(name, phone)');

转换潜在客户

$salesforce = new Salesforce();

$lead = $salesforce->insert(
        array('lastname' => 'Homerito Hernández', 
              'Email' => 'homerito@doitcloud.mx', 
              'Phone' => 1234588892, 
              'Company' => 'DoIT Cloud Consulting'
          ), 'Lead');

$salesforce->convertLead($lead->id, 'Closed - Converted');

描述全局（包括自定义和标准对象的 sObject 属性）。

$salesforce = new Salesforce();
$salesforce->describeGlobal();

描述布局

$salesforce = new Salesforce();
$salesforce->describeLayout('Account');

描述 SObject

$salesforce = new Salesforce();
$salesforce->describeSObject('Account');

获取所有更新

$salesforce = new Salesforce();
$salesforce->getMeAllUpdated('Case', '08-04-2019', '30-04-2019');

获取所有已删除

$salesforce = new Salesforce();
$salesforce->getMeAllDeleted('Case', '08-04-2019', '30-04-2019');

构建于

• Carbon - 一个简单的 DateTime API 扩展。
• Sublime Text - 一个用于代码、标记和散文的复杂文本编辑器
• PHP Toolkit Salesforce - Force.com PHP Toolkit 提供了一个易于使用的 Force.com 包装器
• PHP - PHP 是一种流行的通用脚本语言，特别适用于 Web 开发。
• SOAP 项目 - Web 服务

作者

• Hugo Hernández - 初始工作 - Linkedin

有关参与此项目的贡献者列表。

许可

本项目采用 LGPL-2.0-only 许可协议 - 请参阅 LICENSE.md 文件以获取详细信息