Tutorial: Implementar una definición de lista de tareas de proyecto

En este tutorial se muestra cómo utilizar Visual Studio 2010 para crear, personalizar, depurar e implementar una definición de lista de SharePoint para realizar un seguimiento de las tareas del proyecto.

En este tutorial se muestran las tareas siguientes:

• Crear un proyecto de definición de lista de SharePoint que contenga tareas.

• Agregar la definición de lista a una característica de SharePoint.

• Agregar un receptor de eventos a la lista.

• Crear y personalizar un paquete de SharePoint para implementar la característica.

• Compilar e implementar una solución de SharePoint.

Requisitos previos

Necesita los componentes siguientes para completar este tutorial:

• Ediciones compatibles de Microsoft Windows y SharePoint. Para obtener más información, vea Requisitos para desarrollar soluciones de SharePoint.

• Visual Studio 2010 Professional o una edición de Visual Studio Application Lifecycle Management (ALM).

Crear una definición de lista de SharePoint

Cree un proyecto de definición de lista de SharePoint y asocie la definición a tareas.

Para crear un proyecto de definición de lista de SharePoint

1. Abra el cuadro de diálogo Nuevo proyecto, expanda el nodo de SharePoint y haga clic en 2010.

2. En el recuadro Plantillas, seleccione DefiniciónLista, denomine el proyecto ListaTareasProyecto y, a continuación, haga clic en Aceptar.

   Aparece el Asistente para la personalización de SharePoint.

3. Escriba el sitio de SharePoint local que utiliza para depurar y, a continuación, haga clic en Siguiente.

4. Para el Nombre para mostrar de la lista, escriba Lista Tareas Proyecto.

5. En el menú desplegable ¿De qué tipo es la definición de lista?, seleccione, Tareas y, a continuación, haga clic en Finalizar.

   La definición de lista, la instancia de lista, la característica y el paquete aparecerán en el Explorador de soluciones.

Agregar un receptor de eventos

En la definición de la lista de tareas, puede agregar un receptor de eventos que automáticamente establezca la fecha de vencimiento y la descripción de la tarea. En el procedimiento siguiente se agrega un controlador de eventos simple a la instancia de la lista como un receptor de eventos.

Para agregar un receptor de eventos

1. Haga clic con el botón secundario en el nodo del proyecto, apunte a Agregar y haga clic en Nuevo elemento.

2. En la lista de plantillas de SharePoint 2010, seleccione Receptor de eventos y denomínelo ReceptorEventosListaTareasProyecto.

   Aparece el Asistente para la personalización de SharePoint.

3. En la página Elegir configuración del receptor de eventos, seleccione Eventos de elementos de lista como el tipo de receptor de eventos.

4. Establezca el Elemento de origen de eventos en ListaTareasProyecto.

5. En la lista de eventos para controlar, active la casilla situada junto a Se agregó un elemento y, a continuación, haga clic en Finalizar.

   Un nuevo nodo de receptor de eventos se agrega al proyecto con un archivo de código que se denomina ReceptorEventosListaTareasProyecto.

6. Agregue código al método ItemAdded del archivo de código ReceptorEventosListaTareasProyecto. Cada vez que se agrega una nueva tarea, se le agrega una fecha de vencimiento y una descripción predeterminadas. La fecha de vencimiento predeterminada es el 1 de julio de 2009.

   Public Overrides Sub ItemAdded(ByVal properties As SPItemEventProperties)
       MyBase.ItemAdded(properties)
       Dim web As SPWeb = properties.OpenWeb()
       properties.ListItem("Due Date") = "July 1, 2009"
       properties.ListItem("Description") = "This is a critical task."
       properties.ListItem.Update()
   End Sub
   

    public override void ItemAdded(SPItemEventProperties properties)
   {
       base.ItemAdded(properties);
       SPWeb web = properties.OpenWeb();
       properties.ListItem["Due Date"] = "July 1, 2009";
       properties.ListItem["Description"] = "This is a critical task.";
       properties.ListItem.Update(); 
   }  
   

Personalizar la característica Lista de tareas de proyecto

Al crear una solución de SharePoint, Visual Studio crea automáticamente las características de los elementos predeterminados del proyecto. Puede personalizar la configuración de la lista de tareas de proyecto para el sitio de SharePoint mediante el diseñador de características.

