Agregar informes a la plantilla de proceso

Artículo
11/18/2015

Con el complemento de informes, puede especificar la estructura de carpetas y el conjunto de informes que aparecen en el nodo Informe 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 informes a un proyecto 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 que ofrecen las plantillas de proceso de TFS, vea Informes (SQL Server Reporting Services).

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 Ver, cargar y organizar informes (Informes de Reporting Services).

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.

Nombre del archivo:	ReportsTasks.xml
Nombre de la carpeta:	Informes
Nombre del complemento:	Microsoft.ProjectCreationWizard.Reporting

Nota

Puede cambiar los nombres del archivo XML y de la carpeta pero no el del complemento.Visual Studio Team Foundation Server no incluye un 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.

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.

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.

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>

Crear el sitio de informes

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

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

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>

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

Nota

Los nombres de los orígenes de datos de Reporting Services son Tfs2010ReportsDS y Tfs2010OlapReportsDS.Aunque es posible que haya instalado TFS o haya actualizado a la última versión de TFS, estos nombres, que se asignaron a los orígenes de datos para una instalación de TFS 2010, siguen en uso.

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

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.

Elemento	Sintaxis	Descripción
datasources	`<datasources> <reference /> </datasources>`	Elemento secundario necesario de report. Contiene una colección de elementos reference que especifican un origen de datos que el informe utiliza.
folder	`<folder path="FolderName" />`	Elemento secundario necesario de folders. Define el nombre de una carpeta que se crea bajo el nodo Reports para un proyecto de equipo.
folders	`<folders> <folder path="FolderName" /> </folders>`	Elemento secundario opcional de ReportingServices. Contiene una colección de elementos folder, cada uno especifica el nombre de una carpeta que se va a crear.
parameter	`<parameter name="ParameterName" value="ParameterValue" />` Donde cada atributo tiene la siguiente definición: name: nombre de un parámetro que desee especificar. value: valor que se va a asignar al parámetro. Como mínimo, debe definir el parámetro siguiente para que su informe use automáticamente el proyecto que contiene el informe: `<parameter name="ExplicitProject" value="" />`	Elemento secundario necesario de parameters. Especifica el nombre de un parámetro de informe y el valor que se le asigna.
parameters	`<parameters> <parameter /> </parameters>`	Elemento secundario necesario de report. Define una colección de elementos parameter para un informe.
properties	`< properties > < property /> </ properties >`	Elemento secundario opcional de report.
property	`<property name="PropertyName" value="PropertyValue" />` Donde cada atributo tiene la siguiente definición: name: nombre de la propiedad que se desea especificar. Para obtener más información, vea Ver, organizar y configurar informes mediante el Administrador de informes. value: valor que se asigna a la propiedad.	Elemento secundario necesario de properties.
reference	`<reference name="RelationalDBName" dsname="OLAPDBName" />` Donde cada atributo tiene la siguiente definición: name: nombre del origen de datos de Team Foundation Server. En Team Foundation Server 2010, este valor es Tfs2010OlapReportDS para el cubo de Analysis Services o Tfs2010ReportsDS para el almacenamiento de datos relacional. dsname: nombre del recurso de la base de datos. Especifique TfsOlapReportDS para el cubo de Analysis Services y TfsReportsDS para el almacenamiento de datos relacional. Para obtener más información sobre los nombres de orígenes de datos de informes, vea Buscar informes después de la actualización a Team Foundation Server 2010.	Elemento secundario necesario de datasources. Especifica los nombres asignados en Team Foundation Server a la base de datos relacional del almacén de datos y al cubo de Analysis Services.
report	`<report name="ReportName" filename="ReportFilePathName" folder="FolderName" cacheExpiration="CacheDuration"> <folders> <parameters>. . .</parameters> <datasources>. . .</datasources> <properties>. . .</properties > </report>` Donde cada atributo tiene la siguiente definició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 local Reports desde donde se obtiene el archivo de informes .rdl. folder: nombre de ruta de acceso relativa de la ubicación de donde se agrega el informe en el sitio de informes. cacheExpiration: número predeterminado de minutos de almacenamiento del informe en la memoria caché.	Elemento secundario necesario de reports. Especifica el nombre del informe, del archivo que contiene la definición .rdl y de la carpeta en la que el informe está cargado. Team Foundation Server
reports	`<reports> <report /> . . . </reports>`	Elemento secundario necesario de ReportingServices. Contiene una colección de elementos report, cada uno especifica el nombre de un archivo de informes que se va a cargar.
ReportingServices	`<ReportingServices> <folders>. . .</folders> <reports>. . .</reports> </ReportingServices>`	Elemento secundario necesario del elemento taskXml para el complemento de informes. Describe las tareas necesarias para definir los informes y las carpetas de SQL Server Reporting Services.
site	`<site> </site>`	Elemento necesario para el complemento de informes. Especifica que se creará un sitio de informes para el proyecto de equipo.

Vea también

Conceptos

Personalizar un proceso

Información general sobre los archivos de plantillas de procesos

Compartir a través de