Definir el complemento del portal del proyecto para una plantilla de procesos

Artículo
03/12/2013

Mediante el complemento de portal, se pueden definir las bibliotecas de documentos iniciales, la estructura de bibliotecas y los documentos del portal de un proyecto de equipo.También se pueden incluir las tareas que crean paneles e informes de Excel que están diseñados para trabajar con las plantillas de proceso para Microsoft Solutions Framework (MSF).

Importante
Las tareas que se especifican en el complemento para Productos de SharePoint solo se ejecutan cuando se crea un sitio de SharePoint al crear un proyecto de equipo.

En este tema

Nombre y ubicación del complemento de portal
Tareas y dependencias de creación de portal
Crear el sitio y especificar la plantilla del sitio
Crear las bibliotecas de documentos
Crear la estructura de carpetas de una biblioteca de documentos
Especificar los archivos que se cargan en las bibliotecas de documentos
Activar las características de panel

Nombre y ubicación del complemento de portal

En la siguiente tabla se resumen los nombres del archivo de complemento, la carpeta y el complemento de portal para las plantillas de proceso de MSF.

Nombre del archivo:	WssTasks.xml
Nombre de la carpeta:	Windows SharePoint Services
Nombre del complemento:	Microsoft.ProjectCreationWizard.Portal

[!NOTA]

Puede cambiar los nombres del archivo XML y de la carpeta pero no el del complemento.Visual Studio Team Foundation Server no incluye un mecanismo para la implementación de complementos de cliente, directivas u otras modificaciones.Si desea implementar este tipo de funcionalidad, debe utilizar su propio programa de instalación y distribución.

Volver al principio

Tareas y dependencias de creación de portal

En el archivo de complemento de portal, especifique una o varias tareas y sus dependencias.Especifique las siguientes tareas clave:

Crear el sitio utilizando una plantilla de sitio especificada
Crear las bibliotecas de documentos
Crear las carpetas y cargar los archivos en las bibliotecas de documentos
Activar las características de panel

Para obtener un ejemplo de una tarea que especifica un portal de proyecto simple, vea el archivo WssTasks.xml en la plantilla de proceso de MSF for Agile Software Development.

Para obtener más información sobre los requisitos y la administración de un sitio, vea SharePoint Products and Team Foundation Server.

Volver al principio

Crear el sitio y especificar la plantilla del sitio

Debe especificar una plantilla del sitio en la que se basará el portal del proyecto.La plantilla también debe estar disponible en el portal de Team Foundation Server para SharePoint.Las plantillas de sitio no se incluyen en la plantilla de procesos.

Especifique la plantilla del sitio mediante el elemento site.

<site template="" language=""/>

En la tabla siguiente se describen los atributos del elemento site.

Atributo	Descripción
plantilla	Especifica qué plantilla utilizar.Debe especificar una plantilla que esté definida en el servidor que hospeda Productos de SharePoint para los proyectos de equipo que se crearán. Para utilizar las características que están disponibles con la versión actual de las plantillas de proceso para MSF, especifique una de las cadenas siguientes: TFS2010 Agile Dashboard TFS2010 CMMI Dashboard
lenguaje	Especifica un identificador de configuración regional que indica la versión del idioma que se utilizará en la plantilla del sitio.La versión inglesa es 1033.

plantilla

Especifica qué plantilla utilizar.Debe especificar una plantilla que esté definida en el servidor que hospeda Productos de SharePoint para los proyectos de equipo que se crearán.

Para utilizar las características que están disponibles con la versión actual de las plantillas de proceso para MSF, especifique una de las cadenas siguientes:

TFS2010 Agile Dashboard
TFS2010 CMMI Dashboard

lenguaje

Especifica un identificador de configuración regional que indica la versión del idioma que se utilizará en la plantilla del sitio.La versión inglesa es 1033.

En el ejemplo siguiente se muestra cómo hacer referencia a la versión en inglés de la versión actual de la plantilla de proceso de MSF Agile, que admite paneles.

