Compartir a través de


Exportación de un informe paginado a un archivo XML (Generador de informes)

Se aplica a: Generador de informes de Microsoft (SSRS) Power BI Report Builder Diseñador de informes en SQL Server Data Tools

La extensión de representación en XML devuelve un informe paginado en formato XML. El esquema XML del informe es específico de éste y solamente contiene datos. La extensión de representación en XML no representa la información de diseño ni mantiene la paginación. El XML que genera esta extensión se puede importar a una base de datos, se puede usar como mensaje de datos XML o se puede enviar a una aplicación personalizada.

Nota

Puede crear y modificar los archivos de definición de informes paginados (.rdl) en el Generador de informes de Microsoft, en Power BI Report Builder y en el Diseñador de informes de SQL Server Data Tools.

Elementos de informe

En la tabla siguiente se describe cómo se representan los elementos de informe.

Elemento Comportamiento de la representación
Informe Se representa como el elemento de nivel superior del documento XML.
Regiones de datos Se representa como un elemento dentro del elemento de su contenedor. Entre las regiones de datos se incluyen la tabla, la matriz y la lista que muestran los datos en forma de texto y de gráficos, las barras de datos, los minigráficos, los medidores y los indicadores que visualizan los datos.
Secciones de grupo y de detalles Cada instancia se representa como un elemento dentro del elemento de su contenedor.
Cuadro de texto Se representa como un atributo o elemento dentro de su contenedor.
Rectángulo Se representa como un elemento dentro de su contenedor.
Grupos de columnas de matriz Se representan como elementos dentro de grupos de filas.
Asignación Se representa como un elemento dentro del elemento de su contenedor. Las capas de mapa son elementos secundarios del mapa. Cada capa de mapa incluye los elementos y los atributos de los miembros del mapa.
Gráfico Se representa como un elemento dentro del elemento de su contenedor. Las series son elementos secundarios del gráfico y las categorías son los elementos secundarios de una serie. Representa todas las etiquetas de gráfico de cada valor de gráfico. Las etiquetas y los valores se incluyen como atributos.
Barra de datos Se representan como un elemento dentro del elemento de su contenedor, de forma similar a un gráfico. Normalmente, una barra de datos no incluye jerarquías o etiquetas, solo valores.
Minigráfico Se representan como un elemento dentro del elemento de su contenedor, de forma similar a un gráfico. Normalmente, un minigráfico no incluye jerarquías ni etiquetas, solo valores.
Indicador Se representa como un elemento dentro del elemento de su contenedor. Se representa como un único elemento con los valores máximo y mínimo de la escala, los valores inicial y final del intervalo, y el valor del puntero como atributos.
Indicador Se representa como un elemento dentro del elemento de su contenedor, de forma similar a un medidor. Se representa como un único elemento con el nombre del estado activo, los estados disponibles y el valor de los datos como atributos.

Los informes que se representan con la extensión de representación en XML también siguen estas reglas:

  • Los elementos y atributos XML se representan en el orden en que aparecen en la definición de informe.

  • No se tiene en cuenta la paginación.

  • No se representan los encabezados ni los pies de página.

  • No se representan los elementos ocultos que no se pueden mostrar mediante alternancia. Inicialmente, se representan los elementos visibles y los elementos ocultos que se pueden mostrar mediante un control de alternancia.

  • Se omitenImages, lines, and custom report items .

Tipos de datos

Al elemento o atributo del cuadro de texto se le asigna un tipo de datos XSD según los valores que muestra el cuadro de texto.

Si todos los valores del cuadro de texto son El tipo de datos asignado es
Int16, Int32, Int64, UInt16, UInt32, UInt64, Byte, SByte xsd:integer
Decimal (o Decimal y cualquier tipo de datos integer o byte) xsd:decimal
Float (o Decimal y cualquier tipo de datos integer o byte) xsd:float
Double (o Decimal y cualquier tipo de datos integer o byte) xsd:double
DateTime o DateTime Offset xsd:dateTime
Time xsd:string
Boolean xsd:boolean
String, Char xsd:string
Otros xsd:string

Reglas de representación específicas de XML

En las secciones siguientes se describe cómo interpretan los elementos del informe las extensiones de representación en XML.

Cuerpo del informe

Un informe se representa como el elemento raíz del documento XML. El nombre del elemento procede del conjunto de propiedades DataElementName del panel Propiedades.

Las definiciones del espacio de nombres y los atributos de referencia del esquema XML también se incluyen en el elemento de informe. Las variables se indican en <>:

<<Report> xmlns="<SchemaName>" xmlns:xsi="<http://www.w3.org/2001/XMLSchema-instance>" xsi:<schemaLocation>="<SchemaNameReportURL>&amp;rc%3aSchema=true" Name="ReportName">

Los valores de las variables son los siguientes:

Nombre Value
Informe Report.DataElementName
ReportURL Dirección URL absoluta con codificación URL al informe en el servidor.
SchemaName Report.SchemaName. Si es null, Report.Name. Si se usa Report.Name, el valor se codifica primero con XmlConvert.EncodeLocalName.
ReportName Nombre del informe.

Cuadros de texto

