Как передать ТабличныйДокумент из 1С через веб-сервис для отображения или скачивания на внешнем сайте?

← К списку

Когда возникает задача передачи сложного отчета или табличных данных из системы 1С:Предприятие во внешнюю веб-систему, например, для отображения на сайте или предоставления пользователю для скачивания, мы сталкиваемся с несколькими вызовами. ТабличныйДокумент в 1С — это мощный инструмент для представления отчетов, но его прямая передача через веб-сервис требует правильного подхода. Давайте вместе разберем различные стратегии и выберем наиболее подходящее решение для вашей ситуации.

Общие принципы взаимодействия веб-сервиса 1С и внешнего сайта

Прежде чем углубляться в детали форматов, давайте вспомним, что для успешной работы веб-сервиса 1С его необходимо опубликовать на веб-сервере (например, IIS или Apache). Этот процесс включает регистрацию модуля расширения веб-сервера и настройку виртуального приложения. Обеспечение безопасности соединения с использованием SSL-сертификатов (HTTPS) и дополнительной аутентификации является критически важным шагом.

При передаче данных через веб-сервисы мы всегда стремимся к оптимизации. Это включает минимизацию размера передаваемых данных и использование эффективных методов работы с ними. Если объем данных превышает несколько мегабайт, их рекомендуется разбивать на части. 1С:Предприятие также поддерживает оптимизированную отправку двоичных данных по MTOM-протоколу, что может быть полезно.

Решение 1: Передача ТабличногоДокумента в формате PDF

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

Формирование и сохранение ТабличногоДокумента в PDF.

На стороне 1С мы сначала формируем наш ТабличныйДокумент, а затем сохраняем его в формате PDF. Для этого используем метод Записать() объекта ТабличныйДокумент, указывая тип файла ТипФайлаТабличногоДокумента.PDF.
```
ТабДок = Новый ТабличныйДокумент;
// ... код по заполнению ТабДок ...

ИмяВременногоФайлаPDF = КаталогВременныхФайлов() + "Отчет_" + УникальныйИдентификатор() + ".pdf";
ТабДок.Записать(ИмяВременногоФайлаPDF, ТипФайлаТабличногоДокумента.PDF);
```
Оптимизация без сохранения на диск: Для повышения производительности и безопасности мы можем избежать создания временных файлов на диске. Вместо этого, используем объект ПотокВПамяти (MemoryStream). Сначала записываем ТабличныйДокумент в поток, а затем преобразуем его в ДвоичныеДанные.
```
ТабДок = Новый ТабличныйДокумент;
// ... код по заполнению ТабДок ...

Поток = Новый ПотокВПамяти;
ТабДок.Записать(Поток, ТипФайлаТабличногоДокумента.PDF);
ДвоичныеДанныеPDF = Поток.Прочитать();
```

Преобразование PDF в строку Base64.

Для передачи через веб-сервис двоичные данные PDF-файла необходимо преобразовать в текстовый формат, используя кодировку Base64. Это универсальный способ передачи бинарных данных через текстовые протоколы.


// Если мы использовали временный файл:
ДвоичныеДанныеPDF = Новый ДвоичныеДанные(ИмяВременногоФайлаPDF);

// Или если использовали ПотокВПамяти, у нас уже есть ДвоичныеДанныеPDF
СтрокаBase64PDF = База64Кодировать(ДвоичныеДанныеPDF);
Возврат СтрокаBase64PDF; // Веб-сервис возвращает строку Base64

Декодирование и отображение на стороне клиента.

На стороне клиентского сайта (например, на JavaScript) мы получаем строку Base64, декодируем ее обратно в двоичные данные и отображаем PDF. Мы можем использовать префикс data:application/pdf;base64, для встраивания PDF напрямую в HTML-страницу или для создания ссылки на скачивание.

Важный момент: Иногда могут возникать проблемы с чтением PDF после декодирования. В этом случае мы рекомендуем проверять корректность полученной Base64-строки онлайн-валидаторами.

Решение 2: Передача ТабличногоДокумента в формате HTML

Если цель — непосредственное отображение отчета на веб-странице, то передача в формате HTML может быть очень удобной. Мы можем сформировать HTML-код отчета прямо в 1С.

Формирование и сохранение ТабличногоДокумента в HTML.