<tasks>
  <task id="SharePointPortal" name="Create Sharepoint Portal" plugin="Microsoft.ProjectCreationWizard.Portal" completionMessage="Project portal site created.">
    <dependencies />
    <taskXml>
        <Portal>
           <site template="TFS2010 Agile Dashboard" language="1033" />  
       . . . 
        </Portal>

[!NOTA]

Todas las demás tareas definidas en el complemento de portal dependen de la tarea de creación del sitio porque el portal del proyecto se debe crear antes de crear más bibliotecas de documentos o copiar archivos.

Rendimiento de la plantilla de procesos

Los archivos que se especifican en WssTasks.xml se incluyen como parte de la plantilla de proceso cuando se carga.El tamaño de la plantilla de procesos determina el tiempo que se necesita para crear un nuevo proyecto de equipo.Las plantillas de procesos grandes tardan más tiempo en crear nuevos proyectos de equipo.Por tanto, debería considerar estrategias alternativas que proporcionen archivos cuando el rendimiento de la plantilla disminuya.

Utilizar la plantilla del sitio

Puede incluir archivos como parte de la plantilla del sitio de SharePoint.Esto mueve los archivos de la plantilla de procesos a la plantilla del sitio y mejora el rendimiento cuando se crean proyectos de equipo nuevos.

Sin embargo, la enumeración de archivos en WssTasks.xml ofrece una ventaja.Se pueden enlazar archivos de Microsoft Project y Microsoft Excel a una consulta utilizando el atributo queryid descrito anteriormente.Esto ayuda a los miembros del equipo cuando abren los archivos porque ya estarán conectados al Team Foundation Server y a la consulta correcta.

Utilizar un sitio Web alternativo

Si tiene una extensa colección de archivos que se comparten entre varios proyectos de equipo, puede hospedarlos en un sitio Web alternativo y establecer vínculos a ellos desde el portal del proyecto o las páginas Web.Esta estrategia también aumenta el rendimiento cuando se crean proyectos de equipo, ya que no es preciso copiar los archivos en el portal del proyecto.Para obtener más información, vea Share Process Guidance for a Team Project.

Volver al principio

Crear las bibliotecas de documentos

Una vez creado el portal del proyecto, puede especificar que se creen bibliotecas de documentos adicionales.Utilice el elemento documentLibrary para especificar una biblioteca de documentos.

<documentLibraries>
   <documentLibrary name="" description="" isProcessGuidance="true | false" />
</documentLibraries>

[!NOTA]

No es posible habilitar o deshabilitar la creación de versiones de una biblioteca de documentos en la plantilla de procesos.Puede habilitar o deshabilitar la creación de versiones en la plantilla del sitio Windows SharePoint Services o después de la creación del proyecto.

En la tabla siguiente se describen los atributos del elemento documentLibrary.

Atributo	Descripción
name	Especifica el nombre de la biblioteca de documentos que aparece en el portal del proyecto.
description	Ofrece una descripción de la biblioteca de documentos que aparece en el portal del proyecto.
isProcessGuidance	Especifica si la biblioteca de documentos se utiliza para admitir el contenido de la guía de procesos.

En el ejemplo siguiente se muestra cómo crear una biblioteca de documentos denominada Development que el equipo de desarrollo puede utilizar para almacenar documentos.

<documentLibraries>
. . .
   <documentLibrary name="Process Guidance" description="How to make best use of the Team Foundation Server tools and process" isProcessGuidance="true" />
. . .
</documentLibraries>

Volver al principio

Crear la estructura de carpetas de una biblioteca de documentos

Una vez creado el portal del proyecto, puede especificar la creación de carpetas adicionales.También puede especificar qué archivos copiar como archivos de plantilla.

Utilice el elemento folder para crear una nueva carpeta.

<folders>
   <folder documentLibrary="" name=""/>
</folders>

