2017 © Pedro Peláez
 

symfony-bundle salesforce-outbound-message-bundle

This bundle allows you to easily process outbound messages sent by Salesforce.

image

comsave/salesforce-outbound-message-bundle

This bundle allows you to easily process outbound messages sent by Salesforce.

  • Monday, July 16, 2018
  • by Dirk-Scholten
  • Repository
  • 2 Watchers
  • 2 Stars
  • 46 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 62 Versions
  • 0 % Grown

The README.md

Symfony OutboundMessageBundle for Salesforce

Create, update, remove objects in Symfony sent through Salesforce outbound messages., (*1)

Release Travis Test Coverage Packagist, (*2)

Requirements

This bundle assumes you're using:, (*3)

1) MongoDB database (and specifically doctrine/mongodb-odm). 2) comsave/salesforce-mapper-bundle for Salesforce object mapping to your MongoDB Document classes., (*4)

Bundle features

  • Object create
  • Object update
  • Object delete. To enable this complete additional setup steps.
  • Object custom handling beforeFlush
  • Object custom handling afterFlush

Installation

  • composer require comsave/salesforce-outbound-message-bundle
  • Register the bundle in your AppKernel.php by adding new Comsave\SalesforceOutboundMessageBundle\ComsaveSalesforceOutboundMessageBundle()
  • To handle the Salesforce's incoming outbound messages create a route (for example /sync) and a method to a controller: 
<?php

use Symfony\Component\HttpFoundation\Request;
use Symfony\Bundle\FrameworkBundle\Controller\Controller;
use Comsave\SalesforceOutboundMessageBundle\Services\RequestHandler\OutboundMessageRequestHandler;

class OutboundMessageController extends Controller
{
    public function syncAction(Request $request, OutboundMessageRequestHandler $requestHandler)
    {
        try {
            $outboundMessageXml = $request->getContent();
            return $requestHandler->handle($outboundMessageXml);
        }
        catch (\Throwable $e) {
            throw new \SoapFault("Server", $e->getMessage());
        }
    }
}
  • add the bundle configuration in your app/config/config.yml 
comsave_salesforce_outbound_message:
    # WSDL_CACHE_NONE, WSDL_CACHE_DISK, WSDL_CACHE_MEMORY or WSDL_CACHE_BOTH
    wsdl_cache: 'WSDL_CACHE_DISK'                     
    # An absolute path to Salesforce object WSDL files
    wsdl_directory: '/absolute/path/' 
    document_paths:
        # Map a document using its Salesforce name and your local class 
        CustomObject__c:              
            path: 'YourNamespace\Documents\CustomObject'
            force_compare: false # if true, incoming object will be compared to existing ones in the database; will continue sync only if not equal
  • Add DocumentInterface to the document class you'd like to be tracked by the OutboundMessageBundle.
<?php

use Comsave\SalesforceOutboundMessageBundle\Interfaces\DocumentInterface;
use LogicItLab\Salesforce\MapperBundle\Model\Account as BaseAccount;

class Account extends BaseAccount implements DocumentInterface
{
}
  • Create an EventSubscriber for an object you'd like to sync. It would look something like this for the Account object:
<?php

namespace YourNamespace\EventSubscriber;

use Comsave\SalesforceOutboundMessageBundle\Event\OutboundMessageBeforeFlushEvent;
use Comsave\SalesforceOutboundMessageBundle\Event\OutboundMessageAfterFlushEvent;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;
use Comsave\SalesforceOutboundMessageBundle\Interfaces\DocumentInterface; 
use Comsave\Webservice\Core\UserBundle\Document\Account;

class AccountSoapRequestSubscriber implements EventSubscriberInterface
{
    public static function getSubscribedEvents()
    {
        return [
            OutboundMessageBeforeFlushEvent::NAME => [
                ['onBeforeFlush'],
            ],
            OutboundMessageAfterFlushEvent::NAME => [
                ['onAfterFlush'],
            ],
        ];
    }

    public function supports(DocumentInterface $document): bool
    {
        $documentClass = get_class($document);

        return Account::class == $documentClass || $document instanceof Account;
    }

