SharePoint 2010 y Azure: Integración con el Windows Azure Data Market (II)!

Siguiendo con la serie de posts sobre como integrar Windows Azure Data Market y SharePoint 2010, en esta ocasión vamos a ver como podemos realizar dicha integración a través de un Business Data Connectivity Model o simplemente un conector de BCS (Business Connectivity Services) que crearemos en Visual Studio 11 Beta (VS 11 Beta) y que luego desplegaremos en nuestro ambiente de SharePoint. Empecemos:

  • Lo primero que tenemos que hacer como siempre es conocer la forma que tenemos de integrar la fuente de datos del Windows Azure Data Market. En mi caso, voy a trabajar con el set de datos 2006 – 2008 Crime in the United States que se puede integrar de forma muy sencilla en nuestras aplicaciones sin más que añadir una referencia al correspondiente servicio que en este caso es: https://api.datamarket.azure.com/data.gov/Crimes/
  • Como siempre, antes de ponernos a  hacer nada podemos jugar con el set de datos directamente desde el Data Market.
  • En VS 11 Beta creamos un proyecto de tipo SharePoint 2010 Project al que añadimos un elemento de tipo Business Data Connectivity Model que pasaremos a parametrizar a continuación. Este modelo tendrá una única entidad, Crime, que nos permitirá acceder a la información de los crímenes que expone el servicio.
image image image
  • En lugar de trabajar con el diseñador del Business Data Connectivity Model, vamos a agregar en primer lugar la lógica necesaria para acceder a los datos del servicio. Para ello, añadimos en primer lugar una referencia al citado servicio en nuestro proyecto. Tendremos que añadir además una referencia a System.Data.Services.Client.
  • A partir de aquí, en el explorador de soluciones vamos a preparar las dos clases que se crean al añadir el elemento de tipo Business Data Connectivity Model al proyecto: Entity1 y Entity1Service. La primera clase modela la entidad tipo que nos permite integrar los datos del servicio en SharePoint a través de una serie de propiedades. La segunda, contiene los métodos que permiten trabajar con entidades de tipo Entity1.
  • En mi caso, he renombrado Entity1 a Crime y le he añadido las siguientes propiedades que luego se mapearán a propiedades del set de datos expuestos por el servicio:
   1: public partial class Crime

   2: {

   3:     //TODO: Implement additional properties here. The property Message is just a sample how a property could look like.

   4:     public int ID { get; set; }

   5:     public string State { get; set; }

   6:     public string City { get; set; }

   7:     public int Year { get; set; }

   8:     public int Population { get; set; }

   9:     public int Burglary { get; set; }

  10:     public int LarcenyTheft { get; set; }

  11:     public int MotorVehicleTheft { get; set; }

  12: }

  • A continuación iremos por la clase Entity1Service que en este caso renombramos a CrimeService. En la misma añadimos referencias a System.Net, System.Data.Services.Clien y al servicio de Windows Azure Data Market.
  • Añadimos a la clase un método que nos permita devolver un proxy al servicio. Como veis, simplemente se trata de devolver dicho proxy y además lidiar con no tener problemas de conexión por SSL usando para ello ServicePointManager y confiando en certificados del Windows Azure Data Market. Este proxy nos permitirá acceder a los datos del servicio.

   1: private static datagovCrimesContainer GetProxy()

   2: {

   3:     ServicePointManager.ServerCertificateValidationCallback =

   4:         ((sender, certificate, chain, sslPolicyErrors) => 

   5:             certificate.Subject.Contains("datamarket"));

   6:     Uri serviceUri =

   7:         new Uri("https://api.datamarket.azure.com/Data.ashx/data.gov/Crimes");

   8:     datagovCrimesContainer proxy =

   9:         new datagovCrimesContainer(serviceUri);

  10:     proxy.Credentials =

  11:         new NetworkCredential("Yor Data Market Account",

  12:             "Your Data Market Key");

  13:     return proxy;

  14:  

  15: }

  • Esta clase al menos tiene que implementar dos métodos:
    • Uno de tipo “Specific finder” que devuelva una entidad de tipo Crime en base a un parámetro como por ejemplo puede ser un identificador. En este caso, el método en cuestión se ha renombrado a ReadCrime. Cómo veis, a partir de un identificador y el proxy podemos acceder fácilmente a un registro expuesto por el servicio y devolverlo.
   1: public static Crime ReadCrime(int id)

   2: {

   3:     datagovCrimesContainer proxy = GetProxy();

   4:  

   5:     var results = from stat in proxy.CityCrime

   6:                   where stat.ROWID == id

   7:                   select stat;

   8:  

   9:     Crime currentStat = new Crime();

  10:  

  11:     currentStat.ID = results.Single().ROWID;

  12:     currentStat.City = results.Single().City;

  13:     currentStat.State = results.Single().State;

  14:     currentStat.Year = results.Single().Year;

  15:     currentStat.Population = results.Single().Population;

  16:     currentStat.Burglary = results.Single().Burglary;

  17:     currentStat.LarcenyTheft = results.Single().LarcenyTheft;

  18:     currentStat.MotorVehicleTheft = results.Single().MotorVehicleTheft;

  19:  

  20:     return currentStat;

  21: }

    • Uno de tipo “finder” que nos devuelva una colección de objetos de tipo Crime. En este caso se ha renombrado el método a ReadCrimes(). Como antes, a partir del proxy es sencillo obtener una colección de objetos CityCrime expuestos por el servicio que luego usaremos para devolver la colección de objetos de tipo Crime.
   1: public static IEnumerable<Crime> ReadCrimes()

   2: {

   3:     List<Crime> queryResults = new List<Crime>();

   4:  

   5:     datagovCrimesContainer proxy = GetProxy();

   6:  

   7:     IEnumerable<CityCrime> crimes = 

   8:         proxy.CityCrime.Where(c => c.State ==

   9:                "Washington" && (c.Year == 2008 || c.Year == 2007));

  10:  

  11:     //Procesando el set de datos devuelto

  12:     foreach (var c in crimes)

  13:     {

  14:         Crime cr = new Crime();

  15:         cr.ID = c.ROWID;

  16:         cr.City = c.City;

  17:         cr.State = c.State;

  18:         cr.Year = c.Year;

  19:         cr.Population = c.Population;

  20:         cr.Burglary = c.Burglary;

  21:         cr.LarcenyTheft = c.LarcenyTheft;

  22:         cr.MotorVehicleTheft = c.MotorVehicleTheft;

  23:  

  24:         queryResults.Add(cr);

  25:     }

  26:  

  27:     return queryResults.ToList();

  28: }

  • A partir de aquí, de vuelta al explorador del modelo de BDC tenemos que configurar adecuadamente la entidad Crime para que se usen estos métodos y tenga los miembros correspondientes de acuerdo a la definición de la clase. Este trabajo lo haremos en el diseñador del modelo y el explorador.
  • En el diseñador configuraremos el nombre de la entidad y de los métodos expuestos. Mientras que en el explorador del modelo configuraremos adecuadamente los parámetros de entrada y de salida de cada uno de estos métodos.
  • Una vez creado el conector, simplemente lo desplegamos y en nuestro sitio de SharePoint creamos la correspondiente lista externa que mostrará los datos expuestos por el servicio.
