Notificaciones a Aplicaciones Windows Phone desde SharePoint Parte I

​Una de las nuevas características que introduce SharePoint 2013es que permite a los dispositivos móviles registrarse en nuestra aplicación. Una vezregistradoel dispositivose puede escribir código de controlador de eventos para interactuar con el servicio de notificacionespushde Microsoft(MPNS o Microsoft PushNotificationsService)o con servicios de notificación de otras plataformas de dispositivos móviles.

Una de las características de losmóvilescon WP es que tienen un servicio de notificaciones Push, que permite que cualquier aplicación externa pueda comunicarse con este servicio y de esta forma mostrar un aviso a nuestra aplicación tal y como se muestra en esta figura.

Existen tres tipos de notificaciones que podemos utilizaren los dispositivos con Windows Phone 7.5 (en la versión 8 se han añadido más tipos de notificaciones):

Notificaciones Toast:Es aquella que se muestra ocupando la parte superior de la pantalla, con un color de fondo igual al color de resaltado del dispositivo. Se compone de tres elementos:

·Titulo:Texto en negrita que se muestra justo a continuación del icono de la aplicación y se establece en la propiedad Text1 del elemento del esquema XML.

·Subtitulo:Texto sin negrita mostrado después del titulo y establecido por la propiedad Text2 del esquema XML.

·Parámetro:Un parámetro que no será mostrado pero será enviado a la aplicación cuando el usuario presione la notificación Toast, definido en la propiedadParamdel esquema XML.

Notificaciones Tile:Actualiza el Live Tile para la aplicación en la pantalla de inicio del teléfono, cambiando el gráfico, el título del mosaico, y el contador numérico en el mosaico. Son recibidas incluso si la aplicación está ejecutando.Al trabajar con notificaciones Tile debemos tener en cuenta las siguientes restricciones:

·A ser posible usaremos locales y no remotas para los tiles, de esta forma reduciremos el consumo de transferencia y evitaremos retardos al enviar imágenes con la notificación.

·Las imágenes para los tiles deben estar en formatopngojpg.

·No está soportado HTTPS para imágenes remotas.

·El tamaño máximo de imagen remota es de 80KB, si la imagen tiene un tamaño será descartada y no se descargará.

·Si por alguna razón la imagen frontal o trasera falla al descargarse, ninguna de las demás propiedades se establecerá.

Notificaciones RAW(o en bruto):Nos permite enviar información a nuestra aplicación para que este la procese y use. No es un tipo de notificación para mostrar directamente al usuario, como lo son las notificaciones Toast y Tile. Este tipo de notificación nos permite enviar información a nuestra aplicación de cualquier tipo, otorga mayor flexibilidad que los tipos anteriores, porque no estamos obligados a usar unos campos concretos.

Para hacer mas ameno la explicación vamos a ponernos en un ejemplomas o menos real, tenemos en un servidor SharePoint donde tenemos la información de los números de Compartimos, así como los artículos que hay en la revista. En base a estos datos tenemos una aplicación Windows Phone en la que se visualiza esta información y recibe las notificaciones cada vez que sale un nuevo número de la revista.

Manos a la obra

En primer lugar, vamos a realizar la parte que tenemos que implementar en la nueva versión de nuestro servidor favorito.

Para permitir que en el sitio puedan subscribirse los dispositivos móviles para poder recibir las notificaciones que se producen en los eventos del sitio tenemos que activar esta característica:

Esta característica la podemos activar con el siguiente código en C# añadido en el momento que activamos nuestra característica y de esta forma siempre que despleguemos nuestra solución tendremos activada la característica y nos olvidamos de problemas (para mi esta es la opción adecuada):

spWeb.Features.Add(newGuid(PushNotificationFeatureId),false);

A continuación partimos que tenemos dos listas en SharePoint:

Revista esta compuesta por estas tres columnas:

• Titulo: donde se guarda el titulo de este número de la revista
• Fecha: de publicación de la revista
• Imagen: Donde almacenamos la caratula de la revista
• Número de artículos

Articulo esta compuesta por tres columnas:

