В версию«1С:Предприятие» 8.3.15 планируется добавить новый функционал: теперь не понадобится устанавливать расширения для тех манипуляций с файлами, которые можно проводить без них.
Предыстория
Ранее в «1С» сообщили: для того, чтобы поместить несколько файлов на сервер в веб-клиенте, можно не устанавливать в браузере расширение работы с файлами. Теперь пришло время для аналогичных изменений в методах, которые получают файлы с сервера.
Платформа развивалась так, что с необходимостью работать асинхронно появилось три метода для получения файлов. Но они работали несимметрично с теми методами, которые помещали файлы на сервер. Например, методы для получения файлов с сервера ПолучитьФайл() и НачатьПолучениеФайлов() содержат особенности, которых не оказалось у тех, что помещают файлы на сервер.
Для реализации новой функциональности разработчикам пришлось навести порядок в методах.
Унификация
В результате инженеры отказались от методов ПолучитьФайл(), ПолучитьФайлы(), НачатьПолучениеФайлов(). Вместо них сделали два новых асинхронных метода с понятными именами:
-
НачатьПолучениеФайлаССервера()
-
НачатьПолучениеФайловССервера()
Для работы «в обратную сторону», отказались от методов: НачатьПомещениеФайла() и НачатьПомещениеФайлов(). Их заменили двумя новыми:
-
НачатьПомещениеФайлаНаСервер()
-
НачатьПомещениеФайловНаСервер()
Все новые методы позволяют получать с сервера или помещать на него один или несколько файлов. При этом можно задействовать интерактивный диалог. Для его настройки тоже создано несколько новых типов:
-
ПараметрыДиалогаПолученияФайлов
-
ПараметрыДиалогаПомещенияФайлов
Для их работы во время использования интерактивного диалога не потребуется расширение работы с файлами в веб-клиенте. Если диалог не используется, то в браузере понадобится установить расширение.
Так разработчики постарались свести к минимуму необходимость установки расширения при работе веб-клиента. Если работать с файлами можно без расширения, то программа не будет его вызывать, даже если оно установлено.
Новая функциональность методов
С новыми методами появилась и новая функциональность. Методы, помещающие один или несколько файлов на сервер, позволяют подключить собственный обработчик прогресса загрузки файлов.
Метод НачатьПолучениеФайловССервера() позволяет вам получать файлы в виде архива. Для этого создан новый тип ПараметрыПолученияАрхиваФайлов, который позволяют задавать имя архива и режим его получения.
В результате во встроенном языке теперь есть четыре рекомендуемых асинхронных метода для работы с файлами:
|
|
Помещение на сервер |
Получение с сервера |
|
Один файл |
НачатьПомещениеФайлаНаСервер() |
НачатьПолучениеФайлаССервера() |
|
Несколько файлов |
НачатьПомещениеФайловНаСервер() |
НачатьПолучениеФайловССервера() |
Прежние методы теперь можно считать устаревшими: в синтаксис-помощнике их больше нет. Но платформа продолжает их поддерживать, поэтому ранее написанные конфигурации будут работать и с новой версией «1С:Предприятие».
Но разработчики рекомендуют со временем все же перевести старые конфигурации на использование новых методов, чтобы не отставать от современной методики актуальной платформы.