image image image

 

Y hasta aquí llega este segundo post sobre la integración de SharePoint 2010 y el Windows Azure Data Market.

SharePoint 2010 y Azure: Integración con el Windows Azure Data Market (I)!

Otro gran punto de integración entre SharePoint 2010 y Windows Azure es a través del Windows Azure Data Market de manera que podemos acceder a datos publicados utilizando artefactos de SharePoint como pueden ser WebParts o conectores de BCS. En este primer post os voy a mostrar como podemos usar Bing Translator, que ya está incluido en el Windows Azure Data Market, para poder realizar traducciones en una WebPart. Comencemos:

image image image

Partimos del ejemplo de uso de Microsoft Translator que pasa por descargarse el proxy C# disponible en la página de detalle de Microsoft Translator en el Data Market. A partir de aquí, ya estamos listos para codificar de acuerdo a los siguientes pasos:

  • Agregar referencia a System.Data.Services.Client puesto que los datos del Data Market los consultaremos a través de servicios REST.
  • Añadir directivas using a System.Data.Services.Client, System.Net y el espacio de nombres del proxy que nos hemos bajado (Microsoft en este caso).
  • Especificar la cuenta y clave de uso del Azure Data Market.
  • Evitar el infame error: The underlying connection was closed: Could not establish trust relationship for the SSL/TLS secure channel, date una vuelta por este enlace para saber de que estamos hablando. Como veis, en mi caso y dado que esto son pruebas uso SharePointManager para saltarme problemas de certificados y dar por válidos los certificados usados por el Azurre Data Market. Si quieres específicamente confiar únicamente en los certificados del Windows Azure Data Market, basta con cambiar que se confía en todos los certificados (valor true) por certificate.Subject.Contains("datamarket").
  • Creamos una instancia del objeto TranslatorContainer definido en el proxy y que nos permite realizar la consulta de traducción.
  • Especificamos la url del servicio de Microsoft Translator y las credenciales de acceso al Windows Azure Data Market.
  • A partir de aquí especificamos que queremos traducir, el idioma de destino y el de origen…realizamos la traducción y procesamos los resultados.
   1: try

   2: {

   3:     this.txtTranslation.Text = "";

   4:     // tUri del Servicio 

   5:     Uri uServiceRootUri =

   6:                    new Uri(

   7:                        "https://api.datamarket.azure.com/Bing/MicrosoftTranslator/");

   8:  

   9:     //  Claves de acceso

  10:     string sAccountUser = "TuCuenta";

  11:     string sAccountKey = "TuClave";

  12:  

  13:     // Objeto Translator Container

  14:     ServicePointManager.ServerCertificateValidationCallback =

  15:         ((MySender, certificate, chain, sslPolicyErrors) => true); 

  16:     TranslatorContainer tc = 

  17:         new TranslatorContainer(uServiceRootUri);

  18:  

  19:     // Credenciales de acceso 

  20:     tc.Credentials = 

  21:         new NetworkCredential(sAccountUser,sAccountKey); 

  22:  

  23:     //*****************************************

  24:     //A traducir

  25:     //*****************************************

  26:  

  27:     // Generamos la consulta 

  28:     var translationQuery = 

  29:         tc.Translate(this.txtWordToTranslate.Text,"en","es");

  30:  

  31:     // Ejecutamos la consulta

  32:     var translationResults = translationQuery.Execute();

  33:  

  34:     // Procesamos los resultados

  35:     if (translationResults!=null)

  36:     {

  37:         foreach (var item in translationResults)

  38:         {

  39:             this.txtTranslation.Text += item.Text;

  40:         }

  41:     }                

  42:  

  43: }

  44: catch (Exception ex)

  45: {

  46:  

  47:     this.lblError.Text = "Error: " +

  48:         ex.Message;

  49: }