En la tabla siguiente se describen los atributos del elemento folder.

Atributo	Descripción
documentLibrary	Identifica la biblioteca de documentos en la que crear la carpeta.
name	Especifica el nombre de la carpeta.

En el ejemplo siguiente se muestra cómo crear una carpeta denominada Trip Reports en la biblioteca de documentos Development, en la que los desarrolladores pueden almacenar informes de viajes o de visitas de clientes.

<folders>
   <folder documentLibrary="Development"
           name="Trip Reports"/>
</folders>

Volver al principio

Especificar los archivos que se cargan en las bibliotecas de documentos

También debe copiar archivos en las carpetas y bibliotecas de documentos.Los archivos de código fuente se encuentran bajo la carpeta Windows SharePoint Services.Debe especificar un destino en el portal del proyecto.

<files>
   <file source="" documentLibrary="" target="" queryId="" /> 
</files>

En la tabla siguiente se describen los atributos del elemento file.

Atributo	Descripción
source	Ruta de acceso relativa a la copia local del archivo.Generalmente, el nombre de la ruta de acceso de origen empieza siempre con Windows SharePoint Services, que es el nombre de la carpeta donde se define el complemento de portal.
documentLibrary	Nombre de la biblioteca de documentos en la que se copiará el archivo.
destino	Ruta de acceso relativa al destino en el portal del proyecto donde se copia el archivo.
queryId	Especifica el nombre de una consulta del elemento de trabajo que se enlaza al archivo.Cuando se abre el archivo por primera vez, se rellena con los resultados obtenidos al ejecutar la consulta.Este atributo es opcional y la consulta especificada debe existir en el archivo workitems.xml. Nota queryId sólo se aplica a archivos .xls.

En el ejemplo siguiente se muestra cómo copiar un archivo de plantilla denominado Project Checklist en la carpeta Project Management.En el ejemplo también se especifica que, cuando se abre el archivo por primera vez, debería rellenarse con los resultados de la consulta del elemento de trabajo Project Checklist.

<files>
   <file source="Windows SharePoint Services\Templates\Project Checklist.xls" 
      documentLibrary="Project Management" 
      target="Project Checklist.xls" 
      queryId="Project Checklist" />
</files>

[!NOTA]

Si se incluyen las carpetas y archivos como parte de la plantilla del sitio, no es necesario enumerarlos en el XML.

[!NOTA]

Si especifica archivos .exe y el sitio de SharePoint no admite este tipo de archivos, no podrá crear correctamente un proyecto de equipo usando la plantilla de proceso.

Contenido y archivos auxiliares de la guía de procesos

La guía de procesos es un contenido que documenta los procesos que deben seguir los miembros del equipo que trabajan en un proyecto de software.Los elementos de trabajo, los informes y las consultas del proyecto de equipo pueden cambiar durante el ciclo de vida de éste, y ser diferentes en los distintos proyectos.El contenido de la guía de procesos proporciona información detallada sobre un proyecto de equipo, como información sobre cómo rellenar los campos de los elementos de trabajo, ejemplos de informes positivos y negativos, y descripciones de las consultas.También proporciona información detallada sobre el proceso que se debe seguir en un proyecto de equipo, como los roles que se deben desempeñar y las actividades que se deben completar.

De MSDN Library, puede tener acceso al contenido de la guía de procesos para la mayoría de los artefactos definidas por cada una de las plantillas de proceso predeterminadas que Team Foundation Server proporciona.Puede examinar el contenido en MSDN desde uno de los temas siguientes: Scrum 2,0 de Visual Studio, MSF for Agile 6,0, y MSF for CMMI 6,0.

Para admitir el acceso a la guía de procesos de los formularios de elemento de trabajo en Team Explorer, un conjunto de archivos de .htm se carga en la carpeta de la guía de procesos dentro de la biblioteca de SharePoint de los documentos.Estos archivos especifican direcciones URL al contenido de MSDN que se abre cuando un miembro del equipo elige el icono Abrir guía de procesos para elemento de trabajo de la guía de procesos dentro de un formulario de elemento de trabajo.Estos archivos se cargan en función de las tareas de file definidas en el complemento de portal.Por ejemplo, la plantilla de procesos de Agile define las tareas siguientes para file:

