Learn about the long-awaited effort underway to port the Salesforce Suite, a complex Drupal 7 module, to Drupal 8. In November of 2016, we passed the one-year anniversary of the Drupal 8.0.0 release. The community is finally catching up on porting more advanced modules to this latest version, and the Salesforce Suite is no exception. Aaron Bauman, the original architect of this suite of modules that integrate Drupal and Salesforce, has been working on the port of the Suite from D7 to D8 for quite some time. Dozens of meta-comments, half a dozen refactors, and hundreds of hours later, Salesforce-8.x-3.x is picking up steam. In this session, we'll explore aspects of navigating the dozens of new Drupal 8 APIs, architectural decisions when planning your projects, issues management, and team coordination. We'll look at the current state of Salesforce Suite's update to Drupal 8, including: Major components already ported from Drupal 7, including Salesforce Mapping UI, Drupal to Salesforce Push, and Salesforce to Drupal Pull New features for Drupal 8, including new Plugin APIs, event scheme, Queue APIs, examples module, unit tests, and new class hierarchy Roadmap to Drupal 8 stable release, including migration paths from Drupal 7, a baked-in SOAP client, more unit tests, kernel tests, more examples, and additional documentation.

1. 1 ©2016 Acquia Inc. — Confidential and Proprietary
Presented by Message Agency
Updating Salesforce Suite to D8:
Major Changes for a Big Module

2. 2 ©2016 Acquia Inc. — Confidential and Proprietary
Who Are We?
Aaron Bauman
– 8+ years Drupal developer & module
maintainer
– aaron@messageagency.com
– drupal.org/u/aaronbauman
Alex Rhodes
– 7 year Drupal developer
– rhodes@messageagency.com
– drupal.org/u/ironsizide

3. 3 ©2016 Acquia Inc. — Confidential and Proprietary
Why Are We Here?
We’re here to talk about navigating
Drupal 8 APIs for Drupal 7 developers,
through the lens of Salesforce module.
– Entity & Entity Storage API
– Plugin API
– Events Dispatcher
– Queue API
– Building a REST client for Salesforce
API
– Route Subscribers
– Service Providers

4. 4 ©2016 Acquia Inc. — Confidential and Proprietary
Project Overview
– Mappings (Entity API, Plugin API,
Route Subscriber)
– Pull (Queue API)
– Push (Queue API, custom)
– Push/Pull Events (Events
Dispatcher)
– Salesforce REST API Client (Service)
– Encrypt support (Service Provider
alter)

5. 5 ©2016 Acquia Inc. — Confidential and Proprietary
New Features & Bug Fixes
– Intelligent use of API clients
– Multiple mappings per entity type
– Improved error handling and logging
– Merge support
– Encryption support
– Fully extensible and pluggable

6. 6 ©2016 Acquia Inc. — Confidential and Proprietary
Salesforce Push Diagram
http://goo.gl/tmKw6w

7. 7 ©2016 Acquia Inc. — Confidential and Proprietary
Salesforce Pull Diagram
http://goo.gl/2X3BG3

8. 8 ©2016 Acquia Inc. — Confidential and Proprietary
Demo Slide
– Elevator music goes here

9. 9 ©2016 Acquia Inc. — Confidential and Proprietary
Entity & Entity Storage
node_load()
is now
Drupal::service(
'entity_type.manager')
->getStorage('node')
->load()
This is... verbose. Why is it better?
– Extensibility
– Dependability
– Testability

10. 10 ©2016 Acquia Inc. — Confidential and Proprietary
Entity & Entity Storage
Examples
– Drupalsalesforce_mapping
– EntityMappedObject
– EntitySalesforceMapping
– SalesforceMappingStorage
– MappedObjectStorage

11. 11 ©2016 Acquia Inc. — Confidential and Proprietary
Plugin API
hook_my_module_new_api_info
+ module_invoke_all
+ hook_my_module_new_api_data
+hook_my_module_new_api_CALLBACK_FUN
CTION
is now
Drupal::service(
'my_module.plugin_manager')
->getDefinitions()
This is more concise. Why is this better?
– Extensibility
– Dependability
– Testability

12. 12 ©2016 Acquia Inc. — Confidential and Proprietary
Plugin API
Examples
– Drupalsalesforce_mapping
– SalesforceMappingFieldPluginManager
– SalesforceMappingFieldPluginBase
– PluginSalesforceMappingFieldProperties
– PluginSalesforceMappingFieldBroken

13. 13 ©2016 Acquia Inc. — Confidential and Proprietary
Queue API
hook_cron_queue_info
is now
PluginQueueWorker
Why is this better?
– Extensibility
– Dependability
– Testability

14. 14 ©2016 Acquia Inc. — Confidential and Proprietary
Queue API
Examples
– Drupalsalesforce_pull
– QueueHandler
– PluginQueueWorkerPullBase
– Drupalsalesforce_push
– PushQueue
– PluginSalesforcePushQueueProcessorRest

15. 15 ©2016 Acquia Inc. — Confidential and Proprietary
Events API
Examples
– Drupalsalesforce
SalesforceEvents
– Drupalsalesforce_pushPlugin
SalesforcePushQueueProcessor
Rest
module_invoke_all()
is now
Drupal::service(
'event_dispatcher')
->dispatch()

16. 16 ©2016 Acquia Inc. — Confidential and Proprietary
Salesforce REST API Client
Drupal 7
+ Salesforce client encapsulated in a
class
- Class file contains 3 different classes
+ Internal methods are atomized
- Return values are not reliable
Drupal 8
+ PSR-4 enforces namespacing, class
hierarchy, interface
+ Class wrappers for return values
+ Type-hinting whenever possible
+ Salesforce Exception classes to
encapsulate error responses
DrupalsalesforceRestRestClient

17. 17 ©2016 Acquia Inc. — Confidential and Proprietary
Lower barrier to implementing new APIs
– Extend a class, rather than copy-pasting and re-writing
– Plugin API and Annotations reduce overhead and time to ship
– Lots of previously hard/tedious things we now get "for free"
Key Takeaways

18. 18 ©2016 Acquia Inc. — Confidential and Proprietary
OOP, finally
– Reliable arguments and return values make devs happy
– Traits make it easy to reuse components across inheritance, extensibility, and
interfaces
– Consistent expectations for all objects. No more stdClass, yay!
Key Takeaways

19. 19 ©2016 Acquia Inc. — Confidential and Proprietary
Early architecture decisions are important
– Naming conventions are crucial, and tedious to change
– Writing tests early (or full TDD) is faster than writing tests for a large, existing stack
– Dependency injection and encapsulation, every time
– Not sure the best way to do something?
Look for a pattern in core.
Key Takeaways

20. 20 ©2016 Acquia Inc. — Confidential and Proprietary
Navigating and learning D8 can be tedious
– Dozens of nesting levels and wrappers
– Namespacing means class names are no longer unique
– Keep a copy of core.services.yml handy at all times
– Use a smart IDE, or a good documentation tool like Dash
– Be ready to search d.o documentation, changelogs, and issue queue for "the D8
way" to do things
– Examples module implements dozens of different APIs
Key Takeaways

21. 21 ©2016 Acquia Inc. — Confidential and Proprietary
Thank You
https://www.drupal.org/project/salesforce
https://www.messageagency.com