Y finalmente la prueba del algodón:

image

Otros posts sobre la integración de SharePoint y Azure:

SharePoint 2010: Tipos de campo soportados como “Projected Fields” al relacionar listas!

Cómo sabéis, en SharePoint 2010 (como en la versión predecesora) es posible relacionar dos listas a través de columnas de tipo búsqueda (Lookup). La novedad que incorporó SharePoint 2010 es que además de relacionar dos listas mediante un campo de búsqueda definido en la lista padre que apunte a una columna de la lista hija, podemos traer columnas adicionales de la lista hija a través de la característica de campos proyectados. Ahora bien, hay que tener en cuenta que no todos los campos definidos en la lista hija pueden ser campos proyectados…en concreto, los siguientes tipo de campos se soportan como proyectados al relacionar dos listas y por ende se pueden usar en consultas CAML definidas a las dos listas:

  • Calculated (treated as plain text).
  • ContentTypeId.
  • Counter.
  • Currency.
  • DateTime.
  • Guid.
  • Integer.
  • Note (one-line only).
  • Number.
  • Text.

Por último, os recomiendo que reviséis la sección de la SharePoint Guidance en la que se tratan estos temas y en los que se resumen de forma muy esquematizada:

  • Como relacionar dos listas mediante campos de lookup.
  • Como se define un campo de lookup en SharePoint 2010.
Ff798514.84ceee0b-1351-487a-a0b6-e10050bb1998(en-us,PandP.10).png Ff798514.ae9fd5b2-ccab-481f-84e2-56d0efeac718(en-us,PandP.10).png

Referencias:

SharePoint Online: Microsoft incrementa “y bastante” el número de usuarios externos que se pueden invitar!

SharePoint Online (SPO) en Office 365 permite modelar escenarios Extranet en los que puedan colaborar usuarios externos a partir de la característica de “Invitar a usuarios externos” disponible tanto para planes P como para planes E. Hasta ahora esta característica tenía unas limitaciones que Microsoft ha decidido mejorar ya que:

  • En planes P sólo se podía invitar hasta 50 usuarios externos, y si necesitabas invitar a más usuarios externos no te quedaba otra que cambiar a un plan de tipo E.
  • En planes E, se incluía en el precio la invitación a 50 usuarios externos y si necesitabas más podías adquirir paquetes adicionales de invitaciones a 50 usuarios externos.

Por suerte, y como se comenta en este enlace, estos límites se han extendido ampliamente de manera que en planes P se pueden invitar hasta a 500 usuarios externos y en planes E ya no hay límite…simplemente genial.

image

SharePoint 2010: Cómo crear un flujo re-utilizable de forma global!