• Titulo : donde se guarda el titulo del artículo
• Autor: persona que ha escrito el artículo en la revista
• Contenido: En este campo es de tipo multi línea y en el que esta almacenado el desarrollo del artículo.
• Revista de tipo Lookup donde indicamos en que número de la revista se ha publicado este artículo.

Nuestra intención es que cada vez que se agregue un elemento a lista Revista dentro de nuestra aplicación se envié:

• una notificación Toast en la que se indique que ha salido un nuevo ejemplar de nuestra revista.
• una notificación Tile en el que le enviaremos la nueva portada de la Revista, asi como el número de artículos que la componen.
• una notificación Raw que la utilizara la aplicación Windows Phone internamente para tareas de administración interna.

Para crearnos las listas bien la podemos hacer de dos formas con la interfaz de usuario de SharePoint o mediante programación como por ejemplo el siguiente código para crear la lista Articulo:

1internalvoidCreateListArticulo(SPWebspWeb)
2
3{
4
5stringlistTitle="Articulos";
6
7stringlistDescription="Lista donde están losarticulospublicados en la revistaCompartiMOSS.";
8
9
10
11Dictionary<string,SPFieldType> columns =newDictionary<string,SPFieldType>();
12
13columns.Add("Autor",SPFieldType.Text);
14
15columns.Add("Contenido",SPFieldType.Note);
16
17
18
19GuidlistId=spWeb.Lists.Add(listTitle,listDescription,SPListTemplateType.GenericList);
20
21SPListlist =spWeb.Lists[listId];
22
23SPViewview =list.DefaultView;
24
25
26
27foreach(stringkeyincolumns.Keys)
28
29{
30
31list.Fields.Add(key, columns[key],false);
32
33view.ViewFields.Add(key);
34
35}
36
37
38
39list.Update();
40
41view.Update();
42
43}
44

Una vez ya tenemos las listas creadas, abrimos un proyecto SharePoint 2013 en blanco. Agregamos una clase Notificacion en la que nos vamos a crear los métodos que se encargaran de enviar las notificaciones a los dispositivos Windows Phone subscritos a nuestra lista.

Creamos un procedimiento que se va a encargar de enviar las notificaciones. La principal novedad es que vamos a utilizar una variable de tipo SPPushNotificationSubscriber este tipo de variable es una de las novedades del modelo de objetos de SP2013. Lo importante de este tipo de variables es que tienen almacenado la dirección Uri donde tenemos que enviar la notificación. Este procedimiento es valido para los tres tipos de notificaciones en base a que tipo de notificación pondemos un valor distinto en la variable “notificationType”. Dependiendo de que tipo de notificación sea, la variable message tendrá una estructura de XML diferente

