Complemento de plantilla de procesos de Windows SharePoint Services

Artículo
10/07/2008

Actualización: noviembre 2007

El complemento Windows SharePoint Services define el portal del proyecto para el equipo, basado en una plantilla del sitio SharePoint. El nombre del complemento es Microsoft.ProjectCreationWizard.Portal. El archivo XML de Windows SharePoint Services se denomina WssTasks.xml y se encuentra en la carpeta Windows SharePoint Services de la jerarquía de carpetas de la plantilla de procesos. Puede cambiar el nombre de la carpeta y del archivo XML si es necesario.

En el archivo XML, especifique una o más tareas y sus dependencias. Son tres las tareas clave que se deben definir: qué plantilla del sitio se utilizará, qué bibliotecas de documentos se crearán y qué archivos y carpetas se copiarán en las bibliotecas de documentos. Para obtener un ejemplo de tareas que especifican un portal de proyecto simple, vea el archivo WssTasks.xml en la plantilla de procesos de MSF for Agile Software Development.

Nota:
Team Foundation Server no incluye un mecanismo para la implementación de complementos de cliente, directivas u otras modificaciones. Si desea implementar complementos, directivas u otras modificaciones en Team Explorer, debe utilizar su propio programa de instalación y distribución.

Para obtener más información sobre sitios de Windows SharePoint Services y la administración de Windows SharePoint Services, consulte Windows SharePoint Services Administrator's Guide.

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 SharePoint de Team Foundation Server. 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
template	Especifica qué plantilla utilizar. La plantilla es una combinación del nombre de la plantilla y el identificador de configuración del archivo webtemp.xml del servidor de SharePoint.
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 inglesa es 1033.

En el ejemplo siguiente se muestra cómo hacer referencia a la versión inglesa de la plantilla VSTS_MSFAgile.

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

Nota:
El resto de tareas de Windows SharePoint Services dependen de esta tarea porque el portal del proyecto debe crearse antes de crear las bibliotecas de documentos o de copiar archivos.

Crear plantillas de sitio personalizadas

Puede crear plantillas de sitio SharePoint personalizadas para usarlas con plantillas de procesos. Las plantillas de sitio SharePoint se crean utilizando las características administrativas en el sitio SharePoint. Para obtener más información sobre cómo crear plantillas de sitio SharePoint, vea la Ayuda de Microsoft Windows SharePoint Services 2.0.

Después de crear una plantilla del sitio SharePoint personalizada, debe agregarla al Team Foundation Server donde se utilizará. Primero guarde la plantilla del sitio personalizada en un archivo .stp. Para obtener más información sobre cómo guardar las plantillas del sitio, vea la Ayuda de Microsoft Windows SharePoint Services 2.0.

Para agregar las plantillas del sitio personalizadas utilice el sitio SharePoint o el símbolo del sistema. El procedimiento siguiente explica cómo agregar una plantilla del sitio personalizada a Team Foundation Server.

Para agregar una plantilla del sitio personalizada a Team Foundation Server

En Team Foundation Server, abra una ventana de símbolo del sistema.
En el símbolo del sistema, cambie al directorio \Program Files\Common Files\Microsoft Shared\web server extensions\12\bin.
Escriba el comando siguiente para agregar la plantilla del sitio personalizada a Team Foundation Server.

stsadm -o addtemplate -filename <custom site template filename>.stp -title <site template title>
Escriba iisreset y presione ENTRAR. Se debe reiniciar IIS para que la plantilla del sitio agregada esté disponible.

Una vez que las plantillas del sitio personalizadas están cargadas en Team Foundation Server, las plantillas de procesos pueden utilizarlas para crear proyectos de equipo. El procedimiento siguiente explica cómo modificar el XML de la plantilla de procesos para utilizar una plantilla del sitio personalizada.

Para agregar una plantilla del sitio personalizada a una plantilla de procesos

En Team Foundation Server, abra una ventana de símbolo del sistema.
En el símbolo del sistema, cambie al directorio \Program Files\Common Files\Microsoft Shared\web server extensions\12\bin.
Escriba stsadm -o enumtemplates y presione ENTRAR. Se mostrarán las plantillas del sitio disponibles. Esta información se necesita para construir la plantilla de procesos XML adecuada.

Por ejemplo, si agrega una plantilla del sitio denominada ExCustom verá el resultado siguiente.

ExCustom - Language: 1033 - Site Template: _GLOBAL_#1 - Template Id: 1

Nota:

El identificador de la plantilla puede variar dependiendo de la cantidad de plantillas del sitio que haya en el servidor
En el menú Equipo de Visual Studio, elija Configuración de Team Foundation Server y, a continuación, haga clic en Administrador de plantilla de procesos.
Descargue la plantilla de procesos que desee modificar utilizando el Administrador de plantilla de procesos.

Para obtener más información sobre cómo descargar una plantilla de procesos, vea Cómo: Descargar una plantilla de procesos.
En la plantilla de procesos, abra el archivo WSSTasks.xml.

Busque el elemento site y cambie el atributo de la plantilla para que coincida con el nombre de la plantilla del sitio que obtuvo en el paso 3. En el XML siguiente se muestra un ejemplo del elemento site para la plantilla de ejemplo ExCustom.
```
<site template="_GLOBAL_#1" language="1033"/>
```

Nota:
El identificador de la plantilla puede variar dependiendo de la cantidad de plantillas del sitio que haya en el servidor

Cargue la plantilla de procesos actualizada.

Para obtener más información sobre cómo cargar una plantilla de procesos, vea Cómo: Cargar una plantilla de procesos.

Nota:
Las plantillas de procesos actualizadas no deben contener archivos .exe en ninguna carpeta o se producirá un error al crear el proyecto, aunque la plantilla de procesos actualizada se cargue correctamente.

Ahora puede utilizar el Asistente para nuevo proyecto de equipo para crear nuevos proyectos de equipo a partir de la plantilla de procesos personalizada. Los nuevos proyectos de equipo utilizarán la plantilla del sitio personalizada en el portal del proyecto.

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=""/>
</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
nombre	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.

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="Development" 
      description=" Documents for the development team "/>
</documentLibraries>

Carpetas y archivos

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

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 origen comienza con Windows SharePoint Services.
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 sólo se aplica a archivos .xls y .mpp.

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 Windows SharePoint no los admite, no podrá crear un proyecto de equipo con la plantilla de procesos.

Rendimiento de la plantilla de procesos

Los archivos que especifica en wsstasks.xml se incluyen como parte de la plantilla de procesos 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 Windows 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, enumerar los archivos en wsstasks.xml presenta una ventaja. Puede 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.

Orientación del proceso

El complemento Windows SharePoint Services instala los archivos de orientación del proceso. Todos estos archivos se encuentran en la carpeta Windows SharePoint Services\Process Guidance, y debe especificarse un elemento file para cada archivo como forma de asegurar que se copia en el portal del proyecto. Para obtener más información sobre cómo personalizar la guía de procesos, vea MSF for Agile Software Development, MSF for CMMI Process Improvement y MSF for CMMI Process Improvement.

Vea también

Tareas

Cómo: Comprobar cambios en Windows SharePoint Services

Cómo: Descargar una plantilla de procesos

Cómo: Cargar una plantilla de procesos

Compartir a través de