Аналогично PDF, ТабличныйДокумент можно сохранить в HTML. Метод Записать() позволяет это сделать.
```
ТабДок = Новый ТабличныйДокумент;
// ... код по заполнению ТабДок ...

ИмяВременногоФайлаHTML = КаталогВременныхФайлов() + "Отчет_" + УникальныйИдентификатор() + ".html";
ТабДок.Записать(ИмяВременногоФайлаHTML, ТипФайлаТабличногоДокумента.HTML);
```
Опять же, мы можем использовать ПотокВПамяти для работы без временных файлов, а затем прочитать данные из потока.

Чтение HTML-содержимого и возврат его как строки.

После сохранения (или формирования в потоке) мы читаем содержимое HTML-файла (или потока) в строку и возвращаем ее из веб-сервиса.


ТекстовыйДокумент = Новый ТекстовыйДокумент;
ТекстовыйДокумент.Прочитать(ИмяВременногоФайлаHTML, КодировкаТекста.UTF8); // Убедитесь в правильной кодировке
СтрокаHTML = ТекстовыйДокумент.ПолучитьТекст();
Возврат СтрокаHTML; // Веб-сервис возвращает HTML-строку

Встраивание HTML на клиентской стороне.

На клиентском сайте полученную HTML-строку можно напрямую вставить в элемент
или </code>.</p> <p><strong>Важный момент:</strong> При встраивании HTML-отчета в существующую страницу сайта могут возникнуть <strong>конфликты стилей</strong>. Мы рекомендуем заранее продумать, как будут взаимодействовать стили отчета со стилями вашего сайта, возможно, потребуется перенос стилей в заголовок страницы или использование изолированного <code><iframe></code>.</p> </li> </ol> <h3>Решение 3: Передача структурированных данных (JSON/XML) для рендеринга на стороне клиента</h3> <p>Этот подход предполагает <strong>разделение данных и представления</strong>. 1С передает "сырые" табличные данные в структурированном формате, а внешний сайт самостоятельно отрисовывает их, используя свои библиотеки и шаблонизаторы. Этот метод особенно хорош, когда нам нужна гибкость в представлении данных на сайте.</p> <ol> <li> <p><strong>Преобразование ТабличногоДокумента в ТаблицуЗначений или массив структур.</strong></p> <p>На стороне 1С мы извлекаем данные из <code>ТабличногоДокумента</code> и формируем из них <code>ТаблицуЗначений</code> или массив структур, который будет легко сериализовать в JSON или XML.</p> <div class="code-container"> <button class="copy-button">Скопировать код</button> <pre class="code-block"><code> ТабДок = Новый ТабличныйДокумент; // ... код по заполнению ТабДок ... ТаблицаДанных = Новый ТаблицаЗначений; ТаблицаДанных.Колонки.Добавить("Показатель"); ТаблицаДанных.Колонки.Добавить("Значение"); // Пример заполнения ТаблицыЗначений из ТабличногоДокумента Для Каждого ОбластьСтроки Из ТабДок.Области Цикл Если ОбластьСтроки.Тип = Тип("ОбластьТабличногоДокумента") Тогда НоваяСтрока = ТаблицаДанных.Добавить(); НоваяСтрока.Показатель = ОбластьСтроки.Ячейки[0].Текст; НоваяСтрока.Значение = ОбластьСтроки.Ячейки[1].Текст; КонецЕсли; КонецЦикла; </code></pre> </div> </li> <li> <p><strong>Сериализация данных в JSON или XML.</strong></p> <p>Платформа 1С:Предприятие (начиная с версии 8.3.6) имеет встроенные средства для работы с JSON. Мы можем использовать <code>ЗаписьJSON</code> для сериализации <code>ТаблицыЗначений</code> или массива структур.</p> <div class="code-container"> <button class="copy-button">Скопировать код</button> <pre class="code-block"><code> ЗаписьJSON = Новый ЗаписьJSON; ЗаписьJSON.УстановитьСтроку(); ЗаписатьJSON(ЗаписьJSON, ТаблицаДанных); // Или массив структур СтрокаJSON = ЗаписьJSON.Закрыть(); Возврат СтрокаJSON; // Веб-сервис возвращает JSON-строку </code></pre> </div> <p>Для XML мы используем <code>ЗаписьXML</code> и <code>ЗаписатьXML()</code>.</p> <p><strong>Обратите внимание:</strong> Для передачи табличных данных также может быть весьма подходящим формат <strong>OData</strong>, который предоставляет стандартизированный подход к RESTful API.</p> </li> <li> <p><strong>Парсинг и рендеринг на стороне клиента.</strong></p> <p>На клиентском сайте мы получаем JSON/XML-строку, парсим ее и используем JavaScript-библиотеки (например, React, Vue, Angular) или шаблонизаторы для динамического построения HTML-таблицы.</p> <p><strong>Преимущества JSON:</strong> JSON является компактным текстовым форматом, широко используемым в веб-приложениях. Все современные браузеры имеют встроенные средства для работы с ним, что упрощает разработку.</p> </li> </ol> <h3>Решение 4: Передача ТабличногоДокумента как ДвоичныеДанные через ХранилищеЗначений</h3> <p>Этот метод часто используется для передачи объектов между базами 1С, но может быть адаптирован и для веб-сервисов, если требуется передать сам объект <code>ТабличныйДокумент</code> или его двоичное представление.</p> <ol> <li> <p><strong>Преобразование ТабличногоДокумента в ХранилищеЗначений.</strong></p> <p>Объект <code>ХранилищеЗначений</code> (<code>ValueStorage</code>) позволяет сериализовать любой объект 1С, включая <code>ТабличныйДокумент</code>.</p> <div class="code-container"> <button class="copy-button">Скопировать код</button> <pre class="code-block"><code> ТабДок = Новый ТабличныйДокумент; // ... код по заполнению ТабДок ... Хранилище = Новый ХранилищеЗначений(ТабДок, Новый СжатиеДанных(9)); // Сжимаем для уменьшения размера </code></pre> </div> </li> <li> <p><strong>Преобразование ХранилищаЗначений в ДвоичныеДанные.</strong></p> <p>Полученное <code>ХранилищеЗначений</code> само по себе является сериализуемым объектом, который можно преобразовать в <code>ДвоичныеДанные</code> для передачи.</p> <div class="code-container"> <button class="copy-button">Скопировать код</button> <pre class="code-block"><code> ДвоичныеДанныеХранилища = Хранилище.Получить(); // Получаем двоичные данные хранилища Возврат ДвоичныеДанныеХранилища; // Веб-сервис возвращает ДвоичныеДанные </code></pre> </div> <p>В этом случае веб-сервис должен быть настроен на передачу двоичных данных, возможно, с использованием <code>MTOM</code>, если это большой объем.</p> </li> <li> <p><strong>Обратное преобразование на принимающей стороне.</strong></p> <p>Если принимающая сторона — тоже 1С, то процесс обратный:</p> <div class="code-container"> <button class="copy-button">Скопировать код</button> <pre class="code-block"><code> ДвоичныеДанныеХранилища = ПолученныеДанныеОтВебСервиса; Хранилище = Новый ХранилищеЗначений(ДвоичныеДанныеХранилища); ТабДокПолученный = Хранилище.Получить(); </code></pre> </div> <p>Если принимающая сторона — внешний сайт, то ей придется десериализовать этот специфичный формат 1С, что может быть сложной задачей без специальных библиотек.</p> </li> </ol> <h3>Решение 5: Публикация файлов на веб-сервере с гиперссылками</h3> <p>Этот подход является <strong>непрямым</strong>: веб-сервис 1С не передает сам документ, а предоставляет клиенту ссылку на него. Это особенно удобно для больших файлов или когда требуется, чтобы пользователь мог легко скачать документ.</p> <ol> <li> <p><strong>Формирование ТабличногоДокумента и сохранение в файл.</strong></p> <p>На стороне 1С мы формируем <code>ТабличныйДокумент</code> и сохраняем его в выбранном формате (PDF, XLSX, DOCX и т.д.) в <strong>специально выделенный каталог на веб-сервере</strong>. Мы должны предусмотреть <strong>уникальные имена файлов</strong> для каждой публикации, например, включая код клиента, дату, время и уникальный идентификатор.</p> <div class="code-container"> <button class="copy-button">Скопировать код</button> <pre class="code-block"><code> ТабДок = Отчеты.ДебиторскаяЗадолженность.Создать(); // ... заполнение параметров отчета ... ТабДок.Сформировать(Истина); КодКонтрагента = "00001"; // Пример параметра ИмяФайлаНаСервере = "C:\inetpub\wwwroot\reports\" + КодКонтрагента + "_Задолженность_" + Формат(ТекущаяДата(), "ДФ=yyyyMMddhhmmss") + ".xlsx"; ТабДок.Записать(ИмяФайлаНаСервере, ТипФайлаТабличногоДокумента.XLSX); </code></pre> </div> </li> <li> <p><strong>Формирование URL-адреса и возврат его клиенту.</strong></p> <p>После сохранения файла мы формируем его полный <code>URL</code>-адрес. Веб-сервис возвращает клиенту <code>HTML</code>-страничку с гиперссылками на эти файлы или просто список <code>URL</code>-адресов.</p> <div class="code-container"> <button class="copy-button">Скопировать код</button> <pre class="code-block"><code> // Предполагаем, что отчеты доступны по адресу https://вашсайт.ru/reports/ URLФайла = "https://вашсайт.ru/reports/" + ИмяФайлаНаСервере.Имя + "." + ИмяФайлаНаСервере.Расширение; Возврат URLФайла; // Веб-сервис возвращает URL </code></pre> </div> </li> </ol> <p><strong>Важные моменты:</strong></p> <ul> <li> <p><strong>Безопасность:</strong> Мы должны обеспечить <strong>безопасность доступа</strong> к каталогу с опубликованными файлами. Это включает использование <code>HTTPS</code> и, при необходимости, аутентификации на веб-сервере. Для каталога хранения файлов необходимо предоставить соответствующие права доступа, чтобы 1С могла записывать в него.</p> </li> <li> <p><strong>Протокол:</strong> Используем только <code>HTTP(S)</code> для доступа к файлам, <strong>никаких <code>FTP</code>!</strong></p> </li> <li> <p><strong>Пример кода из форума:</strong></p> <div class="code-container"> <button class="copy-button">Скопировать код</button> <pre class="code-block"><code> Функция WSПолучитьДебиторскуюЗадолженность(Parameters) ОсновнойДоговорКонтрагента = Справочники.Контрагенты.НайтиПоКоду(Parameters).ОсновнойДоговорКонтрагента; Если ОсновнойДоговорКонтрагента.Пустая() Тогда Возврат Неопределено; КонецЕсли; Отчет = Отчеты.ДебиторскаяЗадолженность.Создать(); Отчет.ДоговорКонтрагента = ОсновнойДоговорКонтрагента; Отчет.МоментРасчета = ТекущаяДата(); ДебиторскаяЗадолженность = Отчет.Сформировать(Истина); ИмяФайла = КаталогВременныхФайлов() + "ClientDebts" + Parameters + "_" + Формат(ТекущаяДата(), "ДФ=yyyyMMddhhmmss") ; ДебиторскаяЗадолженность.Записать(ИмяФайла, ТипФайлаТабличногоДокумента.XLSX); Возврат ИмяФайла; КонецФункции Функция GetClientDebts(Parameters) КодКонтрагента = Parameters; Ответ = WSПолучитьДебиторскуюЗадолженность(КодКонтрагента); файл = Новый Файл(Ответ); Если файл.Существует() Тогда Хранилище = Новый ДвоичныеДанные(файл.ПолноеИмя); КонецЕсли; Возврат Хранилище; КонецФункции </code></pre> </div> <p>В этом примере функция <code>WSПолучитьДебиторскуюЗадолженность</code> возвращает имя файла, а <code>GetClientDebts</code> читает этот файл и возвращает его как <code>ДвоичныеДанные</code>. Этот подход можно модифицировать для возврата <code>URL</code> вместо двоичных данных, если файл уже опубликован.</p> </li> </ul> <h3>Решение 6: Формирование SVG-файла</h3> <p>Использование SVG (Scalable Vector Graphics) для таблиц — это интересный и современный подход, обеспечивающий <strong>масштабируемость без потери качества</strong>. Это особенно актуально, если нам нужна векторная графика для отображения отчетов.</p> <ol> <li> <p><strong>Построение SVG-кода для таблицы.</strong></p> <p>На стороне 1С мы можем вручную или с помощью специализированных функций сформировать SVG-код, который будет представлять нашу таблицу. Для ячеек используются элементы <code><rect></code>, а для текста внутри ячеек — <code><text></code>.</p> <p>Рассмотрим пример SVG-файла для простой таблицы:</p> <div class="code-container"> <button class="copy-button">Скопировать код</button> <pre class="code-block"><code> <svg width="400" height="200" xmlns="http://www.w3.org/2000/svg" style="font-family: Arial, sans-serif;">  <rect x="0" y="0" width="200" height="40" fill="#e0e0e0" stroke="#000"/> <text x="10" y="25" font-size="14" fill="#000">Показатель</text> <rect x="200" y="0" width="200" height="40" fill="#e0e0e0" stroke="#000"/> <text x="210" y="25" font-size="14" fill="#000">Значение</text>  <rect x="0" y="40" width="200" height="40" fill="#f9f9f9" stroke="#000"/> <text x="10" y="65" font-size="14" fill="#000">Выручка</text> <rect x="200" y="40" width="200" height="40" fill="#f9f9f9" stroke="#000"/> <text x="210" y="65" font-size="14" fill="#000">1000</text>  <line x1="0" y1="40" x2="400" y2="40" stroke="#000"/> <line x1="0" y1="80" x2="400" y2="80" stroke="#000"/>  <line x1="200" y1="0" x2="200" y2="80" stroke="#000"/> </svg> </code></pre> </div> </li> <li> <p><strong>Возврат SVG-кода как строки.</strong></p> <p>Веб-сервис возвращает полученную SVG-строку.</p> <div class="code-container"> <button class="copy-button">Скопировать код</button> <pre class="code-block"><code> СтрокаSVG = "..." // Сформированный SVG-код Возврат СтрокаSVG; </code></pre> </div> </li> <li> <p><strong>Использование SVG на клиентской стороне.</strong></p> <p>На клиентском сайте SVG-файл можно использовать несколькими способами:</p> <ul> <li>Сохранить как <code>.svg</code>-файл и открыть в браузере.</li> <li>Вставить в HTML как изображение: <code><img src="data:image/svg+xml;base64,..." /></code> или <code><img src="table.svg"></code>, если файл опубликован.</li> <li>Вставить SVG-код напрямую в <code><div></code> элемент HTML-страницы.</li> </ul> </li> </ol> <h3>Общие рекомендации и инструменты</h3> <ul> <li> <p><strong>Отладка:</strong> Для тестирования и отладки веб-сервисов 1С мы рекомендуем использовать такие инструменты, как <strong>Postman, SoapUI или Advanced REST Client</strong>. В 1С также существуют встроенные средства для отладки как потребителя, так и поставщика веб-сервисов.</p> </li> <li> <p><strong>Работа с ТабличнымДокументом в веб-клиенте:</strong> Если ваш веб-сервис взаимодействует с веб-клиентом 1С, помните, что для достижения приемлемой скорости следует избегать частых обращений к серверу. Обновление состояния формы должно выполняться на клиенте, а серверные вызовы должны быть оптимизированы. Присваивать сформированный на сервере <code>ТабличныйДокумент</code> реквизиту формы лучше также на сервере.</p> </li> <li> <p><strong>Выбор формата:</strong> Выбор формата (PDF, HTML, JSON, SVG, XLSX и т.д.) должен зависеть от <strong>конкретных требований</strong> вашего проекта. Если нужна неизменяемость и печатный вид — PDF. Если интерактивность и гибкость на сайте — JSON/XML с клиентским рендерингом или HTML. Если векторная графика — SVG. Для скачивания — публикация файлов.</p> </li> </ul> <p>Мы надеемся, что этот подробный разбор поможет вам успешно решить задачу передачи <code>ТабличногоДокумента</code> из 1С через веб-сервис. Удачи в реализации!</p> <a href="../index.html" class="back-btn back-btn-bottom" id="back-btn-bottom">← К списку</a> <script> // Восстанавливаем правильную страницу для возврата (function () { const lastPage = localStorage.getItem('lastIndexPage'); if (lastPage) { const pageNum = parseInt(lastPage); const backUrl = pageNum === 1 ? '../index.html' : `../page${pageNum}.html`; // Обновляем обе кнопки возврата const btnTop = document.getElementById('back-btn-top'); const btnBottom = document.getElementById('back-btn-bottom'); if (btnTop) btnTop.href = backUrl; if (btnBottom) btnBottom.href = backUrl; } })(); </script> <script src="../js/script.js"></script> </body> </html>