    public function onBeforeFlush(OutboundMessageBeforeFlushEvent $event)
    {
        /**
         * Make sure to do call $this->supports() before you start processing the object
         * You only want to process the correct object in this EventSubscriber (which is Account in this case)
         */
        /** @var Account $newAccount */
        $newAccount = $event->getNewDocument();

        if (!$this->supports($newAccount)) return; 

        /** @var Account $existingAccount */
        $existingAccount = $event->getExistingDocument();

        /**
         * You can do any modifications you want to the object before it get's saved (flushed) to the database.
         * - - -
         * $event->getExistingDocument() provides you access to the existing object (if it exists) 
         * $event->getNewDocument() provides you access to the new object delivered by the outbound message. This is the object that will be merged over the existing one (if any) and saved to the database. In most of the cases you only need to use this one.
         */
    }

    public function onAfterFlush(OutboundMessageAfterFlushEvent $event)
    {
        /** @var Account $account */
        $account = $event->getDocument();

        if (!$this->supports($account)) return; 

        /**
         * You can process the object further if necessary after it has been saved (flushed) to the database.
         */
    }
}
  • Add your newly created route to the Salesforce outbound message for the object you want to sync (Account in our example).
  • That's it! Trigger an outbound message to be sent out and see everything happen automagically. 😎 👍

License

This project is licensed under the MIT License., (*5)

The Versions

16/07 2018

dev-master

9999999-dev

This bundle allows you to easily process outbound messages sent by Salesforce.

  Sources   Download

MIT

The Requires

 

The Development Requires

16/07 2018

0.3.10

0.3.10.0

This bundle allows you to easily process outbound messages sent by Salesforce.

  Sources   Download

MIT

The Requires

 

The Development Requires

13/07 2018

0.3.9

0.3.9.0

This bundle allows you to easily process outbound messages sent by Salesforce.

  Sources   Download

MIT

The Requires

 

The Development Requires

13/07 2018

0.3.8

0.3.8.0

This bundle allows you to easily process outbound messages sent by Salesforce.

  Sources   Download

MIT

The Requires

 

The Development Requires

12/07 2018

0.3.7

0.3.7.0

This bundle allows you to easily process outbound messages sent by Salesforce.

  Sources   Download

MIT

The Requires

 

The Development Requires

12/07 2018

0.3.6

0.3.6.0

This bundle allows you to easily process outbound messages sent by Salesforce.

  Sources   Download

MIT

The Requires

 

The Development Requires

12/07 2018

0.3.5

0.3.5.0

This bundle allows you to easily process outbound messages sent by Salesforce.

  Sources   Download

MIT

The Requires

 

The Development Requires

12/07 2018

0.3.4

0.3.4.0

  Sources   Download

MIT

The Requires

 

The Development Requires

12/07 2018

0.3.3

0.3.3.0

  Sources   Download

MIT

The Requires

 

The Development Requires

12/07 2018

0.3.2

0.3.2.0

  Sources   Download

MIT

The Requires

 

The Development Requires

12/07 2018

0.3.1

0.3.1.0

  Sources   Download

MIT

The Requires

 

The Development Requires

10/07 2018

0.2.37

0.2.37.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

10/07 2018

0.2.36

0.2.36.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

09/07 2018

0.2.35

0.2.35.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

09/07 2018

0.2.33

0.2.33.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

09/07 2018

0.2.34

0.2.34.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

02/07 2018

0.2.32

0.2.32.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

28/06 2018

0.2.31

0.2.31.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

28/06 2018

0.2.30

0.2.30.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

28/06 2018

0.2.29

0.2.29.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

28/06 2018

0.2.28

0.2.28.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

28/06 2018

0.2.27

0.2.27.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

27/06 2018

0.2.26

0.2.26.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

27/06 2018

0.2.25

0.2.25.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

27/06 2018

0.2.23

0.2.23.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

27/06 2018

0.2.22

0.2.22.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

27/06 2018

0.2.21

0.2.21.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

26/06 2018

0.2.20

0.2.20.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

26/06 2018

0.2.19

0.2.19.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

26/06 2018

0.2.18

0.2.18.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

26/06 2018

0.2.17

0.2.17.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

26/06 2018

0.2.14

0.2.14.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

26/06 2018

0.2.15

0.2.15.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

