{"id":1870,"date":"2019-01-10T12:09:36","date_gmt":"2019-01-10T11:09:36","guid":{"rendered":"http:\/\/blogs.encamina.com\/por-una-nube-sostenible\/?p=1870"},"modified":"2019-01-10T12:22:58","modified_gmt":"2019-01-10T11:22:58","slug":"integracion-de-sistemas-con-microsoft-flow","status":"publish","type":"post","link":"https:\/\/blogs.encamina.com\/por-una-nube-sostenible\/integracion-de-sistemas-con-microsoft-flow\/","title":{"rendered":"Integraci\u00f3n de sistemas con Microsoft Flow"},"content":{"rendered":"

\"\"<\/p>\n

Microsoft Flow es uno de los servicios disponibles\u00a0en Office 365\u00a0<\/a>por el que Microsoft est\u00e1 apostando como herramienta de integraci\u00f3n\u00a0transversal con casi pr\u00e1cticamente cualquier servicio en la nube. Hace un tiempo, nuestro compa\u00f1ero Sergio Hern\u00e1ndez\u00a0\u00a0ya present\u00f3 este servicio en este mismo blog.<\/a>\u00a0En esta ocasi\u00f3n vamos a ver un caso de uso real en el que en ENCAMINA hemos utilizado Flow para integrar\u00a0correo\u00a0de\u00a0Office 365 con\u00a0SAP\u00a0CRM.\u00a0<\/span><\/p>\n

<\/p>\n

<\/span>Escenario<\/span><\/h2>\n

La necesidad de nuestro cliente era incorporar como actividad dentro de\u00a0SAP\u00a0CRM cualquier correo cruzado entre los\u00a0Account\u00a0Mangers\u00a0y una serie de cuentas de clientes.\u00a0Tanto los correos de entrada como los de salida.<\/p>\n

Para ello, se ofrec\u00eda un API desde\u00a0SAP\u00a0en el que consultar si una cuenta de correo correspond\u00eda con uno de los clientes de inter\u00e9s\u00a0o no. En caso afirmativo, otro m\u00e9todo del servicio web de\u00a0SAP\u00a0permit\u00eda crear la actividad en\u00a0SAP\u00a0CRM con los datos del correo electr\u00f3nico.\u00a0La casu\u00edstica era m\u00e1s o menos la misma, tanto para los correos de entrada como los de salida. Hab\u00eda que buscar c\u00f3mo monitorizar los buzones de los\u00a0Account\u00a0Managers para comunicarse con el servicio web.\u00a0<\/span><\/p>\n

La soluci\u00f3n\u00a0que encontramos fue utilizar Microsoft Flow<\/strong> para realizar esta monitorizaci\u00f3n\u00a0puesto que ofrece un evento que dispara un flujo al enviar o recibir un correo en un buz\u00f3n de correo.<\/p>\n

\"\"<\/p>\n

Este mismo evento se puede lanzar para el correo de entrada o para el de salida, cambiando la carpeta que se monitoriza:<\/p>\n

\"\"<\/p>\n

No obstante, para realizar las transformaciones necesarias antes de llamar al servicio web de SAP se gener\u00f3 un web api en Azure<\/strong>\u00a0 al que se invoc\u00f3 desde el flujo en Microsoft Flow.<\/strong><\/p>\n

<\/span>Requisitos t\u00e9cnicos<\/span><\/h2>\n

Para poder realizar est\u00e1 integraci\u00f3n vamos a necesitar una cuenta de Microsoft Flow, capacidad para desarrollar una web API con autenticaci\u00f3n en Azure, y los servicios expuestos de SAP, para poder generar los proxies correspondientes.<\/p>\n

<\/span>Implementaci\u00f3n<\/span><\/h2>\n

\"\"<\/p>\n

 <\/p>\n

La base fundamental de todo el desarrollo est\u00e1 compuesta por una serie de proxies generados mediante los wsdl extra\u00eddos de SAP. Para nuestro ejemplo han sido generados para C#, e integrados en un proyecto con visual studio 2017:<\/p>\n

\"\"<\/p>\n

service.cs<\/strong> : Proxy wsdl generado para obtener si el remitente esta dado de alta en SAP.<\/p>\n

serviceManager.cs<\/strong> : Proxy wsdl generado para crear acciones en SAP.<\/p>\n

Una vez generados los ficheros proxy que nos permiten el acceso a SAP, generaremos una web api para hacer uso de ellos, y que nos permita generar la l\u00f3gica necesaria para ello.<\/p>\n

\"\"<\/p>\n

 <\/p>\n

El fichero principal de nuestra web api \u201cSAPController.cs\u201d, expondr\u00e1 los m\u00e9todos necesarios para poder comunicar nuestro flujo con la web api, publicada en Azure<\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

\"\"<\/p>\n

Para el ejemplo vamos a examinar el m\u00e9todo GetBP, que nos permite saber si el remitente de un correo est\u00e1 dado de alta el SAP.<\/p>\n

\"\"<\/p>\n

Como se puede ver en la captura, instanciamos el proxy para consultar si el usuario est\u00e1 vinculado a un cliente en SAP, para ello generamos una entidad NetworkCredential que nos permita almacenar las credenciales de acceso a SAP, que tendremos almacenadas en nuestro web.config.<\/p>\n

El m\u00e9todo a utilizar ser\u00e1 \u201cFindBusinessPartnerByEmailURI_Sync\u201d, expuesto por SAP y accesible mediante nuestro proxy. Este m\u00e9todo requiere un objeto de tipo data,<\/em> que contenga el correo a consultar.<\/p>\n

En caso afirmativo nuestro m\u00e9todo nos devolver\u00e1 el c\u00f3digo asociado al cliente vinculado a esta cuenta de correo.<\/p>\n

Por \u00faltimo, necesitaremos crear otro m\u00e9todo m\u00e1s que nos permita crear acciones en SAP. Para ello utilizaremos el segundo proxy que expone los m\u00e9todos necesarios para crear acciones:<\/p>\n

\"\"<\/p>\n

Una vez creado el web api, ser\u00e1 necesario publicarlo en Azure mediante un perfil de publicaci\u00f3n, adem\u00e1s de crear las dos aplicaciones empresariales en Azure Active Directory para poder realizar un acceso seguro a la web api.<\/p>\n

\"\"<\/p>\n

Estas aplicaciones nos proveen de un token de autorizaci\u00f3n que nos permite realizar comunicaciones con el web api, estos datos ser\u00e1n necesarios para poder configurar las llamadas desde el Flow encargado de monitorizar una carpeta vinculada a nuestro correo de office 365.<\/p>\n

Para finalizar este ejemplo, nos falta unir todas las piezas creadas hasta ahora, esto lo realizamos mediante Microsoft Flow.<\/p>\n

\"\"<\/p>\n

Este flujo nos permite mediante las acciones b\u00e1sicas de Flow automatizar la monitorizaci\u00f3n de una cuenta de correo, como vemos la primera acci\u00f3n a utilizar es la de recepci\u00f3n de correo, esta acci\u00f3n est\u00e1 vinculada a una conexi\u00f3n que crearemos mediante la cuenta que queramos monitorizar.<\/p>\n

\"\"<\/p>\n

Como vemos la cuenta a monitorizar es la que mediante la configuraci\u00f3n indicamos como conexi\u00f3n a Office 365, una vez publicado el flujo, este se activar\u00e1 ante cada correo recibido.<\/p>\n

Por \u00faltimo, vamos a ver c\u00f3mo hacer uso del web api que hemos publicado en Azure, y c\u00f3mo utilizar los m\u00e9todos de autenticaci\u00f3n para que las comunicaciones se realicen. Para ello utilizaremos la acci\u00f3n de conexi\u00f3n http:<\/p>\n

\"\"<\/p>\n

Como vemos, esta acci\u00f3n tiene varios par\u00e1metros a configurar:<\/p>\n