Demo T-Mass
Guía para integrar Salesforce con la herramienta POSTMAN, que se utiliza como base para entender la forma de comunicar cualquier sistema (Oracle, SAP y otros), con Salesforce.
Guía para integrar Salesforce con la herramienta POSTMAN, que se utiliza como base para entender la forma de comunicar cualquier sistema (Oracle, SAP y otros), con Salesforce.
Para integrar cualquier sistema de tecnología con Salesforce, el primer paso es definir la tecnología a utilizar, según las capacidades del sistema a integrarse (oracle, sap, sql, entre otros). Las tecnologías que Salesforce ofrece para integración son REST API, SOAP API, Bulk API y Streaming API. Para efectos de esta demostración estaremos basandonos en REST API, utilizando una estructura de archivos JSON la cuál es más liviana para este tipo de transacciones.
En una integración de este tipo se requieren 3 elementos importantes:
-Una herramienta para realizar las pruebas.
-Un ejemplo de un archivo JSON.
-Accesos seguros para lograr la transacción.
A continuación se definen los pasos para lograr una integración demo de prueba con Salesforce, con el objetivo de que pueda validar el proceso y que este sea viable para su sistema.
Postman es la herramienta que permite simular una llamada por medio de REST API hacia Salesforce. De este modo podemos probar su funcionamiento adecuado previo a integrar con otro sistema.
Para poder intercambiar datos lo hacemos atraves de un archivo muy común llamado JSON, el cuál lleva una estructura liviana para integración de datos de este tipo. Es la recomendada sin embargo también es posible usar archivos XML.
La seguridad es el valor más importante para Salesforce. Por ello también brindamos en esta guía los accesos seguros para poder realizar una prueba de demo y comprobar la comunicación.
Descargamos la herramienta POSTMAN del siguiente enlace:
https://www.postman.com/downloads/
Una vez que se descarga la herramienta, instalamos y seguimos los pasos para finalizar la instalación, esto ya sea el tipo de sistema operativo que está utilizando.
Antes de iniciar el proceso de demo para integrar con SF, es importante tomar en cuenta algunos conceptos básicos que describimos a continuación:
-Usuario de Salesforce: usuario de acceso a Salesforce.
-Contraseña de Salesforce: contraseña de acceso que contiene el token de seguridad.
-Consumer Key: llave del consumidor a traves de REST API
-Consumer Secret: clave de consumo a traves de API.
Para este instructivo favor solicitar estos accesos al área de Tecnologías de Incompany.
Una vez tenemos los accesos el siguiente paso es preparar el archivo que se encargará de intercambiar los datos. En este caso usamos un archivo de tipo JSON, esto ya que es más liviano para este tipo de transacciones. Para efectos de realizar la prueba en esta guía, usaremos la siguiente estructura de ejemplo:
{
"Nombre": "Juan Rafael",
"Apellidos": "Mora Porras"
}
Una vez tenemos los accesos el siguiente paso es preparar el archivo que se encargará de intercambiar los datos. En este caso usamos un archivo de tipo JSON, esto ya que es más liviano para este tipo de transacciones. Para efectos de realizar la prueba en esta guía, usaremos la siguiente estructura de ejemplo:
{
"Nombre": "Juan Rafael",
"Apellidos": "Mora Porras"
}
Una vez que se tienen todos los elementos para realizar la prueba (accesos, estructura json y herramienta postman instalada), seguimos las instrucciones en este video que detallan la forma en que se debe configurar la herramienta postman para realizar la prueba.
El resultado es que debe retornar un mensaje de 200ok, el cuál indica que la conexión fue exitosa. La seguridad es lo más importante en este tipo de transacciones, es por ello que salesforce utiliza el OAuth como protocolo de seguridad y en este caso se requiere de dos transacciones importantes:
-Obtención del token para transaccionar.
-Envío del archivo JSON.