![\"webhooks\"](\"http:\/\/blogs.encamina.com\/desarrollandosobresharepoint\/wp-content\/uploads\/sites\/8\/2016\/06\/webhooks.png\")
Los tiempos en el desarrollo van cambiando y junto a ello naturalmente las herramientas de desarrollo, los patrones y la forma en la que se hacen las cosas.<\/h4>\nLos tiempos en el desarrollo van cambiando y junto a ello naturalmente las herramientas de desarrollo, los patrones y la forma en la que se hacen las cosas.<\/h4>\nUn claro ejemplo son los Event Receiver y los WebHook. Hasta hace unos a\u00f1os nuestro pensamiento era que nuestra aplicaci\u00f3n ten\u00eda que estar esperando determinados cambios para realizar determinadas acciones. En caso de que esto fuera una aplicaci\u00f3n de terceros, tendr\u00edamos bien que implementar un proceso o \u00abdemonio\u00bb que estuviera permanentemente comprobando si se cumple una determinada condici\u00f3n para hacer determinada acci\u00f3n.<\/p>\n
Ahora bien, esto est\u00e1 claro que en un modelo de desarrollo basado en el cloud d\u00f3nde tenemos que simplificar el tiempo de proceso (y por lo tantos los costes). A ra\u00edz de esto surge el concepto de WebHook<\/strong>. Podemos definirlo como:<\/p>\n Realizar llamadas \u00abCallBacks\u00bb que hacen las aplicaciones Web, pudiendo ser esta llamada por nuestra aplicaci\u00f3n o bien por terceras aplicaciones que nada tiene que ver la aplicaci\u00f3n original. <\/em><\/p>\n Aplicaciones como GitHub, Slack, WordPress, etc. las pusieron de moda. \u00a0Nosotros en ENCAMINA<\/a>,\u00a0en nuestro Slack, tenemos varios WebHooks contra Visual Studio Team Services<\/strong> porque nos interesa saber cu\u00e1l es el resultado de la Build o cu\u00e1ndo finalizamos tareas.<\/p>\n <\/p>\n <\/p>\n Dado que cambi\u00f3 la pauta del funcionamiento, cuando hay un evento que nuestra aplicaci\u00f3n necesita saber, la aplicaci\u00f3n origen notifica a dicha aplicaci\u00f3n. En este post, vamos a ver una introducci\u00f3n de c\u00f3mo montar un WebHook en ASP.NET<\/strong>.<\/p>\n <\/p>\n <\/p>\n <\/p>\n Para empezar nos creamos un proyecto\u00a0\u00a0MVC + Web API<\/strong>\u00a0 utilizando autenticaci\u00f3n con Cuentas Individuales tal y como se muestra en la siguiente imagen:<\/p>\n <\/p>\n <\/p>\n A continuaci\u00f3n, en nuestra soluci\u00f3n a\u00f1adiremos los siguientes paquetes Nugget<\/strong>:<\/p>\n <\/p>\n Una vez a\u00f1adido esto dentro de la clase\u00a0WebApiConfig.Register\u00a0<\/strong>a\u00f1adimos las siguientes l\u00edneas:<\/p>\n <\/p>\n Los WebHooks los podemos bien guardar en memoria, en una tabla de SQL Server o bien en un BlobStorage de Azure. Por este motivo, hay dos paquetes de Nugget id\u00f3neos\u00a0para administrar estos WebHooks seg\u00fan la opci\u00f3n que decidamos:<\/p>\n <\/p>\n <\/p>\n Ahora vamos a ver la definici\u00f3n del conjunto de filtros de eventos que estar\u00e1n disponibles para los consumidores de sus WebHooks. Los filtros indican qu\u00e9 eventos se pueden subscribir<\/strong>. Por defecto, el sistema registra un filtro comod\u00edn que permite subscribirse a todos los eventos que se exponen. Para ello tendremos que implementar la interfaz IWebHookFilterProvider. Interfaz que solamente expone el m\u00e9todo GetFiltersAsync.<\/p>\n Una vez implementados los filtros, lo que vamos a hacer es crear diversos controladores que al invocarlos ser\u00e1n los encargados de enviar dicho evento a todos los subscriptores<\/strong> de dicho WebHook.<\/p>\n A\u00f1adiremos un controlador MVC vac\u00edo que en la acci\u00f3n del Summit generar\u00e1 un evento utilizando el m\u00e9todo NotifyAsync.<\/p>\n <\/p>\n Para poder llamar a este m\u00e9todo, se debe realizar con un usuario autenticado. En caso de que no lo pongamos, no se realizar\u00e1 la petici\u00f3n.<\/p>\n Para el caso de una WebAPi<\/strong> el c\u00f3digo es muy similar:<\/p>\n Una vez tenemos creado el Sending, en nuestra aplicaci\u00f3n crearemos un Receptor para comprobar el correcto funcionamiento<\/strong> del mismo. Para ello, en primer lugar agregaremos el siguiente paquete Nuget:<\/p>\n Microsoft.AspNet.WebHooks.Receivers.Custom<\/a>\u00a0\u00a0<\/b>Dentro del fichero\u00a0WebApiConfig.Register\u00a0<\/strong>a\u00f1adiremos la siguiente linea:<\/p>\n <\/p>\n En el WebConfig tambi\u00e9n a\u00f1adiremos la siguiente entrada, en la que indicamos el token key de nuestro webHook.<\/p>\n <\/p>\n A cotinuaci\u00f3n nos creamos una clase TestHandler que hereda de WebHookHandler. Este ser\u00e1 el punto de nuestra aplicaci\u00f3n que estar\u00e1 permanentemente a la escucha de que se notifique un WebHook.<\/strong> Para ello, implementaremos el siguiente c\u00f3digo:<\/p>\n Ahora para probar agregaremos el siguiente c\u00f3digo, que lo que hace es suscribirnos a todos los eventos del WebHook y tenemos llamadas a los m\u00e9todos<\/strong> en el NotifyApiController y NotifyController. Para ello agregamos el siguiente c\u00f3digo en la vista Views\/Home\/Index.cshtml<\/p>\n Si ahora\u00a0nos subscribimos a los eventos que nos proporciona el WebHook, lanzamos uno de ellos y ponemos un punto de parada en el Handler, veremos lo siguiente:<\/p>\n <\/p>\n En el tiempo en el que el Cloud es una realidad, los WebHooks son\u00a0una forma simple y sencilla que permite a nuestra aplicaci\u00f3n la comunicaci\u00f3n con terceras aplicaciones de la forma menos costosa posible.<\/strong> En siguientes art\u00edculos veremos c\u00f3mo incorporarlos a SharePoint Online en sustituci\u00f3n de los Remote Event Receivers.<\/p>\n El c\u00f3digo lo ten\u00e9is disponible para descargar en mi repositorio de GitHub \ud83d\ude09 Bibliograf\u00eda<\/strong><\/p>\n Los tiempos en el desarrollo van cambiando y junto a ello naturalmente las herramientas de desarrollo, los patrones y la forma en la que se hacen las cosas. Un claro ejemplo son los Event Receiver y los WebHook. Hasta hace … Continue reading ![\"Slack\"](\"http:\/\/blogs.encamina.com\/desarrollandosobresharepoint\/wp-content\/uploads\/sites\/8\/2016\/07\/Slack.png\")
<\/p>\n![](\"http:\/\/www.hanselman.com\/blog\/content\/binary\/Windows-Live-Writer\/fa342a3c97d5_D620\/WebHookReceivers_3132734c-c730-475e-a3c9-1239b97b542d.png\")
<\/p>\nCuando trabajamos con los WebHooks tenemos dos opciones que implementar:<\/h3>\n
\n
Manos a la obra<\/h2>\n
![\"ExampleWebHook\"](\"http:\/\/blogs.encamina.com\/desarrollandosobresharepoint\/wp-content\/uploads\/sites\/8\/2016\/07\/ExampleWebHook.png\")
<\/p>\n\n
\r\n config.InitializeCustomWebHooks(); \r\n config.InitializeCustomWebHooksApis();\r\n<\/pre>\n
![](\"https:\/\/msdnshared.blob.core.windows.net\/media\/MSDNBlogsFS\/prod.evol.blogs.msdn.com\/CommunityServer.Blogs.Components.WeblogFiles\/00\/00\/00\/63\/56\/metablogapi\/5428.SubscriptionStore_thumb_4D000B6B.png\")
<\/p>\nDefinici\u00f3n del conjunto de filtros de eventos<\/h2>\n
\r\n public class BlogsEncaminaFilter: IWebHookFilterProvider\r\n {\r\n private readonly Collection<WebHookFilter>; filters = new Collection<WebHookFilter>;\r\n {\r\n new WebHookFilter { Name = "DesarrollandoSobreSharePoint", Description = "Nuevo Post."},\r\n new WebHookFilter { Name = "PorUnaNubeSostenible", Description = "Nuevo Post."},\r\n };\r\n public Task<Collection<WebHookFilter>> GetFiltersAsync()\r\n {\r\n return Task.FromResult(this.filters);\r\n }\r\n }\r\n<\/pre>\n<\/h2>\n
Enviando notificaciones<\/h2>\n
\r\n [Authorize]\r\n public class NotifyController : Controller\r\n {\r\n [HttpPost]\r\n public async Task<ActionResult> Submit()\r\n {\r\n \/\/ Create an event with action 'event1' and additional data\r\n await this.NotifyAsync("DesarrollandoSobreSharePoint", new { Titulo = "Nuevo post" });\r\n\r\n return new EmptyResult();\r\n }\r\n }\r\n<\/pre>\n\r\n [Authorize]\r\n public class NotifyApiController : ApiController\r\n {\r\n public async Task Post()\r\n {\r\n \/\/ Create an event with 'event2' and additional data\r\n await this.NotifyAsync("PorUnaNubeSostenible", new { Titulo = "Nuevo articulo" });\r\n }\r\n }\r\n<\/pre>\n<\/h2>\n
Creando un Receptor<\/h2>\n
\r\nconfig.InitializeReceiveCustomWebHooks();\r\n<\/pre>\n
\r\n<appSettings>\r\n<add key="MS_WebHookReceiverSecret_Custom" value="12345678901234567890123456789012"\/>\r\n<\/appSettings>\r\n<\/pre>\n
\r\n public class TestHandler : WebHookHandler\r\n {\r\n public override Task ExecuteAsync(string receiver, WebHookHandlerContext context)\r\n {\r\n return Task.FromResult(true);\r\n }\r\n }\r\n<\/pre>\n\r\n\r\n<form onsubmit="return subscribe()">\r\n Subscribe to all events <input type="submit" value="submit">\r\n<\/form>\r\n<form onsubmit="return unsubscribe()">\r\n Unsubscribe from all events <input type="submit" value="submit">\r\n<\/form>\r\n<form onsubmit="return notifymvc()">\r\n Trigger notification through MVC controller <input type="submit" value="submit">\r\n<\/form>\r\n<form onsubmit="return notifyapi()">\r\n Trigger notification through Web API controller <input type="submit" value="submit">\r\n<\/form>\r\n\r\n<script>\r\nfunction subscribe() {\r\n $.ajax({\r\n type: "POST",\r\n url: "\/api\/webhooks\/registrations",\r\n data: JSON.stringify({\r\n WebHookUri: "http:\/\/localhost:23224\/api\/webhooks\/incoming\/custom",\r\n Secret: "12345678901234567890123456789012",\r\n Description: "My first WebHook!"\r\n }),\r\n contentType: "application\/json; charset=utf-8",\r\n dataType: "json",\r\n success: function(data, status) { alert(status); },\r\n failure: function(errMsg) { alert(errMsg); }\r\n });\r\n return false;\r\n}\r\n\r\nfunction unsubscribe() {\r\n $.ajax({\r\n url: "\/api\/webhooks\/registrations",\r\n type: 'DELETE',\r\n success: function (data, status) { alert(status); },\r\n failure: function(errMsg) { alert(errMsg); }\r\n });\r\n return false;\r\n}\r\n\r\nfunction notifymvc() {\r\n $.post("\/notify\/submit",\r\n { },\r\n function (data, status) { alert("Data: " + data + "\\nStatus: " + status); });\r\n return false;\r\n}\r\n\r\nfunction notifyapi() {\r\n $.post("\/api\/notifyapi",\r\n { },\r\n function (data, status) { alert("Data: " + data + "\\nStatus: " + status); });\r\n return false;\r\n}\r\n<\/script>\r\n<\/pre>\n![\"Handler\"](\"http:\/\/blogs.encamina.com\/desarrollandosobresharepoint\/wp-content\/uploads\/sites\/8\/2016\/07\/Handler-1024x172.png\")
<\/p>\nResumen<\/h2>\n
WebHooks es una nuevo patr\u00f3n\/utilidad muy \u00fatil para comunicar nuestra aplicaci\u00f3n con terceros.<\/h3>\n
\n![\"github\"](\"http:\/\/blogs.encamina.com\/desarrollandosobresharepoint\/wp-content\/uploads\/sites\/8\/2016\/07\/github-1024x380.png\")
<\/p>\n\n