Atributos y elementos del lenguaje RDL en XML (Generador de informes 1.0)
Cuando se guarda un informe como un archivo XML, el Generador de informes necesita convertir el lenguaje RDL (Report Definition Language) a XML. La opción de exportación a XML guarda los elementos del informe como elementos o atributos en un documento XML. Cada elemento puede tener un conjunto de atributos o subelementos asociados al mismo. Los atributos o elementos varían en función del elemento de informe. En este tema se describe cómo se modifica el esquema RDL cuando se guarda como XML.
Informe
Report es el nodo raíz XML. Contiene atributos que especifican la información de esquema del documento XML y el nombre del informe.
El esquema XML (XSD) se especifica en el nodo raíz XML de la manera siguiente:
<Report xmlns="SchemaName" xmlns:sxi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="SchemaName ReportURL&rs:ImageID=SchemaName" Name="ReportName">
En la tabla siguiente se describe el modo en que la opción de exportación a XML guarda los atributos y los elementos del elemento RDL Report.
Atributo RDL |
Guardado como |
|---|---|
Name |
El atributo Name del elemento raíz. |
Cuadros de texto
En la siguiente tabla se describe cómo se guardan los cuadros de texto mediante la opción de exportación a XML. El nombre y el valor del cuadro de texto se guardan como un elemento o como un atributo, dependiendo del valor del elemento RDL DataElementStyle del cuadro de texto.
Elemento RDL |
Guardado como |
|---|---|
DataElementName |
El nombre del elemento o atributo del cuadro de texto. Si no se especifica DataElementName, el nombre predeterminado es el nombre del cuadro de texto en el lenguaje RDL. |
Value |
El valor de los datos del cuadro de texto. |
Tabla
En la siguiente tabla se describe cómo se guardan las tablas mediante la opción de exportación a XML. La tabla se guarda como un elemento.
Elemento RDL |
Guardado como |
|---|---|
DataElementName |
El nombre del elemento de tabla. Si no se especifica DataElementName, el nombre del elemento es el nombre de la tabla en el lenguaje RDL. |
TableGroup |
El primer elemento TableGroup se guarda como un subelemento del elemento de tabla. Cada elemento TableGroup posterior se guarda como un subelemento de la instancia de grupo del elemento TableGroup anterior. Así se obtienen grupos anidados de datos. |
Details |
Un subelemento de cada instancia de grupo del último elemento TableGroup. Si no hay grupos de tablas, Details se guarda como un subelemento del elemento de tabla. |
Grupo de tablas
En la siguiente tabla se describe cómo se guardan los grupos de tablas mediante la opción de exportación a XML. Los grupos de tablas se guardan como elementos.
Elemento RDL |
Guardado como |
|---|---|
DataCollectionName (Grouping) |
El nombre del elemento de grupo de tablas. Si no se especifica DataCollectionName, el nombre del elemento es el nombre especificado en el elemento DataElementName más la cadena "_Collection". |
DataElementName (Grouping) |
El nombre del elemento de instancia de grupo. Los elementos de instancia de grupo son subelementos del elemento de grupo de tablas. Si no se especifica DataElementName, el nombre del elemento es el nombre de la agrupación en el lenguaje RDL. |
Header |
Todos los elementos del encabezado se guardan como subelementos o atributos del elemento de instancia de grupo. |
Detalles
En la tabla siguiente se describe el modo en que la opción de exportación a XML guarda los atributos y los elementos del elemento RDL Details. Details se guarda como un elemento.
Elemento RDL |
Guardado como |
|---|---|
DataCollectionName (Grouping) |
El nombre del elemento de detalles. Si no se especifica DataCollectionName, el nombre del elemento es el nombre especificado en el elemento DataElementName más la cadena "_Collection". Si Details no tiene agrupación, el nombre del elemento es Detail_Collection. |
DataElementName (Grouping) |
El nombre del elemento de instancia de grupo. Los elementos de instancia de grupo son subelementos del elemento de detalles. Si no se especifica DataElementName, el nombre del elemento es el nombre de la agrupación en el lenguaje RDL. Si Details no tiene agrupación, el nombre del elemento es Detail. |
DetailsRows |
Todos los elementos de las filas de detalle se guardan como subelementos o atributos del elemento de instancia de grupo. |
Matriz
En la siguiente tabla se describe cómo se guardan las matrices mediante la opción de exportación a XML. La matriz se guarda como un elemento.
Elemento RDL |
Guardado como |
|---|---|
DataElementName |
El nombre del elemento de matriz. Si no se especifica DataElementName, el nombre del elemento es el nombre de la matriz en el lenguaje RDL. |
Corner |
Todos los elementos de la esquina se guardan como subelementos o atributos del elemento de matriz. |
RowGrouping |
El primer elemento RowGrouping se guarda como un subelemento del elemento de matriz. Cada elemento RowGrouping posterior se guarda como un subelemento de la instancia de grupo del elemento RowGrouping anterior. Así se obtienen grupos anidados de datos. |
ColumnGrouping |
El primer elemento ColumnGrouping se guarda como un subelemento de cada instancia de grupo del último elemento RowGrouping. Cada elemento ColumnGrouping posterior se guarda como un subelemento de la instancia de grupo del elemento ColumnGrouping anterior. |
MatrixCell |
El subelemento Cell de cada instancia de grupo del último elemento ColumnGrouping. Todos los elementos de la celda de la matriz se guardan como subelementos o atributos del elemento Cell. |
Agrupación de filas
En la siguiente tabla se describe cómo se guardan las agrupaciones de filas mediante la opción de exportación a XML. Una agrupación de filas se guarda como un elemento.
Elemento RDL |
Guardado como |
|---|---|
DataCollectionName (Grouping) |
El nombre del elemento de agrupación de filas. Si no se especifica DataCollectionName, el nombre del elemento es el nombre especificado en el elemento DataElementName más la cadena "_Collection". No es así en el caso de las agrupaciones de filas estáticas. |
DataElementName (Grouping) |
El nombre del elemento de instancia de grupo. Los elementos de instancia de grupo son subelementos del elemento de agrupación de filas Si no se especifica DataElementName, el nombre del elemento es el nombre de la agrupación en el lenguaje RDL. En el caso de las agrupaciones de filas estáticas, el nombre del elemento es el valor de DataElementName del cuadro de texto del encabezado de grupo. Si no hay ningún cuadro de texto para un encabezado de fila estática, el nombre del elemento es RowN, donde N es un número asignado a la agrupación de filas. |
ReportItems |
Todos los elementos de la agrupación de filas se guardan como subelementos o atributos del elemento principal del elemento de agrupación de filas. |
Subtotal |
Un elemento relacionado con el elemento de agrupación de filas. Este elemento contiene una celda de matriz. El nombre de este elemento es el nombre especificado en el elemento DataElementName del subtotal. Si no se especifica ningún nombre, el nombre del elemento es Total. |
[!NOTA]
De manera predeterminada, los subtotales no se guardan. La opción de exportación a XML guarda los subtotales sólo si el valor del elemento RDL DataElementOutput del subtotal es Output.
Agrupación de columnas
En la siguiente tabla se describe cómo se guardan las agrupaciones de columnas mediante la opción de exportación a XML. Una agrupación de columnas se guarda como un elemento.
Elemento RDL |
Guardado como |
|---|---|
DataCollectionName (Grouping) |
El nombre del elemento de agrupación de columnas. Si no se especifica DataCollectionName, el nombre del elemento es el nombre especificado en el elemento DataElementName más la cadena "_Collection". No es así en el caso de las agrupaciones de columnas estáticas. |
DataElementName (Grouping) |
El nombre del elemento de instancia de grupo. Los elementos de instancia de grupo son subelementos del elemento de agrupación de columnas Si no se especifica DataElementName, el nombre del elemento es el nombre de la agrupación en el lenguaje RDL. En el caso de las agrupaciones de columnas estáticas, el nombre del elemento es el valor de DataElementName del cuadro de texto del encabezado de grupo. Si no hay ningún cuadro de texto para un encabezado de columna estática, el nombre del elemento es ColumnN, donde N es un número asignado a la agrupación de columnas. |
ReportItems |
Todos los elementos de la agrupación de columnas se guardan como subelementos o atributos del elemento principal del elemento de agrupación de columnas. |
Subtotal |
Como un elemento relacionado con el elemento de agrupación de columnas. Este elemento contiene una celda de matriz. El nombre de este elemento es el nombre especificado en el elemento DataElementName del subtotal. Si no se especifica ningún nombre, el nombre del elemento es Total. |
[!NOTA]
De manera predeterminada, los subtotales no se guardan. La opción de exportación a XML guarda los subtotales sólo si el valor del elemento RDL DataElementOutput del subtotal es Output.
Para comprender mejor la forma en que la opción de exportación a XML guarda los elementos del lenguaje RDL (Report Definition Language) de un informe como un archivo XML, puede obtener más información acerca de los elementos. Para obtener más información acerca de los elementos del lenguaje RDL, vea el tema acerca del lenguaje RDL (Report Definition Language) en los Libros en pantalla de SQL Server.