GuilleSQL :: Microsoft SQL Server, SSIS, y más !!

Crear un Formulario ASPX para una Lista de SharePoint 2010 en Visual Studio 2010


El presente artículo detalla paso a paso una manera de desarrollar con Visual Studio 2010 un Formulario ASPX para añadir, editar o mostrar (add, edit, ó display) elementos en una Lista de SharePoint 2010, de tal modo que seamos capaces de personalizar dicho formulario conforme a nuestras necesidades de negocio. Una técnica, que junto a la posibilidad de desarrollar Workflows y Event Handlers, aporta gran riqueza al desarrollo y personalización de Aplicaciones en SharePoint 2010.

Cómo desarrollar con Visual Studio 2010 un Formulario ASPX para añadir, editar o mostrar elementos de una Lista en SharePoint 2010, es una pregunta típica de desarrollo en SharePoint, ya que aporta una gran riqueza en la personalización de SharePoint que puede resultarnos de gran utilidad.

El presente artículo, describe una forma de hacer esto, conforme a como describe Ingo Karstein en su Blog (ver enlaces más abajo). En mi caso, he intentado seguir los pasos de Ingo y describir lo que he realizado, con los correspondiente pantallazos y demás, pero en Español.

Descripción del Escenario de Prueba

Partimos de un Proyecto de SharePoint 2010 en Visual Studio 2010, configurado para ser desplegado en la Granja (es decir, es una Farm Solution y no una Sandboxed Solution), que incluye entre otras cosas una Definición de Lista (List Definition) con su correspondiente Instancia (List Instance), ambos de forma declarativa (CAML).

El presente ejercicio pretende demostrar cómo crear un formulario ASPX para una Lista, ya sea un Formulario para añadir, ver o editar elementos (add, new ó display). En nuestro caso de ejemplo, vamos a crear un nuevo formulario para añadir elementos a la Lista.

Partimos de un Proyecto de SharePoint 2010 en Visual Studio 2010, configurado para ser desplegado en la Granja (es decir, es una Farm Solution y no una Sandboxed Solution), que incluye entre otras cosas una Definición de Lista (List Definition) con su correspondiente Instancia (List Instance), ambos de forma declarativa (CAML)

1) Desplegar la Solución de Visual Studio 2010 y crear un nuevo Formulario ASPX de ejemplo desde SharePoint Designer 2010

En esta primera parte, vamos a desplegar nuestro Proyecto de SharePoint, para una vez desplegado, crear un nuevo Formulario ASPX desde SharePoint Designer y copiar su código. El objetivo: obtener un código HTML de ejemplo, para de este modo, no partir desde un lienzo en blanco.

Para empezar vamos a desplegar nuestro Proyecto, por ejemplo pulsando F5 (Start Debugging) en Visual Studio. Una vez que el Proyecto ha sido desplegado, nos conectaremos con SharePoint Designer 2010 al Site sobre el que hemos realizado el despliegue, abriremos las Propiedades de la Lista sobre la que deseamos crear el nuevo Formulario ASPX (en nuestro caso de ejemplo, es la lista Service Requests), y crearemos un nuevo Formulario ASPX.

Para empezar vamos a desplegar nuestro Proyecto, por ejemplo pulsando F5 (Start Debugging) en Visual Studio. Una vez que el Proyecto ha sido desplegado, nos conectaremos con SharePoint Designer 2010 al Site sobre el que hemos realizado el despliegue, abriremos las Propiedades de la Lista sobre la que deseamos crear el nuevo Formulario ASPX (en nuestro caso de ejemplo, es la lista Service Requests), y crearemos un nuevo Formulario ASPX.

Especificaremos que deseamos crear un nuevo Formulario ASPX para añadir elementos a la lista (New ítem form), especificaremos un nombre cualquiera al formulario, y click OK para continuar.

Especificaremos que deseamos crear un nuevo Formulario ASPX para añadir elementos a la lista (New ítem form), especificaremos un nombre cualquiera al formulario, y click OK para continuar.