<!-- Process Guidance -->
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="ProcessGuidance.html" />
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="ProcessGuidance.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\AboutWorkItems.htm" documentLibrary="Process Guidance" target="Supporting Files/AboutWorkItems.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\AboutWorkItems.htm" documentLibrary="Process Guidance" target="Supporting Files/AboutWorkItems.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Bug.htm" documentLibrary="Process Guidance" target="Supporting Files/Bug.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Bug.htm" documentLibrary="Process Guidance" target="Supporting Files/Bug.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Issue.htm" documentLibrary="Process Guidance" target="Supporting Files/Issue.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Issue.htm" documentLibrary="Process Guidance" target="Supporting Files/Issue.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="Supporting Files/ProcessGuidance.htm" />
          <file source="Windows SharePoint Services\Process Guidance\ProcessGuidance.html" documentLibrary="Process Guidance" target="Supporting Files/ProcessGuidance.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\SharedSteps.htm" documentLibrary="Process Guidance" target="Supporting Files/Shared Steps.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\SharedSteps.htm" documentLibrary="Process Guidance" target="Supporting Files/Shared Steps.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Task.htm" documentLibrary="Process Guidance" target="Supporting Files/Task.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\Task.htm" documentLibrary="Process Guidance" target="Supporting Files/Task.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\TestCase.htm" documentLibrary="Process Guidance" target="Supporting Files/Test Case.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\TestCase.htm" documentLibrary="Process Guidance" target="Supporting Files/Test Case.aspx" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\UserStory.htm" documentLibrary="Process Guidance" target="Supporting Files/User Story.htm" />
          <file source="Windows SharePoint Services\Process Guidance\Supporting Files\UserStory.htm" documentLibrary="Process Guidance" target="Supporting Files/User Story.aspx" />

Puede personalizar estos archivos de modo que señalen a otros recursos de la guía de procesos.También puede agregar archivos que admitan el acceso a otra guía de procesos creada para el equipo.Para obtener más información, vea Configurar un portal de proyecto o una guía de procesos.

Volver al principio

Activar las características de panel

Los paneles muestran los datos del proyecto, admiten la investigación y ayudan a los equipos a realizar con rapidez las tareas comunes.Los paneles muestran varios informes de Excel y elementos web de Team Web Access.

Puede utilizar el elemento activateFeatures para activar la creación de los paneles y los informes de Excel.Debe incluir el código siguiente en el archivo de complemento de portal, dentro del elemento Portal, para activar la creación de los paneles y los informes de Excel para un proyecto de equipo.

Para activar las características de panel que están diseñadas para su uso con la plantilla de proceso de MSF para el desarrollo de software ágil:

      <Portal>
    . . . 
        <activateFeatures>
          <!-- TfsDashboardAgileMoss -->
          <feature featureId="0D953EE4-B77D-485b-A43C-F5FBB9367207" />
          <!-- TfsDashboardAgileQuickLaunch -->
          <feature featureId="1D363A6D-D9BA-4498-AD1A-9874ACA5F827" />
        </activateFeatures>
    . . . 
      </Portal>

Para activar las características de panel que están diseñadas para su uso con la plantilla de proceso de MSF para CMMI:

      <Portal>
    . . . 
<activateFeatures>
          <!-- TfsDashboardCmmiMoss -->
          <feature featureId="3D0BA288-BF8E-47F0-9680-7556EDEF6318" />
          <!-- TfsDashboardCmmiProcessDocLibraries -->
          <feature featureId="8610B95B-063F-4FB5-837C-BCF2FE9423C6" />
        </activateFeatures>
    . . . 
      </Portal>

Volver al principio