Элементы и атрибуты языка определения отчетов в XML (построитель отчетов)

Статья
12/15/2008

Когда отчет сохраняется в файл формата XML, построитель отчетов должен преобразовать язык определения отчетов в формат XML. Параметр экспорта в XML сохраняет элементы отчета как элементы или атрибуты в XML-документе. Каждый элемент может иметь набор атрибутов или связанных с ним вложенных элементов. Атрибуты и элементы различаются в зависимости от элемента отчета. В этом разделе обсуждается преобразование схемы языка определения отчетов при сохранении в формате XML.

Отчет

Report — корневой узел XML. Он содержит атрибуты, задающие данные схемы для XML-документа и имя отчета.

XML-схема (XSD) указывается в корневом элементе XML следующим образом:

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

Следующая таблица показывает, каким образом атрибуты и элементы, соответствующие элементам языка определения отчетов, сохраняются при экспорте в формат XML.

Атрибут языка определения отчета	Сохраняется как
Name	Name — атрибут корневого элемента.

Текстовые поля

Следующая таблица показывает, каким образом текстовые поля сохраняются при экспорте в формат XML. Название текстового поля и его значение сохраняются как элемент или как атрибут в зависимости от значения элемента языка определения отчета DataElementStyle, соответствующего текстовому полю.

Элемент языка определения отчетов	Сохраняется как
DataElementName	Имя элемента текстового поля или атрибута. По умолчанию за имя принимается имя текстового поля на языке определения отчетов, если не указано DataElementName,
Value	Значение данных в текстовом поле.

Таблица

Следующая таблица показывает, каким образом таблицы сохраняются при экспорте в формат XML. Таблица сохраняется как элемент.

Элемент языка определения отчетов	Сохраняется как
DataElementName	Имя элемента таблицы. Если DataElementName не задано, именем элемента является имя таблицы на языке определения отчетов.
TableGroup	Первый элемент TableGroup сохраняется как вложенный элемент элемента таблицы. Каждый последующий элемент TableGroup сохраняется как вложенный элемент экземпляра группы предыдущего элемента TableGroup. Это приводит к вложенным группам данных.
Details	Вложенный элемент каждого экземпляра группы для последнего элемента TableGroup. Если табличные группы не созданы, Details сохраняется как вложенный элемент табличного элемента.

Группа таблиц

Следующая таблица показывает, каким образом группы таблиц сохраняются при экспорте в формат XML. Группы таблиц сохраняются как элементы.

Элемент языка определения отчетов	Сохраняется как
DataCollectionName (Grouping)	Имя элемента группы таблиц. Если DataCollectionName не задано, именем элемента является имя, указанное в элементе DataElementName с добавлением строки «_Collection».
DataElementName (Grouping)	Имя элемента экземпляра группы. Элементы экземпляров группы — это вложенные элементы элемента группы таблиц. Если DataElementName не задано, именем элемента является имя группирования на языке определения отчетов.
Header	Все элементы в заголовке сохраняются как вложенные элементы или как атрибуты элемента экземпляра группы.

Подробности

Следующая таблица показывает, каким образом атрибуты и элементы элемента языка определения отчета Details сохраняются при экспорте в формат XML. Details сохраняется как элемент.

Элемент языка определения отчетов	Сохраняется как
DataCollectionName (Grouping)	Имя элемента подробностей. Если DataCollectionName не задано, именем элемента является имя, указанное в элементе DataElementName с добавлением строки «_Collection». Если Details не имеет группирования, именем элемента является Detail_Collection.
DataElementName (Grouping)	Имя элемента экземпляра группы. Элементы экземпляров группы — это вложенные элементы элемента подробностей. Если DataElementName не задано, именем элемента является имя группирования на языке определения отчетов. Если Details не имеет группирования, именем элемента является Detail.
DetailsRows	Все элементы в строках сведений сохраняются как вложенные элементы или атрибуты элемента экземпляра группы.

Матрица

Следующая таблица показывает, каким образом матрицы сохраняются при экспорте в формат XML. Матрица сохраняется как элемент.