Realizado esto, editaremos el nuevo Formulario ASPX desde SharePoint Designer 2010 (por ejemplo, desde las Propiedades de la Lista podremos ver el nuevo formulario, y editarlo), y seguidamente haremos click en la opción Advanced Mode.

Realizado esto, editaremos el nuevo Formulario ASPX desde SharePoint Designer 2010 (por ejemplo, desde las Propiedades de la Lista podremos ver el nuevo formulario, y editarlo), y seguidamente haremos click en la opción Advanced Mode.

Una vez hecho esto, seleccionaremos TODO el código fuente HTML del formulario ASPX, y temporalmente lo guardaremos en un fichero de texto, por ejemplo utilizando Notepad, al que podríamos llamar New.txt.

Con esto, ya podemos detener la sesión de depuración que habíamos iniciado en Visual Studio.

2) Añadir un nuevo Formulario ASPX a una Lista de un Proyecto en Visual Studio 2010

En esta segunda parte, vamos a añadir un nuevo Formulario ASPX a nuestro Proyecto, para que sea utilizado al añadir (New) nuevos elementos a la Lista. El procedimiento a seguir, sería similar si quisiéramos crear un Formulario ASPX para mostrar o editar (Display ó Edit) elementos de Lista.

De vuelta a Visual Studio 2010, ahora tenemos que añadir un nuevo elemento (Add Item) a nuestro Proyecto, de tipo Application Page.

De vuelta a Visual Studio 2010, ahora tenemos que añadir un nuevo elemento (Add Item) a nuestro Proyecto, de tipo Application Page.

Esto hará que se cree una nueva Página ASPX dentro de la carpeta Layouts, en particular bajo una subcarpeta con el mismo nombre que nuestro Proyecto de Visual Studio (ej: ITSM).

Esto hará que se cree una nueva Página ASPX dentro de la carpeta Layouts, en particular bajo una subcarpeta con el mismo nombre que nuestro Proyecto de Visual Studio (ej: ITSM).

Moveremos (Drag & Drop) esta nueva Página ASPX de la carpeta LAYOUTS a nuestra Definición de Lista (en nuestro caso de ejemplo, a lstServiceRequests, justo debajo), y seguidamente en las Propiedades de dicha Página ASPX, deberemos cambiar el valor de la Propiedad Deployment Type a ElementFile. Hecho esto, podríamos ya eliminar la carpeta LAYOUTS de nuestro Proyecto de Visual Studio, si no la necesitamos para nada más.

Moveremos (Drag & Drop) esta nueva Página ASPX de la carpeta LAYOUTS a nuestra Definición de Lista (en nuestro caso de ejemplo, a lstServiceRequests, justo debajo), y seguidamente en las Propiedades de dicha Página ASPX, deberemos cambiar el valor de la Propiedad Deployment Type a ElementFile. Hecho esto, podríamos ya eliminar la carpeta LAYOUTS de nuestro Proyecto de Visual Studio, si no la necesitamos para nada más.

Editaremos en Visual Studio la Página ASPX (en nuestro caso, newServiceRequest.aspx), y eliminaremos TODO el contenido de la página, excepto las líneas que contienen las directivas @Page y @Assembly. Seguidamente, en la línea de código de la directiva @Page, sustituiremos el atributo DynamicMasterPageFile por MasterPageFile.

Editaremos en Visual Studio la Página ASPX (en nuestro caso, newServiceRequest.aspx), y eliminaremos TODO el contenido de la página, excepto las líneas que contienen las directivas @Page y @Assembly. Seguidamente, en la línea de código de la directiva @Page, sustituiremos el atributo DynamicMasterPageFile por MasterPageFile.

Ahora copiaremos en nuestra Página ASPX de Visual Studio, todo el código de la Página ASPX que obtuvimos en el paso anterior con SharePoint Designer. Bueno, todo el código excepto la línea que contiene la Directiva @Page.

Ahora copiaremos en nuestra Página ASPX de Visual Studio, todo el código de la Página ASPX que obtuvimos en el paso anterior con SharePoint Designer. Bueno, todo el código excepto la línea que contiene la Directiva @Page.

