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

Mediante el complemento de portal, se pueden definir las bibliotecas de documentos, la estructura de bibliotecas y los documentos iniciales 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 Team Foundation Server (TFS).

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. Para obtener más información sobre los requisitos y la administración de un sitio, vea Requisitos de Productos de SharePoint para Team Foundation Server.

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 TFS.

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.TFS no incluye ningún 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.

Tareas y dependencias de creación del 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 de una de las plantilla de proceso de TFS. Puede descargar las plantillas de proceso más recientes de TFS.

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 la cadena siguiente: Team Foundation Server Project Portal.
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 en inglés 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="Team Foundation Server Project Portal" 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 proceso

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 Configurar o agregar un portal de proyecto.

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>

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>

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.
target	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 solo 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 este, 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.

En la biblioteca de MSDN, puede acceder al contenido de la guía de procesos de la mayoría de los artefactos definidos por cada una de las plantillas de proceso predeterminadas de TFS. Puede examinar el contenido disponible en MSDN desde uno de los temas siguientes: Visual Studio Scrum 3.0, MSF for Agile y MSF for CMMI.

Para admitir el acceso a la guía de procesos desde los formularios de elemento de trabajo de Team Explorer, se carga un conjunto de archivos .htm en la carpeta de guía de procesos dentro de la biblioteca de documentos de SharePoint. Estos archivos especifican direcciones URL al contenido de MSDN que se abre cuando un miembro del equipo elige el icono de guía de procesos dentro de un formulario de elemento de trabajo. Estos archivos se cargan en función de las tareas file definidas en el complemento de portal. Por ejemplo, la plantilla de proceso de Agile define las siguientes tareas 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 o agregar un portal de proyecto.

Activar 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 para Visual Studio Scrum:

      <Portal>
    . . . 
<activateFeatures>
         <!-- TfsDashboardScrumWss -->
          <feature featureId="71EC0D67-21AB-4560-A825-9D976DA09D04" />
          <!-- 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 Agile Software Development:

      <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 for CMMI Process Improvement:

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

Vea también

Conceptos

Personalizar un proceso

Información general sobre los archivos de plantillas de procesos