Элемент языка определения отчетов	Сохраняется как
DataElementName	Имя элемента матрицы. Если DataElementName не задано, именем элемента является имя матрицы на языке определения отчетов.
Corner	Все элементы в углу сохраняются как вложенные элементы или атрибуты элемента матрицы.
RowGrouping	Первый элемент RowGrouping сохраняется как вложенный элемент элемента матрицы. Каждый последующий элемент RowGrouping сохраняется как вложенный элемент экземпляра группы предыдущего элемента RowGrouping. Это приводит к вложенным группам данных.
ColumnGrouping	Первый элемент ColumnGrouping сохраняется как вложенный элемент экземпляра последнего элемента RowGrouping. Каждый последующий элемент ColumnGrouping сохраняется как вложенный элемент экземпляра группы предыдущего элемента ColumnGrouping.
MatrixCell	Вложенный элемент Cell в каждом экземпляре группы для последнего элемента ColumnGrouping. Все элементы в ячейках матрицы сохраняются как вложенные элементы или атрибуты элемента Cell.

Группирование строк

Следующая таблица показывает, каким образом группирования строк сохраняются при экспорте в формат XML. Группирование строк сохраняется как элемент.

Элемент языка определения отчетов	Сохраняется как
DataCollectionName (Grouping)	Имя элемента группирования строк. Если DataCollectionName не задано, именем элемента является имя, указанное в элементе DataElementName с добавлением строки «_Collection». Оно не используется для статического группирования строк.
DataElementName (Grouping)	Имя элемента экземпляра группы. Элементы экземпляров группы — это вложенные элементы элемента группирования строк. Если DataElementName не задано, именем элемента является имя группирования на языке определения отчетов. Для статического группирования строк именем элемента является значение DataElementName для текстового поля в используемом заголовке группы. Если в статическом заголовке строки нет текстового поля, именем элемента является RowN, где N — номер, присвоенный группированию строк.
ReportItems	Все элементы в группировании строк сохраняются как вложенные элементы или атрибуты родителя элемента группирования строк.
Subtotal	Родственный элемент того же уровня для элемента группирования строк. Этот элемент содержит ячейку матрицы. Именем этого элемента является имя, заданное в элементе DataElementName для подытогов. Если имя не задано, именем элемента является Total.

Примечание.
Подытоги не сохраняются по умолчанию. Модуль подготовки XML-файлов сохраняет подытоги, только если значение DataElementOutput элемента языка определения отчетов для подытогов равно Output.

Группирование столбцов

Следующая таблица показывает, каким образом группирования столбцов сохраняются при экспорте в формат XML. Группирование столбцов сохраняется как элемент.

Элемент языка определения отчетов	Сохраняется как
DataCollectionName (Grouping)	Имя элемента группирования столбцов. Если DataCollectionName не задано, именем элемента является имя, указанное в элементе DataElementName с добавлением строки «_Collection». Не используется для статического группирования столбцов.
DataElementName (Grouping)	Имя элемента экземпляра группы. Элементы экземпляров группы — это вложенные элементы элемента группирования столбцов. Если DataElementName не задано, именем элемента является имя группирования на языке определения отчетов. Для статического группирования столбцов именем элемента является значение DataElementName для текстового поля в используемом заголовке группы. Если в статическом заголовке столбца нет текстового поля, именем элемента является ColumnN, где N — номер, присвоенный группированию столбцов.
ReportItems	Все элементы в группировании столбцов сохраняются как вложенные элементы или атрибуты родителя элемента группирования столбцов.
Subtotal	Родственный элемент того же уровня для элемента группирования столбцов. Этот элемент содержит ячейку матрицы. Именем этого элемента является имя, заданное в элементе DataElementName для подытогов. Если имя не задано, именем элемента является Total.

Примечание.
Подытоги не сохраняются по умолчанию. Модуль подготовки XML-файлов сохраняет подытоги только в том случае, если значение DataElementOutput элемента языка определения отчетов для них равно Output.

Чтобы лучше понять, как параметр экспорта XML сохраняет элементы языка определения отчетов в виде XML-файла, необходимо больше узнать об элементах. Дополнительные сведения об элементах языка определения отчетов см. в разделе «Язык определения отчетов» электронной документации по SQL Server 2005.

См. также

Поделиться через