Seguidamente eliminaremos el contenido del nodo ZoneTemplate (sin eliminar dicho nodo) e incluiremos el código HTML personalizado tras la WebPartZone.

Seguidamente eliminaremos el contenido del nodo ZoneTemplate (sin eliminar dicho nodo) e incluiremos el código HTML personalizado tras la WebPartZone.

A continuación editaremos el fichero Code Behind de nuestra Página ASPX, es decir, el fichero que contiene el código C# (en nuestro caso de ejemplo, newServiceRequest.aspx.cs), y realizaremos dos modificaciones: añadiremos una referencia Microsoft.SharePoint.WebPartPages, y sustituiremos el tipo base de nuestra Página ASPX, de LayoutsPageBase a WebPartPage.

A continuación editaremos el fichero Code Behind de nuestra Página ASPX, es decir, el fichero que contiene el código C# (en nuestro caso de ejemplo, newServiceRequest.aspx.cs), y realizaremos dos modificaciones: añadiremos una referencia Microsoft.SharePoint.WebPartPages, y sustituiremos el tipo base de nuestra Página ASPX, de LayoutsPageBase a WebPartPage.

Ahora editaremos el fichero Schema.xml de la Definición de Lista que estamos personalizando. Buscaremos la etiqueta Form correspondiente al Formulario ASPX utilizado para añadir nuevos elementos a la lista y realizaremos dos modificaciones: Primero añadiremos el atributo UseLegacyForm="TRUE" (ojito con el TRUE, que sean todas las letras en mayúscula) y seguidamente modificaremos el valor del atributo SetupPath al valor features\$SharePoint.Feature.DeploymentPath$\lstServiceRequests\newServiceRequest.aspx.

Ahora editaremos el fichero Schema.xml de la Definición de Lista que estamos personalizando. Buscaremos la etiqueta Form correspondiente al Formulario ASPX utilizado para añadir nuevos elementos a la lista y realizaremos dos modificaciones: Primero añadiremos el atributo UseLegacyForm=TRUE (ojito con el TRUE, que sean todas las letras en mayúscula) y seguidamente modificaremos el valor del atributo SetupPath al valor features\$SharePoint.Feature.DeploymentPath$\lstServiceRequests\newServiceRequest.aspx.

Y llegados a este punto, hemos acabado. La verdad que parece algo lioso, pero en cuanto lo haces unas cuantas veces seguidas, no deja de ser un sota-caballo-rey.

3) Probar el nuevo Formulario ASPX

Ahora toca probar el formulario, por ejemplo pulsando F5 (Start Debugging) en Visual Studio, e intentando añadir un nuevo elemento a nuestra Lista de ejemplo (Service Requests), para así comprobar si el nuevo Formulario ASPX que estamos desarrollando, se muestra o no. Y pinta que sí.

Ahora toca probar el formulario, por ejemplo pulsando F5 (Start Debugging) en Visual Studio, e intentando añadir un nuevo elemento a nuestra Lista de ejemplo (Service Requests), para así comprobar si el nuevo Formulario ASPX que estamos desarrollando, se muestra o no. Y pinta que sí.

Por supuesto, queda pendiente ver cómo personalizar este tipo de Formularios ASPX, ya que nuestro caso de ejemplo no aporta una gran funcionalidad.

Despedida y Cierre

Hasta aquí llega el presente artículo, en el cual hemos intentado presentar una manera en la que desplegar nuestros propios Formularios ASPX para añadir, editar y mostrar elementos en una Lista de SharePoint desde un Proyecto de Visual Studio. A continuación tenéis algunos enlaces de interés, para quién desee consultar más información.

Poco más por hoy. Como siempre, confío que la lectura resulte de interés.

 


[Fecha del Artículo (UTC): 20/08/2013]
[Autor: GuilleSQL]



Escribir un Comentario

Para poder escribir un comentario, debe Iniciar Sesión con un usuario.

Si no dispone de un usuario, puede Registrarse y hacerse miembro.

