Elementos e atributos RDL em XML (Construtor de Relatórios 1.0)

Quando um relatório é salvo como arquivo XML, o Construtor de Relatórios precisa converter a linguagem RDL em XML. A opção de exportação de XML salva itens de relatório como elementos ou atributos em um documento XML. Cada elemento pode ter um conjunto de atributos ou subelementos associado a ele. Os atributos ou elementos variam conforme o item de relatório. Este tópico discute no que se transforma o esquema RDL quando salvo como XML.

Report

Report é o nó raiz XML. Ele contém atributos que especificam informações de esquema do documento XML e o nome do relatório.

O Esquema XML (XSD) é especificado no nó raiz XML da seguinte maneira:

<Report xmlns="SchemaName" xmlns:sxi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="SchemaName ReportURL&rs:ImageID=SchemaName" Name="ReportName">

A tabela a seguir descreve como os atributos e elementos do elemento Report RDL são salvos pela opção de exportação XML.

Atributo RDL	Salvo como
Name	O atributo Name do elemento raiz.

Caixas de texto

A tabela a seguir descreve como as caixas de texto são salvas pela opção de exportação XML. O nome e o valor da caixa de texto são salvos como elemento ou atributo, dependendo do valor do elemento RDL DataElementStyle relativo à caixa de texto.

Elemento RDL	Salvo como
DataElementName	O nome do elemento ou atributo da caixa de texto. Se DataElementName não for especificado, o nome padrão será o nome da caixa de texto na RDL.
Value	O valor dos dados na caixa de texto.

Tabela

A tabela a seguir descreve como as tabelas são salvas pela opção de exportação XML. A tabela é salva como elemento.

Elemento RDL	Salvo como
DataElementName	O nome do elemento da tabela. Se DataElementName não for especificado, o nome do elemento será o nome da tabela na RDL.
TableGroup	O primeiro elemento TableGroup é salvo como subelemento do elemento da tabela. Cada elemento TableGroup subseqüente é salvo como subelemento da instância de grupo do elemento TableGroup anterior. Isso gera grupos de dados aninhados.
Details	Um subelemento de cada instância de grupo do último elemento TableGroup. Se não houver grupos de tabela, Details será salvo como subelemento do elemento de tabela.

TableGroup

A tabela a seguir descreve como os grupos de tabela são salvos pela opção de exportação XML. Os grupos de tabela são salvos como elementos.

Elemento RDL	Salvo como
DataCollectionName (Grouping)	O nome do elemento do grupo de tabela. Se DataCollectionName não for especificado, o nome do elemento será o nome especificado no elemento DataElementName mais a cadeia de caracteres "_Collection".
DataElementName (Grouping)	O nome do elemento da instância de grupo. Elementos de instância de grupo são subelementos do elemento de grupo de tabela. Se DataElementName não for especificado, o nome do elemento será o nome do agrupamento na RDL.
Header	Todos os itens do cabeçalho são salvos como subelementos ou atributos do elemento da instância de grupo.

Details

A tabela a seguir descreve como os atributos e elementos do elemento RDL Details são salvos pela opção de exportação XML. Details é salvo como elemento.

Elemento RDL	Salvo como
DataCollectionName (Grouping)	O nome do elemento de detalhes. Se DataCollectionName não for especificado, o nome do elemento será o nome especificado no elemento DataElementName mais a cadeia de caracteres "_Collection". Se Details não tiver um agrupamento, o nome do elemento será Detail_Collection.
DataElementName (Grouping)	O nome do elemento da instância de grupo. Elementos de instância de grupo são subelementos do elemento de detalhes. Se DataElementName não for especificado, o nome do elemento será o nome do agrupamento na RDL. Se Details não tiver um agrupamento, o nome do elemento será Detail.
DetailsRows	Todos os itens das linhas de detalhes são salvos como subelementos ou atributos do elemento da instância de grupo.

Matriz

A tabela a seguir descreve como as matrizes são salvas pela opção de exportação XML. A matriz é salva como elemento.