26/06 2018

0.2.13

0.2.13.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

26/06 2018

0.2.12

0.2.12.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

26/06 2018

0.2.11

0.2.11.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

26/06 2018

0.2.10

0.2.10.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

26/06 2018

0.2.9

0.2.9.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

26/06 2018

0.2.8

0.2.8.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

26/06 2018

0.2.7

0.2.7.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

26/06 2018

0.2.6

0.2.6.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

26/06 2018

0.2.5

0.2.5.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

26/06 2018

0.2.4

0.2.4.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

26/06 2018

0.2.3

0.2.3.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

26/06 2018

0.2.2

0.2.2.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

26/06 2018

0.2.1

0.2.1.0

  Sources   Download

proprietary

The Requires

 

The Development Requires

26/06 2018

0.1.17

0.1.17.0

Salesforce outbound message handler. Will process the outbound message sent by Salesforce and save all the changes to your database.

  Sources   Download

MIT

The Requires

 

The Development Requires

25/06 2018

0.1.15

0.1.15.0

Salesforce outbound message handler. Will process the outbound message sent by Salesforce and save all the changes to your database.

  Sources   Download

MIT

The Requires

 

The Development Requires

25/06 2018

0.1.14

0.1.14.0

Salesforce outbound message handler. Will process the outbound message sent by Salesforce and save all the changes to your database.

  Sources   Download

MIT

The Requires

 

The Development Requires

25/06 2018

0.1.13

0.1.13.0

Salesforce outbound message handler. Will process the outbound message sent by Salesforce and save all the changes to your database.

  Sources   Download

MIT

The Requires

 

The Development Requires

25/06 2018

0.1.12

0.1.12.0

Salesforce outbound message handler. Will process the outbound message sent by Salesforce and save all the changes to your database.

  Sources   Download

MIT

The Requires

 

The Development Requires

25/06 2018

0.1.11

0.1.11.0

Salesforce outbound message handler. Will process the outbound message sent by Salesforce and save all the changes to your database.

  Sources   Download

MIT

The Requires

 

The Development Requires

25/06 2018

0.1.10

0.1.10.0

Salesforce outbound message handler. Will process the outbound message sent by Salesforce and save all the changes to your database.

  Sources   Download

MIT

The Requires

 

The Development Requires

25/06 2018

0.1.9

0.1.9.0

Salesforce outbound message handler. Will process the outbound message sent by Salesforce and save all the changes to your database.

  Sources   Download

MIT

The Requires

 

The Development Requires

25/06 2018

0.1.8

0.1.8.0

Salesforce outbound message handler. Will process the outbound message sent by Salesforce and save all the changes to your database.

  Sources   Download

MIT

The Requires

 

The Development Requires

25/06 2018

0.1.7

0.1.7.0

Salesforce outbound message handler. Will process the outbound message sent by Salesforce and save all the changes to your database.

  Sources   Download

MIT

The Requires

 

The Development Requires

25/06 2018

0.1.6

0.1.6.0

Salesforce outbound message handler. Will process the outbound message sent by Salesforce and save all the changes to your database.

  Sources   Download

MIT

The Requires

 

The Development Requires

25/06 2018

0.1.5

0.1.5.0

Salesforce outbound message handler. Will process the outbound message sent by Salesforce and save all the changes to your database.

  Sources   Download

MIT

The Requires

 

The Development Requires

25/06 2018

0.1.4

0.1.4.0

Salesforce outbound message handler. Will process the outbound message sent by Salesforce and save all the changes to your database.

  Sources   Download

MIT

The Requires

 

The Development Requires

22/06 2018

0.1.3

0.1.3.0

Salesforce outbound message handler. Will process the outbound message sent by Salesforce and save all the changes to your database.

  Sources   Download

MIT

The Requires

 

The Development Requires

22/06 2018

0.1.2

0.1.2.0

Salesforce outbound message handler. Will process the outbound message sent by Salesforce and save all the changes to your database.

  Sources   Download

MIT

The Requires

 

The Development Requires

22/06 2018

0.1.1

0.1.1.0

Salesforce outbound message handler. Will process the outbound message sent by Salesforce and save all the changes to your database.

  Sources   Download

The Requires

 

The Development Requires