Agregar informes a la plantilla de procesos

Mediante el complemento de informes, puede especificar la estructura de las carpetas y el conjunto de informes que aparecen bajo el nodo Reports en un nuevo proyecto de equipo.

Importante
El complemento de informe requiere que la colección de proyectos de equipo en la que crea un proyecto de equipo esté configurada con SQL Server Analysis Services y SQL Server Reporting Services. Para obtener más información, vea Agregar un servidor de informes a una colección de proyectos de equipo.

Se especifican dos tareas principales mediante el complemento de informes. Primero, se crea el sitio de informes mediante el elemento site. En segundo lugar, se especifica la estructura de carpetas y los informes que se van a cargar en el sitio utilizando los elementos folder y report. Los informes que carga tienen una extensión .rdl y están diseñados para su uso con  Reporting Services. Para obtener información general sobre los informes proporcionados por las plantillas de proceso de Microsoft Solutions Framework (MSF), vea Informes (Agile) o Informes (CMMI).

En este tema

• Nombre y ubicación del complemento de informes

• Estructura de la sintaxis del complemento de informes

• Crear el sitio de informes

• Definir carpetas

• Especificar los informes que se van a cargar

• Referencia del elemento ReportingServices

Después de crear un proyecto de equipo a partir de la plantilla de proceso, puede agregar, quitar, cambiar el nombre y modificar la estructura de las carpetas para informes. Para obtener más información, vea Administrar informes.

Nombre y ubicación del complemento de informes

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

En el archivo XML, puede especificar una o más tareas y sus dependencias. Para obtener un ejemplo de una tarea que especifica un conjunto de informes, vea el archivo ReportsTasks.xml en la plantilla de proceso de MSF for Agile Software Development.

Volver al principio

Estructura de la sintaxis del complemento de informes

El archivo del complemento de informe se debe ajustar a la definición de esquema de ReportingServices, que se define en el archivo Rosetta.xsd y se especifica en su propio archivo. Puede descargar los archivos de esquema para las plantillas de proceso de la siguiente página del sitio web de Microsoft: Process Template and Work Item Schemas for Visual Studio Team Foundation.

La sintaxis siguiente muestra la estructura del complemento de informes. Para obtener una descripción de cada elemento, vea Elementos secundarios de ReportingServices, más adelante en este tema.

<?xml version="1.0" encoding="utf-8"?>
<tasks>
  <task id="Site" plugin="Microsoft.ProjectCreationWizard.Reporting" completionMessage="Project Reporting site created.">
    <dependencies />
    <taskXml>
      <ReportingServices>
        <site> </site>
      </ReportingServices>
    </taskXml>
  </task>
  <task id="Populate Reports" plugin="Microsoft.ProjectCreationWizard.Reporting" completionMessage="Project reports uploaded.">
    <dependencies>
      <dependency taskId="Site" />
    </dependencies>
    <taskXml>
      <ReportingServices>
        <folders> . . . </folders>
        <reports> . . . </reports>
      </ReportingServices>
    </taskXml>
  </task>
</tasks>

Volver al principio

Crear el sitio de informes

Para que los informes se ejecuten correctamente, debe crear un sitio de informes. El sitio de informes contendrá un vínculo en la página principal del portal del proyecto, y dicho vínculo se denominará Informes. Para crear el sitio de informes, utilice el elemento site, como se muestra en el ejemplo siguiente:

<taskXml>
   <ReportingServices>
        <site></site>
   </ReportingServices>
</taskXml>

Volver al principio

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

En el ejemplo siguiente se crean cuatro carpetas de nivel superior y dos subcarpetas en el sitio de informes. Las carpetas del nivel superior se denominan Bugs, Builds, Project Management y Tests. Las dos subcarpetas se encuentran bajo Project Management y están etiquetadas como Visual Studio y Visual Studio ALM.

<taskXml>
   <ReportingServices>
      <folders>
         <folder path="Bugs" />
          <folder path="Builds" />
          <folder path="Project Management" />
          <folder path="Project Management/Visual Studio" />
          <folder path="Project Management/Visual Studio ALM" />
          <folder path="Tests" />
      </folders>
   </ReportingServices>
</taskXml>

Volver al principio

Especificar los informes que se van a cargar

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.

En el ejemplo siguiente se especifica que el archivo Remaining Work.rdl se carga en la carpeta Project Management. Debe especificar el parámetro ExplicitProject y los orígenes de datos para cada informe. Los orígenes de datos en el ejemplo siguiente se corresponden con los nombres que se asignan automáticamente a la base de datos relacional del cubo de Analysis Services y del almacén de datos de Team Foundation Server 2010. Para obtener más información, vea Encontrar informes después de actualizar a Team Foundation Server 2010.

<taskXml>
   <ReportingServices>
     <reports>
        <report name="Remaining Work" filename="Reports\Remaining Work.rdl" folder="Project Management" cacheExpiration="30">
       <parameters>
          <parameter name="ExplicitProject" value="" />
       </parameters>
       <datasources>
          <reference name="/Tfs2010OlapReportDS" dsname="TfsOlapReportDS" />
          <reference name="/Tfs2010ReportDS" dsname="TfsReportDS" />
       </datasources>
    </report>
 . . . 
     </reports>
   </ReportingServices>
</taskXml>

Volver al principio

Referencia del elemento ReportingServices

En la sintaxis siguiente se muestra la estructura del elemento ReportingServices y sus elementos secundarios. Se especifican estos elementos dentro del elemento contenedor taskXml y solo para el complemento de informes.

<ReportingServices>
   <folders>
      <folder />
 . . . 
   </folders>
   <reports>
      <report>
         <parameters>
            <parameter />
         </parameters>
         <datasources>
            <reference />
         </datasources>
      </report>
 . . . 
   </reports>
</ReportingServices>

En la tabla siguiente se describen los elementos que se usan para especificar un informe que se va a cargar en un proyecto de equipo y al que se tiene acceso a través de SQL Server Reporting Services.

<datasources>
   <reference />
</datasources>

<folder path="FolderName" />

<folders>
   <folder path="FolderName" />
</folders>

<parameter name="ParameterName" value="ParameterValue" />

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

<parameters>
   <parameter />
</parameters>

< properties >
   < property />
</ properties >

<property name="PropertyName" value="PropertyValue" />

<reference name="RelationalDBName" dsname="OLAPDBName" />

<report name="ReportName" filename="ReportFilePathName" 
folder="FolderName" cacheExpiration="CacheDuration">   <folders>
   <parameters>. . .</parameters>
   <datasources>. . .</datasources>
   <properties>. . .</properties >
</report>

<reports>
   <report />
   . . .
</reports>

<ReportingServices>
   <folders>. . .</folders>
   <reports>. . .</reports>
</ReportingServices>

<site> </site>

Volver al principio

Vea también

Tareas

Comprobar cambios en los informes

Conceptos

Proceso de personalización paso a paso

Trabajar con archivos de plantilla de proceso

Personalizar las áreas funcionales en una plantilla de proceso

Otros recursos

Personalizar plantillas de procesos

Historial de cambios