genesis-global/salesforce-bundle

Symfony bundle that provides OAuth2 authentication and exposes Salesforce REST API methods in OOP friendly way.

1.3.2 2020-11-25 15:58 UTC

Requires

• genesis-global/salesforce: ^1.1.9
• symfony/config: ^3.2|^4.0|^4.1|^5.0
• symfony/dependency-injection: ^3.2|^4.0|^4.1|^5.0
• symfony/http-kernel: ^3.2|^4.0|^4.1|^5.0

Requires (Dev)

• phpunit/phpunit: ~6.5

MIT

• salesforce

README

Symfony bundle for Salesforce REST client which is base on username,password authentication

###Package instalation with composer

$ composer require genesis-global/salesforce-bundle

Enable bundle

Then, enable the bundle by adding it to the list of registered bundles in the app/AppKernel.php file of your project:

<?php
// app/AppKernel.php

// ...
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(
            // ...

            new GenesisGlobal\Salesforce\SalesforceBundle\SalesforceBundle(),
        );

        // ...
    }

    // ...
}

Required configuration:

salesforce:
    authentication:
        endpoint: "https://login.salesforce.com/"
        client_id: "id"
        client_secret: "secret"
        username: "name"
        password: "pass",
        security_token: '22s2sd233e3'
    rest:
        version: "v35.0"
        endpoint: "https://yourinstance.salesforce.com"
        

Use in controller:

CREATE RECORD

// custom class which implements SobjectInterface
$case = new Sobject();
$case->setName('Case');
$case->setContent(['someField' => 'someValue']);

$result = $this->get('salesforce.service')->create($case);  

// get salesforce id
$id = $result->getId();

UPDATE RECORD

try {
    $this->get('salesforce.service')->update('Account', '001D000000INjVe', [ 'someField' => 'someValue' ]);
    
} catch (UpdateSobjectException $e) {
    
    // update failed
    echo $e->getMessage();
}

UPSERT RECORD

// account object
$account = new \stdClass();
$account->Current_Balance__c = '21023';
$account->Current_Count_of_Deposit__c = 0;
$account->Number_of_Active_Days__c = 12;
 
// account sObject ready to send to salesforce
$accountSobject = new Sobject();
$accountSobject->setName('Account');
$accountSobject->setContent($account);

$result = $this->get('salesforce.service')->upsert($sObject, 'Player_Account__c', '123132');

GET METADATA

$metaData = $this->get('salesforce.service')->getMetaDataForSobject('Account');