Como sabéis, con SharePoint 2010 contamos con la posibilidad de crear flujos de trabajo re-utilizables en SharePoint Designer 2010 (SPD 2010), es decir, flujos que no están “atados” a una lista concreta o incluso a un tipo de contenido concreto de manera que el flujo puede ser re-utilizado en todo el sitio vinculándolo a cualquier lista o tipo de contenido del mismo. Una pregunta que puede surgir es si es posible re-utilizar este flujo en otros sitios, la respuesta es que inicialmente no, pero podemos configurarlo para que sea globalmente re-utilizable:

  • Abrimos un sitio cualquiera con SPD 2010 y nos vamos a la sección de flujos de trabajo. Pulsamos la opción de la Ribbon que nos permite crear un flujo de trabajo re-utilizable.
  • En la pantalla inicial de definición del flujo, especificamos un nombre y descripción para el mismo. En principio, no lo vinculamos a un tipo de contenido concreto.
  • En el diseñador de flujos, modelamos un sencillo flujo de trabajo.
image image image
  • Guardamos el flujo y para publicarlo de forma global, no tenemos más que usar la opción correspondiente de la Ribbon (“Publish Globally”), de manera que se muestra un mensaje informativo indicando que el flujo se publicará en el catálogo de flujos globales de nuestro despliegue de SharePoint de manera que podremos utilizarlo en otros sitios.
  • Comprobamos que efectivamente el flujo aparece en otro sitio.
image image

SharePoint 2010 & SharePoint Online: Como automatizar el despliegue de una aplicación de Access Services (II)!

Siguiendo con la serie de posts sobre como automatizar el despliegue de una aplicación Access Services en SharePoint OnPremise u Online (SPO), en esta ocasión vamos a empatar el resultado del partido y casi a ganarlo ya que una vez que os muestre el camino alternativo de publicación, es muy fácil pensar en como mediante el modelo de objetos automatizar al máximo el despliegue de una aplicación de Access Services. Empecemos pues.

  • Lo primero que tenemos que hacer es crear una aplicación Access 2010 Web o bien partir de una existente.
  • En mi caso, he creado una nueva aplicación usando como base la plantilla Charitable Contributions.
  • Una vez que hemos realizado todas las personalizaciones e implementaciones de nuestra aplicación Access Web, empieza la “fiesta” para la publicación alternativa de la misma en los servicios de Access. Lo que tenemos que hacer es guardar la aplicación como plantilla de tipo “Database template” (ACCDT) a través de la opción “Save & Publish”.
image image image
  • De esta forma se abre una ventana en la que especificaremos los datos de la plantilla ACCDT a generar.
  • Una vez especificados estos datos, pulsamos “OK” y nos quedamos con la ruta dónde se guarda la plantilla.
  • Nos vamos a un sitio de SharePoint OnPremise o SPO y cargamos la plantilla en la galería de soluciones. Activamos la plantilla.
image image image
  • Una vez activada, nos vamos a Acciones del sitio –> Crear y buscamos nuestra plantilla (cuidado con el idioma). Configuramos los parámetros de creación del nuevo sitio y pulsamos “Crear”.
  • En mi caso, la prueba la he hecho en SPO y el proceso a finalizado con un error no especificado, pero creando el nuevo sitio por lo que deduzco que se ha debido dar algún Time Out en el proceso de creación…pero el resultado es qué la aplicación se crea, por lo que JC empata el partido.
  • Por supuesto, la aplicación está completamente operativa.
image image image

 

Referencia:

http://www.slideshare.net/patenik2/access-services-in-sharepoint-2010-all-you-need-to-know

SharePoint Online: Cómo registrar un manejador de eventos contra una lista personalizada (II)!

Siguiendo con la serie de posts sobre como registrar un manejador de eventos contra una lista personalizada de SharePoint Online (SPO), en esta ocasión toca ver la aproximación programática a través del modelo de objetos de SharePoint:

  • Una vez creado el manejador en VS 11 Beta, tenemos que averiguar la información del ensamblado correspondiente ya que la necesitaremos para registrar el manejador a la lista mediante el modelo de objetos. Para obtener esta información, simplemente usamos la utilidad Strong Name de VS 11 Beta que nos la vuelca en la ventana de salida.
  • A continuación, para registrar el manejador de eventos en la lista mediante el modelo de objetos tenemos que recurrir a un Feature Event Receiver…y es aquí dónde nos esperan las malas noticias: no es posible registrar el manejador de eventos mediante el modelo de objetos cuando se trata de una solución de tipo Sandbox…básicamente el método Add() que necesitamos para añadir el manejador a la colección de manejadores de la lista en cuestión no está disponible.
image image

Referencias: