Проектирование вывода в формате CSV
Модуль подготовки отчетов в формате CSV переводит отчеты в текстовый формат, в котором значения разделяются запятыми. В этом формате используется строковый разделитель для отделения полей и строк. В качестве строкового разделителя можно использовать любой знак, кроме запятой. Полученный в результате файл можно открыть в программе электронных таблиц, например Microsoft Excel, или импортировать в другие программы. Отчет экспортируется в CSV-файл и возвращает тип MIME text/plain. Это файлы MIME версии 1.0.
Подготовка CSV-файлов
Если для отображения используются параметры по умолчанию, отчет в формате CSV имеет следующие характеристики:
- Первая запись содержит заголовки всех столбцов в отчете.
- Во всех строках одинаковое количество столбцов.
- По умолчанию строка разделителя полей — запятая (,).
- Строка разделителя записи — возврат каретки и перевод строки (<cr><lf>).
- Ограничитель текста — кавычка (").
- Если текст содержит внедренную строку разделителя или строку ограничителя текста, вокруг текста помещается ограничитель текста, а внедренные ограничители удваиваются.
- Форматирование и макет игнорируются.
Для отображения модуль подготовки отчетов в формате CSV использует объектную модель отчета, созданную обработчиком отчетов. При обработке не учитываются следующие элементы:
- PageHeader
- PageFooter
- Custom
- Line
- Image
- ActiveXControl
Остальные элементы отчета сортируются сверху вниз, затем слева направо. Каждый элемент присваивается столбцу. Если отчет имеет вложенные элементы данных, такие как списки или таблицы, родительские элементы повторяются в каждой записи.
Следующая таблица перечисляет условия, применяемые к элементам при приведении к CSV.
| Элемент | Поведение при подготовке к просмотру |
|---|---|
Текстовое поле |
Подготовка содержимого текстового поля. Данные форматируются согласно свойству Format элемента. |
Таблица |
Подготовка путем разворачивания таблицы и создания строки и столбца для каждой строки и столбца на самом низком уровне детализации. Строки и столбцы подытогов не имеют заголовков строки или столбца. Детализированные отчеты не поддерживаются. |
Матрица |
Подготовка с развертыванием таблицы и созданием строки и столбца для каждой строки и столбца на самом низком уровне детализации. Строки и столбцы подытогов не имеют заголовков строки или столбца. |
Список |
Подготовка записи для каждой отдельной строки или экземпляра в списке. |
Прямоугольник |
Подготовка содержимого как вложенных элементов. Родительский элемент повторяется для каждого экземпляра содержимого. |
Вложенный отчет |
Подготовка содержимого как вложенных элементов. Родительский элемент повторяется для каждого экземпляра содержимого. |
Диаграмма |
Подготовка строки для одного набора значений данных и столбцов для другого набора значений данных. |
Модуль подготовки отчетов в формате CSV использует значения по умолчанию для нескольких настраиваемых параметров — знаков разделителя полей, разделителя записей и ограничителя текста. К этим параметрам можно получить доступ и изменить их с помощью пользовательского приложения. Можно управлять отображением данных, используемыми по умолчанию разделителями и знаками разрыва страниц. Можно изменить разделитель полей, разделитель записей и ограничитель текста с помощью параметров FieldDelimiter, RecordDelimiter и Qualifier.
Для управления разрывами страниц используется логический параметр SuppressLineBreaks, который указывает, удалять ли разрывы строк при отображении данных. Когда значение параметра SuppressLineBreaks равно true, разрывы строк и переводы каретки заменяются одиночным символом пробела. Параметр Extension позволяет определять, какое расширение файла используется для текстового файла, в то время как параметр Encoding позволяет изменять кодировку с используемого по умолчанию Юникода на ASCII, UTF-7 или UTF-8. Наконец, параметр NoHeader указывает, должна ли быть пропущена строка заголовка при подготовке. Дополнительные сведения о параметрах настройки устройства см. в разделе Reporting Services Device Information Settings.
.gif "ms155919.note(ru-ru,SQL.90).gif") Примечание. |
|---|
| Структура матричной области данных в CSV может измениться в предстоящих выпусках служб Reporting Services. |
См. также
Основные понятия
Вопросы проектирования при подготовке отчета
Другие ресурсы
Reporting Services Programming