Elemento RDL	Salvo como
DataElementName	O nome do elemento da matriz. Se DataElementName não for especificado, o nome do elemento será o nome da matriz na RDL.
Corner	Todos os itens do canto são salvos como subelementos ou atributos do elemento da matriz.
RowGrouping	O primeiro elemento RowGrouping é salvo como subelemento do elemento da matriz. Cada elemento RowGrouping subseqüente é salvo como subelemento da instância de grupo do elemento RowGrouping anterior. Isso gera grupos de dados aninhados.
ColumnGrouping	O primeiro elemento ColumnGrouping é salvo como subelemento de cada instância de grupo do último elemento RowGrouping. Cada elemento ColumnGrouping subseqüente é salvo como subelemento da instância de grupo do elemento ColumnGrouping anterior.
MatrixCell	O subelemento Cell de cada instância de grupo do último elemento ColumnGrouping. Todos os itens da célula da matriz são salvos como subelementos ou atributos do elemento Cell.

RowGrouping

A tabela a seguir descreve como os agrupamentos de linhas são salvos pela opção de exportação XML. Um agrupamento de linhas é salvo como elemento.

Elemento RDL	Salvo como
DataCollectionName (Grouping)	O nome do elemento do agrupamento de linhas. Se DataCollectionName não for especificado, o nome do elemento será o nome especificado no elemento DataElementName mais a cadeia de caracteres "_Collection". Isso não é usado para agrupamentos de linhas estáticos.
DataElementName (Grouping)	O nome do elemento da instância de grupo. Elementos de instância de grupo são subelementos do elemento do agrupamento de linhas. Se DataElementName não for especificado, o nome do elemento será o nome do agrupamento na RDL. Para agrupamentos de linhas estáticos, o nome do elemento é o valor de DataElementName da caixa de texto no cabeçalho de grupo usado. Se não houver uma caixa de texto para um cabeçalho de linha estático, o nome do elemento será RowN, onde N representa um número atribuído ao agrupamento de linhas.
ReportItems	Todos os itens do agrupamento de linhas são salvos como subelementos ou atributos do pai do elemento do agrupamento de linhas.
Subtotal	Um elemento irmão do elemento do agrupamento de linhas. Esse elemento contém uma célula de matriz. O nome desse elemento é o nome especificado no elemento DataElementName para o subtotal. Se nenhum nome for especificado, o nome do elemento será Total.

Observação
Os subtotais não são salvos por padrão. A opção de exportação XML salva subtotais apenas se o valor do elemento RDL DataElementOutput para o subtotal for Output.

ColumnGrouping

A tabela a seguir descreve como os agrupamentos de colunas são salvos pela opção de exportação XML. Um agrupamento de colunas é salvo como elemento.

Elemento RDL	Salvo como
DataCollectionName (Grouping)	O nome do elemento do agrupamento de colunas. Se DataCollectionName não for especificado, o nome do elemento será o nome especificado no elemento DataElementName mais a cadeia de caracteres "_Collection". Isso não é usado para agrupamentos de colunas estáticos.
DataElementName (Grouping)	O nome do elemento da instância de grupo. Elementos de instância de grupo são subelementos do elemento do agrupamento de colunas. Se DataElementName não for especificado, o nome do elemento será o nome do agrupamento na RDL. Para agrupamentos de colunas estáticos, o nome do elemento é o valor de DataElementName da caixa de texto no cabeçalho de grupo usado. Se não houver uma caixa de texto para um cabeçalho de coluna estático, o nome do elemento será ColumnN, onde N representa um número atribuído ao agrupamento de colunas.
ReportItems	Todos os itens do agrupamento de colunas são salvos como subelementos ou atributos do pai do elemento do agrupamento de colunas.
Subtotal	Como elemento irmão do elemento do agrupamento de colunas. Esse elemento contém uma célula de matriz. O nome desse elemento é o nome especificado no elemento DataElementName para o subtotal. Se nenhum nome for especificado, o nome do elemento será Total.

Observação
Os subtotais não são salvos por padrão. A opção de exportação XML salva subtotais apenas se o valor do elemento RDL DataElementOutput para o subtotal for Output.

Para entender melhor como a opção de exportação XML salva os elementos RDL em um relatório como um arquivo XML, convém saber mais sobre os elementos. Para obter mais informações sobre os elementos RDL, consulte o tópico Linguagem RDL nos Manuais Online do SQL Server.