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

TFS 2017 | TFS 2015 | TFS 2013

Importante

TFS 2018 y versiones posteriores ya no admiten la integración nativa con SharePoint productos. Si planea actualizar a TFS 2018, lea Acerca de la integración SharePoint para obtener información sobre las opciones disponibles.

Al crear un proyecto a partir de Visual Studio Team Explorer, el complemento del portal de proyectos crea un sitio SharePoint y carga varios archivos contenidos en la plantilla de proceso. Estos archivos aparecerán debajo de especifica la estructura de carpetas y el conjunto de informes que aparecerán en el nodo Documentos en Team Explorer.

Mediante el complemento del portal, puede definir las bibliotecas de documentos iniciales, la estructura de bibliotecas y los documentos del portal de un proyecto. También puede incluir las tareas que crean paneles e informes Excel que están diseñados para trabajar con las plantillas de proceso predeterminadas.

Las tareas que especifique en el complemento para SharePoint Products solo se ejecutan cuando se crea un sitio de SharePoint al crear un proyecto. Para obtener más información sobre los requisitos de sitio y la administración, vea SharePoint Products requirements for Team Foundation Server.

Importante

Al crear un proyecto desde el portal web, se omite WssTasks.xml archivo de complemento. Para agregar SharePoint después de crear el proyecto, consulte Configuración o adición de un portal de proyectos.
Los clientes que admiten la creación de proyectos varían en función de la versión de TFS. Para obtener más información, consulte Plantilla de proceso y archivos de complemento, Soporte técnico de cliente para la creación de proyectos.

Nombre y ubicación del complemento de portal

Los nombres del archivo, la carpeta y el complemento para las plantillas de proceso predeterminadas son los siguientes:

Nombre de archivo: WssTasks.xml
Nombre de 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. El sistema no incluye un mecanismo para la implementación de complementos del lado 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 en una de las plantillas de proceso predeterminadas. Puede descargar las plantillas de proceso más recientes.

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 de sitio también debe estar disponible en Team Foundation Server SharePoint portal. 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 de sitio.

Atributo Descripción
template Especifica qué plantilla utilizar. Debe especificar una plantilla definida en el servidor que hospeda SharePoint Products para los proyectos que se van a crear.
Para usar las características que están disponibles con la versión actual de las plantillas de proceso, especifique la cadena siguiente: Team Foundation Server Project Portal .
language 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 plantilla de proceso 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 proceso afecta al tiempo que se tarda en crear un nuevo proyecto. Las plantillas de proceso más grandes tardan más tiempo en crear nuevos proyectos. 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 fuera de la plantilla de proceso y a la plantilla de sitio y mejora el rendimiento al crear nuevos proyectos.

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

Utilizar un sitio web alternativo

Si tiene una gran colección de archivos que se comparten entre varios proyectos, puede usar un sitio web alternativo para hospedar los archivos y vincular a los archivos desde el portal del proyecto o las páginas web. Esta estrategia también aumenta el rendimiento al crear proyectos, ya que no es necesario 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. Use 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.

Use 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.
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 solo se aplica a .xls archivos.

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. Si especifica .exe archivos y el sitio SharePoint no admite archivos .exe, no podrá crear un proyecto correctamente mediante 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 pueden cambiar durante el ciclo de vida de un proyecto y pueden ser diferentes entre proyectos. El contenido de la guía de proceso proporciona detalles sobre un proyecto, como información sobre cómo completar campos de elementos de trabajo, ejemplos de informes correctos e incorrectos y descripciones de las consultas. La guía del proceso también proporciona detalles sobre el proceso que se debe seguir en un proyecto, como los roles que se asumen y las actividades que se deben completar.

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

<!-- 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 Excel y Team Web Access web.

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

Para activar las características del panel diseñadas para su uso con la plantilla de proceso para 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 del panel diseñadas para su uso con la plantilla de proceso para Agile:

<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 del panel diseñadas para su uso con la plantilla de proceso para CMMI:

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