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

  • Статья

Экспорт в файл CSV (построитель отчетов 2.0)

Модуль подготовки отчетов в формат с разделителями-запятыми (CSV) готовит отчеты для просмотра в виде плоских наборов данных стандартизованного текстового вида. Этот формат легко читается и может использоваться для обмена со многими приложениями.

Модуль подготовки отчетов в формате CSV использует строковый символ-разделитель для отделения полей и строк. Строковый разделитель можно настроить, чтобы использовать символ, отличный от запятой. Полученный файл может быть открыт в электронных таблицах (например в Microsoft Excel) или импортирован в другие программы. Отчет экспортируется в CSV-файл и возвращает тип MIME text/csv.

Подготовка CSV-файлов

Если для отображения используются параметры по умолчанию, отчет в формате CSV имеет следующие характеристики:

  • По умолчанию строка разделителя полей — запятая (,).

    ПримечаниеПримечание

    В качестве разделителя полей можно задать любой символ, в том числе символ табуляции. Для этого нужно изменить настройки сведений об устройстве. Дополнительные сведения см. в разделе Настройки сведений об устройстве в службах Reporting Services.

  • Строка разделителя записи — возврат каретки и перевод строки (<cr><lf>).

  • Ограничитель текста — кавычка (").

    Модуль подготовки отчетов в формате CSV не заключает все текстовые строки в квалификаторы. Ограничители текста добавляются только в случаях, когда строка содержит символ разделителя или символ конца строки.

  • Если текст содержит внедренную строку разделителя или строку ограничителя текста, вокруг текста помещается ограничитель текста, а внедренные ограничители удваиваются.

  • Форматирование и макет игнорируются.

При обработке не учитываются следующие элементы.

  • Диаграмма

  • Датчик

  • Верхний колонтитул страницы

  • Нижний колонтитул страницы

  • Пользовательские элементы

  • Line

  • Image

  • Автоматические подытоги

Остальные элементы отчета сортируются сверху вниз, затем слева направо. Каждый элемент присваивается столбцу. Если отчет имеет вложенные элементы данных, такие как списки или таблицы, родительские элементы повторяются в каждой записи.

В следующей таблице описывается, как выглядят подготовленные к просмотру элементы отчета.

Элемент

Поведение при подготовке к просмотру

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

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

Таблица

Подготовка путем разворачивания таблицы и создания строки и столбца для каждой строки и столбца на самом низком уровне детализации. Строки и столбцы подытогов не имеют заголовков строки или столбца. Детализированные отчеты не поддерживаются.

Матрица

Подготовка с развертыванием таблицы и созданием строки и столбца для каждой строки и столбца на самом низком уровне детализации. Строки и столбцы подытогов не имеют заголовков строки или столбца.

Список

Подготовка записи для каждой отдельной строки или экземпляра в списке.

Прямоугольник

Родительский элемент повторяется для каждого экземпляра содержимого.

Вложенный отчет

Родительский элемент повторяется для каждого экземпляра содержимого.

Иерархические и группированные данные

Иерархические и группированные данные должны быть переведены в плоский формат, чтобы их можно было представить в формате CSV.

Модуль подготовки отчетов делает отчет плоским, преобразуя его в древовидную структуру, отображающую вложенные группы области данных. Формирование плоского отчета происходит следующим образом.

  • Сначала делается плоской иерархия строк, затем — иерархия столбцов.

  • Сначала в CSV-файл отображаются элементы иерархии строк, затем элементы иерархии столбцов.

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

  • Внутри области данных столбцы упорядочиваются следующим образом: угловые элементы, элементы иерархии строк, элементы иерархии столбцов и затем ячейки.

  • Одноранговые области данных — это области данных или динамические группы, относящиеся к одной и той же области данных или имеющие одного динамического предка. Одноранговые данные можно определить по разветвлениям уплощенного дерева.

Дополнительные сведения см. в разделе Работа с областями данных табликса (построитель отчетов 2.0).

Режимы модуля подготовки отчетов

Модуль подготовки отчетов в формате CSV может работать в двух режимах: один оптимизирован для Excel, а другой — для приложений сторонних разработчиков, которые требуют строгого соответствия спецификации CSV в стандарте RFC 4180. Обработка одноранговых областей данных выполняется по-разному, в зависимости от используемого режима.

Режим по умолчанию

Режим по умолчанию оптимизирован для использования отчетов в электронных таблицах Excel. Отчет, подготовленный в режиме по умолчанию, имеет формат CSV-файла с несколькими разделами данных в формате CSV. Каждая одноранговая область данных отделена пустой строкой. Одноранговые области данных в тексте отчета выводятся как отдельные массивы данных внутри файла CSV. Результатом является CSV-файл, в котором:

  • индивидуальные текстовые поля в тексте отчета выводятся один раз как первый блок данных в CSV-файле;

  • каждая одноранговая область данных верхнего уровня в тексте отчета выводится в своем собственном блоке данных;

  • вложенные области данных выводятся диагонально в одном и том же блоке данных.

Форматирование

Числовые значения выводятся в форматированном виде. Программа работы с электронными таблицами Excel распознает форматированные численные значения — денежные суммы, проценты, даты — и форматирует ячейки соответствующим образом при импорте CSV-файла.

Режим совместимости

Совместимый формат оптимизирован для приложений сторонних разработчиков.

Области данных

Заголовки столбцов содержатся только в первой строке файла, и каждая строка содержит одинаковое количество столбцов.

Форматирование

Значения не форматируются.

Интерактивность

Ни один формат CSV данного модуля подготовки отчетов не поддерживает интерактивности. Не обрабатываются следующие интерактивные элементы.

  • Гиперссылки

  • Показать или скрыть

  • Схема документа

  • Ссылки с детализацией или дополнительной информацией

  • Сортировка конечным пользователем

  • Фиксированные заголовки

  • Закладки

Настройки сведений об устройстве

Некоторые настройки по умолчанию для этого модуля подготовки отчетов можно изменить с помощью изменения настроек сведений об устройстве. Можно, например, указать, в каком режиме готовить отчет, какие символы использовать в качестве разделителей, а какие — в качестве ограничителей текста. Дополнительные сведения см. в разделе Настройки сведений об устройстве в службах Reporting Services.