Agregar informes a la plantilla de proceso

Artículo
02/19/2013

Mediante el complemento de informes, puede especificar la estructura de las carpetas y el conjunto de informes que aparecen bajo 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 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.

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.

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

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.

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

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 para Visual Studio ALM. 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 los orígenes de datos de informes, vea Locating Reports After the Upgrade to 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.