Создание Excel-документа на ActionScript 3.0

Недавно в одном из моих проектов при работе с различными схемами и диаграммами появилась необходимость экспорта данных в распространенный и удобочитаемый формат. Выбор автоматически пал на документы Microsoft Excel. Оказалось:

Начиная с 10-ой версии Flash Player можно собирать Excel-документы без участия сервера.

с чем хочу с вами поделится.

Немного теории.

В качестве Excel-документов я рассматриваю документы созданные в Microsoft Excel 2007 с расширением .xlsx. Именно с этой версии Microsoft открыла свой формат электронных таблиц. И теперь - это не файл с бинарными записями, а .zip-архив с набором .xml-документов.

Таким образом для создания .xlsx-документов нам необходимо записать данные в .xml-документы, затем собрать их в .zip-архив и в завершении заменить его расширение на ".xlsx".

Что мы имеем во Flash Player?

• Полноценная работа с xml-разметкой (пакет классов flash.xml). Мы можем с легкостью записывать наши данные в .xml-документы.
• Работа с бинарными данными (класс flash.utils.ByteArray), с помощью которой можно организовать сборку zip-архива.
• Сохранение бинарных данных на компьютер пользователя (класс flash.net.FileReference).

Всё что нам необходимо, мы имеем. Поэтому перейдем к практике.

Запись данных в XML

Первым делом нужно разобраться с содержимом .xlsx-документа, а именно с .xml-документами. Для этого я в Microsoft Excel 2007 создал новый документ, сделал некоторые записи,



сохранил, поменял расширение на .zip и увидел такую вот структуру с каталогами и файлами.



Свои записи (Ivan, Ivanov, Ivanovich) я нашел в файле xl/sharedString.xml. Насколько я понял, это хранилище для текстовой информации.

<sst xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" count="3" uniqueCount="3">
  <si><t>Ivanov<t><si>
  <si><t>Ivan<t><si>
  <si><t>Ivanovich<t><si>
<sst>

Далее я открыл файл xl/worksheets/sheet1.xml и действительно в описание столбца увидел ссылку (а точнее индекс) на содержимое из xl/sharedString.xml.

...
<row r="1" spans="1:3">
  <c r="A1" t="s"><v>0<v><c>
<row>
...

Для начала этой информации нам достаточно.

Рассматривать подробно все возможности записи .xml-документов внутри .xlsx-файлов я не буду. Ознакомится с ними можно прочитав книгу "OpenXML. Кратко и доступно", автором которой является Воутер Ван Вугт.

Скажу только то, что благодаря такой открытой структуре .xlsx-документа, вы сможете с легкостью записывать не только текстовую информацию, но и изображения, диаграммы и все остальные объекты Microsoft Excel.

Сборка XML-документов в ZIP-архив

Теперь когда с записью в .xml-документы разобрались давайте попробуем их собрать в архив. Писать архиватор мы не будем, используем готовый. Меньше всего проблем у меня возникло с библиотекой FZip, так что используем её.

...
var zip:FZip = new FZip();
zip.addFile("_rels/.rels", Templates._RELS);
zip.addFile("docProps/app.xml", Templates.APP_XML);
zip.addFile("docProps/core.xml", Templates.CORE_XML);
zip.addFile("xl/_rels/workbook.xml.rels", Templates.WORKBOOK_XML_RELS);
zip.addFile("xl/theme/theme1.xml", Templates.THEME1);
zip.addFile("xl/worksheets/_rels/sheet1.xml.rels", Templates.SHEET1_XML_RELS);
zip.addFile("xl/worksheets/sheet1.xml", Templates.SHEET1_XML);
zip.addFile("xl/sharedStrings.xml", Templates.SHARED_STRING_XML);
zip.addFile("xl/styles.xml", Templates.STYLES_XML);
zip.addFile("xl/workbook.xml", Templates.WORKBOOK_XML);
zip.addFile("[content_types].xml", Templates.CONTENT_TYPES_XML);
//
var brr:ByteArray = new ByteArray();
zip.serialize(brr, true);
...

Сохранение на компьютер пользователя

Сохранить, собранный архив на локальный диск пользователя, можно при помощи класса flash.net.FileReference. Начиная с 10 версии FlashPlayer'a у этого класса появился метод save, который перед сохранением показывает диалоговое окно с выбор место сохранения. Вызываем его и в первом параметре пишем имя сохраняемого файла по умолчанию с расширением "xlsx".

...
var file:FileReference = new FileReference();
file.save("excel_file.xlsx", brr);
...

Пример