Complemento de plantilla de procesos de informes

Actualización: noviembre 2007

El complemento Informes define los informes iniciales de un proyecto de equipo. El nombre del complemento es Microsoft.ProjectCreationWizard.Reporting. El archivo XML de Informes se denomina ReportsTasks.xml y se encuentra en la carpeta Informes 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. Para obtener un ejemplo de tareas que especifican informes simples, vea el archivo ReportsTasks.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.

Sitio de Informes

Para que los informes se ejecuten correctamente, debe crear un sitio de informes. El sitio de informes contendrá un vínculo al informe en la página principal del portal de proyecto denominado Informes. Para crear este sitio, utilice el elemento site mostrado en el ejemplo siguiente.

<task 
   id="Site"
   plugin="Microsoft.ProjectCreationWizard.Reporting"
   completionMessage="Project Reporting site created.">
   <dependencies/>
   <taskXml>
      <ReportingServices>
         <site />
      </ReportingServices>
   </taskXml>
</task>

Carpetas

Puede crear las carpetas en el sitio de informes utilizando el elemento folder. Utilice el atributo path para especificar el nombre de ruta de acceso relativa de la nueva carpeta. La carpeta aparece en el sitio del proyecto y en la carpeta Informes de Team Explorer.

<folder path=""/>

El ejemplo siguiente crea una carpeta pública en el sitio de informes.

   <task id="Populate Reports"
          plugin="Microsoft.ProjectCreationWizard.Reporting"
          completionMessage="Project site created.">
        <dependencies>
            <dependency taskId="Site"/>
        </dependencies>
        <taskXml>
            <ReportingServices>
         <folders>
            <folder path="Public"/>
         </folders>
      </ReportingServices>
   </taskXml>
</task>

Informes

Los informes se definen con archivos .rdl. Para agregar informes al sitio de informes, copie los archivos .rdl en una carpeta bajo la carpeta Informes de la plantilla de procesos. A continuación, utilice el elemento report para describir las propiedades y los orígenes de datos necesarios para el informe.

<report name=""
        filename=""
        folder=""
        cacheExpiration ="30">

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

Atributo	Descripción
name	Nombre del informe que se muestra en el sitio de informes y en Team Explorer.
filename	Ruta de acceso relativa bajo la carpeta Informes local desde donde se obtiene el archivo de informes .rdl.
folder	Nombre de ruta de acceso relativa desde la que agregar el informe en el sitio de informes.
cacheExpiration	Establece el número predeterminado de minutos de almacenamiento del informe en la memoria caché.

Puede especificar valores para los parámetros en un informe. Se suele utilizar para asignar el parámetro Project al proyecto de equipo actual. La mayoría de los informes no se ejecutarán correctamente sin una referencia al proyecto de equipo. Para asignar el parámetro Project al proyecto de equipo, especifique el valor como $$PROJECTNAME$$.

<parameters>
   <parameter name="" value=""/>
</parameters>

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

Atributo	Descripción
name	Nombre del parámetro del informe que se va a enlazar.
value	Valor con el que se va a enlazar el parámetro.

Debe asignar cada nombre de origen de datos de cada informe a un origen de datos de Team Foundation Server activo. Utilice el elemento reference para especificar un origen de datos.

<datasources>
   <reference name="" dsname=""/> 
</datasources>

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

Atributo	Descripción
name	Nombre del origen de datos en el informe.
dsname	Nombre del origen de datos de Team Foundation Server. Normalmente este valor es TfsReportDS o TfsOlapReportDS.

En el ejemplo siguiente se muestra cómo agregar un informe de elementos de trabajo. El parámetro Project se enlazará con el proyecto de equipo y el informe se enlazará con el origen de datos de TfsReportDS.

<report name="Work Items" 
        filename="Reports\Work Items.rdl" 
        folder="" 
        cacheExpiration ="30">
   <parameters>
      <parameter name="Project" value="$$PROJECTNAME$$"/>
   </parameters>
   <datasources>
      <reference name="/TfsOlapReportDS" dsname="TfsOlapReportDS"/> 
      <reference name="/TfsReportDS" dsname="TfsReportDS"/>
   </datasources>
</report>

Vea también

Tareas

Cómo: Comprobar cambios en los informes

Conceptos

Complemento de plantilla de procesos de Windows SharePoint Services

Complemento de plantilla de procesos de control de versiones

Complemento de plantilla de procesos de permisos y grupos

Otros recursos

Complemento de plantilla de procesos de seguimiento de elementos de trabajo.