Anteriormente:
1 - Creando nuestro primer WebPart para Sharepoint Services 3.0
Continuando con la serie de artículos acerca de la creación de WebParts para Sharepoint Services 3.0, el paso lógico es crear algo más que un simple WebPart que diga "Hola Mundo!" :-) Así que vamos a ponernos manos a la obra: ¿Que tal si primero identificamos a nuestro interlocutor? Si sabemos el nombre del usuario siempre podremos saludarlo y parecer así un poco más educados...
Para realizar esto vamos a agregar una segunda clase en el proyecto anterior MisPrimerosWebParts, de modo que cada WebPart sea un poco más evolucionado que su predecesor:
1: public class ElSegundo : WebPart
2: {
3: protected override void RenderContents(HtmlTextWriter writer)
4: {
5: writer.Write("Hola {0}", this.Page.User.Identity.Name.ToString());
6: base.RenderContents(writer);
7: }
8: }
Bien, aunque no hemos avanzado demasiado por lo menos es un primer paso. Aunque lo que realmente me gustaría es que el usuario pudiese personalizar el saludo y de este modo abordaremos el verdadero propósito de este artículo: La persistencia de propiedades de la clase en Sharepoint Services.
No basta con crear una propiedad en la clase para que pueda ser persistida y representada en Sharepoint Services mediante un control PropertyGridEditorPart, ésta debe implementar una serie de atributos:
1: Personalizable(PersonalizationScope.Shared / User)
Indica el ámbito de personalización del WebPart. El ámbito Shared significa que los datos de personalización se aplican a todos los usuarios y para todos los controles personalizables de una página, y que también están disponibles para guardarse en la página. Mientras que el ámbito User indica que los datos de personalización específicos del usuario, así como los datos de personalización aplicables a todos los usuarios, se cargan para todos los controles personalizables de una página. Sólo los datos de personalización específicos del usuario pueden guardarse en la página.
Indica si la propiedad designada de un control de elementos Web se muestra en un objeto PropertyGridEditorPart.
1: WebDisplayName("Nombre de la propiedad")
Define el nombre descriptivo de una propiedad de un control de elementos Web.
1: WebDescription("Descripción de la propiedad")
Define el valor de cadena que se va a utilizar como información sobre herramientas de una propiedad de un control de elementos Web.
En nuestro caso particular vamos a crear una propiedad "Saludo" que permita almacenar el saludo preferido por el usuario, de modo que la propiedad implemente los atributos descritos anteriormente del siguiente modo:
1: private string strSaludo = ""
2:
3: [Personalizable(PersonalizationScope.Shared) ,
4: WebBrowsable,
5: WebDisplayName("Tipo de saludo"),
6: WebDescription("Permite personalizar el tipo de saludo")
7: ]
8: public string Saludo
9: {
10: get
11: {
12: if (strSaludo == String.Empty)
13: {
14: strSaludo = "Hola";
15: }
16: return strSaludo;
17: }
18: set { strSaludo = value; }
19: }
20:
Ahora podremos utilizar la nueva propiedad en el método "RenderControls" para mostrar correctamente el mensaje al usuario:
1: protected override void RenderContents(HtmlTextWriter writer)
2: {
3: writer.Write("{0}, {1}", Saludo, this.Page.User.Identity.Name.ToString());
4: base.RenderContents(writer);
5: }
Y para terminar, ya que nuestro WebPart posee propiedades personalizadas, vamos a redondearlo permitiendo la exportación de éstas en forma de fichero XML (esto es sumamente sencillo, y basta con agregar una línea de código en el constructor de la clase, indicando en modo de exportación):
1: public ElSegundo()
2: {
3: ExportMode = WebPartExportMode.All;
4: }
Ahora si. Una vez hemos terminado, debemos volver a generar nuestro proyecto y seguir los pasos que indicábamos en el artículo anterior
. Es decir: copiar el ensamblado en el servidor, añadirlo en la GAC, reiniciar IIS (de hecho sólo es necesario reiniciar los servicios de aquellos sitios de WSS 3.0 dónde se haya desplegado el WebPart, etc...).
Una vez agregado nuestro WebPart a una página podremos observar que podemos editar sus propiedades, y que entre ellas aparece la propiedad creada anteriormente, el valor de la cual podremos modificar y Sharepoint Services se encargará de persistir su valor en la página.
En el próximo artículo mostraremos cómo acceder a una base de datos SQL Server para mostrar información, y de paso como parametrizar la ubicación del servidor (ya sabemos que los servidores a veces nunca se están quietos) y protegernos en caso de un error en tiempo de ejecución mostrando un mensaje personalizado con la excepción.