Procesando Salesforce Outbound Messages con PHP en Heroku
0 recomendaciones685 vistas
Este documento describe cómo procesar mensajes salientes de Salesforce con PHP en Heroku de forma asincrónica. Explica qué son Salesforce y Heroku, y muestra un ejemplo de integración donde se crean órdenes en un sistema externo cuando se cierran oportunidades en Salesforce. Luego detalla cómo funcionan los mensajes salientes de Salesforce, las consideraciones de diseño para el servidor externo, y un esquema de implementación usando PHP en Heroku para procesar los mensajes de forma asíncrona e idempotente. Finalmente, inclu
Procesando Salesforce Outbound Messages con PHP en Heroku
- 1. Procesando Salesforce Outbound Messages con PHP en Heroku Mensajes asincrónicos en las nubes Ago 8, 2015
- 3. Agenda ▪ Salesforce ▪ Heroku ▪ Ejemplo de integración asincrónica ▪ Outbound Messages ▪ Consideraciones de diseño ▪ Esquema de implementación ▪ Demo
- 4. Qué es Salesforce? ▪ CRM ▪ Guardar datos de los clientes ▪ Establecer procesos de venta ▪ Automatización de la gestión del negocio ▪ Movilidad ▪ Plataforma ▪ SaaS (Software as a Service) ▪ On-demand vs On-premise ▪ Multi-tenant (segmentación vs virtualización) ▪ Basado en metadatos
- 5. Terminología ▪ Objeto = Tabla (Account, Contact, Order, etc) ▪ Record = Fila de la tabla con identificador único ▪ Campo = Campo de la tabla ▪ Org = Abreviación de “Organización” es nuestra instancia en salesforce ▪ App = Conjunto de campos, objetos, permisos y funcionalidades para que se cumplan los procesos de negocio ▪ Force.com = Plataforma donde suceden todas las orgs
- 6. Aprendiendo Salesforce de forma gratuita https://developers.salesforce.com/trailhead
- 7. Qué es Heroku? ▪ Plataforma ▪ Políglota (Ruby, Python, Java, Node.js, PHP, etc) ▪ Stack Ubuntu basado en Debian ▪ PaaS (Platform as a Service)
- 8. Aprendiendo Heroku de forma gratuita https://devcenter.heroku.com/start
- 9. Ejemplo de integración asincrónica barkingtshirts.com ▪ Implementan los procesos de marketing y ventas con Salesforce ▪ Requerimiento de negocio: para cada oportunidad (venta) cerrada se debe crear una orden en el sistema de facturación externo (ERP)
- 10. Ejemplo de integración asincrónica Salesforce org Opportunity (closed/won) ERP system Create Order
- 11. Moviendo datos desde Salesforce a un sistema externo ▪ De forma manual /o (*oh, no!) ▪ Herramientas ETL ▪ Streaming API ▪ Apex HTTP Callouts (sync/async) ▪ Outbound Messages
- 12. Outbound Messages ▪ Permite de forma declarativa especificar qué cambios sobre determinados objetos deben generar mensajes de notificación a un servidor externo predefinido ▪ Es una funcionalidad integrada con el motor de Workflow de la plataforma. ▪ Define un contrato (WSDL) para que un sistema externo lo implemente ▪ El proceso de notificación es asincrónico (Fire and Forget)
- 13. Fire and Forget ▪ Una operación de alta o modificación sucede en un conjunto de records en Salesforce ▪ Dada una condición lógica, el motor de workflow ejecuta una regla de negocio (Outbound Message) ▪ Esta regla envía un mensaje SOAP al servidor externo pre- configurado. ▪ El servicio externo toma el mensaje, lo agrega a una cola y retorna un resultado de ACK positivo. ▪ Salesforce recibe el ACK y finaliza la notificación (failover: espera 10 segundos y vuelve a intentar hasta por 24hrs) ▪ En caso de ser necesario un callback, el mensaje SOAP contiene un token (SessionId) para autenticarse contra Salesforce
- 14. Consideraciones de diseño del servidor externo ▪ Debe implementar el contrato (WSDL) especificado por Salesforce de antemano ▪ Debe ser Idempotente (la misma notificación aplicada n veces debe dar siempre el mismo resultado) ▪ Idealmente solo debe: ▪ Capturar el mensaje XML de la notificación ▪ Serializar la notificación en una cola para posterior procesamiento ▪ Enviar la respuesta a Salesforce (ACK)
- 15. Esquema de implementación (PHP) ▪ Cargar el WSDL con SoapServer ▪ Idempotencia: descartar notificaciones duplicadas (NotificationId es único) ▪ Captura el XML: crear una instancia de StdClass ▪ Serializar a una cola: SQS, MQ, JMS, RabbitMQ, etc ▪ Enviar respuesta a Salesforce: construir un mensaje SOAP especifico
- 17. Crear Workflow rule en Salesforce
- 18. Definir el Outbound Message
- 19. Ganando una oportunidad en Salesforce
- 20. Monitoreando Salesforce OM queue
- 21. Outbound message desde consola
- 22. Monitoreando Salesforce OM queue
- 23. App en Heroku
- 26. Muchas gracias! Procesando Salesforce Outbound messages con PHP en Heroku Mensajes asincrónicos en las nubes Aldo Fernandez @aldoforce #phpday #uysdug #salesforce #heroku #outboundMessages