Para personalizar la característica de lista de tareas de proyecto

1. En el Explorador de soluciones, expanda Características.

2. Haga doble clic en Característica1.

3. En el campo Título, escriba Característica Lista Tareas Proyecto.

4. En el menú desplegable Ámbito, seleccione Web.

5. En la ventana Propiedades, escriba 1.0.0.0 como el valor de la propiedad Version.

Personalizar el paquete de lista de tareas de proyecto

Al crear un proyecto SharePoint, Visual Studio agrega automáticamente las características que contienen los elementos predeterminados del proyecto al paquete. Puede personalizar la configuración de la lista de tareas de proyecto para el sitio de SharePoint mediante el diseñador de paquetes.

Para personalizar el paquete de lista de tareas de proyecto

1. En Explorador de soluciones, haga doble clic en Paquete.

2. En el campo Nombre, escriba PaqueteListaTareasProyecto.

3. Seleccione Reiniciar servidor web.

Compilar y probar la lista de tareas del proyecto

Cuando se ejecuta el proyecto, se abre el sitio de SharePoint. Sin embargo, debe navegar manualmente hasta la ubicación de la lista de tareas.

Para probar la lista de tareas del proyecto

1. Presione F5 para compilar e implementar la lista de tareas de proyectos.

   Se abre el sitio de SharePoint.

2. Haga clic en Inicio.

3. En la barra lateral izquierda, haga clic en ListaTareasProyecto - InstanciaLista1.

   Aparece la página Lista de tareas del proyecto.

4. En la pestaña Herramientas de lista, haga clic en Elementos.

5. Haga clic en Nuevo elemento.

6. Haga clic en Tarea.

7. En el cuadro de texto Título, escriba Tarea1.

8. Haga clic en Guardar.

   Una vez estado actualizado el sitio, la tarea Tarea1 aparece con una fecha de vencimiento de 1/7/2009.

9. Haga clic en Tarea1.

   Aparece la vista detallada de la tarea y la descripción muestra "Esta es una tarea crítica".

Implementar la lista de tareas de proyecto

Después de compilar y probar la lista de tareas del proyecto, puede implementarla en el sistema local o en un sistema remoto. El sistema local es el mismo equipo donde se desarrolló la solución, mientras que un sistema remoto es un equipo diferente.

Para implementar la lista de tareas del proyecto en el sistema local

• En el menú Generar, haga clic en Implementar.

  Visual Studio recicla el grupo de aplicaciones IIS, contrae las versiones existentes de la solución, copia el archivo de paquete de solución (.wsp) en SharePoint y, a continuación, activa sus características. Ahora puede usar la solución de SharePoint. Para obtener más información acerca de los pasos de configuración de la implementación, vea Cómo: Modificar una configuración de implementación de SharePoint.

Para implementar la lista de tareas del proyecto en un sistema remoto

1. En el menú Generar, haga clic en Paquete.

   De esta forma se crea un archivo .wsp para la solución en la carpeta de depuración binaria del proyecto (…\<Project Name>\<Project Name>\bin\Debug).

2. Copie el archivo .wsp en el sistema de SharePoint remoto.

3. Use el comando de PowerShell Add-SPUserSolution para instalar el paquete en la instalación de SharePoint remota. (Para las soluciones de granja de servidores, use el comando Add-SPSolution).

   Por ejemplo: Add-SPUserSolution C:\MyProjects\ProjectTaskList\ProjectTaskList\bin\Debug\ProjectTaskList.wsp.

4. Use el comando de PowerShell Install-SPUserSolution para implementar la solución. (Para las soluciones de granja de servidores, use el comando Install-SPSolution).

   Por ejemplo: Install-SPUserSolution –Identity ProjectTaskList.wsp –Site http://NewSiteName.

   Para obtener más información sobre la implementación remota, vea Uso de soluciones y Adding and Deploying Solutions with PowerShell in SharePoint 2010.

Pasos siguientes

Puede obtener más información sobre cómo personalizar e implementar las soluciones de SharePoint de los temas siguientes:

• Tutorial: Crear un campo, tipo de contenido, definición de lista e instancia de lista personalizados

• Cómo: Crear un receptor de eventos

• Windows PowerShell para SharePoint Server 2010

Vea también

Otros recursos

Empaquetar e implementar soluciones de SharePoint