1///<summary>
2
3///Procedimiento para enviar la notificación WP
4
5///</summary>
6
7///<paramname="notificationType">Tile = 1, Toast = 2, Raw = 3</param>
8
9///<paramname="subscriber"></param>
10
11///<paramname="message">Mensaje de lanotificacion</param>
12
13///<paramname="intervalValue">Intervalo para esperar lanotificacion</param>
14
15///<returns></returns>
16
17privatevoidSendPushNotification(NotificationTypeEnumnotificationType,SPPushNotificationSubscribersubscriber,stringmessage,intintervalValue)
18
19{
20
21// Creamos un objeto HTTP WebRequestque es el encargado de comunicar.
22
23stringsubscriptionUri=subscriber.ServiceToken;
24
25HttpWebRequestsendNotificationRequest= (HttpWebRequest)WebRequest.Create(subscriptionUri);
26
27
28
29// MPNS espera un vector de bytes por lo que lo codificamos el mensaje.
30
31byte[]notificationMessage=Encoding.Default.GetBytes(message);
32
33
34
35//Establecemoslas propiedaddelHTTPRequestpara enviar la notificación
36
37sendNotificationRequest.Method=WebRequestMethods.Http.Post;
38
39sendNotificationRequest.ContentLength=notificationMessage.Length;
40
41sendNotificationRequest.ContentType="text/xml";
42
43sendNotificationRequest.Headers.Add("X-MessageID",Guid.NewGuid().ToString());
44
45
46
47switch(notificationType)
48
49{
50
51caseNotificationTypeEnum.Tile:
52
53sendNotificationRequest.Headers.Add("X-WindowsPhone-Target","token");
54
55break;
56
57caseNotificationTypeEnum.Toast:
58
59sendNotificationRequest.Headers.Add("X-WindowsPhone-Target","toast");
60
61break;
62
63caseNotificationTypeEnum.Raw:
64
65// En el caso de las notificacionesRawno se especifica ningún tipo de cabecera.
66
67break;
68
69}
70
71
72
73sendNotificationRequest.Headers.Add("X-NotificationClass",intervalValue.ToString());
74
75
76
77using(StreamrequestStream=sendNotificationRequest.GetRequestStream())
78
79{
80
81requestStream.Write(notificationMessage, 0,notificationMessage.Length);
82
83}
84
85
86
87try
88
89{
90
91//Enviamos la notificación, en un caso real esperaríamos la respuesta y bien la almacenamos en alguna lista o tomamos alguna determinación como volver a enviar la notificación.
92
93HttpWebResponseresponse = (HttpWebResponse)sendNotificationRequest.GetResponse();
94
95
96
97}
98
99}
100
101

A continuación en esta clase vamos a añadirle el procedimiento PushToast, que será el que invoquemos para enviar la notificación al móvil. Este procedimiento va a generar la estructura del XML que tenemos que enviar, tiene tres valores que hay que rellenar Text1, donde en nuestro caso estará el titulo del articulo, Text2 que en nuestro caso pondremos el nombre de la persona que ha escrito el articulo, y en la parte del Param la vamos a dejar en blanco (generalmente en el param se pone una pagina que se quiera mostrar cuando en el dispositivo móvil)..

1publicvoidPushToast(SPPushNotificationSubscribersubscriber,stringtoastTitle,stringtoastMessage,
2
3stringtoastParam,ToastIntervalValuesEnumintervalValue)
4
5{
6
7stringtoastNotification="<?xml version=\"1.0\" encoding=\"utf-8\"?>"+
8
9"<wp:Notificationxmlns:wp=\"WPNotification\">"+
10
11"<wp:Toast>"+
12
13"<wp:Text1>"+toastTitle+"</wp:Text1>"+
14
15"<wp:Text2>"+toastMessage+"</wp:Text2>"+
16
17"<wp:Param>"+toastParam+"</wp:Param>"+
18
19"</wp:Toast> "+
20
21"</wp:Notification>";
22
23
24
25SendPushNotification(NotificationTypeEnum.Toast, subscriber,toastNotification, (int)intervalValue);
26
27}
28

También añadiremos un procedimiento PushTile que como parámetros tiene los siguientes: Imagen de Fondo, Contador, Titulo, Imagen de Fondo Trasera y Titulo de fondo.

1publicvoidPushTile(SPPushNotificationSubscribersubscriber,stringtileFrontal,stringtileImagenF,stringtileContador,stringtileTrasero,
2
3stringtileImagenT,stringtileContenido, ToastIntervalValuesEnumintervalValue)
4
5{
6
7// Construct toast notification message from parameter values.
8
9stringtileNotification="<?xml version=\"1.0\" encoding=\"utf-8\"?>"+
10
11"<wp:Notificationxmlns:wp=\"WPNotification\">"+
12
13"<wp:Tile>"+
14
15"<wp:BackgroundImage>"+tileImagenF+"</wp:BackgroundImage>"+
16
17"<wp:Count>"+tileContador+"</wp:Count>"+
18
19"<wp:Title>"+tileFrontal+"</wp:Title>"+
20
21"<wp:BackBackgroundImage>"+tileImagenT+"</wp:BackBackgroundImage>"+
22
23"<wp:BackTitle>"+tileTrasero+"</wp:BackTitle>"+
24
25"<wp:BackContent>"+tileContador+"</wp:BackContent>"+
26
27"</wp:Tile> "+
28
29"</wp:Notification>";
30
31
32
33returnSendPushNotification(NotificationTypeEnum.Toast, subscriber,tileNotification, (int)intervalValue);
34
35}
36