Los cuadros de texto se representan como elementos o atributos según la propiedad RDL DataElementStyle. El nombre del elemento o atributo procede de la propiedad RDL TextBox.DataElementName.

Gráficos, barras de datos y minigráficos

Los gráficos, las barras de datos y los minigráficos se representan en XML. Los datos son estructurados.

Medidores e indicadores

Los medidores y los indicadores se representan en XML. Los datos son estructurados.

Subinformes

Los subinformes se representan como elementos. El nombre del elemento se toma de la propiedad RDL DataElementName. El valor de la propiedad TextBoxesAsElements del informe invalida el valor correspondiente del subinforme. Los atributos de espacio de nombres y XSLT no se agregan al elemento de subinforme.

Rectángulos

Los rectángulos se representan como elementos. El nombre del elemento se toma de la propiedad RDL DataElementName.

Elementos de informes personalizados

Los CustomReportItems (CRI) no son visibles para la extensión de representación. Si existe algún elemento de informe personalizado en el informe, la extensión de representación lo representa como un elemento de informe convencional.

Imágenes

Las imágenes no se representan.

Líneas

Las líneas no se representan.

Tablas, matrices y listas

Las tablas, matrices y listas se representan como un elemento. El nombre del elemento procede de la propiedad RDL DataElementName de Tablix.

En filas y columnas

Las columnas se representan dentro de las filas.

Esquina de Tablix

La esquina no se representa. Solo se representa el contenido de la esquina.

Celdas de Tablix

Las celdas de Tablix se representan como elementos. El nombre del elemento se toma de la propiedad RDL DataElementName de la celda.

Subtotales automáticos

Los subtotales automáticos de Tablix no se representan.

Elementos de fila y de columna que no se repiten con un grupo

Los elementos que no repiten con un grupo, como las etiquetas, los subtotales y los totales, se representan como elementos. El nombre del elemento procede de la propiedad RDL TablixMember.DataElementName.

La propiedad RDL TablixMember.DataElementOutput controla si se representa un elemento no repetitivo.

Si no se proporciona la propiedad DataElementName del miembro de Tablix, se genera dinámicamente un nombre para el elemento no repetitivo en este formato:

FilaX: para las filas que no se repiten, donde X es un índice de fila de base cero dentro del elemento primario actual.

ColumnaY: para las columnas que no se repiten, donde Y es un índice de columna de base cero dentro del elemento primario actual.

Un encabezado no repetitivo se representa como un elemento secundario de la fila o la columna que no se repite dentro de un grupo.

Si un miembro no repetitivo no tiene ninguna celda de Tablix correspondiente, no se representa. Este resultado puede ocurrir en el caso de una celda de Tablix que abarca más de una columna.

Filas y columnas que se repiten dentro de un grupo

Las filas y las columnas que se repiten dentro de un grupo se representan según las reglas Tablix.DataElementOutput. El nombre del elemento se toma de la propiedad DataElementName.

Cada valor único dentro de un grupo se representa como un elemento secundario del grupo. El nombre del elemento se toma de la propiedad Group.DataElementName.

Si el valor de la propiedad DataElementOutput es igual al de la salida, el encabezado de un elemento repetitivo se representa como un elemento secundario del elemento de detalle.

Formatos personalizados y transformaciones XSL

Los archivos XML generados por la extensión de representación en XML se pueden transformar prácticamente a cualquier formato mediante las transformaciones XSL (XSLT). Esta funcionalidad se puede usar para generar datos en formatos todavía no admitidos por las extensiones de representación existentes. Se recomienda utilizar la extensión de representación en XML y XSLT antes de intentar crear una extensión de representación propia.

Duplicar nombres

Si hay nombres de elementos de datos duplicados dentro del mismo ámbito, el representador muestra un mensaje de error.

transformaciones XSLT

El representador de XML puede aplicar una transformación XSLT en el servidor a los datos XML originales. Cuando se aplica una XSLT, el representador genera el contenido transformado en lugar de los datos XML originales. La transformación se produce en el servidor, no en el cliente.

La transformación XSLT que se debe aplicar a la salida se define en el archivo de definición de informe con la propiedad DataTransform del informe. O como alternativa, se puede especificar con el parámetro DeviceInfo XSLT.

Si se establece cualquiera de estos valores, la transformación se produce cada vez que se usa el representador de XML. Cuando use suscripciones, la transformación XSLT se debe definir en la propiedad RDL DataTransform.

Si se especifica un archivo XSLT, tanto con la propiedad de definición DataTransform como con la configuración de la información del dispositivo, primero se produce la transformación XSLT especificada en DataTransform y después la establecida mediante la configuración de la información del dispositivo.

Configuración de la información del dispositivo

Puede cambiar parte de la configuración predeterminada de este representador cambiando valores de configuración de la información del dispositivo como la siguiente configuración:

  • La transformación (XSLT) que se aplicará al XML.

  • El tipo MIME del documento XML.

  • Si se van a aplicar cadenas de formato a los datos.

  • Si se va a aplicar sangría a los resultados XML.

  • Si se va a incluir el nombre del esquema XML.

  • La codificación del documento XML.

  • La extensión de archivo del documento XML.

Para obtener más información, vea Configuración de la información del dispositivo XML.