Si dispone de un usuario, pero no recuerda sus credenciales de acceso, puede Restablecer su Contraseña.

Miembros de
Miembros de GITCA (Global IT Community Association)

Menu de Usuario
  Iniciar Sesión
  Registrarse
  Restablecer Contraseña
  Ventajas de Registrarse

Acerca de
  Contigo desde Oct 2007
  771 usuarios registrados
  86146 pageloads/mes
  Ranking Alexa 498160

Social Networks
Sigue a Portal GuilleSQL en Linkedin !!
Sigue a Portal GuilleSQL en Twitter !!



Archivo

Marzo de 2017 (3)
Enero de 2017 (4)
Junio de 2016 (1)
Mayo de 2016 (2)
Abril de 2016 (2)
Septiembre de 2015 (2)
Agosto de 2015 (2)
Junio de 2015 (10)
Mayo de 2015 (4)
Abril de 2015 (8)
Marzo de 2015 (11)
Octubre de 2014 (3)
Septiembre de 2014 (7)
Agosto de 2014 (5)
Julio de 2014 (2)
Mayo de 2014 (4)
Abril de 2014 (4)
Marzo de 2014 (4)
Febrero de 2014 (1)
Enero de 2014 (5)
Diciembre de 2013 (8)
Noviembre de 2013 (2)
Octubre de 2013 (7)
Septiembre de 2013 (6)
Agosto de 2013 (1)
Julio de 2013 (6)
Junio de 2013 (11)
Mayo de 2013 (7)
Abril de 2013 (6)
Febrero de 2013 (5)
Enero de 2013 (7)
Diciembre de 2012 (12)
Noviembre de 2012 (13)
Octubre de 2012 (5)
Septiembre de 2012 (3)
Agosto de 2012 (6)
Julio de 2012 (4)
Junio de 2012 (1)
Mayo de 2012 (2)
Abril de 2012 (7)
Marzo de 2012 (16)
Febrero de 2012 (9)
Enero de 2012 (5)
Diciembre de 2011 (10)
Noviembre de 2011 (10)
Octubre de 2011 (4)
Septiembre de 2011 (5)
Agosto de 2011 (2)
Julio de 2011 (2)
Junio de 2011 (4)
Mayo de 2011 (2)
Abril de 2011 (6)
Marzo de 2011 (4)
Febrero de 2011 (10)
Enero de 2011 (5)
Diciembre de 2010 (6)
Noviembre de 2010 (4)
Octubre de 2010 (8)
Septiembre de 2010 (4)
Agosto de 2010 (1)
Julio de 2010 (3)
Mayo de 2010 (5)
Abril de 2010 (6)
Marzo de 2010 (8)
Febrero de 2010 (3)
Enero de 2010 (1)
Diciembre de 2009 (9)
Noviembre de 2009 (14)
Octubre de 2009 (2)
Septiembre de 2009 (8)
Agosto de 2009 (2)
Julio de 2009 (10)
Junio de 2009 (9)
Mayo de 2009 (10)
Abril de 2009 (9)
Marzo de 2009 (3)
Febrero de 2009 (2)
Enero de 2009 (3)
Noviembre de 2008 (2)
Octubre de 2008 (2)
Septiembre de 2008 (2)
Agosto de 2008 (5)
Julio de 2008 (5)
Junio de 2008 (1)
Mayo de 2008 (3)
Abril de 2008 (2)
Marzo de 2008 (2)
Febrero de 2008 (2)
Enero de 2008 (5)
Noviembre de 2007 (2)
Octubre de 2007 (2)






Esta información se proporciona "como está" sin garantías de ninguna clase, y no otorga ningún derecho.
This information is provided "AS IS" with no warranties, and confers no rights.

Copyright © 2007 GuilleSQL, todos los derechos reservados.
GuilleSQL.com y GuilleSQL.net son también parte de Portal GuilleSQL.

Visitas recibidas (Page Loads) en GuilleSQL (fuente: StatCounter):

screen resolution stats
Visitas