Finalmente añadiremos un procedimiento PushRaw donde no se establece ningún tipo de parametrización, le enviaremos un mensaje con la estructura que nosotros queramos. Va a ser una notificación interna que se utiliza para labores internas en la aplicación móvil.

1publicvoidPushRaw(SPPushNotificationSubscribersubscriber,stringrawMessage,RawIntervalValuesEnumintervalValue)
2
3{
4
5returnSendPushNotification(NotificationTypeEnum.Raw, subscriber,rawMessage, (int)intervalValue);
6
7}
8

A continuación a nuestro proyecto le añadimos un EventReceiver (Receptor de Eventos), seleccionamos una Lista Personalizada y seleccionamos el evento de añadir un elemento en una lista.

Implementamos el siguiente código consulta todos los dispositivos móviles que están subscritos en este sitio y a cada dispositivo le envía una notificación con los datos que acabamos de añadir en la lista.

1///<summary>
2///Cuando añadimos un elemento a la lista.
3
4///</summary>
5
6publicoverridevoidItemAdded(SPItemEventPropertiesproperties)
7
8{
9
10SPWebspWeb=properties.Web;
11
12SPPushNotificationSubscriberCollectionpushSubscribers=spWeb.PushNotificationSubscribers;
13
14PushNotificationpushNotification=newPushNotification();
15
16
17
18SPListItemlistItem=properties.ListItem;
19
20
21
22stringtitleRevista=listItem["Title"].ToString();
23
24stringfechaRevista=listItem["Fecha"].ToString();
25
26stringimagenRevista=listItem["Imagen"].ToString();
27
28stringcontadorRevista=listItem["contador"].ToString();
29
30
31
32foreach(SPPushNotificationSubscriberpsinpushSubscribers)
33
34{
35
36//Enviode notificaciones ToastpushNotification.PushToast(ps,titleRevista,fechaRevista,string.Empty,ToastIntervalValuesEnum.ImmediateToast);
37
38//Enviode notificaciones Tile
39
40pushNotification.PushTile(ps,titleRevista,string.Empty,imagenRevista,contadorRevista,string.Empty,string.EmptyToastIntervalValuesEnum.ImmediateTile);
41
42//Enviode notificacionesRaw
43
44pushNotification.PushRaw(ps,titleRevista,"NuevoNumero",ToastIntervalValuesEnum.ImmediateRaw);
45
46
47
48}
49
50base.ItemAdded(properties);
51
52}
53

¿Comoenviar las notificacionesenSharePoint2010?

Tal y como habéis visto con anterioridad,en la nueva versión deSharePoint el gran beneficio que tiene es que se almacena internamente los dispositivos que están subscritos a nuestras listas, que esto no es más que hay una lista oculta en el que se almacena esta información. Por lo tanto el primer paso para empezar es crearnos una lista “Subscriptores” que solo va a tener dos camposGuidyChannelUri(elGuidpara tener un control de los dispositivos que tenemos almacenados y elChannelUripara tener la dirección a la cual enviamos la notificación).

El siguiente paso al igual que en SharePoint 2013 es crearnos una clase PushNotificacion, la única diferencia es que no vamos a utilizar las variables de tipo SPPushNotificationSubscriber y las vamos a sustituir por cadenas de tipo string(lo único que necesitamos para enviar la notificación es la dirección URI). El código resultante quedaría de la siguiente forma:

1privatevoidSendPushNotification(NotificationTypeEnumnotificationType,stringsubscriber,stringmessage,intintervalValue)
2
3{
4
5// Creamos un objeto HTTP WebRequestque es el encargado de comunicar.
6
7HttpWebRequestsendNotificationRequest= (HttpWebRequest)WebRequest.Create(subscriber);
8
9
10
11El resto del código a implementar						 es exactamente igual.
12
13
14
15Una vez ya tenemos implementada la clase						 PushNotification, añadimos un						 eventReceiver						 (del mismo tipo que en el sitio de 2013), y ahora lo que tenemos que implementar es el funcionamiento del objeto “SPPushNotificationSubscriberCollection” que no es más que consultar las direcciones URI que tenemos almacenada en la lista de subscriptores						 para hacerlo en 2010- Una vez tenemos los subscriptores les enviamos la notificación a los dispositivos vinculados. Aquí está el código que implementa esta acción:
16
17
18
19public override void ItemAdding(SPItemEventProperties properties)
20
21{
22
23base.ItemAdding(properties);
24
25
26
27List<string> Subscripter= GetListSubscriptores(properties);
28
29SPListItem listItem = properties.ListItem;
30
31
32
33stringtitleRevista=listItem["Title"].ToString();
34
35stringfechaRevista=listItem["Fecha"].ToString();
36
37stringimagenRevista=listItem["Imagen"].ToString();
38
39stringcontadorRevista=listItem["contador"].ToString();
40
41
42
43foreach (string UriSubcripcion in Subscripter)
44
45{
46
47// Envio de notificaciones Toast
48
49pushNotification.PushToast(UriSubcripcion,titleArticulo, autorArticulo, string.Empty, ToastIntervalValuesEnum.ImmediateToast);
50
51//Enviode notificaciones Tile
52
53pushNotification.PushTile(UriSubcripcion,titleRevista,string.Empty,imagenRevista,contadorRevista,string.Empty,string.EmptyToastIntervalValuesEnum.ImmediateTile);
54
55//Enviode notificacionesRaw
56
57pushNotification.PushRaw(UriSubcripcion,titleRevista,"NuevoNumero",ToastIntervalValuesEnum.ImmediateRaw);
58
59
60
61}
62
63}
64
65/// <summary>
66
67/// Devuelve las direcciones de los dispositivos subscriptos
68
69/// </summary>
70
71/// <param name="properties"></param>
72
73/// <returns></returns>
74
75private List<string> GetListSubscriptores(SPItemEventProperties properties)
76
77{
78
79List<string> resultado = new List<string>();
80
81foreach (SPListItem item in properties.Web.Lists["Subscriptores"].GetItems())
82
83{
84
85resultado.Add(item["ChannelUri"].ToString());
86
87}
88
89return resultado;
90
91}
92

Resumen

Eneste artículo hemos visto una de las grandes novedades que trae consigo SharePoint2013 y es como enviar notificaciones a dispositivos moviles que estan subscritos a estas listas de SharePoint. De la misma forma hemos visto como es relativamente utilizar las listas de Sharepoint en Windows Phone y otorgarle un plus de interacción con el usuario, algo que estamoda esta con la llegada de los nuevos productos de Microsoft.

A su vez tambien es visto como a pesar de todas estas mejorasen SharePoint 2013 no es mas que una evolución deSharePoint2010, en la que mejora muchas cosas, pero esto no impide que se puedan hacer, aunque para ello es necesario realizar unas pequeñas modificaciones.Muchos de nosotros nos va a tocar pelearnos durante un cierto tiempo con la versión 2010 y siempre es muy util obtener todas las mejoras posibles y que esten adaptadas a las necesidades del usuario final de la aplicación.

Para el siguiente número dejamos la parte de como implementar la aplicación Windows Phone tanto en su versión 7.5 como en la recientemente liberada 8, un paso más para hacer el circulo cada vez más estrecho y más sencillo para el desarrollador con lo cual siempre se puede ofrecer un mejor producto al cliente final.

Referencias

Novedades de los dispositivos móviles (SharePoint 2013 Preview)

http://technet.microsoft.com/es-es/library/fp161352(v=office.15).aspx

How to: Configure and use push notifications in SharePoint 2013 apps for WindowsPhone

http://msdn.microsoft.com/es-es/library/jj163784(office.15).aspx

Adrián Díaz Cervera

MCPD SharePoint 2010

Microsoft Active Professional 2012

addiacer@gmail.com

@AdrianDiaz81